Google Play 제출
AAB 빌드부터 내부 테스트, 프로덕션 심사 제출까지 단계별로 안내합니다.
빌드된 릴리즈 AAB를 Google Play에 올려 실제 출시하는 전 과정입니다. 먼저 출시 전 준비물과 운영 배포 체크리스트를 완료했다고 가정합니다.
Play Console UI는 수시로 바뀝니다. 메뉴 이름이 조금 달라도 흐름(앱 생성 → 등록정보 → 정책 설문 → 트랙 업로드 → 심사) 은 동일합니다.
1. 릴리즈 AAB 빌드
Google Play는 AAB(App Bundle) 형식을 권장합니다.
# 플랜에 맞는 릴리즈 AAB 생성
./gradlew :app:bundleBasicRelease
./gradlew :app:bundleStandardRelease
./gradlew :app:bundleProRelease릴리즈 서명이 설정되어 있어야 합니다. Google Play App Signing을 쓰면 Google이 재서명하므로, 운영 라이선스는 Google 재서명 인증서의 SHA-256으로 활성화해야 합니다. 자세한 내용은 운영 배포 체크리스트를 참고하세요.
2. 앱 만들기
- Google Play Console 접속 → 앱 만들기
- 앱 이름, 기본 언어, 앱/게임 유형, 유료/무료 선택
- 개발자 프로그램 정책·미국 수출법 동의 후 생성
3. 앱 설정(정책 설문) 완료
앱 콘텐츠 섹션에서 아래 필수 항목을 채웁니다. 하나라도 비면 심사 제출이 막힙니다.
- 개인정보처리방침 — 공개 URL 입력 (준비 방법: 개인정보처리방침 & 데이터 안전성)
- 앱 액세스 권한 — 로그인이 필요한 앱이면 심사관용 테스트 계정 제공
- 광고 — 광고 포함 여부
- 콘텐츠 등급 — 설문에 답하면 자동으로 등급 산정
- 타겟 연령층 / 어린이 대상 여부
- 데이터 안전성 — SDK/웹앱이 다루는 데이터 신고 (작성 요령)
심사 노트에 WebView 설명 첨부
Unveily는 WebView 기반이므로, 심사 노트에 "네이티브 기능은 빌드 시 고정" 설명과 config.json을 첨부하면 승인 가능성이 높아집니다. 문구는 앱 심사 팁에서 복사해 사용하세요.
4. 스토어 등록정보 작성
성장 → 스토어 등록정보 → 기본 스토어 등록정보에서:
- 앱 이름, 짧은 설명, 자세한 설명
- 앱 아이콘(512×512), 기능 그래픽(1024×500)
- 폰 스크린샷 2장 이상 (실제 앱 화면)
- 카테고리, 연락처 정보
5. 내부 테스트로 먼저 올리기 (권장)
곧바로 프로덕션에 올리지 말고 내부 테스트로 검증하세요.
- 테스트 → 내부 테스트 → 새 버전 만들기
- 릴리즈 AAB 업로드 → 버전 정보 입력
- 테스터 탭에서 테스터 Gmail 추가 → 공유된 옵트인 링크로 설치
- 실기기에서 라이선스 검증·핵심 기능·권한 동작 확인
인앱결제(Pro)를 사용한다면 내부 테스트 단계에서 라이선스 테스터 설정으로 결제 흐름을 검증하세요 → 인앱결제 설정.
6. 프로덕션 제출
- 프로덕션 → 새 버전 만들기 → AAB 업로드(또는 내부 테스트 버전 승격)
- 출시 노트 작성
- 버전 검토 → 검토를 위해 게시 클릭
- Google 심사(보통 수시간~수일) 후 승인되면 스토어에 게시
출시 후
- config.json을 바꾸면 앱을 다시 빌드·업데이트 제출해야 합니다(재심사). 웹 콘텐츠 변경은 재심사 불필요 → 앱 심사 팁
- 앱 무결성(Play Integrity) 활성화 확인 → 앱 무결성 검증
- 다음 버전 배포 시
versionCode를 반드시 올리세요
자주 막히는 지점
| 증상 | 원인 / 해결 |
|---|---|
| 심사 제출 버튼 비활성 | 앱 콘텐츠(정책 설문) 미완료 — 개인정보처리방침·데이터 안전성·콘텐츠 등급 확인 |
| 앱 실행 시 바로 종료 | 라이선스 키 파일 누락 또는 서명 해시 불일치 — App Signing 사용 시 Google 재서명 SHA-256으로 재활성화 |
| "웹사이트를 감싸기만 함" 거절 | 네이티브 Bridge 활용을 심사 노트에 명시 → 앱 심사 팁 |