dotnet tool install

Este artículo se aplica a: ✔️ SDK de .NET Core 3.1 y versiones posteriores

NOMBRE

dotnet tool install: instala la herramienta de .NET especificada en el equipo.

Sinopsis

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Descripción

El comando dotnet tool install permite instalar herramientas de .NET en el equipo. Para usar el comando, especifique una de las siguientes opciones de instalación:

  • Para instalar una herramienta global en la ubicación predeterminada, use la opción --global.
  • Para instalar una herramienta global en una ubicación personalizada, use la opción --tool-path.
  • Para instalar una herramienta local, omita las opciones --global y --tool-path.

Ubicaciones de instalación

Herramientas globales

Las herramientas globales se instalan en los siguientes directorios de forma predeterminada cuando se especifica la opción -g o --global:

SO Path
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Para cada herramienta instalada globalmente se generan ejecutables en estas carpetas, aunque los archivos binarios reales de las herramientas se anidan en profundidad en el directorio .store relacionado.

Herramientas --tool-path

Las herramientas con rutas de acceso de herramienta explícitas se almacenan donde se haya especificado que apunte el parámetro --tool-path. Se almacenan de la misma manera que las herramientas globales: un archivo binario ejecutable con los archivos binarios reales en un directorio .store relacionado.

Herramientas locales

Las herramientas locales se almacenan en el directorio global de NuGet, sea cual sea el que haya establecido. Hay archivos de correcciones de compatibilidad (shim) en $HOME/.dotnet/toolResolverCache para cada herramienta local que apuntan a donde se encuentran las herramientas dentro de esa ubicación.

Se agregan referencias a las herramientas locales a un archivo dotnet-tools.json en un directorio .config en el directorio actual. Si aún no existe un archivo de manifiesto, créelo con la opción --create-manifest-if-needed o ejecutando el siguiente comando:

dotnet new tool-manifest

Para obtener más información, vea Instalación de una herramienta local.

Argumentos

  • PACKAGE_NAME

    Nombre o identificador del paquete NuGet que contiene la herramienta de .NET que se va a instalar.

Opciones

  • --allow-downgrade

    Permitir la degradación del paquete al instalar o actualizar un paquete de herramientas de .NET. Suprime la advertencia " La versión solicitada x.x.x es inferior a la versión x.x.x.x existente".

  • -a|--arch <ARCHITECTURE>

    Especifica la arquitectura de destino. Se trata de una sintaxis abreviada para establecer el identificador del entorno de ejecución (RID), donde el valor proporcionado se combina con el RID predeterminado. Por ejemplo, en un equipo win-x64, al especificar --arch x86 se establece el RID en win-x86.

  • --add-source <SOURCE>

    Agrega un origen de paquete NuGet adicional que se usará durante la instalación. Se accede a las fuentes en paralelo, y no de forma secuencial en un orden de prioridad. Si el mismo paquete y versión se encuentra en varias fuentes, se usa la fuente más rápida. Para obtener más información, consulte ¿Qué ocurre cuando se instala un paquete NuGet?.

  • --configfile <FILE>

    Archivo de configuración de NuGet (nuget.config) que se va a usar. Si se especifica, solo se usará la configuración de este archivo. Si no se especifica, se utilizará la jerarquía de archivos de configuración del directorio actual. Para más información, consulte Configuraciones comunes de NuGet.

  • --create-manifest-if-needed

    Se aplica a las herramientas locales. Disponible a partir del SDK de .NET 8. Para buscar un manifiesto, el algoritmo de búsqueda busca dotnet-tools.json en el árbol de directorios o en una carpeta .config que contenga un archivo dotnet-tools.json.

    Si no se encuentra un manifiesto de herramientas y la opción --create-manifest-if-needed está establecida en false, se produce el error CannotFindAManifestFile.

    Si no se encuentra un manifiesto de herramientas y la opción --create-manifest-if-needed está establecida en true, la herramienta crea automáticamente un manifiesto. Se elige una carpeta para el manifiesto de la siguiente manera:

    • Se recorre el árbol de directorios en busca de un directorio que tenga una subcarpeta .git. Si se encuentra uno, se crea el manifiesto en ese directorio.
    • Si el paso anterior no encuentra un directorio, recorra el árbol de directorios buscando un directorio que tenga un .sln archivo o .git . Si se encuentra uno, se crea el manifiesto en ese directorio.
    • Si ninguno de los dos pasos anteriores encuentra un directorio, se crea el manifiesto en el directorio de trabajo actual.

    Para obtener más información sobre cómo se encuentran los manifiestos, consulte Instalación de una herramienta local.

  • --disable-parallel

    Impide que se restauren varios proyectos en paralelo.

  • --framework <FRAMEWORK>

    Especifica el marco de destino para instalar la herramienta. De forma predeterminada, el SDK de .NET intenta elegir la plataforma de destino más apropiada.

  • -g|--global

    Especifica que la instalación se realiza en todos los usuarios. No se puede combinar con la opción --tool-path. Al omitir --global y --tool-path, se especifica la instalación de una herramienta local.

  • -?|-h|--help

    Imprime una descripción de cómo usar el comando.

  • --ignore-failed-sources

    Indica que los errores de origen de paquete se traten como advertencias.

  • --interactive

    Permite que el comando se detenga y espere una entrada o una acción del usuario. Por ejemplo, para completar la autenticación.

  • --local

    Actualice la herramienta y el manifiesto de la herramienta local. No se puede combinar con las opciones --global o --tool-path.

  • --no-cache

    No almacena en caché paquetes ni solicitudes HTTP.

  • --prerelease

    Se incluyen los paquetes de versión preliminar.

  • --tool-manifest <PATH>

    Ruta de acceso al archivo de manifiesto.

  • --tool-path <PATH>

    Especifica la ubicación de donde se tiene que instalar la herramienta global. PATH puede ser una ruta absoluta o relativa. Si la ruta no existe, el comando intenta crearla. Al omitir --global y --tool-path, se especifica la instalación de una herramienta local.

  • -v|--verbosity <LEVEL>

    Establece el nivel de detalle del comando. Los valores permitidos son q[uiet], m[inimal], n[ormal], d[etailed] y diag[nostic]. Para obtener más información, vea LoggerVerbosity.

  • --version <VERSION_NUMBER>

    La versión de la herramienta que se va instalar. De forma predeterminada, se instala la versión estable más reciente del paquete. Utilice esta opción para instalar la versión preliminar o versiones anteriores de la herramienta.

    A partir de .NET 8.0, --version Major.Minor.Patch hace referencia a una versión específica principal, secundaria o de revisión, incluidas las versiones no incluidas en la lista. Para obtener la última versión de una determinada versión principal o secundaria en su lugar, use --version Major.Minor.*.

Ejemplos

  • dotnet tool install -g dotnetsay

    Instala dotnetsay como herramienta global en la ubicación predeterminada.

  • dotnet tool install dotnetsay --tool-path c:\global-tools

    Instala dotnetsay como herramienta global en un directorio específico de Windows.

  • dotnet tool install dotnetsay --tool-path ~/bin

    Instala dotnetsay como herramienta global en un directorio específico de Linux/macOS.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Instala la versión 2.0.0 de dotnetsay como la herramienta global.

  • dotnet tool install dotnetsay

    Instala dotnetsay como herramienta local del directorio actual.

  • dotnet tool install -g --verbosity minimal

    Instala dotnetsay como herramienta global con el nivel de detalle mínimo. El nivel de detalle predeterminado correspondiente a la herramienta global es silencioso.

Consulte también