Instalación y administración de paquetes con la CLI de dotnetInstall and manage packages using the dotnet CLI

La herramienta CLI permite instalar, desinstalar y actualizar fácilmente paquetes NuGet en proyectos y soluciones.The CLI tool allows you to easily install, uninstall, and update NuGet packages in projects and solutions. Se ejecuta en Windows, Mac OS X y Linux.It runs on Windows, Mac OS X, and Linux.

La CLI de dotnet está diseñada para su uso en el proyecto de .NET Core y .NET Standard (tipos de proyecto de estilo SDK) y para cualquier otro proyecto de estilo SDK (por ejemplo, un proyecto de estilo SDK que tenga como destino .NET Framework).The dotnet CLI is for use in your .NET Core and .NET Standard project (SDK-style project types), and for any other SDK-style projects (for example, an SDK-style project that targets .NET Framework). Para obtener más información, consulte Atributo Sdk.For more information, see SDK attribute.

En este artículo se muestra el uso básico de algunos de los comandos más comunes de la CLI de dotnet.This article shows you basic usage for a few of the most common dotnet CLI commands. Para la mayoría de estos comandos, la herramienta CLI busca un archivo de proyecto en el directorio actual, a menos que se especifique un archivo de proyecto en el comando (el archivo de proyecto es un modificador opcional).For most of these commands, the CLI tool looks for a project file in the current directory, unless a project file is specified in the command (the project file is an optional switch). Para obtener una lista completa de los comandos y los argumentos que puede usar, consulte las herramientas de la interfaz de la línea de comandos (CLI) de .NET Core.For a complete list of commands and the arguments you may use, see the .NET Core command-line interface (CLI) tools.

Requisitos previosPrerequisites

  • El SDK de .NET Core, que ofrece la herramienta de línea de comandos de dotnet.The .NET Core SDK, which provides the dotnet command-line tool. 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.

Instala un paquete.Install a package

dotnet add package agrega una referencia de paquete al archivo del proyecto y, después, ejecuta dotnet restore para instalar el paquete.dotnet add package adds a package reference to the project file, then runs dotnet restore to install the package.

  1. Abra una línea de comandos y cambie al directorio que contiene el archivo del proyecto.Open a command line and switch to the directory that contains your project file.

  2. Use el comando siguiente para instalar un paquete NuGet:Use the following command to install a Nuget package:

    dotnet add package <PACKAGE_NAME>
    

    Por ejemplo, para instalar el paquete Newtonsoft.Json, use el comando siguiente:For example, to install the Newtonsoft.Json package, use the following command

    dotnet add package Newtonsoft.Json
    
  3. Cuando el comando se complete, examine el archivo del proyecto para asegurarse de que el paquete se haya instalado.After the command completes, look at the project file to make sure the package was installed.

    Puede abrir el archivo .csproj para ver la referencia agregada:You can open the .csproj file to see the added reference:

    <ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="12.0.1" />
    </ItemGroup>
    

Instalación de una versión específica de un paqueteInstall a specific version of a package

Si no se especifica la versión, NuGet instala la versión más reciente del paquete.If the version is not specified, NuGet installs the latest version of the package. También puede usar el comando dotnet add package para instalar una versión específica de un paquete NuGet:You can also use the dotnet add package command to install a specific version of a Nuget package:

dotnet add package <PACKAGE_NAME> -v <VERSION>

Por ejemplo, para agregar la versión 12.0.1 del paquete Newtonsoft.Json, use este comando:For example, to add version 12.0.1 of the Newtonsoft.Json package, use this command:

dotnet add package Newtonsoft.Json -v 12.0.1

Enumeración de referencias del paqueteList package references

Puede enumerar las referencias del paquete para el proyecto con el comando dotnet list package.You can list the package references for your project using the dotnet list package command.

dotnet list package

Eliminación de un paqueteRemove a package

Use el comando dotnet remove package para quitar una referencia de paquete del archivo del proyecto.Use the dotnet remove package command to remove a package reference from the project file.

dotnet remove package <PACKAGE_NAME>

Por ejemplo, para eliminar el paquete Newtonsoft.Json, use el comando siguiente:For example, to remove the Newtonsoft.Json package, use the following command

dotnet remove package Newtonsoft.Json

Actualización de un paqueteUpdate a package

A menos que se especifique la versión del paquete (modificador -v), NuGet instala la versión más reciente del paquete cuando se usa el comando dotnet add package.NuGet installs the latest version of the package when you use the dotnet add package command unless you specify the package version (-v switch).

Restaurar paquetesRestore packages

Use el comando dotnet restore, que restaura los paquetes incluidos en el archivo del proyecto (vea PackageReference).Use the dotnet restore command, which restores packages listed in the project file (see PackageReference). Con .NET Core 2.0 y versiones posteriores, la restauración se realiza automáticamente con dotnet build y dotnet run.With .NET Core 2.0 and later, restore is done automatically with dotnet build and dotnet run. A partir de NuGet 4.0, ejecuta el mismo código que nuget restore.As of NuGet 4.0, this runs the same code as nuget restore.

Como con los otros comandos de la CLI de dotnet, primero abra una línea de comandos y cambie al directorio que contiene el archivo de proyecto.As with the other dotnet CLI commands, first open a command line and switch to the directory that contains your project file.

Para restaurar un paquete con dotnet restore:To restore a package using dotnet restore:

dotnet restore