Files
goldenChart/data/mobile-releases/README.md
T
2026-06-17 10:00:34 +09:00

83 lines
2.2 KiB
Markdown

# GoldenChart Android APK 배포
APK는 **Git에 포함하지 않습니다.** 로컬에서 빌드 후 서버 `data/mobile-releases/`에 업로드합니다.
## exdev.co.kr 업로드
### Jenkins 자동 (git push main)
`post-receive``trigger-mobile-jenkins-build.sh``goldenChart-Mobile-Pipeline`
```bash
# 서버 최초 1회
./scripts/server-install-mobile-jenkins.sh
```
로컬 CI와 동일한 빌드:
```bash
./scripts/jenkins-mobile-pipeline.sh
```
### 수동 업로드
```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=https://stock.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: `https://stock.exdev.co.kr`, HTTPS 443 미사용)
- 설치 페이지: `https://stock.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 표시 버전 (Jenkins가 `build.gradle` versionName 반영) |
| `GC_MOBILE_APP_IOS_TESTFLIGHT_URL` | iPad TestFlight 초대 URL |
## 앱 API URL
모바일 앱은 `app/.env``VITE_API_BASE_URL`**빌드 시** 박힙니다. exdev 배포용:
```env
VITE_API_BASE_URL=https://stock.exdev.co.kr/api
```
변경 후 `npm run cap:sync` → APK 재빌드 → 업로드.