분할 APK와 Android App Bundle, 사용자를 위한 설명

APK 하나에서 여럿으로

예전에는 앱이 모든 화면 크기, 언어, CPU를 위한 코드와 리소스를 담은 하나의 APK였습니다. 2021년 8월부터 Google Play는 새 앱을 Android App Bundle(.aab)로 올리도록 요구합니다. Play는 번들을 보관하고, 내려받을 때마다 그 기기에서 앱을 구성하는 APK 묶음을 생성합니다.

구성 요소

• base.apk: 모든 기기에 공통인 코드와 리소스. 그렇게 만들어진 앱에서만 단독 설치가 가능하며, 최신 앱 대부분은 그렇지 않습니다.
• 구성 분할: split_config.arm64_v8a.apk(CPU용 네이티브 코드), split_config.xxhdpi.apk(화면 밀도용 이미지), split_config.en.apk, split_config.ko.apk(언어 문자열). 기기는 종류별로 하나씩 받습니다.
• 기능 분할: 편집기나 카메라 기능처럼 앱이 필요할 때 내려받는 선택 모듈.

한 앱의 모든 분할은 패키지 이름, 버전 코드, 서명을 공유합니다. Android는 이를 한 세션에서 설치하고 하나의 앱으로 취급합니다.

base.apk만 설치하면 실패하는 이유

앱이 시작한 뒤 분할 안에 있는 리소스나 네이티브 라이브러리를 찾다가 Resources$NotFoundException 또는 UnsatisfiedLinkError로 죽거나, 설치 프로그램이 INSTALL_FAILED_MISSING_SPLIT으로 거부합니다. XAPK를 통째로 설치해야 하는 이유입니다. SAI로 분할 APK 설치하기를 보세요.

미러는 번들을 어떻게 다루나

Play가 기기별 묶음을 생성하므로, 미러는 유니버설 APK(개발자의 단일 파일 빌드로 모든 구성을 포함해 크지만 어디서나 설치됨)나, 기본과 가장 흔한 구성(arm64, xxhdpi, 여러 언어)의 분할을 담은 XAPK를 보관합니다. 이 사이트의 버전 페이지는 파일마다 형식을 표시하므로, 특이한 기기에는 유니버설 APK를, 최신 폰에는 XAPK를 고를 수 있습니다.

기기에 무엇이 있는지 확인

App Manager나 SAI는 설치된 앱의 상세에서 분할을 나열합니다. adb shell pm path <패키지>는 앱의 모든 APK 파일을 한 줄에 하나씩 출력합니다. 한 줄만 나오는 앱은 유니버설 또는 단일 파일 패키지로 설치된 것입니다.