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

  • Artigo

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:

Instalar e usar pacotes usando a CLI do dotnet