UseDotNet@2 – Usar a tarefa dotnet v2

Use essa tarefa para adquirir uma versão específica do .NET Core SDK do internet ou do cache local e adicioná-la ao PATH. Use essa tarefa para alterar a versão do .NET Core que será usada em tarefas subsequentes. Essa 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 para instalação
string. Valores permitidos: runtime, sdk (SDK (contém tempo de execução)). Valor padrão: sdk.

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

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

Instala todos os SDKs a partir de global.json arquivos. Esses arquivos são pesquisados a partir de system.DefaultWorkingDirectory. Você pode alterar o caminho raiz da 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 atende à política de rolagem especificada. Por exemplo, se você global.json especificar "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 , veja a seção Observações e a visão geralglobal.json.

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

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

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

Especifica o caminho de onde global.json os arquivos 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 SDK Core .NET ou o tempo de execução a ser instalado. 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 arquivo. O link para uma releases.json versão maior/menor está no arquivo releases-index . Por exemplo, o link para o arquivoreleases.json da versão 3.1.

vsVersion - Compatível Visual Studio versão
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 usadas para a version string, estão no releases.json arquivo. O link para uma releases.json versão maior/menor está no arquivo releases-index . Por exemplo, o link para o arquivoreleases.json da versão 3.1.

checkForExistingVersion - Verifique se há instalações existentes
boolean. Valor padrão: false.

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

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

Se definido como true, inclui versões de pré-visualização quando a tarefa busca pelas versões mais recentes de runtime/SDK, como buscar por 2.2.x ou 3.1.x. Essa configuração é ignorada se você especificar uma versão exata, como 3.0.100-preview3-010431.

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

Especifica onde o SDK/Runtime do Núcleo .NET deve ser instalado. Caminhos diferentes podem ter o seguinte impacto no comportamento do .NET.

• $(Agent.ToolsDirectory): Usar esse 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): Usar esse caminho garante que um pipeline não use uma versão em cache do .NET Core, pois essa pasta é limpa após cada pipeline.
• Outro caminho: Você pode usar qualquer caminho se o processo agente tiver acesso ao caminho. Isso alterará o estado do computador e afetará todos os processos em execução nele.

performMultiLevelLookup - Realize Pesquisa Multinível
boolean. Valor padrão: false.

Configura o comportamento do processo host .NET quando ele busca um framework compartilhado adequado. Os valores são:

• false: O processo host busca apenas versões presentes na pasta especificada pela tarefa.
• true: O processo host fará busca em locais globais predefinidos usando consulta 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 busca multinível no SharedFX.

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

Forneça um valor de tempo para as requisições HTTP que a tarefa faz para obter o pacote .NET. O valor está em milissegundos. O padrão é 300000 milissegundos (5 minutos). Não pode ser mais de 600000 milissegundos (10 minutos).

Nenhum.