AAPT2

AAPT2 (ابزار بسته‌بندی دارایی‌های اندروید) یک ابزار ساخت است که اندروید استودیو و افزونه‌ی اندروید گریدل از آن برای کامپایل و بسته‌بندی منابع برنامه‌ی شما استفاده می‌کنند. AAPT2 منابع را تجزیه، فهرست‌بندی و به فرمت باینری که برای پلتفرم اندروید بهینه شده است، کامپایل می‌کند.

افزونه‌ی اندروید گریدل نسخه ۳.۰.۰ و بالاتر، به طور پیش‌فرض AAPT2 را فعال می‌کند. معمولاً نیازی نیست خودتان aapt2 فراخوانی کنید. با این حال، اگر ترجیح می‌دهید به جای اندروید استودیو از ترمینال و سیستم ساخت خودتان استفاده کنید، می‌توانید از AAPT2 از خط فرمان استفاده کنید. همچنین می‌توانید خطاهای ساخت مربوط به AAPT2 را از خط فرمان اشکال‌زدایی کنید. برای انجام این کار، AAPT2 را به عنوان یک ابزار مستقل در ابزارهای ساخت SDK اندروید نسخه ۲۶.۰.۲ و بالاتر پیدا کنید.

برای دانلود ابزارهای ساخت SDK اندروید از خط فرمان، از sdkmanager استفاده کنید و دستور زیر را اجرا کنید:

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

پس از دانلود ابزارهای ساخت SDK، AAPT2 را در android_sdk /build-tools/ version / پیدا کنید.

از آنجا که نسخه‌های جدید ابزارهای ساخت SDK اندروید اغلب منتشر نمی‌شوند، ممکن است نسخه AAPT2 موجود در ابزارهای ساخت SDK شما جدیدترین نباشد. برای دریافت آخرین نسخه AAPT2، AAPT2 را از Google Maven دانلود کنید .

برای استفاده از AAPT2 از طریق خط فرمان در لینوکس یا مک، دستور aapt2 را اجرا کنید. در ویندوز، دستور aapt2.exe را اجرا کنید.

AAPT2 با فعال کردن کامپایل افزایشی، از کامپایل سریع‌تر منابع پشتیبانی می‌کند. برای انجام کامپایل افزایشی، پردازش منابع به دو مرحله تقسیم می‌شود:

• کامپایل : فایل‌های منبع را به فرمت‌های دودویی کامپایل می‌کند.
• پیوند : تمام فایل‌های کامپایل شده را ادغام کرده و آنها را در یک بسته واحد بسته‌بندی می‌کند.

این جداسازی به بهبود عملکرد برای ساخت‌های افزایشی کمک می‌کند. برای مثال، اگر تغییراتی در یک فایل واحد وجود داشته باشد، فقط باید آن فایل را دوباره کامپایل کنید.

دانلود AAPT2 از گوگل ماون

برای دریافت جدیدترین نسخه AAPT2 که در ابزارهای ساخت وجود ندارد، AAPT2 را از مخزن Maven گوگل به شرح زیر دانلود کنید:

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

   برای مثال، برای دانلود نسخه ۳.۲.۰-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 از کامپایل کردن تمام انواع منابع اندروید ، مانند فایل‌های drawable و XML، پشتیبانی می‌کند. وقتی AAPT2 را برای کامپایل کردن فراخوانی می‌کنید، در هر فراخوانی، یک فایل منبع واحد را به عنوان ورودی ارسال کنید. سپس AAPT2 فایل را تجزیه کرده و یک فایل باینری میانی با پسوند .flat تولید می‌کند.

هنگام ارسال کل دایرکتوری‌ها، AAPT2 تمام فایل‌های موجود در دایرکتوری را حتی زمانی که فقط یک منبع تغییر کرده باشد، دوباره کامپایل می‌کند. اگرچه می‌توانید دایرکتوری‌های منبع حاوی بیش از یک فایل منبع را با استفاده از پرچم --dir به AAPT2 ارسال کنید، اما از مزایای کامپایل تدریجی منابع به این روش بهره‌مند نمی‌شوید.

انواع فایل‌های خروجی می‌توانند بسته به ورودی که برای کامپایل ارائه می‌دهید، متفاوت باشند، همانطور که در جدول زیر نشان داده شده است:

جدول ۱. انواع فایل‌های ورودی و خروجی برای کامپایل

فایل‌های خروجی AAPT2 قابل اجرا نیستند و شما باید بعداً این فایل‌های باینری را به عنوان ورودی در مرحله پیوند برای تولید APK وارد کنید. با این حال، فایل APK تولید شده قابل اجرا نیست که بتوانید بلافاصله آن را روی دستگاه اندروید مستقر کنید، زیرا حاوی فایل‌های 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/

همانطور که در جدول ۱ نشان داده شده است، نام فایل خروجی به نام فایل ورودی و نام دایرکتوری والد آن بستگی دارد.

برای مثال قبلی که فایل strings.xml به عنوان ورودی است، aapt2 به طور خودکار فایل خروجی را values-en_strings.arsc.flat نامگذاری می‌کند. با این حال، فایل drawable کامپایل شده که در دایرکتوری drawable ذخیره شده است، drawable_img.png.flat نامگذاری شده است.

