# 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 (기본 `http://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`