반응형
PWA를 Android 마켓(Play 스토어)에 TWA(Trusted Web Activity)로 올리는 방법을 단계별로 설명해줄게.
1. 기본 요구사항 확인
- PWA는 HTTPS에서 호스팅되어야 함.
- PWA의 Web App Manifest(manifest.json)에 display: "standalone" 또는 "fullscreen"이 포함되어야 함.
- 서비스 워커(Service Worker)가 있어야 하며, 오프라인 지원이 가능해야 함.
- PWA가 Lighthouse 테스트에서 "PWA 기본 조건"을 만족해야 함.
2. Bubblewrap을 사용하여 TWA 설정
Bubblewrap은 Google이 제공하는 TWA 패키지를 만드는 CLI 도구야.
(1) Node.js 및 Bubblewrap 설치
npm install -g @bubblewrap/cli
(2) 프로젝트 초기화
bubblewrap init --manifest https://your-pwa-url.com/manifest.json
- https://your-pwa-url.com/manifest.json은 네 PWA의 매니페스트 URL로 변경해야 해.
(3) 디지털 자산 링크 설정
- assetlinks.json 파일을 PWA의 .well-known/ 폴더에 업로드해야 함.
- assetlinks.json 파일은 bubblewrap init 후 자동 생성됨.
(4) 빌드 및 서명
bubblewrap build
빌드를 진행하면 .apk 파일이 생성됨.
3. Play 스토어 등록
(1) Google Play Console 가입 및 앱 생성
- Google Play Console에서 새 앱을 생성
- 패키지 이름은 bubblewrap init 시 설정한 값과 일치해야 함
(2) 앱 서명 및 배포
- bubblewrap build로 생성된 .apk 또는 .aab 파일을 Play 스토어에 업로드
(3) 검토 및 배포
- 스토어 등록 정보를 작성하고 앱을 심사 요청 후 배포하면 끝!
추가 팁
- TWA가 정상적으로 동작하는지 adb install your-app.apk 후 직접 테스트 가능.
- Play 스토어 등록 전, Google Play 앱 서명 기능을 활성화하는 것이 좋음.