Instalowanie zestawu .NET SDK lub środowiska uruchomieniowego platformy .NET w systemie Debian

W tym artykule opisano sposób instalowania platformy .NET w systemie Debian. Gdy wersja debiana nie jest obsługiwana, platforma .NET nie jest już obsługiwana w tej wersji. Jednak te instrukcje mogą pomóc w uruchomieniu platformy .NET w tych wersjach, mimo że nie jest obsługiwana.

Zainstaluj zestaw SDK (obejmujący środowisko uruchomieniowe), jeśli chcesz tworzyć aplikacje platformy .NET. Lub, jeśli potrzebujesz tylko uruchamiać aplikacje, zainstaluj środowisko uruchomieniowe. Jeśli instalujesz środowisko uruchomieniowe, zalecamy zainstalowanie środowiska uruchomieniowego ASP.NET Core, ponieważ obejmuje zarówno środowiska uruchomieniowe platformy .NET, jak i ASP.NET Core.

dotnet --list-sdks Użyj poleceń idotnet --list-runtimes, aby zobaczyć, które wersje są zainstalowane. Aby uzyskać więcej informacji, zobacz Jak sprawdzić, czy platforma .NET jest już zainstalowana.

Ważne

Używanie menedżera pakietów do instalowania platformy .NET z kanału informacyjnego pakietów firmy Microsoft obsługuje tylko architekturę x64. Inne architektury, takie jak Arm, nie są obsługiwane przez źródło danych pakietów firmy Microsoft.

Aby uzyskać więcej informacji na temat instalowania platformy .NET bez menedżera pakietów, zobacz jeden z następujących artykułów:

• Użyj skryptu, aby zainstalować platformę install-dotnet .NET.
• Ręcznie zainstaluj platformę .NET.

Obsługiwane dystrybucje

Poniższa tabela zawiera listę aktualnie obsługiwanych wersji platformy .NET i obsługiwanych wersji debiana. Wersje te pozostają obsługiwane, dopóki wersja platformy .NET nie osiągnie końca wsparcia lub wersja debiana osiągnie koniec życia.

Debian	.NET
12	9, 8, 6
11	8, 6

Ważne

Platforma .NET 9 jest obecnie dostępna w wersji zapoznawczej.

Następujące wersje platformy .NET nie są ❌ już obsługiwane:

• .NET 7
• .NET 6 (od 12 listopada 2024 r.)
• .NET 5
• .NET Core 3.1
• .NET Core 3.0
• .NET Core 2.2
• .NET Core 2.1
• .NET Core 2.0

Instalowanie wersji zapoznawczych

Wersje wersji zapoznawczej i wersji platformy .NET nie są dostępne w repozytoriach pakietów. Możesz zainstalować wersje zapoznawcze i kandydatów do wydania platformy .NET w jeden z następujących sposobów:

• Instalacja skryptowa z install-dotnet.sh
• Ręczne wyodrębnianie binarne

Usuwanie wersji zapoznawczych

W przypadku korzystania z menedżera pakietów do zarządzania instalacją platformy .NET może wystąpić konflikt, jeśli wcześniej zainstalowano wersję zapoznawcza. Menedżer pakietów może interpretować wydanie inne niż wersja zapoznawcza jako starszą wersję platformy .NET. Aby zainstalować wersję inną niż wersja zapoznawcza, najpierw odinstaluj wersje zapoznawcza. Aby uzyskać więcej informacji na temat odinstalowywania platformy .NET, zobacz Jak usunąć środowisko uruchomieniowe platformy .NET i zestaw SDK.

Debian 12

Instalowanie za pomocą narzędzia APT można wykonać za pomocą kilku poleceń. Przed zainstalowaniem platformy .NET uruchom następujące polecenia, aby dodać klucz podpisywania pakietów firmy Microsoft do listy zaufanych kluczy i dodać repozytorium pakietów.

Otwórz terminal i uruchom następujące polecenia:

wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalacja zestawu SDK

