Início Rápido: Instalar e usar um pacote no Visual Studio para Mac

Os pacotes NuGet contém código reutilizável que outros desenvolvedores disponibilizam para uso em seus projetos. Consulte O que há de novo no NuGet para obter mais informações. Os pacotes são instalados em um projeto de Visual Studio para Mac usando o NuGet Gerenciador de Pacotes. Este artigo demonstra o processo usando o popular pacote Newtonsoft.Json e um projeto de console do .NET Core. O mesmo processo se aplica a qualquer outro projeto do Xamarin ou do .NET Core.

Depois de instalado, consulte o pacote no código com using <namespace> em que <namespace> é específico para o pacote que você está usando. Depois que a referência é feita, você pode chamar o pacote por meio de sua API.

Dica

Comece com nuget.org: navegar nuget.org é como os desenvolvedores do .NET normalmente encontram componentes que podem reutilizar em seus próprios aplicativos. Você pode pesquisar no nuget.org diretamente ou localizar e instalar pacotes de dentro do Visual Studio, conforme mostrado neste artigo. Para saber mais, confira Localizar e avaliar pacotes do NuGet.

Pré-requisitos

  • Visual Studio 2019 para Mac.

É possível instalar a edição Community 2019 gratuitamente em visualstudio.com ou usar as edições Professional ou Enterprise.

Se você estiver usando Visual Studio no Windows, consulte Instalar e usar um pacote em Visual Studio (somente Windows).

Criar um projeto

É possível instalar pacotes do NuGet em qualquer projeto .NET, desde que o pacote ofereça suporte à mesma estrutura de destino do projeto.

Para este passo a passo, use um aplicativo simples do Console do .NET Core. Crie um projeto em Visual Studio para Mac usando a Nova Solução de Arquivo>..., selecione o modelo de Aplicativo do Console de Aplicativo > do .NET Core>. Clique em Próximo. Aceite os valores padrão da Estrutura de Destino quando solicitado.

O Visual Studio criará o projeto, que será aberto no Gerenciador de Soluções.

Adicionar o pacote do NuGet Newtonsoft.Json

Para instalar o pacote, use o NuGet Gerenciador de Pacotes. Ao instalar um pacote, o NuGet registra a dependência no arquivo de projeto ou em um arquivo packages.config (dependendo do formato do projeto). Para obter mais informações, veja Visão geral e fluxo de trabalho do consumo de pacote.

Gerenciador de Pacotes NuGet

  1. Em Gerenciador de Soluções, clique com o botão direito do mouse em Dependências e escolha Adicionar Pacotes....

    Manage NuGet Packages command for project References

  2. Escolha "nuget.org" como a origem do pacote no canto superior esquerdo da caixa de diálogo e pesquise Newtonsoft.Json, selecione esse pacote na lista e selecione Adicionar Pacotes...:

    Locating Newtonsoft.Json package

    Se você quiser obter mais informações sobre o NuGet Gerenciador de Pacotes, consulte Instalar e gerenciar pacotes usando Visual Studio para Mac.

Use a API Newtonsoft.Json no aplicativo

Com o pacote Newtonsoft.Json no projeto, você pode chamar seu método JsonConvert.SerializeObject para converter um objeto em uma cadeia de caracteres legível.

  1. Abra o Program.cs arquivo (localizado no Painel de Soluções) e substitua o conteúdo do arquivo pelo seguinte código:

    using System;
    using Newtonsoft.Json;
    
    namespace NuGetDemo
    {
        public class Account
        {
            public string Name { get; set; }
            public string Email { get; set; }
            public DateTime DOB { get; set; }
        }
    
        class Program
        {
            static void Main(string[] args)
            {
                Account account = new Account()
                {
                    Name = "Joe Doe",
                    Email = "joe@test.com",
                    DOB = new DateTime(1976, 3, 24)
                };
                string json = JsonConvert.SerializeObject(account);
                Console.WriteLine(json);
            }
        }
    }
    
  2. Crie e execute o aplicativo selecionando Executar > Iniciar Depuração:

  3. Depois que o aplicativo for executado, você verá a saída JSON serializada aparecer no console:

Output of the Console app

Próximas etapas

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

Para ver o que mais o NuGet tem a oferecer, selecione os links abaixo.