Udostępnij za pośrednictwem

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

  • Artykuł

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:

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

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

  • .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

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:

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-9.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-9.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-9.0 w poprzednim poleceniu poleceniem :dotnet-runtime-9.0

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

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia 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:

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:

12.x

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

11.x

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

10.x

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

Inne notatki

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 , należy zainstalować bibliotekę libgdiplus . Aby uzyskać więcej informacji, zobacz System.Drawing.Common supported only on Windows (Obsługiwane tylko w systemie Windows).

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

Następne kroki