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

  • Artículo
  • 2 minutos para leer

Los paquetes de NuGet son unidades de código reutilizable que otros desarrolladores ponen a su disposición para que los use en sus proyectos. Consulte ¿Qué es NuGet? para obtener más información. Los paquetes se instalan en un proyecto de .NET Core con el comando dotnet add package tal y como se describe en este artículo para el popular paquete dotnet add package.

Una vez instalado, haga referencia al paquete en el código con using <namespace>, donde <namespace> es específico del paquete que está usando. A continuación, puede usar la API del paquete.

Sugerencia

Comience con nuget.org: la exploración de nuget.org es la forma en que los desarrolladores de .NET suelen buscar componentes que pueden reutilizar en sus propias aplicaciones. Puede buscar directamente en nuget.org o buscar e instalar paquetes en Visual Studio, tal y como se indica en este artículo.

Prerequisites

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

Crear un proyecto

Los paquetes NuGet pueden instalarse en todo tipo de proyecto de .NET. En este tutorial, cree un proyecto simple de consola de .NET Core de la siguiente manera:

  1. Cree una carpeta 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. Utilice dotnet run para comprobar que la aplicación se ha creado correctamente.

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 .csproj para ver la referencia agregada:

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

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

  1. Abra el archivo Program.cs y agréguele la línea siguiente al principio:

    using Newtonsoft.Json;

  2. Agregue el código siguiente antes de llamar a la línea class Program:

    public class Account
{
    public string Name { get; set; }
    public string Email { get; set; }
    public DateTime DOB { get; set; }
}

  3. reemplace la función Main por lo siguiente:

    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);
}

  4. 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"
}

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

Pasos siguientes

¡Enhorabuena por instalar y usar su primer paquete NuGet!

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

Para explorar más de lo que NuGet ofrece, seleccione los siguientes vínculos.