UseDotNet@2 - Use a tarefa dotnet v2

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

# 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.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version.
    #checkForExistingVersion: false # boolean. Check for existing installation. Default: false.
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

# 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.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # 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.

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

packageType - Pacote a instalar
string. Valores permitidos: runtime, sdk (SDK (contém o tempo de execução)). Valor predefinido: sdk.

Especifica se deve instalar apenas o runtime .NET ou o SDK.

useGlobalJson - Usar json global
boolean. Opcional. Use 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. Você pode alterar o caminho da raiz de pesquisa definindo a entrada do diretório de trabalho.

A tarefa também lê a sdk.rollForward propriedade e global.json instala a versão mais recente que satisfaz a política de avanço especificada. Por exemplo, se for global.json especificado "version": "8.0.302" com "rollForward": "latestFeature", a tarefa instala o SDK mais recente 8.0.x em vez da versão exata. Se sdk.rollForward não estiver presente, a tarefa instala a versão exata especificada em sdk.version, que corresponde ao comportamento anterior. Para mais informações sobre valores suportados rollForward , consulte a secção Observações e a visão geralglobal.json.

O 6.x formato and 6.1.x (usando .x como wildcard) descrito na UseDotNet@2.version entrada é para uso na version entrada da tarefa, 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 está a usar global.json, verifique no sdk.version seu global.jsonarquivo .

Para mais informações sobre global.json, consulte Selecione a versão .NET a utilizar.

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

Especifica o caminho a partir de onde global.json os ficheiros devem ser pesquisados ao usar useGlobalJson. Se o valor for 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 .NET Core SDK ou runtime a instalar. Os formatos de valor de versão são mostrados 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 menores especificadas, 3 e 1.
• 3.1.402: Instala o SDK especificado ou a versão de runtime, 3.1.402.

Os valores de versão para SDK ou instalações em tempo de execução estão no releases.json ficheiro. O link para uma releases.json versão maior/menor encontra-se no ficheiro índice releases . Por exemplo, o link para o ficheiroreleases.json da versão 3.1.

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

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

Os valores de versão para SDK ou instalações em tempo de execução, que são usados para a version string, estão no releases.json ficheiro. O link para uma releases.json versão maior/menor encontra-se no ficheiro índice releases . Por exemplo, o link para o ficheiroreleases.json da versão 3.1.

checkForExistingVersion - Verifique se a instalação já existe
boolean. Valor predefinido: false.

Selecione se quiser detetar se a versão especificada já está instalada antes de tentar descarregar. Use apenas quando o installationPath estiver Vazio, ou seja, definido para o valor predefinido.

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

Se definido para true, inclui versões de pré-visualização quando a tarefa procura as versões mais recentes de runtime/SDK, como procurar por 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 Core .NET deve ser instalado. Caminhos diferentes podem ter o seguinte impacto no comportamento do .NET.

• $(Agent.ToolsDirectory): Usando este caminho, a instalação no agente é armazenada em cache, pois este 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): Usar este caminho garante que um pipeline não utiliza uma versão em cache do .NET Core, pois esta pasta é limpa após cada pipeline.
• Outro caminho: Podes usar qualquer caminho se o processo agente tiver acesso ao caminho. Isso mudará o estado da máquina e afetará todos os processos em execução nela.

performMultiLevelLookup - Realizar Pesquisa Multinível
boolean. Valor predefinido: false.

Configura o comportamento do processo anfitrião .NET quando este procura um framework partilhado adequado. Os valores são:

• false: O processo host procura apenas as versões presentes na pasta especificada pela tarefa.
• true: O processo host irá pesquisar em localizações globais predefinidas usando pesquisa multinível. 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 multinível.

requestTimeout - Definir tempo limite para solicitação de download de pacote
string. Valor predefinido: 300000.

Forneça um valor de timeout para os pedidos HTTP que a tarefa faz para obter o pacote .NET. O valor é em milissegundos. O padrão é 300000 milissegundos (5 minutos). Não pode ser superior a 600000 milissegundos (10 minutos).

Nenhuma.