Teilen über

Installieren von .NET SDK mit Snap

In diesem Artikel wird beschrieben, wie Sie das Snap-Paket für .NET SDK installieren. Snap-Pakete für .NET SDK werden von Canonical bereitgestellt und verwaltet. Snaps stellen eine gute Alternative zum in Ihre Linux-Distribution integrierten Paket-Manager dar.

Ein Snap ist ein Bündel aus einer App und ihren Abhängigkeiten, das in vielen verschiedenen Linux-Distributionen funktioniert. Snaps sind über den Snap Store abrufbar und installierbar. Weitere Informationen zu Snap finden Sie unter Schnellstart-Tour.

Achtung

Bei Snap-Installationen von .NET können Probleme beim Ausführen von .NET-Tools auftreten. Wenn Sie .NET-Tools verwenden möchten, sollten Sie .NET mit dem dotnet-install-Skript oder dem Paket-Manager für die jeweilige Linux-Distribution installieren.

Es ist ein bekanntes Problem, dass der dotnet watch-Befehl nicht funktioniert, wenn .NET über Snap installiert wird.

Wenn Sie .NET-Tools oder den dotnet watch-Befehl verwenden möchten, sollten Sie .NET mithilfe des dotnet-install-Skripts installieren.

Voraussetzungen

  • Linux-Distribution, die Snap unterstützt.
  • snapd der Snap-Daemon.

Ihre Linux-Distribution enthält möglicherweise bereits Snap. Versuchen Sie, snap von einem Terminal aus auszuführen, um festzustellen, ob der Befehl funktioniert. Eine Liste der unterstützten Linux-Distributionen und Anweisungen zum Installieren von Snap finden Sie unter Installierensnapd.

.NET-Releases

Microsoft veröffentlicht .NET unter zwei verschiedenen Supportrichtlinien, Long Term Support (LTS) und Standard Term Support (STS). Die Qualität aller Releases ist gleich. Der einzige Unterschied ist die Dauer des Supports. LTS-Versionen erhalten drei Jahre lang kostenlosen Support und Patches. STS-Versionen erhalten kostenlosen Support und Patches für zwei Jahre. Weitere Informationen finden Sie in der .NET-Supportrichtlinie.

Die Versionen von .NET, die derzeit von Microsoft unterstützt werden, sind:

  • 10.0 (LTS) – Der Support endet am 14. November 2028.
  • 9.0 (STS) – Der Support endet am 10. November 2026.
  • 8.0 (LTS) – Der Support endet am 10. November 2026.

Andere Entitäten, die .NET erstellen und freigeben, können unterschiedliche Supportrichtlinien einführen. Stellen Sie sicher, dass Sie sich mit ihnen vertraut machen, um zu verstehen, wie .NET unterstützt wird.

1. Installieren des SDKs

Wichtig

.NET 10 wurde am 11. November 2025 veröffentlicht. Es kann Zeit dauern, bis die Pakete in den Paket-Manager-Feeds oder für Ihre spezifische Linux-Verteilung angezeigt werden, um sie einzuschließen.

Ab .NET 9 werden Snap-Pakete für das .NET SDK unter versionsspezifischen Bezeichnern veröffentlicht (z dotnet-sdk-90 . B. für .NET 9 und dotnet-sdk-100 für .NET 10). Vor .NET 9 wurden alle SDK-Versionen unter demselben Bezeichner dotnet-sdkveröffentlicht, und Sie haben die Version über einen Kanal angegeben. Darüber hinaus unterstützen .NET 9 und höhere Snap-Pakete sowohl x64- als auch Arm64-Architekturen, während frühere Versionen nur x64 unterstützen. Das SDK enthält sowohl die ASP.NET Core- als auch die .NET-Runtime, versioniert für das SDK.

Tipp

Die Snapcraft .NET SDK-Paketseite enthält distributionsspezifische Anweisungen zum Installieren von Snapcraft und .NET.

  1. Öffnen Sie ein Terminal.

  2. Verwenden Sie snap install zum Installieren des Snap-Pakets für.NET SDK.

    Der --classic-Parameter ist erforderlich.

    • Für .NET 9 und höher

      Installieren Sie das versionsspezifische Paket. Der folgende Befehl installiert z. B. .NET SDK 10:

      sudo snap install dotnet-sdk-100 --classic

    • Für .NET 8 und frühere Versionen

      Installieren Sie aus dem dotnet-sdk Paket, und geben Sie einen Kanal an. Bei Weglassen dieses Parameters wird latest/stable verwendet. Der folgende Befehl installiert z. B. .NET SDK 8:

      sudo snap install dotnet-sdk --classic --channel 8.0/stable