Zestaw .NET SDK umożliwia tworzenie aplikacji za pomocą platformy .NET. Jeśli zainstalujesz zestaw .NET SDK, nie musisz instalować odpowiedniego środowiska uruchomieniowego. Aby zainstalować zestaw .NET SDK, uruchom następujące polecenia:

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-8.0

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.

Instalowanie środowiska uruchomieniowego

Środowisko uruchomieniowe platformy ASP.NET Core umożliwia uruchamianie aplikacji wykonanych z platformą .NET, które nie udostępniały środowiska uruchomieniowego. Następujące polecenia instalują środowisko uruchomieniowe ASP.NET Core, które jest najbardziej zgodnym środowiskiem uruchomieniowym dla platformy .NET. W terminalu uruchom następujące polecenia:

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-8.0

Alternatywą dla środowiska uruchomieniowego platformy ASP.NET Core jest zainstalowanie środowiska uruchomieniowego platformy .NET, które nie obejmuje obsługi ASP.NET Core: zastąp aspnetcore-runtime-8.0 w poprzednim poleceniu poleceniem :dotnet-runtime-8.0

sudo apt-get install -y dotnet-runtime-8.0

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.

Debian 11

Instalowanie za pomocą narzędzia APT można wykonać za pomocą kilku poleceń. Przed zainstalowaniem platformy .NET uruchom następujące polecenia, aby dodać klucz podpisywania pakietów firmy Microsoft do listy zaufanych kluczy i dodać repozytorium pakietów.

Otwórz terminal i uruchom następujące polecenia:

wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalacja zestawu SDK

Zestaw .NET SDK umożliwia tworzenie aplikacji za pomocą platformy .NET. Jeśli zainstalujesz zestaw .NET SDK, nie musisz instalować odpowiedniego środowiska uruchomieniowego. Aby zainstalować zestaw .NET SDK, uruchom następujące polecenia:

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-8.0

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.

Instalowanie środowiska uruchomieniowego

Środowisko uruchomieniowe platformy ASP.NET Core umożliwia uruchamianie aplikacji wykonanych z platformą .NET, które nie udostępniały środowiska uruchomieniowego. Następujące polecenia instalują środowisko uruchomieniowe ASP.NET Core, które jest najbardziej zgodnym środowiskiem uruchomieniowym dla platformy .NET. W terminalu uruchom następujące polecenia:

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-8.0

Alternatywą dla środowiska uruchomieniowego platformy ASP.NET Core jest zainstalowanie środowiska uruchomieniowego platformy .NET, które nie obejmuje obsługi ASP.NET Core: zastąp aspnetcore-runtime-8.0 w poprzednim poleceniu poleceniem :dotnet-runtime-8.0

sudo apt-get install -y dotnet-runtime-8.0

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.

Debian 10

Instalowanie za pomocą narzędzia APT można wykonać za pomocą kilku poleceń. Przed zainstalowaniem platformy .NET uruchom następujące polecenia, aby dodać klucz podpisywania pakietów firmy Microsoft do listy zaufanych kluczy i dodać repozytorium pakietów.

Otwórz terminal i uruchom następujące polecenia:

wget https://packages.microsoft.com/config/debian/10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalacja zestawu SDK

Zestaw .NET SDK umożliwia tworzenie aplikacji za pomocą platformy .NET. Jeśli zainstalujesz zestaw .NET SDK, nie musisz instalować odpowiedniego środowiska uruchomieniowego. Aby zainstalować zestaw .NET SDK, uruchom następujące polecenia:

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-7.0

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.

Instalowanie środowiska uruchomieniowego

Środowisko uruchomieniowe platformy ASP.NET Core umożliwia uruchamianie aplikacji wykonanych z platformą .NET, które nie udostępniały środowiska uruchomieniowego. Następujące polecenia instalują środowisko uruchomieniowe ASP.NET Core, które jest najbardziej zgodnym środowiskiem uruchomieniowym dla platformy .NET. W terminalu uruchom następujące polecenia:

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-7.0

