Partilhar via

Guia de início rápido: instalar e usar um pacote com a CLI 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 é NuGet. Este guia de início rápido descreve como instalar o popular pacote Newtonsoft.Json NuGet em um projeto .NET usando o comando dotnet add package .

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

Sugestão

Navegue por 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 comandos dotnet. A partir do Visual Studio 2017, a CLI dotnet é instalada automaticamente com qualquer carga de trabalho relacionada ao .NET ou .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 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ê deve ver a saída Hello, World!.

Adicione o pacote Newtonsoft.Json NuGet

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

    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>

Utilize a API Newtonsoft.Json na aplicação

  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óximos passos

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

Instalar e usar pacotes usando a CLI dotnet

  • Last updated on