Delen via


VSBuild@1 - Visual Studio build v1-taak

Gebruik deze taak om te bouwen met MSBuild en de visual studio-versie-eigenschap in te stellen. Meer informatie over het installeren van Visual Studio-installatiekopieën 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.

Invoerwaarden

solution - Oplossing
string. Vereist. Standaardwaarde: **\*.sln.

Hiermee geeft u de oplossing voor de taak te gebruiken in het buildproces.

Als u één oplossing wilt bouwen, klikt u op de knop ... en geeft u de oplossing op.

Als u meerdere oplossingen wilt bouwen, geeft u de zoekcriteria op. U kunt een jokerteken met één map (*) en recursieve jokertekens () gebruiken.** Zoekt bijvoorbeeld **.sln naar alle .sln bestanden in alle submappen.

Zorg ervoor dat de oplossingen die u opgeeft, worden gedownload door deze build-pijplijn. Op het tabblad Opslagplaats:

  • Als u TFVC gebruikt, moet u ervoor zorgen dat de oplossing een onderliggend element is van een van de toewijzingen op het tabblad Opslagplaats.
  • Als u Git gebruikt, moet u ervoor zorgen dat het project of de oplossing zich in uw Git-opslagplaats bevindt en in een vertakking die u bouwt.

Tip

  • U kunt ook MSBuild-projectbestanden (.*proj) maken.
  • Als u een aangepast MSBuild-projectbestand maakt, raden we u aan de taak MSBuild te gebruiken in plaats van de Visual Studio Build-taak.

vsVersion - Visual Studio-versie
string. Toegestane waarden: 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). Standaardwaarde: latest.

De waarde van deze invoer moet overeenkomen met de versie van Visual Studio die wordt gebruikt om uw oplossing te maken.

Hiermee voegt u het /p:VisualStudioVersion={numeric_visual_studio_version} argument toe aan de MSBuild-opdracht die wordt uitgevoerd door de build. Als u bijvoorbeeld Visual Studio 2015 opgeeft, /p:VisualStudioVersion=14.0 wordt toegevoegd aan de opdracht MSBuild.

Azure Pipelines: als uw team Visual Studio wil gebruiken met de door Microsoft gehoste agents, selecteert u windows-latest als uw standaard buildpool. Zie Door Microsoft gehoste agents.


vsVersion - Visual Studio-versie
string. Toegestane waarden: 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). Standaardwaarde: latest.

De waarde van deze invoer moet overeenkomen met de versie van Visual Studio die wordt gebruikt om uw oplossing te maken.

Hiermee voegt u het /p:VisualStudioVersion={numeric_visual_studio_version} argument toe aan de MSBuild-opdracht die wordt uitgevoerd door de build. Als u bijvoorbeeld Visual Studio 2015 opgeeft, /p:VisualStudioVersion=14.0 wordt toegevoegd aan de opdracht MSBuild.

Azure Pipelines: als uw team Visual Studio wil gebruiken met de door Microsoft gehoste agents, selecteert u windows-latest als uw standaard buildpool. Zie Door Microsoft gehoste agents.


msbuildArgs - MSBuild-argumenten
string.

Geeft aanvullende argumenten door aan MSBuild. Zie MSBuild Command-Line Reference voor syntaxis.


platform - Platform
string.

Hiermee geeft u het platform op dat u wilt bouwen, zoals Win32, x86, x64of any cpu.

Tip

  • Als u zich richt op een MSBuild-projectbestand (.*proj) in plaats van een oplossing, geeft u AnyCPU (geen witruimte) op.
  • Declareer een buildvariabele zoals BuildPlatform op het tabblad Variabelen (selecteer Toestaan op wachtrijtijd) en verwijs hier naar $(BuildPlatform). Op deze manier kunt u het platform wijzigen wanneer u de build in de wachtrij zet en het bouwen van meerdere configuraties inschakelt.

configuration - Configuratie
string.

