الإصدار 8.1.0 من Android Gradle Plugin (تموز/يوليو 2023)

الإصدار 8.1.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" هو إصدار رئيسي يتضمّن مجموعة متنوّعة من الميزات والتحسينات الجديدة.

التوافق

استخدام لغة Kotlin DSL تلقائيًا لإعدادات التصميم

تستخدم المشاريع الجديدة الآن لغة Kotlin DSL (build.gradle.kts) تلقائيًا لإعدادات الإصدار. يوفّر ذلك تجربة تعديل أفضل من Groovy DSL (build.gradle) مع تمييز بناء الجملة وإكمال الرمز البرمجي والتنقّل إلى التصريحات. يُرجى العِلم أنّه في حال استخدام الإصدار 8.1 من "مكوّن Android الإضافي في Gradle" ولغة Kotlin DSL لإعدادات الإصدار، عليك استخدام الإصدار 8.1 من Gradle للحصول على أفضل تجربة. لمزيد من المعلومات، راجِع دليل نقل البيانات إلى Kotlin DSL.

إتاحة اللغة لكل تطبيق بشكل تلقائي

بدءًا من الإصدار التجريبي 7 من Android Studio Giraffe والإصدار 8.1.0-alpha07 من "مكوّن Android الإضافي في Gradle"، يمكنك ضبط تطبيقك تلقائيًا ليتوافق مع إعدادات اللغة على مستوى التطبيق. استنادًا إلى موارد مشروعك، ينشئ المكوّن الإضافي لنظام Gradle المتوافق مع Android الملف LocaleConfig ويضيف إليه مرجعًا في ملف البيان النهائي، وبالتالي لن تحتاج إلى إجراء ذلك يدويًا. يستخدم المكوّن الإضافي لنظام Gradle في Android الموارد الموجودة في مجلدات res الخاصة بوحدات تطبيقك وأي عناصر اعتمادية لوحدة المكتبة لتحديد اللغات المحلية التي سيتم تضمينها في ملف LocaleConfig.

يُرجى العِلم أنّ ميزة "اللغة التلقائية لكل تطبيق" تتوافق مع التطبيقات التي تعمل بالإصدار 13 من نظام التشغيل Android (المستوى 33 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث. لاستخدام الميزة، يجب ضبط قيمة compileSdkVersion على 33 أو أعلى. لضبط إعدادات اللغة المخصصة حسب التطبيقات في الإصدارات السابقة من Android، عليك استخدام واجهات برمجة التطبيقات وأدوات اختيار اللغة داخل التطبيق.

لتفعيل ميزة توفير اللغة تلقائيًا لكل تطبيق، حدِّد لغة تلقائية:

1. في مجلد res الخاص بوحدة التطبيق، أنشئ ملفًا جديدًا باسم resources.properties.

2. في ملف resources.properties، اضبط اللغة التلقائية باستخدام التصنيف unqualifiedResLocale. لتكوين أسماء اللغات المحلية، ادمج رمز اللغة مع رمزَي البرنامج النصي والمنطقة الاختياريين، مع الفصل بين كل رمز وآخر بشرطة:

   • اللغة: استخدِم رمز ISO 639-1 المكوّن من حرفَين أو ثلاثة أحرف.
   • النص البرمجي (اختياري): استخدِم رمز ISO 15924.
   • المنطقة (اختيارية): استخدِم رمز ISO 3166-1-alpha-2 المكوّن من حرفَين أو رمز UN_M.49 المكوّن من ثلاثة أرقام.

   على سبيل المثال، إذا كانت اللغة التلقائية هي الإنجليزية الأمريكية:

       unqualifiedResLocale=en-US
       

تضيف أداة AGP هذه اللغة التلقائية وأي لغات بديلة حدّدتها، وذلك باستخدام أدلة values-* في المجلد res، إلى ملف LocaleConfig الذي يتم إنشاؤه تلقائيًا.

تكون ميزة "اللغة لكل تطبيق" غير مفعَّلة تلقائيًا. لتفعيل الميزة، استخدِم إعداد generateLocaleConfig في حزمة androidResources {} من ملف build.gradle.kts على مستوى الوحدة (ملف build.gradle إذا كنت تستخدم Groovy):

android {
  androidResources {
    generateLocaleConfig = true
  }
}

android {
  androidResources {
    generateLocaleConfig true
  }
}

يحتوي Android Lint على رمز بايت يستهدف الإصدار 17 من JVM

بدءًا من الإصدار 8.1.0-alpha04 من "مكوّن Android Lint"، يتضمّن هذا المكوّن رمزًا بايت يستهدف الإصدار 17 من جهاز JVM. إذا كنت تكتب عمليات فحص مخصّصة باستخدام أداة Lint، عليك إجراء عملية تجميع باستخدام الإصدار 17 من JDK أو إصدار أحدث وتحديد jvmTarget = '17' في خيارات برنامج الترجمة البرمجية في Kotlin.

لمزيد من المعلومات حول أداة Lint، راجِع تحسين الرمز باستخدام عمليات التحقّق من Lint.

تم نقل إعداد ضغط المكتبة المجمّعة من رموز برمجية أصلية إلى DSL

اعتبارًا من الإصدار 8.1.0-alpha10 من "مكوّن Android الإضافي لبرنامج Gradle"، ستتلقّى تحذيرًا إذا لم تضبط إعدادات ضغط المكتبة المجمّعة من رموز برمجية أصلية باستخدام لغة DSL بدلاً من ملف البيان. توضّح الإرشادات التالية كيفية تعديل الإعدادات لاستخدام لغة DSL. للحصول على مساعدة في إجراء هذه التحديثات، استخدِم "مساعد ترقية" Android Gradle Plugin (أدوات > مساعد ترقية Android Gradle Plugin).

لاستخدام المكتبات الأصلية غير المضغوطة، عليك إزالة السمة android::extractNativeLibs من ملف البيان وإضافة الرمز التالي إلى ملف build.gradle.kts على مستوى الوحدة (ملف build.gradle إذا كنت تستخدم Groovy):

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging = false
    }
  }
}

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging false
    }
  }
}

علامات الإصدار التجريبي

هذه علامات تجريبية لإعداد الإصدار المتوفّر في الإصدار 8.1 من "مكوّن Android الإضافي في Gradle".

المشاكل التي تم إصلاحها

الإصدار 8.1.4 من المكوّن الإضافي لنظام Gradle المتوافق مع Android

الإصدار 8.1.3 من المكوّن الإضافي لنظام Gradle المتوافق مع Android

الإصدار 8.1.2 من المكوّن الإضافي لنظام Gradle المتوافق مع Android

الإصدار 8.1.1 من المكوّن الإضافي لنظام Gradle المتوافق مع Android

الإصدار 8.1.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android