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

Artículo
12/22/2023

Puede usar la herramienta dotnet CLI en Windows, macOS o Linux para instalar, desinstalar y actualizar fácilmente paquetes NuGet en proyectos y soluciones de .NET. En este artículo se describen los comandos de la CLI de dotnet más comunes para administrar paquetes NuGet.

La CLI de dotnet se ejecuta en proyectos .NET, ..Net Core, .NET Standard SDK-style y en cualquier otro proyecto SDK-style, por ejemplo los que tienen como objetivo .NET Framework. Para más información, vea SDK de proyectos de .NET.

Para la mayoría de los comandos, la herramienta CLI busca un archivo de proyecto en el directorio actual, a menos que se especifique un archivo de proyecto diferente como modificador opcional en el comando. Para obtener una lista completa de los comandos y sus argumentos, consulte comandos de la CLI de dotnet.

Requisitos previos

El SDK de .NET Core, que ofrece la herramienta de línea de comandos de dotnet. A partir de Visual Studio 2017, la CLI de dotnet se instala automáticamente con todas las cargas de trabajo relacionadas con .NET y .NET Core.

Instalación o actualización de un paquete

El comando dotnet add package agrega una referencia de paquete al archivo del proyecto, y luego se ejecuta dotnet restore 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
```
Una vez completado el comando, puede abrir el archivo del proyecto para ver la referencia del paquete.

Por ejemplo, abra el archivo .csproj para ver la referencia de paquete agregada Newtonsoft.Json:
```
<ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>
```

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

El comando dotnet add package instala la última versión del paquete a menos que especifique una versión diferente.

Para instalar una versión específica de un paquete NuGet, utilice el modificador opcional -v o --version.

dotnet add package <PACKAGE_NAME> -v <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

Enumere las referencias y versiones de los paquetes de su 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, utilice el siguiente comando:

dotnet remove package Newtonsoft.Json

Restaurar paquetes

El comando dotnet restore restaura los paquetes que el archivo de proyecto enumera con <PackageReference>. Para obtener más información, vea Referencias de paquete en un archivo del proyecto.

.NET Core 2.0 y posteriores y los comandos dotnet build y dotnet run restauran los paquetes automáticamente. A partir de NuGet 4.0, dotnet restore ejecuta el mismo código que nuget restore.

Para restaurar un paquete con dotnet restore:

Abra una línea de comandos y cambie al directorio que contiene el archivo del proyecto.
Ejecute dotnet restore.