راهنماها

ارسال قوانین حفظ هوشمندتر: چگونه ارائه‌دهندگان کتابخانه می‌توانند بهینه‌سازی کد DEX در سطح برنامه را رفع انسداد کنند

‫۶ دقیقه خواندن
مشاهده نمایه Breana Tate
Breana Tate مهندس روابط توسعه‌دهندگان

به‌عنوان توسعه‌دهندگان برنامه و کتابخانه Android، همه ما برای یک هدف تلاش می‌کنیم: برنامه‌هایی با عملکرد خوب که تجربه کاربری روانی ارائه می‌دهند. بخش عمده‌ای از آن شامل R8، بهینه‌ساز برنامه Android، می‌شود. R8 با برداشتن کد استفاده‌نشده و بهینه‌سازی و مبهم‌سازی بقیه کد، عملکرد برنامه را بهبود می‌بخشد.

Google Play اخیراً آستانه‌های جدید بهینه‌سازی کد DEX را برای برنامه‌ها و بازی‌ها اعلام کرده است که به بهبود زمان راه‌اندازی، کاهش ردپای حافظه، و همسویی با تعهد Android برای محافظت از تجربه کاربری دربرابر برنامه‌هایی که از حافظه اضافی استفاده می‌کنند کمک می‌کند. درحالی‌که این آستانه‌ها برای برنامه‌ها و بازی‌ها اعمال می‌شود، برآورده کردن آن‌ها مسئولیتی مشترک در سراسر بوم‌سازگان است—R8 فقط می‌تواند برنامه‌ای را در چارچوب پارامترهایی که به آن داده شده است بهینه‌سازی کند، که شامل قوانین نگهداری است که توسط کتابخانه‌هایی که برنامه به آن‌ها وابسته است بسته‌بندی شده‌اند.

R8 Configuration Analyzer ابزار فوق‌العاده‌ای برای ارزیابی بهینه‌سازی برنامه، کوچک‌سازی، و درصد مبهم‌سازی است که در هسته الزامات فنی Google Play قرار دارند. علاوه‌بر ردیابی این درصدها، «تحلیل‌گر پیکربندی R8» قوانین حفظ ناکارآمدی را که نه تنها از برنامه‌ها بلکه از قوانین حفظ مصرف‌کننده که در کتابخانه‌هایی که برنامه‌ها به آن‌ها وابسته هستند بسته‌بندی شده‌اند، نشان می‌دهد.

این راهنما توضیح می‌دهد که چگونه می‌توانید برخی‌از رایج‌ترین چالش‌هایی را که ارائه‌دهندگان کتابخانه با آن‌ها مواجه هستند حل کنید و قوانین محدود و با عملکرد بالا را ارسال کنید تا به مشتریانتان کمک کنید الزامات فنی Google Play را برآورده کنند.

قوانین نگهداری مصرف‌کننده چیست؟

قوانین نگهداری مصرف‌کننده دستورالعمل‌هایی هستند که در کتابخانه Android یا JAR گنجانده شده‌اند و به R8 می‌گویند کدام بخش‌های کد کتابخانه ممکن است درطول فرایند کامپایل در سطح برنامه بهینه‌سازی نشوند. برخلاف قوانین نگهداری استاندارد که توسط برنامه یا کتابخانه مورداستفاده در کوچک‌سازی مصنوعات آن‌ها نوشته شده است، قوانین نگهداری مصرف‌کننده در داخل کتابخانه‌ها جاسازی شده‌اند و بر نحوه کوچک‌سازی کتابخانه درطول بهینه‌سازی کل برنامه تأثیر می‌گذارند. این امر تضمین می‌کند که اهداف بازتاب داخلی و میاناهای بومی دست‌نخورده باقی بمانند، بدون اینکه توسعه‌دهنده برنامه نیاز به شناسایی دستی آن‌ها داشته باشد.

