Installieren von .NET unter macOS

• Auf Windows installieren
• Installieren unter macOS
• Installieren unter Linux

In diesem Artikel erfahren Sie, welche Versionen von .NET unter macOS unterstützt werden, wie sie .NET installieren und was der Unterschied zwischen dem SDK und der Laufzeit ist.

Die neueste Version von .NET ist 10.

Download .NET

Unterstützte Versionen

In der folgenden Tabelle sind die unterstützten .NET Versionen und die macOS aufgeführt, auf denen sie unterstützt werden. Diese Versionen werden weiterhin unterstützt, bis die Version von .NET das Ende des Supports erreicht oder die Version von macOS nicht mehr unterstützt wird.

macOS-Version	.NET
macOS 26 "Tahoe"	10.0, 9.0, 8.0
macOS 15 „Sequoia”	10.0, 9.0, 8.0
macOS 14 "Sonoma"	9.0, 8.0

Die folgenden Versionen von .NET werden ❌ nicht mehr unterstützt:

• .NET 7
• .NET 6
• .NET 5
• .NET Core 3.1
• .NET Core 3.0
• .NET Core 2.2
• .NET Core 2.1
• .NET Core 2.0

Runtime oder SDK

Die runtime wird verwendet, um mit .NET erstellte Apps auszuführen. Wenn ein App-Autor eine App veröffentlicht, kann er die Runtime zusammen mit seiner App bereitstellen. Wenn sie die Runtime nicht einschließen, liegt es am Benutzer, die richtige Runtime zu installieren.

Es gibt zwei Runtimes, die Sie unter macOS installieren können. Beide sind im SDK enthalten.

• ASP.NET Core Runtime
  Führt ASP.NET Core Apps aus. Enthält die .NET-Laufzeitumgebung. Nicht als Installationsprogramm verfügbar.

• .NET Runtime
  Dies führt normale .NET Apps aus, jedoch keine speziellen Apps, z. B. apps, die auf ASP.NET Core basieren.

Die SDK wird verwendet, um .NET Apps und Bibliotheken zu erstellen und zu veröffentlichen. Das neueste SDK unterstützt das Erstellen von Apps für frühere Versionen von .NET. Unter normalen Umständen muss nur das aktuelle SDK installiert sein.

Die Installation des SDK umfasst sowohl die Standard-.NET Runtime als auch die ASP.NET Core Runtime. Wenn Sie z. B. .NET SDK 9.0 installiert haben, werden .NET Runtime 9.0 und ASP.NET Core 9.0 Runtime beide installiert. Allerdings werden keine anderen Runtimeversionen mit dem SDK installiert, sodass Sie diese separat installieren müssten.

Auswählen, wie .NET installiert werden soll

Es gibt verschiedene Möglichkeiten, .NET zu installieren, und einige Produkte verwalten möglicherweise ihre eigene Version von .NET. Wenn Sie .NET über Software installieren, die eine eigene Version von .NET verwaltet, ist sie möglicherweise nicht systemweit aktiviert. Stellen Sie sicher, dass Sie die Auswirkungen der Installation von .NET über andere Software verstehen.

Wenn Sie nicht sicher sind, welche Methode Sie nach der Überprüfung der Listen in den folgenden Abschnitten auswählen sollten, möchten Sie wahrscheinlich das .NET Installer-Paket verwenden.

Entwickler

• Visual Studio Code - C# Dev Kit

  Installieren Sie die Erweiterung C# Dev Kit für Visual Studio Code, um .NET Apps zu entwickeln. Die Erweiterung kann ein bereits installiertes SDK verwenden oder ein SDK für Sie installieren.

Benutzer und Entwickelnde

• .NET Installer

  Verwenden Sie das eigenständige Installationsprogramm, um .NET zu installieren. Diese Methode ist die typische Methode zum Installieren von .NET auf Ihrem Entwickler- oder Benutzercomputer.

• Install .NET mit einem Skript

  Ein Bash-Skript, mit dem die Installation des SDK oder der Runtime automatisiert werden kann. Sie können auswählen, welche Version von .NET installiert werden soll.

• Installieren .NET manuell

  Verwenden Sie diese Installationsmethode, wenn Sie .NET in einem bestimmten Ordner installieren müssen, und führen Sie sie abgesehen von anderen Kopien von .NET aus.

Installieren von .NET

Installer-Pakete sind für macOS verfügbar, eine einfache Möglichkeit zum Installieren von .NET.

1. Öffnen Sie einen Browser, und navigieren Sie zu .

