A .NET telepítése Linuxra telepítési szkripttel vagy bináris fájlok kinyerésével

Ez a cikk bemutatja, hogyan telepítheti a .NET SDK-t vagy a .NET-futtatókörnyezetet Linuxon a telepítési szkript használatával vagy a bináris fájlok kinyerésével. A beépített csomagkezelőt támogató disztribúciók listáját a .NET linuxos telepítése című témakörben találja.

Ha .NET-alkalmazásokat szeretne fejleszteni, telepítse az SDK-t (amely tartalmazza a futtatókörnyezetet is). Vagy ha csak alkalmazásokat kell futtatnia, telepítse a futtatókörnyezetet. Ha telepíti a futtatókörnyezetet, javasoljuk, hogy telepítse a ASP.NET Core-futtatókörnyezetet , mivel az tartalmazza a .NET és ASP.NET Core futtatókörnyezeteket is.

dotnet --list-sdksdotnet --list-runtimes A parancsokkal megtekintheti, hogy mely verziók vannak telepítve. További információ: Hogyan ellenőrizheti, hogy a .NET már telepítve van-e.

.NET-kiadások

A támogatott kiadásoknak két típusa van: a hosszú távú támogatás (LTS) vagy a standard távú támogatás (STS). Az összes kiadás minősége ugyanaz. Az egyetlen különbség a támogatás hossza. Az LTS-kiadások 3 é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.

Az alábbi táblázat a .NET (és a .NET Core) egyes verzióinak támogatási állapotát sorolja fel:

✔️ Támogatott ❌ Támogatott
8 (LTS) 5
7 (STS) 3.1
6 (LTS) 3,0
2,2
2.1
2,0
1,1
1,0

Függőségek

Előfordulhat, hogy a .NET telepítésekor bizonyos függőségek nem lesznek telepítve, például manuálisan történő telepítéskor. Az alábbi lista a Microsoft által támogatott és esetleg telepíteni kívánt függőségekkel rendelkező Linux-disztribúciókat ismerteti. További információkért tekintse meg a terjesztési oldalt:

A függőségekkel kapcsolatos általános információkért lásd az önálló Linux-alkalmazásokat.

RPM-függőségek

Ha a disztribúció korábban nem volt felsorolva, és RPM-alapú, a következő függőségekre lehet szüksége:

  • krb5-libs
  • libicu
  • openssl-libs

Ha a cél futtatókörnyezet OpenSSL-verziója 1.1-es vagy újabb, telepítse compat-openssl10.

DEB-függőségek

Ha a disztribúció korábban nem szerepel a listán, és debian-alapú, akkor a következő függőségekre lehet szüksége:

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

Gyakori függőségek

Ha a .NET-alkalmazás a System.Drawing.Common szerelvényt használja, a libgdiplust is telepíteni kell. Mivel a System.Drawing.Common már nem támogatott Linux rendszeren, ez csak a .NET 6-on működik, és a futtatókörnyezet konfigurációs kapcsolójának System.Drawing.EnableUnixSupport beállítására van szükség.

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

Parancsfájlos telepítés

A dotnet-install szkriptek az SDK és a futtatókörnyezet automatizálására és nem rendszergazdai telepítésére használhatók. A szkriptet https://dot.net/v1/dotnet-install.shinnen töltheti le. Ha a .NET ilyen módon van telepítve, telepítenie kell a Linux-disztribúció által igényelt függőségeket. Az adott Linux-disztribúcióhoz használja a .NET telepítése Linuxon című cikkben található hivatkozásokat.

Fontos

A szkript futtatásához Bash szükséges.

A szkriptet a következővel wgettöltheti le:

wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh

A szkript futtatása előtt győződjön meg arról, hogy engedélyezi a szkript végrehajthatóként való futtatását:

chmod +x ./dotnet-install.sh

