Freigeben über

/Build (devenv.exe)

  • Artikel

Erstellt mithilfe einer angegebenen Projektmappen-Konfigurationsdatei eine Projektmappe oder ein Projekt.

Syntax

devenv SolutionName /Build [SolnConfigName [/Project ProjName [/ProjectConfig ProjConfigName]] [/Out OutputFilename]]

Argumente

  • SolutionName

    Erforderlich. Der Pfad und Name der Projektmappendatei relativ zum Projektmappenverzeichnis.

  • SolnConfigName

    Dies ist optional. Der Name der Projektmappenkonfiguration (z.B. Debug oder Release), die zum Erstellen der in SolutionName benannten Projektmappe verwendet werden soll. Wenn mehrere Projektmappenplattformen verfügbar sind, müssen Sie auch die Plattform angeben (z.B. Debug|Win32). Wenn dieses Argument nicht angegeben wird oder eine leere Zeichenfolge ("") enthält, verwendet das Tool die aktive Konfiguration der Projektmappe.

  • /Project ProjName

    Optional. Der Pfad und der Name einer Projektdatei innerhalb der Projektmappe. Sie können einen relativen Pfad vom SolutionName-Ordner zur Projektdatei, dem Anzeigenamen des Projekts oder dem vollständigen Pfad und Namen der Projektdatei eingeben.

  • /ProjectConfig ProjConfigName

    Optional. Der Name der Projektbuildkonfiguration (z.B. Debug oder Release), die beim Erstellen des benannten Projekts verwendet wird. Wenn mehrere Projektmappenplattformen verfügbar sind, müssen Sie auch die Plattform angeben (z.B. Debug|Win32). Wenn dieser Schalter angegeben ist, überschreibt er das Argument SolnConfigName.

  • /Out OutputFilename

    Optional. Der Name der Datei, an die die Ausgabe des Tools gesendet werden soll. Wenn die Datei bereits vorhanden ist, fügt das Tool die Ausgabe an das Ende der Datei an.

Hinweise

  • Der Schalter /Build führt dieselbe Funktion aus wie der Menübefehl Projektmappe erstellen in der integrierten Entwicklungsumgebung (Integrated Development Environment, IDE).

  • Schließen Sie Zeichenfolgen, die Leerzeichen enthalten, in doppelten Anführungszeichen ein.

  • Zusammenfassende Informationen für Builds, inklusive Fehlermeldungen, können im Befehlsfenster oder in einer Protokolldatei, die durch den Schalter /Out angegeben wird, angezeigt werden.

  • Der Schalter /Build erstellt nur Projekte, die seit dem letzten Build geändert wurden. Verwenden Sie stattdessen /rebuild, um alle Projekte in einer Projektmappe zu erstellen.

  • Wenn Sie die Fehlermeldung Ungültige Projektkonfiguration erhalten, stellen Sie sicher, dass Sie eine Projektmappenplattform oder eine Projektplattform angegeben haben (z.B. Debug|Win32).

Beispiele

Mit dem folgenden Befehl wird das Projekt CSharpWinApp mithilfe der Projektbuildkonfiguration Debug in MySolution erstellt.

devenv "%USERPROFILE%\source\repos\MySolution.sln" /build Debug /project "CSharpWinApp\CSharpWinApp.csproj" /projectconfig Debug

Und um alle Builddateien zu bereinigen:

devenv "%USERPROFILE%\source\repos\MySolution.sln" /clean

Erstellen eines Setupprojekts

Um ein Installationsprogramm (.msi Datei) zu erstellen, benötigen Sie ein Setupprojekt, das über eine .vdproj Projektdatei verfügt, aber zum Erstellen müssen Sie zuerst eine Problemumgehung anwenden, die einen bestimmten Registrierungsschlüssel festlegt. Führen Sie an der Visual Studio Developer-Eingabeaufforderung die ausführbare DisableOutOfProcBuild.exe aus dem Ordner "Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild" aus. Ohne diese Problemumgehung wird möglicherweise der Fehler angezeigt: ERROR: An error occurred while validating. HRESULT = '8000000A'. Der Befehl wirkt sich auf den aktuellen Benutzer aus, daher müssen Sie ihn für Build-Agent-Szenarien aus demselben Konto ausführen, das den Build ausführt. Weitere Informationen finden Sie in der README.txt Datei im selben Ordner.

Außerdem können Sie in Visual Studio eine neue Konfiguration erstellen, z Setup. B. basierend auf der Release Konfiguration, und wählen Sie das Setupprojekt als Projekt aus, das erstellt werden soll. Standardmäßig sind Setupprojekte nicht in den Standardkonfigurationen enthalten, Debug und Release. Mit der Setup definierten Konfiguration erstellen die folgenden Befehle ein Projekt WindowsFormsApp1 und das zugehörige Setupprojekt, um die .msi Datei zu generieren:

devenv WindowsFormsApp1.sln /build Setup

Wenn die Lösung bereits mit der Release-Konfiguration erstellt wurde, erstellt dieser Befehl einfach das Setupprojekt.

Siehe auch