기여하기

이 문서 편집

문서를 번역하거나 컴퓨터에서 전체 프로젝트를 여세요.

작업을 제출하기 전까지는 아무것도 게시되지 않습니다.

Wails 로고Wails 로고

Go로 데스크톱 앱 빌드하기

Go와 최신 웹 기술로 아름답고 성능이 뛰어난 애플리케이션을 빌드하세요. 하나의 코드베이스. 세 가지 플랫폼. 브라우저 불필요.*

* 정말 원한다면 사용할 수 있습니다

빠른 시작

# 1. Install the Wails CLI
go install github.com/wailsapp/wails/v3/cmd/wails3@latest

# 2. Run the setup wizard (experimental)
wails3 setup

이제 첫 번째 프로젝트를 시작할 준비가 되었습니다.

wails3 init -n myapp -t vanilla
cd myapp && wails3 dev

이제 애플리케이션이 실행 중이며 핫 리로드와 타입 안전성이 보장되는 Go-to-JS 바인딩을 사용할 수 있습니다.

wails3 setup에 문제가 있나요? 수동 설치 가이드를 참조하세요.

데스크톱 앱을 그대로 모바일 앱으로

wails3 task ios:run      # run your existing app on iOS Simulator
wails3 task android:run  # run your existing app on Android Emulator

Go 코드를 전혀 변경할 필요가 없습니다. 동일한 main.go, 동일한 서비스, 동일한 프런트엔드를 Wails가 iOS 및 Android용으로 자동 컴파일합니다. 플랫폼별 기능(햅틱, 네이티브 대화 상자, 안전 영역)은 필요할 때 사용할 수 있지만, 앱을 출시하는 데 반드시 필요한 것은 아닙니다.

모바일 문서 →


Wails를 선택해야 하는 이유

사용자가 체감하는 성능
  • Electron의 150MB에 비해 약 15MB인 바이너리
  • 100MB+에 비해 약 10MB인 기본 메모리 사용량
  • 2-3초에 비해 <0.5초인 시작 시간
  • OS WebView를 사용한 네이티브 렌더링
  • 번들 브라우저로 인한 오버헤드 없음
개발자 경험
  • 모든 플랫폼에서 하나의 Go 코드베이스 사용
  • React, Vue, Svelte 등 모든 웹 프레임워크 지원
  • 개발 중 핫 리로드 지원
  • Go를 Javascript에서 쉽게 호출할 수 있도록 바인딩 자동 생성
  • 메모리 내 IPC. 네트워크 포트를 사용하지 않음
데스크톱 앱 개발에 필요한 기능 완비
  • 수명 주기를 지원하는 다중 창
  • 네이티브 메뉴 및 시스템 트레이
  • 플랫폼 네이티브 파일 대화 상자
  • 시스템 통합 및 바로 가기
  • 코드 서명 및 패키징 도구
데스크톱 및 모바일
  • Windows, macOS, Linux, iOS, Android
  • 동일한 코드베이스, 재작성 불필요
  • 모든 플랫폼에서 네이티브 WebView 사용
  • 열린 포트 및 localhost 서버 없음
  • 필요할 때 플랫폼 기능 사용 가능

다음 단계

다음으로 완전한 애플리케이션을 빌드하거나, 예제를 살펴보거나, API 레퍼런스를 확인하세요. v2에서 마이그레이션하시나요? 업그레이드 가이드를 참조하세요.

Wails 개발 후원하기

Wails는 개발자가 개발자를 위해 만든 무료 오픈 소스입니다. Wails로 훌륭한 애플리케이션을 빌드하는 데 도움을 받으셨다면 지속적인 개발을 후원해 주세요.

여러분의 후원은 프로젝트를 유지하고 문서를 개선하며 전체 커뮤니티에 도움이 되는 새로운 기능을 개발하는 데 보탬이 됩니다.

후원자 되기 →