Tutorial: Membuat pustaka kelas .NET menggunakan Visual Studio untuk Mac

Penting

Microsoft telah mengumumkan penghentian Visual Studio untuk Mac. Visual Studio untuk Mac tidak akan lagi didukung mulai 31 Agustus 2024. Alternatifnya meliputi:

• Visual Studio Code dengan C# Dev Kit dan ekstensi terkait, seperti .NET MAUI dan Unity.
• Visual Studio berjalan di Windows di VM di Mac.
• Visual Studio berjalan di Windows di VM di Cloud.

Untuk informasi selengkapnya, lihat Pengumuman penghentian Visual Studio untuk Mac.

Dalam tutorial ini, Anda membuat pustaka kelas yang berisi satu metode penanganan string.

Pustaka kelas menentukan jenis dan metode yang dipanggil oleh aplikasi. Jika pustaka menargetkan .NET Standard 2.0, pustaka dapat dipanggil oleh implementasi .NET apa pun (termasuk .NET Framework) yang mendukung .NET Standard 2.0. Jika pustaka menargetkan .NET 5, pustaka dapat dipanggil oleh aplikasi apa pun yang menargetkan .NET 5. Tutorial ini menunjukkan cara menargetkan .NET 5.

Catatan

Umpan balik Anda sangat dihargai. Ada dua cara untuk memberikan umpan balik kepada tim pengembangan di Visual Studio untuk Mac:

• Di Visual Studio untuk Mac, pilih Bantuan>Laporkan Masalah dari menu atau Laporkan Masalah dari layar Selamat Datang, yang membuka jendela untuk mengajukan laporan bug. Anda dapat melacak umpan balik Anda di portal Komunitas Pengembang.
• Untuk membuat saran, pilih Bantuan>Berikan Saran dari menu atau Berikan Saran dari layar Selamat Datang, yang membawa Anda ke halaman web Komunitas Pengembang Visual Studio for Mac.

Prasyarat

• Instal Visual Studio untuk Mac versi 8.8 atau yang lebih baru. Pilih opsi untuk menginstal .NET Core. Menginstal Xamarin bersifat opsional untuk pengembangan .NET. Untuk informasi lebih lanjut, lihat sumber daya berikut ini:

  • Tutorial: Menginstal Visual Studio untuk Mac.
  • Versi macOS yang didukung.
  • Versi .NET didukung oleh Visual Studio untuk Mac.

Membuat solusi dengan proyek pustaka kelas

Solusi Visual Studio berfungsi sebagai kontainer untuk satu atau beberapa proyek. Buat solusi dan proyek pustaka kelas dalam solusi. Anda akan menambahkan proyek terkait tambahan ke solusi yang sama nanti.

1. Mulai Visual Studio untuk Mac.

2. Di jendela mulai, pilih Proyek Baru.

3. Dalam dialog Pilih templat untuk proyek baru Anda pilih Pustaka Kelas Pustaka>Web dan Konsol>, lalu pilih Berikutnya.

   

4. Dalam dialog Konfigurasikan Pustaka Kelas baru Anda, pilih .NET 5.0, dan pilih Berikutnya.

5. Beri nama proyek "StringLibrary" dan solusi "ClassLibraryProjects". Biarkan Buat direktori proyek dalam direktori solusi dipilih. Pilih Buat.

   

6. Dari menu utama, pilih Lihat>Solusi, dan pilih ikon dock untuk menjaga pad tetap terbuka.

   

7. Di pad Solusi, perluas simpul StringLibrary untuk mengungkapkan file kelas yang disediakan oleh templat, Class1.cs. ctrl-klik file, pilih Ganti nama dari menu konteks, dan ganti nama file menjadi StringLibrary.cs. Buka file dan ganti konten dengan kode berikut:

   using System;
   
   namespace UtilityLibraries
   {
       public static class StringLibrary
       {
           public static bool StartsWithUpper(this string str)
           {
               if (string.IsNullOrWhiteSpace(str))
                   return false;
   
               char ch = str[0];
               return char.IsUpper(ch);
           }
       }
   }
   

