AAB 업로드와 용량: Play 제출에서 자주 보는 문제
AAB와 APK 차이, 업로드 실패 점검 순서, 용량·기능 모듈 주의점. 개발과 제출이 같은 용어를 쓰도록. Telegram @hagee66.
이 글 · 가이드 목록 · Apple 제출 · Google 제출 · 양 스토어 · Telegram @hagee66
Google Play의 신규 앱·업데이트 배포는 Android App Bundle(AAB) 가 중심입니다. 팀에서 흔한 마찰은 개발이 APK 사이드로드에 익숙한 반면 운영이 Console 업로드 입구를 못 찾는 경우, 또는 AAB 업로드 실패를 “용량 초과”로 오해하고 실제로는 서명·versionCode 문제인 경우입니다. 이 글은 AAB와 APK 차이, 실패 점검 순서, 용량·기능 모듈 주의점을 개발과 제출이 같은 말로 맞추도록 정리하고, Play 릴리스 트랙 과 제출 자료 로 이어갑니다. 형식·상한·기기별 APK 생성 규칙은 바뀝니다—공식 최신 문서를 따르세요. 업로드 성공이 심사 통과를 보장하지 않습니다. 등타 goee.cc 협업은 Telegram @hagee66.
이 가이드가 푸는 문제
- Console은 AAB를 요구하는데 로컬 테스트는 왜 아직 APK를 쓰는지.
- 업로드 오류(
versionCode증가 필수, 서명 무효, Play App Signing 미확인 등)를 네트워크 문제로 오해하고 반복 업로드하는 것. - 용량 팽창: 비압축 에셋, 중복 ABI, 디버그 심볼, 미분할 리소스로 다운로드 경험·리뷰 악화.
- Dynamic Feature / Asset Delivery를 켰는데 스토어 문구에 “일부는 나중에 다운로드”를 안 적어 기대와 어긋나는 것.
- iOS 빌드 번호 감각과 섞여 Android
versionCode를 올리지 않아 업로드가 막히는 것.
누가 읽으면 좋은지
| 역할 | 용도 |
|---|---|
| Android 엔지니어 | 릴리스 번들, 서명과 versionCode |
| 제출 담당 | 올바른 트랙 업로드, 영어 오류 읽기 |
| 프로덕트 | 선택 모듈, “첫 다운로드 크기”를 솔직히 안내 |
| QA | “Play에서 설치” vs adb install APK 차이 |
업로드 전 자료·선언: 프리체크 점수표; 키: 서명·인증서 인수인계.
실무 요점
AAB vs APK: 어디에 쓰나
| 관점 | AAB | APK |
|---|---|---|
| Play 제출 | 표준 흐름 | 신규·업데이트는 보통 AAB(예외는 공식 문서) |
| 로컬 디버그 / CI 스모크 | 직접 설치는 드묾 | adb install 가능 |
| 사용자가 받는 것 | 기기 최적화 APK / 분할 | 유니버설 APK는 더 큰 경우가 많음 |
| 용량 체감 | 번들 크기 ≠ 사용자 다운로드 크기 | 손에 든 단일 APK 크기가 보임 |
팀 약속: Play 제출은 서명된 릴리스 AAB; 테스터 스모크는 APK 또는 내부 트랙 링크.
업로드 전 필수 확인
versionCode는 모든 Play 트랙(내부 포함)의 최댓값보다 엄격히 커야 함. iOS 버전 관리 와 맞춰 같은 날 배포 혼란을 막기.- 서명은 올바른 업로드 키; Console에서 Play App Signing 확인. 서명 인수인계.
targetSdk/ 권한 변경—번들만이 아니라 Data Safety·스토어 문구도 동기화.- 트랙 선택: internal / closed 등. Play 릴리스 트랙.
업로드 실패: 이 순서로 점검
1. versionCode 미증가 → 올리고 다시 빌드
2. 서명 / 업로드 키 불일치 → keystore / Play 상태 확인
3. 패키지명 ≠ Console 앱 → applicationId 확인
4. 필수 메타데이터 미완 → 등급·정책 등 Console 안내 먼저
5. 전송 / 브라우저 → 네트워크 변경, 공식 업로드 수단이 있으면 그것
6. 금지 구성요소·정책 충돌 → 선언과 번들 일치, 순수 기술 문제만이 아님
오류 전문을 릴리스 로그에 붙이세요—“Upload failed” 스크린샷만으로 끝내지 마세요.
용량: 엔지니어링 레버
- 에셋: 거대한 PNG보다 WebP/벡터; 밀도별, 만능 거대 이미지 지양.
- ABI: 번들 분할—모든
.so를 한 APK에 넣는 사고 버리기(Gradle/AGP). - 언어:
resConfigs로 배포 언어 제한, 스토어 로컬라이즈와 맞춤. - 디버그: 릴리스에서 디버그 플래그 끄고 미사용 리소스 제거(R8/Proguard 검증).
- SDK: 광고·분석·지도는 용량과 권한 모두—SDK 공개 체크리스트 와 동기화.
“200MB 다운로드” 불만은 첫 설치+에셋 모듈 합일 수 있음. 스토어에 “일부는 첫 사용 시 추가 다운로드”를 솔직히(실제 동작과 일치 필수).
기능 모듈과 Play Asset Delivery
동적 기능·대용량 에셋 배포를 쓰면:
- 테스트 트랙에서 첫 실행/첫 레벨이 추가 다운로드가 필요한지 검증.
- 약한 네트워크·저용량 저장소에 명확한 UI. 조용히 크래시하지 않기.
- Console·스토어가 “완전 오프라인”을 약속하지 않기(핵심 자산이 온라인 수신이면).
세부사항은 최신 Google Play 문서—이 가이드는 모듈 종류를 전부 나열하지 않습니다.
제출 쪽이 원하는 숫자
엔지니어에게 네 가지: versionName, versionCode, 번들 파일 크기, 이전 대비 한 줄 델타. 릴리스 노트를 템플릿화해 “올렸는데 어느 버전?”을 막기.
복붙 템플릿
AAB 업로드 로그
[AAB 업로드 로그]
앱:
패키지명:
대상 트랙: internal / closed / open / production
versionName:
versionCode(기존 어떤 값보다 큼):
AAB SHA256(선택):
업로드 키 소유자:
이전 대비 변경:
새 권한 / SDK: Y / N; Data Safety 재확인: Y / N
업로더:
시각:
Console 결과: 처리 중 / 트랙 반영 / 실패(전문)
테스트 설치 담당:
용량 리뷰(큰 릴리스)
[용량 리뷰]
버전:
번들 크기:
이전 대비: + / - MB
주요 델타:
신규 SDK:
사용자용 추가 DL 안내(스토어 / 앱 내):
다음 주 개선 1가지:
실패 기록
[업로드 실패]
시각:
versionCode:
영어 오류 전문:
제외됨: 네트워크 / 브라우저 / 계정 권한
다음 조치:
담당:
흔한 실수
- 디버그 서명 AAB 업로드. 릴리스 트랙은 릴리스 서명 필요.
versionName만 바꾸고 code는 안 올림. Play는 “새 버전 느낌”이 아니라 code를 봄.- 손 APK 크기 = 사용자 DL 크기라고 가정. Play 빌드의 실제 설치 크기를 볼 것.
- 업로드 성공 → 내부 스모크 없이 프로덕션. 릴리스 트랙 가이드 참고.
- 언어를 잘랐는데 스토어는 그 국가를 타깃. 설치 후 UI 깨짐.
- Console 프리런치 힌트 무시. 프리런치 리포트 와 함께.
- iOS·Android 같은 날 같은 릴리스 노트인데 버전 번호 불일치. 플랫폼별 code/build 분리.
FAQ
테스트도 반드시 AAB인가?
내부 트랙은 보통 AAB; 로컬은 APK 가능. 현재 업로드 UI를 따르세요.
업로드 후 언제 설치되나?
처리에 시간이 걸림; 국가·트랙마다 다름. “처리 완료” 시각을 남기고 즉시라고 가정하지 마세요.
용량 한도를 넘으면?
상한·확장 배포는 공식 문서. 먼저 용량 리뷰와 모듈 분할—검사를 피하려 하지 마세요.
APK와 AAB를 같이 쓸 수 있나?
정책은 현행 Google; 신규는 AAB 우선. 오래된 “둘 다 올리기” 블로그에 기대지 마세요.
실패한 업로드가 심사 횟수에 영향?
실패는 보통 사용자 노출 버전을 소비하지 않음; 나쁜 패키지 반복은 정책 주의 대상이 될 수 있음. 고친 뒤 재업로드.
Hermes / 16KB 페이지 크기 등 새 요구?
공식 공지와 Console 안내를 따르세요—이 글은 컴플라이언스 속보가 아닙니다.
다음 단계
- 다음 릴리스 전 AAB 업로드 로그를 채우고 Play 릴리스 트랙 체크리스트와 맞추기.
- 서명 인수인계 와
versionCode규칙. - Google Play 제출 자료 의 번들·권한 항목.
- 큰 릴리스: 용량 리뷰 + SDK 목록.
- 양 플랫폼: iOS version과 build.