Pendahuluan

Rust kini menjadi bahasa yang populer untuk sistem yang membutuhkan performa tinggi sekaligus menjamin keamanan memori. Panduan ini menjelaskan proses instalasi Rust dengan rustup, alat resmi yang menjaga versi compiler dan Cargo tetap terkelola. Setelah instalasi, kita akan memverifikasi toolchain, menulis program Hello World dengan editor teks, dan juga membuat proyek terstruktur menggunakan Cargo.

1. Menginstal Rust di Berbagai Platform

Kita akan menggunakan rustup, manajer toolchain Rust, karena ia secara otomatis menginstal rustc (compiler), cargo (tool build dan paket), dan mengatur PATH. Pastikan sistem sudah terhubung ke internet.

1.1 Windows (PowerShell)

Jalankan PowerShell dengan hak administrator dan gunakan perintah berikut:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Perintah ini memungkinkan skrip lokal dijalankan. Lalu unduh dan jalankan installer resmi:

irm https://sh.rustup.rs -useb | iex

Ikuti prompt, pilih opsi default (menekan Enter). Setelah selesai, restart terminal agar PATH terbarui. Jika Anda lebih nyaman menggunakan PowerShell Core atau Terminal Windows, prosedurnya sama.

1.2 macOS

Pastikan curl tersedia (default di macOS). Buka Terminal dan jalankan:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Proses akan menawarkan mode standar. Setelah selesai, jalankan source ~/.cargo/env agar perubahan PATH aktif dalam sesi saat ini. Untuk shell seperti zsh atau fish, pastikan file konfigurasi memuat source ~/.cargo/env.

1.3 Linux

Langkah instalasi di Linux sangat mirip dengan macOS. Gunakan terminal favorit Anda:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Setelah selesai, jalankan source $HOME/.cargo/env. Jika Anda menggunakan shell login, masukkan baris ini ke ~/.bashrc atau ~/.zshrc.

Untuk distribusi dengan kebijakan keamanan ketat, pastikan curl mengunduh skrip dan tidak ada firewall memblokir.

2. Memeriksa Versi Rust dan Cargo

Setelah instalasi, validasi dengan dua perintah:

rustc --version
cargo --version

Kedua perintah harus menampilkan versi masing-masing tool. rustc menunjukkan versi compiler, sedangkan cargo menunjukkan versi manajer proyek. Jika muncul kesalahan command not found, periksa apakah ~/.cargo/bin sudah ada dalam PATH. Anda dapat memeriksa dengan:

echo $PATH

atau untuk Windows PowerShell:

$env:Path -split ';'

Jika perlu, tambahkan PATH secara manual melalui pengaturan sistem.

3. Menulis dan Menjalankan Program Hello World Manual

Dengan compiler Rust tersedia, Anda dapat membuat file teks sederhana.

3.1 Membuat file

Buka editor seperti VS Code atau nano, lalu tulis:

// hello.rs
fn main() {
    println!("Halo dari Rust!");
}

Simpan file dengan nama hello.rs. Pastikan ekstensi .rs. Cara ini bagus untuk memahami alur compile tanpa alat tambahan.

3.2 Mengompilasi dan Menjalankan

Gunakan rustc:

rustc hello.rs
./hello

Di Windows, jalankan hello.exe. Compiler menghasilkan binary dalam direktori saat ini. Jika terjadi kesalahan seperti error: cannot find function `main`, pastikan tipe file dan kurung kurawal sudah lengkap. Kesalahan lain yang umum adalah tanda kutip ganda “smart quotes” dari editor; gunakan tanda kutip ASCII.

Metode ini cocok untuk eksperimen ringkas, namun untuk proyek yang lebih besar sebaiknya gunakan Cargo.

4. Membuat Proyek Baru dengan Cargo

Cargo adalah sistem build dan manajemen dependensi Rust. Ia otomatis membuat struktur proyek standar.

4.1 Inisialisasi proyek

Untuk membuat proyek bernama hello_cargo:

cargo new hello_cargo --bin
cd hello_cargo

Opsi --bin membuat aplikasi (bukan library). Struktur yang dihasilkan:

  • Cargo.toml: deklarasi metadata dan dependensi.
  • src/main.rs: entry point program.

Isi src/main.rs default sudah berisi:

fn main() {
    println!("Hello, world!");
}

4.2 Menjalankan proyek Cargo

Gunakan:

cargo run

Perintah ini melakukan kompilasi (jika diperlukan) lalu menjalankan binary. Cargo mengelola cache dan rebuild hanya jika file berubah, menghemat waktu. Dev-mode juga dapat disertai cargo run --release untuk optimasi produksi, meskipun membutuhkan waktu kompilasi lebih lama.

Untuk membangun tanpa menjalankan:

cargo build

Binary akan disimpan di target/debug/ atau target/release/. Untuk memeriksa struktur, gunakan tree -L 2 jika tersedia.

5. Tips Praktis dan Pemecahan Masalah

1. Memperbarui toolchain: Gunakan rustup update untuk mengunduh perbaikan terbaru dan memperbarui rustc serta cargo.

2. Mengelola platform target: Tambahkan target platform lain dengan rustup target add. Misalnya, untuk integrasi WebAssembly:

rustup target add wasm32-unknown-unknown

3. Kesalahan PATH: Jika terminal lama tetap menunjukkan versi lama, tutup dan buka kembali. Pastikan rustup berada di PATH dengan which rustup atau Get-Command rustup.

4. Debugging: Jika cargo run gagal, jalankan cargo check terlebih dahulu. Ini hanya melakukan analisis tanpa menghasilkan binary, membantu menemukan kesalahan compile lebih cepat.

5. Dokumentasi: Gunakan cargo doc --open untuk membuka dokumentasi lokal dari dependensi.

Kesimpulan

Rust dapat diinstal dengan mudah menggunakan rustup di Windows, macOS, dan Linux. Setelah toolchain aktif, verifikasi versi dan praktikkan membuat program sederhana baik secara manual maupun menggunakan Cargo. Cargo menawarkan struktur proyek, manajemen dependensi, dan workflow build yang ideal untuk proyek nyata. Dengan mengikuti langkah-langkah ini, Anda siap mengeksplorasi ekosistem Rust secara lebih luas.