Udostępnij za pośrednictwem

Zestawy obciążeń zestawu SDK platformy .NET

  • Artykuł

Funkcja zestawów obciążeń udostępnia numer wersji reprezentujący grupę obciążeń zestawu SDK platformy .NET. Polecenia instalacji, aktualizacji i przywracania używają tego numeru w trybie aktualizacji zestawu obciążeń, aby zapewnić następujące korzyści:

  • Kontrolujesz tempo zmian dla zainstalowanych wersji obciążeń. Alternatywny tryb operacji bez używania zestawów obciążeń jest nazywany luźnym trybem aktualizacji manifestów. W tym trybie obciążenia są aktualizowane automatycznie, ponieważ nowe wersje poszczególnych obciążeń są zwalniane na wszystkie skonfigurowane źródła danych NuGet. W workload-set trybie aktualizacji obciążenia pozostają w określonej wersji zestawu obciążeń do momentu jawnej zmiany tej wersji.
  • Można zainstalować i zaktualizować kombinację wersji obciążenia, które są dostarczane w tym samym czasie i są znane ze współpracy.
  • Możesz mieć pewność, że wszyscy członkowie zespołu zawsze pracują nad tymi samymi wersjami obciążeń.
  • Nie musisz używać pliku wycofywania, aby określić, jaka wersja obciążenia ma być włączona.

Poniżej przedstawiono kilka sposobów używania zestawów obciążeń:

  • "Przypnij" install polecenie do określonej wersji zestawu obciążeń.
  • Zaktualizuj zainstalowane obciążenia do najnowszej dostępnej wersji zestawu obciążeń.
  • Przeprowadź aktualizację do określonej wersji zestawu obciążeń.
  • Określ wersję zestawu obciążeń w global.json.
  • Sprawdź bieżący tryb aktualizacji i wersję zestawu obciążeń.

Nadal możesz zdecydować się na zainstalowanie, zaktualizowanie lub przywrócenie do najnowszej wersji poszczególnych obciążeń, ignorując zestawy obciążeń.

Wymagania wstępne

  • Zestaw .NET 8.0.400 SDK lub nowszy.

    W zestawie SDK w wersji 8.0.400 polecenia są w trybie aktualizacji zestawu obciążeń tylko wtedy, dotnet workload gdy jest jawnie zaznaczone.

"Przypnij" polecenie instalacji

Polecenie dotnet workload install z opcją --version "przypina" install polecenie w workload-set trybie aktualizacji z określoną wersją zestawu obciążeń. Polecenie nie instaluje już automatycznie najnowszego obciążenia na podstawie luźnych manifestów.

Aby "przypiąć install " polecenie:

  1. Wybierz wersję zestawu obciążeń. Na przykład 9.0.100-preview.7.24414.1.

  2. Wybierz obciążenie. Na przykład aspire.

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

    Po uruchomieniu tego polecenia:

    • Wybiera workload-set tryb aktualizacji, jeśli nie został jeszcze wybrany.
    • Pobiera zestaw obciążeń, który ma określoną wersję.
    • Z zestawu obciążeń pobiera wersję manifestu określonego obciążenia.
    • Instaluje wersję manifestu obciążenia.
    • Po zakończeniu pozostaje w workload-set trybie aktualizacji.

  4. Wybierz inne obciążenie do zainstalowania, takie jak maui-ios.

  5. dotnet workload install maui-ios

    To polecenie instaluje maui-ios obciążenie przy użyciu wersji obciążenia z wersji 9.0.100-preview.7.24414.1zestawu obciążeń, ponieważ poprzedni install przykład polecenia przypiął ten zestaw obciążeń.

Przy użyciu --version polecenia install lub update przypinania install do określonej wersji, ale update jest skonfigurowany tylko do workload-set trybu aktualizacji, a nie do określonej wersji zestawu obciążeń. Jeśli następnie uruchomisz dotnet workload update polecenie bez --version opcji:update

  • Aktualizuje obciążenia do najnowszej dostępnej wersji zestawu obciążeń.
  • Polecenie "Odepnij".install
  • Pozostaje w workload-set trybie aktualizacji.

Aktualizowanie przy użyciu najnowszego zestawu obciążeń

Aby zaktualizować zainstalowane obciążenia do najnowszej wersji zestawu obciążeń dostępnej w skonfigurowanych kanałach informacyjnych, uruchom następujące polecenia:

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

    Poprzednie polecenie jest konieczne tylko wtedy, gdy obecnie jesteś w trybie aktualizacji manifestów. Jeśli nie wiesz, sprawdź bieżący tryb aktualizacji.

  2. dotnet workload update

    W workload-set trybie aktualizacji to polecenie aktualizuje obciążenia do najnowszej wersji zestawu obciążeń, chyba że określono wersję zestawu obciążeń w global.json.