قوانین نگهداری مصرف‌کننده با دامنه محدود و هدفمند روال مطلوب مهمی است که هم برای کتابخانه و هم برای برنامه‌هایی که از آن استفاده می‌کنند مفید است. قوانین نگهداری مصرف‌کننده که بیش‌ازحد گسترده باشند، کدهای استفاده‌نشده را حفظ می‌کنند و درنتیجه بر بهینه‌سازی و عملکرد برنامه تأثیر می‌گذارند. با اضافه شدن اطلاعات آماری بهینه‌سازی کد DEX به «کنسول Play»، سنجه‌هایی که توسعه‌دهندگان برنامه خواهند دید نشان‌دهنده تأثیر ترکیبی قوانین هم از برنامه و هم از کتابخانه‌های ادغام‌شده آن است.

ایجاد توازن بین پایداری و عملکرد

ارائه‌دهندگان کتابخانه اغلب با نیت خوب قوانین نگهداری گسترده مصرف‌کننده را ارسال می‌کنند. هیچ‌کس نمی‌خواهد کیت توسعه نرم‌افزارش به‌دلیل حذف کلاس درطول بازتاب باعث خرابی شود. 

بااین‌حال، قوانین نگهداری گسترده یا در سطح بسته به‌عنوان راه‌حل بلندمدت برای جلوگیری از خرابی توصیه نمی‌شود، زیرا پتانسیل بهینه‌سازی برنامه R8 را به‌شدت محدود می‌کند. در اینجا چند استراتژی توصیه‌شده برای کمک به شما در ارائه قوانین محدود و با عملکرد بالا بدون فدا کردن پایداری آورده شده است:

۱. آزمایش و عرضه قوانین محدود

برای کمک به شما در انتشار مطمئن قوانین محدود، این روال‌های مطلوب را درنظر بگیرید:

  • آزمایش در برنامه نمونه: راهنمای آزمایش محلی در آزمایش بهینه‌سازی برای برنامه‌های نمونه نیز اعمال می‌شود. پس‌از فعال کردن R8، مسیرهای قطعی کاربر را آزمایش کنید تا مطمئن شوید عملکرد طبق انتظار کار می‌کند.
  • R8 Configuration Analyzer را در برنامه نمونه‌تان اجرا کنید تا ببینید توسعه‌دهندگان نرم‌افزار هنگام ممیزی پیکربندی R8 خود چه چیزی می‌بینند. این ویژگی به شما امکان می‌دهد تأثیرات قوانین نگهداری را به‌راحتی در برنامه‌های پایین‌دستی تجسم کنید.
  • از فرمان تجزیه‌وتحلیل از Android CLI برای ارزیابی بهینه‌سازی AAR یا JAR خود، ازجمله روش‌ها، کلاس‌ها، و فیلدهای حفظ‌شده استفاده کنید. می‌توانید این اعداد را در نسخه‌های پخش مقایسه کنید تا پس‌رفت‌ها را پایش کنید.
  • استفاده از نسخه کتابخانه و خرابی‌ها را در «کنسول کیت توسعه نرم‌افزار Google Play» پایش کنید.
  • برای روال‌های مطلوب، به راهنمای بهینه‌سازی برای نویسندگان کتابخانه و اسناد R8 مراجعه کنید.

۲. حفظ بازتاب و هدف‌های JNI بدون قوانین نگهداری گسترده

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

اگر کیت توسعه نرم‌افزار شما کد بومی را هدف قرار می‌دهد، مثل کد بومی در بازی‌ها یا ویرایشگرهای عکس و ویدیو، برای همه کلاس‌هایی که از JNI استفاده می‌کنند قانون ارائه دهید. بیشتر بازی‌ها روی موتورهای بازی مثل Unity و Unreal اجرا می‌شوند که بازی را به کد بومی تبدیل می‌کنند. کد بومی بازی و افزونه شما ازطریق فراخوانی‌های JNI با چارچوب Android ارتباط برقرار می‌کنند.

حاشیه‌نویسی‌های Jetpack Keep که اکنون در نسخه آلفا است، می‌تواند با امکان حاشیه‌نویسی استفاده از بازتاب، به کاهش نگهداری موردنیاز بازتاب کمک کند. سپس می‌توان از این حاشیه‌نویسی‌ها برای تولید قوانین حفظ در زمان ساخت استفاده کرد.

