VSBuild@1 – Visual Studio build v1-uppgift

Använd den här uppgiften för att skapa med MSBuild och ange visual studioversionsegenskapen. Läs mer om hur du installerar Visual Studio-avbildningar i 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.

Indata

solution - Lösning
string. Krävs. Standardvärde: **\*.sln.

Anger lösningen för uppgiften som ska användas i byggprocessen.

Om du vill skapa en enda lösning klickar du på knappen ... och anger lösningen.

Om du vill skapa flera lösningar anger du sökvillkoren. Du kan använda jokertecken med en mapp (*) och rekursiva jokertecken (**). Söker till exempel **.sln efter alla .sln filer i alla underkataloger.

Kontrollera att de lösningar som du anger laddas ned av den här bygg-pipelinen. På fliken Lagringsplats:

• Om du använder TFVC kontrollerar du att lösningen är underordnad någon av mappningarna på fliken Lagringsplats.
• Om du använder Git kontrollerar du att projektet eller lösningen finns på din Git-lagringsplats och i en gren som du skapar.

Tips

• Du kan också skapa MSBuild-projektfiler (.*proj).
• Om du skapar en anpassad MSBuild-projektfil rekommenderar vi att du använder MSBuild-uppgiften i stället för Visual Studio Build-uppgiften.

vsVersion - Visual Studio-version
string. Tillåtna värden: 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). Standardvärde: latest.

Värdet för dessa indata måste matcha den version av Visual Studio som används för att skapa din lösning.

/p:VisualStudioVersion={numeric_visual_studio_version} Lägger till argumentet i MSBuild-kommandot som körs av bygget. Om du till exempel anger Visual Studio 2015/p:VisualStudioVersion=14.0 läggs till i MSBuild-kommandot.

Azure Pipelines: Om ditt team vill använda Visual Studio med Microsofts värdbaserade agenter väljer du windows-latest som standardversionspool. Se Microsofts värdbaserade agenter.

msbuildArgs - MSBuild-argument
string.

Skickar ytterligare argument till MSBuild. Syntax finns i REFERENS för MSBuild Command-Line.

platform - Plattform
string.

Anger den plattform som du vill skapa, till exempel Win32, x86, x64eller any cpu.

Tips

• Om du riktar in dig på en MSBuild-projektfil (.*proj) i stället för en lösning anger du AnyCPU (inget blanksteg).
• Deklarera en byggvariabel, till exempel BuildPlatform på fliken Variabler (välj Tillåt vid kötid) och referera till den här som $(BuildPlatform). På så sätt kan du ändra plattformen när du köar bygget och gör det möjligt att skapa flera konfigurationer.

configuration - Konfiguration
string.

Anger den konfiguration som du vill skapa, till exempel debug eller release.

Tips

Deklarera en byggvariabel, till exempel BuildConfiguration på fliken Variabler (välj Tillåt vid kötid) och referera till den här som $(BuildConfiguration). På så sätt kan du ändra plattformen när du köar bygget och gör det möjligt att skapa flera konfigurationer.

clean - Ren
boolean. Standardvärde: false.

Om värdet är falsegör uppgiften en inkrementell version. Den här inställningen kan minska byggtiden, särskilt om din kodbas är stor. Det här alternativet har ingen praktisk effekt om du inte också ställer in Clean-lagringsplatsen på false.

Om den är inställd truepå återskapar aktiviteten all kod i kodprojekten. Detta motsvarar argumentet MSBuild /target:clean .

maximumCpuCount - Skapa parallellt
boolean. Standardvärde: false.

Valfritt. Om din MSBuild-målkonfiguration är kompatibel med att bygga parallellt kan du kontrollera dessa indata för att skicka växeln /m till MSBuild (endast Windows). Om målkonfigurationen inte är kompatibel med att bygga parallellt kan kontrollen av det här alternativet leda till att bygget resulterar i filanvändningsfel eller tillfälliga eller inkonsekventa byggfel.

restoreNugetPackages - Återställa NuGet-paket
boolean. Standardvärde: false.

Indata är inaktuella. Om du vill återställa NuGet-paket lägger du till en NuGet Tool Installer-uppgift före bygget.

msbuildArchitecture - MSBuild-arkitektur
string. Tillåtna värden: x86 (MSBuild x86), x64 (MSBuild x64). Standardvärde: x86.

Valfritt. Tillhandahåller arkitekturen (x86 eller x64) för MSBuild som ska köras.

Tips

Eftersom Visual Studio körs som ett 32-bitarsprogram kan det uppstå problem när bygget bearbetas av en byggagent som kör 64-bitarsversionen av Team Foundation Build Service. Genom att välja MSBuild x86kan du lösa dessa problem.

logProjectEvents - Registrera projektinformation
boolean. Standardvärde: true.

Valfritt. Innehåller information om tidslinjen för varje projekt.

createLogFile - Skapa loggfil
boolean. Standardvärde: false.

Valfritt. Skapar en loggfil (endast Windows).

logFileVerbosity - Utförlig loggfil
string. Valfritt. Använd när createLogFile = true. Tillåtna värden: quiet, minimal, normal, detailed, diagnostic. Standardvärde: normal.

Anger detaljnivån i loggfilerna.

enableDefaultLogger - Aktivera standardloggare
boolean. Standardvärde: true.

Om värdet är trueaktiveras standardloggaren för MSBuild.

customVersion - Anpassad version
string.

Anger en anpassad version av Visual Studio. Exempel: 15.0, 16.0, 17.0. Den version av Visual Studio som krävs måste vara installerad i systemet.

Azure Pipelines: Om ditt team vill använda Visual Studio 2022 med Microsofts värdbaserade agenter väljer du windows-2022 som standardversionspool. Mer information finns i Microsofts värdbaserade agenter.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Läs mer om hur du installerar Visual Studio-avbildningar i Azure.

Viktigt

Den här uppgiften stöds bara på agenter som kör Windows.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: msbuild, visualstudio
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	1.95.0 eller senare
Uppgiftskategori	Build