Compartilhar via


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 outros desenvolvedores disponibilizam para uso por outros desenvolvedores em seus respectivos projetos. Para obter mais informações, confira O que é o NuGet. Este guia de início rápido descreve como instalar o popular pacote NuGety Newtonsoft.Json NuGet em um projeto .NET usando 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 para nuget.org/packages para encontrar pacotes que você pode reutilizar em seus próprios aplicativos. Você pode pesquisar diretamente em https://nuget.org ou localizar 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 . NET SDK, que fornece a ferramenta de linha de comando dotnet. No Visual Studio 2017 em diante, a CLI do dotnet é instalada automaticamente com qualquer carga de trabalho relacionada ao .NET ou .NET Core.

Criar um projeto

Os pacotes NuGet podem ser instalados em um projeto do .NET. Para este passo a passo, crie um projeto de console do .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:

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

Adicionar o pacote do NuGet Newtonsoft.Json

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

    dotnet add package Newtonsoft.Json
    
  2. Após a conclusão do comando, abra o arquivo Nuget.Quickstart.csproj no Visual Studio para ver a referência do pacote NuGet adicionada:

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

Use a API Newtonsoft.Json no aplicativo

  1. No Visual Studio, abra o arquivo Program.cs e adicione as seguintes instruções à parte superior do arquivo:

    using Newtonsoft.Json;
    
  2. Adicione o seguinte código para substituir a instrução 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. Salve o arquivo e compile e execute o aplicativo usando o comando dotnet run. A saída é a representação JSON do objeto Account no código:

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

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

Encontre mais vídeos sobre o NuGet no Channel 9 e no YouTube.

Próximas etapas

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