الإصدار 3.4.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" (أبريل 2019)

يتطلّب هذا الإصدار من المكوّن الإضافي المتوافق مع Android ما يلي:

الميزات الجديدة

• إعدادات جديدة لتبعيات فحص أداة Lint: تغيّر سلوك lintChecks وتم تقديم إعداد جديد للتبعيات، وهو lintPublish، لمنحك مزيدًا من التحكّم في عمليات فحص أداة Lint التي يتم تجميعها في مكتبات Android.

  • lintChecks: هذا إعداد حالي يجب استخدامه لعمليات فحص أداة Lint التي تريد تشغيلها فقط عند إنشاء مشروعك محليًا. إذا كنت تستخدم سابقًا إعداد تبعية lintChecks لتضمين عمليات فحص أداة Lint في ملف AAR المنشور، عليك نقل هذه التبعيات لاستخدام إعداد lintPublish الجديد الموضّح أدناه بدلاً من ذلك.
  • lintPublish: استخدِم هذا الإعداد الجديد في مشاريع المكتبة لعمليات فحص أداة Lint التي تريد تضمينها في ملف AAR المنشور، كما هو موضّح أدناه. وهذا يعني أنّ المشاريع التي تستخدم مكتبتك تطبّق أيضًا عمليات فحص أداة Lint هذه.

  يستخدم عينة التعليمات البرمجية التالية كلا إعدادات الاعتمادية في مشروع مكتبة Android محلي.

  dependencies {
    // Executes lint checks from the ':lint' project at build time.
    lintChecks project(':lint')
    // Packages lint checks from the ':lintpublish' in the published AAR.
    lintPublish project(':lintpublish')
  }
          

  dependencies {
    // Executes lint checks from the ':lint' project at build time.
    lintChecks(project(":lint"))
    // Packages lint checks from the ':lintpublish' in the published AAR.
    lintPublish(project(":lintpublish"))
      }
          

  • بوجه عام، من المفترض أن تشهد مهام التغليف والتوقيع تحسينًا عامًا في سرعة الإنشاء. إذا لاحظت تراجعًا في الأداء مرتبطًا بـ هذه المهام، يُرجى الإبلاغ عن خطأ.

تغييرات في السلوك

• تحذير بشأن إيقاف المكوّن الإضافي للميزات في "تطبيقات Android فورية" : إذا كنت لا تزال تستخدم com.android.feature لإنشاء تطبيقك الفوري، سيظهر لك تحذير بشأن إيقافه في الإصدار 3.4.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android". للتأكّد من أنّه لا يزال بإمكانك إنشاء تطبيقك الفوري على الإصدارات المستقبلية من المكوّن الإضافي، عليك نقل تطبيقك الفوري لاستخدام المكوّن الإضافي للميزات الديناميكية، ما يتيح لك أيضًا نشر كلٍّ من تجارب التطبيق المثبَّت والتطبيق الفوري من مجموعة حزمات تطبيق Android واحدة.

• تفعيل R8 تلقائيًا: يدمج R8 عمليات إزالة السكر، وتقليص الحجم، وإخفاء الرموز، والتحسين، والتحويل إلى تنسيق DEX في خطوة واحدة، ما يؤدي إلى تحسينات ملحوظة في أداء عملية الإنشاء. تم تقديم R8 في الإصدار 3.3.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"، وهو مفعَّل الآن تلقائيًا لكلٍّ من مشاريع التطبيقات ومكتبات Android التي تستخدم الإصدار 3.4.0 من المكوّن الإضافي والإصدارات الأحدث.

تقدّم الصورة أدناه نظرة عامة عالية المستوى على عملية التجميع قبل تقديم R8.

باستخدام R8، يتم الآن إكمال عمليات إزالة السكر، وتقليص الحجم، وإخفاء الرموز، والتحسين، والتحويل إلى تنسيق DEX (D8) يتم إكمالها جميعًا في خطوة واحدة، كما هو موضّح أدناه.

يُرجى العِلم أنّ R8 مصمّم للعمل مع قواعد ProGuard الحالية، لذا من المحتمل ألا تحتاج إلى اتّخاذ أي إجراءات للاستفادة من R8. ومع ذلك، بما أنّه يختلف عن ProGuard ومصمّم خصيصًا لمشاريع Android، قد يؤدي تقليص الحجم والتحسين إلى إزالة رموز برمجية قد لا يزيلها ProGuard. لذا، في هذه الحالة غير المحتملة، قد تحتاج إلى إضافة قواعد إضافية للحفاظ على هذه الرموز البرمجية في ناتج عملية الإنشاء.

إذا واجهت مشاكل في استخدام R8، يُرجى قراءة الـ أسئلة الشائعة حول توافق R8 لمعرفة ما إذا كان هناك حل لمشكلتك. إذا لم يتم توثيق حل، يُرجى الإبلاغ عن خطأ. يمكنك إيقاف R8 عن طريق إضافة أحد السطرَين التاليَين إلى ملف مشروعك gradle.properties:

      # Disables R8 for Android Library modules only.
      android.enableR8.libraries = false
      # Disables R8 for all modules.
      android.enableR8 = false
      
    

ملاحظة: بالنسبة إلى نوع تصميم معيّن، إذا ضبطت useProguard على false في ملف build.gradle الخاص بوحدة تطبيقك، سيستخدم "المكوّن الإضافي لنظام Gradle المتوافق مع Android" أداة R8 لتقليص حجم الرموز البرمجية لتطبيقك لهذا النوع من التصميم، بغض النظر عمّا إذا أوقفت R8 في ملف gradle.properties الخاص بمشروعك.

• ndkCompile تم إيقافه: سيظهر لك الآن خطأ في عملية الإنشاء إذا حاولت استخدام ndkBuild لتجميع مكتباتك المجمّعة من رموز برمجية أصلية. بدلاً من ذلك، عليك استخدام CMake أو ndk-build لإضافة رموز برمجية بلغتَي C وC++ إلى مشروعك.

المشاكل المعروفة

• لا يتم حاليًا فرض الاستخدام الصحيح لأسماء الحِزم الفريدة ولكن سيتم فرض ذلك بشكل أكثر صرامة في الإصدارات اللاحقة من المكوّن الإضافي. في الإصدار 3.4.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"، يمكنك الموافقة على التحقّق ممّا إذا كان مشروعك يعلن عن أسماء حِزم مقبولة عن طريق إضافة السطر أدناه إلى ملف gradle.properties الخاص بك.

            android.uniquePackageNames = true
            
          

  لمزيد من المعلومات عن ضبط اسم الحزمة من خلال "المكوّن الإضافي لنظام Gradle المتوافق مع Android" يُرجى الاطّلاع على مقالة ضبط معرّف التطبيق.