تطوير Android / دليل حلول تحريري
تشخيص إخفاقات توافق Gradle وJDK
افصل JDK الذي يشغّل Gradle عن أهداف الترجمة وأصلح الأدوات غير المتوافقة وفق متطلبات المشروع الفعلية.
قاعدة معرفة للقراءة فقط · بلا تعليقات عامة
تعرّف على الأعراض
تفشل المزامنة أو البناء قبل تشغيل شيفرة التطبيق. قد تذكر الرسالة إصدار class-file غير مدعوم أو Java غير متوافق أو إصدار Gradle مطلوباً. قد تنجح Studio ويفشل الطرفية أو العكس. سجل أول رسالة ذات صلة بدقة وحدد هل وقع الفشل عند تحميل الإضافة أو تقييم النص أو ترجمة Kotlin.
افهم الأسباب المحتملة
- قد تشغّل Studio برنامج Gradle باستخدام Gradle JDK المضبوط، بينما تستخدم الطرفية JAVA_HOME أو برنامج java على PATH. يختار الغلاف Gradle وتفرض إضافة Android متطلبات توافق خاصة. تضبط إعدادات توافق مصدر Java وهدف JVM في Kotlin الشيفرة الناتجة؛ ولا يغير تعديلها بالضرورة بيئة التشغيل التي تنفذ Gradle فعلياً.
حدّد بيئة التشغيل المستخدمة فعلياً
افحص إعداد الغلاف وإعلانات الإضافات أو كتالوج الإصدارات واختيار Gradle JDK في Studio وإعداد Java في CI. قارنها كمجموعة بدلاً من السؤال عن أحدث Java عموماً. تعرض الأوامر بيئة الطرفية وبيئة البناء التي اختارها الغلاف. نفذها داخل النسخة المقصودة فقط؛ وقد ينزل الغلاف غير المخبأ توزيعته المضبوطة. احفظ خصوصية المسارات وتفاصيل البيئة عند المشاركة ولا تلصق البيئة كاملة بما فيها الاعتمادات.
java -version
./gradlew --versionهذه أوامر تشخيص لمشروع Gradle قائم وموثوق. لا تثبت Android SDK ولا توصل جهازاً. قارن JVM الذي يبلغه Gradle بإعداد Gradle JDK في Studio؛ لا تكفي java -version وحدها كدليل.
اقرأ صف التوافق لإضافة المشروع
افتح وثائق الإصدار الرسمية لإصدار إضافة Android Gradle المعلن في المشروع. افحص Gradle وJDK المطلوبين ثم إرشادات تكامل Kotlin ومترجم Compose المعنية. لا تستبدل إصداراً حالياً اعتباطياً من قالب آخر. إذا استخدم المشروع عائلة أحدث بدعم Kotlin مدمج فاتبع قواعد ترحيلها بدلاً من إضافة إضافات قديمة لإسكات العرض. يجب أن يكون التصحيح تغيير إعداد صغيراً قابلاً للمراجعة بسبب توافق محدد.
وحّد البيئة قبل تعديل أهداف المصدر
اختر JDK المتوافق المدعوم بالمشروع واضبط Studio والطرفيات وCI باتساق. إذا خرج الغلاف عن مدى الإضافة فحدّثه بسير المشروع الموثق مع إعدادات التوافق المتأثرة. احفظ الإعداد المعروف الصالح للمقارنة. لا تبدأ بحذف المخابئ أو إعادة كتابة كل الاعتماديات؛ تزيل تلك الإجراءات الأدلة ولا تثبت قدرة البيئة على تحميل الإضافة. يختلف عدم تطابق هدف JVM أثناء الترجمة عن فشل بدء Gradle.
تحقق من نجاح الإصلاح
أعد تقرير الإصدارات في الطرفية وأكد JVM المقصود. زامن Studio ثم نفذ مهمة البناء ومتغيرها الأصليين. يعني النجاح اختفاء رسالة التوافق واكتمال المهمة المقصودة، لا مجرد توقف المحرر عن وضع خط تحت ملف. قارن CI على مراجعة المصدر نفسها قبل إعلان إصلاح البيئة.
امنع تكرار المشكلة
- وثق الغلاف والإضافة وتكامل Kotlin وCompose وJDK المختبرة كمجموعة متوافقة. راجع الترقيات معاً واحفظ أمراً أدنى يعيد الفشل في تقارير العيوب. تجنب مسارات JDK الخاصة بجهاز في الإعداد المشترك إلا إذا كان المشروع يديرها صراحة.