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 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:

    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:

    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:

    <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:

    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? 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:

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

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

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

  • Last updated on