데스크톱 (Tauri) 직접 빌드

공식 설치 파일은 GitHub Releases에서 바로 다운로드할 수 있습니다. 이 글은 직접 패키지를 만들고 싶은 개발자(내부 배포, 셸 수정 등)를 위한 것입니다. 데스크톱 셸의 프런트엔드는 apps/app 빌드 산출물을 재사용하고 런타임에는 원격 월드 주소에 접속만 하므로, 데스크톱 빌드에 백엔드 의존성 배포는 전혀 필요 없습니다.

1. 1.Windows 빌드

   Rust + Node가 설치된 아무 머신에서나 pnpm --dir apps/desktop build:windows:x64를 실행합니다. 산출물은 apps/desktop/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/에 생성됩니다. 설치 프로그램은 중·영·일·한 4개 언어를 지원합니다.

2. 2.macOS 빌드

   반드시 macOS에서 실행해야 합니다. 먼저 Xcode Command Line Tools를 설치하고(xcode-select --install) Rust 타깃을 추가한 뒤(rustup target add aarch64-apple-darwin x86_64-apple-darwin), 칩에 따라 pnpm --dir apps/desktop build:mac:aarch64 또는 build:mac:x86_64를 실행합니다. 산출물에는 .app과 .dmg가 포함됩니다.

3. 3.서명: 3단계 형태

   환경 변수로 결정됩니다: ① APPLE_SIGNING_IDENTITY를 비우거나 "-"(ad-hoc)로 설정 — 본인 머신에는 설치 가능하나 타인에게 배포하면 상대가 우클릭으로 열거나 quarantine 속성을 제거해야 함. ② Developer ID 인증서 신원 설정 — 배포 가능하지만 첫 실행 시 사용자가 시스템 설정에서 승인 필요. ③ ②에 더해 App Store Connect API Key 3종 세트로 공증 — 바로 배포 가능하고 Gatekeeper 경고도 없음. 저장소의 CI 워크플로는 secrets를 갖추면 자동으로 ③으로 승격됩니다.

4. 4.자동 업데이트 (기본 비활성)

   셸에는 tauri-plugin-updater가 탑재되어 있습니다(메뉴의 "업데이트 확인…" + 시작 시 무음 점검). 다만 bundle.createUpdaterArtifacts가 기본적으로 꺼져 있습니다: 켜면 minisign 서명 개인 키가 필수가 되어 없으면 빌드가 즉시 실패합니다. 활성화 절차: tauri signer generate로 키 쌍 생성 → 공개 키를 tauri.conf.json에 기입 → 개인 키를 CI secrets에 등록 → 스위치를 켜고 릴리스. 비활성 상태에서도 모든 것이 정상 동작하며, 단지 업데이트가 배포되지 않을 뿐입니다.