Sdílet prostřednictvím

Sady úloh sady funkcí .NET SDK

  • Článek

Funkce sad úloh poskytuje číslo verze, které představuje skupinu úloh sady .NET SDK. Příkazy pro instalaci, aktualizaci a obnovení používají toto číslo v režimu aktualizace sady úloh a poskytují následující výhody:

  • Můžete řídit četnost změn nainstalovaných verzí úloh. Alternativní režim operace bez použití sad úloh se nazývá režim aktualizace volných manifestů. V tomto režimu se úlohy aktualizují automaticky, protože nové verze jednotlivých úloh se vydávají do všech nakonfigurovaných informačních kanálů NuGet. V workload-set režimu aktualizace zůstanou úlohy v konkrétní verzi sady úloh, dokud tuto verzi explicitně nezměníte.
  • Můžete nainstalovat a aktualizovat kombinaci verzí úloh, které se dodávají současně a které jsou známé, že spolupracují.
  • Můžete zajistit, aby všichni členové vašeho týmu vždy pracovali na stejných verzích úloh.
  • Pokud chcete určit, jakou verzi úlohy chcete používat, nemusíte používat záložní soubor.

Tady je několik způsobů, jak můžete použít sady úloh:

  • "Připnout" install příkaz na konkrétní verzi sady úloh.
  • Aktualizujte nainstalované úlohy na nejnovější dostupnou verzi sady úloh.
  • Aktualizujte na zadanou verzi sady úloh.
  • Zadejte verzi sady úloh v global.json.
  • Zkontrolujte aktuální režim aktualizace a verzi sady úloh.

A přesto se můžete rozhodnout nainstalovat, aktualizovat nebo obnovit nejnovější verzi jednotlivých úloh a ignorovat sady úloh.

Požadavky

  • .NET 8.0.400 SDK nebo novější.

    V sadě SDK verze 8.0.400 jsou příkazy v režimu aktualizace sady úloh pouze v případě, dotnet workload že je explicitně vybrána.

Připnutí příkazu install

Příkaz dotnet workload install s --version možností "připne" install příkaz v workload-set režimu aktualizace se zadanou verzí sady úloh. Příkaz už automaticky nenainstaluje nejnovější úlohy na základě volných manifestů.

Postup připnutí install příkazu:

  1. Zvolte verzi sady úloh. Například 9.0.100-preview.7.24414.1.

  2. Zvolte úlohu. Například aspire.

  3. dotnet workload install aspire --version 9.0.100-preview.7.24414.1

    Po spuštění tohoto příkazu:

    • Pokud ještě není vybraný, vybere workload-set režim aktualizace.
    • Získá sadu úloh, která má zadanou verzi.
    • Ze sady úloh získá verzi manifestu zadané úlohy.
    • Nainstaluje verzi manifestu úlohy.
    • Po dokončení zůstane v workload-set režimu aktualizace.

  4. Zvolte jinou úlohu, která se má nainstalovat, například maui-ios.

  5. dotnet workload install maui-ios

    Tento příkaz nainstaluje maui-ios úlohu pomocí verze sady úloh z verze 9.0.100-preview.7.24414.1sady úloh, protože předchozí install příklad příkazu připnul tuto sadu úloh.

Použití --version se zadaným režimem install aktualizace nebo update připnutím install na zadanou verzi, ale update pouze pro režim aktualizace, nikoli na workload-set konkrétní verzi sady úloh. Pokud pak spustíte dotnet workload update bez --version možnosti, update příkaz:

  • Aktualizuje úlohy na nejnovější dostupnou verzi sady úloh.
  • "Odepnout" install příkaz.
  • Zůstane v workload-set režimu aktualizace.

Aktualizace s využitím nejnovější sady úloh

Pokud chcete aktualizovat nainstalované úlohy na nejnovější verzi sady úloh dostupnou v nakonfigurovaných informačních kanálech, spusťte následující příkazy:

  1. dotnet workload config --update-mode workload-set

    Předchozí příkaz je nezbytný pouze v případě, že jste aktuálně v režimu aktualizace manifestů. Pokud to nevíte, zkontrolujte aktuální režim aktualizace.

  2. dotnet workload update

    V workload-set režimu aktualizace tento příkaz aktualizuje úlohy na nejnovější verzi sady úloh, pokud jste nezadáli verzi sady úloh v global.json.

