[Android] bundletool을 어떻게 쓰라는거지? 윈도우에서 bundletool 사용법

사용자에게 앱을 제공할 때 좀 더 작은 용량을 다운받을 수 있게 제공하고자 만들어진 Android App Bundle.

Android App Bundle로 빌드 된 aab 파일을 로컬에 연결 된 디바이스에 테스트 하려면 bundletool을 사용하면 된다고 가이드를 하고 있다.

그리고 bundletool 다운로드 페이지를 아래와 같이 안내하고 있다.

 

https://github.com/google/bundletool/releases

google/bundletool

여기에 들어가면, 소스코드와 jar파일밖에 없다.

jar 파일을 사용해 보지 않았다면 이를 어떻게 사용하는지 모를것이다.

 

이 글에서는 Windows 환경에서 bundletool.jar파일 사용법을 안내하고자 한다.

 

맥 사용자의 경우 아래 글을 참고하기 바란다.

https://hckim999.tistory.com/22

[Android] bundletool을 어떻게 쓰라는거지? 맥에서 bundletool 사용법

 

 

우선 java 설치부터

jar파일을 실행하려면 java가 설치되고, 자바 환경변수가 설정되어 있어야 한다.

java 가 설치되어 있는지 아는 방법은 cmd에서 java -version을 입력하면 된다.

 

입력하면 아래와 같이 표시되어야 한다.

 

>java -version
java version "1.8.0_221"
Java(TM) SE Runtime Environment (build 1.8.0_221-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.221-b11, mixed mode)

 

위와 같이 뜨지 않는다면, 

자바를 설치하고 자바 환경변수를 설정 해 줘야 한다.

 

자바 환경변수를 설정해 주는 글은 인터넷에 너무 많으니 이 글에서는 다루지 않고자 한다.

구글에서 "자바 환경변수 설정" 혹은 "java path 설정"등을 검색해서 위와 같이 "java -version"이라고 표시되게 한 다음에 이 글을 계속 읽기 바란다.

 

 

이제 bundle.jar를 실행 해 보자

bundle.jar를 실행하기 위한 cmd 명령어는 아래와 같다.

 

> java -jar "./bundletool-all-0.11.0.jar" version

 

필자가 이 글을 적는 당시 bundletool의 최신 버전이 0.10.0이라서 파일명이 bundletool-all-0.11.0.jar 이다.

 

이렇게 적으면 내가 다운받은 bundletool의 버전이 표시 될 것이다.

필자는 아래와 같이 표시가 되었다.

0.11.0

이제 bundletool을 사용할 수 있다!

 

bundletool 명령어로 사용할 수 있게 하기

bundletool을 사용할 떄 마다 위와 같이 java -jar "./bundletool-all-0.11.0.jar" 를 앞에 붙여주려니 귀찮다.

저 긴 명령어 대신에 문서에 나오는 것 처럼 bundletool만 입력하면 되게 할 수 없을까?

 

필자는 위의 긴 명령구문을 실행시켜주는 bundletool.bat파일을 만들었다.

(bat파일은 메모장 등 편한 에디터를 이용해서 만들고, 확장자만 bat로 지정하면 된다. 된다)

java -jar "C:\dev\android_bundle_tool\bundletool-all-0.11.0.jar" %*

 

bat파일에 bundletool-all-0.11.0.jar 파일의 절대경로를 적어주고, %*를 이용해서 batch파일의 모든 파라미터를 jar를 실행할 때 넘기도록 했다.

 

그 후 저 bundletool.bat가 있는 경로를 환경변수 Path에 추가 시켰다.

그 후 cmd를 껐다 킨 뒤 bundletool version이라고 입력하면 아래와 같이 뜬다.

 

>bundletool version
>java -jar "C:\dev\android_bundle_tool\bundletool-all-0.11.0.jar" version
0.11.0

 

이제 bundletool 문서에 나오는 명령어로 실행하면 동작이 되는것을 볼 수 있다.