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:
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 | 8, 7, 6 |
| 11 | 8, 7, 6 |
| 10 | 7, 6 |
Następujące wersje platformy .NET nie są ❌ już obsługiwane:
- .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-8.0
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
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
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
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
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
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}.
Produktu
Typ produktu .NET do zainstalowania. Prawidłowe opcje to:dotnetaspnetcore
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.06.03.12.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:
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ładaspnetcore-runtime-8.0. Jest to używane w poniższymsudo apt-get installpoleceniu.
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:
# 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
# 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:
- libc6
- libgcc1 (dla 10.x)
- libgcc-s1 (dla 11.x i 12.x)
- libgssapi-krb5-2
- libicu63 (dla 10.x)
- libicu67 (dla 11.x)
- libicu72 (dla 12.x)
- libssl1.1
- 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
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla