dotnet-arbetsbelastningsinstallation
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>]
dotnet workload install -?|-h|--help
Description
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.
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]
ochdiag[nostic]
. Standardvärdet ärminimal
. Om du angerdetailed
ellerdiagnostic
utförligt visar kommandot information om De Nuget-paket som hämtas.
Exempel
Installera arbetsbelastningen
maui
:dotnet workload install maui
Installera arbetsbelastningarna
maui-android
ochmaui-ios
:dotnet workload install maui-android maui-ios
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för