Google Play에 프로그레시브 웹 앱 등록

Google Play에 PWA를 등록하면 세계 최대 앱 스토어에서 검색 가능해집니다. Google Play에서는 앱 평점 및 리뷰도 제공하므로 사용자가 PWA를 설치하기 전에 PWA에 대한 유용한 정보를 얻을 수 있습니다. 마지막으로 Google Play에 앱을 등록하면 Google Play 결제의 강력한 기능도 이용할 수 있습니다. 이를 통해 사용자는 익숙한 결제 플랫폼을 사용할 수 있으며 여러 국가의 결제를 지원할 수 있습니다.

뽁뽁이

Bubblewrap은 프로그레시브 웹 앱을 가져와 Android 앱 개발 지식 없이도 ChromeOS 및 Android의 Play와 같은 앱 스토어를 통해 배포할 수 있도록 Android 앱 번들로 래핑하는 CLI입니다.

시작하려면 NPM에서 Bubblewrap을 설치하세요.

$ npm install -g @bubblewrap/cli

프로젝트를 초기화하려면 PWA의 웹 앱 매니페스트를 입력으로 전달합니다. 그러면 Bubblewrap에서 PWA Play 패키지를 빌드할 Android 프로젝트를 생성합니다.

$ bubblewrap init --manifest=""

그런 다음 프로젝트를 빌드하면 Bubblewrap에서 Google Play에 업로드하여 배포할 수 있는 패키지 (APK 또는 AAB)를 만듭니다.

$ bubblewrap build

빠른 시작 가이드와 명령어에 관한 자세한 내용은 공식 CLI 문서를 확인하세요.

ChromeOS만 해당

이미 플랫폼별 Android 앱이 있거나 모바일 환경을 원하지 않는 경우 init 명령어에 --chromeosonly 플래그를 추가하여 ChromeOS에서만 애플리케이션을 사용할 수 있도록 할 수 있습니다.

$ bubblewrap init --manifest="" --chromeosonly

애플리케이션을 이미 초기화한 경우 twa-manifest.json 파일에서 isChromeOSOnly 플래그를 true으로 설정하고 Bubblewrap의 update 명령어를 실행하여 이 구성을 변경할 수 있습니다.

서명 키

서명 키는 개발자를 앱의 원작자로 지정하며, 앱에 적용되는 업데이트에는 원본 서명 키를 사용해야 합니다. 프로젝트를 초기화할 때 Bubblewrap에서 기존 키를 요청하거나 새 키를 생성합니다.

이 키를 보호하고 분실하지 않는 것이 매우 중요합니다. 이 키를 분실하면 Google Play에서 애플리케이션을 업데이트하기가 매우 어려워질 수 있습니다.

디지털 애셋 링크를 설정하려면 여러 단계를 거쳐야 합니다. Google Play에서 앱에 관한 정보를 수집하고 웹 애플리케이션의 특정 위치에 파일을 배포해야 합니다. PWA의 디지털 애셋 링크를 설정하는 방법에 관한 팁은 아래 동영상을 참고하세요.

이 동영상이 게시된 이후로 Bubblewrap은 더 이상 디지털 애셋 링크 파일을 생성하지 않습니다. 대신 도구에서 fingerprint 명령어를 확인하세요.

Google Play에 앱 게시

Google Play에 앱을 게시할 준비가 되면 다음 단계를 따르세요.

이제 Google Play에 앱을 출시할 수 있습니다. 먼저 신뢰할 수 있는 테스터 목록을 사용하여 테스트 트랙에 출시하여 앱이 예상대로 작동하는지 확인하는 것이 좋습니다.

참고: Google Play에 게시된 PWA에는 유료 앱 옵션을 사용하지 않는 것이 좋습니다. 설치된 PWA는 사용자의 브라우저에서 액세스할 수 있어야 하며, 탐색이 Play 설치 앱에서 비롯되었는지 확인하는 유일한 방법은 클라이언트 측 검사에 의존하며 모든 탐색에 대해 실행되지 않을 수 있습니다. 따라서 다른 유료 앱과 같은 방식으로 액세스를 제한하는 안전한 방법이 없으므로 대신 인앱 구매 또는 정기 결제를 통해 수익을 창출하는 것이 좋습니다.

