VSBuild@1: Visual Studio-Build v1-Aufgabe

Verwenden Sie diese Aufgabe für die Erstellung mit MSBuild, und legen Sie die Visual Studio-Versionseigenschaft fest. Hier erfahren Sie mehr über die Installation 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.

# 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.

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

Gibt die Lösung für den Task an, der 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 Platzhalter für einzelne Ordner (*) und rekursive Platzhalter (**) verwenden. Sucht beispielsweise **.sln nach allen .sln Dateien in allen Unterverzeichnissen.

Vergewissern Sie sich, dass die von Ihnen angegebenen Projektmappen von dieser Buildpipeline heruntergeladen werden. Auf der Registerkarte „Repository“:

• Vergewissern Sie sich bei Verwendung von TFVC, dass die Projektmappe ein untergeordnetes Element einer der Zuordnungen auf der Registerkarte „Repository“ ist.
• Stellen Sie bei Verwendung von Git sicher, dass sich das Projekt oder die Projektmappe innerhalb des Git-Repositorys 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 Projektmappe verwendet wurde.

Fügt das /p:VisualStudioVersion={numeric_visual_studio_version} Argument dem MSBuild-Befehl hinzu, der vom Build ausgeführt wird. Wenn Sie beispielsweise Visual Studio 2015 angeben, /p:VisualStudioVersion=14.0 wird dem Befehl MSBuild 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 gehostete 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 Projektmappe verwendet wurde.

Fügt das /p:VisualStudioVersion={numeric_visual_studio_version} Argument dem MSBuild-Befehl hinzu, der vom Build ausgeführt wird. Wenn Sie beispielsweise Visual Studio 2015 angeben, /p:VisualStudioVersion=14.0 wird dem Befehl MSBuild 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 gehostete Agents

msbuildArgs - MSBuild-Argumente
string.

Übergibt zusätzliche Argumente an MSBuild. Informationen zur Syntax finden Sie in der Referenz zur MSBuild-Befehlszeile.

platform - Plattform
string.

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

configuration - Konfiguration
string.

Gibt die Konfiguration an, die Sie erstellen möchten, z debug . B. oder release.

clean - Sauber
boolean. Standardwert. false.

Wenn auf falsefestgelegt ist, erstellt der Task einen inkrementellen Build. Diese Einstellung kann die Buildzeit reduzieren, insbesondere bei einer umfangreichen Codebasis. Diese Option hat keine praktische Wirkung, es sei denn, Sie legen auch das Repository bereinigen auf fest false.

Wenn auf truefestgelegt ist, erstellt die Aufgabe den gesamten Code in den Codeprojekten neu. Dieser entspricht dem /target:clean-Argument von MSBuild.

maximumCpuCount - Parallele Erstellung
boolean. Standardwert. false.

Optional. Wenn Ihre MSBuild-Zielkonfiguration mit dem parallelen Erstellen kompatibel ist, können Sie diese Eingabe überprüfen, um den /m Switch an MSBuild (nur Windows) zu übergeben. Wenn Ihre Zielkonfiguration nicht mit dem parallelen Erstellen kompatibel ist, kann das Aktivieren dieser Option dazu führen, dass beim Build Fehler vom Typ „Datei wird verwendet“, zeitweilige Fehler oder Fehler mit inkonsistenten Builds auftreten.

restoreNugetPackages - Wiederherstellen von NuGet-Paketen
boolean. Standardwert. false.

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

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

Optional. Stellt die auszuführende Architektur (x86 oder x64) von MSBuild bereit.

logProjectEvents - Projektdetails aufzeichnen
boolean. Standardwert. true.

Optional. Zeichnet Zeitleiste Details für jedes Projekt auf.

createLogFile - Erstellen einer Protokolldatei
boolean. Standardwert. false.

Optional. Erstellt eine Protokolldatei (nur Windows).

logFileVerbosity - Ausführlichkeit der Protokolldatei
string. Optional. Verwenden Sie , wenn createLogFile = true. Zulässige Werte: quiet, minimal, normal, detailed, diagnostic. Standardwert. normal.

Gibt die Ausführlichkeitsebene in Protokolldateien an.

enableDefaultLogger - Aktivieren der Standardprotokollierung
boolean. Standardwert. true.

Wenn auf truefestgelegt ist, aktiviert die Standardprotokollierung für MSBuild.

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 gehostete Agents.

Keine.