A .NET áttekintése az Ubuntu-on

Ez a cikk bemutatja, hogyan telepíthető a .NET az Ubuntu-on. Az Ubuntu 22.04-től kezdve a .NET legtöbb támogatott verziója elérhető a beépített Ubuntu-hírcsatornában. Az Ubuntu .NET backports csomagtárház a többi támogatott .NET-verziót tartalmazza. Az elérhető verziókról további információt a Támogatott disztribúciók című szakaszban talál.

A Canonical átvette a .NET közzétételét az Ubuntu-on. Az Ubuntu 22.04-től kezdve a Microsoft már nem terjeszti a .NET for Ubuntu-t a Microsoft csomagtárházába.

Az Ubuntu frissítésekor megfontolandó szempontok

Az Ubuntu frissítése 22.04-re vagy újabbra? Először fontolja meg a .NET eltávolítását.

Ha csomagkezelővel telepítette a .NET-et a Microsoft csomagtárából, az Ubuntu frissítése után csomagkeveréssel kapcsolatos probléma merül fel. Most, hogy a Canonical közzéteszi a .NET-et az Ubuntu 22.04 (és újabb verziók) csomagcsatornáiban, a csomagkezelő nem fog tudni a korábban telepített .NET-verzióról. A csomagok nem frissíthetők a legújabb .NET-re. Először távolítsa el őket, majd telepítse újra őket az [Ubuntu csomag adattárából].

Döntse el, hogyan telepítse a .NET-et

Ha az Ubuntu verziója támogatja a .NET-et a beépített vagy a .NET-háttérportok Ubuntu-csatornáján keresztül, a .NET-buildek támogatását a Canonical biztosítja, és a buildek különböző számítási feladatokhoz optimalizálhatók. A Microsoft támogatást nyújt a Microsoft csomagtár-hírcsatornájában lévő csomagokhoz.

A .NET telepítésének módját az alábbi szakaszokban találja:

• Az Ubuntu 22.04-et vagy újabb verziót használom, és csak .NET-ra van szükségem
• Az Ubuntu 22.04 előtti verzióját használom
• Más Microsoft-csomagokat használok, például powershell, mdatpvagy mssql
• .NET-alkalmazást szeretnék létrehozni
• .NET-alkalmazást szeretnék futtatni egy tárolóban, felhőben vagy folyamatos integrációs forgatókönyvben
• Az Ubuntu-disztribúció nem tartalmazza a kívánt .NET-verziót, vagy nem támogatott .NET-verzióra van szükségem
• Egy előzetes verziót szeretnék telepíteni
• Nem akarom használni az APT-t
• Arm-alapú CPU-t használok
• Az IBM System Z platformot használom

Az Ubuntu 22.04-et vagy újabb verziót használom, és csak .NET-ra van szükségem

Telepítse a .NET-et az Ubuntu-csatornán keresztül. További információkért tekintse meg a következő oldalakat:

• Telepítse a .NET-et az Ubuntu 24.10-en.
• Telepítse a .NET-et az Ubuntu 24.04-en.
• Telepítse a .NET-et az Ubuntu 22.04-en.

Ha a Microsoft-adattárat más Microsoft-csomagok ( például powershell, mdatpvagy mssql) használatára szeretné telepíteni, akkor deprioritizálnia kell a Microsoft-adattár által biztosított .NET-csomagokat. A csomagok deprioritizálásával kapcsolatos utasításokért lásd : A Linux-disztribúció .NET-csomagokat biztosít, és használni szeretném őket.

Az Ubuntu 22.04 előtti verzióját használom

Használja a verzióspecifikus Ubuntu oldalon található utasításokat.

• 20.04 (LTS)

A támogatott disztribúciók szakaszban további információt talál arról, hogy a .NET mely verziói támogatottak az Ubuntu verziójához. Ha nem támogatott verziót telepít, olvassa el a Microsoft-csomagtár regisztrálása című témakört.

Más Microsoft-csomagokat használok, például powershell, mdatpvagy mssql

Ha az Ubuntu-verzió egy Ubuntu-hírcsatornán keresztül támogatja a .NET-et, el kell döntenie, hogy melyik hírcsatorna telepítse a .NET-et. A Támogatott disztribúciók szakasz egy táblázatot tartalmaz, amely felsorolja, hogy a .NET mely verziói érhetők el a csomagcsatornákban.

Ha a .NET-csomagokat egy Ubuntu-hírcsatornából szeretné beszerezni, deprioritizálnia kell a Microsoft-adattár által biztosított .NET-csomagokat. A csomagok deprioritizálásával kapcsolatos utasításokért lásd : A Linux-disztribúció .NET-csomagokat biztosít, és használni szeretném őket.