Der Snap-Alias „dotnet“ wird automatisch erstellt und dem dotnet-Befehl des Snap-Pakets zugeordnet.

In der folgenden Tabelle sind die Snap-Pakete und Kanäle aufgeführt, die Sie installieren können:

.NET-Version Snap-Paket oder Kanal
10 (LTS) dotnet-sdk-100 (Vorschau)
9 (STS) dotnet-sdk-90
8 (LTS) dotnet-sdk --channel 8.0/stable
7 dotnet-sdk --channel 7.0/stable (nicht unterstützt)
6 dotnet-sdk --channel 6.0/stable (nicht unterstützt)
5 dotnet-sdk --channel 5.0/stable (nicht unterstützt)
3.1 dotnet-sdk --channel 3.1/stable (nicht unterstützt)
2.1 dotnet-sdk --channel 2.1/stable (nicht unterstützt)

2. Exportieren des Installationspfads

Die DOTNET_ROOT-Umgebungsvariable wird häufig von Tools verwendet, um zu ermitteln, wo .NET installiert ist. Wenn .NET über Snap installiert wird, ist diese Umgebungsvariable nicht konfiguriert. Sie sollten die Umgebungsvariable DOTNET_ROOT in Ihrem Profil konfigurieren. Der Pfad zu Snap verwendet das folgende Format: /snap/{package}/current.

Verwenden Sie für .NET 9 und höher den versionsspezifischen Paketnamen:

export DOTNET_ROOT=/snap/dotnet-sdk-100/current

Verwenden Sie für .NET 8 und früher den Namen des freigegebenen Pakets:

export DOTNET_ROOT=/snap/dotnet-sdk/current

Dauerhaftes Exportieren der Umgebungsvariable

Der oben aufgeführte Befehl export legt nur die Umgebungsvariable für die Terminalsitzung fest, in der er ausgeführt wurde.

Sie können Ihr Shell-Profil bearbeiten, um diese Befehle dauerhaft hinzuzufügen. Für Linux sind viele verschiedene Shells verfügbar, die jeweils über ein unterschiedliche Profile verfügen. Zum Beispiel:

  • Bash-Shell: ~/.bash_profile, ~/.bashrc
  • Korn-Shell: ~/.kshrc oder .profile
  • Z Shell: _~/.zshrc* oder .zprofile

Bearbeiten Sie die geeignete Quelldatei für Ihre Shell, und fügen Sie den Exportbefehl für Ihre installierte .NET-Version hinzu. Verwenden Sie export DOTNET_ROOT=/snap/dotnet-sdk-100/current für .NET 9+ und passen Sie die Versionsnummer bei Bedarf an. Verwenden Sie für .NET 8 und frühere Versionen export DOTNET_ROOT=/snap/dotnet-sdk/current.

3. Verwenden der .NET CLI

Öffnen Sie ein Terminal und geben Sie dotnet ein.

dotnet

Die folgende Ausgabe wird angezeigt:

Usage: dotnet [options]
Usage: dotnet [path-to-application]

Options:
  -h|--help         Display help.
  --info            Display .NET information.
  --list-sdks       Display the installed SDKs.
  --list-runtimes   Display the installed runtimes.

path-to-application:
  The path to an application .dll file to execute.

Informationen zur Verwendung der .NET CLI finden Sie in der .NET CLI-Übersicht.

Problembehandlung

Der Dotnet-Terminalbefehl funktioniert nicht.

Snap-Pakete können einem Befehl einen Alias zuordnen, der vom Paket bereitgestellt wird. Standardmäßig erstellen die Snap-Pakete für .NET SDK einen Alias für den dotnet-Befehl. Wenn der Alias nicht erstellt oder zuvor entfernt wurde, verwenden Sie den folgenden Befehl, um den Alias zuzuordnen.

Für .NET 9 und höher:

