AAPT2

AAPT2(Android Asset Packaging Tool)는 Android 스튜디오 및 Android Gradle 플러그인이 앱의 리소스를 컴파일하고 패키징하는 데 사용하는 빌드 도구입니다. AAPT2는 리소스를 Android 플랫폼에 최적화된 바이너리 형식으로 파싱하고 색인을 생성하며 컴파일합니다.

Android Gradle 플러그인 3.0.0 이상에서는 기본적으로 AAPT2가 사용 설정됩니다. 일반적으로 aapt2를 직접 호출하지 않아도 됩니다. 그러나 Android 스튜디오 대신 터미널 및 자체 빌드 시스템 사용을 선호한다면 명령줄에서 AAPT2를 사용할 수 있습니다. 명령줄에서 AAPT2와 관련된 빌드 오류를 디버그할 수도 있습니다. 이렇게 하려면 Android SDK 빌드 도구 26.0.2 이상에서 AAPT2를 독립형 도구로 사용하면 됩니다.

명령줄에서 Android SDK 빌드 도구를 다운로드하려면 sdkmanager를 사용하여 다음 명령어를 실행합니다.

sdkmanager "build-tools;build-tools-version"

SDK 빌드 도구를 다운로드하고 나면 android_sdk/build-tools/version/에서 AAPT2를 찾으세요.

Android SDK 빌드 도구의 버전은 자주 출시되지 않으므로 SDK 빌드 도구에 포함된 AAPT2가 최신 버전이 아닐 수도 있습니다. AAPT2의 최신 버전을 받으려면 Google Maven에서 AAPT2를 다운로드하세요.

Linux 또는 Mac의 명령줄에서 AAPT2를 사용하려면 aapt2 명령어를 실행합니다. Windows의 경우 aapt2.exe 명령어를 실행합니다.

AAPT2에서는 증분 컴파일을 사용 설정하여 리소스를 더 빨리 컴파일할 수 있습니다. 증분 컴파일을 위해 리소스 처리는 다음 두 단계로 구분됩니다.

• Compile: 리소스 파일을 바이너리 형식으로 컴파일합니다.
• Link: 모든 컴파일된 파일과 패키지를 단일 패키지로 병합합니다.

이렇게 구분하면 증분 빌드의 성능 향상에 도움이 됩니다. 예를 들어 파일 하나가 변경된 경우 그 파일만 다시 컴파일하면 됩니다.

Google Maven에서 AAPT2 다운로드

빌드 도구에 번들로 포함되지 않은 AAPT2의 최신 버전이 필요한 경우 다음과 같이 Google Maven 저장소에서 AAPT2를 다운로드하세요.

1. 저장소 색인에서 com.android.tools.build > aapt2로 이동합니다.
2. AAPT2 최신 버전의 이름을 복사합니다.

3. 복사한 버전 이름을 다음 URL에 삽입하고 타겟 운영체제를 지정합니다. https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/aapt2-version/aapt2-aapt2-version- [windows | linux | osx].jar

   예를 들어 Windows용 버전 3.2.0-alpha18-4804415를 다운로드하려면 다음을 사용합니다. https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ 3.2.0-alpha18-4804415/aapt2-3.2.0-alpha18-4804415-windows.jar

4. 브라우저에서 URL로 이동하면 곧 AAPT2 다운로드가 시작됩니다.

5. 방금 다운로드한 JAR 파일의 패키지를 해제합니다.

   JAR 파일에는 aapt2 실행 파일과 실행 파일에서 사용하는 라이브러리가 포함되어야 합니다.

컴파일

AAPT2는 모든 Android 리소스 유형(예: 드로어블 및 XML 파일)의 컴파일을 지원합니다. 컴파일을 위해 AAPT2를 호출하는 경우 단일 리소스 파일을 호출당 입력으로 전달합니다. 그런 다음 AAPT2는 파일을 파싱하고 확장자가 .flat인 중간 바이너리 파일을 생성합니다.

