Cài đặt

Ghi chú về phiên bản phát hành

WSL Dashboard cung cấp ba dạng tệp phát hành khác nhau để đáp ứng các nhu cầu sử dụng khác nhau:

Loại phiên bản	Tên tệp ví dụ	Mô tả
Portable (EXE)	WSLDashboard.vX.Y.Z.Portable.x64.exe	Cách được khuyến nghị. Phiên bản xanh một tệp, không cần cài đặt, chạy trực tiếp. Cấu hình được lưu tại ~\.wsldashboard.
Portable (ZIP)	WSLDashboard.vX.Y.Z.Portable.x64.zip	Phiên bản portable đã nén, phù hợp để triển khai thủ công hoặc tích hợp vào bộ công cụ khác.
Setup (Trình cài đặt)	WSLDashboard.vX.Y.Z.Setup.x64.exe	Trình cài đặt tiêu chuẩn. Sau khi chạy sẽ tạo lối tắt menu Start, biểu tượng màn hình nền và đăng ký mục gỡ cài đặt hệ thống.

TIP

Làm sao để chọn?

• Nếu bạn muốn đơn giản và nhanh chóng, hãy chọn Portable (EXE).
• Nếu bạn muốn tìm thấy nó trong "Menu Start" như phần mềm thông thường, hãy chọn Setup (Trình cài đặt).

Cách cài đặt

WSL Dashboard cung cấp bốn cách cài đặt, bạn có thể chọn bất kỳ cách nào theo sở thích:

Cách 1: Tải từ trang chính thức (Khuyến nghị)

Truy cập trang tải về chính thức và chọn máy chủ nhân bản phù hợp với khu vực của bạn.

Cách 2: Cài đặt qua winget

Cài đặt trực tiếp qua Windows Package Manager (winget):

winget search wsl-dashboard
winget install wsl-dashboard

Mã định danh gói winget là Owu.WSLDashboard, bí danh wsl-dashboard (không phân biệt hoa thường), cả hai đều có thể sử dụng.

Cách 3: Biên dịch sẵn từ GitHub Releases

Đi tới trang GitHub Releases để tải phiên bản mới nhất. Nếu tải về là gói nén, hãy giải nén rồi chạy trực tiếp wsldashboard.exe, không cần cài đặt.

Cách 4: Build từ mã nguồn

Nếu bạn muốn tự biên dịch, hãy đảm bảo môi trường phát triển của bạn đáp ứng các yêu cầu sau:

• Bộ công cụ Rust: Phiên bản 1.92 trở lên.
• Target Build: x86_64-pc-windows-msvc.

Các bước biên dịch

1. Nhân bản kho lưu trữ:

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

2. Chạy để phát triển:

   cargo run .

3. Build sản xuất (dùng tập lệnh được cung cấp):

   .\build\portable\build.ps1

Sản phẩm biên dịch sẽ nằm trong thư mục target/release.

Hướng dẫn sử dụng bản Portable

Bản portable không cần cài đặt: chạy trực tiếp wsldashboard.exe là dùng được, cấu hình được lưu tại ~\.wsldashboard. Gỡ cài đặt chỉ cần xóa tệp, không để lại tàn dư hệ thống. Bản portable và bản setup có chức năng hoàn toàn giống nhau, chỉ thiếu tích hợp hệ thống như lối tắt menu Start, biểu tượng màn hình nền và mục gỡ cài đặt hệ thống.