Início Rápido: Instalar e usar um pacote com a CLI do dotnet

Os pacotes NuGet contêm código binário compilado que os desenvolvedores disponibilizam para outros desenvolvedores usarem em seus projetos. Para obter mais informações, consulte o que é o NuGet. Este guia de início rápido descreve como instalar o popular pacote NuGetNewtonsoft.Json em um projeto .NET com o comando dotnet add package.

Você se refere a pacotes instalados no código com uma diretiva using <namespace>, onde <namespace> geralmente é o nome do pacote. Em seguida, você pode usar a API do pacote em seu projeto.

Dica

Navegue nuget.org/packages para encontrar pacotes que você pode reutilizar em seus próprios aplicativos. Você pode pesquisar diretamente em https://nuget.org, ou encontrar e instalar pacotes de dentro do Visual Studio. Para obter mais informações, consulte Localizar e avaliar pacotes NuGet para seu projeto.

Pré-requisitos

• O SDK do .NET, que fornece a dotnet ferramenta de linha de comando. A partir do Visual Studio 2017, a CLI do dotnet é instalada automaticamente com cargas de trabalho relacionadas ao .NET ou ao .NET Core.

Criar um projeto

Você pode instalar pacotes NuGet em um projeto .NET. Para este passo a passo, crie um projeto de console .NET simples usando a CLI do dotnet, da seguinte maneira:

1. Crie uma pasta chamada Nuget.Quickstart para o projeto.

2. Abra um prompt de comando e alterne para a nova pasta.

3. Crie o projeto usando o seguinte comando:

   CLI do .NET

   dotnet new console
   

4. Use dotnet run para testar o aplicativo. Você deverá ver a saída Hello, World!.

Adicionar o pacote NuGet Newtonsoft.Json

1. Use o seguinte comando para instalar o pacote Newtonsoft.json:

   CLI do .NET

   dotnet add package Newtonsoft.Json
   

2. Depois que o comando for concluído, abra o arquivo Nuget.Quickstart.csproj no Visual Studio para ver a referência de pacote NuGet adicionada:

   XML

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

Usar a API Newtonsoft.Json no aplicativo

1. No Visual Studio, abra o arquivo Program.cs e adicione a seguinte linha na parte superior do arquivo:

   cs

   using Newtonsoft.Json;
   

2. Adicione o seguinte código para substituir a Console.WriteLine("Hello, World!"); instrução:

   cs

   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. Salve o arquivo e, em seguida, compile e execute o aplicativo usando o dotnet run comando. A saída é a representação JSON do Account objeto no código:

   Saída

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

Parabéns por instalar e usar seu primeiro pacote NuGet!

Vídeo relacionado

Encontre mais vídeos do NuGet no Canal 9 e no YouTube.

Próximas etapas

Saiba mais sobre como instalar e usar pacotes NuGet com a CLI do dotnet:

Instalar e usar pacotes usando a CLI do dotnet

• Visão geral e fluxo de trabalho para uso de pacotes
• Localizar e escolher pacotes
• Referências do pacote em arquivos de projeto