VSBuild@1 - Attività build v1 di Visual Studio

Articolo
03/24/2025

Usare questa attività per compilare con MSBuild e impostare la proprietà della versione di Visual Studio. Altre informazioni sull'installazione di immagini di Visual Studio in Azure.

Sintassi

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

Ingressi dati

solution - soluzione
string. Obbligatorio. Valore predefinito: **\*.sln

Specifica la soluzione da usare nell'attività nel processo di compilazione.

Per creare una singola soluzione, fare clic sul pulsante ... e specificare la soluzione.

Per creare più soluzioni, specificare i criteri di ricerca. È possibile usare un carattere jolly a cartella singola (*) e i caratteri jolly ricorsivi (**). Ad esempio, **.sln cerca tutti i file .sln in tutte le sottodirectory.

Assicurarsi che le soluzioni specificate vengano scaricate da questa pipeline di compilazione. Nella scheda Repository:

Se si usa TFVC, assicurarsi che la soluzione sia figlio di uno dei mapping nella scheda Repository.
Se si usa Git, assicurarsi che il progetto o la soluzione si trovi nel repository Git e in un ramo che si sta compilando.

Suggerimento

È anche possibile compilare file di progetto MSBuild (con estensione*proj).
Se si compila un file di progetto MSBuild personalizzato, è consigliabile usare l'attività MSBuild anziché l'attività Di compilazione di Visual Studio.

vsVersion - della versione di Visual Studio
string. Valori consentiti: 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). Valore predefinito: latest

Il valore di questo input deve corrispondere alla versione di Visual Studio usata per creare la soluzione.

Aggiunge l'argomento /p:VisualStudioVersion={numeric_visual_studio_version} al comando MSBuild eseguito dalla compilazione. Ad esempio, se si specifica Visual Studio 2015, /p:VisualStudioVersion=14.0 viene aggiunto al comando MSBuild.

azure Pipelines: se il team vuole usare Visual Studio con gli agenti ospitati da Microsoft, selezionare windows-latest come pool di compilazione predefinito. Vedere agenti ospitati da Microsoft.

vsVersion - della versione di Visual Studio
string. Valori consentiti: 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). Valore predefinito: latest

Il valore di questo input deve corrispondere alla versione di Visual Studio usata per creare la soluzione.

azure Pipelines: se il team vuole usare Visual Studio con gli agenti ospitati da Microsoft, selezionare windows-latest come pool di compilazione predefinito. Vedere agenti ospitati da Microsoft.

msbuildArgs - argomenti DI MSBuild
string.

Passa argomenti aggiuntivi a MSBuild. Per la sintassi, vedere riferimento a MSBuild Command-Line .

piattaforma platform -
string.

Specifica la piattaforma da compilare, ad esempio Win32, x86, x64o any cpu.

Suggerimento

Se si usa come destinazione un file di progetto MSBuild (con estensione*proj) anziché una soluzione, specificare AnyCPU (senza spazi vuoti).
Dichiarare una variabile di compilazione, ad esempio BuildPlatform nella scheda Variabili (selezionando Consenti in fase di coda) e farvi riferimento come $(BuildPlatform). In questo modo è possibile modificare la piattaforma quando si accoda la compilazione e si abilita la compilazione di più configurazioni.

configuration - configurazione
string.

Specifica la configurazione da compilare, ad esempio debug o release.

Suggerimento

Dichiarare una variabile di compilazione, ad esempio BuildConfiguration nella scheda Variabili (selezionando Consenti in fase di coda) e farvi riferimento come $(BuildConfiguration). In questo modo è possibile modificare la piattaforma quando si accoda la compilazione e si abilita la compilazione di più configurazioni.

clean - clean
boolean. Valore predefinito: false

Se impostato su false, l'attività esegue una compilazione incrementale. Questa impostazione potrebbe ridurre il tempo di compilazione, soprattutto se la codebase è di grandi dimensioni. Questa opzione non ha alcun effetto pratico, a meno che non si imposti anche il repository Clean su false.

Se impostato su true, l'attività ricompila tutto il codice nei progetti di codice. Equivale all'argomento /target:clean MSBuild.

maximumCpuCount - compilazione in parallelo
boolean. Valore predefinito: false

Opzionale. Se la configurazione di destinazione MSBuild è compatibile con la compilazione in parallelo, è possibile controllare questo input per passare l'opzione /m a MSBuild (solo Windows). Se la configurazione di destinazione non è compatibile con la compilazione in parallelo, la verifica di questa opzione può causare errori di compilazione in uso o intermittenti o incoerenti.

restoreNugetPackages - ripristinare i pacchetti NuGet
boolean. Valore predefinito: false

Questo input è deprecato. Per ripristinare i pacchetti NuGet, aggiungere un programma di installazione dello strumento NuGet attività prima della compilazione.

msbuildArchitecture - 'architettura di MSBuild
string. Valori consentiti: x86 (MSBuild x86), x64 (MSBuild x64). Valore predefinito: x86

Opzionale. Fornisce l'architettura (x86 o x64) di MSBuild da eseguire.

Suggerimento

Poiché Visual Studio viene eseguito come applicazione a 32 bit, è possibile che si verifichino problemi quando la compilazione viene elaborata da un agente di compilazione che esegue la versione a 64 bit del servizio Team Foundation Build. Selezionando MSBuild x86, è possibile risolvere questi problemi.

logProjectEvents - Record Project Details
boolean. Valore predefinito: true

Opzionale. Registra i dettagli della sequenza temporale per ogni progetto.

createLogFile - Creare file di log
boolean. Valore predefinito: false

Opzionale. Crea un file di log (solo Windows).

logFileVerbosity - di dettaglio dei file di log
string. Opzionale. Usare quando createLogFile = true. Valori consentiti: quiet, minimal, normal, detailed, diagnostic. Valore predefinito: normal

Specifica il livello di dettaglio nei file di log.

enableDefaultLogger - Abilitare il logger predefinito
boolean. Valore predefinito: true

Se impostato su true, abilita il logger predefinito per MSBuild.

customVersion - versione personalizzata
string.

Imposta una versione personalizzata di Visual Studio. Esempi: 15.0, 16.0, 17.0. La versione richiesta di Visual Studio deve essere installata nel sistema.

Azure Pipelines: se il team vuole usare Visual Studio 2022 con gli agenti ospitati da Microsoft, selezionare windows-2022 come pool di compilazione predefinito. Per altre informazioni, vedere agenti ospitati da Microsoft.

Opzioni di controllo attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni:

Altre informazioni sull'installazione di immagini di Visual Studio in Azure.

Importante

Questa attività è supportata solo per gli agenti che eseguono Windows.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Viene eseguito in	Agente, DeploymentGroup
richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle seguenti richiedono di eseguire processi che usano questa attività: msbuild, visualstudio
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	1.95.0 o versione successiva
Categoria attività	Costruire

Condividi tramite

VSBuild@1 - Attività build v1 di Visual Studio

Sintassi

Ingressi dati

Opzioni di controllo attività

Variabili di output

Osservazioni:

Requisiti

Commenti e suggerimenti

Risorse aggiuntive