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.

Syntaxis

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

Invoer

solution - Solution
string. Verplicht. Standaardwaarde: **\*.sln.

Hiermee geeft u de oplossing voor de taak die moet worden gebruikt 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. **.sln zoekt bijvoorbeeld 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.

Hint

• U kunt ook MSBuild-projectbestanden (.*proj) bouwen.
• Als u een aangepast MSBuild-projectbestand bouwt, raden we u aan de MSBuild-taak 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 argument /p:VisualStudioVersion={numeric_visual_studio_version} toe aan de MSBuild-opdracht die door de build wordt uitgevoerd. Als u bijvoorbeeld Visual Studio 2015-opgeeft, wordt /p:VisualStudioVersion=14.0 toegevoegd aan de OPDRACHT MSBuild.

Azure Pipelines: als uw team Visual Studio wil gebruiken met de door Microsoft gehoste agents, selecteert u meest recente windows- als uw standaardbuildpool. Zie door Microsoft gehoste agents.

msbuildArgs - MSBuild-argumenten
string.

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

platform - Platform-
string.

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

Hint

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

configuration - configuratie
string.

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

Hint

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

clean - opschonen
boolean. Standaardwaarde: false.

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

Als deze optie 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 - bouwen in parallelle
boolean. Standaardwaarde: false.

Facultatief. Als uw MSBuild-doelconfiguratie compatibel is met het parallel bouwen, kunt u deze invoer controleren om de /m-switch door te geven aan MSBuild (alleen Windows). Als uw doelconfiguratie niet compatibel is met het parallel bouwen, kan het controleren van deze optie ertoe leiden dat uw build fouten veroorzaakt die in het bestand worden gebruikt, 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 NuGet Tool Installer taak toe.

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

Facultatief. Hiermee wordt de architectuur (x86 of x64) van MSBuild geleverd om uit te voeren.

Hint

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. Door MSBuild x86te selecteren, kunt u deze problemen oplossen.

logProjectEvents - Projectdetails opnemen
boolean. Standaardwaarde: true.

Facultatief. Registreert tijdlijngegevens voor elk project.

createLogFile - logboekbestand maken
boolean. Standaardwaarde: false.

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

logFileVerbosity - uitgebreidheidslogboekbestand
string. Facultatief. Gebruiken wanneer createLogFile = true. Toegestane waarden: quiet, minimal, normal, detailed, diagnostic. Standaardwaarde: normal.

Hiermee geeft u het uitgebreidheidsniveau in logboekbestanden.

enableDefaultLogger - Standaardlogboekregistratie inschakelen
boolean. Standaardwaarde: true.

Als deze optie is ingesteld op true, schakelt u de standaardlogger 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 worden geïnstalleerd in het systeem.

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

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor 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

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen om taken uit te voeren die gebruikmaken van deze taak: msbuild, visualstudio
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	1.95.0 of hoger
Taakcategorie	Bouwen