.NET-alkalmazást szeretnék létrehozni

Használja ugyanazokat a csomagforrásokat az SDK-hoz, mint a futtatókörnyezethez. Javasoljuk, hogy telepítse a .NET-et egy Ubuntu-csatornán keresztül. Ha azonban más forrásból szeretné telepíteni a .NET-et (például a Microsoft csomagtárát a magasabb SDK-szolgáltatási sávok eléréséhez), távolítsa el a .NET-et, konfigurálja a csomagkezelőt úgy, hogy figyelmen kívül hagyja az Ubuntu-hírcsatornából származó .NET-csomagokat, és telepítse újra a másik forrásból.

Tekintse át a .NET telepítésének eldöntése szakaszban található további javaslatokat.

.NET-alkalmazást szeretnék futtatni egy tárolóban, felhőben vagy folyamatos integrációs forgatókönyvben

Ha az Ubuntu-verzió biztosítja a szükséges .NET-verziót, telepítse egy Ubuntu-hírcsatornából. Ellenkező esetben regisztrálja a Microsoft csomagtárházát, és telepítse a .NET-et az adattárból. Tekintse át a Támogatott disztribúciók szakaszban található információkat.

Ha a kívánt .NET-verzió nem érhető el, próbálkozzon a dotnet-install szkripttel.

Az Ubuntu-disztribúció nem tartalmazza a kívánt .NET-verziót, vagy nem támogatott .NET-verzióra van szükségem

Javasoljuk, hogy használja az APT-t és a Microsoft-csomagtárat. További információ: Regisztrálás és telepítés a Microsoft-csomagtárban .

Egy előzetes verziót szeretnék telepíteni

A .NET telepítéséhez használja az alábbi módszerek egyikét:

• Telepítse a .NET-et szkripttel install-dotnet .
• A .NET manuális telepítése

Nem akarom használni az APT-t

Ha automatizált telepítést szeretne, használja a Linux telepítési szkriptet.

Ha teljes mértékben szabályozni szeretné a .NET telepítési felületét, töltse le a tarballt, és telepítse manuálisan a .NET-et. További információ: Manuális telepítés.

Arm-alapú CPU-t használok

Ha az Ubuntu-verzió biztosítja a szükséges .NET-verziót, telepítse a beépített hírcsatornából. Tekintse át a Támogatott disztribúciók szakaszban található információkat.

Ha a kívánt .NET-verzió nem érhető el, próbálkozzon a .NET telepítésének alábbi módjai egyikével:

• Telepítse a .NET-et szkripttel install-dotnet .
• A .NET manuális telepítése

Az IBM System Z platformot használom

A .NET 8-tól kezdve az Ubuntu 24.04-en a Canonical támogatja a .NET-et az IBM System Z platformhoz. A Canonical a támogatást más .NET- és Ubuntu-verziókra is kiterjeszti.

Telepítse a .NET-et a beépített Ubuntu-csatornán keresztül. További információkért tekintse meg a következő oldalt:

• Telepítse a .NET 9-et az Ubuntu 24.10-en.

Támogatott disztribúciók

Az alábbi táblázat a jelenleg támogatott .NET-kiadások és az Ubuntu azon verzióinak listáját tartalmazza, amelyen támogatottak. Minden hivatkozás az adott Ubuntu verziólapra kerül, és konkrét útmutatást tartalmaz az Ubuntu adott verziójához tartozó .NET telepítésére vonatkozóan.

Amikor egy Ubuntu-verzió eléri a támogatási időszak végét, a .NET már nem támogatott az adott Ubuntu-verzióval.

A Canonical támogatja a .NET-verziókat a beépített Ubuntu-hírcsatornában az adott Ubuntu-verzió teljes élettartama alatt, még a Microsoft által biztosított támogatási élettartamon túl is, és a .NET backports csomag adattárában található .NET-verziók maximális támogatását biztosítja, amely nem hosszabb a Microsoft által biztosított támogatási élettartamnál.

A .NET következő verziói már nem támogatottak ❌ :

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

Ubuntu .NET-háttérjelentések csomagtárháza

Az Ubuntu .NET backports csomagtárház a .NET olyan verzióit biztosítja, amelyek nem érhetők el a beépített Ubuntu-hírcsatornában. A Támogatott disztribúciók szakasz egy táblázatot tartalmaz, amely felsorolja, hogy a .NET mely verziói érhetők el a csomagcsatornában. A Canonical fenntartja az ebben a csomagtárban található csomagokat, és minden tőle telhetőt megtesz, ami nem terjed ki a Microsoft által biztosított támogatási időtartamon vagy az adott Ubuntu-verzió támogatási időszakán.

