VSBuild@1 – Visual Studio Build v1-Aufgabe

Verwenden Sie diese Aufgabe, um mit MSBuild zu erstellen und die Visual Studio-Version-Eigenschaft festzulegen. Weitere Informationen zum Installieren von Visual Studio-Images in Azure.

# Visual Studio build v1
# Build with MSBuild and set the Visual Studio version property.
- task: VSBuild@1
  inputs:
    solution: '**\*.sln' # string. Required. Solution. Default: **\*.sln.
    #vsVersion: 'latest' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '11.0'. Visual Studio Version. Default: latest.
    #msbuildArgs: # string. MSBuild Arguments. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #clean: false # boolean. Clean. Default: false.
  # Advanced
    #maximumCpuCount: false # boolean. Build in Parallel. Default: false.
    #restoreNugetPackages: false # boolean. Restore NuGet Packages. Default: false.
    #msbuildArchitecture: 'x86' # 'x86' | 'x64'. MSBuild Architecture. Default: x86.
    #logProjectEvents: true # boolean. Record Project Details. Default: true.
    #createLogFile: false # boolean. Create Log File. Default: false.
    #logFileVerbosity: 'normal' # 'quiet' | 'minimal' | 'normal' | 'detailed' | 'diagnostic'. Optional. Use when createLogFile = true. Log File Verbosity. Default: normal.
    #enableDefaultLogger: true # boolean. Enable Default Logger. Default: true.
    #customVersion: # string. Custom Version.

# Visual Studio build v1
# Build with MSBuild and set the Visual Studio version property.
- task: VSBuild@1
  inputs:
    solution: '**\*.sln' # string. Required. Solution. Default: **\*.sln.
    #vsVersion: 'latest' # 'latest' | '16.0' | '15.0' | '14.0' | '12.0' | '11.0'. Visual Studio Version. Default: latest.
    #msbuildArgs: # string. MSBuild Arguments. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #clean: false # boolean. Clean. Default: false.
  # Advanced
    #maximumCpuCount: false # boolean. Build in Parallel. Default: false.
    #restoreNugetPackages: false # boolean. Restore NuGet Packages. Default: false.
    #msbuildArchitecture: 'x86' # 'x86' | 'x64'. MSBuild Architecture. Default: x86.
    #logProjectEvents: true # boolean. Record Project Details. Default: true.
    #createLogFile: false # boolean. Create Log File. Default: false.
    #logFileVerbosity: 'normal' # 'quiet' | 'minimal' | 'normal' | 'detailed' | 'diagnostic'. Optional. Use when createLogFile = true. Log File Verbosity. Default: normal.

solution - Lösung
string. Erforderlich. Standardwert: **\*.sln.

Gibt die Lösung für die Aufgabe an, die im Buildprozess verwendet werden soll.

Wenn Sie eine einzelne Lösung erstellen möchten, klicken Sie auf die Schaltfläche ..., und geben Sie die Lösung an.

Wenn Sie mehrere Lösungen erstellen möchten, geben Sie die Suchkriterien an. Sie können einen Einzelordner-Wildcard (*) und rekursive Wildcards (**) verwenden. Beispielsweise sucht **.sln nach allen .sln Dateien in allen Unterverzeichnissen.

Stellen Sie sicher, dass die von Ihnen angegebenen Lösungen von dieser Buildpipeline heruntergeladen werden. Auf der Registerkarte "Repository":

• Wenn Sie TFVC verwenden, stellen Sie sicher, dass die Lösung ein untergeordnetes Element einer der Zuordnungen auf der Registerkarte "Repository" ist.
• Wenn Sie Git verwenden, stellen Sie sicher, dass sich das Projekt oder die Projektmappe in Ihrem Git-Repository und in einer Verzweigung befindet, die Sie erstellen.

vsVersion - Visual Studio-Version
string. Zulässige Werte: latest, 17.0 (Visual Studio 2022), 16.0 (Visual Studio 2019), 15.0 (Visual Studio 2017), 14.0 (Visual Studio 2015), 12.0 (Visual Studio 2013), 11.0 (Visual Studio 2012). Standardwert: latest.

Der Wert dieser Eingabe muss mit der Version von Visual Studio übereinstimmen, die zum Erstellen Ihrer Lösung verwendet wird.

Fügt das argument /p:VisualStudioVersion={numeric_visual_studio_version} dem MSBuild-Befehl hinzu, der vom Build ausgeführt wird. Wenn Sie z. B. Visual Studio 2015angeben, wird /p:VisualStudioVersion=14.0 dem MSBuild-Befehl hinzugefügt.

