Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Ez a cikk a .NET SDK beépülő csomag telepítését ismerteti. A .NET SDK beépülő csomagokat a Canonical biztosítja és tartja karban. A snapek nagyszerű alternatívát jelentenek a Linux-disztribúcióba beépített csomagkezelő helyett.
A beépülő modul egy alkalmazás csomagja és annak függőségei, amelyek számos különböző Linux-disztribúcióban működnek. A dokkolások felderíthetők és telepíthetők a Snap Store-ból. A Snap szolgáltatással kapcsolatos további információkért tekintse meg a rövid útmutatót.
Figyelemfelhívás
A .NET illesztési telepítéseinél problémák léphetnek fel a .NET-eszközök futtatása közben. Ha .NET-eszközöket szeretne használni, javasoljuk, hogy telepítse a .NET-et az dotnet-install
adott Linux-disztribúció szkriptjével vagy csomagkezelőjével.
Ismert probléma, hogy a parancs nem működik, ha a dotnet watch
.NET beépülő modulon keresztül van telepítve.
Ha .NET-eszközöket vagy parancsot dotnet watch
szeretne használni, javasoljuk, hogy telepítse a .NET-et a dotnet-install
szkripttel.
Előfeltételek
- A beépülő modult támogató Linux-disztribúció.
snapd
a snap démon.
Előfordulhat, hogy a Linux-disztribúció már tartalmazza a beépülő modult. snap
Futtassa a terminált, és ellenőrizze, hogy működik-e a parancs. A támogatott Linux-disztribúciók listáját és a beépülő modul telepítésével kapcsolatos utasításokat a Telepítés snapd
című témakörben találja.
.NET-kiadások
A Microsoft a .NET-et két különböző támogatási szabályzat, a hosszú távú támogatás (LTS) és a standard távú támogatás (STS) keretében teszi közzé. Az összes kiadás minősége ugyanaz. Az egyetlen különbség a támogatás hossza. Az LTS-kiadások három évig ingyenes támogatást és javításokat kapnak. Az STS-kiadások 18 hónapig ingyenes támogatást és javításokat kapnak. További információt a .NET támogatási szabályzatában talál.
A Microsoft által jelenleg támogatott .NET-verziók a következők:
- 9.0 (STS)– A támogatás 2026 májusában ér véget.
- 8.0 (LTS)– A támogatás 2026. november 10-ig tart.
A .NET-et buildelő és kiadási entitások más támogatási szabályzatokat is bevezethetnek. Mindenképpen kérdezze meg őket, hogy a .NET hogyan támogatott.
1. Az SDK telepítése
Fontos
A .NET 9 2024. november 12-én jelent meg. Időbe telhet, mire a csomagok megjelennek a csomagkezelő hírcsatornáiban, vagy az adott Linux-disztribúció belefoglalja.
A .NET SDK illesztési csomagjai mind ugyanabban az azonosítóban vannak közzétéve: dotnet-sdk
. Az SDK egy adott verziója telepíthető a csatorna megadásával. Az SDK tartalmazza az SDK-ra verziózott ASP.NET Core és .NET futtatókörnyezetet is.
Tipp.
A Snapcraft .NET SDK csomagoldala terjesztési specifikus utasításokat tartalmaz a Snapcraft és a .NET telepítéséhez.
Nyisson meg egy terminált.
A .NET SDK beépülő csomag telepítéséhez használható
snap install
. Az alábbi parancs például telepíti alatest/stable
csatornát, amely az alapértelmezett.sudo snap install dotnet-sdk --classic
- A(z)
--classic
paramétert kötelező megadni. - A paraméter használatával
--channel
adja meg, hogy melyik verziót telepítse. Ha ez a paraméter nincs megadva,latest/stable
akkor a rendszer használja. Telepíti például a--channel 8.0/stable
.NET SDK 8.0-t.
- A(z)
A dotnet
snap alias automatikusan létrejön, és megfeleltetve lesz a snap csomag parancsához dotnet
.
Az alábbi táblázat a telepíthető csomagcsatornák listáját tartalmazza:
.NET-verzió | Csomagcsatorna illesztés |
---|---|
9 (STS) | *Még nem érhető el |
8 (LTS) | 8.0/stable lts/stable |
7 (STS) | 7.0/stable (nem támogatott) |
6 (LTS) | 6.0/stable (nem támogatott) |
5 | 5.0/stable (nem támogatott) |
3.1 | 3.1/stable (nem támogatott) |
2.1 | 2.1/stable (nem támogatott) |
2. A telepítési hely exportálása
A DOTNET_ROOT
környezeti változót gyakran használják az eszközök annak meghatározására, hogy hol van telepítve a .NET. Ha a .NET beépülő modulon keresztül van telepítve, ez a környezeti változó nincs konfigurálva. Konfigurálja a DOTNET_ROOT környezeti változót a profiljában. A illesztés elérési útja a következő formátumot használja: /snap/{package}/current
.
export DOTNET_ROOT=/snap/dotnet-sdk/current
A környezeti változó végleges exportálása
Az előző export
parancs csak arra a terminál munkamenetre állítja be a környezeti változót, amelyben futtatták.
A parancsok végleges hozzáadásához szerkesztheti a rendszerhéjprofilt. Linux rendszeren számos különböző rendszerhéj érhető el, és mindegyik más profillal rendelkezik. Példa:
- Bash Shell: ~/.bash_profile, ~/.bashrc
- Korn Shell: ~/.kshrc vagy .profile
- Z Shell: _~/.zshrc* vagy .zprofile
Szerkessze a megfelelő forrásfájlt a rendszerhéjhoz, és adja hozzá export DOTNET_ROOT=/snap/dotnet-sdk/current
.
3. A .NET parancssori felület használata
Nyisson meg egy terminált, és írja be a kívánt elemet dotnet
.
dotnet
A következő kimenet jelenik meg:
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.
A .NET CLI használatának megismeréséhez tekintse meg a .NET CLI áttekintését.
Hibaelhárítás
- A dotnet terminálparancs nem működik
- Nem telepíthető a Snap on WSL2
- A dotnet parancs vagy az SDK nem oldható fel
- TLS-/SSL-tanúsítványhibák
A dotnet terminálparancs nem működik
A snap-csomagok egy aliast a csomag által biztosított parancsra képezhetnek le. A .NET SDK beépülő csomagok alapértelmezés szerint létrehoznak egy aliast a dotnet
parancshoz. Ha az alias nem lett létrehozva vagy korábban el lett távolítva, az alábbi parancs bemutatja, hogyan képezheti le az aliast:
sudo snap alias dotnet-sdk.dotnet dotnet
Nem telepíthető a Snap on WSL2
systemd
A Beépülő modul telepítése előtt engedélyezni kell a WSL2-példányon.
Nyissa meg
/etc/wsl.conf
a kívánt szövegszerkesztőben.Illessze be a következő konfigurációt:
[boot] systemd=true
Mentse a fájlt, és indítsa újra a WSL2-példányt a PowerShell használatával. Használja az
wsl.exe --shutdown
parancsot.
A dotnet parancs vagy az SDK nem oldható fel
Más alkalmazások, például a code IDE vagy a Visual Studio Code bővítményei esetében gyakori, hogy megpróbálják feloldani a .NET SDK helyét. A felderítés általában a DOTNET_ROOT
környezeti változó ellenőrzésével vagy a dotnet
végrehajtható fájl helyére való kitalálással történik. A beépülő modullal telepített .NET SDK összezavarhatja ezeket az alkalmazásokat. Ha ezek az alkalmazások nem tudják megoldani a .NET SDK-t, a következő üzenetek egyikéhez hasonló hibaüzenet jelenik meg:
- A megadott "Microsoft.NET.Sdk" SDK nem található
- A megadott "Microsoft.NET.Sdk.Web" SDK nem található
- A megadott "Microsoft.NET.Sdk.Razor" SDK nem található
A probléma megoldásához próbálkozzon az alábbi lépésekkel:
Győződjön meg arról, hogy a
DOTNET_ROOT
környezeti változót véglegesen exportálja.Próbálja meg szimbolikusan összekapcsolni a illesztő
dotnet
végrehajtható fájlokat a program által keresett helyre.A parancs két gyakori elérési útját
dotnet
keresi:/usr/local/bin/dotnet
/usr/share/dotnet
A következő paranccsal hozzon létre egy szimbolikus hivatkozást a illesztési csomagra:
ln -s /snap/dotnet-sdk/current/dotnet /usr/local/bin/dotnet
TLS-/SSL-tanúsítványhibák
Ha a .NET beépülő modulon keresztül van telepítve, előfordulhat, hogy egyes disztribúciókban a .NET TLS/SSL-tanúsítványok nem találhatók, és a következő időszakban restore
hibaüzenet jelenhet meg:
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]
A probléma megoldásához állítson be néhány környezeti változót:
export SSL_CERT_FILE=[path-to-certificate-file]
export SSL_CERT_DIR=/dev/null
A tanúsítvány helye elosztás szerint változik. Az alábbiakban azoknak a disztribúcióknak a helyei találhatók, ahol a problémát észlelték:
Disztribúció | Hely |
---|---|
Fedora | /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem |
OpenSUSE | /etc/ssl/ca-bundle.pem |
Solus | /etc/ssl/certs/ca-certificates.crt |