További részletekért tekintse meg az Ubuntu .NET backports csomagtárház webes nézetét.

Az Ubuntu .NET backports csomag adattárának regisztrálása

Nyisson meg egy terminált, és futtassa a következő parancsot:

sudo add-apt-repository ppa:dotnet/backports

Az Ubuntu .NET backports csomagtárház regisztrációjának törlése

Ha már nem szeretne csomagokat használni az Ubuntu .NET backports csomagtárából, törölheti a regisztrációt. Nyisson meg egy terminált, és futtassa a következő parancsot:

sudo add-apt-repository --remove ppa:dotnet/backports

az add-apt-repository parancs nem található

A add-apt-repository(1) segédprogram a legtöbb Ubuntu-telepítésen előre telepítve van.

Ha hibaüzenetet kap arról, hogy a add-apt-repository parancs nem található, telepítenie kell a csomagot, amely ezt a software-properties-common parancsot biztosítja. Nyisson meg egy terminált, és futtassa a következő parancsokat:

sudo apt update
sudo apt install software-properties-common

A Microsoft-csomag adattárának regisztrálása

A Microsoft csomagtárház a .NET összes olyan verzióját tartalmazza, amely korábban vagy jelenleg is támogatott az Ubuntu verziójában. Ha az Ubuntu verziója .NET-csomagokat biztosít, deprioritizálnia kell az Ubuntu-csomagokat, és használnia kell a Microsoft-adattárat. A csomagok deprioritizálásával kapcsolatos utasításokért lásd : Szükségem van a .NET olyan verziójára, amelyet nem a Linux-disztribúcióm biztosít.

Az előzetes verziók nem érhetők el a Microsoft-csomagtárházban. További információ: Előzetes verzió telepítése.

Az APT-vel való telepítés néhány paranccsal elvégezhető. A .NET telepítése előtt futtassa az alábbi parancsokat a Microsoft-csomagaláíró kulcs megbízható kulcsok listájához való hozzáadásához és a csomagadattár hozzáadásához.

Nyisson meg egy terminált, és futtassa a következő parancsokat:

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

# Download Microsoft signing key and repository
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

# Install Microsoft signing key and repository
sudo dpkg -i packages-microsoft-prod.deb

# Clean up
rm packages-microsoft-prod.deb

# Update packages
sudo apt update

A .NET telepítése

Telepítse a .NET-et a csomagkezelőn keresztül a sudo apt install <package-name> paranccsal. Cserélje le <package-name> a telepíteni kívánt .NET-csomag nevére. A .NET SDK 9.0 telepítéséhez például használja a parancsot sudo apt install dotnet-sdk-9.0. Az alábbi táblázat a jelenleg támogatott .NET-csomagokat sorolja fel (amelyek az Ubuntu-verziótól függően változhatnak):

Egyes környezeti változók befolyásolják a .NET futtatását a telepítés után. További információ: .NET SDK és CLI környezeti változók.

A .NET eltávolítása

Ha a .NET-et egy csomagkezelőn keresztül telepítette, távolítsa el ugyanúgy a apt-get remove parancsot:

sudo apt-get remove dotnet-sdk-6.0

További információt a .NET eltávolítása című témakörben talál.

Előzetes verzió telepítése

A .NET előzetes verziójú és kiadásra jelölt verziói nem érhetők el a csomagtárakban. A .NET előzetes verzióit és jelöltjeit az alábbi módokon telepítheti:

• Parancsfájlok telepítése install-dotnet.sh
• Manuális bináris extrakció

Előzetes verzió eltávolítása

Ha csomagkezelőt használ a .NET telepítésének kezeléséhez, ütközés léphet fel, ha korábban telepített egy előzetes kiadást. A csomagkezelő a nem előzetes verziójú kiadást a .NET korábbi verziójaként értelmezheti. A nem előzetes verzió telepítéséhez először távolítsa el az előzetes verziókat. A .NET eltávolításáról további információt a .NET-futtatókörnyezet és az SDK eltávolítása című témakörben talál.

A .NET frissítése az APT használatával

Ha a .NET-et egy csomagkezelőn keresztül telepítette, frissítheti a csomagot a apt upgrade paranccsal. A következő parancsok például a legújabb verzióval frissítik a dotnet-sdk-9.0 csomagot:

sudo apt update
sudo apt upgrade dotnet-sdk-9.0