2. Wählen Sie den Link zur .NET Version aus, die Sie installieren möchten, z. B. .NET 10.0.

   

   Dieser Link bringt Sie zur Seite mit Links zum Herunterladen dieser Version von .NET

   Wenn Sie das SDK installieren möchten, wählen Sie die neueste .NET Version aus. Das SDK unterstützt das Erstellen von Apps für frühere Versionen von .NET.

   Tipp

   Wenn Sie nicht sicher sind, welche Version Sie herunterladen müssen, wählen Sie die als aktuell markierte Version aus.

3. Diese Seite enthält die Downloadlinks für das SDK und die Runtime. Hier laden Sie das .NET SDK oder .NET Runtime herunter.

   

   In der obigen Abbildung sind zwei Abschnitte hervorgehoben. Wenn Sie das SDK herunterladen, lesen Sie Abschnitt 1. Informationen zur .NET Runtime finden Sie in Abschnitt 2.

   • Abschnitt 1 (SDK)

     Dieser Abschnitt ist der Bereich für den Download des SDK. In der Spalte 'Installationsprogramme' in der Zeile 'macOS' sind zwei Architekturen aufgeführt: Arm64 und x64.

     • Wenn Sie einen Apple-Prozessor haben, z. B. einen M1- oder M3 Pro-Prozessor, wählen Sie Arm64 aus.
     • Wenn Sie einen Intel-Prozessor verwenden, wählen Sie x64 aus.

   • Abschnitt 2 (Laufzeit)

     Dieser Abschnitt enthält die Runtimedownloads. Beachten Sie, dass die Links in der Spalte „Installationsprogramme“ in der macOS-Zeile leer sind! Dieser Abschnitt ist leer, da die ASP.NET Core Runtime nur im SDK oder über binary installation bereitgestellt wird.

     Scrollen Sie weiter unten, um den Standard .NET Runtime zum Download zu finden.

     

     • Wenn Sie einen Apple-Prozessor haben, z. B. einen M1- oder M3 Pro-Prozessor, wählen Sie Arm64 aus.
     • Wenn Sie einen Intel-Prozessor verwenden, wählen Sie x64 aus.

4. Sobald der Download abgeschlossen ist, öffnen Sie die heruntergeladene Datei.

5. Folgen Sie den Schritten im Installationsprogramm.

   

Manuelles Installieren von .NET

Alternativ zu den macOS-Installationsprogrammen können Sie das SDK und die Runtime herunterladen und manuell installieren. Die manuelle Installation wird normalerweise als Teil der Teilautomatisierung in einem Continuous-Integration-Szenario durchgeführt. Entwickler und Benutzer möchten in der Regel das Installationsprogramm verwenden.

Tipp

Verwenden Sie das Skript „install-dotnet.sh”, um diese Schritte automatisch auszuführen.

1. Öffnen Sie einen Browser, und navigieren Sie zu .

2. Wählen Sie den Link zur .NET Version aus, die Sie installieren möchten, z. B. .NET 8.0.

   Dieser Link bringt Sie zur Seite mit Links zum Herunterladen dieser Version von .NET

   Wenn Sie das SDK installieren möchten, wählen Sie die neueste .NET Version aus. Das SDK unterstützt das Erstellen von Apps für frühere Versionen von .NET.

   Tipp

   Wenn Sie nicht sicher sind, welche Version Sie herunterladen müssen, wählen Sie die als aktuell markierte Version aus.

   

3. Wählen Sie den Link zum SDK oder zur Runtime aus, das bzw. die Sie installieren möchten. Suchen Sie nach der Spalte Binärdateien in der Zeile macOS.

   

   • Wenn Sie einen Apple-Prozessor haben, z. B. einen M1- oder M3 Pro-Prozessor, wählen Sie Arm64 aus.
   • Wenn Sie einen Intel-Prozessor verwenden, wählen Sie x64 aus.

4. Öffnen Sie ein Terminal, und navigieren Sie zu der Stelle, an der die .NET Binärdatei heruntergeladen wurde.

5. Extrahieren Sie das Tar-Archiv an den Ort, an dem Sie .NET auf Ihrem System entpacken möchten. Im folgenden Beispiel wird das HOME-Verzeichnis verwendet.

   mkdir -p ~/Applications/.dotnet
   tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/
   

Testen Sie, dass .NET funktioniert, indem Sie das Verzeichnis so ändern, dass .NET installiert wurde, und führen Sie den Befehl dotnet --info aus:

chdir ~/Applications/.dotnet/
./dotnet --info

Installieren von .NET mit einem Skript

Die dotnet-install-Skripts werden für die Automatisierung und für Installationen der Runtime ohne erhöhte Rechte verwendet. Sie können das Skript unter herunterladen.

Das Skript installiert standardmäßig die neueste long Term Support (LTS) Version, die .NET 8 ist. Sie können eine bestimmte Version durch Angabe des Schalters auswählen. Fügen Sie den Schalter hinzu, um eine Runtime zu installieren. Andernfalls installiert das Skript das SDK.

