A dotnetup használatának első lépései

Note

dotnetup nyilvános előzetes verzióban érhető el. Funkciói és viselkedése az általános elérhetőség előtt változhat.

dotnetup a felhasználói szintű .NET telepítések platformfüggetlen eszközlánc-kezelője. Rendszercsomag-kezelő használata nélkül telepíti, frissíti és eltávolítja .NET SDK-kat és futtatókörnyezeteket.

Prerequisites

  • Az alábbi operációs rendszerek és architektúrák egyike:

    Operációs rendszer Architectures
    Windows x64, Arm64
    macOS x64, Arm64
    Linux (glibc) x64, Arm64
    Linux (musl), például Alpine Linux x64, Arm64

  • Egy terminál.

  • A letöltési szkript futtatásához macOS-en vagy Linuxon a Basht, Windowson pedig a PowerShellt használja.

  • macOS vagy Linux rendszeren, curl vagy wget a fájlok letöltéséhez, és sha512sum vagy shasum az ellenőrzésükhöz.

A dotnetup operációsrendszer-követelményei megegyeznek a .NET futtatókörnyezetével. Az operációsrendszer-specifikus követelményekről lásd a .NET telepítése Windows rendszerre, a .NET telepítése macOS rendszerre vagy a .NET telepítése Linux rendszerre című témakört.

Important

Windows rendszeren az alapértelmezett beállítás a everywhere hozzáférési módot használja. Ez a mód:

  • A rendszer frissítéséhez jogosultságszint-emelés szükséges PATH.
  • A dotnetup által felügyelt telepítés elsőbbséget élvez a gépszintű .NET-telepítésekkel szemben, például azokkal szemben, amelyeket a Visual Studio telepít. Azok a projektek és alkalmazások, amelyeknek gépi szintű SDK-ra vagy futtatókörnyezetre van szükségük, amelyet a dotnetup sem telepít, nem fordulnak le vagy nem futnak.
  • Módosítja a rendszert PATH, ez a módosítás az összes felhasználóra vonatkozik. A más felhasználók által indított emelt szintű folyamatok a felhasználói profiljából oldhatják fel a .NET-et.

Az ilyen effektusok elkerülése érdekében válassza ki a beállítás során a none vagy shell hozzáférési módot. Ha úgy dönt everywhere, migrálja a meglévő telepítéseket, ha a telepítő felajánlja. További részletekért tekintse meg a Everywhere mód szempontjait.

Dotnetup letöltése

A letöltési szkriptek alapértelmezés szerint telepítik a legújabb preview buildet. Ellenőrzik a letöltött végrehajtható fájlt az SHA-512 ellenőrzőösszegével, és telepítik ide: ~/.dotnetup.

MacOS vagy Linux rendszeren futtassa a következőt:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

Windows rendszeren futtassa:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

A legújabb daily build macOS vagy Linux rendszeren való telepítéséhez futtassa a következőt:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily

A legújabb daily build Windowsra való telepítéséhez futtassa a következőt:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily"

Important

A napi buildek nem estek át a kiadás érvényesítésén, és nincsenek kóddal aláírva. Napi buildeket csak rövid élettartamú teszteléshez használhat.

A szkriptek utasításokat nyomtatnak a(z) dotnetup hozzáadásához a(z) PATH elemhez. Az utasítások alkalmazása után nyisson meg egy új terminált.

Az első beállítás futtatása

Futtassa az interaktív telepítőt:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

Az útvonalak, a folyamatjelző és a környezet útmutatása a rendszertől és a kiválasztott módtól függ.

Az ajánlott hozzáférési mód Windowson a(z) everywhere. macOS-en és Linuxon ez shell, ha a dotnetup támogatott rendszerhéjat észlel, máskülönben none.

Válassza a Nem, a telepítés testreszabása lehetőséget az SDK-csatorna, a hozzáférési mód és az áttelepítési beállítások kiválasztásához.

SDK-csatorna kiválasztása

Egy SDK-csatorna közli dotnetup-val, hogy melyik SDK-t kell telepíteni, és hogyan kell azt frissíteni.

Csatorna űrlap Example Result
Legújabb stabil verzió latest Legújabb aktív stabil SDK
Legújabb LTS lts Legújabb aktív stabil LTS SDK
Legújabb előzetes preview Legújabb előzetes verziójú SDK
Legfrissebb napi daily Legújabb elérhető napi SDK
Őrnagy 10 A megadott főverzió legújabb SDK-ja
Fő- és alverziószám 10.0 A megadott fő- és alverzió legújabb SDK-ja
Funkciósáv 10.0.1xx A megadott funkciósáv legújabb SDK-ja
Pontos verzió 10.0.103 Csak a megadott SDK-verzió
Nincs megadott kezdeti SDK none Telepítés kihagyása a beállítás során

A pontos verziók nem frissülnek a frissítések során. Az összes elfogadott formátum esetében lásd a dotnetup csatornákat és -verziókat.

A .NET elérésének kiválasztása

A hozzáférési mód szabályozza, hogy a terminálok és alkalmazások hogyan találják meg a dotnetup által felügyelt .NET telepítését.

Hozzáférési mód Viselkedés
none Nem módosítja ezeket a környezeti változókat. Futtassa a .NET-et ezzel: dotnetup dotnet.
shell Módosítja a shellprofilt ezen környezeti változók beállítása érdekében. A rendszerhéjból indított folyamatok a dotnetup által telepített .NET SDK-kat és futtatókörnyezeteket használják.
everywhere Módosítja a rendszert PATH , és beállítja a felhasználói szintű DOTNET_ROOT környezeti változót. Csak Windowson érhető el.

A everywhere módra vonatkozó további részletekért és szempontokért lásd a dotnetup környezet konfigurációját.

Meglévő telepítések migrálása

A telepítő felajánlhatja a meglévő, gépszintű .NET SDK- és futtatókörnyezeti telepítések áttelepítését a dotnetup által felügyelt telepítésbe. Tekintse meg a Mindenhol mód szempontjait, hogy miért különösen fontos a migrálás everywhere mód esetében.

Beállítás ellenőrzése

A beállítási módosítások után nyisson meg egy új terminált.

A(z) shell vagy everywhere módhoz futtassa a következőt:

dotnet --version
dotnetup list

none módhoz futtassa a következőt:

dotnetup dotnet -- --version
dotnetup list

A beállítás módosításához futtassa újra a(z) dotnetup init elemet.

Tartsa naprakészen a dotnetupot

Az eszköz frissítéséhez futtassa a következőt: dotnetup self update Napi build esetén használja a dotnetup self update --channel daily. Ezek a parancsok nem frissítik a felügyelt SDK-kat vagy futtatókörnyezeteket. A beállításokkal és a régebbi verzióra való visszaállítással kapcsolatban lásd: A dotnetup frissítése vagy eltávolítása.

  • Utolsó frissítés időpontja: