aapt - คู่มืออ้างอิง ตัวเลือก ตัวอย่างคำสั่ง

---

ชื่อ

aapt - เครื่องมือบรรจุสินทรัพย์ Android

เรื่องย่อ

aapt command [ options ] files ...

คำอธิบาย

Android Asset Packaging Tool (aapt) นำไฟล์ทรัพยากรแอปพลิเคชันของคุณ เช่น ไฟล์ AndroidManifest.xml และไฟล์ XML สำหรับกิจกรรมของคุณ มาคอมไพล์ มีการสร้าง R.java เพื่อให้คุณสามารถอ้างอิงทรัพยากรของคุณจากโค้ด Java ของคุณ

ตัวเลือก

ข้อมูลสรุปของตัวเลือกรวมอยู่ด้านล่าง

-a

พิมพ์ข้อมูลเฉพาะของ Android (ทรัพยากร รายการ) เมื่อแสดงรายการ

-c

ระบุการกำหนดค่าที่จะรวม ค่าเริ่มต้นคือการกำหนดค่าทั้งหมด ค่าของพารามิเตอร์ควรเป็นรายการค่าคอนฟิกูเรชันที่คั่นด้วยเครื่องหมายจุลภาค ควรระบุสถานที่เป็นภาษาหรือคู่ภาษา-ภูมิภาค ตัวอย่างบางส่วน: en port,en port,land,en_US

หากคุณใส่โลแคลพิเศษ zz_ZZ ในรายการ มันจะทำการหลอกโลแคลบนโลแคลเริ่มต้น แก้ไขสตริงทั้งหมดเพื่อให้คุณสามารถค้นหาสตริงที่ไม่ผ่านกระบวนการทำให้เป็นสากล ตัวอย่างเช่น: port,land,zz_ZZ

-d

เนื้อหาอุปกรณ์อย่างน้อยหนึ่งรายการที่จะรวม คั่นด้วยเครื่องหมายจุลภาค

-f

บังคับให้เขียนทับไฟล์ที่มีอยู่

-g

ระบุค่าความคลาดเคลื่อนของพิกเซลเพื่อบังคับให้รูปภาพเป็นโทนสีเทา ค่าเริ่มต้นคือ 0

-j

ระบุไฟล์ jar หรือ zip ที่มีคลาสที่จะรวม

-k

เพิ่มเส้นทางขยะของไฟล์

-m

สร้างไดเร็กทอรีแพ็คเกจภายใต้ตำแหน่งที่ระบุโดย -J

-u

อัปเดตแพ็กเกจที่มีอยู่ (เพิ่มใหม่ แทนที่เก่า ลบไฟล์ที่ถูกลบ)

-v

เอาต์พุตอย่างละเอียด

-x

สร้างรหัสทรัพยากรแบบขยาย (ไม่ใช่แอปพลิเคชัน)

-z

ต้องการการแปลแอตทริบิวต์ของทรัพยากรที่มีเครื่องหมาย localization="suggested"

-A

ไดเร็กทอรีเพิ่มเติมสำหรับค้นหาไฟล์เนื้อหาดิบ

-G

ไฟล์ที่จะส่งออกตัวเลือก proguard เข้าไป

-F

ระบุไฟล์ apk เพื่อส่งออก

-I

เพิ่มแพ็คเกจที่มีอยู่ในชุดรวมฐาน

-J

ระบุตำแหน่งที่จะส่งออกข้อกำหนดคงที่ของทรัพยากร R.java

-M

ระบุเส้นทางแบบเต็มไปยัง AndroidManifest.xml เพื่อรวมไว้ใน zip

-P

ระบุตำแหน่งที่จะส่งออกคำนิยามทรัพยากรสาธารณะ

-S

ไดเร็กทอรีที่ใช้ค้นหาทรัพยากร ไดเร็กทอรีหลายไดเร็กทอรีจะถูกสแกนและรายการแรกที่ตรงกัน (จากซ้ายไปขวา) จะมีความสำคัญเหนือกว่า