Tipp

Diese Befehle werden am Ende dieses Verfahrens als Skriptausschnitt bereitgestellt.

1. Öffnen Sie ein Terminal.

2. Navigieren Sie zu einem Ordner, in den Sie das Skript herunterladen möchten, z. B. ~/Downloads.

3. Wenn Sie nicht über den Befehl verfügen, installieren Sie ihn mit Brew.

   brew install wget
   

4. Führen Sie den folgenden Befehl aus, um das Skript herunterzuladen:

   wget https://dot.net/v1/dotnet-install.sh
   

5. Erteilen Sie dem Skript Ausführungsberechtigungen.

   chmod +x dotnet-install.sh
   

6. Führen Sie das Skript aus, um .NET zu installieren.

   Das Skript installiert standardmäßig das aktuelle SDK im Verzeichnis .

   ./dotnet-install.sh
   

Im Folgenden sind alle Befehle in einem einzelnen Bash-Skript zusammengefasst:

chdir ~/Downloads
brew install wget
wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh

Testen Sie .NET, indem Sie zum Ordner ~/.dotnet navigieren und den Befehl dotnet --info ausführen:

chdir ~/.dotnet
./dotnet --info

Wichtig

Einige Programme verwenden möglicherweise Umgebungsvariablen, um .NET auf Ihrem System zu finden, und die Verwendung des Befehls dotnet funktioniert möglicherweise beim Öffnen eines neuen Terminals nicht. Hilfe zum Beheben dieses Problems finden Sie im Abschnitt Systemweite Verfügbarkeit von .NET.

Installieren von .NET für Visual Studio Code

Visual Studio Code ist ein leistungsstarker und einfacher Quellcode-Editor, der auf Dem Desktop ausgeführt wird. Visual Studio Code kann das bereits auf Ihrem System installierte SDK verwenden. Darüber hinaus installiert die erweiterung C# Dev Kit .NET für Sie, wenn sie noch nicht installiert ist.

Anweisungen zum Installieren von .NET über Visual Studio Code finden Sie unter Getting Started with C# in VS Code.

Notarielle Beglaubigung

Software, die für macOS erstellt wurde, die mit einer Entwickler-ID verteilt wird, muss notarisiert werden, einschließlich Apps, die mit .NET erstellt wurden.

Wenn Sie eine nicht notarisierte App ausführen, wird ein Fehlerfenster ähnlich der folgenden Abbildung angezeigt:

macOS Catalina-Notarisierungswarnung

Weitere Informationen dazu, wie sich die erzwungene Notarisierung auf .NET (und Ihre .NET-Apps) auswirkt, finden Sie unter Working with macOS Catalina Notarization.

Überprüfen

Vergewissern Sie sich nach dem Herunterladen eines Installationsprogramms oder Binärrelease, dass die Datei nicht geändert oder beschädigt wurde. Sie können die Prüfsumme auf Ihrem Computer überprüfen und sie dann mit dem auf der Downloadwebsite angegebenen Wert vergleichen.

Wenn Sie die Datei von einer offiziellen Downloadseite herunterladen, wird die Prüfsumme für die Datei in einem Textfeld angezeigt. Wählen Sie die Schaltfläche Kopieren aus, um den Prüfsummenwert in Ihre Zwischenablage zu kopieren.

Verwenden Sie den Befehl , um die Prüfsumme der heruntergeladenen Datei auszugeben. Der folgende Befehl meldet beispielsweise die Prüfsumme der dotnet-sdk-9.0.306-osx-x64.tar.gz Datei:

$ shasum -a 512 dotnet-sdk-9.0.306-osx-x64.tar.gz
a9700f98e5aa4f70b2a08ddba2b1c6085106b0d17828bd719fdcef460b06c890b32d752fbff8e4659cd1ca4174b4b211b301fe682439ea9a24b6521ca5a64c69  dotnet-sdk-9.0.306-osx-x64.tar.gz

Vergleichen Sie die Prüfsumme mit dem von der Downloadwebsite bereitgestellten Wert.

Verwenden Sie eine Prüfsummendatei zur Validierung

Die .NET Versionshinweise enthalten einen Link zu einer Prüfsummendatei, mit der Sie Ihre heruntergeladene Datei überprüfen können. Die folgenden Schritte beschreiben, wie Sie die Prüfsummendatei herunterladen und eine .NET Installationsdatei validieren:

1. Die Seite mit den Versionshinweisen für .NET 9 auf GitHub at https://github.com/dotnet/core/tree/main/release-notes/9.0#releases enthält einen Abschnitt mit dem Namen Releases. Die Tabelle in diesem Abschnitt enthält Links zu den Downloads- und Prüfsummendateien für jede .NET 9-Version. Die folgende Abbildung zeigt die .NET 8-Versionstabelle als Referenz:

   

