تخطَّ إلى المحتوى
استكشاف الأخطاء وإصلاحها

فشل التجميع

لماذا قد يفشل التجميع اليدوي في مشروع كان Ready، وكيف تقرأ الأخطاء، ومتى يكون "أصلحه بالذكاء الاصطناعي" مجانياً.

آخر تحديث

في هذه الصفحة
  1. لماذا فشل التجميع في مشروع Ready؟
  2. ما الذي تفعله
  3. قراءة الأخطاء الشائعة
  4. يُبنى لكنه لا يعمل داخل اللعبة

#لماذا فشل التجميع في مشروع Ready؟

يبني التجميع الملفات الحالية. الأسباب المعتادة لفشله بعد أن كان المشروع Ready:

  • تغيّرت الملفات بعد التحقق: عدّلت شيئاً ما، أو لم ينتهِ التحقق من تغيير أُجري عبر المحادثة.
  • شيء خارج الكود: كان مستودع اعتماديات غير متاح، أو انتهت مهلة البناء (5 دقائق للـ plugins، و10 للـ mods). جرّب أعد الفحص.

إذا كانت الملفات هي نفسها التي سلّمها Codexe بالضبط وما زال البناء يفشل، فهذه مشكلة على Codexe إصلاحها، والإصلاح مجاني.

#ما الذي تفعله

  1. اقرأ قائمة الأخطاء في نتيجة التجميع: يعرض كل خطأ الملف والسطر.
  2. اضغط على أصلحه بالذكاء الاصطناعي:
    • الملفات لم تتغير منذ أن سلّمها Codexe: يعمل إصلاح داخلي مجاني (سترى جارٍ إصلاح مشكلة…)؛
    • الملفات تغيّرت: تُرسل الأخطاء إلى المحادثة كرسالة عادية (تستهلك توكنات).
  3. إذا كنت قد عدّلت ملفاً للتو لإصلاحه بنفسك، فاضغط على أعد الفحص.

#قراءة الأخطاء الشائعة

الخطأالمعنى
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؛ اذكره بوضوح.

#يُبنى لكنه لا يعمل داخل اللعبة

يثبت التجميع أن الكود يُبنى، لا أن الميزة تتصرف بشكل صحيح. صف السلوك داخل اللعبة في المحادثة. راجع أخطاء المنصات الشائعة.

فشل التجميع | Codexe Docs