Instalación de las herramientas del cliente NuGetInstall NuGet client tools

¿Quiere instalar un paquete? Vea Formas de instalar paquetes NuGet.Looking to install a package? See Ways to install NuGet packages.

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.To work with NuGet, as a package consumer or creator, you can use command-line interface (CLI) tools as well as NuGet features in 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.This article briefly outlines the capabilities of the different tools, how to install them, and their comparative feature availability. 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).To get started using NuGet to consume packages, see Install and use a package (dotnet CLI) and Install and use a package (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]).To get started creating NuGet packages, see Create and publish a NET Standard package (dotnet CLI) and Create and publish a NET Standard package (Visual Studio).

Herramienta               Tool                DESCRIPCIÓNDescription Descargar         Download         
dotnet.exedotnet.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.CLI tool for .NET Core and .NET Standard libraries, and for any SDK-style project such as one that targets .NET Framework. Se incluye con el SDK de .NET Core y ofrece las características básicas de NuGet en todas las plataformas.Included with the .NET Core SDK and provides core NuGet features on all platforms. (A partir de Visual Studio 2017, la CLI de dotnet se instala automáticamente con cualquier carga de trabajo relacionada con .NET Core).(Starting in Visual Studio 2017, the dotnet CLI is automatically installed with any .NET Core related workloads.) SDK de .NET Core.NET Core SDK
nuget.exenuget.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.CLI tool for .NET Framework libraries and for any non-SDK-style project such as one that targets .NET Standard libraries. 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.Provides all NuGet capabilities on Windows, provides most features on Mac and Linux when running under Mono. nuget.exenuget.exe
Visual StudioVisual Studio En Windows, ofrece funciones de NuGet mediante la interfaz de usuario del Administrador de paquetes y la consola del Administrador de paquetes, incluidas las cargas de trabajo relacionadas con .NET.On Windows, provides NuGet capabilities through the Package Manager UI and Package Manager Console; included with .NET-related workloads. En Mac, ofrece ciertas características a través de la interfaz de usuario.On Mac, provides certain features through the UI. En Visual Studio Code, las características de NuGet se proporcionan a través de extensiones.In Visual Studio Code, NuGet features are provided through extensions. Visual StudioVisual Studio

La CLI de MSBuild también ofrece la posibilidad de restaurar y crear paquetes, que es especialmente útil en los servidores de compilación.The MSBuild CLI also provides the ability to restore and create packages, which is primarily useful on build servers. MSBuild no es una herramienta de uso general para trabajar con NuGet.MSBuild is not a general-purpose tool for working with NuGet.

Herramientas de la CLICLI tools

Las dos herramientas de la CLI de NuGet son dotnet.exe y nuget.exe.The two NuGet CLI tools are dotnet.exe and nuget.exe. Vea la comparación de disponibilidad de características.See feature availability for a comparison.

  • Para destinarse a .NET Core o .NET Standard, use la CLI de dotnet.To target .NET Core or .NET Standard, use the dotnet CLI. La CLI de dotnet es necesaria para el formato del proyecto de estilo SDK que usa el atributo SDK.The dotnet CLI is required for the SDK-style project format, which uses the SDK attribute.
  • Para establecer como destino .NET Framework (solo para proyectos que no son de estilo SDK), use la CLI de nuget.exe.To target .NET Framework (non-SDK-style project only), use the nuget.exe CLI. Si el proyecto se migra de packages.config a PackageReference, use la CLI de dotnet.If the project is migrated from packages.config to PackageReference, use the dotnet CLI.

CLI de dotnet.exedotnet.exe CLI

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.The .NET Core 2.0 CLI, dotnet.exe, works on all platforms (Windows, Mac, and Linux) and provides core NuGet features such as installing, restoring, and publishing packages. 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 provides direct integration with .NET Core project files (such as .csproj), which is helpful in most scenarios. dotnet también se crea directamente para cada plataforma y no requiere que se instale Mono.dotnet is also built directly for each platform and does not require you to install Mono.

