KAL
Menu

Penyiapan Lingkungan

Memasang .NET SDK atau Visual Studio Community lalu membuat dan menjalankan proyek console pertama.

Daftar isi

Program VB.NET pertama memerlukan lingkungan kerja yang siap sebelum kode ditulis. Topik ini memandu pemilihan alat antara .NET SDK dan Visual Studio Community, pemasangan SDK, pembuatan proyek console pertama dengan perintah dotnet new, penjelasan berkas yang dihasilkan templat, dan eksekusi pertama dengan perintah dotnet run. Alur command line lintas platform inilah yang digunakan untuk memverifikasi seluruh contoh kode pada jalur ini, sehingga setiap langkahnya dapat diikuti tanpa IDE.

Alat yang dipasang: SDK, bukan hanya runtime#

.NET SDK adalah paket kerja yang berisi compiler VB, templat proyek, dan alat baris perintah bernama dotnet. .NET runtime hanya berisi komponen untuk menjalankan program yang sudah dikompilasi, sehingga tanpa SDK, perintah dotnet new maupun proses kompilasi tidak tersedia. Keduanya gratis, dan SDK tersedia untuk Windows, Linux, serta macOS.

Visual Studio Community adalah pilihan lain yang berlaku di Windows. IDE gratis ini menyertakan SDK, editor dengan penyelesaian kode, debugger visual, dan designer untuk antarmuka Windows Forms. Saat memasang IDE, centang beban kerja pengembangan desktop .NET agar komponen Windows Forms ikut terpasang untuk kebutuhan antarmuka nanti. Instalasi IDE dapat dipadukan dengan SDK yang dipasang terpisah karena keduanya menggunakan SDK yang sama, sehingga proyek yang dibuat melalui terminal dapat dibuka kembali di IDE tanpa konversi.

Memeriksa versi SDK#

Setelah SDK dipasang, buka terminal baru dan periksa versinya. Terminal baru diperlukan karena daftar lokasi program pada PATH dibaca ulang ketika sesi terminal dimulai, sehingga SDK yang baru dipasang belum terlihat pada terminal lama. Perintah berikut tidak mengubah berkas apa pun dan aman dijalankan ulang di folder mana pun.

bash 
# memeriksa versi .NET SDK yang terpasang
dotnet --version
text Keluaran 
10.0.403

Angka 10.0.403 adalah versi SDK yang digunakan untuk memverifikasi seluruh contoh pada jalur ini. Nomor versi pada lingkungan lain kemungkinan lebih baru, dan perbedaan itu tidak mengubah contoh yang dijelaskan. Versi utama 8 atau lebih baru memadai untuk seluruh materi jalur ini.

Untuk pemeriksaan yang lebih rinci, perintah dotnet –list-sdks menyatakan setiap SDK yang terpasang beserta foldernya, sedangkan perintah dotnet –info menambahkan detail lingkungan seperti versi runtime yang menyertai SDK. Kedua perintah tersebut juga hanya membaca kondisi pemasangan, bukan mengubahnya. Apabila dotnet –version menghasilkan nomor versi, pemeriksaan dianggap cukup untuk mengikuti langkah berikutnya.

Membuat proyek console pertama#

Proyek console dibuat dari templat bawaan SDK dengan satu perintah. Pilihan --language VB memilih templat console untuk Visual Basic, sedangkan -o HaloApp menetapkan nama folder proyek. Perintah berikut membuat berkas baru, sehingga disajikan untuk disalin, dan transkrip aslinya tercantum di bawahnya.

bash 
# tidak-dijalankan
# membuat proyek console VB baru di folder HaloApp
dotnet new console --language VB -o HaloApp
text Transkrip terminal 
$ dotnet new console --language VB -o HaloApp
The template "Console App" was created successfully.

Processing post-creation actions...
Restoring /home/kal/my-project/build-scratch/mengenal-visual-basic__penyiapan-lingkungan/HaloApp/HaloApp.vbproj:
  Determining projects to restore...
  Restored /home/kal/my-project/build-scratch/mengenal-visual-basic__penyiapan-lingkungan/HaloApp/HaloApp.vbproj (in 74 ms).
Restore succeeded.

Baris Restoring pada transkrip memuat lokasi folder tempat perintah dijalankan pada lingkungan verifikasi, dan lokasi itu mengikuti folder kerja pada masing-masing komputer. Pada pemasangan .NET yang belum pernah digunakan, transkrip dapat ditambah pesan selamat datang yang hanya muncul sekali. Bagian akhir transkrip menyatakan bahwa templat berhasil dibuat dan proses pemulihan paket (restore) selesai.

Dua berkas utama dihasilkan di dalam folder HaloApp. Berkas Program.vb menampung kode program, sedangkan HaloApp.vbproj adalah berkas proyek yang mengatur kompilasinya.

vb Program.vb 
Imports System

Module Program
    Sub Main(args As String())
        Console.WriteLine("Hello World!")
    End Sub
End Module

Baris Imports System memuat namespace System yang menyediakan kelas Console. Pembungkusnya adalah Module bernama Program dengan prosedur Sub Main sebagai entry point, yaitu titik masuk tempat eksekusi dimulai, dan parameter args berisi argumen baris perintah yang diberikan saat program dijalankan. Baris Console.WriteLine menulis teks Hello World! ke keluaran standar lalu berpindah baris.

