Instalación de las Herramientas de cliente de NuGet

  • Artículo

¿Quiere instalar un paquete? Vea Formas de instalar paquetes NuGet.

Para trabajar con NuGet como consumidor o creador de paquetes, puede usar las herramientas de la interfaz de la línea de comandos (CLI) y las características de NuGet en Visual Studio. En este artículo se describen brevemente las funcionalidades de las distintas herramientas, cómo instalarlas y la comparativa de su disponibilidad de características.

Para empezar a usar NuGet para consumir paquetes, consulte los artículos siguientes:

Para empezar a crear paquetes NuGet, consulte estos artículos:

Herramienta Descripción Descargar
dotnet SDK Herramienta CLI para las bibliotecas .NET Core y .NET Standard y para los proyectos de estilo SDK, como los que tienen como destino .NET Framework. La herramienta CLI se incluye con el SDK de .NET Core y ofrece las características básicas de NuGet en todas las plataformas. A partir de Visual Studio 2017, la CLI de dotnet se instala automáticamente con cualquier carga de trabajo relacionada con .NET Core. SDK de .NET Core
nuget.exe Herramienta CLI para bibliotecas .NET Framework y para cualquier proyecto no de estilo SDK, como los que tienen como destino las bibliotecas .NET Standard. Esta herramienta CLI ofrece todas las funcionalidades de NuGet en Windows, además de la mayoría de las características en Mac y Linux cuando se ejecutan con Mono. nuget.exe
Visual Studio En Windows, el Administrador de paquetes NuGet se incluye con Visual Studio 2012 y versiones posteriores. Visual Studio proporciona la Interfaz de usuario del Administrador de paquetes y la Consola del Administrador de paquetes (PowerShell en Windows). Puede usar estas herramientas para ejecutar la mayoría de las operaciones de NuGet. Visual Studio
Visual Studio para Mac En Mac, ciertas capacidades de NuGet se han integrado directamente. La Consola del Administrador de paquetes no está disponible actualmente. Para otras funcionalidades, use las herramientas dotnet SDK o nuget.exe CLI. Visual Studio para Mac
Visual Studio Code En Windows, Mac o Linux las capacidades de NuGet están disponibles a través de las extensiones de Marketplace. También se pueden usar las herramientas dotnet SDK o nuget.exe CLI. Visual Studio Code

Nota:

Visual Studio para Mac está programado para su retirada antes del 31 de agosto de 2024 de acuerdo con la directiva de ciclo de vida moderno de Microsoft. Consulte ¿Qué ocurre con Visual Studio para Mac? para obtener más información.

La CLI de MSBuild también restaura y crea paquetes. MSBuild no es una herramienta de uso general para trabajar con NuGet. Esta herramienta de la CLI es principalmente útil en los servidores de compilación.

Los comandos de la Consola del Administrador de paquetes solo funcionan en Visual Studio en Windows y no en otros entornos de PowerShell.

Directiva de soporte técnico

La directiva de soporte de Visual Studio para Windows se puede encontrar en Ciclo de vida y mantenimiento del producto de Visual Studio.

La versión más reciente del NuGet.exe es totalmente compatible y se puede utilizar para correcciones de errores, actualizaciones y mejoras. Para obtener más información sobre la directiva de soporte de NuGet.exe, consulte la Directiva de ciclo de vida de soporte de Microsoft.

La directiva de soporte del SDK de .NET se puede encontrar en la directiva de soporte de .NET y .NET Core.

Versiones de revisión

Las versiones revisadas de NuGet.exe se publicarán exclusivamente cuando se requieran correcciones de seguridad críticas para una versión de soporte a largo plazo (LTS) de Visual Studio o el SDK de .NET.

Todos los errores de seguridad deben notificarse al Centro de respuestas de seguridad de Microsoft (MSRC) en la página del informe de MSRC. Consulte también la directiva de seguridad en el repositorio NuGet.Client.

Descarte de NuGet.exe

Las versiones de NuGet.exe vulnerables, en desuso o sin soporte se eliminarán de tools.json.

Visual Studio

En Visual Studio 2017 y versiones posteriores, el Instalador de Visual Studio incluye el Administrador de paquetes de NuGet con cualquier carga de trabajo en la que se use .NET.

También puede instalar el Administrador de paquetes por separado o comprobar la instalación. Ejecute el instalador de Visual Studio y active la opción en Componentes individuales > Herramientas de código > administrador de paquetes NuGet. Para obtener más información, consulte Instalar y administrar paquetes en Visual Studio con el Administrador de paquetes NuGet.

Nota:

Para versiones anteriores de Visual Studio, puede descargar extensiones de NuGet en https://dist.nuget.org/index.html.

Herramientas de la CLI

