Kom igång med dotnetup

Note

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

dotnetupär en plattformsoberoende verktygshanterare för .NET installationer på användarnivå. Den installerar, uppdaterar och tar bort .NET SDK:er och runtimes utan att använda en systempakethanterare.

Prerequisites

• Ett av följande operativsystem och arkitekturer:

  Operativsystem	Architectures
  Windows	x64, Arm64
  macOS	x64, Arm64
  Linux (glibc)	x64, Arm64
  Linux (musl), till exempel Alpine Linux	x64, Arm64

• En terminal.

• Bash på macOS eller Linux, eller PowerShell på Windows, för att köra nedladdningsskriptet.

• På macOS eller Linux, curl eller wget för att ladda ned filer och sha512sum eller shasum för att verifiera dem.

dotnetuphar samma operativsystemkrav som .NET Runtime. Os-specifika krav finns i Installera .NET på Windows, Installera .NET på macOS eller Installera .NET på Linux.

Important

På Windows använder standardkonfigurationen åtkomstläget everywhere. Det här läget:

• Kräver administratörsbehörighet för att uppdatera systemet PATH.
• Gör att den dotnetup-hanterade installationen har företräde framför datoromfattande .NET-installationer, till exempel de som Visual Studio installerar. Projekt och appar som behöver en datoromfattande SDK eller körmiljö som inte också installeras genom dotnetup kan inte skapas eller köras.
• Ändrar systemet PATH, vilket gäller för alla användare. Förhöjda processer som andra användare startar kan använda .NET från din användarprofil.

Om du vill undvika dessa effekter väljer du åtkomstläget none eller shell under installationen. Om du väljer everywhere migrerar du dina befintliga installationer när installationsprogrammet erbjuder det. Mer information finns i överväganden för överalltläge.

Ladda ned dotnetup

Nedladdningsskripten installerar den senaste preview versionen som standard. De verifierar den nedladdade körbara filen med dess SHA-512-kontrollsumma och installerar den i ~/.dotnetup.

Kör på macOS eller Linux:

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

Kör på Windows:

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

Om du vill installera den senaste daily versionen på macOS eller Linux kör du:

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

Om du vill installera den senaste daily versionen på Windows kör du:

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

Important

Dagliga byggen har inte slutfört versionsverifieringen och är inte kodsignerade. Använd endast dagliga versioner för kortvarig testning.

Skripten skriver ut instruktioner för att lägga till dotnetup i PATH. Öppna en ny terminal när du har tillämpat instruktionerna.

Utför den första konfigurationen

Kör den interaktiva installationen:

> 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!

Sökvägar, förloppsvisning och vägledning om miljön beror på systemet och det valda läget.

Det rekommenderade åtkomstläget är everywhere på Windows. I macOS och Linux är shell det när dotnetup identifierar ett skal som stöds och none på annat sätt.

Välj Nej, anpassa konfigurationen för att välja SDK-kanal, åtkomstläge och migreringsalternativ.

Välj en SDK-kanal

En SDK-kanal talar om dotnetup för vilken SDK som ska installeras och hur den ska uppdateras.

Kanalformulär	Example	Result
Senaste stabila versionen	latest	Senaste aktiva stabila SDK:t
Senaste LTS	lts	Senaste aktiva, stabila LTS-SDK:n
Senaste förhandsversion	preview	Senaste förhandsversionen av SDK:t
Senaste dagliga	daily	Senaste tillgängliga dagliga SDK
Huvudsaklig	10	Senaste SDK:t för den angivna huvudversionen
Större och mindre	10.0	Senaste SDK:t för den angivna huvudversionen och delversionen
Funktionsområdet	10.0.1xx	Senaste SDK:et i den angivna funktionsgruppen
Specifik version	10.0.103	Endast den angivna SDK-versionen
Inget initialt SDK	none	Hoppa över installationen under konfigurationen

Exakta versioner uppdateras inte under uppdateringar. Alla godkända format finns i dotnetup-kanaler och versioner.

Välj hur du ska komma åt .NET

Åtkomstläget styr hur terminaler och program hittar den dotnetup-hanterade .NET installationen.

Åtkomstläge	Behavior
none	Ändrar inte dessa miljövariabler. Kör .NET med dotnetup dotnet.
shell	Ändrar skalprofilen för att ange dessa miljövariabler. Processer som startas från det kommandoskalet använder de .NET SDK:er och runtimes som installerats av dotnetup.
everywhere	Ändrar systemnivån för PATH och anger miljövariabeln på användarnivå DOTNET_ROOT. Endast tillgängligt på Windows.

Mer information och överväganden för läget everywhere finns i dotnetup-miljökonfiguration.

Migrera befintliga installationer

Installationsprogrammet kan erbjuda migrering av befintliga systemomfattande .NET SDK- och Runtime-installationer till den dotnetup-hanterade installationen. Se överväganden för Everywhere mode för varför migrering är särskilt viktigt med everywhere-läget.

Verifiera konfigurationen

Öppna en ny terminal efter att konfigurationsändringarna har ändrat dina miljövariabler.

För shell- eller everywhere-läge, kör:

dotnet --version
dotnetup list

För läget none, kör:

dotnetup dotnet -- --version
dotnetup list

Kör dotnetup init igen för att ändra konfigurationen.