itsm_ysm/deploy/apk/README.md
itms-merge-dev 5e5ccc0ec7 docs+build(itms): CI/CD 정본 문서·APK 게시 자산·모바일 빌드 수정 (v1.0.0 APK 게시)
- docs/CICD_PIPELINE.md 정본(LIVE) + deploy/README.md 가동중 갱신
- deploy/apk/: publish_app_manifest.sh·mobile-app.html(WISE QR)·itms-latest.json
- deploy/nginx: /mobile-app(ITMS 전용)+/downloads/(APK)+매니페스트 서빙 반영
- mobile: EAS 빌드 의존 승격(react-navigation/expo-modules-core/metro)·.easignore·eas appVersionSource

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-19 19:41:29 +09:00

1.5 KiB

ITMS 모바일 APK — 서버 게시 준비물

로컬 준비물만 포함(서버 무접촉). 서버 작업은 담당 에이전트가 수행.

파일

  • itms-latest.json — 배포 매니페스트(버전·apkUrl·sizeBytes·sha256·publishedAt). sizeBytes/sha256 는 서버 배치 후 publish_app_manifest.sh 실행으로 확정.
  • publish_app_manifest.sh — APK 배치 후 매니페스트를 원자적으로 기록(+qrencode 있으면 QR PNG 생성). CAMP deploy/publish_app_manifest.sh 패턴.
  • mobile-app.html/mobile-app 정적 게시 페이지(WISE 스타일, 다크모드 대응). itms-latest.json 을 fetch 해 버전/크기/SHA/다운로드 자동 표시. itms-apk-qr.png 존재 시 QR 표시, 없으면 다운로드 버튼 안내로 폴백.

서버 게시 절차(담당 에이전트용, 참고)

# 1) APK 배치
cp itms-mobile-v1.0.0.apk /opt/itms/downloads/itms.apk
# 2) 매니페스트 + QR 생성(운영 도메인)
./publish_app_manifest.sh 1.0.0 /opt/itms/downloads/itms.apk https://itms.wise.ai.kr/downloads/itms.apk
# 3) 정적 페이지 배치
cp mobile-app.html /opt/itms/downloads/mobile-app.html   # 또는 nginx location /mobile-app
# 4) nginx: /downloads/ 와 /mobile-app 정적 서빙 + (필요 시) itms.apk MIME application/vnd.android.package-archive

주의

  • EXPO 토큰·키스토어·자격증명 미포함. 공개 다운로드 URL만 기록.
  • 다운로드 URL 기본값은 운영(itms.wise.ai.kr). 개발 검증은 https://itms.zioinfo.co.kr/downloads/itms.apk 등으로 3번째 인자 지정.