dotnet workload install

Articolo
03/01/2024

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 comando dotnet workload install 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 applicazioni, come .NET MAUI e Blazor WebAssembly AOT.

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

Quando eseguire con privilegi elevati

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

I risultati variano in base alla versione di SDK

I comandi dotnet workload operano nel contesto di versioni specifiche di SDK. Si suppone che sia installato .NET 6.0.100 SDK e .NET 6.0.200 SDK. I comandi dotnet workload forniranno risultati diversi a seconda della versione di SDK selezionata. Questo comportamento si applica alle differenze tra banda di funzionalità e tra versione principale e secondaria, non alle differenze tra versioni patch. Ad esempio, .NET SDK 6.0.101 e 6.0.102 offrono gli stessi risultati, mentre 6.0.100 e 6.0.200 offrono risultati diversi. È possibile specificare la versione SDK usando il file global.json.

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 esegue il download di manifesti disponibili più recenti prima di installare un carico di lavoro. La copia locale di un manifesto quindi fornisce le informazioni necessarie per trovare ed effettuare il download degli asset per un carico di lavoro.

Il comando dotnet workload list confronta le versioni di carichi di lavoro installati con le versioni attualmente disponibili. Quando rileva la disponibilità di una versione più recente rispetto a quella installata, lo comunica nell'output del comando. Queste notifiche della versione più recente in dotnet workload list sono disponibili a partire da .NET 6.

Per abilitare queste notifiche, viene effettuato il download e l’archiviazione delle versioni dei manifesti più recenti disponibili come manifesti pubblicitari. Questi download vengono eseguiti in modo asincrono in background quando viene eseguito uno dei seguenti comandi.

Se un comando termina prima del completamento del download del manifesto, il download viene arrestato. Prova di nuova esecuzione del download viene effettuata 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, ciò non si verifica più di una volta al giorno.

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

Il comando dotnet workload update esegue download anche di 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

WORKLOAD_ID...

ID del carico di lavoro o ID multipli da installare. Per informazioni sui carichi di lavoro disponibili, utilizzare la ricerca carico di lavoro dotnet.

Opzioni

--configfile <FILE>

File di configurazione NuGet (nuget.config) da utilizzare. Se si dispone di indicazione, verranno usate solo le impostazioni di questo file. Se non specificato, verrà usata la gerarchia dei file di configurazione dalla directory corrente. Per ulteriori 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

Gestisce gli errori dell'origine del pacchetto come avvisi.

--include-previews

Consente manifesti del carico di lavoro non definitivi.

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

Salta l'aggiornamento di manifesti del carico di lavoro. I manifesti del carico di lavoro definiscono gli asset e le versioni che 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 effettuare il download ed estrarre pacchetti NuGet (accertarsi della sicurezza).

-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 il livello di dettaglio detailed o diagnostic, il comando visualizza informazioni sui pacchetti Nuget di cui effettua il download.

Esempi

Installare il carico di lavoro maui:
```
dotnet workload install maui
```
Installare i carichi di lavoro maui-android e maui-ios:
```
dotnet workload install maui-android maui-ios
```