AAPT2

AAPT2 (Android Asset Pack Tool) คือเครื่องมือสร้างที่ Android Studio และ ปลั๊กอิน Android Gradle ใช้เพื่อคอมไพล์และจัดแพ็กเกจแอปของคุณ แหล่งข้อมูล การแยกวิเคราะห์ ดัชนี AAPT2 และคอมไพล์ทรัพยากรเป็นรูปแบบไบนารีที่มีการปรับให้เหมาะสมสำหรับ แพลตฟอร์ม Android

ปลั๊กอิน Android Gradle 3.0.0 ขึ้นไปจะเปิดใช้ AAPT2 โดยค่าเริ่มต้น คุณ มักจะไม่จำเป็นต้องเรียกใช้ aapt2 ด้วยตัวเอง แต่หากคุณต้องการใช้ เทอร์มินัลและระบบบิลด์ของคุณเอง แทนที่จะเป็น Android Studio คุณสามารถใช้ AAPT2 จากบรรทัดคำสั่ง คุณยังแก้ไขข้อบกพร่องของข้อผิดพลาดในการสร้างที่เกี่ยวข้องกับ AAPT2 ได้ด้วย จากบรรทัดคำสั่ง ในการดำเนินการนี้ ให้ค้นหา AAPT2 เป็นเครื่องมือแบบสแตนด์อโลนใน เครื่องมือสร้าง Android SDK 26.0.2 ขึ้นไป

หากต้องการดาวน์โหลดเครื่องมือสร้าง Android SDK จากบรรทัดคำสั่ง ให้ใช้ sdkmanager แล้วเรียกใช้คำสั่งต่อไปนี้

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

เมื่อดาวน์โหลดเครื่องมือสร้าง SDK ให้ค้นหา AAPT2 ใน android_sdk/build-tools/version/

เนื่องจากเวอร์ชันแก้ไขของเครื่องมือสร้าง Android SDK ยังไม่เผยแพร่ บ่อยครั้งที่เวอร์ชัน AAPT2 ที่รวมอยู่ในเครื่องมือสร้าง SDK ของคุณอาจไม่ได้ ล่าสุด หากต้องการรับ AAPT2 เวอร์ชันล่าสุด ให้ทำดังนี้ ดาวน์โหลด AAPT2 จาก Google Maven

หากต้องการใช้ AAPT2 จากบรรทัดคำสั่งใน Linux หรือ Mac ให้เรียกใช้คำสั่ง aapt2 เรียกใช้คำสั่ง aapt2.exe ใน Windows

AAPT2 รองรับการรวบรวมทรัพยากรได้เร็วขึ้นโดยเปิดใช้ส่วนเพิ่ม ในการรวบรวม ในการคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ จะต้องประมวลผลทรัพยากร แบ่งออกเป็น 2 ขั้นตอนดังนี้

• คอมไพล์: คอมไพล์ไฟล์ทรัพยากรเป็นรูปแบบไบนารี
• ลิงก์: รวมไฟล์ที่คอมไพล์ทั้งหมดแล้วจัดแพ็กเกจให้เป็นไฟล์เดียว ใหม่

การแยกนี้ช่วยปรับปรุงประสิทธิภาพสำหรับบิลด์ที่เพิ่มขึ้น ตัวอย่างเช่น หากมีการเปลี่ยนแปลงในไฟล์เดียว คุณจะต้องคอมไพล์เฉพาะไฟล์นั้นซ้ำ

ดาวน์โหลด AAPT2 จาก Google Maven

หากต้องการรับ AAPT2 เวอร์ชันใหม่ล่าสุดที่ไม่ได้รวมอยู่ในเครื่องมือสร้าง ดาวน์โหลด AAPT2 จากที่เก็บ Maven ของ Google ดังนี้

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

   ตัวอย่างเช่น หากต้องการดาวน์โหลดเวอร์ชัน 3.2.0-alpha18-4804415 สำหรับ Windows ให้ใช้รูปแบบต่อไปนี้ 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 จะคอมไพล์ไฟล์ทั้งหมดในไดเรกทอรีใหม่ แม้ว่าจะเปลี่ยนแหล่งข้อมูลเพียงแหล่งเดียวก็ตาม แม้ว่าคุณจะสามารถส่งต่อแหล่งข้อมูล ไดเรกทอรีที่มีไฟล์ทรัพยากรมากกว่า 1 ไฟล์ที่ส่งไปยัง AAPT2 โดยใช้ --dir ทำให้คุณไม่ได้รับประโยชน์จากการรวบรวมทรัพยากรที่เพิ่มขึ้นด้วยวิธีนี้

ประเภทไฟล์เอาต์พุตอาจแตกต่างกันไป ขึ้นอยู่กับอินพุตที่คุณระบุสำหรับการคอมไพล์ ดังที่แสดงในตารางต่อไปนี้

