dotnet workload install

Este artigo aplica-se a: ✔️ .NET 6 SDK 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

Description

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

Quando o comando está no workload-set modo de atualização, as versões da carga de trabalho 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 anteriormente o --version sinalizador.

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 a pesquisa de carga de trabalho dotnet para saber quais cargas de trabalho estão disponíveis para instalação.

Quando executar elevado

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

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

Os dotnet workload comandos 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 dotnet workload comandos darão resultados diferentes dependendo da versão do SDK selecionada. Esse comportamento se aplica às diferenças de versão principal e secundária e de banda de recursos, não às diferenças de versão de patch. Por exemplo, o .NET SDK 6.0.101 e 6.0.102 dão 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 publicitários

Os nomes e versões dos ativos que uma instalação de carga de trabalho requer são mantidos em manifestos. Por padrão, o dotnet workload install comando 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 de uma carga de trabalho.

O dotnet workload list comando compara as versões das cargas de trabalho instaladas com as versões atualmente disponíveis. Quando ele descobre que uma versão mais recente do que a versão instalada está disponível, ele anuncia esse fato na saída do comando. Essas notificações de versão mais recente estão disponíveis a dotnet workload list 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 acontecem de forma assíncrona em segundo plano quando qualquer um dos seguintes comandos é executado.

• construção dotnet
• Pacote Dotnet
• dotnet publicar
• restauração dotnet
• Dotnet Run
• teste dotnet

Se um comando for concluído antes da conclusão do download do manifesto, o download será interrompido. O download é tentado novamente na próxima vez que um desses comandos for executado. Você pode definir variáveis de ambiente para desativar 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 dotnet workload install comando faça downloads de manifesto usando a --skip-manifest-update opção.

O dotnet workload update comando 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 --advertising-manifests-only opção para ignorar atualizações de carga de trabalho e fazer apenas os downloads de manifesto. Esta opção está disponível a partir do .NET 6.

Argumentos

• WORKLOAD_ID...

  O ID da carga de trabalho ou vários IDs a serem instalados. Use a pesquisa de carga de trabalho dotnet 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 especificado, somente as configurações desse arquivo serão usadas. Se não for especificado, a hierarquia de arquivos de configuração do diretório atual será usada. Para obter mais informações, consulte Configurações comuns do NuGet.

• --disable-parallel

  Impede a restauração de vários projetos em paralelo.

• -?|-h|--help

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

• --ignore-failed-sources

  Trata as falhas de origem do pacote como avisos.

• --include-previews

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

• --interactive

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

• --no-cache

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

• --skip-manifest-update

  Ignore 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 NuGet a ser usada. Essa configuração substitui todas as fontes especificadas nos arquivos nuget.config . Várias 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 (deve ser seguro).

• -v|--verbosity <LEVEL>

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

• --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 tornar possível usar a --version opção nesse caso, execute o comando fora do caminho que contém o arquivo global.json. Disponível desde 8.0.400 SDK. Para obter mais informações, consulte Conjuntos de carga de trabalho do SDK do .NET.

Exemplos

• Instale a maui carga de trabalho:

  dotnet workload install maui
  

• Instale o maui-android e maui-ios cargas de trabalho:

  dotnet workload install maui-android maui-ios