بهتر است از codegen به‌جای reflection استفاده کنید

برای جلوگیری از خرابی به‌دلیل بازتاب، مهم‌ترین نکته ما این است که از بازتاب اجتناب کنید و درصورت امکان از codegen استفاده کنید. 

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

بااین‌حال، codegen برای همه سناریوها انتخاب مناسبی نیست. برای الگوهایی مانند وابستگی‌های اختیاری، بازتاب همچنان ضروری است. توصیه می‌کنیم بازتاب را با قوانین نگهداری محدود که فقط از نقاط ورودی موردنیاز محافظت می‌کنند جفت کنید، همان‌طور که در راهنمای بازتاب برای پشتیبانی از وابستگی‌های اختیاری شرح داده شده است. 

قوانین را به‌طور دقیق تعریف کنید، حتی برای ساخت‌های کتابخانه ازپیش بهینه‌شده

اگر امکان اجتناب از بازتاب وجود ندارد، مطمئن شوید که قوانین نگهداری مصرف‌کننده شما فقط آنچه را که کتابخانه شما بازتاب می‌دهد مشخص می‌کند. وقتی کتابخانه شما به‌طور پویا به کلاس یا روشی دسترسی پیدا می‌کند، فقط باید نقطه ورودی را مشخص کنید و R8 بقیه کارها را انجام می‌دهد. R8 از نقاط ورودی برای ساختن نموداری از کد ارجاع‌شده و برداشتن کلاس‌ها، روش‌ها، و فیلدهای ارجاع‌نشده استفاده می‌کند.

این امر همچنین درصورتی اعمال می‌شود که قبلاً ساخت کتابخانه خود را بهینه‌سازی یا مبهم کرده باشید، که این کار روشی عالی برای اطمینان از عملکرد خوب و سبک بودن کیت توسعه نرم‌افزار است. چون قوانین شما درطول مرحله همگردانی برنامه اعمال می‌شود، R8 همچنان می‌تواند کتابخانه شما را براساس کلاس‌ها و روش‌های واقعی که توسط برنامه پایین‌دست استفاده می‌شود بیشتر بهینه‌سازی کند. فرمان تجزیه‌وتحلیل میانای خط فرمان Android به‌طور پیش‌کنشی قوانین نگهداری در سطح بسته را که هم استفاده شده‌اند و هم استفاده نشده‌اند و در بهینه‌سازی مسدودشده نقش دارند نشان می‌دهد.

قوانین حفظ کردن را برای وابستگی‌های طرف سوم به‌طور محدود تعریف کنید

این الگوی رایجی است که دیده‌ایم:

-keep public class com.google.android.gms.** { *; }

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

هنگام فراخوانی کتابخانه‌های خارجی، باید قوانین نگهداری را به‌گونه‌ای طراحی کنید که فقط عناصر خاصی را که کتابخانه شما ازطریق بازتاب به آن‌ها دسترسی دارد به‌طور دقیق حفظ کنند. علاوه‌براین، واقعیت این است که بسیاری‌از کتابخانه‌ها (ازجمله GMS) درحال‌حاضر قوانین نگهداری مصرف‌کننده خودشان را ارسال می‌کنند – معرفی قانون نگهداری در سطح بسته می‌تواند قوانین مصرف‌کننده با دامنه محدود را که به‌دقت نوشته شده‌اند از کتابخانه پایین‌دست نیز دربرگیرد.

قوانین نگهداری مشروط را برای آداپتورهای میانجی‌گری آگهی درنظر بگیرید 

اگر کتابخانه آگهی شما بااستفاده از آداپتورهای میانجی‌گری بار می‌شود، قوانین حفظ محدود همچنان یک گزینه است. در این سناریو، توصیه می‌کنیم از قوانین نگهداری شرطی استفاده کنید تا فقط ویژگی‌ها یا قالب‌های خاصی را حفظ کنید، درصورتی‌که برنامه شامل آداپتور مربوطه باشد. این کار تضمین می‌کند که R8 همچنان می‌تواند ویژگی‌هایی را که برنامه استفاده نمی‌کند کوچک کند. به‌عنوان گزینه‌ای دیگر، به‌جای نوشتن دستی قوانین پیچیده، می‌توانید از حاشیه‌نویسی‌های Jetpack Keep نیز برای حاشیه‌نویسی تماس‌های بازتابی خود مستقیماً در کد منبع و تولید خودکار قوانین نگهداری مصرف‌کننده شرطی، ازجمله برای ماژول‌های برافزای اختیاری، استفاده کنید.

