المكوّن الإضافي لنظام Gradle المتوافق مع Android، المراجعة 1.3.0 (يوليو 2015)

التبعيات:

	الحد الأدنى للإصدار	الإصدار التلقائي	الملاحظات
Gradle	2.2.1	2.2.1	لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تحديث Gradle.
أدوات إنشاء حِزم SDK	21.1.1	21.1.1	ثبِّت أو ضبط أدوات إنشاء حِزم SDK.

ملاحظات عامة:

• تمت إضافة إمكانية استخدام السمة com.android.build.threadPoolSize للتحكّم في حجم مجموعة مؤشرات تسلسل المهام Android منملف gradle.properties أو سطر الأوامر. يضبط المثال التالي هذه السمة على 4.

          
          -Pcom.android.build.threadPoolSize=4
          
        

• اضبط السلوك التلقائي للإنشاء لاستبعاد ملفات LICENSE وLICENSE.txt من حِزم APK. لتضمين هذه الملفات في حزمة APK، عليك إزالة هذه الملفات من ملف packagingOptions.excludes في ملف build.gradle. مثلاً:
  android {
        packagingOptions.excludes = []
      }
        

  android {
        packagingOptions.excludes.clear()
      }
      

• تمت إضافة مهمة sourceSets لتفقد مجموعة جميع مجموعات المصادر المتاحة.
• تحسين اختبار الوحدة للتعرّف على المجلدات المصدر الخاصة بالإصدارات المتعددة وأنواع الإصدار على سبيل المثال، لاختبار تطبيق يتضمّن مجموعات متعددة من النُسخ المخصّصة للأجهزة المختلفة، flavor1 وflavorA بنوع الإصدار Debug، تكون مجموعات مصادر الاختبار على النحو التالي:
  • اختبار
  • testFlavor1
  • testFlavorA
  • testFlavor1FlavorA
  • testFlavor1FlavorADebug

  كانت اختبارات Android تُعرِف ملفات المصدر المتعدّدة النُسخ.

• تحسين دعم اختبار الوحدة لإجراء ما يلي:
  • يمكنك تشغيل javac على المصدرَين الرئيسي والاختباري، حتى إذا تم ضبط القيمة useJack على true في ملف الإنشاء.
  • التعرّف بشكل صحيح على التبعيات لكل نوع من أنواع الإنشاء
• تمت إضافة إمكانية تحديد وسيطات أداة تشغيل اختبارات الأدوات من سطر الأوامر. مثلاً:

  ./gradlew connectedCheck 
  
     -Pandroid.testInstrumentationRunnerArguments.size=medium 
  
     -Pandroid.testInstrumentationRunnerArguments.class=TestA,TestB
          

• تمت إضافة دعم لمَعلمات إضافية عشوائية لأداة حزمة مواد عرض Android (AAPT) في ملف build.gradle. مثلاً:

  android {
      aaptOptions {
        additionalParameters "--custom_option", "value"
      }
  }
        

  android {
      aaptOptions {
        additionalParameters += listOf("--custom_option", "value")
      }
  }
        

• تمت إضافة إمكانية استخدام وحدة اختبار حزمة APK كوحدة اختبار منفصلة، وذلك باستخدام السمتَين targetProjectPath وtargetVariant لضبط مسار APK والصيغة المستهدَفة.

  ملاحظة: لا تتوافق وحدة اختبار APK مع نكهات المنتج ولا يمكنها استهداف سوى سعر متغير واحد. بالإضافة إلى ذلك، لا تتوفّر أداة Jacoco بعد.

• تمت إضافة عملية التحقّق من اسم المورد قبل دمج الموارد.
• عند إنشاء حزمة AAR (أرشيف Android) لوحدات المكتبة، لا تقدِّم العنصر النائب @{applicationId} التلقائي في إعداداتدمج البيان. بدلاً من ذلك، استخدِم عنصر نائبًا مختلفًا، مثل @{libApplicationId} و قدِّم قيمة له إذا كنت تريد تضمين أرقام تعريف التطبيقات في مكتبة الأرشيف.