메인 콘텐츠로 건너뛰기
버전: 다음 버전 🚧

설치하기

지원되는 플랫폼​

  • Windows 10/11 AMD64/ARM64
  • MacOS 10.13+ AMD64
  • MacOS 11.0+ ARM64
  • Linux AMD64/ARM64

의존성​

Wails는 설치 전에 아래와 같은 몇 가지 공통적인 의존성이 필요합니다.

  • Go 1.17+
  • NPM (Node 15+)

Go​

Go 다운로드 페이지에서 Go를 다운로드 합니다.

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

  • Go 설치 확인: go version
  • PATH 변수에 "~/go/bin" 확인: echo $PATH | grep go/bin

NPM​

Node 다운로드 페이지에서 NPM을 다운로드 합니다. 우리는 일반적으로 최신 버전에서 테스트를 진행하기 때문에 최신 버전 사용을 권장합니다.

정상적으로 설치된 것을 확인하기 위해 npm --version을 실행합니다.

플랫폼에 따른 의존성​

아래와 같이 플랫폼별 의존성이 있습니다.

Wails requires that the WebView2 runtime is installed. Some Windows installations will already have this installed. You can check using the wails doctor command (see below).

선택 설치​

  • UPX는 어플리케이션 압축에 필요합니다.

Wails 설치​

go install github.com/wailsapp/wails/v2/cmd/wails@latest을 실행하여 Wails CLI를 설치합니다.

시스템 점검​

wails doctor를 실행하면 의존성이 올바르게 설치되어 있는지 점검할 수 있습니다. 문제가 있는 의존성에 대해서는 문제 해결을 위한 도움을 줄 수 있습니다.

wails 명령어를 찾을 수 없나요?​

시스템에서 wails 명령어를 찾을 수 없는 경우 Go 설치 지침을 잘 따라했는지 확인해보세요. 대부분 사용자 홈 디렉토리에 있는 go/bin 디렉토리가 PATH 환경변수에 존재하지 않는 경우입니다. 또한 변경사항이 명령 프롬프트에 반영되도록 일반적으로 열려 있는 모든 명령 프롬프트를 닫았다가 다시 열어야 합니다.