Eigenschaftenseite für benutzerdefinierten Buildschritt

Für jede Kombination aus Projektkonfiguration und Zielplattform in Ihrem Projekt können Sie einen benutzerdefinierten Schritt angeben, der ausgeführt werden soll, wenn das Projekt erstellt wird.

Die Linux-Version dieser Seite finden Sie unter Benutzerdefinierte Buildschritteigenschaften (Linux C++).

Seite „Allgemein“

  • Befehlszeile

    Der Befehl, den der benutzerdefinierte Buildschritt ausführt.

  • Beschreibung

    Eine Meldung, die anzeigt, wann der benutzerdefinierte Buildschritt läuft.

  • Ausgaben

    Die Ausgabedatei, die der benutzerdefinierte Buildschritt generiert. Diese Einstellung ist erforderlich, damit inkrementelle Builds ordnungsgemäß funktionieren.

  • Zusätzliche Abhängigkeiten

    Eine durch Semikolons getrennte Liste von zusätzlichen Eingabedateien, die für den benutzerdefinierten Buildschritt verwendet werden soll.

  • Im Anschluss ausführen und vorher ausführen

    Diese Optionen definieren, wann ein benutzerdefinierter Buildschritt im Buildprozess relativ zu den aufgelisteten Zielen ausgeführt wird. Die am häufigsten aufgeführten Ziele sind BuildGenerateSources, BuildCompileund BuildLink, da sie die wichtigsten Schritte im Buildprozess darstellen. Andere häufig aufgeführte Ziele sind Midl, CLCompileund Link.

  • Ausgabe als Inhalt behandeln

    Diese Option ist nur für Universelle Windows-Plattform- oder Windows Phone-Apps sinnvoll, die alle Inhaltsdateien im .appx Paket enthalten.

  • Inhaltsstammordner

    Diese Eigenschaft gibt den Basisordner an, den MSBuild zum Berechnen von paketrelativen Pfaden für benutzerdefinierte Buildausgaben verwendet, die als Inhalt gekennzeichnet sind. Es werden keine Dateien zum Verpacken ausgewählt oder müssen sie unter diesem Ordner gespeichert werden. Beispiel:

    Inhaltsstamm: C:\Projects\MyApp\Assets
    Quelldatei: C:\Projects\MyApp\Assets\Images\logo.png
    Zielpfad: Images\logo.png

    MSBuild entfernt den Inhaltsstamm aus dem Quellpfad, um den Zielpfad zu erzeugen. Verpackungstools verwenden den Zielpfad, um zu bestimmen, wo die Datei platziert werden soll. Wenn das Paket z. B. in C:\Packagedie Phase gestellt wird, wird die Datei an C:\Package\Images\logo.pngder Datei platziert.

    Der Zielpfad ist portierbar, da er nicht den computerspezifischen Speicherort enthält, an dem die Datei erstellt wurde.

So legen Sie einen benutzerdefinierten Buildschritt fest

  1. Wählen Sie auf der Menüleiste Project>Eigenschaften aus, um das Dialogfeld "Eigenschaftenseiten" zu öffnen. Weitere Informationen erhalten Sie unter Set C++ compiler and build properties in Visual Studio (Festlegen der Compiler- und Buildeigenschaften (C++) in Visual Studio).

  2. Wählen Sie die >>allgemein" aus.

  3. Ändern Sie die Einstellungen.

Siehe auch

Windows C++-Projekteigenschaftenseitenverweis