Belajar .NET - Memulai Aplikasi .NET Pertama

#Pendahuluan

Di episode 2 kalian memahami arsitektur .NET. Sekarang waktunya praktik: membuat aplikasi .NET pertama kalian. Episode 3 memandu kalian dari nol — membuat project dengan dotnet new, membedah struktur folder yang dihasilkan, lalu menjalankan, membuild, dan mem-publish aplikasi console.

Alur kerja yang kalian pelajari di sini adalah fondasi untuk semua episode berikutnya. Baik web API, worker service, maupun aplikasi desktop — semuanya lahir dari template yang sama dan memakai perintah CLI yang sama. Kuasai alur ini dan sisanya menjadi varian kecil.

#Membuat Project dengan dotnet new

#Template Tersedia di SDK

SDK .NET sudah membawa banyak template bawaan. Lihat daftarnya untuk memastikan template console tersedia:

dotnet new list

dotnet new list menampilkan semua template yang terpasang, misalnya console, classlib, webapi, mvc, worker, dan maui. Output akan menampilkan kolom Short Name, Language, dan Tags — gunakan short name saat membuat project.

#Membuat Project Console

Buat project pertama:

dotnet new console -n HelloDotnet -o src/HelloDotnet

dotnet new console -n HelloDotnet -o src/HelloDotnet menciptakan project bernama HelloDotnet di folder src/HelloDotnet. Opsi -n menentukan nama project (dan namespace), sedangkan -o menentukan lokasi output. File kode utama yang dihasilkan adalah Program.cs.

#Struktur Folder Aplikasi

#Program.cs sebagai Titik Masuk

Buka Program.cs — isinya kira-kira sebagai berikut:

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

.NET 6 ke atas memakai top-level statements, sehingga tidak perlu menulis class dan method Main secara eksplisit — compiler yang membungkusnya. Baris Console.WriteLine("Hello, World!") mencetak teks ke standard output, dan baris itulah titik masuk aplikasi kalian.

#File csproj dan Folder Build

File pendamping yang penting adalah HelloDotnet.csproj:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
</Project>

<TargetFramework>net8.0</TargetFramework> menentukan versi runtime target. ImplicitUsings otomatis menambahkan using umum, dan Nullable mengaktifkan analisis nullable reference types. Folder obj dan bin berisi artifact build sementara — keduanya tidak perlu di-commit ke Git.

#Menjalankan Aplikasi Console

#dotnet run

Jalankan aplikasi dari root project:

dotnet run

dotnet run melakukan restore, build, lalu menjalankan aplikasi. Output Hello, World! akan tampil. Perintah ini adalah cara tercepat untuk menguji perubahan kecil. Untuk pengembangan yang menunggu perubahan file secara otomatis, gunakan hot reload:

dotnet watch run

dotnet watch run memantau perubahan sumber lalu merestart aplikasi secara otomatis — alur kerja yang sangat membantu saat mengembangkan web API di episode 11.

#Build dan Publish

#dotnet build untuk Verifikasi

Sebelum commit, biasakan membuild secara eksplisit untuk memastikan kode bebas error:

dotnet build --configuration Release

dotnet build --configuration Release mengkompilasi project ke mode Release dan menghasilkan assembly di bin/Release/net8.0/. Artifact yang dihasilkan masih membutuhkan .NET runtime terpasang di mesin target.

#dotnet publish untuk Produksi

Untuk distribusi, gunakan publish. Mode self-contained membawa runtime .NET sendiri sehingga target tidak perlu install .NET:

dotnet publish -c Release -r linux-x64 --self-contained true

dotnet publish menghasilkan folder bin/Release/net8.0/linux-x64/publish/ yang berisi aplikasi lengkap plus runtime. Folder itulah yang akan dijadikan image Docker di episode 19.

#Alur Kerja Harian .NET

Ringkasan perintah yang akan kalian pakai setiap hari:

• dotnet new untuk membuat project dari template.
• dotnet run untuk menjalankan saat pengembangan.
• dotnet watch run untuk hot reload.
• dotnet build untuk memverifikasi kompilasi.
• dotnet publish untuk menghasilkan artifact produksi.
• dotnet test untuk menjalankan unit test (episode 18).

#Penutup

Inti yang harus dibawa pulang:

• dotnet new console -n Nama -o Path menciptakan project baru.
• Top-level statements membuat Program.cs ringkas.
• File csproj menentukan target framework dan perilaku build.
• dotnet run menjalankan aplikasi; dotnet watch run menambahkan hot reload.
• dotnet build memverifikasi kompilasi; dotnet publish menghasilkan artifact.
• Self-contained publish membawa runtime, framework-dependent tidak.

Di episode 4 selanjutnya kita akan membahas bahasa dasar dan tipe data — tipe primitif, value dan reference types, nullable, string, struct dan enum, control flow, serta fungsi dan lambda expression dalam C#. Ini adalah inti dari menulis logika aplikasi .NET.