installazione del carico di lavoro dotnet

  • Articolo

Questo articolo si applica a: ✔️ .NET 6 SDK e versioni successive

Nome

dotnet workload install - Installa carichi di lavoro facoltativi.

Riepilogo

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

Descrizione

Il dotnet workload install comando installa uno o più carichi di lavoro facoltativi. I carichi di lavoro facoltativi possono essere installati in .NET SDK per fornire supporto per vari tipi di applicazione, ad esempio .NET MAUI e Blazor WebAssembly AOT.

Usare la ricerca del carico di lavoro dotnet per informazioni sui carichi di lavoro disponibili per l'installazione.

Quando eseguire con privilegi elevati

Per le installazioni di macOS e Linux SDK installate in una directory protetta, il comando deve essere eseguito con privilegi elevati (usare il sudo comando ). In Windows, il comando non deve eseguire con privilegi elevati anche se l'SDK è installato nella directory Programmi . Per Windows, il comando usa i programmi di installazione MSI per tale percorso.

I risultati variano in base alla versione dell'SDK

I dotnet workload comandi operano nel contesto di versioni specifiche dell'SDK. Si supponga di avere installato .NET 6.0.100 SDK e .NET 6.0.200 SDK. I dotnet workload comandi forniranno risultati diversi a seconda della versione dell'SDK selezionata. Questo comportamento si applica alle differenze di versione principale e secondaria e della banda delle funzionalità, non alle differenze di versione delle patch. Ad esempio, .NET SDK 6.0.101 e 6.0.102 danno gli stessi risultati, mentre 6.0.100 e 6.0.200 danno risultati diversi. È possibile specificare la versione dell'SDK usando il file global.json o l'opzione --sdk-version dei dotnet workload comandi.

Manifesti pubblicitari

I nomi e le versioni degli asset richiesti da un'installazione del carico di lavoro vengono mantenuti nei manifesti. Per impostazione predefinita, il dotnet workload install comando scarica i manifesti disponibili più recenti prima di installare un carico di lavoro. La copia locale di un manifesto fornisce quindi le informazioni necessarie per trovare e scaricare gli asset per un carico di lavoro.

Il dotnet workload list comando confronta le versioni dei carichi di lavoro installati con le versioni attualmente disponibili. Quando rileva che è disponibile una versione più recente della versione installata, annuncia tale fatto nell'output del comando. Queste notifiche delle versioni più recenti in dotnet workload list sono disponibili a partire da .NET 6.

Per abilitare queste notifiche, le versioni più recenti disponibili dei manifesti vengono scaricate e archiviate come manifesti pubblicitari. Questi download vengono eseguiti in modo asincrono in background quando vengono eseguiti uno dei comandi seguenti.

Se un comando termina prima del completamento del download del manifesto, il download viene arrestato. Il download viene provato di nuovo alla successiva esecuzione di uno di questi comandi. È possibile impostare le variabili di ambiente per disabilitare questi download in background o controllarne la frequenza. Per impostazione predefinita, non si verificano più di una volta al giorno.

È possibile impedire al dotnet workload install comando di eseguire i download del manifesto usando l'opzione --skip-manifest-update .

Il dotnet workload update comando scarica anche manifesti pubblicitari. I download sono necessari per sapere se è disponibile un aggiornamento, quindi non è possibile impedirne l'esecuzione. È tuttavia possibile usare l'opzione --advertising-manifests-only per ignorare gli aggiornamenti del carico di lavoro ed eseguire solo i download del manifesto. Questa opzione è disponibile a partire da .NET 6.

Argomenti

Opzioni

  • --configfile <FILE>

    File di configurazione NuGet (nuget.config) da usare. Se specificato, verranno usate solo le impostazioni di questo file. Se non specificato, verrà utilizzata la gerarchia dei file di configurazione dalla directory corrente. Per altre informazioni, vedere Configurazioni NuGet comuni.

  • --disable-parallel

    Impedisce il ripristino di più progetti in parallelo.

  • -?|-h|--help

    Stampa una descrizione di come usare il comando .

  • --ignore-failed-sources

    Considera gli errori di origine del pacchetto come avvisi.

  • --include-previews

    Consente manifesti del carico di lavoro non definitive.

  • --interactive

    Consente al comando di arrestarsi e attendere l'input o l'azione dell'utente, ad esempio il completamento dell'autenticazione.

  • --no-cache

    Impedisce la memorizzazione nella cache di pacchetti e richieste HTTP.

  • --skip-manifest-update

    Ignorare l'aggiornamento dei manifesti del carico di lavoro. I manifesti del carico di lavoro definiscono quali asset e versioni devono essere installati per ogni carico di lavoro.

  • -s|--source <SOURCE>

    Specifica l'URI dell'origine del pacchetto NuGet da usare. Questa impostazione esegue l'override di tutte le origini specificate nei file NuGet.config. È possibile specificare più origini, selezionando questa opzione più volte.

  • --temp-dir <PATH>

    Specificare la directory temporanea usata per scaricare ed estrarre pacchetti NuGet (deve essere sicura).

  • -v|--verbosity <LEVEL>

    Imposta il livello di dettaglio del comando. I valori consentiti sono q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic]. Il valore predefinito è minimal. Se si specifica o si specifica detailed un diagnostic livello di dettaglio, il comando visualizza informazioni sui pacchetti Nuget scaricati.

Esempio

  • Installare il maui carico di lavoro:

    dotnet workload install maui

  • Installare i maui-android carichi di lavoro e maui-ios :

    dotnet workload install maui-android maui-ios