Bundletool 활용, AAB 파일을 단일 APK로 빠르게 변환하는 실무 가이드

Context

Google Play의 AAB 배포 정책으로 인한 개별 기기 최적화 APK 생성 구조. 물리 기기 테스트 및 QA 팀 공유를 위한 단일 APK 파일의 필요성 대두. Play Store 외부 설치를 위한 범용 설치 파일 확보의 한계.

Technical Solution

• Google 공식 도구인 Bundletool의 jar 파일을 활용한 CLI 기반 변환 방식
• build-apks 명령과 --mode=universal 옵션을 조합한 모든 기기 대응 범용 APK 생성 전략
• .apks 아카이브 파일을 .zip으로 변경 후 내부의 universal.apk를 추출하는 파일 시스템 구조 활용
• --ks, --ks-key-alias 등 키스토어 옵션을 통한 QA용 릴리스 서명 적용 프로세스
• Java Runtime Environment 기반의 독립적 실행 환경 구축으로 GUI 도구 의존성 제거

Impact

2분 미만의 작업 시간으로 AAB의 APK 변환 완료

Key Takeaway

배포 최적화를 위한 AAB 구조와 테스트 편의성을 위한 Universal APK의 용도 분리 설계가 필요함.