Teilen über


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.

Syntax

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

Eingaben

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.

Tipp

  • Sie können auch MSBuild-Projektdateien (.*proj) erstellen.
  • Wenn Sie eine benutzerdefinierte MSBuild-Projektdatei erstellen, wird empfohlen, die MSBuild-Aufgabe anstelle der Aufgabe „Visual Studio-Build“ zu verwenden.

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.

Tipp

  • Wenn Sie eine MSBuild-Projektdatei (.*proj) anstelle einer Projektmappe als Ziel verwenden, geben Sie AnyCPU an (ohne Leerzeichen).
  • Deklarieren Sie eine Buildvariable, z. B. BuildPlatform auf der Registerkarte „Variablen“ (Auswahl von „Zum Einreihungszeitpunkt erlauben“), und verweisen Sie hier als $(BuildPlatform) darauf. Auf diese Weise können Sie die Plattform ändern, wenn Sie den Build in die Warteschlange einreihen und das Erstellen mehrerer Konfigurationen ermöglichen.

configuration - Konfiguration
string.

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

Tipp

Deklarieren Sie eine Buildvariable, z. B. BuildConfiguration auf der Registerkarte „Variablen“ (Auswahl von „Zum Einreihungszeitpunkt erlauben“), und verweisen Sie hier als $(BuildConfiguration) darauf. Auf diese Weise können Sie die Plattform ändern, wenn Sie den Build in die Warteschlange einreihen und das Erstellen mehrerer Konfigurationen ermöglichen.


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.

Tipp

Da Visual Studio als 32-Bit-Anwendung ausgeführt wird, können Probleme auftreten, wenn Ihr Build von einem Build-Agent verarbeitet wird, der die 64-Bit-Version von Team Foundation Build Service ausführt. Wenn Sie MSBuild x86auswählen, können Sie diese Probleme beheben.


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.


Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Hier erfahren Sie mehr über die Installation von Visual Studio-Images in Azure.

Wichtig

Diese Aufgabe wird nur für Agents unter Windows unterstützt.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, klassischer Build
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: msbuild, visualstudio
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Setzbare Variablen Any
Agent-Version 1.95.0 oder höher
Aufgabenkategorie Entwickeln