App Store / Google Play · 清单验收 · 不承诺过审Telegram @hagee66

上架通

GOEE LISTING LEDGER

№ KOgoee.cc
账号归你 · 邀请协作


2026-03-01

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 또는 내부 트랙 링크.

업로드 전 필수 확인

  1. versionCode 는 모든 Play 트랙(내부 포함)의 최댓값보다 엄격히 커야 함. iOS 버전 관리 와 맞춰 같은 날 배포 혼란을 막기.
  2. 서명은 올바른 업로드 키; Console에서 Play App Signing 확인. 서명 인수인계.
  3. targetSdk / 권한 변경—번들만이 아니라 Data Safety·스토어 문구도 동기화.
  4. 트랙 선택: 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:
영어 오류 전문:
제외됨: 네트워크 / 브라우저 / 계정 권한
다음 조치:
담당:

흔한 실수

  1. 디버그 서명 AAB 업로드. 릴리스 트랙은 릴리스 서명 필요.
  2. versionName만 바꾸고 code는 안 올림. Play는 “새 버전 느낌”이 아니라 code를 봄.
  3. 손 APK 크기 = 사용자 DL 크기라고 가정. Play 빌드의 실제 설치 크기를 볼 것.
  4. 업로드 성공 → 내부 스모크 없이 프로덕션. 릴리스 트랙 가이드 참고.
  5. 언어를 잘랐는데 스토어는 그 국가를 타깃. 설치 후 UI 깨짐.
  6. Console 프리런치 힌트 무시. 프리런치 리포트 와 함께.
  7. iOS·Android 같은 날 같은 릴리스 노트인데 버전 번호 불일치. 플랫폼별 code/build 분리.

FAQ

테스트도 반드시 AAB인가?
내부 트랙은 보통 AAB; 로컬은 APK 가능. 현재 업로드 UI를 따르세요.

업로드 후 언제 설치되나?
처리에 시간이 걸림; 국가·트랙마다 다름. “처리 완료” 시각을 남기고 즉시라고 가정하지 마세요.

용량 한도를 넘으면?
상한·확장 배포는 공식 문서. 먼저 용량 리뷰와 모듈 분할—검사를 피하려 하지 마세요.

APK와 AAB를 같이 쓸 수 있나?
정책은 현행 Google; 신규는 AAB 우선. 오래된 “둘 다 올리기” 블로그에 기대지 마세요.

실패한 업로드가 심사 횟수에 영향?
실패는 보통 사용자 노출 버전을 소비하지 않음; 나쁜 패키지 반복은 정책 주의 대상이 될 수 있음. 고친 뒤 재업로드.

Hermes / 16KB 페이지 크기 등 새 요구?
공식 공지와 Console 안내를 따르세요—이 글은 컴플라이언스 속보가 아닙니다.

다음 단계

  1. 다음 릴리스 전 AAB 업로드 로그를 채우고 Play 릴리스 트랙 체크리스트와 맞추기.
  2. 서명 인수인계 와 versionCode 규칙.
  3. Google Play 제출 자료 의 번들·권한 항목.
  4. 큰 릴리스: 용량 리뷰 + SDK 목록.
  5. 양 플랫폼: iOS version과 build.

관련 가이드

가이드 목록 · Google 제출 · Telegram @hagee66