8. Tekan ⌘S (perintah+S) untuk menyimpan file.

9. Pilih Kesalahan di margin di bagian bawah jendela IDE untuk membuka panel Kesalahan . Pilih tombol Output Build.

   

10. Pilih Bangun>Build Semua dari menu.

    Solusinya dibangun. Panel output build menunjukkan bahwa build berhasil.

    

Menambahkan aplikasi konsol ke solusi

Tambahkan aplikasi konsol yang menggunakan pustaka kelas. Aplikasi akan meminta pengguna untuk memasukkan string dan melaporkan apakah string dimulai dengan karakter huruf besar.

1. Di pad Solusi, ctrl-klikClassLibraryProjects solusi. Tambahkan proyek Aplikasi Konsol baru dengan memilih templat dari templat Aplikasi Web dan Konsol>, dan pilih Berikutnya.

2. Pilih .NET 5.0 sebagai Kerangka Kerja Target dan pilih Berikutnya.

3. Beri nama proyek ShowCase. Pilih Buat untuk membuat proyek dalam solusi.

   

4. Buka file Program.cs. Ganti kode dengan kode berikut:

   using System;
   using UtilityLibraries;
   
   class Program
   {
       static void Main(string[] args)
       {
           int row = 0;
   
           do
           {
               if (row == 0 || row >= 25)
                   ResetConsole();
   
               string? input = Console.ReadLine();
               if (string.IsNullOrEmpty(input)) break;
               Console.WriteLine($"Input: {input} {"Begins with uppercase? ",30}: " +
                                 $"{(input.StartsWithUpper() ? "Yes" : "No")}{Environment.NewLine}");
               row += 3;
           } while (true);
           return;
   
           // Declare a ResetConsole local method
           void ResetConsole()
           {
               if (row > 0)
               {
                   Console.WriteLine("Press any key to continue...");
                   Console.ReadKey();
               }
               Console.Clear();
               Console.WriteLine($"{Environment.NewLine}Press <Enter> only to exit; otherwise, enter a string and press <Enter>:{Environment.NewLine}");
               row = 3;
           }
       }
   }
   

   Program ini meminta pengguna untuk memasukkan string. Ini menunjukkan apakah string dimulai dengan karakter huruf besar. Jika pengguna menekan tombol enter tanpa memasukkan string, aplikasi berakhir, dan jendela konsol ditutup.

   Kode menggunakan row variabel untuk mempertahankan hitungan jumlah baris data yang ditulis ke jendela konsol. Setiap kali lebih besar dari atau sama dengan 25, kode akan menghapus jendela konsol dan menampilkan pesan kepada pengguna.

Menambahkan referensi proyek

Awalnya, proyek aplikasi konsol baru tidak memiliki akses ke pustaka kelas. Untuk mengizinkannya memanggil metode di pustaka kelas, buat referensi proyek ke proyek pustaka kelas.

1. Di pad Solusi, ctrl-klik simpul Dependensi dari proyek ShowCase baru. Di menu konteks, pilih Tambahkan Referensi.

2. Dalam dialog Referensi, pilih StringLibrary dan pilih OK.

Menjalankan aplikasi

1. ctrl-klik proyek ShowCase dan pilih Jalankan proyek dari menu konteks.

2. Cobalah program dengan memasukkan string dan menekan enter, lalu tekan enter untuk keluar.

   

Sumber Daya Tambahan:

• Mengembangkan pustaka dengan .NET CLI
• Catatan Rilis Visual Studio 2019 untuk Mac
• Versi Standar .NET dan platform yang mereka dukung.

Langkah berikutnya

Dalam tutorial ini, Anda membuat solusi dan proyek pustaka, dan menambahkan proyek aplikasi konsol yang menggunakan pustaka. Dalam tutorial berikutnya, Anda menambahkan proyek pengujian unit ke solusi.

Menguji pustaka kelas .NET menggunakan Visual Studio untuk Mac