Instalación de las herramientas del cliente NuGet

¿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) multiplataforma, además de 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 Instalar y usar un paquete (CLI de dotnet) e Instalar y usar un paquete (Visual Studio). Para empezar a crear paquetes NuGet, vea Create and publish a .NET Standard package (dotnet CLI) (Creación y publicación de un paquete de .NET Standard [CLI de dotnet]) y Create and publish a .NET Standard package (Visual Studio) (Creación y publicación de un paquete de .NET Standard [Visual Studio]).

Herramienta                Descripción Descargar         
dotnet.exe 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. 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. 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 ofrece la Interfaz de usuario del Administrador de paquetes y la Consola del Administrador de paquetes, con las que puede 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. Actualmente, la consola del Administrador de paquetes no está disponible. Para otras funcionalidades, use las herramientas dotnet.exe o nuget.exe de la 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.exe o nuget.exe de la CLI. Visual Studio Code

La CLI de MSBuild también ofrece la posibilidad de restaurar y crear paquetes, que es especialmente útil en los servidores de compilación. MSBuild no es una herramienta de uso general para trabajar con NuGet.

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

Programa para la mejora

Instalación en Visual Studio 2017 y versiones más recientes

A partir de Visual Studio 2017, el instalador incluye el Administrador de paquetes NuGet con cualquier carga de trabajo en la que se use .NET. Para instalarlo por separado, o para comprobar que el Administrador de paquetes está instalado, ejecute el instalador de Visual Studio y active la opción bajo Componentes individuales > Herramientas de código > Administrador de paquetes NuGet.

Instalación en Visual Studio 2015 y versiones anteriores

Las extensiones de NuGet para Visual Studio 2013 y 2015 pueden descargarse desde https://dist.nuget.org/index.html.

En Visual Studio 2010 y versiones anteriores, instale la extensión "Administrador de paquetes NuGet para Visual Studio". Tenga en cuenta lo siguiente: si no puede ver la extensión en la primera página de resultados de la búsqueda, intente cambiar la lista desplegable Ordenar por a "Más descargadas" o un orden alfabético.

Herramientas de la CLI

Puede usar la CLI de dotnet o la de nuget.exe para admitir las características de NuGet en el IDE. La CLI 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.

Las dos herramientas de la CLI de NuGet son dotnet.exe y nuget.exe. Vea la comparación de disponibilidad de características.

  • Para destinarse a .NET Core o .NET Standard, use la CLI de dotnet. La CLI de dotnet 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 CLI de nuget.exe. Si el proyecto se migra de packages.config a PackageReference, use la CLI de dotnet.

CLI de dotnet.exe

La CLI de .NET Core 2.0, dotnet.exe, 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. 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. dotnet también se crea directamente para cada plataforma y no requiere que se instale Mono.

Instalación:

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

CLI de nuget.exe

La CLI de nuget.exe, nuget.exe, es la utilidad de línea de comandos para Windows que ofrece todas las funcionalidades de NuGet. También se puede ejecutar en Mac OS X y Linux con Mono, con algunas limitaciones.

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

Instalación:

Windows

Nota

NuGet.exe 5.0 y las versiones posteriores requieren .NET Framework 4.7.2 o versiones posteriores para ejecutarse.

  1. Visite nuget.org/downloads y seleccione NuGet 3.3 o posterior (2.8.6 no es compatible con Mono). Siempre se recomienda la última versión, y 4.1.0+ es la versión necesaria para publicar paquetes en nuget.org.
  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 no es un instalador; no verá nada si lo ejecuta directamente desde el explorador.
  3. Agregue la carpeta donde colocó nuget.exe a la variable de entorno de RUTA DE ACCESO para usar la herramienta CLI desde cualquier lugar.

macOS/Linux

Los comportamientos pueden variar ligeramente según la distribución del sistema operativo.

  1. Instale Mono 4.4.2 o versiones posteriores.

  2. Ejecute los comandos siguientes en un símbolo del sistema del shell:

    # Download the latest stable `nuget.exe` to `/usr/local/bin`
    sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe
    
  3. Cree un alias mediante la adición del script siguiente al archivo apropiado del sistema operativo (normalmente ~/.bash_aliases o ~/.bash_profile):

    # Create as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. Recargue el shell. Para probar la instalación, escriba nuget sin parámetros. Debe aparecer la Ayuda de la CLI de NuGet.

Sugerencia

Use nuget update -self en Windows para actualizar un archivo nuget.exe existente a la versión más reciente.

Nota

La CLI de NuGet más reciente recomendada está siempre disponible en https://dist.nuget.org/win-x86-commandline/latest/nuget.exe. A efectos de compatibilidad con sistemas de integración continua anteriores, una dirección URL anterior, https://nuget.org/nuget.exe, ofrece actualmente la herramienta CLI 2.8.6 en desuso.

Disponibilidad de características

Característica CLI de dotnet CLI de nuget (Windows) CLI de nuget (Mono) Visual Studio (Windows) Visual Studio para Mac
Buscar 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

(1) No afecta a los archivos de proyecto; use dotnet.exe en su lugar.

(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 pueden explorar también el Explorador de paquetes NuGet, una herramienta independiente de código abierto para la exploración visual, la creación y la modificación de paquetes NuGet. Por ejemplo, resulta muy útil realizar cambios experimentales en la estructura de un paquete sin recompilar el paquete.