-0

ระบุนามสกุลเพิ่มเติมที่ไฟล์ดังกล่าวจะไม่ถูกบีบอัดใน .apk สตริงว่างหมายถึงการไม่บีบอัดไฟล์ใดๆ เลย

--debug-mode

แทรก android:debuggable="true" ในโหนดแอปพลิเคชันของรายการ ทำให้แอปพลิเคชันสามารถดีบักได้แม้ในอุปกรณ์ที่ใช้งานจริง

--min-sdk-version

แทรก android:minSdkVersion ในไฟล์ Manifest หากเป็นเวอร์ชัน 7 หรือสูงกว่า การเข้ารหัสเริ่มต้นสำหรับทรัพยากรจะเป็น UTF-8

--target-sdk-version

แทรก android:targetSdkVersion ในไฟล์ Manifest

--max-res-version

ละเว้นไดเร็กทอรีทรัพยากรที่มีเวอร์ชันสูงกว่าค่าที่กำหนด

--values

เมื่อใช้กับ "ดัมพ์ทรัพยากร" รวมถึงค่าทรัพยากรด้วย

--version-code

แทรก android:versionCode ในไฟล์ Manifest

--version-name

แทรก android:versionName ในไฟล์ Manifest

--custom-package

สร้าง R.java เป็นแพ็คเกจอื่น

--extra-packages

สร้าง R.java สำหรับไลบรารี แยกไลบรารีด้วย ':'

--generate-dependencies

สร้างไฟล์อ้างอิงในไดเรกทอรีเดียวกันสำหรับ R.java และแพ็คเกจทรัพยากร

--auto-add-overlay

เพิ่มทรัพยากรที่อยู่ในภาพซ้อนทับโดยอัตโนมัติ

--preferred-configurations

เช่นเดียวกับตัวเลือก -c สำหรับการกรองการกำหนดค่าที่ไม่จำเป็นออก แต่จะแสดงเฉพาะการตั้งค่าเท่านั้น หากไม่มีทรัพยากรที่ใช้ได้กับการกำหนดค่าที่ต้องการ ทรัพยากรนั้นจะไม่ถูกถอด

--rename-manifest-package

เขียนรายการใหม่เพื่อให้ชื่อแพ็คเกจเป็นชื่อแพ็คเกจที่กำหนดที่นี่ ชื่อคลาสสัมพัทธ์ (เช่น .Foo) จะถูกเปลี่ยนเป็นชื่อสัมบูรณ์ด้วยแพ็คเกจเก่า ดังนั้นรหัสจึงไม่จำเป็นต้องเปลี่ยน

--rename-instrumentation-target-package

เขียนรายการใหม่เพื่อให้ส่วนประกอบเครื่องมือวัดทั้งหมดกำหนดเป้าหมายไปที่แพ็คเกจที่กำหนด มีประโยชน์เมื่อใช้ร่วมกับ --rename-manifest-package เพื่อแก้ไขการทดสอบกับแพ็คเกจที่ถูกเปลี่ยนชื่อ

--product

ระบุตัวแปรที่จะเลือกสำหรับสตริงที่มีผลิตภัณฑ์ย่อย

--utf16

เปลี่ยนการเข้ารหัสเริ่มต้นสำหรับทรัพยากรเป็น UTF-16 มีประโยชน์เฉพาะเมื่อระดับ API ตั้งค่าเป็น 7 หรือสูงกว่า โดยที่การเข้ารหัสเริ่มต้นคือ UTF-8

--non-constant-id

ทำให้รหัสทรัพยากรไม่คงที่ สิ่งนี้จำเป็นในการสร้างคลาส R java ที่ไม่มีค่าสุดท้าย แต่ใช้เพื่อสร้างไลบรารีที่คอมไพล์แล้วใช้ซ้ำได้ซึ่งจำเป็นต้องเข้าถึงทรัพยากร