ตาราง 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

ตัวเลือกคอมไพล์

มีหลายตัวเลือกที่คุณใช้กับคำสั่ง compile ได้ ตามที่แสดง ในตาราง 2:

ตาราง 2 คอมไพล์ตัวเลือกคำสั่ง

ลิงก์

ในขั้นตอนการลิงก์ AAPT2 จะรวมไฟล์กลางทั้งหมดที่การคอมไพล์ เฟสที่สร้างขึ้น เช่น ตารางทรัพยากร, ไฟล์ XML ไบนารี และ PNG ที่ประมวลผลแล้ว แล้วรวมไฟล์ลงใน APK เดียว นอกจากนี้ สร้างไฟล์เสริมได้ เช่น ไฟล์กฎ R.java และ ProGuard ในช่วงนี้ อย่างไรก็ตาม APK ที่สร้างขึ้นไม่มีไบต์โค้ด DEX และ ไม่มีการลงชื่อ คุณไม่สามารถทำให้ APK นี้ใช้งานได้ในอุปกรณ์

หากคุณไม่ได้ใช้ปลั๊กอิน Android Gradle ในการ สร้างแอปจากบรรทัดคำสั่ง ใช้เครื่องมือบรรทัดคำสั่งอื่นๆ เช่น d8 เพื่อคอมไพล์ ไบต์โค้ด Java ลงใน DEX ไบต์โค้ดและ apksigner เพื่อรับรอง APK ของคุณ

ไวยากรณ์ของลิงก์

ไวยากรณ์ทั่วไปสำหรับการใช้ link มีดังนี้

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

ในตัวอย่างต่อไปนี้ AAPT2 จะรวมไฟล์ระดับกลาง 2 ไฟล์ drawable_Image.flat และ values_values.arsc.flat และ AndroidManifest.xml ไฟล์ AAPT2 ลิงก์ผลลัพธ์กับ android.jar ซึ่งมีทรัพยากรที่กำหนดไว้ในแพ็กเกจ android:

 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 ใช้เพื่อพิมพ์ข้อมูลเกี่ยวกับ APK ที่คุณสร้างโดยใช้ คำสั่ง link

ดัมพ์ไวยากรณ์

ไวยากรณ์ทั่วไปสำหรับการใช้ dump มีดังนี้

aapt2 dump sub-command filename.apk [options]

ตัวอย่างต่อไปนี้พิมพ์เนื้อหาจากตารางทรัพยากรของข้อมูลที่ระบุ APK:

aapt2 dump resources output.apk

คำสั่งย่อยดัมพ์

ระบุคำสั่งย่อยรายการใดรายการหนึ่งต่อไปนี้ด้วยคำสั่ง dump

ตาราง 4 คำสั่งย่อยดัมพ์

ตัวเลือกดัมพ์

ใช้ตัวเลือกต่อไปนี้กับ dump

ตาราง 5 ตัวเลือกดัมพ์

ความแตกต่าง

ใช้ diff เพื่อเปรียบเทียบ APK 2 รายการและระบุความแตกต่างระหว่าง APK

ความแตกต่างทางไวยากรณ์

ไวยากรณ์ทั่วไปสำหรับการใช้ diff มีดังนี้

aapt2 diff first.apk second.apk

ไม่มีตัวเลือกสำหรับคำสั่ง diff

เพิ่มประสิทธิภาพ

optimize ใช้เพื่อเพิ่มประสิทธิภาพสำหรับทรัพยากรที่ผสานรวมและ resources.arsc ก่อนที่จะใช้แพ็กเกจใน APK การเพิ่มประสิทธิภาพนี้ สามารถลดขนาด APK ลงได้ประมาณ 1-3% ขึ้นอยู่กับขนาดและจำนวน ทรัพยากรที่ใช้ได้

เพิ่มประสิทธิภาพไวยากรณ์

ไวยากรณ์ทั่วไปสำหรับการใช้ optimize มีดังนี้

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

ตัวอย่างต่อไปนี้จะเพิ่มประสิทธิภาพทรัพยากรใน input.apk และสร้าง APK ที่เพิ่มประสิทธิภาพใน output.apk จะแทนที่การแสดงตารางค่าเดี่ยวตามปกติ ด้วยแผนผังการค้นหาไบนารีที่กะทัดรัดกว่า ส่งผลให้ APK มีขนาดเล็กลง ต้นทุนของประสิทธิภาพการเรียกข้อมูล:

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

ตัวเลือกการเพิ่มประสิทธิภาพ

คุณใช้ตัวเลือกต่อไปนี้กับ optimize ได้

ตาราง 6 ตัวเลือกการเพิ่มประสิทธิภาพ

ทำ Conversion