قوانین را در قوانین مصرف‌کننده ارسال کنید، نه در اسناد

با ارسال قوانین مصرف‌کننده همراه با کتابخانه‌تان، مطمئن می‌شوید که برنامه‌های دارای ساخت فعال‌شده با R8 می‌توانند از کتابخانه‌تان به‌صورت آماده استفاده کنند و به حداکثر بهینه‌سازی دست یابند. 

مشخص کردن قوانین در اسناد شما باعث ایجاد اصطکاک در راه‌اندازی دستی می‌شود (به‌ویژه ازآنجایی‌که قوانین نگهداری مصرف‌کننده بسته‌بندی‌شده سال‌ها است که در AAR و JAR پشتیبانی می‌شوند) و سربار نگهداری مداوم ایجاد می‌کند. وقتی کتابخانه‌تان را به‌روز می‌کنید (ازجمله بازسازی کد، تغییر نام کلاس‌ها، و تغییر نحوه استفاده از بازتاب)، باید به‌روزرسانی اسناد را فراموش نکنید و برنامه‌ها باید بررسی قوانین جدید را فراموش نکنند. با گذشت زمان، وقتی برنامه‌ها ازطریق چندین نسخه کتابخانه شما ارتقا می‌یابند، ممکن است قوانین حفظ قدیمی را که دیگر موردنیاز نیستند جمع‌آوری کنند و این امر منجر به تورم غیرضروری برنامه شود.

۳. درحال خواندن ردیابی‌های پشته‌ای نسخه پخش

ممکن است به‌دلیل کد مبهم با ردیابی پشته ناخوانا مواجه شده باشید. برای رفع انسداد تحلیل‌های حیاتی، ممکن است وسوسه شوید از keepnames استفاده کنید که امکان کوچک کردن را فراهم می‌کند، اما از بهینه‌سازی‌های اضافی مانند تغییر نام در برنامه مصرف‌کننده جلوگیری می‌کند—دقیقاً همان مقادیری که هنگام اشکال‌زدایی ردیابی پشته‌ای به آن‌ها نیاز دارید. 

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

Firebase Crashlytics، «کنسول Play»، و Logcat در «استودیو Android» رد پشته را برای توسعه‌دهندگان نرم‌افزار ابهام‌زدایی می‌کنند. این یعنی اگر توسعه‌دهنده نرم‌افزار ردیابی پشته‌ای را با شما هم‌رسانی کند، برای اینکه بتوانید آن را بخوانید نیازی نیست از مبهم‌سازی جلوگیری کنید.

اگر فایل نگاشتتان را در «کنسول کیت توسعه نرم‌افزار» بارگذاری کنید، به شما امکان می‌دهد ردیابی‌های پشته‌ای ابهام‌زدایی‌شده را در کنسول کیت توسعه نرم‌افزار ببینید.

بهینه‌سازی را بدون حدس و گمان انجام دهید

بهینه‌سازی کتابخانه نباید مثل بازی آزمون و خطا باشد.

با حفظ قوانین نگهداری مصرف‌کننده، ارائه‌دهندگان کتابخانه می‌توانند مطمئن شوند که برنامه‌ها در سراسر بوم‌سازگان از بهینه‌سازی رفع انسداد می‌شوند.

وقتی کتابخانه‌ها قوانین بهتری ارائه می‌دهند، برنامه‌ها کوچک‌تر و سریع‌تر می‌شوند. همین امروز ممیزی قوانین نگهداری مصرف‌کننده را شروع کنید تا به برنامه‌هایی که به کتابخانه شما وابسته هستند کمک کنید بهترین عملکرد را داشته باشند.

نویسنده:
ادامه خواندن