Tutoriel : Installer et utiliser un outil global .NET à l’aide de l’interface CLI .NET

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

Ce tutoriel vous montre comment installer et utiliser un outil global. L’outil que vous utilisez est celui que vous créez dans le premier tutoriel de cette série.

Prerequisites

À compter de .NET 10.0.100, vous pouvez exécuter des outils .NET sans installation permanente à l’aide dnxde :

  1. Exécutez l’outil directement à l’aide de dnx (syntaxe simplifiée) :

    dnx dotnet-env --add-source ./nupkg

    Le paramètre --add-source indique à l'interface CLI .NET d'utiliser le répertoire ./nupkg comme flux source supplémentaire pour les packages NuGet lorsque l'outil n'est pas disponible sur NuGet.org.

Utiliser l’outil comme outil global (installation traditionnelle)

Si vous préférez une installation permanente pour une utilisation fréquente :

  1. Installez l’outil à partir du package en exécutant la commande d’installation de l’outil dotnet dans le dossier du projet dotnet-env :

    dotnet tool install --global --add-source ./nupkg dotnet-env

    Le paramètre --global indique à l'interface CLI .NET d'installer les fichiers binaires d'outils dans un emplacement par défaut automatiquement ajouté à la variable d'environnement PATH.

    Le --add-source paramètre indique à l’interface CLI .NET d’utiliser temporairement le répertoire ./nupkg comme flux source supplémentaire pour les packages NuGet. Vous avez donné à votre package un nom unique pour vous assurer qu’il se trouve uniquement dans le répertoire ./nupkg , et non sur NuGet.org.

    La sortie affiche la commande utilisée pour appeler l’outil et la version installée :

    You can invoke the tool using the following command: dotnet-env
Tool 'dotnet-env' (version '1.0.0') was successfully installed.

    Note

    Par défaut, l’architecture des fichiers binaires .NET à installer représente l’architecture du système d’exploitation en cours d’exécution. Pour spécifier une architecture de système d’exploitation différente, consultez dotnet tool install, --arch option.

  2. Appelez l’outil :

    dotnet-env

    Note

    Si la commande échoue, ouvrez un nouveau terminal pour actualiser la variable d’environnement PATH .

  3. Supprimez l’outil en exécutant la commande dotnet tool uninstall :

    dotnet tool uninstall -g dotnet-env

Utiliser l’outil comme outil global installé dans un emplacement personnalisé

  1. Installez l’outil à partir du package.

    Sur Windows :

    dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg dotnet-env

    Sur Linux ou macOS :

    dotnet tool install --tool-path ~/bin --add-source ./nupkg dotnet-env

    Le --tool-path paramètre indique à l’interface CLI .NET d’installer les fichiers binaires d’outils à l’emplacement spécifié. Si le répertoire n’existe pas, il est créé. Le répertoire n’est pas automatiquement ajouté à la variable d’environnement PATH .

    La sortie affiche la commande utilisée pour appeler l’outil et la version installée :

    You can invoke the tool using the following command: dotnet-env
Tool 'dotnet-env' (version '1.0.0') was successfully installed.

  2. Appelez l’outil :

    Sur Windows :

    c:\dotnet-tools\dotnet-env

    Sur Linux ou macOS :

    ~/bin/dotnet-env

  3. Supprimez l’outil en exécutant la commande dotnet tool uninstall :

    Sur Windows :

    dotnet tool uninstall --tool-path c:\dotnet-tools dotnet-env

    Sur Linux ou macOS :

    dotnet tool uninstall --tool-path ~/bin dotnet-env

Troubleshoot

Si vous recevez un message d’erreur en suivant le tutoriel, consultez Résoudre les problèmes d’utilisation de l’outil .NET.

Étapes suivantes

Dans ce tutoriel, vous avez installé et utilisé un outil comme outil global. Pour plus d’informations sur l’installation et l’utilisation d’outils globaux, consultez Gestion des outils globaux. Pour installer et utiliser le même outil qu’un outil local, passez au didacticiel suivant.

Installer et utiliser des outils locaux

  • Last updated on