# GoldenChart Android APK 배포

APK는 **Git에 포함하지 않습니다.** 로컬에서 빌드 후 서버 `data/mobile-releases/`에 업로드합니다.

## exdev.co.kr 업로드 (권장)

```bash
# 1) docker-compose 볼륨 변경을 서버에 반영 (최초 1회)
git push origin main   # Jenkins 자동 배포

# 2) 로컬 APK 업로드
chmod +x scripts/upload-android-apk.sh
./scripts/upload-android-apk.sh

# 빌드부터 한 번에
./scripts/upload-android-apk.sh --build --version 1.0.0
```

서버 경로는 SSH로 `deploy.sh`의 `WORK_TREE`를 자동 탐색합니다 (기본: `/Users/aidev/apps/goldenChart`).

로컬 오버라이드: `scripts/deploy-target.local.env`

```bash
REMOTE_PROJECT_DIR=/Users/aidev/apps/goldenChart
PUBLIC_URL=http://exdev.co.kr
```

## 서버 파일 위치

```
<WORK_TREE>/data/mobile-releases/goldenchart-android.apk
```

Docker backend가 `/app/data/mobile-releases`로 마운트해 제공합니다.

- API: `GET /api/mobile-app/info`
- 다운로드: `GET /api/mobile-app/download/android` (절대 URL: `http://exdev.co.kr`, HTTPS 443 미사용)
- 설치 페이지: `http://exdev.co.kr/install.html`

exdev.co.kr은 **HTTP(80)만** 열려 있습니다. QR URL에 `https://` 를 쓰면 휴대폰에서 연결되지 않습니다.

## 로컬만 (개발 PC)

```bash
./scripts/copy-android-apk.sh
docker compose up -d backend   # 볼륨 마운트 후
```

## 환경 변수 (서버 .env)

| 변수 | 설명 |
|------|------|
| `GC_MOBILE_APP_RELEASE_DIR` | 컨테이너 내부 APK 경로 (compose 기본값 사용) |
| `GC_MOBILE_APP_VERSION` | 웹 UI 표시 버전 (`--version` 옵션으로 설정) |

## 앱 API URL

모바일 앱은 `app/.env`의 `VITE_API_BASE_URL`이 **빌드 시** 박힙니다. exdev 배포용:

```env
VITE_API_BASE_URL=http://exdev.co.kr/api
```

변경 후 `npm run cap:sync` → APK 재빌드 → 업로드.