Erzeugen eines Projekts mit einem MSBuild-Befehl

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu So compilieren und erzeugen Sie Anwendungen


Die IDE verwendet zum Erzeugen eines Projekts die MSBuild-Engine von Microsoft. Sie können ohne Kenntnisse über MSBuild Projekte erstellen; die IDE handhabt alle Details für Sie. Projekte lassen sich aber auch direkt - wie im Folgenden beschrieben - über die Befehlszeilensyntax von MSBuild erzeugen. Wenn Sie ein Projekt erzeugen, erscheinen die Ergebnisse des Build-Prozesses auf der Registerkarte Ausgabe des Fensters Meldungen. Wenn Sie Build-Ereignisse festgelegt haben, zeigt der Build-Ausgabebereich die von Ihnen angegebenen Befehle und deren Ergebnisse an.

Die Befehlszeilensyntax von MSBuild hat die folgende Form:

MSBuild <Projektname> [/t:<Zielname>][/p:config=<Konfigurationsname>][target:Deploy][/p:platform=<Name_des_Plattformknotens>]

Erzeugen eines Projekts mit der Befehlszeile

  1. Wählen Sie im Startmenü Embarcadero RAD Studio | RAD Studio-Befehlszeile. Das Befehlszeilenfenster richtet automatisch die Umgebung für die Verwendung der RAD Studio-Tools, wie MSBuild.exe, ein.
    Hinweis: In späteren Versionen des Windows-Betriebssystems steht die Verknüpfung in Ihrem Anwendungslisten-Menü zur Verfügung.
  2. Navigieren Sie zu dem Verzeichnis, das Ihr Projekt enthält, z. B. C:\Users\<Benutzer>\Documents\Embarcadero\Studio\Projects\MeinProjekt.
  3. Geben Sie msbuild ein, aber drücken Sie noch nicht Return.
  4. Geben Sie Ihren Projektnamen ein, wie TelePoll.dproj (ein Delphi-Projekt) oder UserInfo.cbproj (ein C++-Projekt). Wenn das Projekt nicht das aktuelle Verzeichnis ist, müssen Sie dem Projektverzeichnis den vollständigen Pfadnamen hinzufügen.
  5. Zum Festlegen eines Ziels geben Sie das Tag /t: gefolgt von einem in Ihrer Projektdatei festgelegten Ziel ein. Die drei Standardzielnamen sind clean, make und build:
    • Clean bedeutet, dass das Projekt bereinigt wird. Dabei werden erzeugte Dateien, wie z.B. Objektcode, entfernt. Clean entspricht dem Kontextmenübefehl Bereinigen in der Projektverwaltung.
    • Make bedeutet, dass das Projekt compiliert wird. Make entspricht dem Kontextmenübefehl Compilieren.
    • Build bedeutet, dass das Projekt erzeugt wird. Build entspricht dem Kontextmenübefehl Erzeugen.Die drei Ziele entsprechen den Befehlen Bereinigen, Compilieren und Erzeugen im Kontextmenü der Projektmanager. Das Standardziel ist build.
  6. Zum Festlegen einer Konfiguration geben Sie den Namen der Konfiguration hinter /p:config = ein.Wenn Sie keine Konfiguration festlegen verwendet MSBuild die aktuell aktive Konfiguration.Verwenden Sie für die Konfiguration einen in Ihrem Projekt vorhandenen Konfigurationsnamen. Das kann eine Standardkonfiguration, wie z.B. Debug, oderr eine Konfiguration sein, die Sie dem Projekt hinzugefügt haben. Wenn der Konfigurationsname ein Leerzeichen enthält, setzen Sie den Namen in doppelte Anführungszeichen, wie z.B.:/p:config ="My config"
  7. Fügen Sie die Option /target:Deploy hinzu, um Ihre Anwendung für die Bereitstellung vorzubereiten.
  8. Geben Sie weiter Optionen an, und drücken Sie Eingabe, um das Erzeugen zu starten.
Tipp: Um die Online-Hilfe für MSBuild (mit einem ausführlichen Beispiel einer Befehlszeile) anzuzeigen, öffnen Sie die RAD Studio-Befehlszeile (siehe Schritt 1) und geben MSBuild /help ein.

Weitere Informationen über MSBuild finden Sie in der Microsoft-Dokumentation unter http://msdn.microsoft.com/library/default.aspx (EN).

Erstellen einer Android- oder iOS-Anwendung mit der Befehlszeile

Für die Erstellung der APK- oder IPA-Package-Datei ist die Datei *.deployproj erforderlich. Diese Datei wird nur von der IDE generiert. Sie müssen Ihre Anwendung jedes Mal, wenn Sie Änderungen im Bereitstellungs-Manager vornehmen, aus der IDE bereitstellen, damit die Datei *.deployproj aktualisiert wird. Klicken Sie auf Bereitstellen DMgrDeploy.png, um die Datei erneut zu erstellen.

Von der IDE:

  1. Wählen Sie die Optionen für Ihr Projekt in der Projektverwaltung: Build-Konfiguration und Zielplattform.
  2. Compilieren Sie das Projekt.
  3. Gehen Sie zu Projekt > Bereitstellung und klicken Sie auf Bereitstellen DMgrDeploy.png.
    Hinweis: Dies generiert eine *.deployproj-Datei, die mit MSBuild arbeitet.
  4. Speichern Sie das Projekt.

Von MSBuild:

  • Befolgen Sie die Schritte unter Erzeugen eines Projekts in der Befehlszeile, um ein Projekt unter Angabe der Zielplattform msbuild <Projektname> ... /p:platform=Android / iOSDevice64 über die Befehlszeile zu erzeugen.

Beispiele

Sehen Sie sich zur Klärung die folgenden Beispiele für MSBuild-Befehle an:

  • Um ein .apk-Installationsprogramm zur Bereitstellung Ihres C++Builder-Projekts auf der Android-Zielplattform zu erstellen, verwenden Sie einen Befehl mit der folgenden Syntax:

msbuild MyApps_CBuilder.cbproj /t:Build /p:config=Debug /target:Deploy /p:platform=Android

  • Um Ihr Delphi-Projekt auf der iOS32-Zielplattform bereitzustellen, verwenden Sie die folgende Befehlszeilensyntax:

msbuild MyProj_Delphi.dproj /t:Build /p:config=Debug /target:Deploy /p:platform=iOSDevice32

Siehe auch