Installera ett SDK för en repository med dotnetup

Note

dotnetup är i offentlig förhandsversion. Dess funktioner och beteende kan ändras före allmän tillgänglighet.

När du inte anger en SDK-kanal söker dotnetup sdk install från den aktuella katalogen mot filsystemroten. Den använder den närmaste befintliga global.json filen. Om filen är felaktigt formaterad misslyckas kommandot i stället för att söka i en överordnad katalog. Om det inte finns någon fil används latest.

Installera repository-beroendet

Kör från repository-katalogen:

dotnetup sdk install

För den här global.json filen spårar dotnetup funktionsbandet 10.0.1xx :

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

Sökvägen global.json är källan till det lagrade kravetillståndet. Du kan se källan och den installerade versionen med:

dotnetup list

Förstå framåtmappning

För en SDK-version som 10.0.103, mappar rollForward dotnetup enligt följande:

rollForward, värde Sparad dotnetup-kanal
Utelämnat eller latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minoreller major Specifik version 10.0.103

Ett exakt krav är fäst och ändras inte av dotnetup update. Egenskapen allowPrerelease påverkar inte den kanal som dotnetup fastställer.

Använd sdk.paths

Om global.json innehåller sdk.pathsanvänder dotnetup den första sökvägen när inget --install-path alternativ finns. Det tolkar ett relativt värde från katalogen som innehåller global.json.

Prioritetsordningen för installationssökvägar är:

  1. --install-path
  2. Den första sdk.paths posten
  3. Standardroten för dotnetup-hanterad .NET-installation

Begränsningar i förhandsversionen

Den aktuella versionen av den offentliga förhandsversionen behandlar den första sdk.paths posten som en sökväg. Den tolkar inte $host$ som en sentinel och hoppar inte över tomma poster. Om du vill använda standardroten för dotnetup-hanterad installation utelämnar sdk.paths eller anger du --install-path explicit.

Uppdatera global.json

När du har ändrat sdk.version eller rollForward, kör du dotnetup sdk install från repo-katalogen för att tillämpa den nya beroendedefinitionen. Innan skräpsamlingen uppdaterade ändrade global.json källor lagrade dotnetup sdk update krav, så dess första pass kan fortfarande använda det tidigare kravet.

Om du vill installera den senaste versionen i den härledda kanalen och skriva tillbaka den versionen till global.jsonkör du:

dotnetup sdk install --update-global-json

Senare uppdaterar du alla krav för spårade lagringsplatser och deras filer med:

dotnetup sdk update --update-global-json

Uppdateringen ändrar bara sdk.version. Den bevarar befintlig formatering, andra egenskaper och identifierad textkodning.

Ta bort matchande repositorykrav

Avinstallationskommandot tar bort alla matchande globaljson specifikationer i den valda installationsroten. Den riktar sig inte mot ett repository. Om du vill ta bort matchande krav från standardroten kör du:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Om du vill välja en anpassad installationsrot lägger du till --install-path:

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

dotnetup tar bara bort filer när inga återstående krav behöver dem.

Se även