A .NET telepítése macOS rendszeren

• Telepítés Windows rendszeren
• Telepítés macOS rendszeren
• Telepítés Linuxon

Ez a cikk bemutatja, hogy a .NET mely verziói támogatottak macOS rendszeren, hogyan telepíthető a .NET, és mi a különbség az SDK és a futtatókörnyezet között.

A .NET legújabb verziója 8.

A .NET letöltése

Támogatott verziók

Az alábbi táblázat felsorolja a támogatott .NET-kiadásokat, és hogy mely macOS-en támogatottak. Ezek a verziók mindaddig támogatottak maradnak, amíg a .NET verziója el nem éri a támogatás megszűnését, vagy a macOS verziója már nem támogatott.

macOS-verzió	.NET
macOS 15 "Sequoia"	8.0, 6.0
macOS 14 "Sonoma"	8.0, 6.0
macOS 13 "Ventura"	8.0, 6.0

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

• .NET 7
• .NET 6 (2024. november 12-től)
• .NET 5
• .NET Core 3.1
• .NET Core 3.0
• .NET Core 2.2
• .NET Core 2.1
• .NET Core 2.0

Futtatókörnyezet vagy SDK

A futtatókörnyezet a .NET-tel létrehozott alkalmazások futtatására szolgál. Amikor egy alkalmazás szerzője közzétesz egy alkalmazást, belefoglalhatja a futtatókörnyezetet az alkalmazásba. Ha nem tartalmazzák a futtatókörnyezetet, a felhasználónak kell telepítenie a megfelelő futtatókörnyezetet.

Két futtatókörnyezetet telepíthet a macOS-en, és mindkettő az SDK része.

• ASP.NET Core Runtime
  ASP.NET Core-alkalmazásokat futtat. Tartalmazza a .NET-futtatókörnyezetet. Telepítőként nem érhető el.

• .NET-futtatókörnyezet
  Ez normál .NET-alkalmazásokat futtat, speciális alkalmazásokat azonban nem, például ASP.NET Core-ra épülő alkalmazásokat.

Az SDK .NET-alkalmazások és -kódtárak készítésére és közzétételére szolgál. A legújabb SDK támogatja a .NET korábbi verzióihoz készült alkalmazások készítését. Normál körülmények között csak a legújabb SDK-ra lenne szükség.

Az SDK telepítése magában foglalja a standard .NET-futtatókörnyezetet és a ASP.NET Core-futtatókörnyezetet is. Ha például telepítve van a .NET SDK 8.0, akkor a .NET Runtime 8.0 és ASP.NET Core 8.0 futtatókörnyezet is telepítve van. Más futtatókörnyezeti verzió azonban nem lesz telepítve az SDK-val, és külön kell telepítenie.

A .NET telepítésének kiválasztása

A .NET telepítésének különböző módjai vannak, és egyes termékek kezelhetik a .NET saját verzióját. Ha a .NET-et olyan szoftveren keresztül telepíti, amely a .NET saját verzióját kezeli, előfordulhat, hogy a rendszer nem engedélyezi. Győződjön meg arról, hogy tisztában van a .NET más szoftvereken keresztül történő telepítésének következményeival.

Ha nem biztos abban, hogy a következő szakaszok listáinak áttekintése után melyik metódust válassza, akkor valószínűleg a .NET Installer-csomagot szeretné használni.

Fejlesztők

• Visual Studio Code – C# Dev Kit

  Telepítse a Visual Studio Code C# Dev Kit bővítményét a .NET-alkalmazások fejlesztéséhez. A bővítmény használhat egy már telepített SDK-t, vagy telepíthet egyet.

Felhasználók és fejlesztők

• .NET Installer

  A .NET telepítéséhez használja a különálló telepítőt. Ez a módszer a .NET fejlesztői vagy felhasználói gépre történő telepítésének tipikus módja.

• A .NET telepítése szkripttel

  Bash-szkript, amely automatizálja az SDK vagy a futtatókörnyezet telepítését. Kiválaszthatja, hogy a .NET melyik verzióját telepítse.

