Files
networkSetup/docs/changes/2026-11-09-exe-installer-ui-design.md
T
jychoi4andClaude Opus 5.5 7f5540f148 docs: design the EXE installer UI and code signing scope
- Design 14: WiX MSI + Burn with a C# BA host and WebView2 web UI,
  default screen catalog, installer-ui.json and the WebView2 fallback.
- Design 16: Smart App Control checks and what must be signed.
- Manual: beginner guide to Azure Artifact Signing.
- Link the decision from designs 09 and 10 and record it.

Refs #15

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 11:08:50 +09:00

2.4 KiB

EXE 설치 UI 설계 결정

2026-11-09. EXE 설치 파일의 화면을 자유롭게 꾸미는 것이 가장 중요한 요구로 정해져, 설치 UI 구조와 기본 화면 목록을 14 EXE 설치 UI로 정리했다. 설계 문서만 변경했으며 BA·웹 UI·Burn 번들 구현과 설치 시험은 범위 밖이다.

결정

  • 설치 패키지는 WiX MSI를 Burn 번들(setup.exe)로 감싼다. WiX 버전과 OSMF 이용 조건은 채택 전에 확정한다.
  • 설치 화면은 C#(.NET Framework 4.8) BA 호스트가 WebView2로 표시하는 HTML/CSS/TypeScript 웹 UI로 만든다.
  • BA 호스트와 웹 UI는 공통으로 한 번 빌드·서명하고, 제품별 차이는 installer-ui.json과 자산으로만 전달한다.
  • 기본 화면 카탈로그(신규 설치 7개, 유지 관리 2개, 상태 6개)를 제공한다. 1단계는 welcome, license, installFolder, review, progress, finish, failure, cancelled, maintenance, uninstallConfirm 10개다.
  • WebView2가 없으면 같은 BA의 기본 네이티브 화면으로 설치한다. 무인 설치는 WebView2를 쓰지 않는다.
  • 09 설치 과정과 UI 편집의 Rust/Tauri BA 방식과 WixStdBA 테마를 첫 구현으로 삼는 순서는 채택하지 않는다.

모델과 실행

  • 프로젝트 모델의 formats.exe.installerUi 필드는 아직 추가하지 않았다. 구현 단계에서 project-model-change 절차로 반영한다.
  • 웹 UI와 호스트는 정해진 메시지(init, detected, validate, apply, progress, result 등)만 주고받으며 호스트가 모든 입력을 다시 검증한다.

확인 결과

  • 실행한 것: 문서 작성과 저장소 내부 링크 연결(09, 10, 설계 색인, 루트 README).
  • 실행하지 않은 것: BA 구현, WebView2 연결, Burn 번들 빌드, VM 설치·업그레이드·제거·취소 시험, WebView2 미설치 PC 시험, 접근성 시험. 백로그 BL-08 검증 실험으로 수행한다.

근거