dotnet workload install

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>] [--version <VERSION>]

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.

Quando il comando è in workload-set modalità di aggiornamento, sono installate le versioni del carico di lavoro:

• Provengono dal set di carico di lavoro più recente o da una versione del set di carico di lavoro specificata in un global.json o --version opzione.
• Potrebbe non essere la versione più recente disponibile di ogni singolo carico di lavoro. Ad esempio, il install comando non installerà un set di carico di lavoro più recente se in precedenza è stato usato il --version flag.

Per altre informazioni, vedere Set di carichi di lavoro di .NET SDK. workload-set la modalità di aggiornamento è disponibile dalla versione 8.0.400 SDK.

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.

• dotnet build
• dotnet pack
• dotnet publish
• dotnet restore
• dotnet run
• dotnet test

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.

• --version

  Versione del carico di lavoro impostata su cui eseguire l'installazione o l'aggiornamento. Se si specifica la versione del set di carico di lavoro in global.json, non è possibile usare l'opzione --version per specificare la versione del set di carico di lavoro. Per consentire l'uso dell'opzione --version in questo caso, eseguire il comando all'esterno del percorso contenente il file global.json. Disponibile dalla versione 8.0.400 SDK. Per altre informazioni, vedere Set di carichi di lavoro di .NET SDK.

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