Megosztás a következőn keresztül:


A .NET SDK telepítése illesztéssel

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 snapdcí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.

  1. Nyisson meg egy terminált.

  2. A .NET SDK beépülő csomag telepítéséhez használható snap install . Az alábbi parancs például telepíti a latest/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 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

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.

  1. Nyissa meg /etc/wsl.conf a kívánt szövegszerkesztőben.

  2. Illessze be a következő konfigurációt:

    [boot]
    systemd=true
    
  3. 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:

  1. Győződjön meg arról, hogy a DOTNET_ROOT környezeti változót véglegesen exportálja.

  2. 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 restorehibaü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