Files
goldenChart/docs/mobile-tablet-phase1.md
T
2026-06-17 10:00:34 +09:00

68 lines
1.7 KiB
Markdown

# Android 모바일·태블릿 (Phase 1)
## 범위
| 항목 | 지원 |
|------|------|
| Android 휴대폰 | ✅ 동일 APK |
| Android 태블릿(패드) | ✅ 동일 APK (반응형 UI) |
| iPad | ⏸ 향후 (TestFlight) |
## 파이프라인
```
git push main
→ post-receive (deploy.sh)
→ trigger-mobile-jenkins-build.sh
→ jenkins-mobile-pipeline.sh
→ bump-android-version.sh (CI patch + versionCode++)
→ build-mobile-apk.sh
→ data/mobile-releases/goldenchart-android.apk
→ GC_MOBILE_APP_VERSION (.env)
→ backend 재시작
```
## 다운로드 UI
| 위치 | 내용 |
|------|------|
| **모바일** 탭 | QR + APK 다운로드 (Android 전용) |
| **PC 프로그램** 탭 | Android (패드·폰) 카드 |
| `/install.html` | QR 설치 페이지 |
## 앱 내 자동 업데이트 (Android)
1. `/api/mobile-app/info``version` vs `@capacitor/app` `versionName`
2. 새 버전이면 시작·앱 복귀 시 confirm → `App.openUrl`로 APK 다운로드
3. 설정 → **업데이트 확인** 수동 트리거
## Jenkins (서버 1회)
```bash
./scripts/server-install-mobile-jenkins.sh
./scripts/server-setup-mobile-phase1.sh # hook·env·검증
```
## 환경 변수
| 변수 | 설명 |
|------|------|
| `GC_MOBILE_APP_VERSION` | API·앱 업데이트 비교용 버전 |
| `GC_MOBILE_JENKINS_*` | Jenkins mobile job |
| `GC_MOBILE_APP_PUBLIC_BASE_URL` | 다운로드 URL base (기본 `https://stock.exdev.co.kr`) |
## 수동 빌드
```bash
# 버전 bump 없이
BUMP_VERSION=0 ./scripts/jenkins-mobile-pipeline.sh
# bump 포함 (CI와 동일)
./scripts/jenkins-mobile-pipeline.sh
```
## API
- `GET /api/mobile-app/info`
- `GET /api/mobile-app/download/android`