mobile download

2026-05-28 14:44:19 +09:00
parent e2816b037f
commit 3503ef33f5
152 changed files with 11021 additions and 687 deletions
@@ -0,0 +1,64 @@
+# 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 재빌드 → 업로드.