UseDotNet@2 – Usar a tarefa dotnet v2

Use essa tarefa para adquirir uma versão específica do SDK do .NET Core da Internet ou do cache local e adicioná-la ao PATH. Use essa tarefa para alterar a versão do .NET Core usada em tarefas subsequentes. Essa tarefa também fornece suporte a proxy.

Sintaxe

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

Entradas

packageType - Pacote a ser instalado
string. Valores permitidos: runtime, sdk (O SDK (contém runtime)). Valor padrão: sdk.

Especifica se é necessário instalar apenas o runtime do .NET ou o SDK.

useGlobalJson - Usar json global
boolean. Opcional. Use quando packageType = sdk. Valor padrão: false.

Instala todos os SDKs de global.json arquivos. Esses arquivos são pesquisados em system.DefaultWorkingDirectory. Você pode alterar o caminho raiz da pesquisa definindo a entrada do diretório de trabalho.

O 6.x formato e 6.1.x (usando .x como curinga) descrito na UseDotNet@2.version entrada é para uso na version entrada na tarefa, não no sdk.version parâmetro em global.json.

Se você receber uma mensagem de erro como ##[error]Version 6.0.x is not allowed. Allowed version types are: majorVersion.x, majorVersion.minorVersion.x, majorVersion.minorVersion.patchVersion. More details: Only explicit versions and accepted, such as: 2.2.301. Version: 6.0.x is not valid. e estiver usando global.json, verifique o sdk.version em seu global.json.

Para obter mais informações sobre global.json, consulte Selecionar a versão do .NET a ser usada.

workingDirectory - Diretório de Trabalho
string. Opcional. Use quando useGlobalJson = true.

Especifica o caminho de onde global.json os arquivos devem ser pesquisados ao usar useGlobalJson. Se o valor estiver vazio, system.DefaultWorkingDirectory será considerado como o caminho raiz.

version - Versão
string. Opcional. Use quando useGlobalJson = false || packageType = runtime.

Especifica a versão do SDK ou do runtime do .NET Core a ser instalada. Os formatos de valor de versão são mostrados com exemplos:

• 2.x: instala o SDK ou o runtime mais recente com a versão principal especificada, 2.
• 3.1.x: instala o SDK ou o runtime mais recente com as versões principais e secundárias especificadas, 3 e 1.
• 3.1.402: instala o SDK ou a versão de runtime especificada, 3.1.402.

Os valores de versão para instalações do SDK ou do runtime estão no releases.json arquivo . O link para o releases.json de uma versão principal/secundária está no arquivo releases-index . Por exemplo, o link para o arquivo releases.json para a versão 3.1.

vsVersion - Versão compatível do Visual Studio
string.

Especifica uma versão compatível do Visual Studio para uma instalação correspondente do SDK do .NET Core. O valor deve ser um número de versão completo, como 16.6.4, que contém uma versão principal, uma versão secundária e um número de patch.

Os valores de versão para instalações do SDK ou do runtime, que são usados para a version cadeia de caracteres, estão no releases.json arquivo . O link para o releases.json de uma versão principal/secundária está no arquivo releases-index . Por exemplo, o link para o arquivo releases.json para a versão 3.1.

includePreviewVersions - Incluir versões prévias
boolean. Opcional. Use quando useGlobalJson = false || packageType = runtime. Valor padrão: false.

Se definido truecomo , inclui versões prévias quando a tarefa pesquisa versões mais recentes de runtime/SDK, como pesquisar por 2.2.x ou 3.1.x. Essa configuração será ignorada se você especificar uma versão exata, como 3.0.100-preview3-010431.

installationPath - Caminho para instalar .Net Core
string. Valor padrão: $(Agent.ToolsDirectory)/dotnet.

Especifica onde o SDK/Runtime do .NET Core deve ser instalado. Caminhos diferentes podem ter o seguinte impacto em . Comportamento do NET.

• $(Agent.ToolsDirectory): o uso desse caminho armazena em cache a instalação no agente, pois esse diretório não é limpo entre pipelines. Todos os pipelines em execução no agente têm acesso às versões instaladas anteriormente.
• $(Agent.TempDirectory): o uso desse caminho garante que um pipeline não use uma versão armazenada em cache do .NET Core, pois essa pasta é limpa após cada pipeline.
• Outro caminho: você poderá usar qualquer caminho se o processo do agente tiver acesso ao caminho. Isso alterará o estado do computador e afetará todos os processos em execução nele.

Observação

Você pode usar a configuração pesquisa de vários níveis , performMultiLevelLookup, para configurar como o host .NET pesquisa versões.

performMultiLevelLookup - Executar pesquisa de vários níveis
boolean. Valor padrão: false.

Configura o comportamento do processo de host do .NET ao pesquisar uma estrutura compartilhada adequada. Os valores são:

• false: o processo de host pesquisa apenas versões presentes na pasta especificada pela tarefa.
• true: o processo de host pesquisará em locais globais predefinidos usando a pesquisa de vários níveis. Os locais globais padrão são:
  • C:\Program Files\dotnet (Processos de 64 bits)
  • C:\Program Files (x86)\dotnet (Processos de 32 bits)

Saiba mais sobre a pesquisa SharedFX de vários níveis.

Observação

performMultiLevelLookup só é aplicável a agentes baseados no Windows.

Opções de controle de tarefa

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

Variáveis de saída

Nenhum.

Comentários

A tarefa Usar .NET Core adquire uma versão específica do .NET Core da Internet ou do cache de ferramentas e a adiciona ao PATH do Agente do Azure Pipelines (hospedado ou privado). Use essa tarefa para alterar a versão do .NET Core usada em tarefas subsequentes, como DotNetCoreCLI@2. Adicionar essa tarefa antes que o DotNetCoreCLI@2 em uma definição de build garante que a versão estaria disponível no momento da criação, teste e publicação do aplicativo.

A abordagem do instalador de ferramentas também permite que você se desacopla dos ciclos de atualização do agente. Se a versão do .NET Core que você está procurando estiver ausente do agente do Azure Pipelines (hospedado ou privado), você poderá usar essa tarefa para obter a versão correta instalada no agente.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
É executado em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	A execução dessa tarefa atende às seguintes demandas para quaisquer tarefas subsequentes no mesmo trabalho: DotNetCore
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	2.144.0 ou superior
Categoria da tarefa	Ferramenta