SDK-vereisten voor repository’s met dotnetup

Note

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

dotnetup gebruikt global.json om een SDK-vereiste te koppelen aan een repository of mapstructuur. Het zoekt vanuit de huidige map door elke bovenliggende map heen en leest de dichtstbijzijnde bestaande global.json.

Installeer vanuit global.json

Voer een SDK-installatieopdracht uit zonder een kanaal:

dotnetup install

Als het dichtstbijzijnde global.json een sdk.version heeft, leidt dotnetup een installatiespecificatie af van de versie en de rollForward-waarde. Het volledige pad naar het bestand wordt vastgelegd als de specificatiebron. Als er geen global.json bestaat in de huidige map of de bovenliggende mappen, gebruikt de opdracht het latest kanaal. Als het eerstgevonden bestand ongeldig is of opmerkingen bevat, mislukt het parseren. dotnetup slaat dat bestand niet over, maar zoekt in bovenliggende mappen of gebruikt het latest kanaal.

rollForward mapping

dotnetup koppelt global.json SDK-selectiebeleid aan updatebare kanalen:

Waarde rollForward Opgeslagen vereiste voor dotnetup-SDK 10.0.103
Weggelaten of latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor of major 10.0.103

De toewijzingen van exacte versies zijn vastgezet en worden niet bijgewerkt door een update. De allowPrerelease eigenschap heeft geen invloed op het kanaal dat dotnetup bepaalt.

Installatiepad van global.json

Als sdk.paths een vermelding bevat, gebruikt dotnetup het eerste pad. Een relatief pad wordt opgelost ten opzichte van de map die global.json bevat.

In de huidige openbare preview-build dotnetup wordt de eerste vermelding als pad behandeld. Het interpreteert $host$ niet als een sentinel of slaat lege vermeldingen niet over.

De prioriteit van het installatiepad is:

  1. --install-path.
  2. De eerste sdk.paths item in de dichtstbijzijnde global.json.
  3. De standaard door dotnetup beheerde .NET installatiehoofdmap.

Repositorybestanden actueel houden

Geef --update-global-json door om sdk.version te vervangen door de concrete SDK-versie die is geïnstalleerd of bijgewerkt:

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

Alleen global.json-sourced SDK-specificaties worden bijgewerkt door de updatewerkstroom. De wijzigingsfunctie behoudt de andere JSON-eigenschappen, opmaak en gedetecteerde tekstcodering.

Overeenkomende vereisten voor repository's verwijderen

Een gevolgde global.json specificatie wordt ververst tijdens de garbagecollection. Als het bestand niet meer bestaat of geen SDK-versie meer bevat, wordt de specificatie verwijderd.

Als u specificaties per kanaal wilt verwijderen, selecteert u de globaljson bron. Met deze opdracht verwijdert u elke overeenkomende specificatie in de geselecteerde installatiemap, niet slechts één repository:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Gebruik dotnetup list dit om het opgeslagen kanaal, het bronpad en de installatiehoofdmap te vinden. Voeg --install-path toe om een aangepaste hoofdmap te selecteren.

Zie ook

  • Laatst bijgewerkt om