2. Wählen Sie den Link für die Version von .NET aus, die Sie heruntergeladen haben.

   Im vorherigen Abschnitt wurde .NET SDK 9.0.306 verwendet, das sich in der version .NET 9.0.10 befindet.

3. Auf der Veröffentlichungsseite können Sie die .NET Runtime- und .NET SDK-Version sowie einen Link zur Prüfsummendatei anzeigen. Die folgende Abbildung zeigt die .NET 8-Versionstabelle als Referenz:

   

4. Klicken Sie mit der rechten Maustaste auf den Prüfsummenlink, um ihn in die Zwischenablage zu kopieren.

5. Öffnen Sie ein Terminal.

6. Verwenden Sie , um die Prüfsummendatei herunterzuladen.

   Ersetzen Sie den Link im folgenden Befehl durch den Link, den Sie kopiert haben.

   curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt
   

7. Laden Sie sowohl die Prüfsummen- als auch die .NET-Releasedatei in dasselbe Verzeichnis herunter. Verwenden Sie dann den Befehl shasum -a 512 -c {file}, um die heruntergeladene Datei zu überprüfen.

   Wenn die Überprüfung erfolgreich ist, wird die Datei mit dem Status OK ausgegeben:

   $ shasum -a 512 -c 9.0.10-sha.txt
   dotnet-sdk-9.0.306-osx-x64.tar.gz: OK
   

   Wenn die Datei mit FEHLER markiert ist, ist die heruntergeladene Datei ungültig und sollte nicht verwendet werden.

   $ shasum -a 512 -c 9.0.10-sha.txt
   dotnet-sdk-9.0.306-osx-x64.tar.gz: FAILED
   shasum: WARNING: 1 computed checksum did NOT match
   

Arm-basierte Mac-Computer

In den folgenden Abschnitten werden die Punkte beschrieben, die Sie beim Installieren von .NET auf einem Arm-basierten Mac berücksichtigen sollten.

Pfadunterschiede

Auf einem armbasierten Mac werden alle Arm64-Versionen von .NET im normalen Ordner /usr/local/share/do tnet/ installiert. Wenn Sie jedoch die x64 Version des .NET SDK installieren, wird sie im Ordner /usr/local/share/do tnet/x64/do tnet/ installiert.

Pfadvariablen

Umgebungsvariablen, die .NET zum Systempfad hinzufügen, z. B. der Variablen PATH, müssen möglicherweise geändert werden, wenn Sowohl die x64- als auch die Arm64-Versionen des .NET SDK installiert sind. Darüber hinaus basieren einige Tools auf der umgebungsvariablen DOTNET_ROOT, die ebenfalls aktualisiert werden muss, um auf den entsprechenden .NET SDK-Installationsordner zu verweisen.

Problembehandlung

In den folgenden Abschnitten finden Sie Informationen zur Behandlung von Problemen:

• Arm-basierte Macs
• Make .NET systemweit verfügbar

.NET systemweit verfügbar machen

Manchmal müssen Apps auf Ihrem System, einschließlich des Terminals, feststellen, wo .NET installiert ist. Das .NET macOS Installer-Paket sollte Ihr System automatisch konfigurieren. Wenn Sie jedoch die manual-Installationsmethode oder das .NET Installationsskript verwendet haben, müssen Sie das Verzeichnis hinzufügen, in dem .NET der Variablen PATH installiert wurde.

Einige Apps suchen möglicherweise nach der Variablen DOTNET_ROOT, wenn Sie versuchen, zu bestimmen, wo .NET installiert ist.

Für macOS sind viele verschiedene Shells verfügbar, die jeweils über unterschiedliche Profile verfügen. Beispiel:

• Bash-Shell: ~/.profile, /etc/profile
• Korn-Shell: ~/.kshrc oder .profile
• Z-Shell: ~/.zshrc oder .zprofile

Legen Sie die folgenden beiden Umgebungsvariablen in Ihrem Shellprofil fest:

• DOTNET_ROOT

  Diese Variable wird auf den Ordner festgelegt, auf den .NET installiert wurde, z. B. $HOME/.dotnet:

  export DOTNET_ROOT=$HOME/.dotnet
  

• PATH

  Diese Variable sollte sowohl den Ordner als auch den Ordner enthalten:

  export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
  

Zugehöriger Inhalt

• Wie zu überprüfen, ob .NET bereits installiert ist.
• Arbeiten mit der macOS Catalina-Notarisierung
• Tutorial: Erstellen Sie eine .NET Konsolenanwendung.
• Tutorial: Containerisieren einer .NET App.