A szkript alapértelmezés szerint telepíti a legújabb hosszú távú támogatási (LTS) SDK-verziót, amely a .NET 8. A legújabb kiadás telepítéséhez, amely nem lehet (LTS) verzió, használja a paramétert --version latest .

./dotnet-install.sh --version latest

Ha az SDK helyett a .NET-futtatókörnyezetet szeretné telepíteni, használja a paramétert --runtime .

./dotnet-install.sh --version latest --runtime aspnetcore

A paraméterrel telepíthet egy adott főverziót, --channel hogy jelezze az adott verziót. Az alábbi parancs telepíti a .NET 8.0 SDK-t.

./dotnet-install.sh --channel 8.0

További információ: dotnet-install scripts reference.

A .NET parancssori engedélyezéséhez tekintse meg a környezeti változók rendszerszintű beállításával kapcsolatos témakört.

Manuális telepítés

A csomagkezelők alternatívájaként letöltheti és manuálisan telepítheti az SDK-t és a futtatókörnyezetet. A manuális telepítést gyakran használják folyamatos integrációs tesztelés vagy nem támogatott Linux-disztribúció részeként. Egy fejlesztő vagy felhasználó számára jobb, ha csomagkezelőt használ.

Töltsön le egy bináris kiadást az SDK-hoz vagy a futtatókörnyezethez az alábbi webhelyek egyikéről. A .NET SDK tartalmazza a megfelelő futtatókörnyezetet:

Bontsa ki a letöltött fájlt, és a export paranccsal állítsa be DOTNET_ROOT a kibontott mappa helyét, majd győződjön meg arról, hogy a .NET a PATH-ban van. Az DOTNET_ROOT exportálás elérhetővé teszi a .NET CLI-parancsokat a terminálban. A .NET környezeti változókkal kapcsolatos további információkért lásd a .NET SDK és a CLI környezeti változóit.

A .NET különböző verziói ugyanahhoz a mappához nyerhetők ki, amelyek egymás mellett találhatók.

Példa

Az alábbi parancsok a Bash használatával állítják be a környezeti változót DOTNET_ROOT az aktuális munkakönyvtárra, majd a következőre .dotnet. Ez a könyvtár akkor jön létre, ha nem létezik. A DOTNET_FILE környezeti változó a telepíteni kívánt .NET bináris kiadás fájlneve. Ezt a fájlt a rendszer kinyeri a DOTNET_ROOT könyvtárba. DOTNET_ROOT A címtár és az tools alkönyvtár is hozzá lesz adva a PATH környezeti változóhoz.

Fontos

Ha ezeket a parancsokat futtatja, ne felejtse el módosítani az DOTNET_FILE értéket a letöltött .NET-bináris névre.

DOTNET_FILE=dotnet-sdk-8.0.100-linux-x64.tar.gz
export DOTNET_ROOT=$(pwd)/.dotnet

mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"

export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools

A .NET több verzióját is telepítheti ugyanabban a mappában.

A .NET-et a változó vagy ~ elérési HOME út által azonosított kezdőkönyvtárba is telepítheti:

export DOTNET_ROOT=$HOME/.dotnet

Letöltött bináris fájlok ellenőrzése

A telepítő letöltése után ellenőrizze, hogy a fájl nem módosult vagy sérült-e. Ellenőrizheti az ellenőrzőösszeget a számítógépen, majd összehasonlíthatja a letöltési webhelyen jelentettekkel.

Amikor letölt egy telepítőt vagy bináris fájlt egy hivatalos letöltési oldalról, megjelenik a fájl ellenőrzőösszege. A Másolás gombra kattintva másolja az ellenőrzőösszeg értékét a vágólapra.

The .NET download page with checksum

sha512sum A parancs használatával kinyomtathatja a letöltött fájl ellenőrzőösszegét. A következő parancs például a dotnet-sdk-8.0.100-linux-x64.tar.gz fájl ellenőrzőösszegét jelenti:

