문서로 돌아가기
배포
Windows 배포 및 스토어
NSIS 빌드, MSIX 패키징, Microsoft Store 제출.
•
10분 읽기
•PlanToCode는 직접 다운로드(NSIS 설치 프로그램)와 Microsoft Store(MSIX 패키지) 모두를 통해 Windows에서 배포됩니다. 이 문서는 두 배포 방법을 다룹니다.
전제 조건
필수 도구와 인증서:
- 코드 서명 인증서 (EV 또는 표준)
- signtool을 위한 Windows SDK
- 설치 프로그램 빌드를 위한 NSIS
- Store 제출을 위한 MSIX Packaging Tool
NSIS 설치 프로그램
Tauri는 기본적으로 NSIS 설치 프로그램을 빌드합니다:
- PlanToCode 브랜딩이 있는 커스텀 설치 프로그램 UI
- 사용자별 설치 (관리자 필요 없음)
- 시작 메뉴 및 데스크톱 바로 가기
- 깨끗한 제거가 있는 언인스톨러
코드 서명
Authenticode를 사용한 Windows 코드 서명:
- Windows SDK의 signtool로 서명
- 신뢰할 수 있는 TSA 서버의 타임스탬프
- EV 인증서가 SmartScreen 평판 제공
- CI가 인증서와 비밀번호에 시크릿 사용
Microsoft Store를 위한 MSIX
MSIX가 Store 호환 패키징을 제공합니다:
- AppxManifest.xml이 기능 정의
- 가상 파일 시스템 격리
- Store를 통한 자동 업데이트
- 샌드박스 실행 환경
MSIX 구성
주요 AppxManifest 설정:
- Identity: Name, Publisher, Version
- Capabilities: internetClient, microphone
- Visual elements: Tiles, splash screen
- 파일 연결 및 프로토콜 핸들러
MSIX 빌드 단계
MSIX 패키지를 만드는 프로세스:
- pnpm tauri build로 릴리스 빌드
- 올바른 identity로 AppxManifest.xml 생성
- MakeAppx.exe로 패키징
- SignTool로 서명
- Windows App Cert Kit으로 검증
Microsoft Store 제출
Store 제출 프로세스:
- Partner Center에서 앱 생성
- MSIX 패키지 업로드
- 가격 구성 (IAP 크레딧이 있는 무료)
- 인증을 위해 제출
- 검토는 1-3 영업일 소요
Windows 업데이트
각 배포를 위한 업데이트 메커니즘:
- NSIS: GitHub 릴리스와 함께 tauri-plugin-updater
- MSIX/Store: Microsoft Store를 통한 자동
- 둘 다 실행 시 업데이트 확인
WebView2 런타임
Tauri는 Windows에서 WebView2를 사용합니다:
- 설치 프로그램에 번들된 WebView2 부트스트래퍼
- Evergreen 버전 자동 업데이트
- 격리를 위한 고정 버전 사용 가능
- Windows 10 1803+ 필수
문제 해결
일반적인 Windows 배포 이슈:
- SmartScreen 경고: EV 인증서 사용 또는 평판 구축
- WebView2 누락: 부트스트래퍼 실행 확인
- Store 거부: 인증 보고서 세부사항 검토
- 업데이트 실패: 서명과 매니페스트 버전 확인