Menggunakan .NET

ServBay menyediakan lingkungan pengembangan yang mudah dan efisien bagi para developer .NET di macOS. Dengan sistem manajemen paket dari ServBay, Anda dapat dengan mudah menginstal, mengelola, dan menjalankan berbagai versi .NET SDK secara bersamaan, termasuk .NET modern (yakni .NET Core dan versi-versi berikutnya) serta kerangka kerja klasik Mono untuk memenuhi tuntutan berbagai jenis proyek.

Ringkasan

Sejarah Platform .NET dan Dukungannya di macOS

.NET adalah sebuah platform pengembangan serbaguna yang dikembangkan oleh Microsoft. Mengenal sejarah dan evolusi platform ini sangat penting untuk memahami dukungan di macOS:

1. .NET Framework (Versi Asli): Dirilis pertama kali pada tahun 2002 sebagai platform pengembangan andalan Microsoft, namun hanya dirancang untuk sistem operasi Windows. Terdiri dari Common Language Runtime (CLR) dan koleksi besar class library (FCL). Aplikasi .NET Framework biasanya tidak dapat dijalankan langsung di macOS.

2. Mono (Pelopor Cross-Platform): Agar aplikasi .NET dapat berjalan di Linux maupun macOS, komunitas (awalnya oleh Ximian, kemudian didukung Novell dan Xamarin/Microsoft) mengembangkan Mono. Mono merupakan implementasi terbuka dan lintas platform dari .NET Framework. Dengan Mono, developer bisa menjalankan dan membangun aplikasi berbasis .NET Framework (terutama C#) di macOS dan Linux. Untuk skenario yang membutuhkan aplikasi atau pustaka lawas di macOS, Mono masih tetap menjadi solusi yang berguna.

3. .NET Core / .NET 5+ (Standar Modern Cross-Platform): Menyadari pentingnya lintas platform, Microsoft membangun .NET Core dari awal. Ini adalah .NET modern, performa tinggi, open source dan sepenuhnya lintas sistem operasi (Windows, macOS, Linux). Setelah .NET Core 3.1, Microsoft menamainya ulang menjadi .NET (mulai versi 5—melewati 4 agar tidak bingung dengan .NET Framework 4.x). Kini, istilah .NET SDK biasanya mengacu pada versi modern, lintas platform ini (.NET 5, 6, 7, 8, 9, 10, dst). Ini adalah platform yang direkomendasikan Microsoft untuk semua pengembangan aplikasi baru, termasuk di macOS.

Dukungan ServBay untuk .NET

ServBay memahami sejarah .NET dan kebutuhan developer yang beragam, oleh sebab itu menawarkan:

• Paket SDK .NET Modern: Mendukung berbagai versi .NET (Core) (.NET SDK 2.0 hingga 10.0), memungkinkan Anda menggunakan C#, F#, dan ASP.NET Core terbaru untuk pengembangan lintas platform.
• Paket Mono: Menyediakan runtime Mono (contohnya Mono 6) untuk mendukung proyek berbasis .NET Framework lawas atau pustaka spesifik di macOS, termasuk dukungan terbatas untuk ASP.NET lawas (Web Forms, System.Web MVC).
• Instalasi Paralel: Anda bisa menginstal beberapa versi .NET SDK dan Mono secara bersamaan.
• Kontrol Versi Per-Proyek: Tentukan versi .NET SDK modern menggunakan file .servbay.config di masing-masing proyek.
• Manajemen yang Disederhanakan: Melalui antarmuka grafis ServBay, Anda dapat melihat, instal, dan hapus setiap versi SDK dan Mono secara intuitif.

Mengakses Paket .NET

1. Buka aplikasi ServBay.
2. Pada bilah navigasi sebelah kiri, klik Paket (Packages).
3. Di halaman Paket, scroll ke bawah atau pilih Languages -> .NET di daftar kategori sebelah kiri.
4. Di area kanan akan tampil semua daftar paket .NET SDK dan Mono yang tersedia.

Menginstal .NET SDK

Daftar paket menampilkan status tiap versi .NET SDK dengan jelas:

• Nama Paket: Contoh .NET SDK 8.0 atau Mono 6.
• Versi: Nomor versi spesifik dari paket tersebut.
• Status: Menunjukkan Installed (terpasang) atau Not Installed (belum terpasang).
• Kontrol: Tersedia tombol tindakan.

Untuk menginstal .NET SDK yang belum terpasang (misal .NET SDK 10.0):

1. Temukan versi yang diinginkan dalam daftar.
2. Pastikan statusnya Not Installed.
3. Klik ikon Download/Install (Unduh/Instal) di paling kanan baris tersebut (biasanya berikon panah ke bawah).
4. ServBay akan mulai mengunduh dan menginstal SDK tersebut. Proses ini dapat memakan waktu tergantung kecepatan internet dan ukuran SDK.
5. Setelah instalasi berhasil, status berubah menjadi Installed dan ikon kontrol berganti menjadi ikon Uninstall (Hapus) (tempat sampah).

Mengelola SDK yang Telah Terpasang

• Melihat Versi Terpasang: Status Installed di daftar menandakan semua versi .NET SDK atau Mono yang sudah ada di lingkungan Anda.
• Menghapus SDK: Jika Anda tidak membutuhkan versi SDK tertentu, cukup klik ikon Uninstall (Hapus) (tempat sampah) di barisnya dan konfirmasi untuk menghapus dari sistem.

Menggunakan .NET SDK yang Sudah Terpasang

Setelah instalasi, ServBay biasanya secara otomatis menambahkan tool baris perintah dotnet dari SDK ke variabel lingkungan PATH sistem (selama lingkungan ServBay aktif). Artinya, Anda dapat menggunakan perintah dotnet langsung di Terminal macOS.

Contoh Perintah Umum:

1. Cek Daftar Versi SDK yang Tersedia: Buka terminal dan jalankan:

   dotnet --list-sdks

   Ini akan menampilkan semua versi SDK .NET yang terinstal serta lokasinya yang dikelola oleh ServBay.

2. Cek Versi SDK Aktif (biasanya yang terbaru atau diatur sebagai global):

   dotnet --version

3. Membuat Aplikasi Console Baru (menggunakan SDK default):

   # Membuat direktori proyek bernama MyConsoleApp
   mkdir MyConsoleApp
   cd MyConsoleApp
   
   # Membuat proyek console baru dengan SDK default
   dotnet new console

4. Menjalankan Aplikasi:

   dotnet run

5. Menggunakan Versi SDK Tertentu (jika diperlukan): Jika proyek Anda memerlukan versi SDK tertentu, Anda dapat menspesifikkan melalui file global.json. Buat file global.json di root proyek dengan isi seperti berikut:

   {
     "sdk": {
       "version": "8.0.408" // Versi SDK yang dibutuhkan, yang sudah terpasang
     }
   }

   Ketika menjalankan perintah dotnet di direktori proyek tersebut, versi SDK yang dipilih akan mengikuti pengaturan di global.json.

Dukungan Mono

Selain SDK .NET standar, ServBay juga menyediakan opsi instalasi Mono. Mono adalah implementasi open source lintas platform dari .NET Framework. Jika Anda perlu menjalankan atau membangun aplikasi yang bergantung pada fitur .NET Framework tertentu, Mono bisa diinstal dan digunakan dari ServBay. Proses instal dan hapus Mono sama persis seperti SDK .NET.

Mono terutama dipakai untuk mengeksekusi program hasil kompilasi .NET Framework (.exe file) atau menggunakan tool tertentu yang membutuhkan lingkungan Mono, termasuk menjalankan aplikasi ASP.NET lawas.

1. Cek Versi Mono:

   mono --version

2. Menjalankan File Eksekusi .NET Framework: Misalkan Anda punya file LegacyApp.exe hasil kompilasi .NET Framework:

   mono LegacyApp.exe

3. Menjalankan Aplikasi ASP.NET Lawas (dukungan terbatas): Mono menyertakan server web sederhana bernama xsp untuk menjalankan aplikasi Web Forms atau System.Web MVC pada lingkungan pengembangan. Anda juga bisa melakukan integrasi dengan Nginx + FastCGI atau Apache + mod_mono.

   Catatan penting:

   • Cara ini memiliki keterbatasan kompatibilitas untuk ASP.NET Framework. Tidak semua aplikasi dapat berjalan sempurna, terutama jika ada fitur spesifik Windows.
   • Performa cenderung lebih rendah dibandingkan dijalankan di Windows/IIS.
   • Tidak disarankan untuk pengembangan proyek baru. Untuk web modern gunakanlah ASP.NET Core.
   • ServBay menyediakan dokumentasi lengkap: Cara Menjalankan Situs ASP.NET Framework 4.x di macOS.

   Jika Anda tetap ingin menjalankannya (misal untuk testing atau maintenance), bisa menggunakan perintah berikut (tergantung aplikasi & konfigurasi):

   # Contoh: Jalankan server xsp di direktori tertentu
   # cd /Applications/ServBay/www/your_legacy_aspnet_app
   # xsp4 --port 8080 # (xsp4 untuk .NET 4.x)

Integrasi Server Web (ASP.NET Core)

Dengan .NET SDK yang diinstal melalui ServBay, Anda dapat mengembangkan aplikasi web ASP.NET Core. Untuk deployment, aplikasi Anda bisa dikombinasikan dengan server web internal ServBay (seperti Nginx, Caddy, atau Apache):

1. Gunakan perintah dotnet publish untuk membangun aplikasi ASP.NET Core Anda.
2. Tambahkan Website baru di ServBay.
3. Atur agar website tersebut menjadi reverse proxy yang meneruskan request ke port Kestrel server aplikasi ASP.NET Core Anda (misal http://localhost:5000). Cara mengatur reverse proxy akan berbeda tergantung server web yang digunakan (Nginx, Caddy, atau Apache).

Silakan lihat dokumentasi ServBay mengenai penambahan website dan setting reverse proxy untuk detailnya.

Kesimpulan

ServBay sangat menyederhanakan pengaturan dan manajemen lingkungan pengembangan .NET di macOS. Dengan antarmuka yang intuitif, developer dapat dengan mudah menginstal, berganti, dan menghapus berbagai versi .NET SDK serta Mono, sehingga Anda bisa lebih focus pada pengembangan dan pengujian aplikasi C#, F#, dan ASP.NET Core.