استكشاف الأخطاء وإصلاحها
ابحث عن حلول للمشاكل الشائعة التي قد تواجهها أثناء تشغيل سير عمل Java Modernization مع IBM Bob.
SDKMan أو WinGet غير مكتشف
تأكد من تهيئة SDKMan في ملف تعريف shell الخاص بك وأنك أعدت تشغيل جلسة الـ terminal بعد التثبيت.
- افتح ملف تعريف shell الخاص بك (
~/.bashrcأو~/.zshrc). - تحقق من وجود كتلة تهيئة SDKMan في أسفل الملف.
- أعِد تشغيل جلسة الـ terminal.
بعد تثبيت WinGet، أعِد تشغيل VS Code وأي terminals مفتوحة حتى يلتقط Bob الـ PATH المُحدَّث.
إذا كان التثبيت التلقائي محجوباً بسياسة المؤسسة، ثبّت JDK المستهدف يدوياً وعيّن JAVA_HOME ليُشير إليه.
أخطاء حل التبعيات
شغّل بناءً نظيفاً لإجبار إعادة تنزيل التبعيات.
mvn clean install -Ugradle clean build --refresh-dependenciesمشاكل تكامل Git flow
تأكد من تثبيت Git وإمكانية الوصول إليه على PATH النظام:
git --versionإذا لم يُعثر على الأمر، ثبّت Git لنظام التشغيل الخاص بك وتأكد من توفره على PATH قبل إعادة تشغيل Bob.
تحديث UI: مخرجات Backend أو Frontend مفقودة
تأكد من وجود مجلدات back/ وfront/ في جذر المشروع قبل بدء سير عمل UI Modernization. يجب إنشاء هذه المجلدات يدوياً قبل بدء سير العمل.
مشاكل حزمة AMA (إعادة نشر Liberty)
يجب توليد حزمة ترحيل AMA من AMA الإصدار 4.6.0 أو أحدث.
تحقق مما يلي إذا واجهت مشاكل مع حزمة AMA:
- يجب أن يحتوي الـ ZIP على
server.xmlووصفات الترحيل وتحليل التبعيات في المستوى الأعلى — بدون مجلد تغليف إضافي. - إذا فشل النشر على Liberty، تحقق من أن:
- مجموعة ميزات
server.xmlتتطابق مع إصدار Liberty المثبت. - إصدار
liberty-maven-pluginيتوافق مع Liberty runtime الخاص بك.
- مجموعة ميزات