UseDotNet@2 - Utilizar a tarefa dotnet v2

Utilize esta tarefa para adquirir uma versão específica do SDK .NET Core a partir da Internet ou da cache local e adicioná-la ao PATH. Utilize esta tarefa para alterar a versão do .NET Core que é utilizada em tarefas subsequentes. Esta tarefa também fornece suporte de proxy.

Syntax

# 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 instalar
string. Valores permitidos: runtime, sdk (SDK (contém runtime)). Valor predefinido: sdk.

Especifica se pretende instalar apenas o runtime do .NET ou o SDK.

useGlobalJson - Utilizar json global
boolean. Opcional. Utilize quando packageType = sdk. Valor predefinido: false.

Instala todos os SDKs a partir de global.json ficheiros. Estes ficheiros são pesquisados a partir de system.DefaultWorkingDirectory. Pode alterar o caminho de raiz de pesquisa ao definir a entrada do diretório de trabalho.

O 6.x formato e 6.1.x (utilizando .x como caráter universal) descrito na UseDotNet@2.version entrada é para utilização na version entrada na tarefa e não no sdk.version parâmetro em global.json.

Se 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 a utilizar global.json, verifique o sdk.version no .global.json

Para obter mais informações sobre global.jsono , consulte Selecionar a versão do .NET a utilizar.

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

Especifica o caminho a partir do global.json qual os ficheiros devem ser pesquisados ao utilizar useGlobalJson. Se o valor estiver vazio, system.DefaultWorkingDirectory será considerado como o caminho raiz.

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

Especifica a versão do SDK do .NET Core ou do runtime a instalar. Os formatos de valor da versão são apresentados com exemplos:

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

Os valores de versão das instalações do SDK ou do runtime estão no releases.json ficheiro. A ligação para a releases.json de uma versão principal/secundária está no ficheiro releases-index . Por exemplo, a ligação para o ficheiro 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 do SDK .NET Core correspondente. O valor tem de 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 de SDK ou runtime, que são utilizados para a version cadeia, estão no releases.json ficheiro. A ligação para a releases.json de uma versão principal/secundária está no ficheiro releases-index . Por exemplo, a ligação para o ficheiro releases.json para a versão 3.1.

includePreviewVersions - Incluir Versões de Pré-visualização
boolean. Opcional. Utilize quando useGlobalJson = false || packageType = runtime. Valor predefinido: false.

Se estiver definido como true, inclui versões de pré-visualização quando a tarefa procura versões mais recentes do runtime/SDK, como procurar 2.2.x ou 3.1.x. Esta definição é ignorada se especificar uma versão exata, como 3.0.100-preview3-010431.

installationPath - Caminho para Instalar o .Net Core
string. Valor predefinido: $(Agent.ToolsDirectory)/dotnet.

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

• $(Agent.ToolsDirectory): a utilização deste caminho coloca em cache a instalação no agente, uma vez que este diretório não é limpo em pipelines. Todos os pipelines em execução no agente têm acesso às versões instaladas anteriormente.
• $(Agent.TempDirectory): a utilização deste caminho garante que um pipeline não utiliza uma versão em cache do .NET Core, uma vez que esta pasta é limpa após cada pipeline.
• Outro caminho: pode utilizar qualquer caminho se o processo do agente tiver acesso ao caminho. Isto irá alterar o estado do computador e afetar todos os processos em execução no mesmo.

Nota

Pode utilizar a definição Pesquisa de Vários Níveis , performMultiLevelLookup, para configurar a forma como o anfitrião .NET procura versões.

performMultiLevelLookup - Efetuar Pesquisa de Vários Níveis
boolean. Valor predefinido: false.

Configura o comportamento do processo de anfitrião .NET quando procura uma arquitetura partilhada adequada. Os valores são:

• false: o processo de anfitrião procura apenas as versões que estão presentes na pasta especificada pela tarefa.
• true: o processo de anfitrião irá procurar em localizações globais predefinidas através da pesquisa de vários níveis. As localizações globais predefinidas 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.

Nota

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

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das respetivas 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

A tarefa Utilizar .NET Core adquire uma versão específica do .NET Core a partir da Internet ou da cache de ferramentas e adiciona-a ao CAMINHO do Agente dos Pipelines do Azure (alojado ou privado). Utilize esta tarefa para alterar a versão do .NET Core utilizada em tarefas subsequentes, como DotNetCoreCLI@2. Adicionar esta tarefa antes do DotNetCoreCLI@2 numa definição de compilação garante que a versão estaria disponível no momento da criação, teste e publicação da sua aplicação.

A abordagem do instalador de ferramentas também lhe permite desassociar dos ciclos de atualização do agente. Se a versão do .NET Core que procura estiver em falta no agente dos Pipelines do Azure (Alojado ou Privado), pode utilizar esta tarefa para instalar a versão certa no agente.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agente, DeploymentGroup
Exigências	Nenhuma
Capacidades	Executar esta tarefa satisfaz as seguintes exigências para quaisquer tarefas subsequentes no mesmo trabalho: DotNetCore
Restrições de comandos	Qualquer
Variáveis de tabelas definidas	Qualquer
Versão do agente	2.144.0 ou superior
Categoria da tarefa	Ferramenta