instalação da carga de trabalho dotnet

  • Artigo

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>]

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

Descrição

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.

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.

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], , , , d[etailed]m[inimal]n[ormal]e .diag[nostic] A predefinição é minimal. Se você especificar detailed ou diagnostic detalhar, o comando exibirá informações sobre os pacotes Nuget baixados.

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