전체 디렉터리를 전달하면 AAPT2는 리소스가 하나만 변경되었더라도 디렉터리의 모든 파일을 재컴파일합니다. --dir 플래그를 사용하여 리소스 파일이 두 개 이상 포함된 리소스 디렉터리를 AAPT2에 전달할 수 있지만 이렇게 하면 증분 리소스 컴파일의 이점을 활용하지 못합니다.

출력 파일 형식은 다음 표와 같이 컴파일을 위해 제공하는 입력에 따라 다를 수 있습니다.

표 1. 컴파일용 입력 및 출력 파일 형식

AAPT2 출력 파일은 실행 파일이 아니므로 APK를 생성하려면 나중에 링크 단계에서 이러한 바이너리 파일을 입력으로 포함해야 합니다. 그러나 생성된 APK 파일은 Android 기기에 즉시 배포할 수 있는 실행 파일이 아닙니다. DEX 파일이 포함되어 있지 않고 서명되지 않았기 때문입니다.

컴파일 문법

compile을 사용하는 일반적인 구문은 다음과 같습니다.

aapt2 compile path-to-input-files [options] -o output-directory/

다음 예에서 AAPT2는 이름이 각각 values.xml 및 myImage.png인 리소스 파일을 컴파일합니다.

aapt2 compile project_root/module_root/src/main/res/values-en/strings.xml -o compiled/
aapt2 compile project_root/module_root/src/main/res/drawable/myImage.png -o compiled/

표 1에서 볼 수 있듯이 출력 파일의 이름은 입력 파일 이름과 그 상위 디렉터리의 이름에 따라 다릅니다.

앞의 예에서 strings.xml 파일을 입력으로 사용하면 aapt2는 자동으로 출력 파일의 이름을 values-en_strings.arsc.flat으로 지정합니다. 그러나 드로어블 디렉터리에 저장된 컴파일된 드로어블 파일의 이름은 drawable_img.png.flat입니다.

컴파일 옵션

표 2와 같이 compile 명령어와 함께 사용할 수 있는 몇 가지 옵션이 있습니다.

표 2. compile 명령어 옵션

링크

링크 단계에서 AAPT2는 컴파일 단계에서 생성되는 모든 중간 파일(예: 리소스 테이블, 바이너리 XML 파일, 처리된 PNG 파일)을 병합한 후 파일을 단일 APK로 패키징합니다. 또한 이 단계에서는 R.java 및 ProGuard 규칙 파일과 같은 다른 보조 파일도 생성될 수 있습니다. 그러나 생성된 APK는 DEX 바이트 코드를 포함하지 않으며 서명되어 있지 않습니다. 이 APK는 기기에 배포할 수 없습니다.

Android Gradle 플러그인을 사용하여 명령줄에서 앱을 빌드하지 않는 경우 d8과 같은 다른 명령줄 도구를 사용하여 자바 바이트 코드를 DEX 바이트 코드로 컴파일하고 apksigner를 사용하여 APK에 서명할 수 있습니다.

링크 문법

link를 사용하는 일반적인 문법은 다음과 같습니다.

aapt2 link path-to-input-files [options] -o
outputdirectory/outputfilename.apk --manifest AndroidManifest.xml

다음 예에서 AAPT2는 drawable_Image.flat과 values_values.arsc.flat이라는 중간 파일 두 개와 AndroidManifest.xml 파일을 병합합니다. AAPT2는 android 패키지에 정의된 리소스를 보유하는 android.jar 파일을 기준으로 결과를 연결합니다.

 aapt2 link -o output.apk
 -I android_sdk/platforms/android_version/android.jar
    compiled/res/values_values.arsc.flat
    compiled/res/drawable_Image.flat --manifest /path/to/AndroidManifest.xml -v

링크 옵션

link 명령어와 함께 다음 옵션을 사용할 수 있습니다.

표 3. 링크 명령어 옵션

덤프

dump는 link 명령어를 사용하여 생성한 APK 관련 정보를 출력하는 데 사용됩니다.

덤프 문법

dump를 사용하는 일반적인 문법은 다음과 같습니다.

aapt2 dump sub-command filename.apk [options]

다음 예는 지정된 APK의 리소스 테이블에서 콘텐츠를 출력합니다.

aapt2 dump resources output.apk

덤프 하위 명령어