$ sha512sum dotnet-sdk-8.0.100-linux-x64.tar.gz
13905ea20191e70baeba50b0e9bbe5f752a7c34587878ee104744f9fb453bfe439994d38969722bdae7f60ee047d75dda8636f3ab62659450e9cd4024f38b2a5  dotnet-sdk-8.0.100-linux-x64.tar.gz

Hasonlítsa össze az ellenőrzőösszeget a letöltési webhely által megadott értékkel.

Fontos

Annak ellenére, hogy ezekben a példákban egy Linux-fájl látható, ez az információ a macOS rendszerre is vonatkozik.

Ellenőrzőösszeg-fájl használata az ellenőrzéshez

A .NET kibocsátási megjegyzései egy ellenőrzőösszegfájlra mutató hivatkozást tartalmaznak, amellyel ellenőrizheti a letöltött fájlt. Az alábbi lépések bemutatják, hogyan töltheti le az ellenőrzőösszegfájlt, és hogyan ellenőrizheti a .NET telepítési bináris fájlokat:

  1. A GitHubon a .NET 8 kibocsátási megjegyzésoldala https://github.com/dotnet/core/tree/main/release-notes/8.0 a Releases nevű szakaszt tartalmazza. Az ebben a szakaszban található táblázat az egyes .NET 8-kiadások letöltési és ellenőrzőösszegfájljaira hivatkozik:

    The github release notes version table for .NET

  2. Válassza ki a letöltött .NET-verzió hivatkozását. Az előző szakasz a .NET SDK 8.0.100-at használta, amely a .NET 8.0.0 kiadásban található.

  3. A kiadási lapon láthatja a .NET-futtatókörnyezet és a .NET SDK verzióját, valamint az ellenőrzőösszegfájlra mutató hivatkozást:

    The download table with checksums for .NET

  4. Másolja ki az ellenőrzőösszegfájlra mutató hivatkozást.

  5. Használja a következő szkriptet, de cserélje le a hivatkozást a megfelelő ellenőrzőösszegfájl letöltéséhez:

    curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt
    
  6. Az ellenőrzőösszeg- és a .NET-kiadási fájl ugyanazon könyvtárba való letöltésével a sha512sum -c {file} --ignore-missing parancs használatával ellenőrizze a letöltött fájlt.

    Amikor az ellenőrzés sikeres, megjelenik az OK állapotú fájl:

    $ sha512sum -c 8.0.0-sha.txt --ignore-missing
    dotnet-sdk-8.0.100-linux-x64.tar.gz: OK
    

    Ha a sikertelenként megjelölt fájlt látja, a letöltött fájl érvénytelen, ezért nem szabad használni.

    $ sha512sum -c 8.0.0-sha.txt --ignore-missing
    dotnet-sdk-8.0.100-linux-x64.tar.gz: FAILED
    sha512sum: WARNING: 1 computed checksum did NOT match
    sha512sum: 8.0.0-sha.txt: no file was verified
    

Környezeti változók beállítása rendszerszintűen

Ha az előző telepítési szkriptet használta, a beállított változók csak az aktuális terminálmunkamenetre vonatkoznak. Adja hozzá őket a rendszerhéjprofilhoz. Linux rendszeren számos különböző rendszerhéj érhető el, és mindegyik más profillal rendelkezik. Példa:

  • Bash Shell: ~/.bash_profile vagy ~/.bashrc
  • Korn Shell: ~/.kshrc vagy .profile
  • Z Shell: ~/.zshrc vagy .zprofile

Állítsa be a következő két környezeti változót a rendszerhéjprofilban:

  • DOTNET_ROOT

    Ez a változó arra a mappára van állítva, amelybe a .NET telepítve volt, például $HOME/.dotnet:

    export DOTNET_ROOT=$HOME/.dotnet
    
  • PATH

    Ennek a változónak tartalmaznia kell a DOTNET_ROOT mappát és a DOTNET_ROOT/tools mappát is:

    export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
    

Következő lépések