Partilhar via

VSBuild@1 - Tarefa de compilação v1 do Visual Studio

  • Artigo

Use esta tarefa para criar com o MSBuild e definir a propriedade de versão do Visual Studio. Saiba mais sobre como instalar imagens do Visual Studio no Azure.

Sintaxe

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

Insumos

Solução solution -
string. Obrigatório. Valor padrão: **\*.sln.

Especifica a solução para a tarefa a ser usada no processo de compilação.

Se você quiser criar uma única solução, clique no botão ... e especifique a solução.

Se você quiser criar várias soluções, especifique os critérios de pesquisa. Você pode usar um curinga de pasta única (*) e curingas recursivos (**). Por exemplo, **.sln pesquisa todos os arquivos .sln em todos os subdiretórios.

Certifique-se de que as soluções especificadas sejam baixadas por esse pipeline de compilação. Na guia Repositório:

  • Se você usar TFVC, certifique-se de que a solução seja filha de um dos mapeamentos na guia Repositório.
  • Se você usa o Git, certifique-se de que o projeto ou a solução esteja no seu repositório Git e em uma ramificação que você está criando.

Tip

  • Você também pode criar arquivos de projeto MSBuild (.*proj).
  • Se você estiver criando um arquivo de projeto MSBuild personalizado, recomendamos que você use a tarefa MSBuild em vez da tarefa Visual Studio Build.

vsVersion - Versão do Visual Studio
string. Valores permitidos: 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). Valor padrão: latest.

O valor dessa entrada deve corresponder à versão do Visual Studio usada para criar sua solução.

Adiciona o argumento /p:VisualStudioVersion={numeric_visual_studio_version} ao comando MSBuild executado pela compilação. Por exemplo, se você especificar Visual Studio 2015, /p:VisualStudioVersion=14.0 será adicionado ao comando MSBuild.

Azure Pipelines: Se sua equipe quiser usar o Visual Studio com os agentes hospedados pela Microsoft, selecione mais recentes do Windows como seu pool de compilação padrão. Consulte agentes hospedados pela Microsoft.


vsVersion - Versão do Visual Studio
string. Valores permitidos: 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). Valor padrão: latest.

O valor dessa entrada deve corresponder à versão do Visual Studio usada para criar sua solução.

Adiciona o argumento /p:VisualStudioVersion={numeric_visual_studio_version} ao comando MSBuild executado pela compilação. Por exemplo, se você especificar Visual Studio 2015, /p:VisualStudioVersion=14.0 será adicionado ao comando MSBuild.

Azure Pipelines: Se sua equipe quiser usar o Visual Studio com os agentes hospedados pela Microsoft, selecione mais recentes do Windows como seu pool de compilação padrão. Consulte agentes hospedados pela Microsoft.


msbuildArgs - Argumentos do MSBuild
string.

Passa argumentos adicionais para MSBuild. Para sintaxe, consulte MSBuild Command-Line Reference.


platform - Plataforma
string.

Especifica a plataforma que você deseja criar, como Win32, x86, x64ou any cpu.

Tip

  • Se você estiver direcionando um arquivo de projeto MSBuild (.*proj) em vez de uma solução, especifique AnyCPU (sem espaço em branco).
  • Declare uma variável de compilação como BuildPlatform na guia Variáveis (selecionando Permitir no Tempo da Fila) e faça referência a ela aqui como $(BuildPlatform). Dessa forma, você pode modificar a plataforma quando enfileirar a compilação e habilitar a criação de várias configurações.

configuration - de configuração
string.

Especifica a configuração que você deseja criar, como debug ou release.

Tip

Declare uma variável de compilação como BuildConfiguration na guia Variáveis (selecionando Permitir no Tempo da Fila) e faça referência a ela aqui como $(BuildConfiguration). Dessa forma, você pode modificar a plataforma quando enfileirar a compilação e habilitar a criação de várias configurações.


clean - Limpar
boolean. Valor padrão: false.

Se definido como false, a tarefa fará uma compilação incremental. Essa configuração pode reduzir o tempo de compilação, especialmente se a base de código for grande. Esta opção não tem efeito prático, a menos que você também defina o repositório Limpar como false.

Se definido como true, a tarefa reconstrói todo o código nos projetos de código. Isso é equivalente ao argumento MSBuild /target:clean.


maximumCpuCount - Construir em paralelo
boolean. Valor padrão: false.

Opcional. Se a configuração de destino do MSBuild for compatível com a construção em paralelo, você poderá verificar essa entrada para passar a opção /m para o MSBuild (somente Windows). Se sua configuração de destino não for compatível com a construção em paralelo, marcar essa opção pode fazer com que sua compilação resulte em erros de arquivo em uso ou falhas de compilação intermitentes ou inconsistentes.


restoreNugetPackages - Restaurar pacotes NuGet
boolean. Valor padrão: false.

Esta entrada foi preterida. Para restaurar pacotes NuGet, adicione um Instalador da Ferramenta NuGet tarefa antes da compilação.


msbuildArchitecture - de arquitetura do MSBuild
string. Valores permitidos: x86 (MSBuild x86), x64 (MSBuild x64). Valor padrão: x86.

Opcional. Fornece a arquitetura (x86 ou x64) do MSBuild para executar.

Tip

Como o Visual Studio é executado como um aplicativo de 32 bits, você pode ter problemas quando sua compilação é processada por um agente de compilação que está executando a versão de 64 bits do serviço Team Foundation Build. Ao selecionar MSBuild x86, você pode resolver esses problemas.


logProjectEvents - Registrar detalhes do projeto
boolean. Valor padrão: true.

Opcional. Registra os detalhes da linha do tempo de cada projeto.


createLogFile - Criar arquivo de log
boolean. Valor padrão: false.

Opcional. Cria um arquivo de log (somente Windows).


logFileVerbosity - de Verbosidade do Arquivo de Log
string. Opcional. Use quando createLogFile = true. Valores permitidos: quiet, minimal, normal, detailed, diagnostic. Valor padrão: normal.

Especifica o nível de detalhamento nos arquivos de log.


enableDefaultLogger - Ativar Registrador Padrão
boolean. Valor padrão: true.

Se definido como true, habilita o registrador padrão para MSBuild.


customVersion - versão personalizada
string.

Define uma versão personalizada do Visual Studio. Exemplos: 15.0, 16.0, 17.0. A versão necessária do Visual Studio deve ser instalada no sistema.

do Azure Pipelines: Se sua equipe quiser usar o Visual Studio 2022 com os agentes hospedados pela Microsoft, selecione windows-2022 como seu pool de compilação padrão. Para saber mais, veja agentes hospedados pela Microsoft.


Opções de controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Saiba mais sobre como instalar imagens do Visual Studio no Azure.

Importante

Esta tarefa só é suportada em agentes que executam o Windows.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, construção clássica
Funciona em Agente, DeploymentGroup
Exigências Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas executar trabalhos que usam essa tarefa: msbuild, visualstudio
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.95.0 ou superior
Categoria de tarefa Construir