dump 명령어를 사용하여 다음 하위 명령어 중 하나를 지정합니다.

표 4. 덤프 하위 명령어

덤프 옵션

dump와 함께 다음 옵션을 사용하세요.

표 5. 덤프 옵션

diff

diff를 사용하여 두 APK를 비교하고 차이점을 식별합니다.

diff 문법

diff를 사용하는 일반적인 문법은 다음과 같습니다.

aapt2 diff first.apk second.apk

diff 명령어에는 옵션이 없습니다.

최적화

optimize는 APK에 패키징하기 전에 병합된 리소스와 resources.arsc에서 최적화를 실행하는 데 사용됩니다. 이 최적화는 사용 중인 리소스의 크기와 수에 따라 APK 크기를 약 1~3% 줄일 수 있습니다.

최적화 문법

optimize를 사용하는 일반적인 문법은 다음과 같습니다.

aapt2 optimize options file[,file[..]]

다음 예에서는 input.apk의 리소스를 최적화하고 output.apk에 최적화된 새 APK를 만듭니다. 일반 플랫 테이블 표현을 더 작은 바이너리 검색 트리로 대체하므로 검색 성능을 희생하는 대신 APK가 더 작아집니다.

aapt2 optimize -o output.apk --enable-sparse-encoding input.apk

최적화 옵션

optimize와 함께 다음 옵션을 사용할 수 있습니다.

표 6. 최적화 옵션

변환

기본적으로 AAPT compile 명령어는 리소스를 APK에 적합한 바이너리 형식으로 컴파일합니다. --proto-format을 지정하여 AAB에 적합한 protobuf 형식을 지정할 수도 있습니다. convert 명령어는 두 형식 간에 APK를 변환합니다.

변환 문법

convert의 일반적인 문법은 다음과 같습니다.

aapt2 convert -o output-file options file[,file[..]]

다음 예에서는 input.apk의 리소스를 변환하고 output.apk에 protobuf 형식 리소스가 포함된 새로운 APK를 만듭니다. 일반 플랫 테이블 표현을 더 작은 바이너리 검색 트리로 대체하므로 검색 성능은 저하되지만 APK가 더 작아집니다.

aapt2 convert -o output.apk --output-format proto --enable-sparse-encoding input.apk

변환 옵션

convert와 함께 다음 옵션을 사용하세요.

표 7. 변환 옵션

데몬 모드

AAPT 버전 2.19에서는 명령어 실행을 위한 데몬 모드를 도입했습니다. 데몬 모드를 사용하면 단일 AAPT 세션에서 여러 명령어를 입력할 수 있습니다.

데몬 문법

다음 명령어를 사용하여 데몬 모드를 시작하세요.

aapt2 daemon

데몬 모드가 실행되면 명령어를 입력할 수 있습니다. 명령어의 각 인수는 별도의 줄에 있어야 하며, 명령어 끝에는 빈 줄이 있어야 합니다. Control+D를 입력하여 데몬 모드를 종료합니다.

다음과 같은 개별 compile 명령어를 살펴보세요.

aapt2 compile project_root/module_root/src/main/res/values-en/strings.xml -o compiled/
aapt2 compile project_root/module_root/src/main/res/drawable/myImage.png -o compiled/

이러한 명령어를 데몬 모드에서는 다음과 같이 입력할 수 있습니다.

aapt2 daemon
Ready
compile
project_root/module_root/src/main/res/values-en/strings.xml
-o
compiled/

Done
compile
project_root/module_root/src/main/res/drawable/myImage.png
-o
compiled/

Done
^D
Exiting daemon

데몬 모드 옵션

데몬 모드의 단일 옵션은 --trace-folder folder로, 지정된 folder에 대한 systrace JSON 트레이스 프래그먼트를 생성합니다.

버전

사용 중인 AAPT2 버전을 version 명령어를 통해 확인합니다.

aapt2 version
Android Asset Packaging Tool (aapt) 2.19-8678579

AAPT2 사용 시 동작 변경사항

AAPT2 이전에는 AAPT가 Android Asset Packaging Tool의 기본 버전이었으며 지금은 지원 중단되었습니다. AAPT2를 이전 프로젝트에서 즉시 사용할 수 있지만 이 섹션에서는 반드시 알아야 할 몇 가지 동작 변경사항을 설명합니다.

