Instalación de las Herramientas de cliente de NuGet

¿Desea instalar un paquete? Consulte Formas de instalar un paquete NuGet.

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

Inicios rápidos de NuGet

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

• Instalación y uso de un paquete con la CLI de dotnet
• Instalar y usar un paquete NuGet en Visual Studio (solo Windows)

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

• Creación y publicación de un paquete con la CLI de dotnet
• Crear y publicar un paquete NuGet mediante Visual Studio (solo Windows)

Introducción a las herramientas

Herramienta	Descripción	Descargar
DOTNET SDK	La herramienta de la CLI para bibliotecas estándar de .NET y .NET y para cualquier proyecto de estilo SDK como el que tenga como destino .NET Framework. Esta herramienta de la CLI se incluye con el SDK de .NET y proporciona características básicas de NuGet en todas las plataformas. En Visual Studio 2017 y versiones posteriores, la CLI de dotnet se instala automáticamente con las cargas de trabajo relacionadas con .NET.	SDK de .NET
nuget.exe	La herramienta de la CLI para bibliotecas de .NET Framework y para cualquier proyecto que no sigue el estilo SDK, como uno que usa bibliotecas estándar de .NET Standard. Esta herramienta de la CLI proporciona todas las funcionalidades de NuGet en Windows y la mayoría de las características de macOS y Linux cuando se ejecuta en Mono.	nuget.exe
Visual Studio	Un entorno de desarrollo integrado (IDE) completo que incluye nuGet Administrador de paquetes. Visual Studio proporciona la interfaz de usuario Administrador de paquetes y la consola de Administrador de paquetes (PowerShell en Windows). Puede usar estas herramientas para ejecutar la mayoría de las operaciones de NuGet.	Visual Studio
Visual Studio Code	Un editor de código abierto ligero para Windows, macOS y Linux que ofrece funcionalidades de NuGet a través de extensiones de Marketplace. En Visual Studio Code también se pueden utilizar el SDK de dotnet y las herramientas CLI de nuget.exe.	Visual Studio Code

También puede usar la CLI Microsoft Build Engine (MSBuild) para restaurar y crear paquetes. Pero 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 de Administrador de paquetes solo funcionan dentro de Visual Studio en Windows y no funcionan en otros entornos de PowerShell.

Directiva de soporte técnico

Para obtener la directiva de soporte técnico de Visual Studio para Windows, consulte Ciclo de vida y soporte de Visual Studio.

La versión más reciente de nuget.exe es totalmente compatible y se puede confiar en para correcciones de errores, actualizaciones y mejoras. Para obtener más información sobre la directiva de nuget.exe soporte técnico, consulte la Directiva del ciclo de vida moderno.

Para obtener la directiva de soporte del SDK de .NET, consulte la Directiva de soporte para .NET y .NET Core.

Lanzamientos de parches

Las versiones revisadas de nuget.exe se publican exclusivamente cuando se requieren correcciones de seguridad críticas para una versión de soporte técnico 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 MSRC. Para obtener información detallada sobre informes de problemas de seguridad, consulte la directiva de seguridad en el repositorio NuGet.Client.

NuGet.exe deslistar

Las versiones no compatibles, en desuso o vulnerables nuget.exe se quitan del tools.json punto de conexión.

Visual Studio

En Visual Studio 2017 y versiones posteriores, el instalador de Visual Studio incluye el Administrador de paquetes NuGet con cualquier carga de trabajo que emplee .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 Individual components>Code tools>NuGet package manager. Para obtener más información, consulte Install and manage packages in Visual Studio using the NuGet Administrador de paquetes.

Herramientas de la CLI

Puede usar la CLI de dotnet o la CLI de nuget.exe para admitir 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. La nuget.exe CLI debe instalarse por separado, como se ha descrito anteriormente. Para obtener una comparación de características de las herramientas, consulte la sección Disponibilidad de características.

• Para tener como destino .NET o .NET Estándar, use la herramienta de la CLI del SDK de dotnet. Esta CLI es necesaria para el formato de proyecto de estilo SDK, que usa el SDK atributo .

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

DOTNET SDK

Dotnet SDK es la herramienta de la CLI de .NET. Funciona en todas las plataformas (Windows, macOS y Linux) y proporciona características básicas de NuGet, como instalar, restaurar y publicar paquetes. La CLI de dotnet proporciona integración directa con archivos de proyecto .NET, como los de .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 la instalación de Mono.

Instalación del SDK de dotnet

• En los equipos para desarrolladores, instale el SDK de .NET. En Visual Studio 2017 y versiones posteriores, la CLI de dotnet se instala automáticamente con las cargas de trabajo relacionadas con .NET.

• Para los servidores de compilación, siga las instrucciones para usar el SDK de .NET en entornos de integración continua.

