dotnet workload install

  • Artikel

Den här artikeln gäller för: ✔️ .NET 6 SDK och senare versioner

Name

dotnet workload install – Installerar valfria arbetsbelastningar.

Sammanfattning

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

beskrivning

Kommandot dotnet workload install installerar en eller flera valfria arbetsbelastningar. Valfria arbetsbelastningar kan installeras ovanpå .NET SDK för att ge stöd för olika programtyper, till exempel .NET MAUI och Blazor WebAssembly AOT.

När kommandot är i workload-set uppdateringsläge installeras arbetsbelastningsversioner:

  • Kommer från den senaste arbetsbelastningsuppsättningen eller en version av arbetsbelastningsuppsättningen som anges i en global.json eller --version ett alternativ.
  • Kanske inte är den senaste versionen som är tillgänglig för varje enskild arbetsbelastning. Kommandot installerar till exempel install inte en nyare arbetsbelastningsuppsättning om du tidigare använde --version flaggan.

Mer information finns i .NET SDK-arbetsbelastningsuppsättningar. workload-set uppdateringsläget är tillgängligt sedan 8.0.400 SDK.

Använd dotnet-arbetsbelastningssökning för att lära dig vilka arbetsbelastningar som är tillgängliga att installera.

När förhöjd körning ska köras

För macOS- och Linux SDK-installationer som är installerade i en skyddad katalog måste kommandot köras förhöjt (använd sudo kommandot). I Windows behöver kommandot inte köras förhöjt även om SDK:t är installerat i katalogen Programfiler . För Windows använder kommandot MSI-installationsprogram för den platsen.

Resultaten varierar beroende på SDK-version

Kommandona dotnet workload fungerar i kontexten för specifika SDK-versioner. Anta att du har både .NET 6.0.100 SDK och .NET 6.0.200 SDK installerat. Kommandona dotnet workload ger olika resultat beroende på vilken SDK-version du väljer. Det här beteendet gäller för större och mindre skillnader i version och funktionsband, inte för korrigering av versionsskillnader. Till exempel ger .NET SDK 6.0.101 och 6.0.102 samma resultat, medan 6.0.100 och 6.0.200 ger olika resultat. Du kan ange SDK-versionen med hjälp av filen global.json.

Reklammanifest

Namnen och versionerna av de tillgångar som en arbetsbelastningsinstallation kräver underhålls i manifest. Som standard dotnet workload install laddar kommandot ned de senaste tillgängliga manifesten innan en arbetsbelastning installeras. Den lokala kopian av ett manifest innehåller sedan den information som behövs för att hitta och ladda ned tillgångarna för en arbetsbelastning.

Kommandot dotnet workload list jämför versionerna av installerade arbetsbelastningar med de tillgängliga versionerna. När den upptäcker att en version som är nyare än den installerade versionen är tillgänglig annonserar den det faktumet i kommandoutdata. Dessa nyare versionsmeddelanden i dotnet workload list är tillgängliga från och med .NET 6.

För att aktivera dessa meddelanden laddas de senaste tillgängliga versionerna av manifesten ned och lagras som reklammanifest. Dessa nedladdningar sker asynkront i bakgrunden när något av följande kommandon körs.

Om ett kommando slutförs innan manifesthämtningen är klar stoppas nedladdningen. Nedladdningen görs igen nästa gång ett av dessa kommandon körs. Du kan ange miljövariabler för att inaktivera dessa bakgrundsnedladdningar eller kontrollera deras frekvens. Som standard sker de inte mer än en gång om dagen.

Du kan förhindra att dotnet workload install kommandot gör manifestnedladdningar med hjälp --skip-manifest-update av alternativet .

Kommandot dotnet workload update laddar också ned reklammanifest. Nedladdningarna krävs för att ta reda på om en uppdatering är tillgänglig, så det finns inget alternativ för att hindra dem från att köras. Du kan dock använda --advertising-manifests-only alternativet för att hoppa över arbetsbelastningsuppdateringar och endast göra manifestnedladdningarna. Det här alternativet är tillgängligt från och med .NET 6.

Argument

  • WORKLOAD_ID...

    Det arbetsbelastnings-ID eller flera ID:t som ska installeras. Använd dotnet-arbetsbelastningssökning för att lära dig vilka arbetsbelastningar som är tillgängliga.

Alternativ

  • --configfile <FILE>

    NuGet-konfigurationsfilen (nuget.config) som ska användas. Om det anges används endast inställningarna från den här filen. Om det inte anges används hierarkin för konfigurationsfiler från den aktuella katalogen. Mer information finns i Vanliga NuGet-konfigurationer.

  • --disable-parallel

    Förhindrar att flera projekt återställs parallellt.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

  • --ignore-failed-sources

    Behandlar paketkällans fel som varningar.

  • --include-previews

    Tillåter arbetsbelastningsmanifest i förväg.

  • --interactive

    Tillåter att kommandot stoppar och väntar på användarens indata eller åtgärd. Till exempel för att slutföra autentiseringen.

  • --no-cache

    Förhindrar cachelagring av paket och http-begäranden.

  • --skip-manifest-update

    Hoppa över att uppdatera arbetsbelastningsmanifesten. Arbetsbelastningsmanifesten definierar vilka tillgångar och versioner som måste installeras för varje arbetsbelastning.

  • -s|--source <SOURCE>

    Anger URI:n för NuGet-paketkällan som ska användas. Den här inställningen åsidosätter alla källor som anges i nuget.config-filerna . Flera källor kan tillhandahållas genom att ange det här alternativet flera gånger.

  • --temp-dir <PATH>

    Ange den temporära katalog som används för att ladda ned och extrahera NuGet-paket (måste vara säker).

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är minimal. Om du anger detailed eller diagnostic utförligt visar kommandot information om De Nuget-paket som hämtas.

  • --version

    Arbetsbelastningen anger vilken version som ska installeras eller uppdateras till. Om du anger arbetsbelastningsuppsättningsversionen i global.json kan du inte använda --version alternativet för att ange arbetsbelastningsuppsättningsversionen. Om du vill göra det möjligt att använda --version alternativet i så fall kör du kommandot utanför sökvägen som innehåller global.json-filen. Tillgänglig sedan 8.0.400 SDK. Mer information finns i .NET SDK-arbetsbelastningsuppsättningar.

Exempel

  • Installera arbetsbelastningen maui :

    dotnet workload install maui

  • Installera arbetsbelastningarna maui-android och maui-ios :

    dotnet workload install maui-android maui-ios