إضافة خيارات عامة

توفّر R8 خيارات عامة تعدّل تحسينات R8 في جميع أنحاء التطبيق أو تؤثّر في كل قاعدة keep. يتم الاحتفاظ بهذه الخيارات في ملف proguard-rules.pro، بالإضافة إلى قواعد الاحتفاظ بالبيانات. تتيح بعض هذه الخيارات العامة ضبط إعدادات تحسين إضافية، بينما توقف خيارات أخرى جوانب معيّنة من التحسين.

خيارات عامة لتحسين إضافي

تتيح الخيارات العامة التالية إجراء تحسينات إضافية:

• ‫-repackageclasses [<optional-package-name>]: إعادة تجميع الفئات في حزمة واحدة لتقليل حجم التطبيق إذا لم تقدّم اسم الحزمة الاختياري، سيتم نقل الفئات إلى حزمة تلقائية بدون اسم. هذا هو الإعداد المقترَح للتطبيقات لأنّه يؤدي إلى إنشاء ملفات DEX أصغر حجمًا من خلال حذف بادئة الحزمة من أسماء الفئات.
• -allowaccessmodification: يتيح هذا الخيار لبرنامج R8 تغيير مستوى ظهور الفئات والحقول والطُرق (عادةً ما يتم توسيع نطاق الظهور) لإجراء عمليات تحسين أكثر شمولاً. يتم تفعيلها عند استخدام proguard-android-optimize.txt. منذ الإصدار 8.2 من المكوّن الإضافي لنظام Gradle المتوافق مع Android، أصبح هذا الإعداد هو الإعداد التلقائي في حال تفعيل التحسين الكامل باستخدام R8.

• ‫-processkotlinnullchecks [level]: تتيح هذه السمة لبرنامج R8 تغيير عمليات التحقّق من قيمة Kotlin Intrinsics لتصبح إما إزالة رسالة الخطأ فقط أو إزالة عملية التحقّق من القيمة الفارغة بشكل كامل.

  تؤدي قيم level، مرتّبة من الأضعف إلى الأقوى، إلى التأثير التالي:

  • لا يؤدي keep إلى تغيير عمليات التحقّق.
  • تعيد remove_message كتابة كل استدعاء لطريقة التحقّق إلى استدعاء getClass() في الوسيطة الأولى للاستدعاء (مع الاحتفاظ فعليًا بالتحقّق من القيمة الخالية، ولكن بدون أي رسالة).
  • تؤدي remove إلى إزالة علامات الاختيار تمامًا.

  يستخدم R8 remove_message تلقائيًا. ويحلّ أي تحديد لسمة -processkotlinnullchecks محلّ ذلك. في حال تحديدها عدة مرات، سيتم استخدام القيمة الأقوى.

  تتوفّر -processkotlinnullchecks بدءًا من الإصدار 9.0.0 من Android Gradle Plugin.

في ما يلي مثال على إعدادات تم تفعيل ميزة التحسين الإضافي فيها:

-repackageclasses
-allowaccessmodification

خيارات عامة للحدّ من التحسين

تتيح لك الخيارات العامة التالية إيقاف جوانب معيّنة من تحسين التطبيق، وهي مفيدة عند تحسين قواعد الاحتفاظ أو تفعيل R8 لأول مرة.

• ‫-dontoptimize: يمنع تحسين الرمز، مثل تضمين الدوال البرمجية. يمكن استخدام هذا الخيار أثناء التطوير، ولكن لا يجب استخدامه في الإصدارات المخصّصة للإنتاج.
• ‫-dontshrink: يمنع إزالة الرمز غير المرجعي وتحسين الرمز. يمكن استخدام هذا الخيار أثناء التطوير، ولكن يجب عدم استخدامه في إصدارات الإنتاج.
• -dontobfuscate: يمنع تقصير أسماء الفئات والطرق. ويمكن أن يكون إيقاف التشويش مفيدًا بشكل خاص أثناء تصحيح الأخطاء لتسهيل قراءة عمليات تتبُّع تسلسل استدعاء الدوال البرمجية. يمكن استخدام هذا الخيار أثناء التطوير، ولكن يجب عدم استخدامه في إصدارات الإنتاج.
• ‫-keepattributes <attributes>: تقبل قائمة مفصولة بفواصل تتضمّن السمات التي يجب الحفاظ عليها. في حال عدم استخدام proguard-android-optimize.txt التلقائي، يزيل R8 جميع السمات، بما في ذلك RuntimeVisibleAnnotations وSignature، ولكن قد يكون من المفيد الاحتفاظ بهذه السمات إذا كانت مطلوبة في حالات مثل الانعكاس. للحصول على قائمة بالسمات التي يمكنك تحديدها، اطّلِع على السمات التي يجب الاحتفاظ بها.

إبقاء السمات

السمات هي معلومات إضافية مرتبطة بأجزاء مختلفة من الرمز. تخزّن السمات معلومات مثل التعليقات التوضيحية والتوقيعات العامة من الرمز البرمجي.

تتطلّب بعض العمليات الانعكاسية الاحتفاظ بسمات معيّنة لتنفيذها بنجاح. مثلاً:

• عند الوصول إلى بنية الفئة الداخلية أو الخارجية باستخدام getEnclosingMethod() أو getDeclaredClasses()، يجب توفُّر السمتَين EnclosingMethod وInnerClasses.
• عند الوصول إلى التوقيعات العامة باستخدام getTypeParameters()، يجب توفير السمة Signature.

• عند الوصول إلى التعليقات التوضيحية باستخدام getAnnotation()، يجب تضمين السمة RuntimeVisibleAnnotations.

السمات المطلوبة بشكل شائع

عند استخدام ملف Proguard التلقائي (proguard-android-optimize.txt أو proguard-android.txt)، يحتفظ المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) بالسمات التالية. يُرجى العِلم أنّ بعض هذه السمات تتطلّب إصدارات أحدث من "مكوّن Android الإضافي في Gradle":

بالنسبة إلى التطبيقات التي تستخدم proguard-android-optimize.txt، تكون قواعد الاحتفاظ المحدّدة من خلال "منصة Google Play" كافية في معظم السيناريوهات. ومع ذلك، إذا كنت تكتب رمزًا برمجيًا لمكتبة، عليك تحديد جميع السمات التي تتطلبها مكتبتك في قواعد الاحتفاظ بالمستهلك، حتى إذا كانت محددة في هذه القائمة. يضمن ذلك أن تكون مكتبتك قوية في حال قرّر المطوّرون عدم تضمين proguard-android-optimize.txt.

سمات إضافية يجب الاحتفاظ بها

يمكنك تحديد سمات إضافية ليتم الاحتفاظ بها، ولكن لا حاجة إليها في معظم حالات الوصول إلى البيانات باستخدام انعكاس أو JNI. ومع ذلك، قد يظل يتم استخدام بعض هذه الملفات بشكل متكرّر أثناء تحسين المكتبات.