wailsapp/wails

어떤 프로젝트인가요?

핵심 기능

• 01JavaScript에서 Go 메서드를 직접 호출하고 TypeScript 정의를 자동 생성
• 02네이티브 대화상자와 메뉴, 다크 모드 및 라이트 모드 지원
• 03Go와 JavaScript 간 통합 이벤트 시스템
• 04프론트엔드 템플릿을 제공하는 프로젝트 스캐폴딩, 빌드, 번들링용 CLI
• 05브라우저를 내장하지 않고 네이티브 렌더링 엔진을 사용해 Windows, macOS, Linux에서 실행

활용 사례

• 최신 웹 기반 UI를 갖춘 경량 Go 데스크톱 도구 제작
• 로컬 웹 서버를 실행하지 않고 기존 Go 프로그램에 그래픽 프론트엔드 추가
• React, Vue, Svelte를 사용한 크로스 플랫폼 데스크톱 애플리케이션 제작

빠른 시작

1. 1

   Go를 사용해 Wails v2 CLI 설치하기

   go install github.com/wailsapp/wails/v2/cmd/wails@latest
2. 2

   Go를 사용해 Wails v3 CLI(베타) 설치하기

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

   Wails 문서 사이트에서 전체 설치 안내를 확인하세요

사용 전 알아둘 점

• !v3는 아직 베타이며, v2가 안정화 버전입니다.
• !데스크톱 앱에는 Go 툴체인 외에도 플랫폼별 네이티브 종속 항목이 필요합니다.

토픽

자주 묻는 질문

wails은(는) 무엇인가요?

네이티브 렌더링 엔진을 사용해 웹 프론트엔드(React, Vue, Svelte 등)를 갖춘 크로스 플랫폼 데스크톱 앱을 만들 수 있는 Go 프레임워크입니다. Wails를 사용하면 Go 코드를 HTML, JavaScript, CSS 프론트엔드와 결합해 데스크톱 애플리케이션을 만들 수 있습니다. 로컬 웹 서버를 실행하고 브라우저를 여는 대신, Go 백엔드와 웹 UI를 하나의 바이너리로 묶어 네이티브 창에서 실행합니다.

wails은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

wails은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

wails은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. wails의 마지막 커밋은 2026년 10월 21일입니다.

wails은(는) 어디에 사용할 수 있나요?

최신 웹 기반 UI를 갖춘 경량 Go 데스크톱 도구 제작 로컬 웹 서버를 실행하지 않고 기존 Go 프로그램에 그래픽 프론트엔드 추가 React, Vue, Svelte를 사용한 크로스 플랫폼 데스크톱 애플리케이션 제작

wails는 어떻게 설치하나요?

Go를 사용해 Wails v2 CLI 설치하기: go install github.com/wailsapp/wails/v2/cmd/wails@latest Go를 사용해 Wails v3 CLI(베타) 설치하기: go install github.com/wailsapp/wails/v3/cmd/wails3@latest Wails 문서 사이트에서 전체 설치 안내를 확인하세요

wails은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/wailsapp/wails