Requisiti dell'SDK del repository con dotnetup

Note

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

dotnetup usa global.json per associare un requisito dell'SDK a un repository o a un albero di directory. Esegue la ricerca dalla directory corrente attraverso ciascuna directory padre e legge il più vicino esistente global.json.

Installa da global.json

Eseguire un comando di installazione dell'SDK senza un canale:

dotnetup install

Se il global.json più vicino ha un sdk.version, dotnetup deriva una specifica di installazione dalla versione e dal valore di rollForward. Registra il percorso completo del file come origine della specifica. Se global.json non esiste nella directory corrente o nelle directory padre, il comando usa il canale latest. Se il file più vicino non è valido o contiene commenti, il parsing non riesce. dotnetup non salta quel file durante la ricerca nelle directory padre né usa il canale latest.

rollForward mapping

dotnetup associa global.json i criteri di selezione dell'SDK ai canali aggiornabili:

Valore rollForward Requisito dotnetup archiviato per SDK 10.0.103
Omesso o latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor o major 10.0.103

Le mappature delle versioni esatte sono bloccate e non sono avanzate da un aggiornamento. La allowPrerelease proprietà non influisce sul canale derivato da dotnetup.

Percorso di installazione da global.json

Se sdk.paths contiene una voce, dotnetup usa il primo percorso. Un percorso relativo viene risolto dalla directory che contiene global.json.

Nella build di anteprima pubblica corrente, dotnetup considera la prima voce come percorso. Non interpreta $host$ come sentinel né salta le voci vuote.

La precedenza del percorso di installazione è:

  1. --install-path.
  2. La prima sdk.paths voce nel global.json più vicino.
  3. Radice di installazione del .NET gestito da dotnetup predefinito.

Mantenere aggiornati i file del repository

Passare --update-global-json per sostituire sdk.version con la versione concreta dell'SDK installata o aggiornata:

dotnetup install --update-global-json
dotnetup sdk update --update-global-json

Solo le specifiche SDK provenienti da global.json vengono aggiornate dal flusso di lavoro di aggiornamento. Il modificatore preserva le altre proprietà JSON, la formattazione e la codifica del testo rilevata.

Rimuovere i requisiti del repository corrispondenti

Una specifica monitorata viene aggiornata global.json durante l'operazione di Garbage Collection. Se il file non esiste più o non contiene più una versione dell'SDK, la specifica viene rimossa.

Per rimuovere le specifiche per canale, selezionare la sorgente globaljson. Questo comando rimuove tutte le specifiche corrispondenti nella radice di installazione selezionata, non solo quelli di un repository:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Usare dotnetup list per trovare il canale archiviato, il percorso di origine e la radice di installazione. Aggiungi --install-path per selezionare una radice personalizzata.

Vedere anche

  • Ultimo aggiornamento: