Aan de slag met dotnetup

Note

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

dotnetup is een platformonafhankelijk beheerprogramma voor toolchains voor .NET-installaties op gebruikersniveau. Het installeert, werkt .NET SDK's en runtimes bij en verwijdert deze zonder een systeempakketbeheerder te gebruiken.

Prerequisites

• Een van de volgende besturingssystemen en architecturen:

  besturingssysteem	Architectures
  Windows	x64, Arm64
  macOS	x64, Arm64
  Linux (glibc)	x64, Arm64
  Linux (musl), zoals Alpine Linux	x64, Arm64

• Een terminal.

• Bash op macOS of Linux, of PowerShell op Windows, om het downloadscript uit te voeren.

• Op macOS of Linux, curl of wget om bestanden te downloaden en sha512sum of shasum om ze te verifiëren.

dotnetupheeft dezelfde besturingssysteemvereisten als de .NET Runtime. Zie .NET installeren op Windows, .NET installeren in macOS of .NET installeren op Linux voor specifieke vereisten voor het besturingssysteem.

Important

In Windows gebruikt de standaardinstelling de everywhere toegangsmodus. Deze modus:

• Verhoogde rechten zijn vereist om het systeem PATH bij te werken.
• Zorgt ervoor dat de door dotnetup beheerde installatie voorrang krijgt op machinebrede .NET-installaties, zoals de installaties die Visual Studio installeert. Projecten en apps die een machinebrede SDK of runtime nodig hebben die niet ook is geïnstalleerd door dotnetup, kunnen niet worden gebouwd of uitgevoerd.
• Hiermee wijzigt u het systeem PATH, dat van toepassing is op alle gebruikers. Verhoogde processen die andere gebruikers starten, kunnen .NET vanuit uw gebruikersprofiel laden.

Als u deze effecten wilt voorkomen, kiest u tijdens de installatie de toegangsmodus none of shell. Als u voor everywhere kiest, migreer uw bestaande installaties wanneer het installatieprogramma dit aanbiedt. Zie Overwegingen voor de modus Everywhere voor meer informatie.

Dotnetup downloaden

De downloadscripts installeren standaard de nieuwste preview build. Ze controleren het gedownloade uitvoerbare bestand met de bijbehorende SHA-512-controlesom en installeren het in ~/.dotnetup.

Voer in macOS of Linux het volgende uit:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

Voer op Windows het volgende uit:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

Als u de nieuwste build wilt installeren in macOS of Linux, voert u het volgende daily uit:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily

Voer de volgende opdracht uit om de nieuwste daily build op Windows te installeren:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily"

Important

Dagelijkse builds hebben de releasevalidatie niet voltooid en zijn niet met code ondertekend. Gebruik dagelijkse builds alleen voor tests met een korte levensduur.

De scripts afdrukken instructies om dotnetup aan PATH toe te voegen. Open een nieuwe terminal nadat u de instructies hebt toegepast.

Eerste installatie uitvoeren

Voer de interactieve installatie uit:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

De paden, voortgangsweergave en omgevingsrichtlijnen zijn afhankelijk van uw systeem en de geselecteerde modus.

De aanbevolen toegangsmodus is everywhere op Windows. Op macOS en Linux is het shell wanneer dotnetup een ondersteunde shell detecteert, en anders none.

Selecteer Nee, pas de installatie aan om het SDK-kanaal, de toegangsmodus en de migratieopties te kiezen.

Een SDK-kanaal kiezen

Een SDK-kanaal geeft voor dotnetup aan welke SDK moet worden geïnstalleerd en hoe deze moet worden bijgewerkt.

Formulier voor kanaal	Example	Result
Nieuwste stabiele versie	latest	Meest recente actieve stabiele SDK
Nieuwste LTS	lts	Nieuwste actieve stabiele LTS SDK
Nieuwste previewversie	preview	Nieuwste preview-SDK
Nieuwste dagelijkse build	daily	Nieuwste beschikbare dagelijkse SDK
Majoor	10	Nieuwste SDK voor de opgegeven hoofdversie
Groot en klein	10.0	Nieuwste SDK voor de opgegeven major- en minorversie
Functielint	10.0.1xx	Nieuwste SDK in de opgegeven featureband
Exact version	10.0.103	Alleen de opgegeven SDK-versie
Geen SDK bij aanvang	none	Installatie overslaan tijdens de set-up

Exacte versies worden niet bijgewerkt tijdens updates. Zie dotnetup-kanalen en -versies voor alle geaccepteerde vormen.

Kiezen hoe u toegang wilt krijgen tot .NET

De toegangsmodus bepaalt hoe terminals en toepassingen de door dotnetup beheerde .NET-installatie vinden.

Toegangsmodus	Gedrag
none	Wijzigt deze omgevingsvariabelen niet. Voer .NET uit met dotnetup dotnet.
shell	Hiermee wijzigt u het shell-profiel om deze omgevingsvariabelen in te stellen. Processen die vanuit die shell zijn gestart, gebruiken de .NET SDK's en runtimes die zijn geïnstalleerd door dotnetup.
everywhere	Wijzigt het systeem PATH en stelt de omgevingsvariabele op gebruikersniveau DOTNET_ROOT in. Alleen beschikbaar op Windows.

Zie everywhere voor meer informatie en overwegingen voor de modus.

Bestaande installaties migreren

Setup kan aanbieden om bestaande machinebrede .NET SDK- en Runtime-installaties te migreren naar de door dotnetup beheerde installatie. Zie overwegingen voor de modus Everywhere voor de reden waarom migratie vooral belangrijk is met de modus everywhere.

Setup controleren

Open een nieuwe terminal nadat de installatie uw omgeving wijzigt.

Voer voor de modus shell of everywhere het volgende uit:

dotnet --version
dotnetup list

Voer voor de modus none het volgende uit:

dotnetup dotnet -- --version
dotnetup list

Voer opnieuw uit dotnetup init om de installatie te wijzigen.