Erste Schritte mit dotnetup

Hinweis

dotnetup befindet sich in der öffentlichen Vorschau. Die Features und das Verhalten können sich vor der allgemeinen Verfügbarkeit ändern.

dotnetup ist ein plattformübergreifender Toolchain-Manager für .NET-Installationen auf Benutzerebene. Es installiert, aktualisiert und entfernt .NET SDKs und Laufzeiten, ohne einen Systempaket-Manager zu verwenden.

Voraussetzungen

  • Eines der folgenden Betriebssysteme und Architekturen:

    Betriebssystem Architekturen
    Windows x64, Arm64
    macOS x64, Arm64
    Linux (glibc) x64, Arm64
    Linux (Musl), z. B. Alpine Linux x64, Arm64

  • Ein Terminal.

  • Bash auf macOS oder Linux oder PowerShell auf Windows, um das Downloadskript auszuführen.

  • Unter macOS oder Linux curl oder wget zum Herunterladen von Dateien und sha512sum oder shasum zum Überprüfen dieser Dateien.

dotnetup hat die gleichen Betriebssystemanforderungen wie die .NET Runtime. Informationen zu betriebssystemspezifischen Anforderungen finden Sie unter Installieren .NET unter Windows, Installieren .NET unter macOS oder installieren .NET unter Linux.

Von Bedeutung

In Windows verwendet das Standardsetup den everywhere Zugriffsmodus. Dieser Modus:

  • Zum Aktualisieren des Systems sind Administratorrechte erforderlich PATH.
  • Macht die von dotnetup verwaltete Installation Vorrang vor computerweiten .NET-Installationen, z. B. den Installationen, die von Visual Studio installiert werden. Projekte und Apps, die ein computerweites SDK oder eine computerweite Laufzeit benötigen, die nicht auch von dotnetup installiert ist, können nicht erstellt oder ausgeführt werden.
  • Änderungen am System PATH, die für alle Benutzer gelten. Erhöhte Prozesse, die andere Benutzer starten, lösen .NET möglicherweise aus Ihrem Benutzerprofil auf.

Um diese Effekte zu vermeiden, wählen Sie während des Setups den none oder shell Zugriffsmodus aus. Wenn Sie everywhere auswählen, migrieren Sie Ihre vorhandenen Installationen, wenn das Setup dies anbietet. Ausführliche Informationen finden Sie in den Überlegungen zum Modus „Überall“.

Dotnetup herunterladen

Die Downloadskripts installieren standardmäßig den neuesten preview Build. Sie überprüfen die heruntergeladene ausführbare Datei mit ihrer SHA-512-Prüfsumme und installieren sie in ~/.dotnetup.

Führen Sie unter macOS oder Linux Folgendes aus:

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

Führen Sie auf Windows Folgendes aus:

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

Um den neuesten daily Build unter macOS oder Linux zu installieren, führen Sie Folgendes aus:

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

Führen Sie Folgendes aus, um den neuesten daily Build auf Windows zu installieren:

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

Von Bedeutung

Tägliche Builds haben die Releasevalidierung nicht abgeschlossen und sind nicht mit Code signiert. Verwenden Sie tägliche Builds nur für kurzlebige Tests.

Die Skripts drucken Anweisungen zum Hinzufügen von dotnetup zu PATH. Öffnen Sie ein neues Terminal, nachdem Sie die Anweisungen angewendet haben.

Ersteinrichtung ausführen

Führen Sie das interaktive Setup aus:

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

Die Pfade, Statusanzeige und Umgebungsanleitungen hängen vom System und dem ausgewählten Modus ab.

Der empfohlene Zugriffsmodus ist unter Windows everywhere. Unter macOS und Linux ist es shell, wenn dotnetup eine unterstützte Shell erkennt, und none andernfalls.

Wählen Sie Nein, Setup anpassen aus, um den SDK-Kanal, den Zugriffsmodus und die Migrationsoptionen auszuwählen.

SDK-Kanal auswählen

Ein SDK-Kanal teilt dotnetup mit, welches SDK installiert werden soll und wie es aktualisiert werden soll.

Channel-Formular Beispiel Result
Neueste stabile Version latest Neuestes aktives stabiles SDK
Neueste LTS-Version lts Neuestes aktives stabiles LTS SDK
Neueste Vorschau preview Neuestes Vorschau-SDK
Neueste täglich daily Neuestes verfügbares tägliches SDK
Haupt 10 Neuestes SDK für die angegebene Hauptversion
Major und Minor 10.0 Neuestes SDK für die angegebene Haupt- und Nebenversion
Funktionsleiste 10.0.1xx Neuestes SDK im angegebenen Featureband
Exakte Version 10.0.103 Nur die angegebene SDK-Version
Kein initiales SDK none Installation während des Setups überspringen

Exakte Versionen werden bei Updates nicht fortgeschrieben. Alle zulässigen Varianten finden Sie unter dotnetup-Kanälen und -Versionen.

Wählen Sie aus, wie Sie auf .NET zugreifen

Der Zugriffsmodus steuert, wie Terminals und Anwendungen die von dotnetup verwalteten .NET Installation finden.

Zugriffsmodus Behavior
none Ändert diese Umgebungsvariablen nicht. .NET mit dotnetup dotnet ausführen.
shell Ändert das Shellprofil, um diese Umgebungsvariablen festzulegen. Von dieser Shell gestartete Prozesse verwenden die von dotnetup installierten .NET SDKs und Runtimes.
everywhere Ändert das System PATH und legt die Umgebungsvariable auf Benutzerebene DOTNET_ROOT fest. Nur für Windows verfügbar.

Weitere Details und Überlegungen für den Modus everywhere finden Sie in der dotnetup-Umgebungskonfiguration.

Vorhandene Installationen migrieren

Setup kann anbieten, vorhandene computerweite .NET SDK- und Runtime-Installationen in die von dotnetup verwaltete Installation zu migrieren. Siehe Überlegungen zum Modus „Überall“, warum die Migration mit dem Modus everywhere besonders wichtig ist.

Überprüfen Sie das Setup

Öffnen Sie nach Änderungen durch das Setup ein neues Terminal.

Führen Sie im Modus shell oder everywhere Folgendes aus:

dotnet --version
dotnetup list

Für den Modus none ausführen:

dotnetup dotnet -- --version
dotnetup list

Führen Sie dotnetup init erneut aus, um das Setup zu ändern.

  • Zuletzt aktualisiert um