Hiermee geeft u de configuratie die u wilt bouwen, zoals debug of release.

Tip

Declareer een buildvariabele zoals BuildConfiguration op het tabblad Variabelen (selecteer Toestaan op wachtrijtijd) en verwijs hier naar $(BuildConfiguration). Op deze manier kunt u het platform wijzigen wanneer u de build in de wachtrij zet en het bouwen van meerdere configuraties inschakelt.


clean - Schoon
boolean. Standaardwaarde: false.

Als dit is ingesteld op false, maakt de taak een incrementele build. Deze instelling kan de buildtijd verkorten, met name als uw codebasis groot is. Deze optie heeft geen praktisch effect, tenzij u ook de opslagplaats Opschonen instelt op false.

Als dit is ingesteld op true, wordt met de taak alle code in de codeprojecten opnieuw opgebouwd. Dit komt overeen met het argument MSBuild /target:clean .


maximumCpuCount - Parallel bouwen
boolean. Standaardwaarde: false.

Optioneel. Als uw MSBuild-doelconfiguratie compatibel is met parallel bouwen, kunt u deze invoer controleren om de /m overschakeling door te geven aan MSBuild (alleen Windows). Als uw doelconfiguratie niet compatibel is met parallel bouwen, kan het controleren van deze optie leiden tot fouten bij het gebruik van bestanden of onregelmatige of inconsistente buildfouten.


restoreNugetPackages - NuGet-pakketten herstellen
boolean. Standaardwaarde: false.

Deze invoer is afgeschaft. Als u NuGet-pakketten wilt herstellen, voegt u vóór de build een taak voor het installatieprogramma van het NuGet-hulpprogramma toe.


msbuildArchitecture - MSBuild-architectuur
string. Toegestane waarden: x86 (MSBuild x86), x64 (MSBuild x64). Standaardwaarde: x86.

Optioneel. Levert de architectuur (x86 of x64) van MSBuild die moet worden uitgevoerd.

Tip

Omdat Visual Studio wordt uitgevoerd als een 32-bits toepassing, kunnen er problemen optreden wanneer uw build wordt verwerkt door een buildagent waarop de 64-bits versie van Team Foundation Build Service wordt uitgevoerd. Als u MSBuild x86selecteert, kunt u deze problemen oplossen.


logProjectEvents - Projectdetails opnemen
boolean. Standaardwaarde: true.

Optioneel. Registreert tijdlijngegevens voor elk project.


createLogFile - Logboekbestand maken
boolean. Standaardwaarde: false.

Optioneel. Hiermee maakt u een logboekbestand (alleen Windows).


logFileVerbosity - Uitgebreidheid van logboekbestand
string. Optioneel. Gebruik wanneer createLogFile = true. Toegestane waarden: quiet, minimal, normal, detailed, . diagnostic Standaardwaarde: normal.

Hiermee geeft u het uitgebreidheidsniveau in logboekbestanden op.


enableDefaultLogger - Standaardlogboekregistratie inschakelen
boolean. Standaardwaarde: true.

Als dit is ingesteld op true, schakelt u de standaardlogboekregistratie voor MSBuild in.


customVersion - Aangepaste versie
string.

Hiermee stelt u een aangepaste versie van Visual Studio in. Voorbeelden: 15.0, 16.0, 17.0. De vereiste versie van Visual Studio moet in het systeem zijn geïnstalleerd.

Azure Pipelines: als uw team Visual Studio 2022 wil gebruiken met de door Microsoft gehoste agents, selecteert u windows-2022 als uw standaard buildpool. Zie Door Microsoft gehoste agents voor meer informatie.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Meer informatie over het installeren van Visual Studio-installatiekopieën in Azure.

Belangrijk

Deze taak wordt alleen ondersteund op agents met Windows.

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die gebruikmaken van deze taak: msbuild, visualstudio
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie 1.95.0 of hoger
Taakcategorie Build