Krav för Repository SDK med dotnetup

Note

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

dotnetup använder global.json för att associera ett SDK-krav med en lagringsplats eller ett katalogträd. Den söker från den aktuella katalogen via varje överordnad katalog och läser närmaste befintliga global.json.

Installera från global.json

Kör ett SDK-installationskommando utan en kanal:

dotnetup install

Om närmaste global.json har en sdk.version, härleder dotnetup en installationsspecifikation från versionen och värdet för rollForward. Den registrerar den fullständiga sökvägen till filen som specifikationskälla. Om det inte finns någon global.json i den aktuella katalogen eller dess överordnade kataloger använder kommandot kanalen latest. Om den närmast liggande filen är felaktigt formaterad eller innehåller kommentarer misslyckas parsningen. dotnetup hoppar inte över filen för att söka efter överordnade kataloger eller använda latest kanalen.

rollForward-mappning

dotnetup kopplar global.json SDK-urvalsprinciper till uppdateringsbara kanaler:

rollForward, värde Lagrade dotnetup-krav för SDK 10.0.103
Utelämnat eller latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minoreller major 10.0.103

Mappningarna för exakta versioner är låsta och uppdateras inte av en uppdatering. Egenskapen allowPrerelease påverkar inte den kanal som dotnetup avgör.

Installationssökväg från global.json

Om sdk.paths innehåller en post använder dotnetup den första sökvägen. En relativ sökväg bestäms från katalogen som innehåller global.json.

I den aktuella offentliga förhandsversionen behandlar dotnetup den första posten som en sökväg. Den tolkar inte $host$ som en sentinel och hoppar inte över tomma poster.

Installationssökvägens prioritet är:

  1. --install-path.
  2. Den första sdk.paths posten i närmaste global.json.
  3. Standardroten för den dotnetup-hanterade .NET-installationen.

Håll repots filer aktuella

Ange --update-global-json för att ersätta sdk.version med den specifika SDK-versionen som installerades eller uppdaterades:

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

Endast global.json-sourced SDK-specifikationer uppdateras av uppdateringsarbetsflödet. Modifiern bevarar de andra JSON-egenskaperna, formateringen och den identifierade textkodningen.

Ta bort matchande repositorykrav

En spårad global.json specifikation uppdateras under sopinsamling. Om filen inte längre finns eller inte längre innehåller en SDK-version tas specifikationen bort.

Om du vill ta bort specifikationer per kanal väljer du globaljson-källan. Det här kommandot tar bort alla matchande specifikationer i den valda installationsroten, inte bara ett arkiv:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Använd dotnetup list för att hitta den lagrade kanalen, källsökvägen och installationsroten. Lägg till --install-path för att välja en anpassad rotkatalog.

Se även

  • Uppdaterades senast