Instalación y administración de paquetes con la CLI de dotnet

Artículo
12/02/2021
2 minutos para leer

La herramienta CLI permite instalar, desinstalar y actualizar fácilmente paquetes NuGet en proyectos y soluciones. Se ejecuta en Windows, Mac OS X y 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). Para obtener más información, consulte Atributo Sdk.

En este artículo se muestra el uso básico de algunos de los comandos más comunes de la CLI de dotnet. 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). 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.

Prerequisites

El SDK de .NET Core, que proporciona la herramienta de línea de comandos. A partir de Visual Studio 2017, la CLI de dotnet se instala automáticamente con cualquier carga de trabajo relacionada con .NET Core.

Instalación de un paquete

dotnet add package agrega una referencia de paquete al archivo de proyecto y, a continuación, se ejecuta para instalar el paquete.

Abra una línea de comandos y cambie al directorio que contiene el archivo del proyecto.
Use el comando siguiente para instalar un paquete NuGet:
```
dotnet add package <PACKAGE_NAME>
```
Por ejemplo, para instalar el paquete Newtonsoft.Json, use el comando siguiente:
```
dotnet add package Newtonsoft.Json
```
Cuando el comando se complete, examine el archivo del proyecto para asegurarse de que el paquete se haya instalado.

Puede abrir el archivo .csproj para ver la referencia agregada:
```
<ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="12.0.1" />
</ItemGroup>
```

Instalación de una versión específica de un paquete

Si no se especifica la versión, NuGet instala la versión más reciente del paquete. También puede usar el comando dotnet add package para instalar una versión específica de un paquete NuGet:

dotnet add package <PACKAGE_NAME> --version <VERSION>

Por ejemplo, para agregar la versión 12.0.1 del paquete Newtonsoft.Json, use este comando:

dotnet add package Newtonsoft.Json --version 12.0.1

Enumeración de referencias del paquete

Puede enumerar las referencias del paquete para el proyecto con el comando dotnet list package.

dotnet list package

Eliminación de un paquete

Use el comando dotnet remove package para quitar una referencia de paquete del archivo del proyecto.

dotnet remove package <PACKAGE_NAME>

Por ejemplo, para eliminar el paquete Newtonsoft.Json, use el comando siguiente:

dotnet remove package Newtonsoft.Json

Actualización de un paquete

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.

Restaurar paquetes

Use el comando dotnet restore, que restaura los paquetes incluidos en el archivo del proyecto (vea PackageReference). Con .NET Core 2.0 y versiones posteriores, la restauración se realiza automáticamente con dotnet build y dotnet run. A partir de NuGet 4.0, ejecuta el mismo código que 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.

Para restaurar un paquete con dotnet restore:

dotnet restore