dotnet workload install

Cet article s’applique à : ✔️ SDK .NET 6 et versions ultérieures

Nom

dotnet workload install - Installe des charges de travail facultatives.

Synopsis

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

Description

La commande dotnet workload install installe une ou plusieurs charges de travail facultatives. Les charges de travail facultatives peuvent être installées sur le SDK .NET pour assurer la prise en charge de différents types d’applications, tels que .NET MAUI et Blazor WebAssembly AOT.

Lorsque la commande est en workload-set mode mise à jour, les versions de charge de travail sont installées :

• Proviennent du dernier jeu de charges de travail ou d’une version de jeu de charges de travail spécifiée dans une global.json ou --version une option.
• Il peut ne pas s’agir de la dernière version disponible de chaque charge de travail individuelle. Par exemple, la install commande n’installe pas un jeu de charges de travail plus récent si vous avez précédemment utilisé l’indicateur --version .

Pour plus d’informations, consultez les ensembles de charges de travail du Kit de développement logiciel (SDK) .NET. workload-set le mode de mise à jour est disponible depuis le Kit de développement logiciel (SDK) 8.0.400.

Utilisez dotnet workload search pour découvrir les charges de travail disponibles pour l’installation.

Quand l’exécuter avec des privilèges élevés

Pour les installations du SDK macOS et Linux installées dans un répertoire protégé, la commande doit être exécutée avec des privilèges élevés (utilisez la commande sudo). Sur Windows, la commande n’a pas besoin d’être exécutée avec des privilèges élevés, même si le SDK est installé dans le répertoire Program Files. Pour Windows, la commande utilise des programmes d’installation MSI pour cet emplacement.

Les résultats varient selon la version du SDK

Les commandes dotnet workload fonctionnent dans le contexte de versions spécifiques du SDK. Supposons que vous ayez installé le SDK .NET 6.0.100 et le SDK .NET 6.0.200. Les commandes dotnet workload donnent des résultats différents en fonction de la version que vous sélectionnez du SDK. Ce comportement s’applique aux différences de version majeure et mineure et de plage de fonctionnalités, et non aux différences de version corrective. Par exemple, les SDK .NET 6.0.101 et 6.0.102 donnent les mêmes résultats, tandis que 6.0.100 et 6.0.200 donnent des résultats différents. Vous pouvez spécifier la version du Kit de développement logiciel (SDK) en utilisant le fichier global.json.

Manifestes publicitaires

Les noms et versions des ressources requises par une installation de charge de travail sont conservés dans les manifestes. Par défaut, la commande dotnet workload install télécharge les derniers manifestes disponibles avant d’installer une charge de travail. La copie locale d’un manifeste fournit ensuite les informations nécessaires pour rechercher et télécharger les ressources d’une charge de travail.

La commande dotnet workload list compare les versions des charges de travail installées aux versions actuellement disponibles. Lorsqu’il trouve qu’une version plus récente que la version installée est disponible, elle publie ce fait dans la sortie de commande. Ces notifications de version plus récente dans dotnet workload list sont disponibles à partir de .NET 6.

Pour activer ces notifications, les dernières versions disponibles des manifestes sont téléchargées et stockées en tant que manifestes publicitaires. Ces téléchargements se produisent de manière asynchrone en arrière-plan quand l’une des commandes suivantes est exécutée.

• dotnet build
• dotnet pack
• dotnet publish
• dotnet restore
• dotnet run
• dotnet test

Si une commande se termine avant la fin du téléchargement du manifeste, le téléchargement est arrêté. Le téléchargement est réessayé la prochaine fois que l’une de ces commandes est exécutée. Vous pouvez définir des variables d’environnement pour désactiver ces téléchargements en arrière-plan ou contrôler leur fréquence. Par défaut, ils ne se produisent pas plus d’une fois par jour.

Vous pouvez empêcher la commande dotnet workload install d’effectuer des téléchargements de manifeste à l’aide de l’option --skip-manifest-update.

La commande dotnet workload update télécharge également les manifestes publicitaires. Les téléchargements sont nécessaires pour savoir si une mise à jour est disponible, aussi il n’existe aucune option pour empêcher leur exécution. Vous pouvez toutefois utiliser l’option --advertising-manifests-only permettant d’ignorer les mises à jour de charge de travail et de procéder uniquement aux téléchargements de manifeste. Cette option est disponible à partir de .NET 6.

Arguments

• WORKLOAD_ID...

  ID de charge de travail ou ID multiples à installer. Utilisez dotnet workload search pour découvrir les charges de travail disponibles.

Options

• --configfile <FILE>

  Fichier de configuration NuGet (nuget.config) à utiliser. S’ils sont spécifiés, seuls les paramètres de ce fichier seront utilisés. Si elle n’est pas spécifiée, la hiérarchie des fichiers de configuration du répertoire actuel sera utilisée. Pour plus d’informations, consultez Configuration NuGet courantes.

• --disable-parallel

  Empêche la restauration de plusieurs projets en parallèle.

• -?|-h|--help

  Affiche une description de l’utilisation de la commande.

• --ignore-failed-sources

  Traite les échecs de la source du package comme des avertissements.

• --include-previews

  Autorise les manifestes de charge de travail de préversion.

• --interactive

  Permet à la commande de s’arrêter et d’attendre une action ou une entrée utilisateur. Par exemple, pour effectuer une authentification.

• --no-cache

  Empêche la mise en cache des packages et des requêtes HTTP.

• --skip-manifest-update

  Ignore la mise à jour des manifestes de charge de travail. Les manifestes de charge de travail définissent les ressources et versions à installer pour chaque charge de travail.

• -s|--source <SOURCE>

  Spécifie l’URI de la source de package NuGet à utiliser. Ce paramètre remplace toutes les sources spécifiées dans les fichiers nuget.config. Vous pouvez spécifier plusieurs sources en spécifiant cette option plusieurs fois.

• --temp-dir <PATH>

  Spécifiez le répertoire temporaire utilisé pour télécharger et extraire des packages NuGet (doit être sécurisé).

• -v|--verbosity <LEVEL>

  Définit le niveau de détail de la commande. Les valeurs autorisées sont q[uiet], m[inimal], n[ormal], d[etailed] et diag[nostic]. Par défaut, il s’agit de minimal. Si vous spécifiez la verbosité detailed ou diagnostic, la commande affiche des informations sur les packages Nuget qu’il télécharge.

• --version

  Version définie par la charge de travail à installer ou à mettre à jour. Si vous spécifiez la version du jeu de charges de travail dans global.json, vous ne pouvez pas utiliser l’option --version pour spécifier la version du jeu de charges de travail. Pour permettre d’utiliser l’option --version dans ce cas, exécutez la commande en dehors du chemin contenant le fichier global.json. Disponible depuis le Kit de développement logiciel (SDK) 8.0.400. Pour plus d’informations, consultez les ensembles de charges de travail du Kit de développement logiciel (SDK) .NET.

Exemples

• Installer la charge de travail maui :

  dotnet workload install maui
  

• Installer les charges de travail maui-ios et maui-android :

  dotnet workload install maui-android maui-ios