Google Play 앱 번들 2026: AAB, 분할, 용량 한도
Android App Bundle(AAB)은 Google Play가 2021년 8월부터 신규 앱에 요구해 온 게시 형식이며, 두 사람이 같은 앱을 설치해도 다운로드 크기가 크게 달라지는 이유이기도 합니다. 이제 Google Play에 완성된 APK를 넘기지 않습니다. 컴파일된 코드와 리소스 전체, 그리고 이를 조립하는 지침을 담은 번들을 넘기면, Google Play가 각 기기에 실제로 설치되는 분할 APK를 생성합니다.
그 한 가지 변경으로 많은 결정이 빌드 스크립트에서 Play로 옮겨갑니다. 어떤 CPU 아키텍처가 어떤 네이티브 라이브러리를 받는지, 어떤 화면 밀도가 어떤 드로어블을 받는지, 어떤 로케일이 어떤 문자열을 받는지가 여기서 정해집니다. 또한 일련의 엄격한 크기 제한이 도입되는데, 그 제한이 바뀌었습니다. 기본 모듈 상한은 더 이상 200MB가 아닙니다. 여전히 예전 수치를 기준으로 계획하는 팀은 전달 전략을 과도하게 설계하거나, 원인을 알 수 없어 보이는 크기 오류로 업로드를 날리게 됩니다.
이 가이드는 2026년 현황을 실제로 마주치는 순서대로 다룹니다. 번들에 포함되는 항목, 현재 크기 제한, 분할 APK가 조립되는 방식, Play 기능 전달과 Play 에셋 전달, 생성된 APK의 버전 코드 규칙, bundletool을 이용한 테스트, 업로드 전에 실행할 점검표입니다.
1. AAB에 실제로 포함되는 것
앱 번들은 APK 대신 업로드하는 .aab 아티팩트입니다. Google의 표현은 정확합니다. 앱의 컴파일된 코드와 리소스를 모두 포함하며, APK 생성과 서명을 Google Play로 미루는 방식입니다. 그 안에는 다음이 들어 있습니다:
- 기본 모듈 — 모든 기기에 필요한 코드, 리소스, 매니페스트입니다. 앱의 버전 코드와 버전 이름이 여기에 포함되는데, 이는 생각보다 중요한 부분입니다.
- 기능 모듈 — 기기나 국가에 따라 설치 시점, 주문형, 또는 조건부로 제공할 수 있는 코드와 리소스입니다.
- 에셋 팩 — 모듈 시스템이 아닌 Play Asset Delivery를 통해 전달되는 대용량 파일(게임 에셋, 미디어, ML 모델).
- 기기 타기팅 메타데이터 — Play가 어떤 요소가 어떤 기기에 속하는지 판단하게 하는 매니페스트 설정으로, ABI, 화면 밀도, 언어, 그리고 에셋 팩을 위한 최신 텍스처 압축 타기팅이 포함됩니다.
번들 자체는 기기에 설치되지 않습니다. 패키지가 아닌 배포 소스입니다.
2. "분할"이 사용자에게 의미하는 것
사용자가 설치를 누르면 Play는 해당 기기 구성에 맞는 APK 세트를 생성하고 서명한 뒤 제공합니다. 대표적인 분할 방식은 다음과 같습니다.
- ABI 분할 — arm64-v8a, armeabi-v7a, x86_64. 최신 스마트폰은 네 개가 아닌 하나의 아키텍처만 다운로드합니다.
- 화면 밀도 분할 — 420dpi 기기가 640dpi 래스터 에셋 비용을 지불하지 않습니다.
- 언어 분할 — 기기가 요청하지 않은 로케일의 문자열은 서버에 남습니다.
- 동적 기능 및 에셋 팩 분할 — 온디맨드 제공으로 표시한 모든 항목.
따라서 Play Console의 '다운로드 크기'는 하나의 숫자가 아니라 구성별로 달라지는 범위이며, 앱 크기 페이지는 기준 기기 수치와 그 범위를 함께 보여줍니다. 로컬에서 빌드한 APK 하나로 릴리스를 판단하는 것이 바로 팀들이 설치 전환율에서 예상 밖의 결과를 맞는 이유입니다.
3. 2026년 크기 제한
Play Console 고객센터에서 확인한 수치이며, 계획을 세울 때 기준으로 삼아야 할 숫자입니다. 오래된 가이드에 아직도 떠도는 200MB라는 수치에서 기본 모듈 상한이 얼마나 멀어졌는지 눈여겨보세요.
- 기본 모듈: 다운로드 크기 500MB 제한.
- 각 개별 기능 모듈: 500MB.
- 각 개별 에셋 팩: 1.5GB.
- 모든 모듈과 설치 시점 애셋 팩의 누적 합계: 4GB.
- 주문형 및 패스트 팔로우 에셋 팩 누적 합계: 30GB.
- 전체 최대 압축 다운로드 크기: 34GB.
그 수치와 함께 네 가지 추가 제약이 따릅니다:
- 1GB를 초과하는 앱은 최소 SDK Android 5.0 롤리팝(API 레벨 21) 이상을 타깃으로 해야 합니다.
- 권장 최대치는 앱이 API 26 이상을 타깃할 때 기능 모듈 100개이며, 더 낮은 버전을 타깃할 때는 상한이 50개입니다.
- 하나의 번들에 포함할 수 있는 에셋 팩의 최대 개수는 100개입니다.
- 앱이 200MB를 넘으면 모바일 데이터 연결 사용자가 설치할 때 용량에 대한 경고 대화상자가 표시됩니다. 설치를 막지는 않지만 전환율은 떨어집니다.
레거시 함정 하나: 일반 APK로 제공되는 앱은 위의 어떤 제한에도 해당하지 않습니다. 이들은 레거시 APK 규칙을 따르며, 상한은 100MB APK입니다. 업로드가 2019년 메시지처럼 보이는 크기 오류로 거부된다면, 업로드한 산출물이 실제로 번들인지 확인하세요.
4. 어떤 메커니즘이 필요한가?
세 가지 방식은 서로 다른 세 가지 문제를 해결하며, 이를 혼동하면 몇 주가 낭비됩니다.
- Play 기능 모듈 — 코드와 리소스 모듈입니다. 모든 기기나 시장에 설치될 필요가 없는 기능을 제공할 때 사용하세요.
- Play Asset Delivery — 대용량 바이너리 에셋. 설치 용량이 중요한 게임 콘텐츠, 비디오, 오디오, ML 모델, 대용량 데이터셋에 사용하세요.
- Play 앱 서명 — 인접한 주제지만 핵심적입니다. AAB를 사용하면 Play가 생성된 APK에 서명하므로 키와 버전 코드 관리 방식이 달라졌습니다.
5. Play Feature Delivery: 설치 시점, 주문형, 조건부
기능 모듈은 매니페스트에서 세 가지 전달 모드 중 하나를 선언합니다:
- 설치 시점 — 모듈이 최초 설치에 포함됩니다. 사용자가 건너뛸 수 없으며, 사용자에게 표시되는 크기에도 포함됩니다.
- 온디맨드 — 앱이 요청하기 전까지 모듈이 설치되지 않습니다. 코드에서 대기, 다운로드 중, 완료, 실패 상태를 처리해야 합니다.
- 조건부 — 기기 기능, 사용자 국가, 최소 SDK 버전 등 직접 선언한 조건을 기기가 충족하는 경우에만 설치 시점에 모듈이 설치됩니다.
조건부 배포는 팀이 가장 덜 활용하는 기능입니다. 태블릿 전용 기능 모듈이나 특정 결제 사업자가 운영되는 곳에서만 의미 있는 모듈은 모든 기기에 탑재할 필요가 없습니다.
6. Play Asset Delivery: 설치 시점, 빠른 후속, 온디맨드
- 설치 시점 팩은 앱과 함께 도착합니다. 앱의 설치 크기에 포함되며, 4GB 누적 한도에도 포함됩니다. 편리하지만 여전히 사용자가 스토어 등록정보에서 보는 숫자의 일부입니다.
- 패스트팔로우 팩은 설치가 끝나는 즉시 백그라운드에서 자동으로 다운로드를 시작합니다. 사용자는 곧바로 앱을 열 수 있고, 소재는 잠시 뒤에 도착합니다.
- 온디맨드 팩은 앱이 요청할 때만 다운로드됩니다. 큰 용량은 여기에 있습니다. 온디맨드 및 패스트팔로우 팩의 누적 허용량이 30GB인 이유는 바로 설치 전환율과 경쟁하지 않기 때문입니다.
에셋 팩은 텍스처 압축 타깃팅도 지원하므로, 모든 포맷을 묶어 배포하는 대신 기기 GPU가 실제로 지원하는 압축 포맷을 Play가 전달할 수 있습니다. 게임에서는 보통 이용 가능한 가장 큰 용량 절감 효과입니다.
7. Play에서 APK를 생성할 때의 버전 코드
번들을 사용하면 APK마다 버전 코드를 관리할 필요가 없습니다. 기본 모듈에서 버전 코드를 하나만 설정하면, 업로드 후 Google Play가 해당 번들에서 생성하는 모든 APK에 같은 버전 코드를 부여합니다. 한 번의 설치를 구성하는 모든 분할 APK는 버전 코드를 공유합니다.
그 결과는 복잡함이 아니라 규율입니다. 업데이트를 출시하려면 기본 모듈의 버전 코드를 올리고 새 전체 번들을 빌드해야 합니다. 사용자가 업데이트하면 Play는 해당 기기에 현재 설치된 모든 APK의 업데이트된 버전을 제공합니다. 여기서 두 가지 실무 원칙이 나옵니다.
- 기존의 ABI별 버전 코드 방식(
abiCodes * 1000 + versionCode트릭)은 유지하지 마세요. 레거시 APK 분할 패턴이며 번들 업로드와 충돌합니다. - 빌드 시스템이 트랙 간 버전 코드를 뒤섞으면 "version code already used" 또는 "lower than the existing version" 오류로 업로드가 실패합니다. 기본 모듈이 유일한 기준입니다.
8. 서명: 앱 서명 키가 아닌 업로드 키
Play 앱 서명을 사용하면 업로드하는 아티팩트는 업로드 키로 서명되고, Play가 생성된 APK를 앱 서명 키로 다시 서명합니다. 서명 구성은 기본 모듈에만 있어야 합니다. 흔히 사람들을 놓치게 하는 두 가지가 있습니다:
- 업로드 키를 분실한 경우 Play Console을 통해 재설정할 수 있습니다. 복구 가능합니다. 앱 서명 키는 직접 다룰 필요가 전혀 없습니다.
- 번들이 잘못된 키로 서명되면 Play는 심사가 시작되기도 전에 업로드를 거부합니다. 이는 한 줄만 고치면 되는 빌드 설정 문제이지 정책 문제가 아닙니다.
9. 출시 전 bundletool로 분할 APK 테스트하기
Android Gradle 플러그인이 번들을 빌드하고, bundletool은 이를 다시 기기별 APK로 변환하고 Play의 배포 방식을 로컬에서 재현할 때 사용합니다. Play도 APK 생성에 같은 도구를 사용하므로 로컬 동작이 프로덕션과 거의 일치합니다.
# 지원되는 모든 기기 구성을 포괄하는 APK 세트 빌드 bundletool build-apks \ --bundle=app-release.aab \ --output=app.apks \ --ks=upload-key.jks --ks-key-alias=upload # 연결된 기기와 일치하는 분할 APK만 배포 bundletool install-apks --apks=app.apks # 빠른 정상 작동 확인을 위한 유니버설 APK 생성 bundletool build-apks --bundle=app-release.aab --output=app.apks --mode=universal # 온디맨드 모듈 및 애셋 팩의 로컬 테스트 활성화 bundletool build-apks --bundle=app-release.aab --output=app.apks --local-testing
--local-testing 플래그는 APK 매니페스트에 메타데이터를 기록해 Play Core 라이브러리가 Play에 연결하지 않고 로컬 분할을 사용하도록 지시합니다. 이 플래그가 없으면 주문형 다운로드 코드를 스토어 외부에서 실행할 수 없습니다. 기기별 사양이 필요하면 bundletool get-device-spec을 사용하세요.
프로덕션 배포 전에 내부 테스트 트랙은 실제 설치가 올바른 분할을 제대로 해석하는지 확인하는 가장 저렴한 방법입니다. 크래시 분석에서 신경 쓰는 저사양 기기에서도 마찬가지입니다.
10. 최적화하기 전에 앱 크기 페이지를 먼저 읽으세요
앱에 프로덕션 릴리스가 있으면 Play Console은 모니터링 및 개선, Android vitals, 앱 크기 순으로 다운로드 크기를 보고합니다. 기준 기기에서의 앱 다운로드 크기와 구성별 범위, 직접 정의한 그룹의 동종 비교, 시간에 따른 추세, 그리고 크기 수치 자체보다 더 가치 있는 두 가지 지표를 보여줍니다.
- 여유 공간이 2GB 미만인 활성 기기 — 설치 기반 중 저장 공간 압박을 받는 비율
- 여유 공간이 2GB 미만인 기기에서의 삭제 — 해당 기기의 삭제 수 대비 전체 삭제 수 비율입니다. 이 값이 높다면 리텐션 문제로 보이지만 실제로는 용량 문제입니다.
11. 업로드 전 점검표
- 산출물은 범용 APK가 아니라
.aab입니다. - 기본 모듈 버전 코드는 정확히 한 곳에서만 증가합니다.
- 업로드 키는 기본 모듈에만 구성하고, 키스토어는 노트북 한 대가 아닌 다른 곳에 백업하세요.
- 기본 모듈의 압축 다운로드 크기는 500MB 이내여야 하며, 설치 시 모바일 데이터 경고를 피하려면 200MB 미만이어야 합니다.
- 각 기능 모듈은 500MB 미만이며, 모든 모듈과 설치 시 팩을 합쳐도 누적 한도 4GB 미만입니다.
- 각 에셋 팩은 1.5GB 미만이며, 온디맨드 및 패스트 팔로우 팩은 30GB 미만으로 유지됩니다.
- 에셋 팩은 최대 100개이며, 최소 SDK에 대한 100개 또는 50개 기능 모듈 지침을 준수해야 합니다.
- 앱이 1GB를 초과하는 경우 최소 SDK는 API 21 이상입니다.
- 주문형 기능은 Play Core 라이브러리로 구현하며, 대기, 다운로드 중, 실패 상태를 명시적으로 처리합니다.
- 둘 이상의 GPU 포맷이 사용되는 에셋 팩에서는 텍스처 압축 타깃팅이 활성화됩니다.
- 번들은 최소 한 대의 저사양 기기와 한 대의 arm64 기기에서
bundletool install-apks로 테스트되었으며, 모든 온디맨드 경로에 대해--local-testing도 함께 테스트되었습니다. - 앱 크기 페이지는 릴리스가 출시된 후에 검토되며, 2GB 미만 무료 지표도 포함됩니다.
- 데이터 보안 양식과 콘텐츠 신고 내용이 새 모듈이 실제로 수집하는 데이터와 여전히 일치하는지.
- 스토어 등록정보 텍스트와 스크린샷은 여전히 사용자가 지금 내려받는 앱을 설명하고 있지, 테스트에 사용한 유니버설 빌드를 설명하는 것이 아닙니다.
12. 출시 후에만 나타나는 실패
- 주문형 모듈이 다운로드되지 않는 경우는 Play Core 연동이 성공을 전제로 하고 실패하거나 취소된 요청에 대한 재시도 경로가 없기 때문입니다.
- 설치 시점 애셋 팩은 콘텐츠 배포 후 등록정보 용량을 크게 늘리고, 코드를 전혀 바꾸지 않았는데도 설치 전환율이 떨어집니다.
- 조건부 모듈이 조건을 충족하지 않는 기기에 설치되는 경우 — 잘못된 매니페스트에 선언되었기 때문입니다.
- 빌드 파일에 레거시 ABI별 방식이 여전히 활성화된 상태에서 CI가 번들에 버전을 찍을 때 발생하는 버전 코드 충돌.
- 키스토어 교체 후 기본 모듈 구성에 반영되지 않아 발생하는 잘못된 키 서명.
- 느린 연결에서의 최초 실행 실패 — 앱의 첫 화면이 아직 도착하지 않은 후속 팩에 의존하는 경우
- 데이터 보안 불일치 — 새 SDK가 아무도 다시 신고하지 않은 새로 분리된 모듈에 포함된 경우.
13. KappS의 위치
앱 크기와 전달 방식은 개발자 계정, 결제 프로필, 세금 정보와 같은 운영 흐름에 속합니다. 이 중 하나만 늦어져도 출시가 조용히 막힐 수 있습니다. KappS는 개발자가 이 흐름 전반에서 컴플라이언스 요건을 갖춘 자료를 준비하고 제출하도록 돕습니다. 번들과 전달 구성 검토도 포함되는데, 설치 시점 팩과 패스트 팔로우 팩의 차이는 메가바이트가 아니라 설치 전환율로 판가름 납니다.
저희가 하지 않는 일은 스토어를 우회하는 것입니다. 용량 제한, 배포 선언, 데이터 보안 답변은 실제로 출시한 산출물과 대조해 Google가 검증합니다. 번들이 하지 않는 일을 등록정보에서 약속하는 것은 출시 거절이나 계정 정지로 이어지는 지름길이며, 저희가 제공하는 서비스가 아닙니다. 요령은 앞서 설명한 단 하나입니다. 번들을 정직하게 만들고, 실제로 담긴 내용을 선언하고, 제한을 준수하는 것입니다.
출처(Google 공식 문서): Android 앱 번들 소개(developer.android.com/guide/app-bundle), Play Console 도움말 — 앱 크기 최적화 및 Google Play 앱 크기 제한 준수(support.google.com/googleplay/android-developer/answer/9859372), 기본 모듈 구성, Play Asset Delivery, Play Feature Delivery, bundletool(developer.android.com/tools/bundletool).
개발자 계정을 대규모로 운영하시나요? 운영 업무를 저희가 처리합니다.
메시지를 접수했습니다. 24시간 이내에 답변드리겠습니다.
← 수정으로 돌아가기