Hoe dotnetup werkt

dotnetup scheidt wat u opvraagt van de bestanden die het installeert. Met dit model kunnen verschillende vereisten één .NET installatie delen en kan dotnetup bestanden die niet meer nodig zijn verwijderen.

Installatiemappen

Een .NET installatiehoofdmap is een map die dotnetup bijhoudt. Een installatiehoofdmap heeft:

• Een volledig gekwalificeerd mappad.
• Een architectuur: x86, x64of arm64.
• Nul of meer installatiespecificaties, opgegeven als channels.
• Nul of meer specifieke installaties.

De huidige CLI wordt geïnstalleerd voor de architectuur van het actieve dotnetup proces. Het heeft geen architectuuroptie.

De standaard door dotnetup beheerde .NET installatiehoofdmap is de dotnet submap van de dotnetup-gegevensmap:

Gebruik --install-path om een andere installatiehoofdmap te selecteren. Een expliciet installatiepad heeft voorrang op een pad uit global.json, dat weer voorrang heeft op de standaardinstallatiemap.

dotnetupschrijft niet naar een door het systeem beheerde .NET map, zoals Program Files\dotnet of /usr/share/dotnet.

Onderdelen

dotnetup beheert deze onderdeeltypen:

De ASP.NET Core aliassen aspnet en de Windows Desktop-aliassen desktop worden geaccepteerd in de specificaties van runtime-onderdelen.

Installatiespecificaties

Een installatiespecificatie registreert een onderdeel en een kanaal of een exacte versie. Een SDK-specificatie voor 10.0.1xx betekent bijvoorbeeld 'behoud de nieuwste SDK in de 10.0.1xx-featureband'.

Je kunt meer informatie vinden over de verschillende soorten ondersteunde kanalen en versies in Kanalen en versies.

Elke specificatie heeft een van de volgende bronnen:

• Explicit: U hebt het kanaal of de versie op de opdrachtregel opgegeven.
• GlobalJson: dotnetup heeft de SDK-vereiste afgeleid uit een global.json-bestand.

All is een uninstallfilter. Het wordt niet opgeslagen als een specificatiebron.

Een exacte versie is een vastgezette specificatie. Updateopdrachten laten het niet verdergaan. Een kanaalspecificatie kan tijdens een update naar een nieuwere versie verwijzen.

Installaties en gedeelde bestanden

Een installatie registreert één concrete onderdeelversie en de subcomponentmappen die deze gebruikt. Twee specificaties kunnen resulteren in dezelfde installatie.

Deïnstallatieopdrachten verwijderen eerst overeenkomende specificaties. Garbagecollection bewaart vervolgens de nieuwste geïnstalleerde versie die overeenkomt met elke resterende specificatie. Hiermee verwijdert u een installatie en de niet-gedeelde subonderdelen alleen wanneer geen enkele resterende specificatie deze nodig heeft.

Voordat de deïnstallatie van status verandert, wordt er gewaarschuwd als een andere specificatie een aangevraagde installatie behoudt of als garbagecollection extra installaties verwijdert. In de interactieve modus moeten deze waarschuwingen worden bevestigd. Zie het gedrag van SDK-verwijdering en het gedrag voor runtime-verwijdering voor meer informatie.

Bijgehouden en niet-bijgehouden installaties

Standaard registreert een installatieopdracht de specificatie en het resultaat ervan in het manifest. Een gevolgde installatie kan worden weergegeven, bijgewerkt en verwijderd door dotnetup.

Met de --untracked optie worden bestanden geïnstalleerd zonder deze te registreren. dotnetup vermeldt, bijwerkt of verwijdert deze bestanden niet. Gebruik deze optie alleen als een ander proces eigenaar is van de doelmap.

Om onbedoeld mengen te voorkomen, mislukt een bijgehouden installatie als het doel een bestaande .NET installatie bevat die zich niet in het geselecteerde manifest bevindt. Selecteer een andere map, verwijder de bestaande installatie of gebruik --untracked.

Toestandsbestanden

De dotnetup-gegevensmap bevat deze statusbestanden op gebruikersniveau:

Bewerk deze bestanden niet. Gebruik dotnetup install, update, uninstallen env opdrachten om de gerelateerde status te wijzigen. Gebruik dotnetup self update --update-notifications <true|false> om de meldingsinstelling te wijzigen zonder het uitvoerbare bestand bij te werken.

De DOTNET_DOTNETUP_DATA_DIR omgevingsvariabele wijzigt de gegevensmap. De --manifest-path optie wijzigt alleen het manifest dat door één opdracht wordt gebruikt. Het configuratiebestand of de standaardinstallatiehoofdmap wordt niet gewijzigd.

Gelijktijdige bewerkingen

Workflows voor installeren, bijwerken, verwijderen, weergeven en garbagecollection coördineren de toegang tot de gedeelde installatiestatus. Een opdracht die verschillende specificaties accepteert, lost deze op voordat ze worden geïnstalleerd en kan deze gelijktijdig downloaden. Manifestwijzigingen blijven geserialiseerd.

Zelf-update coördineert vervanging van het uitvoerbare dotnetup afzonderlijk van .NET installatiestatus. Andere opdrachten kunnen mislukken terwijl self-update de coördinatievergrendelingen aanhoudt. Voer deze opdrachten opnieuw uit nadat de update is voltooid. Zie dotnetup self updatevoor meer informatie.

Zie ook

• Kanalen en versies
• Repository-SDK-vereisten
• Omgevingsconfiguratie
• dotnetup list