chpark
c5ff736cc9
Deploy momo-erp / deploy (push) Successful in 1m55s
스토어 업로드는 AAB. 기존 패키지(com.momotogether.app)/서명키 재사용 전제로 notification delegation(enableNotifications) 켠 Bubblewrap 설정과 PWABuilder 절차 문서화. keystore/빌드 산출물은 .gitignore 처리.
모모유통 ERP — Android(TWA) 빌드
웹앱(momotogether.com)을 감싸는 TWA(Trusted Web Activity) 패키지 빌드 설정입니다.
패키지명 com.momotogether.app — public/.well-known/assetlinks.json 의 지문과 짝을 이룹니다.
스토어 업로드 형식
- Google Play 스토어 → AAB (필수)
- 직접 배포(사이드로드) → APK
⚠️ 서명키(중요)
반드시 기존에 쓰던 keystore 그대로 사용해야 합니다.
다른 키로 서명하면 assetlinks.json 지문이 안 맞아 주소창이 다시 뜨고 알림 위임(푸시) 이 깨집니다.
- 기존 지문:
2A:55:B2:9E:03:51:2B:DE:28:E2:A4:34:15:9C:23:1F:21:B6:C0:43:9C:10:3B:6C:E2:D5:46:F7:AF:42:C3:97 - Play App Signing 을 쓰는 경우, Play Console 의 앱 서명 인증서 SHA-256 도 assetlinks 에 포함되어야 합니다.
방법 A — PWABuilder (권장, 로컬 툴 불필요)
- https://www.pwabuilder.com 에서
https://momotogether.com입력 - Package For Stores → Android Package
- 옵션에서 Notification delegation(알림 위임) 켜기 ✅ (이게 켜져야 "삼성 인터넷" 대신 앱 이름으로 알림이 옵니다)
- 기존 서명키 업로드(처음 만들 때 받은 keystore) — 새로 만들지 말 것
- versionCode 를 현재 게시 버전보다 +1 로
- 생성된 .aab 를 Play Console 에 새 버전으로 업로드
방법 B — Bubblewrap CLI (이 폴더의 twa-manifest.json 사용)
JDK 17 + Android SDK 필요.
npm i -g @bubblewrap/cli
cd android
# 기존 keystore 를 ./android.keystore 로 복사 (signingKey.path 와 일치)
bubblewrap build # app-release-bundle.aab(스토어용) + app-release-signed.apk(사이드로드용) 생성
twa-manifest.json의enableNotifications: true가 알림 위임 활성화 키입니다.- 새 버전 낼 때마다
appVersionCode를 올리세요.
설치 후 (사용자)
홈화면 설치 → 첫 실행 시 알림 권한 허용 → 출고요청 화면의 알림 스위치 ON. 그러면 새 품목 등록 시 "모모유통" 이름·아이콘으로 푸시가 옵니다.