• A .NET manuális telepítése

  Ezt a telepítési módszert akkor használja, ha a .NET-et egy adott mappába kell telepítenie, és a .NET más példányaitól eltérően kell futtatnia.

A .NET telepítése

A telepítőcsomagok a macOS-hez érhetők el, amely a .NET egyszerű telepítésének módja.

1. Nyisson meg egy böngészőt, majd lépjen a következő helyre: https://dotnet.microsoft.com/download/dotnet.

2. Válassza ki a telepíteni kívánt .NET-verzióra mutató hivatkozást, például a .NET 8.0-t.

   

   Ez a hivatkozás a .NET ezen verziójának letöltésére szolgáló hivatkozásokat tartalmazó lapra mutat.

   Ha telepíteni szeretné az SDK-t, válassza ki a legújabb .NET-verziót. Az SDK támogatja a .NET korábbi verzióihoz készült alkalmazások készítését.

   Tipp.

   Ha nem biztos abban, hogy melyik verziót töltse le, válassza ki a legújabbként megjelölt verziót.

3. Ez az oldal az SDK és a futtatókörnyezet letöltési hivatkozásait mutatja be. Itt letöltheti a .NET SDK-t vagy a .NET-futtatókörnyezetet.

   

   Az előző képen két szakasz van kiemelve. Ha letölti az SDK-t, tekintse meg az 1. szakaszt. A .NET-futtatókörnyezethez tekintse meg a 2. szakaszt.

   • 1. szakasz (SDK)

     Ez a szakasz az SDK letöltési területe. A macOS sor Telepítők oszlopában két architektúra található: Arm64 és x64.

     • Ha Apple-processzort, például M1-et vagy M3 Pro-t futtat, válassza az Arm64 lehetőséget.
     • Ha Intel processzort futtat, válassza az x64 lehetőséget.

   • 2. szakasz (futtatókörnyezet)

     Ez a szakasz a futtatókörnyezet letöltéseit tartalmazza. Figyelje meg, hogy a macOS sor Telepítők oszlopának hivatkozásai üresek! Ez a szakasz üres, mert a ASP.NET Core Runtime csak az SDK-ban vagy bináris telepítéssel érhető el.

     Görgessen tovább lefelé a letöltéshez használt standard .NET-futtatókörnyezet megkereséséhez.

     

     • Ha Apple-processzort, például M1-et vagy M3 Pro-t futtat, válassza az Arm64 lehetőséget.
     • Ha Intel processzort futtat, válassza az x64 lehetőséget.

4. Ha a letöltés befejeződött, nyissa meg.

5. Kövesse a telepítő lépéseit.

   

A .NET manuális telepítése

A macOS-telepítő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és általában egy folyamatos integrációs forgatókönyv részeként történik. A fejlesztők és a felhasználók általában a telepítőt szeretnék használni.

Tipp.

A install-dotnet.sh szkripttel automatikusan végrehajthatja ezeket a lépéseket.

1. Nyisson meg egy böngészőt, majd lépjen a következő helyre: https://dotnet.microsoft.com/download/dotnet.

2. Válassza ki a telepíteni kívánt .NET-verzióra mutató hivatkozást, például a .NET 8.0-t.

   Ez a hivatkozás a .NET ezen verziójának letöltésére szolgáló hivatkozásokat tartalmazó lapra mutat.

   Ha telepíteni szeretné az SDK-t, válassza ki a legújabb .NET-verziót. Az SDK támogatja a .NET korábbi verzióihoz készült alkalmazások készítését.

   Tipp.

   Ha nem biztos abban, hogy melyik verziót töltse le, válassza ki a legújabbként megjelölt verziót.

   

3. Válassza ki a telepíteni kívánt SDK-ra vagy futtatókörnyezetre mutató hivatkozást. Keresse meg a bináris fájlok oszlopot a macOS sorban.

   

   • Ha Apple-processzort, például M1-et vagy M3 Pro-t futtat, válassza az Arm64 lehetőséget.
   • Ha Intel processzort futtat, válassza az x64 lehetőséget.

4. Nyisson meg egy terminált, és keresse meg a .NET bináris letöltési helyét.

