استكشاف الأخطاء وإصلاحها
فشل التجميع
لماذا قد يفشل التجميع اليدوي في مشروع كان Ready، وكيف تقرأ الأخطاء، ومتى يكون "أصلحه بالذكاء الاصطناعي" مجانياً.
آخر تحديث
في هذه الصفحة
#لماذا فشل التجميع في مشروع Ready؟
يبني التجميع الملفات الحالية. الأسباب المعتادة لفشله بعد أن كان المشروع Ready:
- تغيّرت الملفات بعد التحقق: عدّلت شيئاً ما، أو لم ينتهِ التحقق من تغيير أُجري عبر المحادثة.
- شيء خارج الكود: كان مستودع اعتماديات غير متاح، أو انتهت مهلة البناء (5 دقائق للـ plugins، و10 للـ mods). جرّب أعد الفحص.
إذا كانت الملفات هي نفسها التي سلّمها Codexe بالضبط وما زال البناء يفشل، فهذه مشكلة على Codexe إصلاحها، والإصلاح مجاني.
#ما الذي تفعله
- اقرأ قائمة الأخطاء في نتيجة التجميع: يعرض كل خطأ الملف والسطر.
- اضغط على أصلحه بالذكاء الاصطناعي:
- الملفات لم تتغير منذ أن سلّمها Codexe: يعمل إصلاح داخلي مجاني (سترى جارٍ إصلاح مشكلة…)؛
- الملفات تغيّرت: تُرسل الأخطاء إلى المحادثة كرسالة عادية (تستهلك توكنات).
- إذا كنت قد عدّلت ملفاً للتو لإصلاحه بنفسك، فاضغط على أعد الفحص.
#قراءة الأخطاء الشائعة
| الخطأ | المعنى |
|---|---|
cannot find symbol | فئة أو دالة أو متغير غير موجود في إصدار الـ API الذي تبني عليه، أو أن استيراداً ما مفقود. اذكر إصدار خادمك. |
package … does not exist | اعتمادية مفقودة من pom.xml / build.gradle. اذكر اسم الـ plugin أو المكتبة التي تستخدمها. |
incompatible types | دالة تُرجع شيئاً مختلفاً في إصدار الـ API هذا. |
Could not resolve … | إصدار اعتمادية غير موجود، أو أن مستودعها ليس من المستودعات التي يستطيع Codexe الوصول إليها. |
release version 21 not supported | يستهدف المشروع إصدار Java أحدث من الذي استخدمه البناء. يُحدَّد إصدار Java بحسب إصدار Minecraft؛ اذكره بوضوح. |
#يُبنى لكنه لا يعمل داخل اللعبة
يثبت التجميع أن الكود يُبنى، لا أن الميزة تتصرف بشكل صحيح. صف السلوك داخل اللعبة في المحادثة. راجع أخطاء المنصات الشائعة.