Inicio rápido: Instalar y usar un paquete con la CLI de dotnet

  • Artículo

Los paquetes NuGet contienen código binario compilado que los desarrolladores ponen a disposición de otros desarrolladores para que lo utilicen en sus proyectos. Para obtener más información, consulte Qué es NuGet. En este inicio rápido se describe cómo instalar el popular paquete NuGet Newtonsoft.Json en un proyecto de .NET mediante el comando dotnet add package.

Puede hacer referencia a los paquetes instalados en el código con una directiva using <namespace>, donde <namespace> suele ser el nombre del paquete. A continuación, puede usar la API del paquete en su proyecto.

Sugerencia

Examine nuget.org/packages para buscar paquetes que puede reutilizar en sus propias aplicaciones. Puede buscar directamente en https://nuget.org o buscar e instalar paquetes en Visual Studio. Para obtener más información, consulte Búsqueda y evaluación de paquetes de NuGet para su proyecto.

Requisitos previos

  • El SDK de .NET, 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 cualquier carga de trabajo relacionada con .NET o .NET Core.

Creación de un proyecto

Puede instalar paquetes NuGet en un proyecto de .NET. En este tutorial, cree un proyecto simple de consola de .NET mediante la CLI de dotnet, de la siguiente manera:

  1. Cree una carpeta denominada Nuget.Quickstart para el proyecto.

  2. Abra un símbolo del sistema y cambie a la carpeta nueva.

  3. Cree el proyecto con el comando siguiente:

    dotnet new console

  4. Use dotnet run para probar la aplicación. Debería ver el resultado Hello, World!.

Agregar el paquete de NuGet Newtonsoft.Json

  1. Use el comando siguiente para instalar el paquete Newtonsoft.json:

    dotnet add package Newtonsoft.Json

  2. Una vez completado el comando, abra el archivo Nuget.Quickstart.csproj en Visual Studio para ver la referencia del paquete NuGet agregada:

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

Usar la API de Newtonsoft.Json en la aplicación

  1. En Visual Studio, abra el archivo Program.cs y agregue la siguiente línea al principio del archivo:

    using Newtonsoft.Json;

  2. Agregue el código siguiente para reemplazar la instrucción Console.WriteLine("Hello, World!");:

    namespace Nuget.Quickstart
{
    public class Account
    {
        public string? Name { get; set; }
        public string? Email { get; set; }
        public DateTime DOB { get; set; }
    }
    internal class Program
    {
        static void Main(string[] args)
        {
            Account account = new Account
            {
                Name = "John Doe",
                Email = "john@nuget.org",
                DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
            };

            string json = JsonConvert.SerializeObject(account, Formatting.Indented);
            Console.WriteLine(json);
        }
    }
}

  3. Guarde el archivo y, a continuación, compile y ejecute la aplicación mediante el comando dotnet run. El resultado debe ser la representación JSON del objeto Account en el código:

    {
  "Name": "John Doe",
  "Email": "john@nuget.org",
  "DOB": "1980-02-20T00:00:00Z"
}

¡Enhorabuena por instalar y usar su primer paquete NuGet!

Encuentre más vídeos de NuGet en Channel 9 y YouTube.

Pasos siguientes

Obtenga más información sobre cómo instalar y usar paquetes NuGet con la CLI de dotnet:

Instalación y uso de paquetes mediante la CLI de dotnet