أداة AAPT2

إنّ AAPT2 (أداة تجميع مواد العرض في Android) هي أداة تصميم تتيح لك نستخدمه المكوّن الإضافي لنظام Gradle المتوافق مع Android لتجميع وتجميع محتوى تطبيقك الموارد. تحليلات وفهارس AAPT2 وتجمع الموارد في تنسيق ثنائي تم تحسينه نظام Android الأساسي.

يعمل الإصدار 3.0.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android والإصدارات الأحدث على تفعيل AAPT2 تلقائيًا. إِنْتَ عادةً لا تحتاج إلى استدعاء aapt2 بنفسك. ومع ذلك، إذا كنت تفضّل استخدام الوحدة الطرفية ونظام التصميم بدلاً من "استوديو Android"، يمكنك استخدام AAPT2 من سطر الأوامر. يمكنك أيضًا تصحيح أخطاء الإصدار المتعلقة بـ AAPT2 من سطر الأوامر. للقيام بذلك، ابحث عن AAPT2 كأداة مستقلة في أدوات إنشاء حزمة تطوير البرامج (SDK) لنظام التشغيل Android 26.0.2 والإصدارات الأحدث.

لتنزيل أدوات إنشاء حزمة تطوير البرامج (SDK) لنظام التشغيل Android من سطر الأوامر، استخدِم sdkmanager وشغِّل الأمر التالي:

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

بعد تنزيل أدوات إنشاء حزمة SDK، ابحث عن AAPT2 في android_sdk/build-tools/version/

لأنّه لم يتم إصدار النُسخ السابقة من "أدوات إنشاء حزمة تطوير البرامج (SDK) لنظام التشغيل Android". في أغلب الأحيان، قد لا يكون إصدار AAPT2 المضمّن في أدوات إنشاء حزمة تطوير البرامج (SDK) لديك الأحدث. للحصول على أحدث إصدار من AAPT2، نزِّل AAPT2 من Google Maven.

لاستخدام AAPT2 من سطر الأوامر على نظام التشغيل Linux أو Mac، شغِّل الأمر aapt2. على نظام التشغيل Windows، شغِّل الأمر aapt2.exe.

تدعم AAPT2 تجميعًا أسرع للموارد عن طريق تمكين المستخدمين المتزايد التحويل البرمجي. لإنجاز التجميع التزايدي، تتم معالجة الموارد منفصلة إلى خطوتين:

• التجميع: يجمع ملفات الموارد في تنسيقات ثنائية.
• الرابط: يدمج هذا النموذج كل الملفات المجمّعة ويجمعها في ملف واحد طرد.

يساعد هذا الفصل في تحسين الأداء لعمليات الإنشاء التدريجية. على سبيل المثال: وإذا كانت هناك تغييرات في ملف واحد، فستحتاج إلى إعادة التحويل البرمجي لهذا الملف فقط.

تنزيل 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-window.jar

4. انتقِل إلى عنوان URL في متصفّح. سيبدأ تنزيل AAPT2 بعد قليل.

5. ألغِ حزمة ملف JAR الذي نزّلته للتو.

   يجب أن يحتوي ملف JAR على ملف aapt2 قابل للتنفيذ وبعض المكتبات التي قابل للتنفيذ يعتمد عليه.

التجميع

تدعم AAPT2 تجميع كل أنواع موارد Android، مثل القابلة للرسم وملفات XML. عند استدعاء AAPT2 للتجميع، مرر ملف مورد واحد كمدخلات لكل استدعاء. يحلّل AAPT2 الملف بعد ذلك وتنشئ ملفًا ثنائيًا متوسطًا بامتداد .flat.

عند تمرير الأدلة بأكملها، يعيد AAPT2 تجميع كل الملفات في الدليل. حتى عند تغيير مورد واحد فقط. وعلى الرغم من أنّه يمكنك تمرير الموارد دلائل تحتوي على أكثر من ملف موارد واحد لـ 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 هذه على أي جهاز.

إذا كنت لا تستخدم المكوّن الإضافي لنظام Gradle المتوافق مع Android إنشاء تطبيقك من سطر الأوامر، يمكنك استخدام أدوات سطر الأوامر الأخرى، مثل d8 لتجميع رمز بايت Java إلى رمز بايت 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.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 وتحديد أي اختلافات بينهما.

بنية الاختلاف

في ما يلي البنية العامة لاستخدام 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

خيارات "أدوات تحسين الأداء من Google"

يمكنك استخدام الخيارات التالية مع "optimize":

الجدول 6. خيارات "أدوات تحسين الأداء من Google"

الجذب

يجمع أمر AAPT compile الموارد تلقائيًا بتنسيق ثنائي. المناسبة لحِزم 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: خيارات التحويل

وضع الخفي

وفّر الإصدار 2.19 من AAPT وضعًا خفيًا لإصدار الأوامر. يتيح لك وضع الخفي يمكنك إدخال أوامر متعددة في جلسة 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 الذي ينشئ systrace JSON تتبّع الجزء إلى folder المحدّد.

الإصدار

حدد إصدار AAPT2 الذي تستخدمه من خلال الأمر version:

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

تغييرات السلوك عند استخدام AAPT2

قبل استخدام AAPT2، كان AAPT الإصدار التلقائي من "أداة تجميع مواد العرض في Android". التي تم إيقافها الآن. على الرغم من أن 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

ضبط المكتبات بشكل غير صحيح

إذا كان تطبيقك يعتمد على مكتبة تابعة لجهة خارجية تم إنشاؤها باستخدام مكتبة قديمة أدوات إنشاء حزمة تطوير البرامج (SDK) لنظام التشغيل Android، قد يتعطّل التطبيق في وقت التشغيل بدون عرض أي أخطاء أو تحذيرات. هذا العُطل قد تحدث لأنه أثناء إنشاء المكتبة، يتم عرض الحقول R.java تم الإعلان عن final. ونتيجةً لذلك، يتم تضمين جميع معرّفات الموارد في دروس المكتبة.

تعتمد AAPT2 على القدرة على إعادة تعيين معرفات لموارد المكتبة عند إنشاء تطبيقك. إذا افترضت المكتبة أنّ المعرّفات هي final وضمّنتها في ملف DEX للمكتبة، يكون هناك عدم تطابق في بيئة التشغيل.

لحل هذا الخطأ، اتصل بمؤلف المكتبة لإعادة إنشاء المكتبة باستخدام أحدث إصدار من أدوات إنشاء حزمة تطوير البرامج (SDK) لنظام التشغيل Android، وإعادة نشر المكتبة.