f34104b721
Capacitor 확장으로 git push 시 Mobile Jenkins 빌드, PC 탭 Android/iPad 다운로드, 앱 내 APK 업데이트, iOS TestFlight API 및 Capacitor ios 프로젝트를 추가한다. Co-authored-by: Cursor <cursoragent@cursor.com>
1.8 KiB
1.8 KiB
모바일·태블릿 Phase 1 — Capacitor 확장 (A)
스택 결정
| 항목 | 선택 |
|---|---|
| 단기 경로 | 1단계 A — Capacitor 확장 (app/) |
| 장기(선택) | 2단계 B — Tauri Mobile 이전 (미착수) |
| Android 패드 | 동일 APK (반응형 UI) |
| iPad | TestFlight 링크 (ipa 직접 다운로드·앱 내 updater 불가) |
Phase 1 목표: 데스크톱과 동일한 git push → CI 빌드 → 다운로드 허브 흐름을 Android에 맞추고, PC 프로그램 탭에서 Android·iPad를 함께 제공한다.
파이프라인
git push main
→ post-receive (deploy.sh)
→ trigger-mobile-jenkins-build.sh
→ jenkins-mobile-pipeline.sh
→ build-mobile-apk.sh
→ data/mobile-releases/goldenchart-android.apk
→ GC_MOBILE_APP_VERSION (.env)
다운로드 UI
PC 프로그램 탭 (AppDownloadModal):
- macOS (.dmg) — 기존
- Windows (.exe) — 기존
- Android 패드/폰 (.apk) —
/api/mobile-app/info - iPad (TestFlight) —
GC_MOBILE_APP_IOS_TESTFLIGHT_URL링크
Android 앱 내 업데이트
- 시작 시
/api/mobile-app/info버전 vs@capacitor/appversion - 새 버전이면 APK 다운로드 URL 열기 (재설치)
iPad / TestFlight
- Mac + Xcode + Apple Developer Program
cd app && npm run cap:sync && npx cap open ios- Archive → TestFlight 업로드
- 서버
.env:GC_MOBILE_APP_IOS_TESTFLIGHT_URL=https://testflight.apple.com/join/...
Jenkins 설치 (서버 1회)
./scripts/server-install-mobile-jenkins.sh
# .env 예시
# GC_MOBILE_JENKINS_TRIGGER_TOKEN=goldenchart-mobile-build
환경 변수
| 변수 | 설명 |
|---|---|
GC_MOBILE_APP_VERSION |
웹·API 표시 버전 |
GC_MOBILE_APP_IOS_TESTFLIGHT_URL |
iPad TestFlight 초대 URL |
GC_MOBILE_JENKINS_* |
Jenkins mobile job (desktop과 동일 패턴) |