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

Utilize esta tarefa para criar com o MSBuild e definir a propriedade versão do Visual Studio. Saiba mais sobre como instalar imagens do Visual Studio no 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.

Entradas

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

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

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

Se quiser criar várias soluções, especifique os critérios de pesquisa. Pode utilizar um caráter universal de pasta única (*) e carateres universais recursivos (**). Por exemplo, **.sln procura todos os .sln ficheiros em todos os subdiretórios.

Certifique-se de que as soluções especificadas são transferidas por este pipeline de compilação. No separador Repositório:

• Se utilizar o TFVC, certifique-se de que a solução é um subordinado de um dos mapeamentos no separador Repositório.
• Se utilizar o Git, certifique-se de que o projeto ou solução está no seu repositório git e num ramo que está a criar.

Dica

• Também pode criar ficheiros do projeto MSBuild (.*proj).
• Se estiver a criar um ficheiro de projeto MSBuild personalizado, recomendamos que utilize a tarefa MSBuild em vez da tarefa de Compilação do Visual Studio.

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 predefinido: latest.

O valor desta entrada tem de corresponder à versão do Visual Studio utilizada para criar a sua solução.

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

Pipelines do Azure: se a sua equipa quiser utilizar o Visual Studio com os agentes alojados na Microsoft, selecione windows-latest como o conjunto de compilação predefinido. Veja Agentes alojados na Microsoft.

msbuildArgs - Argumentos MSBuild
string.

Transmite argumentos adicionais para MSBuild. Para sintaxe, veja MsBuild Command-Line Reference (Referência de Command-Line MSBuild).

platform - Plataforma
string.

Especifica a plataforma que pretende criar, como Win32, x86, x64ou any cpu.

Dica

• Se estiver a direcionar um ficheiro 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 no separador Variáveis (selecionando Permitir no Tempo da Fila) e veja-a aqui como $(BuildPlatform). Desta forma, pode modificar a plataforma quando coloca em fila a compilação e ativa a criação de múltiplas configurações.

configuration - Configuração
string.

Especifica a configuração que pretende criar, como debug ou release.

Dica

Declare uma variável de compilação, como BuildConfiguration no separador Variáveis (selecionando Permitir no Tempo da Fila) e veja-a aqui como $(BuildConfiguration). Desta forma, pode modificar a plataforma quando coloca em fila a compilação e ativa a criação de múltiplas configurações.

clean - Limpar
boolean. Valor predefinido: false.

Se estiver definida como false, a tarefa cria uma compilação incremental. Esta definição poderá reduzir o tempo de compilação, especialmente se a base de código for grande. Esta opção não tem qualquer efeito prático, a menos que também defina o repositório Limpar como false.

Se estiver definida como true, a tarefa recompila todo o código nos projetos de código. Isto é equivalente ao argumento MSBuild /target:clean .

maximumCpuCount - Compilar em Paralelo
boolean. Valor predefinido: false.

Opcional. Se a configuração de destino MSBuild for compatível com a criação em paralelo, pode verificar esta entrada para passar o /m comutador para MSBuild (apenas Windows). Se a configuração de destino não for compatível com a criação em paralelo, verificar esta opção pode fazer com que a compilação resulte em erros de utilização de ficheiros ou falhas de compilação intermitentes ou inconsistentes.

restoreNugetPackages - Restaurar Pacotes NuGet
boolean. Valor predefinido: false.

Esta entrada foi preterida. Para restaurar pacotes NuGet, adicione uma tarefa do Instalador de Ferramentas NuGet antes da compilação.

msbuildArchitecture - Arquitetura MSBuild
string. Valores permitidos: x86 (MSBuild x86), x64 (MSBuild x64). Valor predefinido: x86.

Opcional. Fornece a arquitetura (x86 ou x64) do MSBuild para execução.

Dica

Uma vez que o Visual Studio é executado como uma aplicação de 32 bits, poderá ter problemas quando a compilação é processada por um agente de compilação que está a executar a versão de 64 bits do Team Foundation Build Service. Ao selecionar MSBuild x86, poderá resolver estes problemas.

logProjectEvents - Gravar Detalhes do Projeto
boolean. Valor predefinido: true.

Opcional. Regista os detalhes da linha cronológica de cada projeto.

createLogFile - Criar Ficheiro de Registo
boolean. Valor predefinido: false.

Opcional. Cria um ficheiro de registo (apenas o Windows).

logFileVerbosity - Verbosidade do Ficheiro de Registo
string. Opcional. Utilize quando createLogFile = true. Valores permitidos: quiet, minimal, , normaldetailed, diagnostic. Valor predefinido: normal.

Especifica o nível de verbosidade nos ficheiros de registo.

enableDefaultLogger - Ativar o Logger Predefinido
boolean. Valor predefinido: true.

Se estiver definido como true, ativa o logger predefinido para MSBuild.

customVersion - Versão Personalizada
string.

Define uma versão personalizada do Visual Studio. Exemplos: 15.0, , 17.016.0. A versão necessária do Visual Studio tem de ser instalada no sistema.

Pipelines do Azure: se a sua equipa quiser utilizar o Visual Studio 2022 com os agentes alojados na Microsoft, selecione windows-2022 como conjunto de compilação predefinido. Para obter mais informações, consulte Agentes alojados na Microsoft.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo 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 com o Windows.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica
É executado em	Agent, DeploymentGroup
Exigências	Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizem esta tarefa: msbuild, visualstudio
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de definição	Qualquer
Versão do agente	1.95.0 ou superior
Categoria da tarefa	Compilação