گزینه های جهانی را اضافه کنید

R8 گزینه‌های جهانی را ارائه می‌کند که یا بهینه‌سازی‌های R8 را در سراسر برنامه تغییر می‌دهند یا بر هر قانون حفظ تأثیر می‌گذارند. این گزینه ها در فایل proguard-rules.pro همراه با قوانین حفظ نگهداری می شوند. تعدادی از این گزینه‌های کلی بهینه‌سازی اضافی را پیکربندی می‌کنند، در حالی که برخی دیگر جنبه‌های خاصی از بهینه‌سازی را خاموش می‌کنند.

گزینه های جهانی برای بهینه سازی اضافی

گزینه های جهانی زیر بهینه سازی اضافی را فعال می کنند:

• -repackageclasses [<optional-package-name>] : برای کاهش بیشتر اندازه برنامه، کلاس‌ها را در یک بسته مشخص شده مجدداً بسته‌بندی می‌کند. اگر نام بسته اختیاری را وارد نکنید، کلاس ها به بسته خالی و پیش فرض منتقل می شوند. این یک تنظیم توصیه شده برای برنامه ها است.
• -allowaccessmodification : به R8 اجازه می‌دهد تا دید کلاس‌ها، فیلدها و روش‌ها را تغییر دهد (معمولاً گسترده‌تر شود) تا بهینه‌سازی‌های گسترده‌تری انجام دهد. وقتی proguard-android-optimize.txt استفاده می شود فعال می شود. از آنجایی که Android Gradle Plugin (AGP) 8.2 است، اگر از R8 در حالت کامل استفاده می کنید، این پیکربندی پیش فرض است.

در زیر نمونه ای از پیکربندی با بهینه سازی اضافی فعال شده است:

-repackageclasses
-allowaccessmodification

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

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

• -dontoptimize : از بهینه‌سازی کد جلوگیری می‌کند، به‌عنوان مثال درون‌سازی روش. این گزینه را می توان در طول توسعه استفاده کرد اما نباید در ساخت های تولیدی استفاده شود.
• -dontshrink : از حذف کدهای ارجاع نشده و بهینه سازی کد جلوگیری می کند. این گزینه را می توان در طول توسعه استفاده کرد اما نباید در ساخت های تولیدی استفاده شود.
• -dontobfuscate : از کوتاه شدن نام کلاس ها و متدها جلوگیری می کند. خاموش کردن مبهم‌سازی در حین اشکال‌زدایی می‌تواند مفید باشد تا ردپای پشته‌ها راحت‌تر خوانده شوند. این گزینه را می توان در طول توسعه استفاده کرد اما نباید در ساخت های تولیدی استفاده شود.
• -keepattributes <attributes> : فهرستی از ویژگی‌های جدا شده با کاما را می‌پذیرد که باید حفظ شوند. اگر از پیش‌فرض proguard-android-optimize.txt استفاده نمی‌کنید ، R8 تمام ویژگی‌ها از جمله RuntimeVisibleAnnotations و Signature را حذف می‌کند، اما حفظ این ویژگی‌ها در صورت نیاز در مواردی مانند بازتاب می‌تواند مفید باشد. برای فهرستی از ویژگی‌هایی که می‌توانید مشخص کنید، ویژگی‌های Keep را ببینید.

صفات را حفظ کنید

ویژگی ها قطعات اضافی اطلاعاتی هستند که به قسمت های مختلف کد شما متصل می شوند. ویژگی ها اطلاعاتی مانند حاشیه نویسی و امضاهای عمومی را از کد شما ذخیره می کنند.

برخی از عملیات بازتابی برای اجرای موفقیت آمیز نیاز به ویژگی های خاصی دارند. به عنوان مثال:

• هنگام دسترسی به ساختار کلاس داخلی یا خارجی با استفاده از getEnclosingMethod() یا getDeclaredClasses() ، ویژگی های EnclosingMethod و InnerClasses مورد نیاز است.
• هنگام دسترسی به امضاهای عمومی با استفاده از getTypeParameters() ، ویژگی Signature مورد نیاز است.

• هنگام دسترسی به حاشیه نویسی با استفاده از getAnnotation() ، ویژگی RuntimeVisibleAnnotations مورد نیاز است.

ویژگی های معمولا مورد نیاز

هنگام استفاده از فایل پیش‌فرض Proguard ( proguard-android-optimize.txt یا proguard-android.txt )، افزونه Android Gradle (AGP) ویژگی‌های زیر را حفظ می‌کند. توجه داشته باشید که برخی از این ویژگی ها به نسخه های جدیدتر AGP نیاز دارند:

برای برنامه هایی که از proguard-android-optimize.txt استفاده می کنند، قوانین حفظ تعریف شده توسط AGP در اکثر سناریوها کافی است. با این حال، اگر در حال نوشتن کد برای یک کتابخانه هستید، باید تمام ویژگی های مورد نیاز کتابخانه خود را در قوانین نگهداری مصرف کننده آن مشخص کنید، حتی اگر در این لیست تعریف شده باشند. اگر توسعه‌دهندگان تصمیم بگیرند که proguard-android-optimize.txt را اضافه نکنند، این اطمینان حاصل می‌کند که کتابخانه شما قوی است.

ویژگی های اضافی نگهداری

می‌توانید ویژگی‌های اضافی را برای نگهداری مشخص کنید، اما برای اکثریت قریب به اتفاق سناریوهای دسترسی بازتابی یا JNI مورد نیاز نیستند. با این حال، برخی از این موارد ممکن است اغلب در حین بهینه سازی کتابخانه ها استفاده شوند.