گزینه‌های کامپایل

همانطور که در جدول 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.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 استفاده کنید:

جدول ۳. گزینه‌های دستور پیوند

تخلیه

dump برای چاپ اطلاعات مربوط به APK تولید شده با استفاده از دستور link استفاده می‌شود.

سینتکس روگرفت

سینتکس کلی استفاده از dump به صورت زیر است:

aapt2 dump sub-command filename.apk [options]

مثال زیر محتوا را از جدول منابع APK مشخص شده چاپ می‌کند:

aapt2 dump resources output.apk

زیردستورات را حذف کنید

یکی از زیردستورات زیر را با دستور dump مشخص کنید:

جدول ۴. زیردستورات dump

گزینه‌های تخلیه

از گزینه‌های زیر با dump استفاده کنید:

جدول 5. گزینه‌های تخلیه

تفاوت

از diff برای مقایسه دو APK و شناسایی هرگونه تفاوت بین آنها استفاده کنید.

نحو تفاوت

سینتکس کلی استفاده از diff به صورت زیر است:

aapt2 diff first.apk second.apk

هیچ گزینه‌ای برای دستور diff وجود ندارد.

بهینه سازی

optimize برای اجرای بهینه‌سازی‌ها روی منابع ادغام‌شده و resources.arsc قبل از بسته‌بندی آنها در APK استفاده می‌شود. این بهینه‌سازی می‌تواند اندازه APK را بسته به اندازه و تعداد منابعی که استفاده می‌شوند، حدود ۱ تا ۳ درصد کاهش دهد.

بهینه سازی سینتکس

سینتکس کلی استفاده از optimize به صورت زیر است:

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

مثال زیر منابع موجود در input.apk را بهینه می‌کند و یک APK جدید و بهینه‌شده در output.apk ایجاد می‌کند. این مثال، نمایش جدول مسطح معمول را با یک نمایش فشرده‌تر جایگزین می‌کند که منجر به کاهش اندازه APK، استفاده از حافظه و تأخیر راه‌اندازی و افزایش اندک زمان جستجوی منابع پس از راه‌اندازی می‌شود.

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

بهینه‌سازی گزینه‌ها

شما می‌توانید از گزینه‌های زیر با optimize استفاده کنید:

جدول 6. گزینه‌های بهینه‌سازی

تبدیل

به طور پیش‌فرض، دستور compile AAPT منابع را به فرمت دودویی که برای APKها مناسب است، کامپایل می‌کند. همچنین می‌توان با مشخص کردن --proto-format فرمت protobuf را که برای AABها مناسب است، مشخص کرد. دستور 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. گزینه‌های تبدیل

حالت دیمون

نسخه ۲.۱۹ نرم‌افزار AAPT حالت دیمون (daemon mode) را برای صدور دستورات معرفی کرد. حالت دیمون به شما امکان می‌دهد چندین دستور را در یک جلسه 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/

این دستورات را می‌توان در حالت 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، --trace-folder folder ‎ است که یک قطعه ردیابی systrace JSON به folder مشخص شده تولید می‌کند.

نسخه

نسخه AAPT2 مورد استفاده خود را با دستور version تعیین کنید:

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

تغییر رفتار هنگام استفاده از AAPT2

قبل از AAPT2، AAPT نسخه پیش‌فرض ابزار بسته‌بندی دارایی‌های اندروید بود که اکنون منسوخ شده است. اگرچه AAPT2 باید بلافاصله با پروژه‌های قدیمی‌تر کار کند، این بخش برخی از تغییرات رفتاری را که باید از آنها آگاه باشید، شرح می‌دهد.

سلسله مراتب عناصر در مانیفست اندروید

در نسخه‌های قبلی 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 شما به درستی تو در تو قرار گرفته‌اند. برای اطلاعات بیشتر، نمای کلی App 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> ، والد آن نیز باید از نوع منبع 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 اندروید ساخته شده است، وابستگی دارد، ممکن است برنامه شما در زمان اجرا بدون نمایش هیچ خطا یا هشداری از کار بیفتد. این از کار افتادن ممکن است به این دلیل رخ دهد که در طول ایجاد کتابخانه، فیلدهای R.java final اعلام شده‌اند. در نتیجه، تمام شناسه‌های منابع در کلاس‌های کتابخانه به صورت درون‌خطی (inline) قرار می‌گیرند.

AAPT2 به این متکی است که هنگام ساخت برنامه شما، شناسه‌ها را به منابع کتابخانه مجدداً اختصاص دهد. اگر کتابخانه فرض کند که شناسه‌ها final هستند و آنها را در DEX کتابخانه به صورت درون‌خطی قرار دهد، عدم تطابق زمان اجرا رخ می‌دهد.

برای رفع این خطا، با نویسنده کتابخانه تماس بگیرید تا کتابخانه را با استفاده از آخرین نسخه ابزارهای ساخت SDK اندروید بازسازی کند و کتابخانه را دوباره منتشر کند.