عند بناء تطبيقك باستخدام Cordova أو Ionic لنظام Android، قد تواجه مشكلة تتعلق بإصدار Gradle المطلوب. رسالة الخطأ التي تظهر تقول “Minimum supported Gradle version is 2.14.1. Current version is 2.13”. هذه المشكلة تحدث عادة عندما يكون هناك تباين بين إصدار Gradle الذي يستخدمه Android Studio والإصدار المحدد في مشروع Cordova / cordova-android الخاص بك.
عندما تقوم بإضافة منصة Android باستخدام الأمر:
csharp$ cordova platform add android
أو
csharp$ ionic platform add android
يقوم Cordova بإنشاء رمز التطبيق الأصلي في المجلد: /the-project/platforms/android. داخل هذا المجلد، يتم تحديد إصدار Gradle المستخدم في عملية البناء من خلال المتغير distributionUrl في ملف: /the-project/platforms/android/cordova/lib/builders/GradleBuilder.js.
عند تشغيل الأمر:
ruby$ cordova build android
يتم استخدام الإصدار المحدد في المتغير distributionUrl كإصدار Gradle لعملية البناء.
مشكلة تأتي عند استيراد المشروع إلى Android Studio، حيث قد تحصل على رسالة توصية بتحديث إصدار Gradle إلى نسخة أحدث. ولكن ينبغي تجنب هذا الإجراء، لأنه سيؤدي إلى تباين في إصدار Gradle بين Android Studio و Cordova، مما يتسبب في أخطاء في البناء داخل Android Studio وأيضًا عند استخدام الأمر:
ruby$ cordova build android
الحل هو الاحتفاظ دائمًا بتعيين مشروع Android Studio على “Use default gradle wrapper” وتجاهل الرسائل المغرية للترقية. إذا كنت ترغب في استخدام إصدار أحدث من Gradle، يمكنك دائمًا تغيير قيمة distributionUrl في الملف المذكور أعلاه. ومع ذلك، يجب أن تكون حذرًا لأن تعديل الرمز داخل المجلدات الخاصة بـ Cordova يعتبر عملية غير مستحسنة، نظرًا لأنه من الممكن أن يتم استبدال التغييرات أثناء عمليات التحديث.
في الوقت الحالي، لا يمكنني تأكيد وجود طريقة لتحديد إصدار Gradle خلال الخطوة:
csharp$ cordova platform add android
وهذا هو الوقت الذي ترغب فيه في القيام بذلك، لتجنب الحاجة إلى تعديل الرمز مباشرة داخل المجلدات الخاصة بالمشروع.
المزيد من المعلومات
في الوقت الحالي، لا يمكنني تأكيد وجود طريقة لتحديد إصدار Gradle خلال الخطوة:
csharp$ cordova platform add android
وهذا هو الوقت الذي ترغب فيه في القيام بذلك، لتجنب الحاجة إلى تعديل الرمز مباشرة داخل المجلدات الخاصة بالمشروع.
هناك نقطة أخرى يجب مراعاتها، وهي أن تحديث إصدار Gradle قد يؤدي إلى مشاكل توافق مع الإضافات والمكتبات التي تستخدمها في مشروعك. قد تكون هناك مشكلات في التوافق مع إصدارات محددة من Gradle، خاصة إذا كنت تستخدم مكتبات تعتمد على إصدارات معينة.
لذا، يُفضل دائمًا إجراء اختبار شامل بعد تحديث إصدار Gradle، والتأكد من أن جميع أجزاء التطبيق تعمل بشكل صحيح. قد تحتاج أيضًا إلى تحديث إعدادات المشروع أو إعدادات Gradle بعد التحديث لضمان التوافق السليم.
في الختام، يُعتبر الحفاظ على توافق إصدار Gradle بين Cordova و Android Studio أمرًا حيويًا لضمان سلاسة عملية تطوير التطبيقات الخاصة بك. باستخدام الإصدار الموصى به من Gradle وتجنب التحديثات غير الضرورية، يمكنك تجنب العديد من المشاكل التي قد تواجهها أثناء عملية التطوير.