Aktualizace na verzi sady úloh

Pokud chcete zadat verzi sady úloh, na kterou se má aktualizovat, když ji nezadáte v global.json, použijte --version možnost update příkazu:

  1. Zvolte verzi sady úloh. Například 8.0.400.

  2. dotnet workload update --version 8.0.400

    workload-set Režim aktualizace bude vybrán, pokud ještě nebyl vybraný.

Použití global.json pro verzi sady úloh

global.json Použití souboru k určení verze sady úloh pro úložiště:

  1. Zvolte verzi sady úloh. Například 9.0.100-preview.7.24414.1.

  2. Vytvořte global.json soubor, který vypadá jako v následujícím příkladu:

    {
  "sdk": {
    "workloadVersion": "9.0.100-preview.7.24414.1"
  }
}

S aktuálním adresářem ve stejném úložišti a rozhraním příkazového řádku v workload-set režimu installupdateaktualizace nainstalují příkazy a restore příkazy úlohy pro zadanou verzi sady úloh. Pokud nemáte soubor global.json a jste v workload-set režimu aktualizace, příkaz nainstaluje verzi sady funkcí, restore která byla vytvořena při přechodu z režimu aktualizace manifestů na workload-set režim aktualizace.

Pokud máte v souboru global.json verzi sady úloh, příkazy úloh jsou v workload-set režimu, i když jste příkazy nespustíte config nebo jste použili --version. Soubor global.json je přepíše. Pokud chcete použít --version možnost v takovém případě, spusťte příkaz mimo cestu obsahující soubor global.json.

Pokud v global.json nezadáte verzi sady úloh, můžete tuto možnost použít --version s příkazem restore . V takovém případě restore příkaz před obnovením úloh do zadané verze sady úloh vybere workload-set režim aktualizace.

V režimu restore aktualizace manifestů nainstaluje nebo aktualizuje úlohy na nejnovější verzi jednotlivých úloh.

Kontrola režimu aktualizace a verze

Pokud chcete zobrazit aktuální režim aktualizace, spusťte config příkaz s --update-mode možností bez argumentu. Režim je buď workload-set nebo manifests. Příklad:

dotnet workload config --update-mode

workload-set

Pokud chcete zobrazit aktuální verzi sady úloh, spusťte dotnet workload --versionpříkaz . Pokud je sada úloh nainstalovaná, zobrazí se verze, například 9.0.100-preview.7.24414.1 nebo 8.0.402. Příklad:

dotnet workload --version

9.0.100-preview.7.24414.1

V režimu manifestů nebo pokud verze sady úloh ještě není vytvořená po přepnutí do workload-set režimu aktualizace, zobrazí se verze ve formě <feature band>-manifests.<hash>. Příklad:

dotnet workload --version

9.0.100-manifests.cf958b56

Volba verze sady úloh

Sady úloh se publikují do nuget.org s každou verzí sady .NET SDK v rámci ID Microsoft.NET.Workloads.<feature band>balíčku . Pro stabilní verzi sady SDK existuje vždy odpovídající verze sady funkcí. Sada funkcí 8.0.400 SDK může nainstalovat sadu úloh 8.0.400 a 401 může nainstalovat sadu 401. Obecně doporučujeme nainstalovat odpovídající sadu úloh pro stabilní sadu SDK.

V případě verzí Preview vyhledejte odpovídající verzi sady úloh na kartě README balíčku. Podívejte se například na kartu README pro balíček .NET 9 Preview 7.

V budoucnu uvidíte seznam verzí sady úloh a jejich obsah.

Ignorovat sady úloh

Pokud chcete nainstalovat nebo aktualizovat nejnovější verzi jednotlivých úloh dostupných v nakonfigurovaných informačních kanálech, vyberte a použijte režim aktualizace manifestů spuštěním příkazu úlohy config :

dotnet workload config --update-mode manifests

V sadě .NET 8.0.4xx SDK je výchozí režim manifestů. V této verzi musíte explicitně vybrat režim manifestů pouze v případě, že jste dříve explicitně vybrali workload-set režim aktualizace.

Související obsah