67 lines
3.0 KiB
Markdown
67 lines
3.0 KiB
Markdown
# Firebase Hosting 시즌 배포 가이드 (오너용)
|
|
|
|
앱은 시작할 때마다 `CONTENT_BASE_URL/manifest.json`을 확인하고, 새 시즌 팩을
|
|
SHA256 검증 후 내려받습니다. 호스팅은 정적 파일 서버이기만 하면 되며,
|
|
Firebase Hosting 무료 플랜이면 충분합니다.
|
|
|
|
## 1회 설정 (약 15분)
|
|
|
|
1. https://console.firebase.google.com → **프로젝트 추가** → 이름 `block-seasons`
|
|
→ Google Analytics **사용 설정** (이후 분석 연동에 사용).
|
|
2. 터미널에서:
|
|
```bash
|
|
npm install -g firebase-tools
|
|
firebase login
|
|
cd "/Volumes/Macintosh 2nd/Project/My_Game_Project/BlockSeasons"
|
|
firebase init hosting
|
|
# → Use an existing project → block-seasons
|
|
# → public 디렉터리: deploy
|
|
# → single-page app: No / 자동 빌드: No
|
|
```
|
|
3. 생성된 호스팅 도메인(예: `https://block-seasons.web.app`)을 Claude에게
|
|
알려주세요 — 앱의 `CONTENT_BASE_URL` 기본값(lib/main.dart)을 그 도메인으로
|
|
맞추고, `flutterfire configure`를 함께 진행해 Firebase Analytics 백엔드도
|
|
연결합니다.
|
|
|
|
## 시즌 배포 (매 시즌 약 1분)
|
|
|
|
새 시즌 팩을 생성한 뒤(`dart run tool/stage_generator/generate.dart ...`):
|
|
|
|
```bash
|
|
cd "/Volumes/Macintosh 2nd/Project/My_Game_Project/BlockSeasons"
|
|
dart run tool/make_manifest.dart
|
|
|
|
rm -rf deploy/content && mkdir -p deploy/content/seasons
|
|
cp content/manifest.json deploy/content/
|
|
for d in content/season_*/; do
|
|
id=$(basename "$d")
|
|
mkdir -p "deploy/content/seasons/$id"
|
|
cp "$d/pack.json" "deploy/content/seasons/$id/"
|
|
done
|
|
|
|
firebase deploy --only hosting
|
|
```
|
|
|
|
배포 직후 모든 유저의 **다음 콜드 스타트**에서 새 시즌이 나타납니다.
|
|
앱 업데이트·스토어 심사가 필요 없습니다.
|
|
|
|
## 동작 방식 요약 (참고)
|
|
|
|
- `manifest.json`: 시즌 목록 + 버전 + SHA256. `tool/make_manifest.dart`가 생성.
|
|
- 클라이언트: 버전이 다른 팩만 다운로드 → SHA256 일치 시에만 원자적으로 캐시
|
|
교체. 검증 실패·오프라인·서버 오류는 전부 조용히 무시되고 기존 캐시 또는
|
|
번들 시즌 1로 동작.
|
|
- 시즌 1은 앱에 번들되어 있어 인터넷이 한 번도 연결되지 않아도 게임이
|
|
완전히 동작합니다 (E2E 검증 완료: docs/screenshots/sim_offline_fallback.png).
|
|
- 원격 시즌 등장 검증: docs/screenshots/sim_remote_season2.png ("SEASON 2 ·
|
|
여름 파도"가 로컬 서버 배포만으로 등장).
|
|
|
|
## 주의
|
|
|
|
- `pack.json`을 수정하면 반드시 `make_manifest.dart`를 다시 실행해 SHA256을
|
|
갱신해야 합니다 (불일치 시 클라이언트가 팩을 거부).
|
|
- 시즌 팩에 새 필수 필드를 도입하는 스키마 변경 시 `schemaVersion`을 올리면
|
|
구버전 앱은 그 팩을 무시합니다 (크래시 없음).
|
|
- `minAppBuild` 필드는 아직 클라이언트가 강제하지 않습니다 — 앱 버전 의존
|
|
콘텐츠를 배포하기 전에 강제 로직을 추가해야 합니다 (Phase 7 체크리스트).
|