사용자 정의 템플릿 만들기

Wails에는 기본 제공 템플릿 세트가 포함되어 있지만, 직접 템플릿을 만들어 커뮤니티와 공유할 수도 있습니다. 사용자 정의 템플릿은 단순한 Git 저장소입니다. 공개적으로 호스팅하면 누구나 명령 하나로 이 템플릿에서 프로젝트 뼈대를 생성할 수 있습니다.

템플릿 뼈대 생성하기

wails3 generate template 명령은 바로 사용자 정의할 수 있는 템플릿 디렉터리를 생성합니다.

wails3 generate template -name MyTemplate

모든 플래그:

모든 플래그를 사용한 예:

wails3 generate template \
  -name "My Template" \
  -author "Your Name" \
  -description "React + custom setup" \
  -helpurl "https://github.com/yourname/my-template" \
  -version "v1.0.0" \
  -frontend ./my-existing-frontend

생성된 디렉터리의 구조는 다음과 같습니다.

MyTemplate/
├── template.yaml          # Template metadata — edit this
├── NEXTSTEPS.md           # Guidance for you as the template author — delete before publishing
├── README.md              # Shown to users after they create a project
├── main.go.tmpl           # Application entry point
├── greetservice.go        # Example Go service
├── go.mod.tmpl            # Go module file
├── go.sum.tmpl            # Go checksums
├── gitignore.tmpl         # Becomes .gitignore in generated projects
├── Taskfile.tmpl.yml      # Build task definitions
└── frontend/              # Your frontend code

템플릿 메타데이터 구성하기

template.yaml을 열어 템플릿의 메타데이터를 설정하세요.

# yaml-language-server: $schema=https://v3.wails.io/schemas/template.v3.json
name: "My Template"
shortname: my-template
author: Your Name
description: A template with my preferred setup
helpurl: https://github.com/yourname/my-template
version: v1.0.0
wailsVersion: 3

wailsVersion 필드는 필수이며 3이어야 합니다. 맨 위의 # yaml-language-server 주석을 사용하면 VS Code(YAML 확장 프로그램 사용 시)와 JetBrains IDE에서 자동 완성과 인라인 유효성 검사를 사용할 수 있습니다. 이 주석은 그대로 두거나 제거해도 되며 런타임에는 영향을 주지 않습니다.

템플릿 사용자 정의하기

프런트엔드

frontend/ 디렉터리는 템플릿에서 생성되는 모든 프로젝트에 변경 없이 그대로 복사됩니다. 자리표시자 콘텐츠를 실제 프런트엔드로 교체하세요.

cd MyTemplate/frontend
npm create vite@latest .

npm install

wails3 generate template -name MyTemplate -frontend ./my-app/frontend

빌드 작업

Taskfile.tmpl.yml은 빌드 워크플로를 정의합니다. 프런트엔드 도구 체인에 맞게 install:frontend:deps 및 build:frontend 작업을 업데이트하세요.

tasks:
  install:frontend:deps:
    dir: frontend
    cmds:
      - npm install       # replace with pnpm install, yarn, etc.

  build:frontend:
    dir: frontend
    deps: [install:frontend:deps, generate:bindings]
    cmds:
      - npm run build     # replace with your build command

Go 애플리케이션

main.go.tmpl 파일은 애플리케이션 진입점입니다. 프로젝트를 생성할 때 Wails의 템플릿 엔진이 이 파일을 처리하며, {{.ProductName}} 같은 템플릿 변수는 사용자가 제공한 값으로 바뀝니다.

IDE 지원을 받으며 실제 Go 파일로 편집하려면 파일 이름을 일시적으로 main.go으로 변경하고 수정한 다음, 커밋하기 전에 다시 main.go.tmpl로 변경하세요.

템플릿 변수

다음 변수는 모든 .tmpl 파일에서 사용할 수 있습니다.

로컬에서 템플릿 테스트하기

게시하기 전에 로컬 경로에서 프로젝트를 만들어 템플릿을 테스트하세요:

wails3 init -n testproject -t /path/to/MyTemplate

그런 다음 프로젝트가 정상적으로 작동하는지 확인하세요:

cd testproject
wails3 dev    # development mode with hot reload
wails3 build  # production binary

다음 사항을 확인하세요:

• 프런트엔드 핫 리로드가 작동합니다
• Go 코드가 변경되면 앱이 다시 빌드되고 실행됩니다
• bin/의 프로덕션 바이너리가 올바르게 실행됩니다

GitHub에 게시하기

git init
git add .
git commit -m "Initial template"
git remote add origin https://github.com/yourname/my-template.git
git push -u origin main

git tag v1.0.0
git push origin v1.0.0

이제 사용자는 템플릿으로 프로젝트를 만들 수 있습니다:

# Latest commit on the default branch
wails3 init -n myapp -t https://github.com/yourname/my-template

# Pinned to a specific release tag
wails3 init -n myapp -t https://github.com/yourname/my-template@v1.0.0

모범 사례

• 명확한 README.md을 작성하세요 — 이 내용은 사용자가 프로젝트를 만든 후 표시됩니다. 프로젝트를 실행하고 빌드하고 사용자 지정하는 방법을 설명하세요.
• helpurl을 작성하세요 — 저장소 또는 별도의 문서로 연결되는 링크를 입력하세요. 사용자는 Wails CLI 템플릿 목록에서 이 링크를 볼 수 있습니다.
• 프런트엔드 종속성 버전을 고정하세요 — 업스트림 업데이트로 설치가 중단되는 일을 방지하려면 package.json에서 버전을 고정하세요.
• 태그를 지정하기 전에 테스트하세요 — 커뮤니티에 알리기 전에 태그가 지정된 릴리스에서 새 프로젝트를 만드세요.
• wailsVersion: 3을 유지하세요 — 이 필드는 템플릿이 대상으로 하는 Wails 주 버전을 Wails에 알려 줍니다. 변경하지 마세요.
• 정기적으로 업데이트하세요 — 종속성을 최신 상태로 유지하고 새 Wails 릴리스에서 테스트하세요.