Azure Pipelines: Wenn Ihr Team Visual Studio mit den von Microsoft gehosteten Agents verwenden möchte, wählen Sie windows-latest als Standardbuildpool aus. Siehe von Microsoft gehosteten Agents.

vsVersion - Visual Studio-Version
string. Zulässige Werte: latest, 16.0 (Visual Studio 2019), 15.0 (Visual Studio 2017), 14.0 (Visual Studio 2015), 12.0 (Visual Studio 2013), 11.0 (Visual Studio 2012). Standardwert: latest.

Der Wert dieser Eingabe muss mit der Version von Visual Studio übereinstimmen, die zum Erstellen Ihrer Lösung verwendet wird.

Fügt das argument /p:VisualStudioVersion={numeric_visual_studio_version} dem MSBuild-Befehl hinzu, der vom Build ausgeführt wird. Wenn Sie z. B. Visual Studio 2015angeben, wird /p:VisualStudioVersion=14.0 dem MSBuild-Befehl hinzugefügt.

Azure Pipelines: Wenn Ihr Team Visual Studio mit den von Microsoft gehosteten Agents verwenden möchte, wählen Sie windows-latest als Standardbuildpool aus. Siehe von Microsoft gehosteten Agents.

msbuildArgs - MSBuild-Argumente
string.

Übergibt zusätzliche Argumente an MSBuild. Syntax finden Sie unter MSBuild Command-Line Reference.

platform - Platform
string.

Gibt die Plattform an, die Sie erstellen möchten, z. B. Win32, x86, x64oder any cpu.

configuration - Configuration
string.

Gibt die zu erstellende Konfiguration an, z. B. debug oder release.

clean - sauberen
boolean. Standardwert: false.

Wenn diese Eigenschaft auf falsefestgelegt ist, erstellt die Aufgabe einen inkrementellen Build. Diese Einstellung kann die Erstellungszeit verringern, insbesondere, wenn ihre Codebasis groß ist. Diese Option hat keine praktische Wirkung, es sei denn, Sie legen auch das Repository "Sauber" auf falsefest.

Bei Festlegung auf trueerstellt die Aufgabe den gesamten Code in den Codeprojekten neu. Dies entspricht dem Argument MSBuild /target:clean.

maximumCpuCount - Build in Parallel
boolean. Standardwert: false.

Wahlfrei. Wenn Ihre MSBuild-Zielkonfiguration mit dem Erstellen parallel kompatibel ist, können Sie diese Eingabe überprüfen, um die /m zu MSBuild (nur Windows) zu übergeben. Wenn Ihre Zielkonfiguration nicht mit dem Erstellen parallel kompatibel ist, kann die Überprüfung dieser Option dazu führen, dass Ihr Build Zu Fehlern bei der Dateiverwendung oder zu zeitweiligen oder inkonsistenten Buildfehlern führt.

restoreNugetPackages - NuGet-Pakete wiederherstellen
boolean. Standardwert: false.

Diese Eingabe ist veraltet. Um NuGet-Pakete wiederherzustellen, fügen Sie vor dem Build eine NuGet Tool Installer Aufgabe hinzu.

msbuildArchitecture - MSBuild-Architektur
string. Zulässige Werte: x86 (MSBuild x86), x64 (MSBuild x64). Standardwert: x86.

Wahlfrei. Stellt die Architektur (x86 oder x64) von MSBuild bereit, die ausgeführt werden soll.

logProjectEvents - Projektdetails aufzeichnen
boolean. Standardwert: true.

Wahlfrei. Zeichnet Zeitachsendetails für jedes Projekt auf.

createLogFile - Protokolldatei erstellen
boolean. Standardwert: false.

Wahlfrei. Erstellt eine Protokolldatei (nur Windows).

logFileVerbosity - protokolldatei verbosity
string. Wahlfrei. Wird verwendet, wenn createLogFile = true. Zulässige Werte: quiet, minimal, normal, detailed, diagnostic. Standardwert: normal.

Gibt die Ausführlichkeitsebene in Protokolldateien an.

enableDefaultLogger - Standardlogger- aktivieren
boolean. Standardwert: true.

Wenn dieser Wert auf truefestgelegt ist, wird der Standardprotokollierer für MSBuild aktiviert.

customVersion - benutzerdefinierte Version
string.

Legt eine benutzerdefinierte Version von Visual Studio fest. Beispiele: 15.0, 16.0, 17.0. Die erforderliche Version von Visual Studio muss im System installiert sein.

Azure Pipelines: Wenn Ihr Team Visual Studio 2022 mit den von Microsoft gehosteten Agents verwenden möchte, wählen Sie windows-2022 als Standardbuildpool aus. Weitere Informationen finden Sie unter von Microsoft gehosteten Agents.

Keiner.