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 poleceniem 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 ma wartość workload-set lub manifests. 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 zawsze jest zgodna wersja zestawu obciążeń. Dlatego zestaw SDK 8.0.400 może zainstalować zestaw roboczy 8.0.400, a 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).

W przyszłości będzie można wyświetlić listę wersji zestawu obciążeń i ich zawartości.

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. W tej wersji należy jawnie wybrać tryb manifestów tylko wtedy, gdy wcześniej wybrano workload-set jawnie tryb aktualizacji.

Powiązana zawartość