Condividi tramite


VSBuild@1 - Attività build v1 di Visual Studio

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

Input

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

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

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

Se si vogliono compilare 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 - Versione di Visual Studio
string. Valori consentiti: latest, 17.0 (Visual Studio 2022), 16.0 (Visual Studio 2019), (Visual Studio 2017), 14.015.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 - 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.

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.


msbuildArgs - Argomenti di MSBuild
string.

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


platform - Piattaforma
string.

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

Suggerimento

  • Se si ha come destinazione un file di progetto MSBuild (.*proj) anziché una soluzione, specificare AnyCPU (senza spazi vuoti).
  • Dichiarare una variabile di compilazione, ad BuildPlatform esempio nella scheda Variabili (selezionando Consenti in fase di coda) e farvi riferimento qui 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 BuildConfiguration esempio nella scheda Variabili (selezionando Consenti in fase di coda) e farvi riferimento qui come $(BuildConfiguration). In questo modo è possibile modificare la piattaforma quando si accoda la compilazione e si abilita la compilazione di più configurazioni.


clean - Pulito
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 MSBuild /target:clean .


maximumCpuCount - Compilazione in parallelo
boolean. Valore predefinito: false.

facoltativo. 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 pacchetti NuGet
boolean. Valore predefinito: false.

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


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

facoltativo. 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 - Registrare i dettagli del progetto
boolean. Valore predefinito: true.

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


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

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


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

Specifica il livello di dettaglio nei file di log.


enableDefaultLogger - Abilita 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 info, vedi Agenti ospitati da Microsoft.


Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input 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 soddisfano le richieste seguenti per eseguire processi che usano questa attività: msbuild, visualstudio
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente 1.95.0 o versione successiva
Categoria attività Compilazione