설치

릴리스 버전 안내

WSL Dashboard는 다양한 사용 환경에 맞춰 세 가지 형태의 릴리스 파일을 제공합니다:

버전 유형	파일명 예시	설명
포터블 버전 (EXE)	WSLDashboard.vX.Y.Z.Portable.x64.exe	권장 방식. 단일 파일 그린 버전으로 설치가 필요 없으며 바로 실행 가능합니다. 설정은 ~\.wsldashboard에 저장됩니다.
포터블 버전 (ZIP)	WSLDashboard.vX.Y.Z.Portable.x64.zip	압축된 포터블 버전으로, 수동 배포 또는 다른 도구 모음에 통합하기에 적합합니다.
설치 버전 (Setup)	WSLDashboard.vX.Y.Z.Setup.x64.exe	표준 설치 프로그램입니다. 실행하면 시작 메뉴 바로 가기, 바탕화면 아이콘이 생성되고 시스템 제거 항목이 등록됩니다.

TIP

어떤 버전을 선택해야 할까요?

• 간단하고 빠른 방법을 원한다면 **포터블 버전 (EXE)**을 선택하세요.
• 일반 소프트웨어처럼 "시작 메뉴"에서 찾고 싶다면 **설치 버전 (Setup)**을 선택하세요.

설치 방법

WSL Dashboard는 네 가지 설치 방법을 제공하며, 취향에 따라 아무 방법이나 선택할 수 있습니다:

방법 1: 공식 사이트 다운로드 (권장)

공식 사이트 다운로드 페이지에 접속하여 해당 지역에 맞는 미러를 선택하세요.

방법 2: winget 설치

Windows 패키지 관리자(winget)를 통해 직접 설치합니다:

winget search wsl-dashboard
winget install wsl-dashboard

winget 패키지 식별자는 Owu.WSLDashboard이고 별칭은 wsl-dashboard(대소문자 구분 안 함)로, 둘 다 사용할 수 있습니다.

방법 3: GitHub Releases 사전 컴파일

GitHub Releases 페이지에서 최신 버전을 다운로드하세요. 압축 패키지라면 압축을 푼 후 wsldashboard.exe를 직접 실행하기만 하면 되며 설치가 필요 없습니다.

방법 4: 소스 코드에서 빌드

직접 컴파일하려면 개발 환경이 다음 요구 사항을 충족하는지 확인하세요:

• Rust 툴체인: 버전 1.92 이상.
• 빌드 타깃: x86_64-pc-windows-msvc.

빌드 단계

1. 저장소를 클론합니다:

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

2. 개발 실행:

   cargo run .

3. 프로덕션 빌드(제공된 스크립트 사용):

   .\build\portable\build.ps1

빌드 산출물은 target/release 디렉터리에 생성됩니다.

포터블 버전 사용 안내

포터블 버전은 설치가 필요 없습니다. wsldashboard.exe를 직접 실행하기만 하면 되며, 설정은 ~\.wsldashboard에 저장됩니다. 제거는 파일을 삭제하기만 하면 되고 시스템에 잔여물이 남지 않습니다. 포터블 버전과 설치 버전의 기능은 완전히 동일하며, 시작 메뉴 바로 가기, 바탕화면 아이콘, 시스템 제거 항목 등 시스템 통합 기능만 다릅니다.