Alternatywą dla środowiska uruchomieniowego platformy ASP.NET Core jest zainstalowanie środowiska uruchomieniowego platformy .NET, które nie obejmuje obsługi ASP.NET Core: zastąp aspnetcore-runtime-7.0 w poprzednim poleceniu poleceniem :dotnet-runtime-7.0

sudo apt-get install -y dotnet-runtime-7.0

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.

Jak zainstalować inne wersje

Wszystkie wersje platformy .NET są dostępne do pobrania na https://dotnet.microsoft.com/download/dotnetstronie , ale wymagają ręcznej instalacji. Możesz spróbować użyć menedżera pakietów, aby zainstalować inną wersję platformy .NET. Jednak żądana wersja może nie być dostępna.

Pakiety dodane do kanałów informacyjnych menedżera pakietów mają nazwę w formacie hackable, na przykład: {product}-{type}-{version}.

• produkt
  Typ produktu .NET do zainstalowania. Prawidłowe opcje to:

  • dotnet
  • aspnetcore

• type
  Wybiera zestaw SDK lub środowisko uruchomieniowe. Prawidłowe opcje to:

  • sdk (dostępne tylko dla produktu dotnet )
  • runtime

• version
  Wersja zestawu SDK lub środowiska uruchomieniowego do zainstalowania. Prawidłowe opcje to dowolna wydana wersja, taka jak:

  • 8.0
  • 6.0
  • 3.1
  • 2.1

  Możliwe, że zestaw SDK/środowisko uruchomieniowe, które próbujesz pobrać, nie jest dostępne dla dystrybucji systemu Linux. Aby uzyskać listę obsługiwanych dystrybucji, zobacz Instalowanie platformy .NET w systemie Linux.

Przykłady

• Zainstaluj środowisko uruchomieniowe ASP.NET Core 8.0: aspnetcore-runtime-8.0
• Zainstaluj środowisko uruchomieniowe platformy .NET Core 2.1: dotnet-runtime-2.1
• Zainstaluj zestaw .NET 5 SDK: dotnet-sdk-5.0
• Zainstaluj zestaw .NET Core 3.1 SDK: dotnet-sdk-3.1

Uwaga

Niektóre pakiety mogą nie być dostępne w dystrybucji systemu Linux.

Brak pakietu

Jeśli kombinacja wersji pakietu nie działa, nie jest dostępna. Na przykład nie ma zestawu ASP.NET Core SDK. Składniki zestawu SDK dla platformy ASP.NET Core są dołączone do zestawu .NET SDK. Wartość aspnetcore-sdk-8.0 jest nieprawidłowa i powinna mieć wartość dotnet-sdk-8.0. Aby uzyskać listę dystrybucji systemu Linux obsługiwanych przez platformę .NET, zobacz .NET dependencies and requirements (Zależności i wymagania dotyczące platformy .NET).

Aktualizowanie platformy .NET przy użyciu narzędzia APT

Gdy dla platformy .NET jest dostępna nowa wersja poprawki, możesz po prostu uaktualnić ją za pomocą narzędzia APT za pomocą następujących poleceń:

sudo apt-get update
sudo apt-get upgrade

Jeśli dystrybucja systemu Linux została uaktualniona od momentu zainstalowania platformy .NET, może być konieczne ponowne skonfigurowanie repozytorium pakietów firmy Microsoft. Uruchom instrukcje instalacji dla bieżącej wersji dystrybucji, aby uaktualnić do odpowiedniego repozytorium pakietów dla aktualizacji platformy .NET.

Rozwiązywanie problemów

Ta sekcja zawiera informacje na temat typowych błędów, które mogą wystąpić podczas używania narzędzia APT do zainstalowania platformy .NET.

Nie można odnaleźć pakietu

Ważne

Używanie menedżera pakietów do instalowania platformy .NET z kanału informacyjnego pakietów firmy Microsoft obsługuje tylko architekturę x64. Inne architektury, takie jak Arm, nie są obsługiwane przez źródło danych pakietów firmy Microsoft.