xml HaloApp.vbproj 
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <RootNamespace>HaloApp</RootNamespace>
    <TargetFramework>net10.0</TargetFramework>
  </PropertyGroup>

</Project>

Berkas proyek ini pendek karena sebagian besar pengaturan diambil dari nilai bawaan SDK modern. Elemen OutputType bernilai Exe menyatakan hasil kompilasi berupa program yang dapat dieksekusi, RootNamespace menjadi namespace bawaan untuk berkas kode baru, dan TargetFramework menetapkan kerangka target. Berkas bawaan ini belum memuat Option Strict On, sehingga elemen <OptionStrict>On</OptionStrict> dapat ditambahkan ke dalam PropertyGroup apabila mode ketat diinginkan sejak proyek pertama.

Menjalankan program#

Program dijalankan dari dalam folder proyek. Perintah cd masuk ke folder HaloApp, kemudian perintah dotnet run mengompilasi proyek lalu mengeksekusi hasilnya. Kedua perintah ini membuat berkas hasil kompilasi, sehingga transkrip aslinya ditempelkan terpisah di bawahnya.

bash 
# tidak-dijalankan
# masuk ke folder proyek lalu kompilasi dan jalankan
cd HaloApp
dotnet run
text Transkrip terminal 
$ cd HaloApp
$ dotnet run
Hello World!

Keluaran Hello World! berasal dari baris Console.WriteLine pada Program.vb. Perintah dotnet run menggabungkan dua langkah, yaitu kompilasi dan eksekusi, sehingga tidak ada berkas yang perlu dijalankan secara manual. Untuk mengubah keluaran, sunting string Hello World! pada Program.vb menjadi pesan lain, simpan berkasnya, lalu jalankan dotnet run sekali lagi.

Pada eksekusi pertama, dotnet run kadang menampilkan pesan pemulihan paket sebelum keluaran program, dan pesan tersebut bukan tanda kesalahan. Eksekusi berikutnya berlangsung tanpa pesan tambahan karena hasil kompilasi tersimpan pada proyek. Dua folder bernama obj dan bin di dalam folder proyek itulah tempat berkas antara dan hasil akhir kompilasi berada, dan keduanya tidak perlu disunting.

Alur kerja yang sama di Visual Studio Community#

Di Windows, alur yang sama dapat dikerjakan tanpa menyentuh terminal. Langkahnya sebagai berikut.

  1. Buka Visual Studio Community dan pilih opsi Create a new project pada jendela awal.
  2. Cari templat Console App, lalu pilih varian yang berlabel bahasa Visual Basic.
  3. Beri nama proyek, misalnya HaloApp, dan pilih kerangka target .NET 10.0.
  4. Tekan tombol Start atau tombol F5 untuk mengompilasi dan menjalankan program.

Panel Output menampilkan keluaran yang sama dengan terminal, yaitu Hello World! Editor Visual Studio otomatis menormalkan kapitalisasi kata kunci VB ketika kode diketik, sehingga penulisan huruf kecil pada pengenal tidak bertahan lama di editor. Debugger visualnya juga menjadi alat utama ketika program yang dibangun makin besar.

Meskipun IDE nyaman untuk pekerjaan harian, command line tetap menjadi alat verifikasi standar pada jalur ini. Alasannya, perintah dotnet berjalan identik pada Windows, Linux, dan macOS, sehingga setiap langkah dapat direproduksi tanpa bergantung pada versi IDE tertentu. Karena SDK-nya sama, proyek yang dibuat lewat terminal dapat dibuka di Visual Studio Community dan sebaliknya tanpa konversi apa pun.

Kesalahan umum#

  • Pesan command not found muncul setelah pemasangan selesai. Penyebabnya, sesi terminal yang terbuka sebelum pemasangan belum memuat lokasi SDK baru pada PATH. Perbaikannya, tutup terminal dan buka sesi baru, lalu jalankan dotnet –version sekali lagi.
  • Perintah dotnet –version berjalan tetapi dotnet new tidak dikenal. Penyebabnya, yang terpasang adalah .NET Runtime saja tanpa SDK, misalnya karena salah memilih paket penginstal. Perbaikannya, pasang .NET SDK dari halaman unduhan resmi, bukan hanya runtime-nya.
  • Perintah dotnet run dijalankan dari luar folder proyek. Penyebabnya, perintah mencari berkas proyek pada folder kerja saat ini, sehingga eksekusi di tempat lain menghasilkan pesan bahwa tidak ada proyek yang ditemukan. Perbaikannya, masuk ke folder proyek terlebih dahulu atau gunakan opsi --project untuk menunjuk foldernya.

Ringkasan#

  • .NET SDK berisi compiler, templat, dan CLI dotnet, sedangkan .NET Runtime hanya menjalankan hasil kompilasi.
  • Perintah dotnet new console –language VB -o HaloApp membuat proyek console lengkap berisi Program.vb dan HaloApp.vbproj.
  • Perintah dotnet run mengompilasi lalu mengeksekusi proyek, dan setiap perubahan kode cukup diikuti dengan menjalankan ulang perintah tersebut.
  • Visual Studio Community menjalankan alur yang sama di atas SDK yang sama, sementara command line menjadi alat verifikasi standar jalur ini.

Referensi#