Dela via

.NET SDK-arbetsbelastningsuppsättningar

  • Artikel

Funktionen för arbetsbelastningsuppsättningar innehåller ett versionsnummer som representerar en grupp .NET SDK-arbetsbelastningar. Installations-, uppdaterings- och återställningskommandona använder det här numret i uppdateringsläge för arbetsbelastningsuppsättningar för att ge följande fördelar:

  • Du styr ändringsfrekvensen för installerade arbetsbelastningsversioner. Det alternativa driftsläget utan att använda arbetsbelastningsuppsättningar kallas för uppdateringsläge för lösa manifest. I det här läget uppdateras arbetsbelastningar automatiskt när nya versioner av enskilda arbetsbelastningar släpps till alla konfigurerade NuGet-feeds. I workload-set uppdateringsläge finns arbetsbelastningarna kvar i en viss version av arbetsbelastningsuppsättningen tills du uttryckligen ändrar den versionen.
  • Du kan installera och uppdatera en kombination av arbetsbelastningsversioner som levereras samtidigt och som är kända för att fungera tillsammans.
  • Du kan se till att alla i teamet alltid arbetar med samma arbetsbelastningsversioner.
  • Du behöver inte använda en återställningsfil för att ange vilken arbetsbelastningsversion du vill använda.

Här följer några sätt att använda arbetsbelastningsuppsättningar:

  • "Fäst" kommandot på install en specifik version av arbetsbelastningsuppsättningen.
  • Uppdatera installerade arbetsbelastningar till den senaste tillgängliga versionen av arbetsbelastningsuppsättningen.
  • Uppdatera till en angiven version av arbetsbelastningsuppsättningen.
  • Ange arbetsbelastningsuppsättningsversionen i global.json.
  • Kontrollera din aktuella uppdateringsläge och arbetsbelastningsuppsättningsversion.

Och du kan fortfarande välja att installera, uppdatera eller återställa till den senaste versionen av varje enskild arbetsbelastning och ignorera arbetsbelastningsuppsättningar.

Förutsättningar

  • .NET 8.0.400 SDK eller senare.

    I 8.0.400 SDK dotnet workload är kommandona endast i uppdateringsläge för arbetsbelastningsuppsättningar när de uttryckligen har valts.

"Fäst" installationskommandot

Ett dotnet workload install kommando med --version alternativet "fäster" install kommandot i workload-set uppdateringsläge med den angivna versionen av arbetsbelastningsuppsättningen. Kommandot installerar inte längre automatiskt den senaste arbetsbelastningen baserat på lösa manifest.

Så här "fäster" install du kommandot:

  1. Välj en version av arbetsbelastningsuppsättningen. Exempel: 9.0.100-preview.7.24414.1

  2. Välj en arbetsbelastning. Exempel: aspire

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

    När det här kommandot körs:

    • Den väljer uppdateringsläge workload-set om det inte redan är valt.
    • Den hämtar den arbetsbelastningsuppsättning som har den angivna versionen.
    • Från arbetsbelastningsuppsättningen hämtas manifestversionen av den angivna arbetsbelastningen.
    • Den installerar manifestversionen av arbetsbelastningen.
    • Den förblir i workload-set uppdateringsläge när den är klar.

  4. Välj en annan arbetsbelastning att installera, till exempel maui-ios.

  5. dotnet workload install maui-ios

    Det här kommandot installerar arbetsbelastningen maui-ios med hjälp av arbetsbelastningsversionen från arbetsbelastningsuppsättningsversionen 9.0.100-preview.7.24414.1, eftersom föregående install kommandoexempel har fäst den arbetsbelastningsuppsättningen.

Använda --version med antingen install eller update fäster install till den angivna versionen, men update är endast konfigurerad för workload-set uppdateringsläge, inte till en specifik version av arbetsbelastningsuppsättningen. Om du sedan kör dotnet workload update utan --version alternativet, update kommandot:

  • Uppdaterar arbetsbelastningar till den senaste tillgängliga versionen av arbetsbelastningsuppsättningen.
  • "Ta bort" install kommandot.
  • Förblir i workload-set uppdateringsläge.

Uppdatera med den senaste arbetsbelastningsuppsättningen

Kör följande kommandon för att uppdatera installerade arbetsbelastningar till den senaste versionen av arbetsbelastningsuppsättningen som är tillgänglig i de konfigurerade flödena:

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

    Föregående kommando är endast nödvändigt om du för närvarande är i uppdateringsläge för manifest. Om du inte vet kontrollerar du det aktuella uppdateringsläget.

  2. dotnet workload update

    I workload-set uppdateringsläge uppdaterar det här kommandot arbetsbelastningarna till den senaste versionen av arbetsbelastningsuppsättningen, såvida du inte har angett arbetsbelastningsuppsättningsversionen i global.json.

