[Next.js] PWA 웹앱 구글 플레이 스토어 배포 방법 A to Z

들어가며

이 글은 아래 사항이 완료되었다는 가정 하에 진행합니다.

• 구글 플레이 계정 생성 및 승인
• PWA 적용

만약 계정이 생성되어있지 않다면 아래 '계정 생성' 섹션 링크를 통해 계정 생성을 완료해주세요.

 

사전 준비

계정 생성

https://play.google.com/console/u/0/developers/5424186097989016611/create-new-app

Google Play Console

Tip

계정 생성 시 주소 인증이 이루어져야 합니다.

이 때, 주소 인증을 위한 첨부파일은 주민등록표 등본이 가장 정확합니다.

https://www.gov.kr/mw/AA020InfoCappView.do?CappBizCD=13100000015

주민등록표 등본(초본) 발급 | 민원안내 및 신청 | 정부24

 

PWA 적용

https://sooncoding.tistory.com/218

[Next.js] Next.js 15버전 PWA 적용 방법

 

시작하기

1. 내부 테스트

1.1 테스터 선택

Tip

실수로 '새 버전 만들기'를 클릭하고 되돌아와 버전이 생성되었다면 '버전 미리보기 및 확인' > '임시 출시 삭제' 과정을 거쳐야합니다.

내부 테스터로 등록할 이메일을 쉼표로 구분하여 입력 후 추가합니다.(또는 CSV 파일 업로드를 통해 추가합니다)
ex) abc123@gmail.com, def456@gmail.com, ...

Tip

내부 테스터 모집은 오픈 카카오톡에서 '테스터 품앗이' 를 검색하세요.

테스터 선택 끝.

 

1.2 새 버전 만들기

새 버전을 만들기 위해서는 .aab 파일이 필요합니다.

필자는 PWA 환경이므로 PWA Builder 웹사이트를 사용하여 .aab 파일을 생성하였습니다.

아래 과정을 통해 PWA 환경에서 .aab 파일을 생성하는 과정을 설명합니다.

 

> PWA 환경에서  .aab 파일 생성

https://www.pwabuilder.com/

PWABuilder

위 사이트에 접속합니다.

내 웹사이트 링크를 입력 후 Start 버튼을 클릭합니다.

필자는 구글 플레이 스토어에 배포할 것이므로 안드로이드를 선택했습니다.

옵션을 따로 설정하지 않고 다운로드 합니다.

다운로드된 압축폴더

다운로드 받은 압축 폴더를 압축 풀기합니다.

Tip

signing-key-info.txt와 signing.keystore에는 앱 업데이트에 필요한 키가 있습니다.

해당 키는 이후 과정 및 업데이트 시 사용되니 반드시 안전한 곳에 백업해 주세요.

aab파일을 업로드합니다.

.aab 파일이 정상적으로 업로드 되었다면 출시명과 출시노트를 입력 후 '다음' 버튼을 클릭합니다.

Tip

출시명이란  개발자가 버전을 구분하기 위해 지정한 이름으로 Google Play에서 사용자에게 표시되지는 않습니다.

출시 노트에는 주요 기능과 추천 사용자를 작성했습니다.

새 버전 만들기 끝.

 

1.3 테스터 모집

내부 테스트 > 테스터 > 링크 복사

해당 링크를 테스터로 등록한 메일 주인들에게 발송 후 테스트를 요청합니다.

테스터 모집 끝.

 

 

 

2. 앱 설정

2.1 개인정보처리방침 생성 및 등록

개인정보처리방침 파일 및 URL 생성을 위해 아래 사이트를 활용합니다.

https://www.freeprivacypolicy.com/

 

개인정보처리방침 생성완료.

URL을 복사합니다.

복사한 URL을 붙여넣기 후 저장 버튼을 클릭합니다.

Tip. 개인정보처리방침 작성방법

https://learn-dev.tistory.com/31

[Web, App] 개인정보 처리 방침 간편하게 생성하는 방법

 

2.2 ~ 2.10

생략.

위 과정은 출시 앱에 대한 설문조사 과정과 비슷하기에 생략합니다.

 

2.11 스토어 설정

Tip

전화번호를 적을 때는 지역번호를 추가해야합니다.

 

2.12

생략합니다.

 

 

 

3. 비공개 테스트

3.1 ~ 3.2

이전 과정과 유사하므로 생략합니다.

 

3.3 새 버전 만들기

비공개 테스트를 위해 다시 한번 .aab 파일을 생성 후 업로드해야합니다.

이 과정에서 1.2(새 버전 만들기) 과정에서 생성한 압축폴더 내 파일들을 활용해야하니 유의해야합니다.

https://www.pwabuilder.com/

PWABuilder

이 때, Version과 Version code 값을 1.2에서 생성했을 때와 다르게 설정하지 않으면 버전 충돌이 발생합니다.

 

패키지 다운로드 전 All seting > Signing 섹션의 옵션을 Use mine으로 변경 후 Key file에 signing.keystore 파일을 업로드합니다.

signing-key-info 파일을 열어 Key password와 Key store password를 복사 후 PWA builder 사이트에서 붙여넣기합니다.

이후 Download Package 버튼을 눌러 패키지를 다운로드 후 .aab 파일을 업로드합니다.

만약 이 과정에서 버전 문제나 key 문제가 발생한다면 3.3 과정을 성실히 이행하였는지 점검해야합니다.

 

4. 프로덕션 

프로덕션 액세스 권한 신청 이전에 변경사항을 모두 전송 후 검토를 받아야합니다.

아래 과정을 모두 이행한 후 승인 이후에 프로덕션 과정을 이행해야합니다.

 

 

참고자료

https://heegs.tistory.com/157

[Android] 정책 변경 후 구글 플레이스토어 개발자 계정 생성부터 신규 앱 배포까지 과정 정리 - 2주

https://marshallku.com/dev/pwa%EB%A5%BC-%EC%8A%A4%ED%86%A0%EC%96%B4%EC%97%90-%EC%B6%9C%EC%8B%9C%ED%95%98%EA%B8%B0

PWA를 스토어에 출시하기

https://disquiet.io/@chochemong/makerlog/%EB%84%88%EB%AC%B4%EB%82%98-%ED%9E%98%EB%93%A4%EC%97%88%EB%8D%98-%ED%94%8C%EB%A0%88%EC%9D%B4%EC%8A%A4%ED%86%A0%EC%96%B4-%EC%B6%9C%EC%8B%9C-%ED%9B%84%EA%B8%B0-feat-%EB%B9%84%EA%B3%B5%EA%B0%9C-%ED%85%8C%EC%8A%A4%ED%8A%B8

[1인 앱개발] 너무나 힘들었던 플레이스토어 출시 후기 (feat. 비공개 테스트) | Disquiet*