Instalasi

Catatan Rilis

WSL Dashboard menyediakan tiga bentuk file rilis yang berbeda untuk memenuhi berbagai skenario penggunaan:

Tipe Versi	Contoh Nama File	Deskripsi
Portable (EXE)	WSLDashboard.vX.Y.Z.Portable.x64.exe	Cara yang disarankan. File hijau satu paket, tanpa instalasi, langsung dijalankan. Konfigurasi disimpan di ~\.wsldashboard.
Portable (ZIP)	WSLDashboard.vX.Y.Z.Portable.x64.zip	Versi portabel yang dikompresi, cocok untuk deployment manual atau integrasi ke kumpulan alat lain.
Setup (Installer)	WSLDashboard.vX.Y.Z.Setup.x64.exe	Penginstal standar. Setelah dijalankan akan membuat pintasan menu Start, ikon desktop, dan mendaftarkan item penghapusan instalasi sistem.

TIP

Bagaimana memilih?

• Jika Anda menginginkan kesederhanaan dan kecepatan, pilih Portable (EXE).
• Jika Anda ingin menemukannya di "Menu Mulai" seperti perangkat lunak biasa, pilih Setup (Installer).

Cara Instalasi

WSL Dashboard menyediakan empat cara instalasi, Anda dapat memilih salah satu sesuai preferensi:

Cara 1: Unduhan dari Situs Resmi (Disarankan)

Kunjungi halaman unduhan resmi dan pilih cermin (mirror) yang sesuai dengan wilayah Anda.

Cara 2: Instalasi winget

Instal langsung melalui Windows Package Manager (winget):

winget search wsl-dashboard
winget install wsl-dashboard

ID paket winget adalah Owu.WSLDashboard, alias wsl-dashboard (tidak peka huruf besar/kecil), keduanya dapat digunakan.

Cara 3: Pra-kompilasi GitHub Releases

Kunjungi halaman GitHub Releases untuk mengunduh versi terbaru. Jika yang diunduh adalah paket terkompresi, ekstrak lalu jalankan langsung wsldashboard.exe, tanpa perlu instalasi.

Cara 4: Build dari Kode Sumber

Jika Anda ingin mengompilasi sendiri, pastikan lingkungan pengembangan Anda memenuhi persyaratan berikut:

• Toolchain Rust: Versi 1.92 atau lebih baru.
• Target Build: x86_64-pc-windows-msvc.

Langkah Kompilasi

1. Klon repositori:

   git clone https://github.com/owu/wsl-dashboard.git
   cd wsl-dashboard

2. Jalankan untuk pengembangan:

   cargo run .

3. Build produksi (menggunakan skrip yang disediakan):

   .\build\portable\build.ps1

Hasil kompilasi akan berada di direktori target/release.

Panduan Penggunaan Portable

Versi portabel tidak memerlukan instalasi: langsung jalankan wsldashboard.exe, konfigurasi disimpan di ~\.wsldashboard. Untuk menghapus instalasi cukup hapus file, tanpa meninggalkan residu sistem. Versi portabel dan versi setup memiliki fungsi yang sepenuhnya identik, hanya kurang integrasi sistem seperti pintasan menu Start, ikon desktop, dan item penghapusan instalasi sistem.