Sdílet prostřednictvím


dotnet workload install

Tento článek se vztahuje na: ✔️ .NET 6 SDK a novější verze

Název

dotnet workload install – Nainstaluje volitelné úlohy.

Synopse

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

Popis

Příkaz dotnet workload install nainstaluje jednu nebo více volitelných úloh. Volitelné úlohy je možné nainstalovat nad sadu .NET SDK, aby poskytovaly podporu pro různé typy aplikací, jako jsou .NET MAUI a Blazor WebAssembly AOT.

Pokud je příkaz v workload-set režimu aktualizace, nainstalují se verze úloh:

  • Pochází z nejnovější sady úloh nebo verze sady úloh zadané v global.json nebo --version možnosti.
  • Nemusí se jednat o nejnovější dostupnou verzi jednotlivých úloh. Příkaz například nenainstaluje novější sadu úloh, install pokud jste příznak použili --version dříve.

Další informace najdete v tématu Sady úloh .NET SDK. workload-set Režim aktualizace je k dispozici od sady SDK 8.0.400.

Pomocí vyhledávání úloh dotnet zjistíte, jaké úlohy jsou k dispozici k instalaci.

Kdy spustit zvýšenou úroveň

Pro instalace sady macOS a Linux SDK, které jsou nainstalované do chráněného adresáře, musí příkaz spustit se zvýšenými oprávněními (použijte tento sudo příkaz). Ve Windows nemusí příkaz spouštět se zvýšenými oprávněními, i když je sada SDK nainstalovaná do adresáře Program Files . Příkaz pro Windows používá instalační programy MSI pro toto umístění.

Výsledky se liší podle verze sady SDK

Příkazy dotnet workload fungují v kontextu konkrétních verzí sady SDK. Předpokládejme, že máte nainstalovanou sadu .NET 6.0.100 SDK i sadu .NET 6.0.200 SDK. Příkazy dotnet workload budou poskytovat různé výsledky v závislosti na verzi sady SDK, kterou vyberete. Toto chování se vztahuje na hlavní a podverzi a rozdíly v pásmu funkcí, nikoli na rozdíly ve verzích oprav. Například sada .NET SDK 6.0.101 a 6.0.102 poskytují stejné výsledky, zatímco 6.0.100 a 6.0.200 poskytují různé výsledky. Verzi sady SDK můžete zadat pomocí souboru global.json.

Reklamní manifesty

Názvy a verze prostředků, které instalace úloh vyžaduje, se udržují v manifestech. Ve výchozím nastavení dotnet workload install příkaz stáhne nejnovější dostupné manifesty před instalací úlohy. Místní kopie manifestu pak poskytuje informace potřebné k vyhledání a stažení prostředků pro úlohu.

Příkaz dotnet workload list porovnává verze nainstalovaných úloh s aktuálně dostupnými verzemi. Když zjistí, že je k dispozici novější verze než nainstalovaná verze, inzeruje tuto skutečnost ve výstupu příkazu. Tato oznámení novější verze dotnet workload list jsou dostupná od verze .NET 6.

Pokud chcete tato oznámení povolit, nejnovější dostupné verze manifestů se stáhnou a uloží jako reklamní manifesty. K těmto stahováním dochází asynchronně na pozadí při spuštění některého z následujících příkazů.

Pokud se příkaz dokončí před dokončením stahování manifestu, stahování se zastaví. Stažení se zkusí znovu při příštím spuštění jednoho z těchto příkazů. Proměnné prostředí můžete nastavit tak, aby se tyto stahování na pozadí zakázalo, nebo můžete řídit jejich frekvenci. Ve výchozím nastavení se nedějí více než jednou denně.

Příkaz můžete zabránit dotnet workload install stahování manifestu --skip-manifest-update pomocí této možnosti.

Příkaz dotnet workload update také stáhne reklamní manifesty. Stahování se vyžaduje, abyste se dozvěděli, jestli je k dispozici aktualizace, takže není možné jim zabránit ve spuštění. Tuto možnost ale můžete použít --advertising-manifests-only ke přeskočení aktualizací úloh a stažení manifestu. Tato možnost je dostupná od verze .NET 6.

Argumenty

  • WORKLOAD_ID...

    ID úlohy nebo několik ID k instalaci. Pomocí vyhledávání úloh dotnet zjistíte, jaké úlohy jsou k dispozici.

Možnosti

  • --configfile <FILE>

    Konfigurační soubor NuGet (nuget.config), který se má použít. Pokud je zadáno, použijí se pouze nastavení z tohoto souboru. Pokud není zadáno, použije se hierarchie konfiguračních souborů z aktuálního adresáře. Další informace najdete v tématu Běžné konfigurace NuGet.

  • --disable-parallel

    Zabraňuje paralelnímu obnovení více projektů.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • --ignore-failed-sources

    Zpracovává selhání zdroje balíčků jako upozornění.

  • --include-previews

    Umožňuje předběžné verze manifestů úloh.

  • --interactive

    Umožňuje příkazu zastavit a čekat na uživatelský vstup nebo akci. Například k dokončení ověřování.

  • --no-cache

    Zabraňuje ukládání balíčků do mezipaměti a požadavků HTTP.

  • --skip-manifest-update

    Přeskočte aktualizaci manifestů úloh. Manifesty úloh definují, jaké prostředky a verze je potřeba nainstalovat pro každou úlohu.

  • -s|--source <SOURCE>

    Určuje identifikátor URI zdroje balíčku NuGet, který se má použít. Toto nastavení přepíše všechny zdroje zadané v souborech nuget.config . Tuto možnost lze zadat vícenásobným zadáním této možnosti.

  • --temp-dir <PATH>

    Zadejte dočasný adresář použitý ke stažení a extrahování balíčků NuGet (musí být zabezpečený).

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , n[ormal]m[inimal], d[etailed]a diag[nostic]. Výchozí hodnota je minimal. Pokud zadáte detailed nebo diagnostic zjistíte, příkaz zobrazí informace o balíčcích NuGet, které stáhne.

  • --version

    Verze sady funkcí pro instalaci nebo aktualizaci. Pokud v global.json zadáte verzi sady úloh, nemůžete ji použít --version k určení verze sady úloh. Pokud chcete tuto možnost použít --version , spusťte příkaz mimo cestu obsahující soubor global.json. K dispozici od sady SDK verze 8.0.400. Další informace najdete v tématu Sady úloh .NET SDK.

Příklady

  • maui Nainstalujte úlohu:

    dotnet workload install maui
    
  • Nainstalujte úlohy maui-android a maui-ios úlohy:

    dotnet workload install maui-android maui-ios