Mulai cepat: Menginstal dan menggunakan paket di Visual Studio untuk Mac

Paket NuGet berisi kode yang dapat digunakan kembali yang disediakan pengembang lain untuk Anda gunakan dalam proyek Anda. Lihat Apa itu NuGet? untuk latar belakang. Paket diinstal ke dalam Visual Studio untuk proyek Mac menggunakan NuGet Package Manager. Artikel ini menunjukkan proses menggunakan paket Newtonsoft.Json populer dan proyek konsol .NET Core. Proses yang sama berlaku untuk proyek Xamarin atau .NET Core lainnya.

Setelah diinstal, lihat paket dalam kode dengan using <namespace> namespace <> layanan khusus untuk paket yang Anda gunakan. Setelah referensi dibuat, Anda dapat memanggil paket melalui API-nya.

Tip

Mulailah dengan nuget.org: Menelusuri nuget.org adalah bagaimana pengembang .NET biasanya menemukan komponen yang dapat mereka gunakan kembali di aplikasi mereka sendiri. Anda dapat mencari nuget.org secara langsung atau menemukan dan menginstal paket dalam Visual Studio seperti yang ditunjukkan dalam artikel ini. Untuk informasi umum, lihat Menemukan dan mengevaluasi paket NuGet.

Prasyarat

• Visual Studio 2019 untuk Mac.

Anda dapat menginstal edisi Komunitas 2019 secara gratis dari visualstudio.com atau menggunakan edisi Professional atau Enterprise.

Jika Anda menggunakan Visual Studio di Windows, lihat Menginstal dan menggunakan paket di Visual Studio (hanya Windows).

Membuat proyek

Paket NuGet dapat diinstal ke dalam proyek .NET apa pun, asalkan paket mendukung kerangka kerja target yang sama dengan proyek.

Untuk panduan ini, gunakan aplikasi .NET Core Console sederhana. Buat proyek di Visual Studio untuk Mac menggunakan Solusi Baru File>... , pilih templat Aplikasi .NET Core > App > Console. Klik Berikutnya. Terima nilai default untuk Kerangka Kerja Target saat diminta.

Visual Studio membuat proyek, yang terbuka di Penjelajah Solusi.

Menambahkan paket Newtonsoft.Json NuGet

Untuk menginstal paket, Anda menggunakan NuGet Package Manager. Saat Anda menginstal paket, NuGet merekam dependensi dalam file proyek atau packages.config file Anda (tergantung pada format proyek). Untuk informasi selengkapnya, lihat Gambaran umum dan alur kerja konsumsi paket.

Pengelola Paket NuGet

1. Di Penjelajah Solusi, klik kanan Dependensi dan pilih Tambahkan Paket....

   

2. Pilih "nuget.org" sebagai sumber Paket di sudut kiri atas dialog, dan cari Newtonsoft.Json, pilih paket tersebut dalam daftar, dan pilih Tambahkan Paket...:

   

   Jika Anda menginginkan informasi selengkapnya tentang Pengelola Paket NuGet, lihat Menginstal dan mengelola paket menggunakan Visual Studio untuk Mac.

Menggunakan Api Newtonsoft.Json di aplikasi

Dengan paket Newtonsoft.Json dalam proyek, Anda dapat memanggil metodenya JsonConvert.SerializeObject untuk mengonversi objek menjadi string yang dapat dibaca manusia.

1. Program.cs Buka file (terletak di Solution Pad) dan ganti konten file dengan kode berikut:

   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. Buat dan jalankan aplikasi dengan memilih Jalankan > Mulai Debugging:

3. Setelah aplikasi berjalan, Anda akan melihat output JSON berseri muncul di konsol:

Langkah berikutnya

Selamat atas penginstalan dan penggunaan paket NuGet pertama Anda!

Menginstal dan mengelola paket menggunakan Visual Studio untuk Mac

Untuk menjelajahi lebih lanjut yang ditawarkan NuGet, pilih tautan di bawah ini.

• Gambaran umum dan alur kerja konsumsi paket
• Referensi paket dalam file proyek