ChromeOS용 PWA와 플랫폼별 Android 앱을 하나의 목록에 나열

플랫폼별 Android 애플리케이션을 통해 이미 Android에 잘 알려져 있으며 Chromebook 전용 PWA를 Google Play에 출시하려는 경우 동일한 등록정보에서 모두 처리할 수 있습니다. PWA를 패키징할 때 위에 언급된 ChromeOS 전용 플래그를 사용해야 합니다. 이렇게 하면 PWA 버전이 Chromebook에서만 제공됩니다. Play 스토어 등록정보를 공유할 PWA와 Android 앱에 동일한 서명 키를 사용해야 합니다.

경고: ChromeOS 전용 앱보다 버전 번호가 높은 모바일 Android 앱을 업로드하면 모바일 Android 앱이 Chromebook과도 호환되는 경우 ChromeOS 전용 앱이 대체됩니다. 권장사항으로 ChromeOS 앱을 모바일 Android 앱보다 여러 버전 높게 설정하세요. 예를 들어 Android 버전이 1인 경우 ChromeOS는 1000으로 설정합니다. 그런 다음 각 버전에 대해 새 버전을 만들 때 ChromeOS 버전이 항상 더 크면 버전 번호를 적절히 늘릴 수 있습니다. Play에서 앱을 배포할 때는 지정된 기기와 호환되는 버전 중 가장 높은 버전을 사용합니다.

ChromeOS 버전을 만들 때 최신 출시된 Android App Bundle을 포함해야 합니다. 최신 모바일 패키지가 ChromeOS 버전에 포함되지 않은 경우 모바일 Android 기기의 사용자는 앱을 설치할 수 없습니다. '이전 버전' 섹션에서 최신 Android 모바일 버전에 해당하는 APK 또는 AAB를 찾아 '포함'을 선택합니다.

Play Console에서 새 버전을 만들 때 이전 버전의 APK 또는 AAB를 포함할 수 있습니다.

마찬가지로 Android 버전을 만들 때도 ChromeOS용으로 출시된 최신 App Bundle을 포함해야 합니다. 그렇지 않으면 ChromeOS 사용자가 기기에 앱을 처음 설치할 때 ChromeOS 앱이 아닌 Android 앱이 표시됩니다.

Google Play 결제 정책 준수

PWA에서 Play 결제 정책에 해당하는 디지털 상품을 판매하는 경우 앱을 실행하기 전에 Play 결제를 통합해야 합니다. 웹 앱에 Google Play 결제 통합에 대해 자세히 알아보세요.

Play에서 PWA 업데이트하기

사용자가 Google Play를 통해 PWA를 설치한 후 라이브 웹 앱을 사용하므로 배포된 앱을 업데이트해야 하는 시나리오가 몇 개 없습니다. 여기에는 다음이 포함됩니다.

  • 앱이 출시된 지 1년이 지난 경우 이 경우 앱이 최신 Android SDK와 호환되도록 업데이트해야 합니다.
  • 동일한 등록정보에 별도의 모바일 및 Chrome OS 전용 패키지가 있고 플랫폼별 Android 버전 번호가 Chrome OS 전용 PWA 버전을 초과하는 경우 이 경우 플랫폼별 Android 앱 출시를 유지하면서 PWA 버전을 업데이트하고 앱을 다시 배포해야 합니다.
  • 활용하고 싶은 새로운 기능이 있는 경우
  • 웹 앱 매니페스트를 변경한 경우(예: 아이콘 또는 테마 색상 업데이트) Play의 PWA에 이러한 변경사항을 적용하려는 경우 이 경우 Bubblewrap 프로젝트를 다시 컴파일하고 앱을 다시 배포해야 합니다.