goldenChart/docs/mobile-tablet-phase1.md

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회)

./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 (기본 https://stock.exdev.co.kr)

수동 빌드

# 버전 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