Para obtener información sobre cómo usar comandos básicos con la herramienta de la CLI del SDK de dotnet, consulte Instalación y administración de paquetes NuGet con 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 macOS y Linux mediante Mono con algunas limitaciones.

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

Instalar nuget.exe

Windows

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

Si la herramienta de la nuget.exe CLI ya está instalada, puede actualizar la herramienta a la versión más reciente mediante el comando nuget update -self.

1. Descargar nuget.exe:

   • Para descargar la versión recomendada más reciente, vaya a https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
   • Para descargar la versión 2.8.6 en desuso, para mantener la compatibilidad con sistemas de integración continua anteriores, vaya a https://dist.nuget.org/win-x86-commandline/v2.8.6/nuget.exe. La versión 2.8.6 no es compatible con Mono.
   • Para seleccionar una versión que se va a descargar, vaya a nuget.org/downloads.
     • La versión 5.0 y posteriores requieren .NET Framework 4.7.2 o posterior.
     • Se requiere la versión 4.1.0 o posterior para publicar paquetes en nuget.org.

2. Cuando se le solicite, guarde el archivo en una carpeta de su elección. El archivo nuget.exe se descarga directamente. El archivo descargado no es un instalador, por lo que no es necesario ejecutar el archivo directamente desde el explorador.

3. Para usar la herramienta cli de cualquier carpeta, agregue la carpeta que contiene el archivo nuget.exe a la PATH variable de entorno.

macOS/Linux

Los comportamientos pueden variar ligeramente en función de la distribución del sistema operativo.

Nota:

Visual Studio para Mac se retiró el 31 de agosto de 2024, de acuerdo con la Política de Ciclo de Vida Moderna de Microsoft. Puede seguir trabajando con Visual Studio para Mac, pero hay otras opciones para desarrolladores en macOS, como la extensión de kit de desarrollo de C# para VS Code.

Para obtener más información sobre las escalas de tiempo y alternativas de soporte técnico, consulte Visual Studio para Mac retirado el 31 de agosto de 2024.

1. Instale Mono versión 4.4.2 o posterior.

2. En el indicador del shell, ejecute el siguiente comando:

   # Download the latest stable version of `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 agregando el código siguiente al archivo que usa el sistema operativo para almacenar alias de Bash o información de configuración. Normalmente, el archivo ~/.bash_aliases o ~/.bash_profile se usa para este propósito.

   # Create an alias for `nuget`.
   alias nuget="mono /usr/local/bin/nuget.exe"
   

4. Vuelva a cargar el shell. Para probar la instalación, escriba el comando nuget sin parámetros. El comando debe imprimir la información de ayuda de la CLI de NuGet en la pantalla.

Disponibilidad de funcionalidades

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

Feature	CLI de dotnet	CLI de NuGet (Windows)	CLI de nuget (Mono)	Visual Studio
Búsqueda de paquetes	✔	✔	✔	✔
Instalación o desinstalación de paquetes	✔	✔ (1)	✔	✔
Actualizar paquetes	✔	✔		✔
Restaurar paquetes	✔	✔	✔ (2)	✔
Administrar fuentes de paquetes (orígenes)	✔	✔	✔	✔
Gestión de paquetes en un feed de datos	✔	✔	✔
Establecer claves de API para feeds		✔	✔
Crear paquetes (3)	✔	✔	✔ (4)	✔
Publicar paquetes	✔	✔	✔	✔
Replicación de paquetes		✔	✔
Administración de paquetes globales y carpetas de caché	✔	✔	✔
Administración de la configuración de NuGet	✔	✔	✔

Notas de características:

• (1) El uso de esta característica no afecta a los archivos de proyecto. En su lugar, use la herramienta de la CLI del SDK de dotnet.
• (2) Esta característica solo funciona con archivospackages.config y no con archivos de solución (.sln o .slnx).
• (3) Varias características avanzadas del paquete solo están disponibles a través de la CLI, ya que no se representan en las herramientas de interfaz de usuario de Visual Studio.
• (4) Esta característica funciona con archivos .nuspec , pero no con archivos de proyecto.

Próximas funcionalidades

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

Contenido relacionado

• Instalar y gestionar paquetes en Visual Studio usando el Administrador de paquetes NuGet
• Instalación y administración de paquetes NuGet con la CLI de dotnet
• Administración de paquetes NuGet con la CLI de NuGet
• Administrar paquetes con la consola de Visual Studio Administrador de paquetes (PowerShell)
• Creación de un paquete mediante la CLI de nuget.exe
• Publicación de paquetes NuGet
• Referencia de PowerShell de la Consola del Administrador de Paquetes

Los desarrolladores que trabajan en Windows también pueden explorar la Explorador de paquetesNuGet. Esta aplicación es una herramienta independiente de código abierto que puede usar para explorar, crear y editar paquetes NuGet visualmente. Resulta útil para muchos escenarios, como realizar cambios experimentales en una estructura de paquete sin volver a generar el paquete.