Aby uzyskać więcej informacji na temat instalowania platformy .NET bez menedżera pakietów, zobacz jeden z następujących artykułów:

• Użyj skryptu, aby zainstalować platformę install-dotnet .NET.
• Ręcznie zainstaluj platformę .NET.

Nie można zlokalizować \ Nie można zainstalować niektórych pakietów

Jeśli zostanie wyświetlony komunikat o błędzie podobny do Nie można zlokalizować pakietu {dotnet-package} lub nie można zainstalować niektórych pakietów, uruchom następujące polecenia.

W poniższym zestawie poleceń znajdują się dwa symbole zastępcze.

• {dotnet-package}
  Reprezentuje instalowany pakiet .NET, na przykład aspnetcore-runtime-8.0. Jest to używane w poniższym sudo apt-get install poleceniu.

Najpierw spróbuj przeczyścić listę pakietów:

sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update

Następnie spróbuj ponownie zainstalować platformę .NET. Jeśli to nie zadziała, możesz uruchomić ręczną instalację przy użyciu następujących poleceń:

Jeśli używasz systemu Debian 12 lub nowszego, spróbuj wykonać następujące polecenia:

# Get OS version info which adds the $ID and $VERSION_ID variables
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Move the key to the appropriate place
sudo mv microsoft.asc.gpg $(cat /etc/apt/sources.list.d/microsoft-prod.list | grep -oP "(?<=signed-by=).*(?=\])")

# Update packages and install .NET
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Jeśli używasz wersji debiana wcześniejszej niż 12, spróbuj wykonać następujące polecenia:

# Define the OS version, name, and codename
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Set ownership
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list

# Update packages and install .NET
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Nie można pobrać

Podczas instalowania pakietu .NET może zostać wyświetlony błąd podobny do Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Ten błąd może oznaczać, że kanał informacyjny pakietu dla platformy .NET jest uaktualniany przy użyciu nowszych wersji pakietów i należy ponowić próbę później. Podczas uaktualniania kanał informacyjny pakietu nie powinien być niedostępny przez ponad 30 minut. Jeśli ten błąd jest stale wyświetlany przez ponad 30 minut, zgłoś problem pod adresem https://github.com/dotnet/core/issues.

Zależności

Podczas instalowania za pomocą menedżera pakietów te biblioteki są instalowane. Jeśli jednak ręcznie zainstalujesz platformę .NET lub opublikujesz aplikację samodzielną, musisz upewnić się, że te biblioteki są zainstalowane:

10.x

• libc6
• libgcc1
• libgssapi-krb5-2
• libicu63
• libssl1.1
• libstdc++6
• zlib1g

11.x

• libc6
• libgcc-s1
• libgssapi-krb5-2
• libicu67
• libssl1.1
• libstdc++6
• zlib1g

12.x

• libc6
• libgcc-s1
• libgssapi-krb5-2
• libicu72
• libssl3
• libstdc++6
• zlib1g

Zależności można zainstalować za apt install pomocą polecenia . Poniższy fragment kodu przedstawia instalowanie libc6 biblioteki:

sudo apt install libc6

Jeśli aplikacja .NET używa zestawu System.Drawing.Common , konieczne będzie również zainstalowanie biblioteki libgdiplus. Ponieważ system.Drawing.Common nie jest już obsługiwany w systemie Linux, działa to tylko na platformie .NET 6 i wymaga ustawienia przełącznika System.Drawing.EnableUnixSupport konfiguracji środowiska uruchomieniowego.

Najnowszą wersję biblioteki libgdiplus można zainstalować, dodając repozytorium Mono do systemu.

Następne kroki

• Omówienie interfejsu wiersza polecenia platformy .NET
• Jak włączyć uzupełnianie tabulatorów dla interfejsu wiersza polecenia platformy .NET
• Samouczek: tworzenie aplikacji konsolowej przy użyciu zestawu .NET SDK przy użyciu programu Visual Studio Code