Instalación:Installation:

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.To learn how to use basic commands with the dotnet CLI, see Install and use packages using the dotnet CLI.

CLI de nuget.exenuget.exe CLI

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.The nuget.exe CLI, nuget.exe, is the command-line utility for Windows that provides all NuGet capabilities; it can also be run on Mac OSX and Linux using Mono with some limitations.

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.To learn how to use basic commands with the nuget.exe CLI, see Install and use packages using the nuget.exe CLI.

Instalación:Installation:

WindowsWindows

Nota

NuGet.exe 5.0 y las versiones posteriores requieren .NET Framework 4.7.2 o versiones posteriores para ejecutarse.NuGet.exe 5.0 and later require .NET Framework 4.7.2 or later to execute.

  1. Visite nuget.org/downloads y seleccione NuGet 3.3 o posterior (2.8.6 no es compatible con Mono).Visit nuget.org/downloads and select NuGet 3.3 or higher (2.8.6 is not compatible with Mono). Siempre se recomienda la última versión, y 4.1.0+ es la versión necesaria para publicar paquetes en nuget.org.The latest version is always recommended, and 4.1.0+ is required to publish packages to nuget.org.
  2. Cada descarga es el archivo nuget.exe directamente.Each download is the nuget.exe file directly. Indique al explorador que guarde el archivo en una carpeta de su elección.Instruct your browser to save the file to a folder of your choice. El archivo no es un instalador; no verá nada si lo ejecuta directamente desde el explorador.The file is not an installer; you won't see anything if you run it directly from the browser.
  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.Add the folder where you placed nuget.exe to your PATH environment variable to use the CLI tool from anywhere.

macOS y LinuxmacOS/Linux

Los comportamientos pueden variar ligeramente según la distribución del sistema operativo.Behaviors may vary slightly by OS distribution.

  1. Instale Mono 4.4.2 o versiones posteriores.Install Mono 4.4.2 or later.

  2. Ejecute los comandos siguientes en un símbolo del sistema del shell:Execute the following command at a shell prompt:

    # 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 an alias by adding the following script to the appropriate file for your OS (typically ~/.bash_aliases or ~/.bash_profile):

    # Create as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. Recargue el shell.Reload the shell. Para probar la instalación, escriba nuget sin parámetros.Test the installation by entering nuget with no parameters. Debe aparecer la Ayuda de la CLI de NuGet.NuGet CLI help should display.

Sugerencia

Use nuget update -self en Windows para actualizar un archivo nuget.exe existente a la versión más reciente.Use nuget update -self on Windows to update an existing nuget.exe to the latest version.

Nota

La CLI de NuGet más reciente recomendada está siempre disponible en https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.The latest recommended NuGet CLI is always available at 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.For compatibility purposes with older continuous integration systems, a previous URL, https://nuget.org/nuget.exe currently provides the deprecated 2.8.6 CLI tool.

