68 lines
1.7 KiB
Markdown
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`
|