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

Puede usar la herramienta dotnet command-line interface (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 .NET, .NET Core, .NET proyectos de estilo SDK estándar y en cualquier otro proyecto de estilo SDK, por ejemplo, los que tienen como destino .NET Framework. Para más información, consulte 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 un argumento opcional en el comando. Para obtener una lista completa de los comandos y sus argumentos, consulte comandos de la CLI de dotnet.

Prerrequisitos

El SDK .NET, que proporciona la CLI de Dotnet. En Visual Studio, la CLI de dotnet se instala automáticamente con todas las cargas de trabajo relacionadas con .NET.

Instalación o actualización de un paquete

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

  1. Abra una ventana de línea de comandos y vaya al directorio que contiene el archivo del proyecto.

  2. Use el siguiente comando para instalar un paquete NuGet:

    dotnet package add <package-name>

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

    dotnet package add Newtonsoft.Json

    Si está utilizando .NET 9 o una versión anterior, use el formato 'verbo-primero' del comando.

    dotnet add package <package-name>

  3. Una vez finalizado el comando, abra el archivo del proyecto para comprobar la referencia del paquete.

    Por ejemplo, abra el archivo .csproj y compruebe la referencia de paquete agregada Newtonsoft.Json :

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

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

El dotnet package add comando instala la versión más reciente del paquete a menos que especifique una versión diferente.

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

dotnet package add <package-name> -v <version>

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

dotnet package add Newtonsoft.Json --version 13.0.1

Listar referencias de paquetes

Puede usar el comando dotnet package list para enumerar las referencias y versiones del paquete para el proyecto. En el directorio que contiene el archivo del proyecto, ejecute el siguiente comando:

dotnet package list

Si usa .NET 9 o versiones anteriores, utilice en su lugar la forma con el verbo primero.

dotnet list package

Quitar un paquete

Puede usar el comando dotnet package remove para quitar una referencia de paquete del archivo del proyecto. En el directorio que contiene el archivo del proyecto, ejecute el siguiente comando:

dotnet package remove <package-name>

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

dotnet package remove Newtonsoft.Json

Si usa .NET 9 o versiones anteriores, utilice en su lugar la forma con el verbo primero.

dotnet remove package <package-name>

Restaurar paquetes

El dotnet restore comando restaura los paquetes que aparecen en <PackageReference> los elementos del archivo del proyecto. Para obtener más información, consulte PackageReference en archivos de proyecto.

A partir de .NET Core 2.0 y continuando con .NET, los comandos y restauran paquetes automáticamente, al igual que muchos otros comandos de la CLI de dotnet. A partir de NuGet 4.0, dotnet restore ejecuta el mismo código que el comando de la nuget restore CLI de NuGet.

Para restaurar paquetes mediante dotnet restore:

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

Contenido relacionado

  • Last updated on