5. Bontsa ki a tarballt arra a helyre, ahová a .NET-et használni szeretné a rendszeren. Az alábbi példa a HOME könyvtárat ~/Applications/.dotnethasználja.

   mkdir -p ~/Applications/.dotnet
   tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/
   

A .NET működésének teszteléséhez módosítsa a könyvtárat arra a helyre, ahová a .NET telepítve van, és futtassa a dotnet --info parancsot:

chdir ~/Applications/.dotnet/
./dotnet --info

A .NET telepítése szkripttel

A dotnet-install szkriptek a futtatókörnyezet automatizálására és nem felügyelt telepítésére szolgálnak. A szkriptet https://dot.net/v1/dotnet-install.shinnen töltheti le.

A szkript alapértelmezés szerint telepíti a legújabb hosszú távú támogatási (LTS) verziót, amely a .NET 8. A kapcsoló megadásával kiválaszthat egy adott kiadást channel . Adja meg a runtime kapcsolót futtatókörnyezet telepítéséhez. Ellenkező esetben a szkript telepíti az SDK-t.

Tipp.

Ezek a parancsok egy szkriptrészletet biztosítanak az eljárás végén.

1. Nyisson meg egy terminált.

2. Lépjen egy mappába, ahol le szeretné tölteni a szkriptet, például ~/Letöltések.

3. Ha nem rendelkezik a paranccsal, telepítse a wget Brew paranccsal

   brew install wget
   

4. Futtassa a következő parancsot a szkript letöltéséhez:

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

5. Parancsprogram végrehajtási engedélyeinek megadása

   chmod +x dotnet-install.sh
   

6. Futtassa a szkriptet a .NET telepítéséhez.

   A szkript alapértelmezés szerint a legújabb SDK-t telepíti a ~/.dotnet könyvtárba.

   ./dotnet-install.sh
   

Íme az összes parancs egyetlen bash-szkriptként:

chdir ~/Downloads
brew install wget
wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh

A .NET teszteléséhez navigáljon a ~/.dotnet mappára, és futtassa a dotnet --info parancsot:

chdir ~/.dotnet
./dotnet --info

Fontos

Előfordulhat, hogy egyes programok környezeti változókkal keresik a .NET-et a rendszeren, és előfordulhat, hogy a dotnet parancs használata nem működik új terminál megnyitásakor. A probléma megoldásához tekintse meg a .NET rendszerszintű elérhetővé tétele című szakaszt.

A .NET telepítése a Visual Studio Code-hoz

A Visual Studio Code egy hatékony és egyszerű forráskódszerkesztő, amely az asztalon fut. A Visual Studio Code használhatja a rendszeren már telepített SDK-t. Emellett a C# Dev Kit bővítmény telepíti a .NET-et, ha még nincs telepítve.

A .NET Visual Studio Code-on keresztüli telepítésével kapcsolatos utasításokért tekintse meg a C# használatának első lépéseit a VS Code-ban.

Közjegyzői jelölés

A fejlesztői azonosítóval elosztott macOS-hez létrehozott szoftvereket közjegyzővel kell felügyelni, beleértve a .NET-tel készült alkalmazásokat is.

Ha nem hitelesített alkalmazást futtat, a következő képhez hasonló hibaablak jelenik meg:

További információ arról, hogy a kényszerített hitelesítés hogyan befolyásolja a .NET-et (és a .NET-alkalmazásokat), olvassa el a macOS Catalina Notarization használata című témakört.

Érvényesítés

A telepítő vagy a bináris kiadás 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ölti a fájlt egy hivatalos letöltési oldalról, a fájl ellenőrzőösszege megjelenik egy szövegdobozban. A Másolás gombra kattintva másolja az ellenőrzőösszeg értékét a vágólapra.

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#releases 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:

   

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:

   

4. Kattintson a jobb gombbal az Ellenőrzőösszeg hivatkozásra, és másolja a vágólapra a hivatkozást.

5. Nyisson meg egy terminált.

