dotnet workload install

Este artigo se aplica a: ✔️ SDK do .NET 6 e versões posteriores

Nome

dotnet workload install - Instala cargas de trabalho opcionais.

Sinopse

dotnet workload install <WORKLOAD_ID>...
    [--configfile <FILE>] [--disable-parallel]
    [--ignore-failed-sources] [--include-previews] [--interactive]
    [--no-cache] [--skip-manifest-update] [--source <SOURCE>]
    [--temp-dir <PATH>] [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet workload install -?|-h|--help

Descrição

O comando dotnet workload install instala uma ou mais cargas de trabalho opcionais. Cargas de trabalho opcionais podem ser instaladas em cima do SDK do .NET para fornecer suporte para vários tipos de aplicativo, como .NET MAUI e Blazor WebAssembly AOT.

Quando o comando está no workload-set modo de atualização, as versões de carga de trabalho são instaladas:

  • São do conjunto de carga de trabalho mais recente ou de uma versão do conjunto de carga de trabalho especificada em um global.json ou --version opção.
  • Pode não ser a versão mais recente disponível de cada carga de trabalho individual. Por exemplo, o install comando não instalará um conjunto de carga de trabalho mais recente se você tiver usado o --version sinalizador anteriormente.

Para obter mais informações, consulte Conjuntos de carga de trabalho do SDK do .NET. workload-set O modo de atualização está disponível desde o SDK 8.0.400.

Use dotnet workload search para saber quais cargas de trabalho estão disponíveis para instalação.

Quando executar com privilégios elevados

Para instalações do SDK em MacOS e Linux instaladas em um diretório protegido, o comando precisa executar com privilégios elevados (use o comando sudo). No Windows, o comando não precisa ser executado com privilégios elevados mesmo se o SDK estiver instalado no diretório Arquivos de Programas. Para o Windows, o comando usa instaladores MSI para esse local.

Os resultados variam de acordo com a versão do SDK

Os comandos dotnet workload operam no contexto de versões específicas do SDK. Suponha que você tenha o SDK do .NET 6.0.100 e o SDK do .NET 6.0.200 instalados. Os comandos dotnet workload fornecerão resultados diferentes dependendo da versão do SDK selecionada. Esse comportamento se aplica a diferenças de versão principal e secundária e faixa de recursos, não a diferenças de versão de patch. Por exemplo, o SDK do .NET 6.0.101 e 6.0.102 fornecem os mesmos resultados, enquanto 6.0.100 e 6.0.200 dão resultados diferentes. Você pode especificar a versão do SDK usando o arquivo global.json.

Manifestos de publicidade

Os nomes e versões dos ativos que uma instalação de carga de trabalho requer são mantidos em manifests. Por padrão, o comando dotnet workload install baixa os manifestos disponíveis mais recentes antes de instalar uma carga de trabalho. A cópia local de um manifesto fornece as informações necessárias para localizar e baixar os ativos para uma carga de trabalho.

O comando dotnet workload list compara as versões das cargas de trabalho instaladas com as versões disponíveis no momento. Quando ele descobre que uma versão mais recente que a versão instalada está disponível, ela anuncia esse fato na saída do comando. Essas notificações de versão mais recente em dotnet workload list estão disponíveis a partir do .NET 6.

Para habilitar essas notificações, as versões mais recentes disponíveis dos manifestos são baixadas e armazenadas como manifestos de publicidade. Esses downloads ocorrem de forma assíncrona em segundo plano quando qualquer um dos comandos a seguir é executado.

Se um comando for concluído antes da conclusão do download do manifesto, o download é interrompido. O download será testado novamente na próxima vez que um desses comandos for executado. Você pode definir variáveis de ambiente para desabilitar esses downloads em segundo plano ou controlar sua frequência. Por padrão, eles não acontecem mais de uma vez por dia.

Você pode impedir que o comando dotnet workload install faça downloads de manifestos usando a opção --skip-manifest-update.

O comando dotnet workload update também baixa manifestos de publicidade. Os downloads são necessários para saber se uma atualização está disponível, portanto, não há nenhuma opção para impedi-los de serem executados. No entanto, você pode usar a opção --advertising-manifests-only para ignorar atualizações de carga de trabalho e fazer apenas os downloads de manifesto. Esta opção está disponível desde o .NET 6.

Argumentos

  • WORKLOAD_ID...

    A ID da carga de trabalho ou várias IDs a serem instaladas. Use dotnet workload search para saber quais cargas de trabalho estão disponíveis.

Opções

  • --configfile <FILE>

    O arquivo de configuração do NuGet (nuget.config) a ser usado. Se esse arquivo for especificado, serão usadas somente as configurações dele. Se ele não for especificado, será usada a hierarquia de arquivos de configuração do diretório atual. Para obter mais informações, confira Configurações comuns do NuGet.

  • --disable-parallel

    Previne a restauração de vários projetos paralelamente.

  • -?|-h|--help

    Imprime uma descrição de como usar o comando.

  • --ignore-failed-sources

    Trata as falhas de origem de pacote como avisos.

  • --include-previews

    Permite manifestos de carga de trabalho de pré-lançamento.

  • --interactive

    Permite que o comando pare e aguarde entrada ou ação do usuário. Por exemplo, para concluir a autenticação.

  • --no-cache

    Impede o cache de pacotes e solicitações http.

  • --skip-manifest-update

    Ignorar a atualização dos manifestos de carga de trabalho. Os manifestos de carga de trabalho definem quais ativos e versões precisam ser instalados para cada carga de trabalho.

  • -s|--source <SOURCE>

    Especifica o URI da origem do pacote de NuGet a ser usado. Essa configuração substitui todas as fontes especificadas nos arquivos nuget.config. Diversas fontes podem ser fornecidas especificando essa opção várias vezes.

  • --temp-dir <PATH>

    Especifique o diretório temporário usado para baixar e extrair pacotes NuGet (precisa ser seguro).

  • -v|--verbosity <LEVEL>

    Define o nível de detalhes do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic]. O padrão é minimal. Se você especificar o detalhamento detailed ou diagnostic, o comando exibirá informações sobre os pacotes Nuget que ele baixa.

  • --version

    A versão do conjunto de carga de trabalho para instalar ou atualizar. Se você especificar a versão do conjunto de carga de trabalho no global.json, não poderá usar a --version opção para especificar a versão do conjunto de carga de trabalho. Para possibilitar o uso da --version opção nesse caso, execute o comando fora do caminho que contém o arquivo global.json. Disponível desde o SDK 8.0.400. Para obter mais informações, consulte Conjuntos de carga de trabalho do SDK do .NET.

Exemplos

  • Instale a carga de trabalho maui:

    dotnet workload install maui
    
  • Instale as cargas de trabalho maui-android e maui-ios:

    dotnet workload install maui-android maui-ios