Så här fungerar dotnetup

Note

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

dotnetup skiljer det du begär från de filer som den installerar. Med den här modellen kan flera program dela en .NET-installation och kan dotnetup ta bort filer som inte längre krävs.

Installationskataloger

En .NET-installationsrotkatalog är en katalog som dotnetup spårar. En installationsrot har:

  • En fullständigt kvalificerad katalogsökväg.
  • En arkitektur: x86, x64eller arm64.
  • Noll eller fler installationsspecifikationer, angivna som channels.
  • Noll eller flera konkreta installationer.

Den aktuella CLI-installationen gäller arkitekturen hos den körande dotnetup-processen. Det finns inget alternativ för arkitektur.

Standardinstallationsroten för dotnetup-managed .NET är underkatalogen dotnet i dotnetups datakatalog:

Platform Standardrotmapp för installation
Windows %LOCALAPPDATA%\dotnetup\dotnet
macOS ~/Library/Application Support/dotnetup/dotnet
Linux $XDG_DATA_HOME/dotnetup/dotnet, eller ~/.local/share/dotnetup/dotnet när XDG_DATA_HOME inte har angetts

Använd --install-path för att välja en annan installationsrot. En explicit installationssökväg har företräde framför en sökväg från global.json, som har företräde framför standardinstallationsroten.

dotnetupskriver inte till en systemhanterad .NET katalog, till exempel Program Files\dotnet eller /usr/share/dotnet.

Komponenter

dotnetup hanterar dessa komponenttyper:

Component Namn på specifikation för körning Installerat material
.NET SDK Ej tillämpligt SDK, host, runtime, målpaket och relaterat SDK-innehåll
.NET-körmiljö runtime Microsoft.NETCore.App runtime
ASP.NET Core-runtime aspnetcore Microsoft.AspNetCore.App runtime
Windows Desktop Runtime windowsdesktop Microsoft.WindowsDesktop.Appruntime på Windows

ASP.NET Core-aliaset aspnet och Windows Desktop-aliaset desktop godkänns i specifikationer för körningskomponenter.

Installationsspecifikationer

En installationsspec registrerar en komponent och en kanal eller exakt version. En SDK-specifikation för 10.0.1xx betyder till exempel "behåll den senaste SDK:t i feature band 10.0.1xx".

Du kan lära dig mer om de olika typer av kanaler och versioner som stöds i Kanaler och versioner.

Varje specifikation har en av följande källor:

  • Explicit: Du angav kanalen eller versionen på kommandoraden.
  • GlobalJson: dotnetup härledde SDK-kravet från en global.json fil.

All är ett avinstallationsfilter. Den lagras inte som en specifikationskälla.

En exakt version är en låst specifikation. Uppdateringskommandon flyttar det inte framåt. En kanalspecifikation kan resultera i en nyare version under en uppdatering.

Installationer och delade filer

En installation registrerar en konkret komponentversion och de underkomponentkataloger som den använder. Två specifikationer kan resultera i samma installation.

Avinstallationskommandon tar först bort matchande specifikationer. Skräpsamling behåller sedan den senaste installerade versionen som matchar varje återstående specifikation. Den tar bort en installation och dess icke-delade delkomponenter endast när ingen återstående specifikation behöver dem.

Innan avinstallationsändringar träder i kraft varnar den om en annan specifikation behåller en begärd installation eller om skräpinsamling tar bort ytterligare installationer. I interaktivt läge kräver dessa varningar bekräftelse. Mer information finns i beteende vid avinstallation av SDK och beteende vid avinstallation av Runtime.

Spårade och ospårade installationer

Som standard registrerar ett installationskommando sin specifikation och resultatet i manifestet. En spårad installation kan listas, uppdateras och tas bort av dotnetup.

Alternativet --untracked installerar filer utan att registrera dem. dotnetup listar inte, uppdaterar inte eller tar bort dessa filer. Använd endast det här alternativet när en annan process äger målkatalogen.

För att förhindra oavsiktlig blandning misslyckas en spårad installation om målet innehåller en befintlig .NET installation som inte finns i det valda manifestet. Välj en annan katalog, ta bort den befintliga installationen eller använd --untracked.

tillståndsfiler

dotnetup-datakatalogen innehåller dessa tillståndsfiler på användarnivå:

Fil Purpose
dotnetup_manifest.json Spårar installationsrötter, installationsspecifikationer, installationer och delade underkomponenter.
dotnetup_manifest.json.sha256 Upptäcker ändringar i manifestinnehåll som dotnetup inte skrev.
dotnetup.config.json Lagrar .NET åtkomstläge, om katalogen dotnetup är på PATH och om uppdateringsmeddelanden är aktiverade.
update-checks/ Lagrar tidsstämplar och tillgängliga versioner för dotnetup-uppdateringskontroller.

Redigera inte dessa filer. Använd kommandona dotnetup install, update, uninstall och env för att ändra det relaterade läget. Använd dotnetup self update --update-notifications <true|false> för att ändra meddelandeinställningen utan att uppdatera den körbara filen.

Miljövariabeln DOTNET_DOTNETUP_DATA_DIR ändrar datakatalogen. Alternativet --manifest-path ändrar endast manifestet som används av ett kommando. Den ändrar inte konfigurationsfilen eller standardinstallationsroten.

Samtidiga åtgärder

Arbetsflöden för installation, uppdatering, avinstallation, listning och skräpinsamling samordnar åtkomsten till delat installationstillstånd. Ett kommando som accepterar flera specifikationer bearbetar dem före installationen och kan ladda ned dem samtidigt. Manifeständringar förblir serialiserade.

Självuppdatering samordnar ersättning av den körbara dotnetup-filen separat från .NET installationstillstånd. Andra kommandon kan misslyckas medan självuppdateringen håller sina koordineringslås. Försök igen med dessa kommandon när uppdateringen har slutförts. Mer information finns i dotnetup self update.

Se även

  • Uppdaterades senast