6. Az ellenőrzőösszeg-fájl letöltésére használható curl -O {link} .

   Cserélje le a következő parancs hivatkozását a másolt hivatkozásra.

   curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt
   

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

Hibaelhárítás

A problémák elhárításához az alábbi szakaszok érhetők el:

• Arm-alapú Mac gépek
• System.Drawing.Common és libgdiplus
• A .NET elérhetővé tétele rendszerszintűen

A .NET elérhetővé tétele rendszerszintűen

Előfordulhat, hogy a rendszeren lévő alkalmazásoknak , beleértve a terminált is, meg kell találniuk, hogy hol van telepítve a .NET. A .NET macOS Installer csomagnak automatikusan konfigurálnia kell a rendszert. Ha azonban a manuális telepítési módszert vagy a .NET telepítési szkriptet használta, hozzá kell adnia azt a könyvtárat, amelyben a .NET telepítve lett a PATH változóhoz.

Egyes alkalmazások megkereshetik a DOTNET_ROOT változót, amikor megpróbálják meghatározni, hogy hol van telepítve a .NET.

A macOS-hez számos különböző rendszerhéj érhető el, és mindegyik más profillal rendelkezik. Példa:

• Bash Shell: ~/.profile, /etc/profile
• 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
  

Arm-alapú Mac gépek

Az alábbi szakaszok ismertetik a .NET Arm-alapú Mac gépekre való telepítésekor megfontolandó szempontokat.

.NET-verziók

Az alábbi táblázat azt ismerteti, hogy a .NET mely verziói támogatottak arm-alapú Mac gépeken:

.NET-verzió	SDK	Futtatókörnyezet	Elérési út ütközése
8	Igen	Igen	Nem
8	Igen	Igen	Nem
6	Igen	Igen	Nem
6	Igen	Igen	Nem

A .NET SDK x64 és Arm64 verziói egymástól függetlenül léteznek. Ha új verziót ad ki, minden telepítést frissíteni kell.

Elérésiút-különbségek

Arm-alapú Mac gépen a .NET összes Arm64-verziója telepítve van a normál /usr/local/share/dotnet/ mappába. A .NET SDK x64-es verziójának telepítésekor azonban az /usr/local/share/dotnet/x64/dotnet/ mappába lesz telepítve.

Elérésiút-ütközések

Az x64 .NET SDK az előző szakaszban leírtak szerint a saját könyvtárába telepedik. Ez lehetővé teszi, hogy a .NET SDK Arm64- és x64-verziói ugyanazon a gépen létezhessenek. A .NET 6 előtti x64 SDK-k azonban nem támogatottak, és ugyanarra a helyre telepítenek, mint az Arm64-verzió, a /usr/local/share/dotnet/ mappa. Ha nem támogatott x64 SDK-t szeretne telepíteni, először el kell távolítania az Arm64-verziót. Az ellenkezője is igaz, el kell távolítania a nem támogatott x64 SDK-t az Arm64-verzió telepítéséhez.

Elérésiút-változók

Ha a .NET 6 SDK x64- és Arm64-verziói is telepítve vannak, előfordulhat, hogy módosítani kell azokat a környezeti változókat, amelyek .NET-et adnak hozzá a rendszer elérési útjához, például a PATH változóhoz. Emellett néhány eszköz a DOTNET_ROOT környezeti változóra támaszkodik, amelyet frissíteni kell, hogy a megfelelő .NET 6 SDK telepítési mappára mutasson.

System.Drawing.Common és libgdiplus

A szerelvényt System.Drawing.Common használó .NET-alkalmazásokat telepíteni kell libgdiplus .

Könnyen beszerezhető libgdiplus a Homebrew ("brew") csomagkezelője macOS-hez. A brew telepítése után telepítse libgdiplus a következő parancsokat a terminálon:

brew update
brew install mono-libgdiplus

Kapcsolódó tartalom

• Annak ellenőrzése, hogy a .NET már telepítve van-e.
• MacOS Catalina notarization használata.
• Oktatóanyag: Új alkalmazás létrehozása a Visual Studio Code-tal.
• Oktatóanyag: .NET-alkalmazás tárolóba helyezése.