Uppdatera till en version av arbetsbelastningsuppsättningen

Om du vill ange en arbetsbelastningsuppsättningsversion som ska uppdateras till när du inte anger den i global.json använder --version du alternativet för update kommandot:

  1. Välj en version av arbetsbelastningsuppsättningen. Exempel: 8.0.400

  2. dotnet workload update --version 8.0.400

    workload-set uppdateringsläget väljs om det inte redan har valts.

Använda global.json för arbetsbelastningsuppsättningsversionen

Så här använder du en global.json fil för att ange arbetsbelastningsuppsättningsversionen för en lagringsplats:

  1. Välj en version av arbetsbelastningsuppsättningen. Exempel: 9.0.100-preview.7.24414.1

  2. Skapa en global.json fil som ser ut som i följande exempel:

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

Med den aktuella katalogen på samma lagringsplats och CLI i workload-set uppdateringsläge installinstallerar kommandona , updateoch restore arbetsbelastningar för den angivna versionen av arbetsbelastningsuppsättningen. Om du inte har en global.json fil och du är i workload-set uppdateringsläge restore installerar kommandot den version av arbetsbelastningsuppsättningen som upprättades när du bytte från manifestuppdateringsläge till workload-set uppdateringsläge.

Om du har en version av arbetsbelastningsuppsättningen i filen global.json är arbetsbelastningskommandona i workload-set läge även om du inte har kört config kommandot eller använt --version. Filen global.json åsidosätter dem. Om du vill använda alternativet --version i så fall kör du kommandot utanför sökvägen som innehåller global.json-filen.

Om du inte anger arbetsbelastningsuppsättningsversionen i global.json kan du använda --version alternativet med restore kommandot . I så fall restore väljer kommandot uppdateringsläge workload-set innan arbetsbelastningarna återställs till den angivna versionen av arbetsbelastningsuppsättningen.

I manifestuppdateringsläge restore installerar eller uppdaterar arbetsbelastningar till den senaste versionen av varje enskild arbetsbelastning.

Kontrollera uppdateringsläget och versionen

Om du vill se aktuellt uppdateringsläge kör config du kommandot med --update-mode alternativet utan argument. Läget är antingen workload-set eller manifests. Till exempel:

dotnet workload config --update-mode

workload-set

Om du vill se den aktuella versionen av arbetsbelastningsuppsättningen kör du dotnet workload --version. Om en arbetsbelastningsuppsättning är installerad visas en version som 9.0.100-preview.7.24414.1 eller 8.0.402. Till exempel:

dotnet workload --version

9.0.100-preview.7.24414.1

I manifestläge, eller om arbetsbelastningsuppsättningsversionen inte har upprättats ännu efter att du har växlat till workload-set uppdateringsläge, ser du en version i form av <feature band>-manifests.<hash>. Till exempel:

dotnet workload --version

9.0.100-manifests.cf958b56

Välj en version av arbetsbelastningsuppsättningen

Arbetsbelastningsuppsättningar publiceras till nuget.org med varje version av .NET SDK under paket-ID: t Microsoft.NET.Workloads.<feature band>. För en stabil version av SDK:t finns det alltid en matchande version av arbetsbelastningsuppsättningen. Så 8.0.400 SDK kan installera en arbetsbelastningsuppsättning på 8.0.400 och 401 kan installera en 401-uppsättning. I allmänhet rekommenderar vi att du installerar matchande arbetsbelastningsuppsättning för en stabil SDK.

För förhandsversioner hittar du motsvarande version av arbetsbelastningsuppsättningen på paketets README-flik. Se till exempel fliken README för .NET 9 Preview 7-paketet.

I framtiden kommer du att kunna se en lista över arbetsbelastningsuppsättningsversioner och vad de innehåller.

Ignorera arbetsbelastningsuppsättningar

Om du vill installera eller uppdatera till den senaste versionen av varje enskild arbetsbelastning som är tillgänglig i de konfigurerade flödena väljer du och använder manifestuppdateringsläget genom att köra arbetsbelastningskommandot config :

dotnet workload config --update-mode manifests

I .NET 8.0.4xx SDK är manifestläget standard. I den här versionen behöver du bara välja manifestläge explicit om du tidigare uttryckligen valde uppdateringsläge workload-set .

Relaterat innehåll