โดยค่าเริ่มต้น คำสั่ง compile ของ AAPT จะรวบรวมทรัพยากรในรูปแบบไบนารี ที่เหมาะสำหรับ APK ได้อย่างไร สามารถระบุรูปแบบ Protobuf ที่เหมาะกับ AAB โดยการระบุ --proto-format convert จะแปลง APK ระหว่างรูปแบบทั้งสอง

แปลงไวยากรณ์

ไวยากรณ์ทั่วไปสำหรับ convert มีดังนี้

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

ตัวอย่างต่อไปนี้จะแปลงทรัพยากรใน input.apk และสร้าง APK ใน output.apk ที่มีทรัพยากรรูปแบบ Protobuf จะแทนที่ การแสดงตารางค่าเดี่ยวที่มีแผนผังการค้นหาไบนารีที่กะทัดรัดกว่า ทำให้ได้ ใน APK ที่เล็กลงแต่ใช้ต้นทุนในการดึงข้อมูล เช่น

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

ตัวเลือกการแปลง

ใช้ตัวเลือกต่อไปนี้กับ convert

ตารางที่ 7 ตัวเลือกการแปลง

โหมด Daemon

AAPT เวอร์ชัน 2.19 ได้เปิดตัวโหมด Daemon สำหรับการออกคำสั่ง โหมด Daemon ช่วยให้ คุณป้อนคำสั่งหลายรายการในเซสชัน AAPT เดียว

ไวยากรณ์ Daemon

เริ่มต้นโหมด Daemon ด้วยคำสั่งต่อไปนี้

aapt2 daemon

เมื่อโหมด Daemon ทำงานแล้ว คุณสามารถป้อนคำสั่งได้ อาร์กิวเมนต์แต่ละรายการของ ต้องอยู่ในบรรทัดแยกต่างหาก และมีบรรทัดว่างอยู่ท้ายคำสั่ง ออกจากโหมด 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/

คำสั่งเหล่านี้ป้อนได้ในโหมด Daemon ดังนี้

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

ตัวเลือกโหมด Daemon

ตัวเลือกเดียวสำหรับโหมด Daemon คือ --trace-folder folder ซึ่งสร้าง JSON ของ systrace การติดตามส่วนไปยัง folder ที่ระบุ

เวอร์ชัน

ระบุเวอร์ชันของ AAPT2 ที่คุณใช้ด้วยคำสั่ง version ดังนี้

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

การเปลี่ยนแปลงลักษณะการทำงานเมื่อใช้ AAPT2

ก่อน AAPT2 นั้น AAPT เป็นเวอร์ชันเริ่มต้นของ Android Asset Packing Tool ซึ่งตอนนี้เลิกใช้งานแล้ว แม้ว่า AAPT2 ควรทํางานร่วมกับ จากโปรเจ็กต์เก่าแล้ว ส่วนนี้จะอธิบายการเปลี่ยนแปลงลักษณะการทำงานบางอย่างที่คุณควรทำ ทราบ

ลำดับชั้นขององค์ประกอบในไฟล์ Manifest ของ 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.

หากต้องการแก้ไขปัญหานี้ ให้ตรวจสอบว่าองค์ประกอบไฟล์ Manifest ของคุณซ้อนอยู่อย่างถูกต้อง สำหรับข้อมูลเพิ่มเติม โปรดอ่าน ภาพรวมไฟล์ Manifest ของแอป

การประกาศทรัพยากร

คุณระบุประเภทของทรัพยากรจากแอตทริบิวต์ 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

การกำหนดค่าไลบรารีไม่ถูกต้อง

หากแอปมีทรัพยากร Dependency ในไลบรารีของบุคคลที่สามที่สร้างขึ้นจากเวอร์ชันเก่า เครื่องมือสร้าง Android SDK แอปอาจขัดข้องขณะรันไทม์โดยไม่แสดงข้อผิดพลาดหรือคำเตือน ข้อขัดข้องนี้ อาจเกิดขึ้นเนื่องจากในระหว่างการสร้างไลบรารี ฟิลด์ R.java ประกาศเป็น final ดังนั้น รหัสทรัพยากรทั้งหมดจะอยู่ในบรรทัด ของห้องสมุด

AAPT2 ใช้ความสามารถในการกำหนดรหัสให้กับทรัพยากรไลบรารีอีกครั้งเมื่อสร้าง แอปของคุณ หากไลบรารีถือว่ารหัสคือ final และรวมรหัสไว้ใน DEX ไลบรารีจะมีรันไทม์ที่ไม่ตรงกัน

หากต้องการแก้ไขข้อผิดพลาดนี้ โปรดติดต่อผู้เขียนห้องสมุดเพื่อสร้างไลบรารีอีกครั้ง โดยใช้เครื่องมือสร้าง Android SDK เวอร์ชันล่าสุด และเผยแพร่ ไลบรารี