sudo snap alias dotnet-sdk-100.dotnet dotnet

Für .NET 8 und frühere Versionen:

sudo snap alias dotnet-sdk.dotnet dotnet

Snap auf WSL2 kann nicht installiert werden

systemd muss auf der WSL2-Instanz aktiviert sein, bevor Snap installiert werden kann.

  1. Öffnen Sie /etc/wsl.conf in einem Text-Editor Ihrer Wahl.

  2. Fügen Sie die folgende Konfiguration ein:

    [boot]
systemd=true

  3. Speichern Sie die Datei, und starten Sie die WSL2-Instanz über PowerShell neu. Verwenden Sie den Befehl wsl.exe --shutdown.

Der Dotnet-Befehl oder das SDK kann nicht aufgelöst werden.

Es ist üblich, dass andere Apps (z. B. Code IDE oder eine Erweiterung in Visual Studio Code) versuchen, den Speicherort des .NET SDK aufzulösen. Die Ermittlung erfolgt in der Regel durch Überprüfen der Umgebungsvariablen „DOTNET_ROOT“ oder durch das Herausfinden des Speicherorts der ausführbaren Datei „dotnet“. Ein Snap-installiertes .NET SDK könnte diese Apps verwirren. Wenn diese Apps das .NET SDK nicht auflösen können, wird ein Fehler angezeigt, der eine der folgenden Meldungen ähnelt:

  • The SDK 'Microsoft.NET.Sdk' specified could not be found (Das angegebene SDK „Microsoft.NET.Sdk“ wurde nicht gefunden)
  • The SDK 'Microsoft.NET.Sdk.Web' specified could not be found (Das angegebene SDK „Microsoft.NET.Sdk.Web“ wurde nicht gefunden)
  • The SDK 'Microsoft.NET.Sdk.Razor' specified could not be found (Das angegebene SDK „Microsoft.NET.Sdk.Razor“ wurde nicht gefunden)

Führen Sie die folgenden Schritte aus, um das Problem zu beheben:

  1. Stellen Sie sicher, dass Sie die DOTNET_ROOT-Umgebungsvariable dauerhaft exportieren.

  2. Versuchen Sie, die ausführbare dotnet-Snap-Datei symbolisch mit dem Speicherort, den das Programm sucht, zu verknüpfen.

    Zwei gängige Pfade, nach denen der Befehl dotnet sucht:

    • /usr/local/bin/dotnet
    • /usr/share/dotnet

    Verwenden Sie den folgenden Befehl, um eine symbolische Verknüpfung mit dem Snap-Paket zu erstellen. Verwenden Sie für .NET 9 und höher den versionsspezifischen Paketnamen:

    ln -s /snap/dotnet-sdk-100/current/dotnet /usr/local/bin/dotnet

    Für .NET 8 und frühere Versionen:

    ln -s /snap/dotnet-sdk/current/dotnet /usr/local/bin/dotnet

TLS/SSL-Zertifikatfehler

Wenn .NET über Snap installiert wird, ist es möglich, dass bei einigen Distributionen die TLS/SSL-Zertifikate für .NET nicht gefunden werden und während restore eine Fehlermeldung angezeigt wird:

Processing post-creation actions...
Running 'dotnet restore' on /home/myhome/test/test.csproj...
  Restoring packages for /home/myhome/test/test.csproj...
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error : Unable to load the service index for source https://api.nuget.org/v3/index.json. [/home/myhome/test/test.csproj]
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error :   The SSL connection could not be established, see inner exception. [/home/myhome/test/test.csproj]
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error :   The remote certificate is invalid according to the validation procedure. [/home/myhome/test/test.csproj]

Zum Lösen dieses Problems müssen Sie einige Umgebungsvariablen festlegen:

export SSL_CERT_FILE=[path-to-certificate-file]
export SSL_CERT_DIR=/dev/null

Der Speicherort des Zertifikats variiert je nach Distribution. Hier sind die Speicherorte für die Distributionen, auf denen das Problem beobachtet wurde:

Distribution Standort
Fedora /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem
OpenSUSE /etc/ssl/ca-bundle.pem
Solus /etc/ssl/certs/ca-certificates.crt

Zugehöriger Inhalt

  • Last updated on