--error-on-failed-insert

บังคับให้ aapt ส่งคืนข้อผิดพลาดหากไม่สามารถแทรกค่าลงในรายการด้วย --debug-mode, --min-sdk-version, --target-sdk-version --version-code และ --version-name โดยทั่วไปการแทรกจะล้มเหลวหากรายการกำหนดแอตทริบิวต์แล้ว

--output-text-symbols

สร้างไฟล์ข้อความที่มีสัญลักษณ์รีซอร์สของคลาส R ในโฟลเดอร์ที่ระบุ

--ignore-assets

สินทรัพย์ที่จะละเว้น

ตัวอย่าง

รายการเนื้อหาของไฟล์เก็บถาวรที่เข้ากันได้กับ Zip:

aapt l[ist] [-v] [-a] file.{zip,jar,apk}

ค่าการถ่ายโอนข้อมูล:

aapt d[ump] [--values] SUBJECT file.{apk} [asset [asset ...]]

เรื่องสามารถ:

strings

พิมพ์เนื้อหาของพูลสตริงของตารางทรัพยากรใน APK

badging

พิมพ์ป้ายกำกับและไอคอนสำหรับแอปที่ประกาศใน APK

permissions

พิมพ์สิทธิ์จาก APK

resources

พิมพ์ตารางทรัพยากรจาก APK

configurations

พิมพ์การกำหนดค่าใน APK

xmltree

พิมพ์ xmls ที่คอมไพล์แล้วในเนื้อหาที่กำหนด

xmlstrings

พิมพ์สตริงของเนื้อหา xml ที่คอมไพล์แล้ว

จัดแพ็คเกจทรัพยากร Android มันจะอ่านเนื้อหาและทรัพยากรที่มาพร้อมกับอาร์กิวเมนต์ -M -A -S หรือ raw-files-dir อ็อพชัน -J -P -F และ -R ควบคุมไฟล์ที่จะส่งออก:

aapt p[ackage] [-d] [-f] [-m] [-u] [-v] [-x] [-z] [-M AndroidManifest.xml] [-0 extension [-0 extension ...]] [-g tolerance] [-j jarfile] [--debug-mode] [--min-sdk-version VAL] [--target-sdk-version VAL] [--app-version VAL] [--app-version-name TEXT] [--custom-package VAL] [--rename-manifest-package PACKAGE] [--rename-instrumentation-target-package PACKAGE] [--utf16] [--auto-add-overlay] [--max-res-version VAL] [-I base-package [-I base-package ...]] [-A asset-source-dir] [-G class-list-file] [-P public-definitions-file] [-S resource-sources [-S resource-sources ...]] [-F apk-file] [-J R-file-dir] [--product product1,product2,...] [-c CONFIGS] [--preferred-configurations CONFIGS] [raw-files-dir [raw-files-dir] ...] [--output-text-symbols DIR]

ลบไฟล์ที่ระบุออกจากไฟล์เก็บถาวรที่เข้ากันได้กับ Zip:

aapt r[emove] [-v] file.{zip,jar,apk} file1 [file2 ...] 

เพิ่มไฟล์ที่ระบุไปยังไฟล์เก็บถาวรที่เข้ากันได้กับ Zip:

aapt a[dd] [-v] file.{zip,jar,apk} file1 [file2 ...]

ทำการประมวลผลล่วงหน้า PNG ในโฟลเดอร์ทรัพยากรหนึ่งหรือหลายโฟลเดอร์ และเก็บผลลัพธ์ไว้ในโฟลเดอร์เอาต์พุต:

aapt c[runch] [-v] -S resource-sources ... -C output-folder ... 

ทำการประมวลผลล่วงหน้า PNG ในไฟล์เดียว:

aapt s[ingleCrunch] [-v] -i input-file -o outputfile 

รุ่นโปรแกรมพิมพ์:

aapt v[ersion]

ผู้เขียน

aapt เขียนโดย The Android Open Source Project