Puede usar la CLI de dotnet o la CLI de nuget.exe para admitir las características de NuGet en el IDE de Visual Studio. La CLI de dotnet se instala con algunas cargas de trabajo de Visual Studio, como .NET Core. La CLI nuget.exe debe instalarse por separado, como se describió anteriormente. Para obtener una comparación de características de las herramientas, consulte la sección disponibilidad de características.

  • Para destinarse a .NET Core o .NET Standard, use la CLI SDK de dotnet. La CLI es necesaria para el formato del proyecto de estilo SDK que usa el atributo SDK.

  • Para establecer como destino .NET Framework (solo para proyectos que no son de estilo SDK), use la herramienta CLI de nuget.exe. Si el proyecto se migra de packages.config a PackageReference, use la CLI SDK de dotnet en su lugar.

SDK de dotnet

El SDK de dotnet es la herramienta CLI de .NET Core 2.0, que funciona en todas las plataformas (Windows, Mac y Linux) y ofrece características básicas de NuGet, tales como la instalación, restauración y publicación de paquetes. La CLI de dotnet proporciona la integración directa con archivos de proyecto de .NET Core (como .csproj), lo que resulta útil en la mayoría de los escenarios. Esta CLI también se crea directamente para cada plataforma y no requiere que se instale Mono.

Instale el SDK de dotnet

Para obtener información sobre cómo usar comandos básicos con la CLI de dotnet, consulte Instalar y administrar paquetes de NuGet mediante la CLI de dotnet.

CLI de nuget.exe

La CLI de NuGet, nuget.exe, es la utilidad de línea de comandos para Windows que proporciona todas las funcionalidades de NuGet. Esta CLI también se puede ejecutar en Mac OSX y Linux mediante Mono con algunas limitaciones.

Para obtener información sobre cómo usar comandos básicos con la CLI de nuget.exe, consulte Administrar paquetes de NuGet mediante la CLI de nuget.exe.

Instalar nuget.exe

Instale siempre la versión más reciente de la herramienta que admita la configuración.

  • Puede descargar la versión recomendada más reciente en https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
  • Si ya tiene instalada la herramienta de la CLI de nuget.exe, puede actualizar la herramienta a la versión más reciente con el comando nuget update -self.
  • A efectos de compatibilidad con sistemas de integración continua anteriores, una dirección URL anterior, https://nuget.org/nuget.exe ofrece actualmente la versión 2.8.6 en desuso de la herramienta CLI.

  1. Visite nuget.org/downloads y descargue NuGet versión 3.3 o posterior.

    • La versión 5.0 y posteriores requieren .NET Framework versión 4.7.2 o posterior.
    • Se requiere la versión 4.1.0 y posteriores para publicar paquetes en nuget.org.
    • La versión 2.8.6 no es compatible con Mono.

  2. Cada descarga es el archivo nuget.exe directamente. Indique al explorador que guarde el archivo en una carpeta de su elección. El archivo de descarga no es un instalador, por lo que no verá nada si lo ejecuta directamente desde el explorador.

  3. Agregue la carpeta donde colocó el archivo nuget.exe a la variable de entorno de RUTA DE ACCESO para usar la herramienta CLI desde cualquier lugar.

Disponibilidad de características

En la tabla siguiente se comparan las características disponibles de las herramientas dotnet y nuget.exe CLI para las plataformas compatibles.

Característica CLI de dotnet CLI de nuget (Windows) CLI de nuget (Mono) Visual Studio (Windows) Visual Studio para Mac
Búsqueda de paquetes ✔ ✔ ✔ ✔ ✔
Instalar o desinstalar paquetes ✔ ✔ (1) ✔ ✔ ✔
Actualizar paquetes ✔ ✔ ✔ ✔
Restaurar paquetes ✔ ✔ ✔ (2) ✔ ✔
Administrar fuentes de paquetes (orígenes) ✔ ✔ ✔ ✔ ✔
Administrar paquetes en una fuente ✔ ✔ ✔
Establecer claves de API para las fuentes ✔ ✔
Crear paquetes (3) ✔ ✔ ✔ (4) ✔
Publicar paquetes ✔ ✔ ✔ ✔
Replicar paquetes ✔ ✔
Administrar las carpetas global-package y de caché ✔ ✔ ✔
Administrar configuración de NuGet ✔ ✔ ✔

Notas de características

  • (1) No afecta a los archivos del proyecto. En su lugar, use la herramienta de la CLI de SDK.
  • (2) Solo funciona con el archivo packages.config, no con archivos de la solución (.sln).
  • (3) Solo diversas características de paquete avanzadas están disponibles a través de la CLI ya que no se representan en las herramientas de la interfaz de usuario de Visual Studio.
  • (4) Funciona con archivos .nuspec pero no con los archivos de proyecto.

Próximas características

Si quiere obtener una versión preliminar de las próximas características de NuGet, instale una versión preliminar de Visual Studio, que funciona en paralelo con versiones estables de Visual Studio. Para notificar problemas o compartir ideas sobre versiones preliminares, abra un problema en el repositorio NuGet de GitHub.

Los desarrolladores que trabajan en Windows también pueden explorar el Explorador de paquetes NuGet. Esta aplicación es una herramienta independiente de código abierto que le permite explorar, crear y editar paquetes NuGet visualmente. Resulta útil para numerosos escenarios, como realizar cambios experimentales en la estructura de un paquete sin recompilar el paquete.