dotnet workload install

  • Article

Cet article s’applique à : ✔️ SDK .NET Core 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>]

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.

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.

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.

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