Aktualizacja do wersji zestawu obciążeń

Aby określić wersję zestawu obciążeń do aktualizacji, jeśli nie określono jej w global.json, użyj --version opcji update polecenia:

  1. Wybierz wersję zestawu obciążeń. Na przykład 8.0.400.

  2. dotnet workload update --version 8.0.400

workload-set Tryb aktualizacji zostanie wybrany, jeśli nie został jeszcze wybrany.

Użyj global.json dla wersji zestawu obciążeń

Aby użyć global.json pliku do określenia wersji zestawu obciążeń dla repozytorium:

  1. Wybierz wersję zestawu obciążeń. Na przykład 9.0.100-preview.7.24414.1.

  2. global.json Utwórz plik, który wygląda podobnie do następującego przykładu:

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

W bieżącym katalogu w tym samym repozytorium i interfejsie wiersza polecenia w workload-set trybie installaktualizacji polecenia , updatei restore instalują obciążenia dla określonej wersji zestawu obciążeń. Jeśli nie masz pliku global.json i jesteś w workload-set trybie aktualizacji, restore polecenie instaluje wersję zestawu obciążeń, która została ustanowiona po przełączeniu z trybu aktualizacji manifestów na workload-set tryb aktualizacji.

Jeśli masz wersję zestawu obciążeń w pliku global.json, polecenia obciążenia są w workload-set trybie, nawet jeśli nie uruchomiono config polecenia lub użyto --versionpolecenia . Plik global.json zastępuje te wartości. Aby użyć --version opcji w tym przypadku, uruchom polecenie poza ścieżką zawierającą plik global.json.

Jeśli nie określisz wersji zestawu obciążeń w global.json, możesz użyć --version opcji z komandem restore . W takim przypadku restore polecenie wybiera workload-set tryb aktualizacji, zanim przywróci obciążenia do określonej wersji zestawu obciążeń.

W trybie restore aktualizacji manifestów instaluje lub aktualizuje obciążenia do najnowszej wersji poszczególnych obciążeń.

Sprawdzanie trybu aktualizacji i wersji

Aby wyświetlić bieżący tryb aktualizacji, uruchom config polecenie z opcją --update-mode bez argumentu. Tryb to manifesty zestawuorobciążeń". Na przykład:

dotnet workload config --update-mode

workload-set

Aby wyświetlić bieżącą wersję zestawu obciążeń, uruchom polecenie dotnet workload --version. Jeśli zestaw obciążeń jest zainstalowany, zostanie wyświetlona wersja, taka jak 9.0.100-preview.7.24414.1 lub 8.0.402. Na przykład:

dotnet workload --version

9.0.100-preview.7.24414.1

W trybie manifestów lub jeśli wersja zestawu obciążeń nie została jeszcze ustanowiona po przełączeniu do workload-set trybu aktualizacji, zostanie wyświetlona wersja w postaci <feature band>-manifests.<hash>. Na przykład:

dotnet workload --version

9.0.100-manifests.cf958b56

Wybieranie wersji zestawu obciążeń

Zestawy obciążeń są publikowane w celu nuget.org z każdą wersją zestawu .NET SDK w ramach identyfikatora Microsoft.NET.Workloads.<feature band>pakietu . W przypadku stabilnej wersji zestawu SDK planujemy zawsze mieć zgodną wersję zestawu obciążeń. Dlatego zestaw SDK 8.0.400 może zainstalować zestaw roboczy 8.0.400, zestaw 401 może zainstalować zestaw 401. Ogólnie rzecz biorąc, zalecamy zainstalowanie pasującego zestawu roboczego dla stabilnego zestawu SDK.

W przypadku wersji zapoznawczych znajdź odpowiednią wersję zestawu obciążeń na karcie README pakietu. Na przykład zobacz kartę README pakietu .NET 9 (wersja zapoznawcza 7).

Jest to wersja zapoznawcza. W przyszłości udostępnimy sposoby wyświetlania listy wersji zestawu obciążeń, aby zobaczyć, co jest dostępne i co zawierają.

Ignoruj zestawy obciążeń

Aby zainstalować lub przeprowadzić aktualizację do najnowszej wersji poszczególnych obciążeń dostępnych w skonfigurowanych kanałach informacyjnych, wybierz tryb aktualizacji manifestów i użyj go, uruchamiając polecenie obciążenia config :

dotnet workload config --update-mode manifests

W zestawie SDK platformy .NET 8.0.4xx tryb manifestów jest domyślny. Należy wybrać tryb manifestów jawnie tylko wtedy, gdy wcześniej jawnie wybrano workload-set tryb aktualizacji.

Powiązana zawartość