Macbook
f34104b721
Capacitor 확장으로 git push 시 Mobile Jenkins 빌드, PC 탭 Android/iPad 다운로드, 앱 내 APK 업데이트, iOS TestFlight API 및 Capacitor ios 프로젝트를 추가한다. Co-authored-by: Cursor <cursoragent@cursor.com>
62 lines
1.8 KiB
Markdown
62 lines
1.8 KiB
Markdown
# 모바일·태블릿 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/app` `version`
|
|
- 새 버전이면 APK 다운로드 URL 열기 (재설치)
|
|
|
|
## iPad / TestFlight
|
|
|
|
1. Mac + Xcode + Apple Developer Program
|
|
2. `cd app && npm run cap:sync && npx cap open ios`
|
|
3. Archive → TestFlight 업로드
|
|
4. 서버 `.env`: `GC_MOBILE_APP_IOS_TESTFLIGHT_URL=https://testflight.apple.com/join/...`
|
|
|
|
## Jenkins 설치 (서버 1회)
|
|
|
|
```bash
|
|
./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과 동일 패턴) |
|