설치

지원 플랫폼

Wails를 설치하기 전에 여러 공통 의존성이 필요합니다:

Go 다운로드 페이지에서 Go를 다운로드하세요.

공식 Go 설치 지침을 따르세요. 또한 PATH 환경 변수에 ~/go/bin 디렉토리의 경로가 포함되어 있는지 확인해야 합니다. 터미널을 다시 시작하고 다음 확인을 수행하세요:

Go가 올바르게 설치되었는지 확인: go version
~/go/bin이 PATH 변수에 있는지 확인
- Mac / Linux: echo $PATH | grep go/bin
- Windows: $env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }

Wails는 npm 설치를 필수로 요구하지는 않지만, 번들로 제공되는 템플릿의 대부분에서 필요합니다.

Node 다운로드 페이지에서 최신 Node 설치 프로그램을 다운로드하세요. 일반적으로 테스트하는 최신 릴리스를 사용하는 것이 가장 좋습니다.

npm --version을 실행하여 확인하세요.

또한 플랫폼별 의존성을 설치해야 합니다:

Wails는 xcode 명령줄 도구가 설치되어 있어야 합니다. 다음을 실행하여 설치할 수 있습니다:

xcode-select --install

Wails는 WebView2 Runtime이 설치되어 있어야 합니다. 대부분의 Windows 설치에는 이미 이 런타임이 설치되어 있습니다. wails doctor 명령을 사용하여 확인할 수 있습니다.

Linux에는 표준 gcc 빌드 도구와 gtk3, webkit2gtk가 필요합니다. 설치 후 wails doctor를 실행하여 의존성 설치 방법을 확인하세요. 배포판이나 패키지 관리자가 지원되지 않는 경우 Discord에서 알려주세요.

Go Modules를 사용하여 Wails CLI를 설치하려면 다음 명령을 실행하세요:

go install -v github.com/wailsapp/wails/v3/cmd/wails3@latest

최신 개발 버전을 설치하려면 다음 명령을 실행하세요:

git clone https://github.com/wailsapp/wails.git
cd wails
cd v3/cmd/wails3
go install

개발 버전을 사용할 때 생성된 모든 프로젝트는 Wails의 개발 버전을 사용하도록 Go의 replace 지시문을 사용합니다.

wails3 doctor를 실행하면 올바른 의존성이 설치되어 있는지 확인합니다. 그렇지 않다면 누락된 항목을 알려주고 문제를 해결하는 방법을 안내합니다.

시스템에서 wails3 명령이 누락되었다고 보고하는 경우 다음을 확인하세요: