Tutorial: Instalación y uso de una herramienta global de .NET mediante la CLI de .NET

Este artículo se aplica a: ✔️ sdk de .NET 8 y versiones posteriores

En este tutorial se muestra cómo instalar y usar una herramienta global. La herramienta que usa es la que se crea en el primer tutorial de esta serie.

Prerrequisitos

• Complete el primer tutorial de esta serie.
• SDK de .NET 10.0.100 o posterior (para dnx): opcional, pero recomendado.

Ejecutar la herramienta sin instalación (recomendado)

A partir de .NET 10.0.100, puede ejecutar herramientas de .NET sin instalación permanente mediante dnx:

1. Ejecute la herramienta directamente mediante dnx (sintaxis simplificada):

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

   El parámetro --add-source indica a la CLI de .NET que use el directorio ./nupkg como fuente de origen adicional para paquetes NuGet cuando la herramienta no está disponible en NuGet.org.

Uso de la herramienta como herramienta global (instalación tradicional)

Si prefiere la instalación permanente para uso frecuente:

1. Instale la herramienta desde el paquete ejecutando el comando dotnet tool install en la carpeta del proyecto dotnet-env :

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

   El parámetro --global indica a la CLI de .NET que instale los archivos binarios de herramientas en una ubicación predeterminada que se agrega automáticamente a la variable de entorno PATH.

   El --add-source parámetro indica a la CLI de .NET que use temporalmente el directorio ./nupkg como fuente de origen adicional para paquetes NuGet. Ha asignado un nombre único al paquete para asegurarse de que solo se encuentra en el directorio ./nupkg , no en NuGet.org.

   La salida muestra el comando usado para llamar a la herramienta y la versión instalada:

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

   Nota:

   De manera predeterminada, la arquitectura de los binarios .NET que se van a instalar representa la arquitectura del sistema operativo que se está ejecutando en ese momento. Para especificar una arquitectura de SO diferente, consulta dotnet tool install, --arch option.

2. Invoque la herramienta:

   dotnet-env
   

   Nota:

   Si se produce un error en el comando, abra un nuevo terminal para actualizar la variable de PATH entorno.

3. Quite la herramienta ejecutando el comando dotnet tool uninstall :

   dotnet tool uninstall -g dotnet-env
   

Uso de la herramienta como herramienta global instalada en una ubicación personalizada

1. Instale la herramienta desde el paquete.

   En Windows:

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

   En Linux o macOS:

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

   El --tool-path parámetro indica a la CLI de .NET que instale los archivos binarios de herramientas en la ubicación especificada. Si el directorio no existe, se crea. El directorio no se agrega automáticamente a la variable de PATH entorno.

   La salida muestra el comando usado para llamar a la herramienta y la versión instalada:

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

2. Invoque la herramienta:

   En Windows:

   c:\dotnet-tools\dotnet-env
   

   En Linux o macOS:

   ~/bin/dotnet-env
   

3. Quite la herramienta ejecutando el comando dotnet tool uninstall :

   En Windows:

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

   En Linux o macOS:

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

Troubleshoot

Si recibe un mensaje de error al seguir el tutorial, consulte Solución de problemas de uso de herramientas de .NET.

Pasos siguientes

En este tutorial, ha instalado y usado una herramienta como una herramienta global. Para obtener más información sobre cómo instalar y usar herramientas globales, consulte Administración de herramientas globales. Para instalar y usar la misma herramienta que una herramienta local, avance al siguiente tutorial.