Installare un SDK per un repository con dotnetup

Note

dotnetup è disponibile in anteprima pubblica. Le funzionalità e il comportamento potrebbero cambiare prima della disponibilità generale.

Quando non si specifica un canale SDK, dotnetup sdk install esegue ricerche dalla directory corrente verso la radice del file system. Usa il file esistente global.json più vicino. Se il file è malformato, il comando non riesce invece di cercare nella directory padre. Se non esiste alcun file, usa latest.

Installare il prerequisito del repository

Dalla directory del repository eseguire:

dotnetup sdk install

Per questo global.json file, dotnetup tiene traccia del 10.0.1xx gruppo di funzionalità:

{
  "sdk": {
    "version": "10.0.103",
    "rollForward": "latestPatch"
  }
}

Il global.json percorso è la fonte del requisito archiviato. È possibile visualizzare la versione di origine e installata con:

dotnetup list

Comprendere la mappatura roll-forward

Per una versione dell'SDK come 10.0.103, dotnetup associa rollForward come indicato di seguito:

Valore rollForward Canale dotnetup archiviato
Omesso o latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor o major Versione esatta 10.0.103

Un requisito esatto viene fissato e non viene modificato da dotnetup update. La allowPrerelease proprietà non influisce sul canale derivato da dotnetup.

Utilizzare sdk.paths.

Se global.json contiene sdk.paths, dotnetup usa il primo percorso quando non è presente alcuna --install-path opzione. Risolve un valore relativo dalla directory che contiene global.json.

La precedenza del percorso di installazione è:

  1. --install-path
  2. La prima sdk.paths voce
  3. Radice di installazione predefinita di .NET gestita da dotnetup

Limitazioni dell'anteprima

La build di anteprima pubblica corrente considera la prima sdk.paths voce come percorso. Non interpreta $host$ come sentinel né ignora voci vuote. Per usare la radice di installazione gestita da dotnetup predefinita, omettere sdk.paths o impostare --install-path in modo esplicito.

Aggiornamento global.json

Dopo aver modificato sdk.version o rollForward, eseguire dotnetup sdk install dalla directory del repository per applicare i nuovi requisiti. Prima che Garbage Collection aggiorni le sorgenti modificate global.json, i processi dotnetup sdk update elaborano i requisiti archiviati, quindi il primo passaggio potrebbe comunque usare il requisito precedente.

Per installare la versione più recente nel canale derivato e scrivere nuovamente tale versione in global.json, eseguire:

dotnetup sdk install --update-global-json

Successivamente, aggiornare tutti i requisiti del repository tracciati e i relativi file con:

dotnetup sdk update --update-global-json

L'aggiornamento cambia solo sdk.version. Mantiene la formattazione esistente, altre proprietà e la codifica del testo rilevata.

Rimuovere i requisiti del repository corrispondenti

Il comando uninstall rimuove tutte le specifiche corrispondenti globaljson nella radice di installazione selezionata. Non punta a un repository. Per rimuovere i requisiti corrispondenti dalla radice predefinita, eseguire:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Per selezionare una radice di installazione personalizzata, aggiungere --install-path:

dotnetup sdk uninstall 10.0.1xx --source globaljson --install-path <INSTALL_PATH>

dotnetup rimuove i file solo quando nessun requisito rimanente ne ha bisogno.

Vedere anche

  • Ultimo aggiornamento: