Penyiapan Lingkungan

Topik ini menyiapkan lingkungan pengembangan C# dari nol, mulai dari pemasangan .NET SDK, pemilihan editor, sampai perintah dasar dotnet CLI. Setelah seluruh langkah dijalankan, proyek konsol pertama dapat dibuat, dibangun, dan dijalankan langsung dari terminal, sehingga seluruh contoh kode pada jalur ini dapat dicoba di komputer sendiri.

Memasang .NET SDK#

Paket yang perlu dipasang adalah .NET SDK (software development kit), yaitu paket yang berisi kompilator, template proyek, dan dotnet CLI. SDK berbeda dengan runtime. Runtime hanya menjalankan program yang sudah jadi, sedangkan SDK membangun program baru dan ikut memasang runtime di dalamnya. Karena itu, pemasangan yang hanya berisi runtime membuat perintah untuk membuat proyek tidak tersedia.

Installer resmi tersedia pada situs dotnet.microsoft.com untuk tiga sistem operasi utama. Pada Windows, pemasangan dapat dilakukan melalui winget atau installer grafis, pada macOS melalui paket .pkg, dan pada Linux melalui manajer paket distribusi seperti apt atau dnf. Setelah pemasangan selesai, buka terminal baru dan periksa versi SDK yang aktif:

# memeriksa versi SDK yang sedang aktif
dotnet --version

10.0.403

Bila lebih dari satu SDK terpasang, semua versinya dapat didaftar sekaligus. Keluaran perintah berikut difilter agar hanya menampilkan nomor versi, tanpa jalur folder tempat setiap SDK tersimpan:

# menampilkan nomor versi SDK saja, tanpa jalur foldernya
dotnet --list-sdks | cut -d' ' -f1

8.0.427
10.0.403

Versi genap .NET seperti 8 dan 10 berstatus long-term support (LTS), yaitu versi yang didukung selama tiga tahun, sedangkan versi ganjil berstatus STS (standard term support) dengan dukungan delapan belas bulan. Jalur ini menargetkan .NET 10, sehingga seluruh contoh diuji pada SDK versi 10.

Memilih editor#

Editor hanya bertugas menyunting kode, sedangkan kompilasi dan eksekusi selalu dikerjakan oleh dotnet CLI. Karena pembagian tugas itu, editor mana pun yang dipilih, perintah-perintah pada bagian berikutnya tetap berlaku tanpa perubahan. Tiga pilihan yang umum digunakan dirangkum pada tabel berikut.

Untuk memulai, VS Code dengan ekstensi C# Dev Kit adalah titik awal yang ringan dan lintas platform, sedangkan Visual Studio dan Rider menyediakan IDE penuh dengan alat refaktor serta debugger yang lebih terpadu. Apa pun pilihannya, editor bekerja pada satu folder proyek yang sama, dan terminal tetap digunakan untuk menjalankan perintah dotnet. Penyorotan sintaks, pelengkapan otomatis, dan debugger visual adalah kenyamanan yang ditambahkan editor, bukan syarat agar program dapat dibangun.

Perintah dasar dotnet CLI#

dotnet adalah command-line interface (CLI), yakni antarmuka berbasis teks untuk mengoperasikan seluruh perkakas .NET dari terminal. Tiga subperintahnya yang paling sering digunakan adalah dotnet new untuk membuat proyek dari template, dotnet build untuk mengompilasi proyek, dan dotnet run untuk mengompilasi sekaligus menjalankannya.

Contoh berikut membuat proyek konsol bernama HaloApp lalu menjalankannya. Di komputer sendiri, proyek cukup dibuat langsung di folder kerja pilihan dengan dotnet new console -o HaloApp, kemudian dijalankan dari dalam folder proyeknya. Pada sandbox, proyek dibuat di folder sementara agar berkas latihan tidak bercampur dengan berkas lain:

folder_latihan=$(mktemp -d)
cd "$folder_latihan"
# hanya baris "created successfully" yang ditampilkan, tanpa keluaran pemulihan NuGet
dotnet new console -o HaloApp | grep -E "created successfully"
cd HaloApp
dotnet run

The template "Console App" was created successfully.
Hello, World!

Perintah dotnet new console membuat proyek dari template konsol, sedangkan opsi -o menentukan nama folder proyeknya. Template menghasilkan struktur folder yang minimal:

HaloApp/
├── HaloApp.csproj   → deskripsi proyek dan versi .NET yang ditargetkan
├── obj/             → berkas perantara hasil proses build
└── Program.cs       → titik masuk program

Isi Program.cs bawaan hanya satu baris, dan baris itulah yang menghasilkan teks Hello, World! pada keluaran di atas:

Console.WriteLine("Hello, World!");

Hello, World!

Perintah dotnet run menggabungkan dua pekerjaan, yaitu build dan eksekusi, sehingga praktis untuk siklus sunting lalu jalankan. Bila hanya kompilasi yang diinginkan, misalnya sebelum membagikan berkas keluarannya, dotnet build digunakan sebagai berikut:

# hanya status build yang ditampilkan, tanpa jalur berkas dan durasi
dotnet build | grep -E "Build succeeded|Error"

Build succeeded.
    0 Error(s)

Hasil build adalah berkas .dll di folder bin yang berisi IL, sehingga ia dapat disalin ke komputer lain yang telah memasang runtime .NET. Ketiga subperintah tadi sudah cukup untuk mengikuti seluruh contoh pada jalur ini, sedangkan subperintah lain seperti dotnet test dan dotnet publish menyusul pada tahap yang lebih lanjut.

Kesalahan umum#

• Perintah dotnet tidak dikenali terminal setelah pemasangan. Terminal yang sudah terbuka sebelum pemasangan masih menggunakan daftar PATH yang lama, sehingga lokasi SDK baru tidak tercakup. Perbaikannya berupa menutup terminal lalu membuka terminal baru, kemudian mengulangi pemeriksaan versi. Bila pesan kesalahan tetap muncul, pemasangan SDK perlu diulang dari installer resminya.
• dotnet run dijalankan dari folder yang salah. Perintah ini mencari berkas proyek .csproj di folder aktif, dan bila tidak ditemukan keluarannya adalah pesan error Couldn't find a project to run. Perbaikannya berupa masuk dahulu ke folder proyek, atau menyebutkan jalurnya melalui opsi --project.
• Memasang runtime saja tanpa SDK. Perintah dotnet new tidak tersedia karena template dan kompilator melekat pada SDK, sehingga proses belajar langsung terhenti di langkah pertama. Perbaikannya berupa memasang SDK lengkap sebagaimana dijelaskan pada bagian Memasang .NET SDK di atas.

Ringkasan#

• .NET SDK berisi kompilator, template proyek, dan dotnet CLI, sekaligus menyertakan runtime untuk menjalankan program.
• Editor menyunting kode, sedangkan build dan eksekusi tetap dikerjakan dotnet CLI, sehingga pilihan editor tidak mengikat.
• dotnet new membuat proyek dari template, dotnet build mengompilasi, dan dotnet run mengompilasi sekaligus menjalankan.
• Hasil build berupa berkas .dll berisi IL di folder bin, siap dijalankan pada komputer yang memasang runtime .NET.

Referensi#

• Install .NET on Windows, Linux, and macOS — Microsoft — Panduan resmi pemasangan SDK untuk setiap sistem operasi.
• dotnet command — Microsoft — Rujukan lengkap seluruh subperintah dotnet CLI beserta opsinya.