83 lines
2.2 KiB
Markdown
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 재빌드 → 업로드.
|