Een SDK installeren voor een repository met dotnetup

Note

dotnetup is beschikbaar als openbare preview. De functies en het gedrag kunnen veranderen vóór algemene beschikbaarheid.

Wanneer u geen SDK-kanaal opgeeft, zoekt dotnetup sdk install vanuit de huidige map tot aan de hoofdmap van het bestandssysteem. Hierbij wordt het dichtstbijzijnde bestaande global.json bestand gebruikt. Als dat bestand een onjuiste indeling heeft, mislukt de opdracht in plaats van een bovenliggende map te doorzoeken. Als er geen bestand bestaat, gebruikt het latest.

Installeer de vereiste voor de repository

Voer in de repositorymap het volgende uit:

dotnetup sdk install

Voor dit global.json bestand houdt dotnetup de 10.0.1xx featureband bij:

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

Het global.json pad is de bron van de opgeslagen eis. U kunt de bron en geïnstalleerde versie zien met:

dotnetup list

Roll-forward-toewijzing begrijpen

Voor een SDK-versie zoals 10.0.103, wijst dotnetup rollForward als volgt toe:

Waarde rollForward Opgeslagen kanaal voor dotnetup
Weggelaten of latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor of major Exacte versie 10.0.103

Een exacte vereiste is vastgezet en wordt niet gewijzigd door dotnetup update. De allowPrerelease eigenschap heeft geen invloed op het kanaal dat dotnetup bepaalt.

Gebruik sdk.paths

Als global.jsonsdk.paths bevat, gebruikt dotnetup het eerste pad wanneer er geen --install-path optie aanwezig is. Hiermee wordt een relatieve waarde bepaald vanuit de map die global.json bevat.

De prioriteit van het installatiepad is:

  1. --install-path
  2. De eerste sdk.paths vermelding
  3. De standaard door dotnetup beheerde .NET installatiehoofdmap

Preview-beperkingen

De huidige openbare preview-build behandelt de eerste sdk.paths vermelding als een pad. Het interpreteert $host$ niet als een sentinel of slaat lege vermeldingen over. Als u de door dotnetup beheerde standaardinstallatiehoofdmap wilt gebruiken, laat sdk.paths weg of stelt u --install-path expliciet in.

global.json bijwerken

Nadat u sdk.version of rollForward hebt gewijzigd, voert u dotnetup sdk install uit vanuit de opslagplaatsmap om de nieuwe vereiste toe te passen. Voordat garbagecollection gewijzigde global.json bronnen vernieuwt, dotnetup sdk update-processen vereisten opslaan, dus de eerste iteratie kan nog steeds gebruikmaken van de vorige vereiste.

Voer de volgende opdracht uit om de nieuwste versie in het afgeleide kanaal te installeren en die versie terug te schrijven naar global.json:

dotnetup sdk install --update-global-json

Werk later alle vereisten van gevolgde repositories en hun bestanden bij met:

dotnetup sdk update --update-global-json

De update wijzigt alleen sdk.version. De bestaande opmaak, andere eigenschappen en gedetecteerde tekstcodering blijven behouden.

Overeenkomende vereisten voor repository's verwijderen

Met de opdracht uninstall verwijdert u elke overeenkomende globaljson-specificatie in de geselecteerde installatiemap. Het is niet gericht op één repository. Als u overeenkomstige vereisten uit de standaard-root wilt verwijderen, voert u het volgende uit:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Als u een aangepaste installatiemap wilt selecteren, voegt u --install-path:

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

dotnetup verwijdert alleen bestanden wanneer geen enkele resterende vereiste ze nodig heeft.

Zie ook