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

Artigo
08/10/2023

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

Em Gerenciador de Soluções, clique com o botão direito do mouse em Dependências e escolha Adicionar Pacotes....
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...:

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.

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);
        }
    }
}

Crie e execute o aplicativo selecionando Executar > Iniciar Depuração:
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!

Instalar e gerenciar pacotes usando Visual Studio para Mac

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

Compartilhar via