releases/.claude/skills/release/SKILL.md
Yun Chan 02995f4153 MEDIABROWSER 개명·업데이트 채널 전환·아이콘 tofu 근본 수정 (BACKLOG 13차) — ①개명: installer.iss AppName/출력 MediaBrowser-Setup-*(AppId·exe·데이터 경로 유지로 업그레이드 호환), 워크플로 산출물명(mediabrowser-*.tar.gz, MediaBrowser-<ver>-arm64.apk), 창 타이틀·모바일 표시명·obtainium.json·README. ②UpdateChecker: apiBase 주입(기본=자체 Forgejo /api/v1, GitHub 는 apiBase 로 호환), osx 자산 tar.gz 허용(기존 dmg 만 → mac 영원히 자산 없음 결함 수정), AppConfig 기본 UpdateRepo=Video-Downloader/releases+UpdateApiBase — 테스트 4건. ③아이콘 tofu(사용자 보고 "절대 안고쳐지네") 근본 원인: Shared.xaml 암시적 TextBlock 스타일의 FontFamily=UiFont 강제가 버튼 ContentPresenter 자동 TextBlock 의 IconFont 상속을 덮어 모든 PUA 글리프가 notdef — 폰트 설치/글리프 존재/HW·SW 렌더/RTB/DPI/런타임 8·10/자체포함·공유 전부 배제 후 실창 픽셀 비교로 격리, 콘텐츠 TextBlock 의 실폰트가 Pretendard 체인임을 테스트로 실증. 수정: 암시 스타일 FontFamily 제거(창 루트 상속으로 통일, PairingWindow/PlayerWindow 는 SetResourceReference), PUA+텍스트 혼합 콘텐츠 7곳+코드 1곳 정리, 순수 글리프 2곳 IconFont 명시. 회귀 방어: IconGlyphXamlTests(정적 스캔)·IconContentFontTests(실창 폰트 단정)·IconGlyphRenderTests(픽셀 비교) — 462/462 GREEN, 수정 전후 실창 캡처로 글리프 렌더 확인
2026-08-18 07:13:18 +09:00

2.4 KiB

name description
release VideoDownloader 배포 절차. Windows 설치자(x64/arm64) 생성과 macOS/Linux 원격 빌드머신 빌드를 수행한다. "배포", "설치자 만들어", "릴리스", "publish" 요청에 사용.

배포

배포는 되돌리기 어렵다. 각 단계 전에 사용자 확인을 받는다. 요청받지 않은 배포를 임의로 하지 않는다.

0. 사전 점검 (필수)

dotnet test VideoDownloader.Tests
git status --short
  • 테스트 실패가 있으면 배포하지 않는다.
  • 커밋되지 않은 변경이 있으면 사용자에게 알린다. 원격 빌드는 git archive HEAD 로 소스를 보내므로 커밋되지 않은 변경은 원격 빌드에 반영되지 않는다.

1. Windows 설치자

./build/publish.ps1 -Config Release -Version <버전>
  • 하는 일: VideoDownloader.App 을 win-x64/win-arm64 self-contained 로 publish (publish/<arch>/) → Inno Setup 으로 설치자 컴파일 → out/MediaBrowser-Setup-<arch>.exe
  • 필요: Inno Setup 6 (winget install --id JRSoftware.InnoSetup -e). 없으면 스크립트가 명시적으로 throw 한다.
  • 특정 아키텍처만: -Archs x64
  • arm64 첫 빌드는 yt-dlp/WebView2 런타임 관련으로 실패할 수 있다. 실패 메시지를 그대로 사용자에게 전달한다.
  • 완료 시 스크립트가 산출물 크기를 출력한다. 그 출력을 인용해 보고한다.

2. macOS / Linux 원격 빌드

bash build/remote/build-remote.sh all      # 또는 linux | mac
  • 하는 일: git archive HEAD 로 현재 커밋 소스를 빌드머신에 SSH 전송 → Cli + Avalonia 를 RID별 self-contained publish → out/remote/<rid>/artifacts-<rid>.tar.gz 수집
  • 자격 증명은 .env 의 MAC_OS_HOST/LINUX_OS_HOST 등을 쓴다. .env 내용을 읽어서 출력하거나 로그에 남기지 않는다.
  • 빌드머신이 절전이면 SSH 가 끊긴다. 재연결 후 재시도한다.
  • Avalonia 12.1 은 빌드머신에 .NET 10 SDK 가 있어야 한다. 8만 있으면 CS0103 으로 실패한다.

3. 배포 후

  • 산출물 경로와 크기를 보고한다.
  • out/, publish/ 는 gitignore 대상이다. 커밋하지 않는다.
  • 릴리스 배포처(GitHub Releases 등)에 올리는 것은 별도 승인 사항이다. 임의로 업로드하지 않는다.
  • 배포 체계 전반은 docs/DEPLOYMENT_PLAN.md 참고.