bundletool

bundletool은 Android 스튜디오, Android Gradle 플러그인, Google Play에서 Android App Bundle을 빌드하는 데 사용하는 기본 도구입니다. bundletool은 App Bundle을 기기에 배포되는 다양한 APK로 변환할 수 있습니다.

Android SDK 번들(ASB)과 관련 APK는 bundletool로 빌드됩니다. 명령줄 도구로도 사용할 수 있으므로 App Bundle과 SDK 번들을 직접 빌드하고 앱 APK 또는 런타임 지원 SDK APK의 Google Play 서버 측 빌드를 다시 만들 수 있습니다.

bundletool 다운로드

아직 다운로드하지 않았다면 GitHub 저장소에서 bundletool을 다운로드하세요.

App Bundle 빌드 및 테스트

Android 스튜디오 또는 bundletool 명령줄 도구를 사용하여 Android App Bundle을 빌드하고 이 App Bundle에서의 APK 생성을 테스트할 수 있습니다.

App Bundle 빌드

Android 스튜디오와 Android Gradle 플러그인을 사용하여 Android App Bundle을 빌드하고 서명합니다. 그러나 IDE를 사용할 수 없다면(예: 연속 빌드 서버를 사용하는 경우) 명령줄에서 App Bundle을 빌드하고 jarsigner를 사용하여 App Bundle에 서명할 수도 있습니다.

bundletool로 App Bundle을 빌드하는 방법에 관한 자세한 내용은 bundletool을 사용하여 App Bundle 빌드를 참고하세요.

App Bundle에서 APK 집합 생성

Android App Bundle을 빌드한 후에는 Google Play에서 어떻게 Android App Bundle을 사용하여 APK를 생성하는지, APK가 기기에 배포되었을 때 어떻게 작동하는지 테스트합니다.

다음 두 가지 방법으로 App Bundle을 테스트할 수 있습니다.

• bundletool 명령줄 도구를 로컬에서 사용합니다.
• 테스트 트랙을 사용하여 Google Play를 통해 번들을 Play Console에 업로드합니다.

이 섹션에서는 bundletool을 사용하여 App Bundle을 로컬에서 테스트하는 방법을 설명합니다.

bundletool이 App Bundle에서 APK를 생성하면 생성된 APK는 .apks 파일 확장자를 사용하는 APK 집합 자료실이라는 컨테이너에 포함됩니다. App Bundle에서 앱이 지원하는 모든 기기 설정의 APK 집합을 생성하려면 아래와 같이 bundletool build-apks 명령어를 사용하세요.

bundletool build-apks --bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

APK를 기기에 배포하려면 다음 명령어와 같이 앱의 서명 정보도 포함해야 합니다. 서명 정보를 지정하지 않으면 bundletool이 디버그 키로 APK에 서명을 시도합니다.

bundletool build-apks --bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks
--ks=/MyApp/keystore.jks
--ks-pass=file:/MyApp/keystore.pwd
--ks-key-alias=MyKeyAlias
--key-pass=file:/MyApp/key.pwd

다음 표에서는 bundletool build-apks 명령어를 사용할 때 설정할 수 있는 다양한 플래그와 옵션을 자세히 설명합니다.

표 1. bundletool build-apks 명령어 옵션

연결된 기기에 APK 배포

APK 집합이 생성되면 bundletool은 이 집합의 올바른 APK 조합을 연결된 기기로 배포할 수 있습니다.

예를 들어, Android 5.0(API 수준 21) 이상을 실행하는 연결된 기기가 있다면 bundletool은 기기에서 앱을 실행하는 데 필요한 기본 APK, 기능 모듈 APK, 구성 APK를 푸시합니다. 또는 연결된 기기가 Android 4.4(API 수준 20) 이하를 실행한다면 bundletool은 호환되는 다중 APK를 검색하여 기기에 배포합니다.

APK 집합에서 앱을 배포하려면 install-apks 명령어를 사용하고 다음 명령어와 같이 --apks=/path/to/apks 플래그를 사용하여 APK 집합의 경로를 지정합니다. 여러 기기가 연결되어 있다면 --device-id=serial-id 플래그를 추가하여 대상 기기를 지정합니다.

bundletool install-apks --apks=/MyApp/my_app.apks

기기별 APK 집합 생성

앱에서 지원하는 모든 기기 설정의 APK 집합을 빌드하지 않으려면 다음 명령어와 같이 --connected-device 옵션을 사용하여 연결된 기기의 구성만 타겟팅하는 APK를 빌드하면 됩니다. 여러 기기가 연결되어 있다면 --device-id=serial-id 플래그를 포함하여 대상 기기를 지정합니다.

bundletool build-apks --connected-device
--bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

기기 사양 JSON 파일 생성 및 사용

bundletool은 JSON 파일로 지정된 기기 설정을 타겟팅하는 APK 집합을 생성할 수 있습니다. 연결된 기기의 JSON 파일을 먼저 생성하려면 다음 명령어를 실행합니다.

bundletool get-device-spec --output=/tmp/device-spec.json

bundletool은 도구 디렉터리에 기기의 JSON 파일을 만듭니다. 그러면 이 파일을 bundletool에 전달하여 다음과 같이 JSON 파일에 설명된 구성만을 타겟팅하는 APK 집합을 생성할 수 있습니다.

bundletool build-apks --device-spec=/MyApp/pixel2.json
--bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

기기 사양 JSON을 수동으로 생성

타겟 APK 집합을 빌드하려는 기기에 액세스할 수 없는 경우(예: 갖고 있지 않은 기기에서 앱을 사용해 보려는 경우) 다음 형식을 사용하여 수동으로 JSON 파일을 만들 수 있습니다.

{
  "supportedAbis": ["arm64-v8a", "armeabi-v7a"],
  "supportedLocales": ["en", "fr"],
  "screenDensity": 640,
  "sdkVersion": 27
}

그런 다음 이전 섹션에서 설명한 대로 이 JSON을 bundle extract-apks 명령어에 전달할 수 있습니다.

기존 APK 집합에서 기기별 APK 추출

기존 APK 집합이 있고 여기서 특정 기기 설정을 타겟팅하는 APK 하위 집합을 추출하려면 extract-apks 명령어를 사용하여 다음과 같이 기기 사양 JSON을 지정하면 됩니다.

bundletool extract-apks
--apks=/MyApp/my_existing_APK_set.apks
--output-dir=/MyApp/my_pixel2_APK_set.apks
--device-spec=/MyApp/bundletool/pixel2.json

APK 집합에서 APK의 예상 다운로드 크기 측정

유선으로 압축되어 제공되는 APK 집합에서 APK의 예상 다운로드 크기를 측정하려면 get-size total 명령어를 사용합니다.

bundletool get-size total --apks=/MyApp/my_app.apks

다음 플래그를 사용하여 get-size total 명령어의 동작을 수정할 수 있습니다.

표 2. get-size total 명령어 옵션

추가 리소스

bundletool 사용에 관한 자세한 내용은 App Bundle: bundletool 및 Play Console을 사용하여 번들 테스트를 참고하세요.