본문으로 건너뛰기
Unveilydocs

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. 앱 만들기

  1. Google Play Console 접속 → 앱 만들기
  2. 앱 이름, 기본 언어, 앱/게임 유형, 유료/무료 선택
  3. 개발자 프로그램 정책·미국 수출법 동의 후 생성

3. 앱 설정(정책 설문) 완료

앱 콘텐츠 섹션에서 아래 필수 항목을 채웁니다. 하나라도 비면 심사 제출이 막힙니다.

  • 개인정보처리방침 — 공개 URL 입력 (준비 방법: 개인정보처리방침 & 데이터 안전성)
  • 앱 액세스 권한 — 로그인이 필요한 앱이면 심사관용 테스트 계정 제공
  • 광고 — 광고 포함 여부
  • 콘텐츠 등급 — 설문에 답하면 자동으로 등급 산정
  • 타겟 연령층 / 어린이 대상 여부
  • 데이터 안전성 — SDK/웹앱이 다루는 데이터 신고 (작성 요령)

심사 노트에 WebView 설명 첨부

Unveily는 WebView 기반이므로, 심사 노트에 "네이티브 기능은 빌드 시 고정" 설명과 config.json을 첨부하면 승인 가능성이 높아집니다. 문구는 앱 심사 팁에서 복사해 사용하세요.

4. 스토어 등록정보 작성

성장 → 스토어 등록정보 → 기본 스토어 등록정보에서:

  • 앱 이름, 짧은 설명, 자세한 설명
  • 앱 아이콘(512×512), 기능 그래픽(1024×500)
  • 폰 스크린샷 2장 이상 (실제 앱 화면)
  • 카테고리, 연락처 정보

5. 내부 테스트로 먼저 올리기 (권장)

곧바로 프로덕션에 올리지 말고 내부 테스트로 검증하세요.

  1. 테스트 → 내부 테스트 → 새 버전 만들기
  2. 릴리즈 AAB 업로드 → 버전 정보 입력
  3. 테스터 탭에서 테스터 Gmail 추가 → 공유된 옵트인 링크로 설치
  4. 실기기에서 라이선스 검증·핵심 기능·권한 동작 확인

인앱결제(Pro)를 사용한다면 내부 테스트 단계에서 라이선스 테스터 설정으로 결제 흐름을 검증하세요 → 인앱결제 설정.

6. 프로덕션 제출

  1. 프로덕션 → 새 버전 만들기 → AAB 업로드(또는 내부 테스트 버전 승격)
  2. 출시 노트 작성
  3. 버전 검토 → 검토를 위해 게시 클릭
  4. Google 심사(보통 수시간~수일) 후 승인되면 스토어에 게시

출시 후

  • config.json을 바꾸면 앱을 다시 빌드·업데이트 제출해야 합니다(재심사). 웹 콘텐츠 변경은 재심사 불필요 → 앱 심사 팁
  • 앱 무결성(Play Integrity) 활성화 확인 → 앱 무결성 검증
  • 다음 버전 배포 시 versionCode를 반드시 올리세요

자주 막히는 지점

증상원인 / 해결
심사 제출 버튼 비활성앱 콘텐츠(정책 설문) 미완료 — 개인정보처리방침·데이터 안전성·콘텐츠 등급 확인
앱 실행 시 바로 종료라이선스 키 파일 누락 또는 서명 해시 불일치 — App Signing 사용 시 Google 재서명 SHA-256으로 재활성화
"웹사이트를 감싸기만 함" 거절네이티브 Bridge 활용을 심사 노트에 명시 → 앱 심사 팁

On this page