Programa para la mejoraVisual Studio

  • Visual Studio Code: las funcionalidades de NuGet están disponibles a través de las extensiones de Marketplace. También puede usar las herramientas dotnet.exe o nuget.exe de la CLI.Visual Studio Code: NuGet capabilities are available through marketplace extensions, or use the dotnet.exe or nuget.exe CLI tools.

  • Visual Studio for Mac: ciertas funcionalidades de NuGet se han integrado directamente.Visual Studio for Mac: certain NuGet capabilities are built in directly. Vea Incluir un paquete NuGet en el proyecto para obtener un tutorial.See Including a NuGet package in your project for a walkthrough. Para otras funcionalidades, use las herramientas dotnet.exe o nuget.exe de la CLI.For other capabilities, use the dotnet.exe or nuget.exe CLI tools.

  • Visual Studio en Windows: el Administrador de paquetes NuGet se incluye con Visual Studio 2012 y versiones posteriores.Visual Studio on Windows: The NuGet Package Manager is included with Visual Studio 2012 and later. 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 provides the Package Manager UI and the Package Manager Console, through which you can run most NuGet operations.

    • 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.Starting in Visual Studio 2017, the installer includes the NuGet Package Manager with any workload that employs .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.To install separately, or to verify that the Package Manager is installed, run the Visual Studio installer and check the option under Individual Components > Code tools > NuGet package manager.
    • La interfaz y la consola del Administrador de paquetes son exclusivas para Visual Studio en Windows.The Package Manager UI and Console are unique to Visual Studio on Windows. No están disponibles de momento en Visual Studio para Mac.They are not presently available on Visual Studio for Mac.
    • Para poder usar las características de NuGet en el IDE se requiere una herramienta CLI.A CLI tool is required to support NuGet features in the IDE. Puede usar la CLI de dotnet o la CLI de nuget.exe.You can use either the dotnet CLI or the the nuget.exe CLI. La CLI dotnet se instala con algunas cargas de trabajo de Visual Studio, como .NET Core.The dotnet CLI is installed with some Visual Studio workloads, such as .NET Core. La CLI nuget.exe debe instalarse por separado, como se describió anteriormente.The nuget.exe CLI must be installed separately as described earlier.
    • Los comandos de la consola del Administrador de paquetes solo funcionan en Visual Studio en Windows y no en otros entornos de PowerShell.Package Manager Console commands work only within Visual Studio on Windows and do not work within other PowerShell environments.
    • En Visual Studio 2010 y versiones anteriores, instale la extensión "Administrador de paquetes NuGet para Visual Studio".For Visual Studio 2010 and earlier, install the "NuGet Package Manager for Visual Studio" extension.
    • También pueden descargarse extensiones de NuGet para Visual Studio 2013 y 2015 desde https://dist.nuget.org/index.html.NuGet Extensions for Visual Studio 2013 and 2015 can also be downloaded from https://dist.nuget.org/index.html.
    • 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.If you'd like to preview upcoming NuGet features, install a Visual Studio Preview, which works side-by-side with stable releases of Visual Studio. Para notificar problemas o compartir ideas sobre versiones preliminares, abra un problema en el repositorio NuGet de GitHub.To report problems or share ideas for previews, open an issue on the NuGet GitHub repository.

Disponibilidad de característicasFeature availability

CaracterísticaFeature CLI de dotnetdotnet CLI CLI de nuget (Windows)nuget CLI (Windows) CLI de nuget (Mono)nuget CLI (Mono) Visual Studio (Windows)Visual Studio (Windows) Visual Studio para MacVisual Studio for Mac
Buscar paquetesSearch packages
Instalar o desinstalar paquetesInstall/uninstall packages ✔(1)✔(1)
Actualizar paquetesUpdate packages
Restaurar paquetesRestore packages ✔(2)✔(2)
Administrar fuentes de paquetes (orígenes)Manage package feeds (sources)
Administrar paquetes en una fuenteManage packages on a feed
Establecer claves de API para las fuentesSet API keys for feeds
Crear paquetes (3)Create packages(3) ✔(4)✔(4)
Publicar paquetesPublish packages
Replicar paquetesReplicate packages
Administrar las carpetas global-package y de cachéManage global-package and cache folders
Administrar configuración de NuGetManage NuGet configuration

(1) No afecta a los archivos de proyecto; use dotnet.exe en su lugar.(1) Does not affect project files; use dotnet.exe instead.

(2) Solo funciona con el archivo packages.config, no con archivos de la solución (.sln).(2) Works only with packages.config file and not with solution (.sln) files.

(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.(3) Various advanced package features are available through the CLI only as they aren't represented in the Visual Studio UI tools.

(4) Funciona con archivos .nuspec pero no con los archivos de proyecto.(4) Works with .nuspec files but not with project files.

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.Developers working on Windows can also explore the NuGet Package Explorer, an open-source, stand-alone tool to visually explore, create, and edit NuGet packages. Por ejemplo, resulta muy útil realizar cambios experimentales en la estructura de un paquete sin recompilar el paquete.It's very helpful, for example, to make experimental changes to a package structure without rebuilding the package.