VSBuild@1 – Tarefa de build v1 do Visual Studio

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

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

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

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

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.

Verifique se as soluções especificadas são baixadas por este pipeline de build. Na guia Repositório:

• Se você usar o TFVC, verifique se a solução é filho de um dos mapeamentos na guia Repositório.
• Se você usar o Git, verifique se o projeto ou a solução está em seu repositório Git e em um branch que você está criando.

vsVersion - de 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 pelo build. Por exemplo, se você especificar do Visual Studio 2015, /p:VisualStudioVersion=14.0 será adicionado ao comando MSBuild.

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

msbuildArgs - argumentos do MSBuild
string.

Passa argumentos adicionais para o MSBuild. Para obter sintaxe, consulte de referência de Command-Line do MSBuild.

platform - Plataforma
string.

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

de Configuração do configuration -
string.

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

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

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

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

compilação maximumCpuCount - em paralela
boolean. Valor padrão: false.

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

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

Essa entrada foi preterida. Para restaurar pacotes NuGet, adicione uma tarefa Instalador de Ferramentas Do NuGet antes do build.

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 execução.

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

Opcional. Registra detalhes da linha do tempo para cada projeto.

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

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

logFileVerbosity - verbosity 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 verbosidade nos arquivos de log.

enableDefaultLogger - habilitar de agente padrão
boolean. Valor padrão: true.

Se definido como true, habilita o agente padrão para o 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 build padrão. Para obter mais informações, consulte agentes hospedados pela Microsoft.

Nenhum.