Partilhar via

Guia de início rápido: instalar e usar um pacote com a CLI dotnet

Neste quickstart, instala o popular pacote NuGet Newtonsoft.Json num projeto .NET. Os pacotes NuGet contêm código binário compilado que os desenvolvedores disponibilizam para outros desenvolvedores usarem em seus projetos. Para mais informações, consulte Uma introdução ao NuGet.

Para instalar o pacote, utiliza-se o comando dotnet package add, que faz parte da interface de linha de comandos dotnet (CLI).

Sugestão

Navegue por nuget.org/packages para encontrar pacotes que você pode reutilizar em seus próprios aplicativos. Pode pesquisar diretamente em https://nuget.org/packages, ou pode encontrar e instalar pacotes a partir de Visual Studio. Para obter mais informações, consulte Localizar e avaliar pacotes NuGet para seu projeto.

Pré-requisitos

O .NET SDK, que fornece a CLI dotnet. No Visual Studio, a CLI dotnet instala-se automaticamente com quaisquer cargas de trabalho relacionadas com .NET.

Criar um projeto

Podes instalar pacotes NuGet num projeto .NET. Para este início rápido, siga os seguintes passos para criar um projeto básico de consola .NET usando a dotnet CLI:

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

  2. Abre uma janela do prompt de comandos e vai à nova pasta.

  3. Crie o projeto usando o seguinte comando:

    dotnet new console

  4. Use dotnet run para testar o aplicativo. O comando escreve a seguinte saída no ecrã: Hello, World!.

Adicione o pacote Newtonsoft.Json NuGet

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

    dotnet package add Newtonsoft.Json

    Se estiver a utilizar o .NET 9 ou uma versão anterior, utilize em vez disso a forma na qual o verbo aparece em primeiro lugar:

    dotnet add package Newtonsoft.Json

  2. Depois de o comando terminar, abra o ficheiro Nuget.Quickstart.csproj na Visual Studio ou num editor de texto. Verifique a referência adicional do pacote NuGet:

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

Utilize a API Newtonsoft.Json na aplicação

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

  1. No Visual Studio ou num editor de texto, abra o ficheiro Program.cs. Adicione a seguinte linha no topo do ficheiro:

    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. Guarda o ficheiro e depois constrói e executa a aplicação 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"
}

Para vídeos sobre o uso do NuGet para gestão de pacotes, veja .NET Gestão de Pacotes com NuGet para Iniciantes e NuGet para Iniciantes.

Conteúdo relacionado

Para saber mais sobre a instalação e utilização de pacotes NuGet usando a CLI dotnet, consulte os seguintes artigos:

  • Last updated on