المتطلبات الأساسية
راجع متطلبات النظام والبيئة والمشروع قبل بدء سير عمل Java Modernization مع IBM Bob.
راجع هذه المتطلبات قبل بدء سير عمل Java Modernization. المشروع المُجهَّز جيداً يؤدي إلى تحليل أسرع وأدق وعدد أقل من الانقطاعات أثناء الترحيل.
متطلبات النظام
| المتطلب | التفاصيل |
|---|---|
| Java Development Kit (JDK) | الحد الأدنى JDK 8. يُوصى بتثبيت إصدار JDK المستهدف مسبقاً (مثلاً JDK 21). يمكن لـ Bob تثبيت الإصدارات المستهدفة عبر SDKMan أو WinGet. |
| IBM Bob | الإصدار 2.0.0 أو أحدث، مثبت ومُصادق عليه. |
| حزمة Java Modernization | رخصة نشطة لـ IBM Bob Premium Package for Java Modernization. |
| Git | مطلوب إذا كنت تستخدم ميزات Git flow لإدارة الـ branch والـ pull request. |
SDKMan مطلوب لإدارة تثبيتات إصدار Java. يتحقق Bob من SDKMan أثناء سير العمل وقد يُطالبك بتثبيته إذا لم يكن مكتشفاً.
لتهيئة SDKMan في shell الخاص بك، تأكد من أنه مُضمَّن في ملف تعريف shell الخاص بك (~/.bashrc أو ~/.zshrc). أعِد تشغيل جلسة الـ terminal بعد التثبيت.
WinGet (Windows Package Manager) مطلوب لإدارة تثبيت Java.
بعد تثبيت WinGet، أعِد تشغيل IBM Bob وأي جلسات terminal مفتوحة حتى يتمكن Bob من اكتشافه على PATH المُحدَّث.
متطلبات المشروع
تكوين البناء
يجب أن يستوفي مشروعك هذه المتطلبات قبل بدء أي سير عمل:
- تكوين بناء Maven (
pom.xml) أو Gradle (build.gradle) صالح موجود. - المشروع مفتوح على مستوى الجذر الصحيح في بيئة التطوير.
- الكود المصدري في هيكل مجلد قياسي (
src/main/javaوsrc/test/java). - جميع التبعيات مُحلَّلة والمشروع يُترجَم بنجاح.
- المشاريع أحادية الوحدة: افتح المجلد الذي يحتوي على
pom.xmlأوbuild.gradleالرئيسي. - المشاريع متعددة الوحدات: افتح جذر المشروع الأصل. تأكد من إدراج جميع الوحدات في POM الأصل وتكوين التبعيات بين الوحدات بشكل صحيح.
- مساحات عمل متعددة المشاريع: اختر جذر المشروع الصحيح عند مطالبة Bob.
التحكم بالإصدار
هيّئ Git بمجلد عمل نظيف. أضف أي تغييرات غير مُضافة أو احتفظ بها قبل البدء.
أنشئ branch ترحيل مخصص:
git checkout -b java-modernizationإعداد البيئة
قبل بدء سير عمل، تأكد من جاهزية بيئتك:
- أداة البناء (Maven أو Gradle) مثبتة ومُكوَّنة.
- وصول للـ terminal متاح لتشغيل عمليات البناء والاختبار.
- وصول للشبكة متاح لتنزيل التبعيات.
- الملفات والمحررات غير الضرورية مغلقة.
- نتائج البناء مُمسَحة (اختياري لكن مُوصى به).
تكوين .bobignore
كوّن .bobignore لحماية الملفات الحساسة واستبعاد الضوضاء من تحليل Bob. يستخدم الملف تنسيق .gitignore ويقع في .bob/.bobignore.
استبعِد:
- التبعيات الكبيرة ونتائج البناء
- ملفات بيانات الاختبار
- ملفات التكوين الحساسة
متطلبات خاصة بسير العمل
النسخ الاحتياطي والسلامة
قبل بدء أي سير عمل:
أنشئ نسخة احتياطية حديثة من ملفات مشروعك وتأكد من أن مستودع Git الخاص بك نظيف مع تضمين جميع التغييرات. أخبر فريقك بأن عمل التحديث جارٍ.