Hibaelhárítás

Az Ubuntu 22.04-től kezdve előfordulhat, hogy olyan helyzetbe kerül, amikor úgy tűnik, hogy csak egy darab .NET érhető el. Telepítette például a futtatókörnyezetet és az SDK-t, de a futtatáskor dotnet --info csak a futtatókörnyezet szerepel a listában. Ez a helyzet két különböző csomagforrás használatával függhet össze. A beépített Ubuntu 22.04 és Ubuntu 22.10 csomagcsatornák tartalmazzák a .NET egyes verzióit, de nem mindegyiket, és előfordulhat, hogy a Microsoft-hírcsatornákról is telepítette a .NET-et. A probléma megoldásáról további információt a Linuxon hiányzó fájlokhoz kapcsolódó .NET-hibák elhárítása című témakörben talál.

APT-problémák

Ez a szakasz a .NET telepítése során előforduló gyakori hibákról nyújt tájékoztatást.

Nem található csomag

A .NET csomagkezelő nélküli telepítésével kapcsolatos további információkért tekintse meg az alábbi cikkek egyikét:

• A .NET telepítéséhez használja a install-dotnet szkriptet.
• A .NET manuális telepítése.

Nem található \ Egyes csomagok nem telepíthetők

Ha a (z) {dotnet-package} csomag nem található, vagy egyes csomagok nem telepíthetők, futtassa a következő parancsokat.

A következő parancskészletben két helyőrző található.

• {dotnet-package}
  Ez a telepített .NET-csomagot jelöli, például aspnetcore-runtime-8.0. Ezt a következő sudo apt-get install parancs használja.

Először próbálja meg kiüríteni a csomaglistát:

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

Ezután próbálja meg újra telepíteni a .NET-et. Ha ez nem működik, a manuális telepítést a következő parancsokkal futtathatja:

Ha az Ubuntu 23.10-et vagy újabb verziót használja, próbálkozzon a következő parancsokkal:

# 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}

Ha Ubuntu-verziót használ a 23.10-es verzió előtt, próbálkozzon a következő parancsokkal:

# 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}

Nem sikerült beolvasni

A .NET-csomag telepítésekor a következőhöz Failed to fetch ... File has unexpected size ... Mirror sync in progress?hasonló hibaüzenet jelenhet meg. Ez a hiba azt jelentheti, hogy a .NET csomagcsatornája újabb csomagverziókkal frissül, és később újra kell próbálkoznia. A frissítés során a csomagcsatorna nem lehet 30 percnél hosszabb ideig elérhetetlen. Ha a hiba 30 percnél hosszabb ideig folyamatosan jelentkezik, küldjön egy hibát a következő címen https://github.com/dotnet/core/issues: .

Függőségek

Ha csomagkezelővel telepíti a telepítendő kódtárakat, ezek a kódtárak telepítve lesznek Önnek. Ha azonban manuálisan telepíti a .NET-et, vagy önkiszolgáló alkalmazást tesz közzé, az alkalmazás futtatásához telepítenie kell ezeket a függőségeket:

• ca-certificates
• libc6
• libgcc1 (16.x és 18.x esetén)
• libgcc-s1 (20.x vagy újabb verzióhoz)
• libgssapi-krb5-2
• libicu55 (16.x-hez)
• libicu60 (18.x-hez)
• libicu66 (20.x-hez)
• libicu70 (22.04-hez)
• libicu72 (23.10-hez)
• libicu74 (24.04 vagy újabb verzióhoz)
• liblttng-ust1 (22.x vagy újabb verzióhoz)
• libssl1.0.0 (16.x esetén)
• libssl1.1 (18.x, 20.x esetén)
• libssl3 (22.x vagy újabb verzió esetén)
• libstdc++6
• libunwind8 (22.x vagy újabb verzió esetén)
• zlib1g

A függőségek a paranccsal telepíthetők apt install . Az alábbi kódrészlet a zlib1g kódtár telepítését mutatja be:

sudo apt install zlib1g

Ha a .NET-alkalmazás a System.Drawing.Common szerelvényt használja, a libgdiplust telepíteni kell. További információ: System.Drawing.Common csak Windows rendszeren támogatott.

A libgdiplus legújabb verzióját úgy telepítheti, hogy hozzáadja a Mono-adattárat a rendszerhez.

Következő lépések

• A .NET CLI áttekintése
• A tabulátor befejezésének engedélyezése a .NET parancssori felületéhez
• Oktatóanyag: Konzolalkalmazás létrehozása a .NET SDK-val a Visual Studio Code használatával