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

Neste início rápido, você instala o popular pacote NuGet Newtonsoft.Json em um projeto de .NET. 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 Uma introdução ao NuGet.

Para instalar o pacote, use o comando adicionar pacote dotnet , que faz parte da CLI (interface de linha de comando) do dotnet.

Pré-requisitos

O SDK .NET, que fornece a CLI do .NET. Em Visual Studio, a CLI do dotnet é instalada automaticamente com cargas de trabalho relacionadas a .NET.

Criar um projeto

Você pode instalar pacotes NuGet em um projeto de .NET. Para este início rápido, execute as seguintes etapas para criar um projeto básico de console .NET usando a CLI do dotnet:

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

2. Abra uma janela do prompt de comando e vá para a nova pasta.

3. Crie o projeto usando o seguinte comando:

   dotnet new console
   

4. Use dotnet run para testar o aplicativo. O comando grava a seguinte saída na tela: Hello, World!.

Adicionar o pacote NuGet Newtonsoft.Json

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

   dotnet package add Newtonsoft.Json
   

   Se você estiver usando .NET 9 ou anterior, use a forma com verbo primeiro em vez disso.

   dotnet add package Newtonsoft.Json
   

2. Depois que o comando for concluído, abra o arquivo Nuget.Quickstart.csproj em Visual Studio ou em um editor de texto. Verifique a referência de pacote NuGet adicionada:

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

Usar a API Newtonsoft.Json no aplicativo

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

1. Em Visual Studio ou em um editor de texto, abra o arquivo Program.cs. Adicione a seguinte linha à parte superior do arquivo:

   using Newtonsoft.Json;
   

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

   namespace Nuget.Quickstart
   {
       public class Account
       {
           public string? Id { get; set; }
           public decimal Balance { get; set; }
           public DateTime Created { get; set; }
       }
       internal class Program
       {
           static void Main(string[] args)
           {
               Account account = new Account
               {
                   Id = "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
                   Balance = 4389.21m,
                   Created = new DateTime(2026, 4, 16, 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:

   {
     "Id": "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
     "Balance": 4389.21,
     "Created": "2026-04-16T00:00:00Z"
   }
   

Vídeos relacionados

Para obter vídeos sobre como usar o NuGet para gerenciamento de pacotes, consulte .NET Gerenciamento de Pacotes com NuGet para Iniciantes e NuGet para Iniciantes.

Conteúdo relacionado

Para saber mais sobre como instalar e usar pacotes NuGet usando a CLI do dotnet, consulte os seguintes artigos:

• Instalar e gerenciar pacotes NuGet com a CLI do dotnet
• Fluxo de trabalho de consumo de pacote
• Localizar e avaliar pacotes NuGet para seu projeto
• PackageReference em arquivos de projeto