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

dotnet workload install

  • Cikk

Ez a cikk a következő verziókra vonatkozik: ✔️ .NET 6 SDK és újabb verziók

Név

dotnet workload install – Telepíti az opcionális számítási feladatokat.

Szinopszis

dotnet workload install <WORKLOAD_ID>...
    [--configfile <FILE>] [--disable-parallel]
    [--ignore-failed-sources] [--include-previews] [--interactive]
    [--no-cache] [--skip-manifest-update] [--source <SOURCE>]
    [--temp-dir <PATH>] [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet workload install -?|-h|--help

Leírás

A dotnet workload install parancs egy vagy több választható számítási feladatot telepít. Az opcionális számítási feladatok telepíthetők a .NET SDK-ra, hogy támogatást nyújtsanak különböző alkalmazástípusokhoz, például a .NET MAUI-hoz és a Blazor WebAssembly AOT-hoz.

Ha a parancs frissítési workload-set módban van, a számítási feladatok verziói telepítve vannak:

  • A legújabb számítási feladatkészletből vagy egy global.json vagy --version beállításban megadott számítási feladatkészlet-verzióból származnak.
  • Előfordulhat, hogy nem az egyes számítási feladatok legújabb verziója érhető el. A parancs például install nem telepít újabb számítási feladatkészletet, ha korábban használta a jelölőt --version .

További információ: .NET SDK számítási feladatkészletek. workload-set A frissítési mód a 8.0.400 SDK óta érhető el.

A dotnet-alapú számítási feladatok keresésének használatával megtudhatja, hogy mely számítási feladatok telepíthetők.

Mikor futtasson emelt szintűt?

A védett könyvtárba telepített macOS- és Linux SDK-telepítések esetén a parancsnak emelt szintű (a sudo parancsot használva) kell futnia. Windows rendszeren a parancsnak nem kell emelt szinten futnia, még akkor sem, ha az SDK telepítve van a Program Files könyvtárban. Windows esetén a parancs MSI-telepítőket használ ehhez a helyhez.

Az eredmények SDK-verziótól függően változnak

A dotnet workload parancsok adott SDK-verziók kontextusában működnek. Tegyük fel, hogy a .NET 6.0.100 SDK és a .NET 6.0.200 SDK is telepítve van. A dotnet workload parancsok különböző eredményeket adnak attól függően, hogy melyik SDK-verziót választja. Ez a viselkedés a fő- és alverziókra, valamint a funkciósávok eltérésére vonatkozik, nem pedig a javítás verzióbeli eltéréseire. A .NET SDK 6.0.101 és 6.0.102 például ugyanazt az eredményt adja, míg a 6.0.100 és a 6.0.200 eltérő eredményt ad. Az SDK-verziót a global.json fájl használatával adhatja meg.

Hirdetési jegyzékek

A számítási feladatok telepítéséhez szükséges eszközök nevei és verziói a jegyzékekben vannak megőrzve. Alapértelmezés szerint a dotnet workload install parancs letölti a legújabb elérhető jegyzékfájlokat, mielőtt telepíti a számítási feladatot. A jegyzék helyi másolata ezután megadja a számítási feladat eszközeinek megkereséséhez és letöltéséhez szükséges információkat.

A dotnet workload list parancs összehasonlítja a telepített számítási feladatok verzióit a jelenleg elérhető verziókkal. Amikor megállapítja, hogy a telepített verziónál újabb verzió érhető el, ezt a tényt a parancs kimenetében hirdeti. Ezek az újabb verziójú dotnet workload list értesítések a .NET 6-tól érhetők el.

Az értesítések engedélyezéséhez a jegyzékek legújabb elérhető verzióit a rendszer letölti és hirdetési jegyzékként tárolja. Ezek a letöltések aszinkron módon történnek a háttérben az alábbi parancsok futtatásakor.

Ha egy parancs befejeződik a jegyzék letöltése előtt, a letöltés leáll. A következő parancs futtatásakor a rendszer ismét megpróbálja a letöltést. Beállíthatja a környezeti változókat, hogy letiltsák ezeket a háttérletöltéseket , vagy szabályozhassák azok gyakoriságát. Alapértelmezés szerint naponta csak egyszer fordulnak elő.

A beállítással --skip-manifest-update megakadályozhatja, hogy a dotnet workload install parancs jegyzékfájl-letöltéseket hajt végre.

A dotnet workload update parancs a hirdetési jegyzékeket is letölti. A letöltések szükségesek ahhoz, hogy megtudják, elérhető-e frissítés, ezért nincs lehetőség a futtatásuk megakadályozására. Használhatja azonban a --advertising-manifests-only számítási feladatok frissítéseinek kihagyását, és csak a jegyzék letöltését. Ez a beállítás a .NET 6-tól érhető el.

Argumentumok

  • WORKLOAD_ID...

    A számítási feladat azonosítója vagy több telepíteni kívánt azonosító. A dotnet-alapú számítási feladatok keresésének használatával megtudhatja, hogy mely számítási feladatok érhetők el.

Beállítások

  • --configfile <FILE>

    A használni kívánt NuGet-konfigurációs fájl (nuget.config). Ha meg van adva, a rendszer csak a fájlból származó beállításokat használja. Ha nincs megadva, a rendszer az aktuális könyvtárból származó konfigurációs fájlok hierarchiáját használja. További információ: Common NuGet Configurations.

  • --disable-parallel

    Megakadályozza több projekt párhuzamos visszaállítását.

  • -?|-h|--help

    A parancs használatának leírását nyomtatja ki.

  • --ignore-failed-sources

    Figyelmeztetésként kezeli a csomag forráshibáit.

  • --include-previews

    Lehetővé teszi a számítási feladatok előzetes jegyzékfájljait.

  • --interactive

    Lehetővé teszi, hogy a parancs leálljon, és várja meg a felhasználói bemenetet vagy műveletet. Például a hitelesítés befejezéséhez.

  • --no-cache

    Megakadályozza a csomagok és http-kérések gyorsítótárazását.

  • --skip-manifest-update

    Hagyja ki a számítási feladatjegyzékek frissítését. A számítási feladatjegyzékek határozzák meg, hogy milyen eszközöket és verziókat kell telepíteni az egyes számítási feladatokhoz.

  • -s|--source <SOURCE>

    Megadja a használni kívánt NuGet-csomagforrás URI-ját. Ez a beállítás felülbírálja a nuget.config fájlokban megadott összes forrást. A beállítás többszöri megadásával több forrás is megadható.

  • --temp-dir <PATH>

    Adja meg a NuGet-csomagok letöltéséhez és kinyeréséhez használt ideiglenes könyvtárat (biztonságosnak kell lennie).

  • -v|--verbosity <LEVEL>

    A parancs részletességi szintjét állítja be. Az engedélyezett értékek a következőkq[uiet]: , m[inimal], n[ormal]d[etailed]és diag[nostic]. Az alapértelmezett érték minimal. Ha megadja vagy diagnostic részletességet ad megdetailed, a parancs megjeleníti a letöltött Nuget-csomagokkal kapcsolatos információkat.

  • --version

    A számítási feladat által beállított verzió, amelybe telepíteni vagy frissíteni kell. Ha a számítási feladat által beállított verziót adja meg a global.json, a beállítással nem --version adhatja meg a számítási feladat által beállított verziót. Ha ebben az esetben szeretné használni a --version lehetőséget, futtassa a parancsot a global.json fájlt tartalmazó elérési úton kívül. 8.0.400 SDK óta érhető el. További információ: .NET SDK számítási feladatkészletek.

Példák

  • Telepítse a maui számítási feladatot:

    dotnet workload install maui

  • Telepítse a és maui-ios a maui-android számítási feladatokat:

    dotnet workload install maui-android maui-ios