Android 매니페스트의 요소 계층 구조

이전 버전의 AAPT에서는 AndroidManifest.xml 파일의 잘못된 노드에 요소가 중첩되어 있으면 이를 무시하거나 경고를 보냈습니다. 다음 예를 살펴보세요.

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.myname.myapplication">
   <application
       ...
       <activity android:name=".MainActivity">
           <intent-filter>
               <action android:name="android.intent.action.MAIN" />
               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
           <action android:name="android.intent.action.CUSTOM" />
       </activity>
   </application>
</manifest>

이전 버전의 AAPT에서는 위치가 잘못된 <action> 태그를 간단히 무시했습니다.

AAPT2에서는 다음과 같은 오류가 발생합니다.

AndroidManifest.xml:15: error: unknown element <action> found.

문제를 해결하려면 매니페스트 요소를 올바르게 중첩해야 합니다. 자세한 내용은 앱 매니페스트 개요를 참고하세요.

리소스 선언

더 이상 name 속성에서 리소스 유형을 표시할 수 없습니다. 다음 예에서는 attr 리소스 항목을 잘못 선언합니다.

<style name="childStyle" parent="parentStyle">
    <item name="attr/my_attr">@color/pink</item>
</style>

이렇게 리소스 유형을 선언하면 다음과 같은 빌드 오류가 발생합니다.

Error: style attribute 'attr/attr/my_attr (aka my.package:attr/attr/my_attr)'
not found.

이 오류를 해결하려면 type="attr"을 사용하여 유형을 명시적으로 선언합니다.

<style name="childStyle" parent="parentStyle">
  <item type="attr" name="my_attr">@color/pink</item>
</style>

또한 <style> 요소를 선언할 때 그 상위 요소도 스타일 리소스 유형이어야 합니다. 그렇지 않으면 다음과 비슷한 오류가 발생합니다.

Error: (...) invalid resource type 'attr' for parent of style

리소스 참조 기호 @의 잘못된 사용

AAPT2에서는 리소스 참조 기호(@)를 생략하거나 잘못된 위치에 배치하면 빌드 오류가 발생합니다. 예를 들어 다음은 스타일 속성을 지정할 때 기호를 생략하는 경우입니다.

<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
  ...
  <!-- Note the missing '@' symbol when specifying the resource type. -->
  <item name="colorPrimary">color/colorPrimary</item>
</style>

AAPT2에서는 모듈을 빌드할 때 다음과 같은 빌드 오류가 발생합니다.

ERROR: expected color but got (raw string) color/colorPrimary

또한 다음은 android 네임스페이스에서 리소스에 액세스할 때 기호를 잘못 포함하는 경우입니다.

...
<!-- When referencing resources from the 'android' namespace, omit the '@' symbol. -->
<item name="@android:windowEnterAnimation"/>

AAPT2에서는 모듈을 빌드할 때 다음과 같은 빌드 오류가 발생합니다.

Error: style attribute '@android:attr/windowEnterAnimation' not found

라이브러리의 잘못된 구성

앱에 Android SDK 빌드 도구의 이전 버전을 사용하여 빌드된 서드 파티 라이브러리의 종속 항목이 있는 경우, 런타임 시 오류나 경고를 표시하지 않고 앱이 비정상 종료될 수 있습니다. 이러한 비정상 종료는 라이브러리를 만드는 동안 R.java 필드가 final로 선언되어 발생할 수도 있습니다. 따라서 모든 리소스 ID가 라이브러리의 클래스에서 인라인 처리됩니다.

AAPT2는 앱을 빌드할 때 ID를 라이브러리 리소스에 다시 할당할 수 있는 기능에 의존합니다. 라이브러리가 ID를 final로 가정하고 라이브러리 DEX에서 인라인 처리하면 런타임 불일치가 발생합니다.

이 오류를 해결하려면 라이브러리 작성자에게 문의하여 최신 버전의 Android SDK 빌드 도구를 사용하는 라이브러리를 다시 빌드하여 라이브러리를 다시 게시합니다.