الإصدار 3.2.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android (أيلول/سبتمبر 2018)

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

3.2.1 (تشرين الأول/أكتوبر 2018)

من خلال هذا التحديث، لن يكون عليك تحديد إصدار من "أدوات إصدار SDK". يستخدم المكوّن الإضافي لنظام Gradle المتوافق مع Android الآن الإصدار 28.0.3 تلقائيًا.

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

  • إتاحة إنشاء تنسيق "مجموعة حزمات تطبيق Android": حِزمة التطبيق هي تنسيق جديد للتحميل يشمل جميع الموارد والرموز البرمجية المجمَّعة الخاصة بتطبيقك، مع تأجيل إنشاء حزمة APK وتسجيل الدخول إلى "متجر Google Play". لم يعُد من الضروري إنشاء حِزم APK متعددة وتوقيعها وإدارتها، وسيحصل المستخدمون على عمليات تنزيل أصغر حجمًا ومحسّنة لأجهزتهم. لمزيد من المعلومات، يمكنك الاطّلاع على لمحة عن "مجموعة حزمات تطبيق Android".

  • إتاحة سرعات الإصدار التزايدية المحسَّنة عند استخدام معالجات التعليقات التوضيحية: تمّ توسيع نطاق AnnotationProcessorOptions DSL الآن إلى CommandLineArgumentProvider، ما يتيح لك أو لمؤلِّف معالج التعليقات التوضيحية إضافة تعليقات توضيحية إلى الوسيطات الخاصة بمعالج البيانات باستخدام التعليقات التوضيحية من نوع سمة الإصدار التزايدي. يؤدي استخدام هذه التعليقات التوضيحية إلى تحسين دقة وأداء الإصدارات النظيفة والتزايدية التي تم تخزينها مؤقتًا. لمزيد من المعلومات، راجِع تمرير الوسيطات إلى معالجات التعليقات التوضيحية.

  • أداة نقل البيانات لنظام التشغيل AndroidX: عند استخدام الإصدار 3.2.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android مع الإصدار 3.2 من نظام التشغيل Android والإصدارات الأحدث، يمكنك نقل البيانات التابعة للمشروع وتبعيات Maven لاستخدام مكتبات AndroidX الجديدة من خلال اختيار إعادة هيكلة > نقل البيانات إلى AndroidX من شريط القوائم. يؤدي استخدام أداة نقل البيانات هذه أيضًا إلى ضبط العلامات التالية على true في ملف gradle.properties:

    • android.useAndroidX: عند ضبط المكوّن الإضافي لنظام التشغيل Android على true، يستخدم مكتبة AndroidX المناسبة بدلاً من "مكتبة الدعم". في حال عدم تحديد هذه العلامة، يضبطها المكوّن الإضافي تلقائيًا على false.

    • android.enableJetifier: عند ضبط المكوّن الإضافي لنظام التشغيل Android على true، ينقل تلقائيًا مكتبات الجهات الخارجية الحالية لاستخدام AndroidX من خلال إعادة كتابة برامجها الثنائية. في حال عدم تحديد هذه العلامة، يضبطها المكوّن الإضافي تلقائيًا على false. يمكنك ضبط هذه العلامة على true فقط عند ضبط android.useAndroidX أيضًا على true، وإلا ستظهر لك رسالة خطأ في الإصدار.

      للتعرّف على مزيد من المعلومات، يمكنك الاطّلاع على نظرة عامة على AndroidX.

  • برنامج تقليص الرموز الجديد، R8: إنّ R8 هي أداة جديدة لتقليص الرموز وإخفاء مفاتيح فك التشفير تحل محل ProGuard. يمكنك بدء استخدام إصدار المعاينة من R8 من خلال تضمين ما يلي في ملف gradle.properties الخاص بمشروعك:

            android.enableR8 = true
        
            android.enableR8 = true

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

  • أصبحت إزالة المحتوى باستخدام D8 مفعّلة الآن تلقائيًا.

  • يتوفّر AAPT2 الآن في مستودع Maven من Google. لاستخدام AAPT2، تأكَّد من توفُّر الاعتمادية google() في ملف build.gradle، كما هو موضّح أدناه:

              buildscript {
                repositories {
                    google() // here
                    jcenter()
                }
                dependencies {
                    classpath 'com.android.tools.build:gradle:3.2.0'
                }
            }
            allprojects {
                repositories {
                    google() // and here
                    jcenter()
            }
          
              buildscript {
                repositories {
                    google() // here
                    jcenter()
                }
                dependencies {
                    classpath 'com.android.tools.build:gradle:3.2.0'
                }
            }
            allprojects {
                repositories {
                    google() // and here
                    jcenter()
            }

  • تم تفعيل ميزة الوسائط المتعددة المتعدّدة تلقائيًا الآن. وكانت الإصدارات السابقة من "استوديو Android" توفّر خيار "تعدُّد التطبيقات الأصلية" عند نشر إصدار تصحيح الأخطاء من أحد التطبيقات على جهاز يعمل بالمستوى 21 من واجهة برمجة تطبيقات Android أو الإصدارات الأحدث. وسواء كنت تنشر على جهاز أو تنشئ حزمة APK بغرض طرحه، يتيح المكوّن الإضافي لنظام Gradle المتوافق مع Android التوافق مع العديد من الأنظمة الأساسية الأصلية لجميع الوحدات التي تضبط نظام minSdkVersion=21 أو إصدارًا أحدث.

  • يفرض المكوّن الإضافي الآن حدًا أدنى من المكوِّن الإضافي للنموذج الأوّلي (0.8.6) ومكوِّن Kotlin الإضافي (1.2.50) والمكوِّن الإضافي Crashlytics (1.25.4).

  • يفرض المكوّن الإضافي com.android.feature لوحدة الميزات الآن استخدام الأحرف والأرقام والشرطات السفلية فقط عند تحديد اسم الوحدة. على سبيل المثال، إذا كان اسم وحدة الميزات يتضمّن شرطات، سيظهر خطأ في الإصدار. ويتطابق هذا السلوك مع المكوّن الإضافي للميزات الديناميكية.

إصلاح الأخطاء