إضافة مشروع JreEmulation إلى مشروع Xcode

يمكن إنشاء مكتبة محاكاة JRE لـ J2ObjC باستخدام Xcode، ويمكن تضمينها كمشروع فرعي في مشاريع Xcode الخاصة بك. يتيح لك ذلك التحكم في الإعدادات المستخدمة لإنشاء تلك المكتبة بحيث يمكن لمشاريعك استخدامها على أفضل وجه.

تنزيل رمز المصدر

إمّا: - تنزيل حزمة المصدر الحالية وضغطها في دليل محلي، أو - استنساخ شجرة رموز المصدر باستخدام git. تتمثل ميزة التحقق من المصدر المحلي في أنه من السهل مواكبة أحدث التغييرات في مشروع J2ObjC، لكنه يتطلب بعض المعرفة بأنظمة التحكم في الإصدار.

يمكن أن يظهر رمز المصدر في أي مكان على النظام المحلي. لأغراض هذا المستند، سنستخدم /usr/local/src/j2objc، ولكن سنغير هذا المسار كما تفضله.

تثبيت أدوات الإصدار

يجب تثبيت أدوات سطر أوامر Xcode وApache Maven لإنشاء J2ObjC. إليك بعض النصائح:

وتكون هذه عمليات بحث في Google بدلاً من صفحات ثابتة، لأنّ عملية التثبيت قد تتغير في أغلب الأحيان مع الإصدارين الجديدين من نظام التشغيل Mac OS X وXcode.

بناء المشروع

اتّبِع خطوات مبنى J2ObjC. وتكون إصدارات سطر الأوامر اختيارية، ولكنها أسهل في تصحيح الأخطاء مقارنةً بالحالات التي يتم استدعاؤها داخل Xcode.

عند تصحيح أخطاء JRE، يُنصح بإضافة الأسطر التالية في أعلى jre_emul/environment.mk قبل تشغيل إصدار نظيف:

DEBUGGING_SYMBOLS=YES
OPTIMIZATION_LEVEL=0

مشروع JreEmulation Xcode

في Xcode، افتح /usr/local/src/j2objc/jre_emul/JreEmulation.xcodeproj. وتتضمن مجلداته ما يلي:

  • الفئات: مجموعة فئات محاكاة JRE الأساسية التي لا يتم إنشاؤها عن طريق ترجمة ملفات مصدر Java.
  • jre_emul_tests: مجموعة اختبارات الوحدات التي يتم إنشاؤها وتشغيلها باستخدام Xcode. ولا تشمل هذه الاختبارات اختبارات JUnit المترجَمة، والتي تم إنشاؤها وتشغيلها من سطر الأوامر باستخدام make test في دليل jre_emul.
  • الصفوف المترجَمة: هي الملفات التي تم إنشاؤها عن طريق ترجمة ملفات مصدر Java التابعة لمكتبة JRE. ملاحظات:
  • يضع Xcode علامة على الملفات المفقودة باللون الأحمر. نظرًا لإنشاء هذه الملفات أثناء الإنشاء، فستكون جميعها في البداية باللون الأحمر حتى يتم إنشاء المشروع.
  • نحن نضيف فئات جديدة بانتظام إلى مكتبة محاكاة JRE، لذلك قد تكون هذه القائمة قديمة. في هذه الحالة، انقر بزر الماوس الأيمن على هذا المجلّد، وانقر على "إضافة ملفات إلى JreEmulation.xcodeproj" وأضِف ملفات .m و.h جديدة من "jre_emul/build_result/Classes" والأدلة الفرعية.

لإنشاء مشروع JreEmulation، اختَر هدف jre_emul وانقر على الزر Run (تشغيل) في Xcode. لإنشاء اختبارات الوحدة وتنفيذها، انقر على السهم المتّجه للأسفل بجانب الزر تشغيل واختَر اختبار.

إضافة مشروع JreEmulation إلى مشروعك

  • في لوحة Project Naviagator على اليسار، انقر بزر الماوس الأيمن على مشروعك وحدد "Add Files to اسم المشروع".
  • ابحث عن ملف jre_emul/JreEmulation.xcodeproj وانقر على الزر إضافة.
  • انقر فوق مشروعك وحدد هدفه الرئيسي، ثم حدد علامة التبويب "مراحل الإنشاء" للهدف.
  • افتح قسم "التبعيات المستهدَفة"، انقر على الزر +، واختَر هدف jre_emul.
  • افتح قسم "Link Binary with Libraries" (ربط ثنائي مع المكتبات)، وانقر على الزر +، واختر libjre_emul.a.
  • اختَر علامة التبويب "Build Settings" (إعدادات الإصدار) للهدف، وابحث عن مسارات بحث العناوين، ثم أضِف المسار إلى الدليل /usr/local/src/j2objc/dist/include (مع استبدال الموقع الفعلي).

الآن، عندما يتم إنشاء مشروعك، يتم إنشاء مشروع JreEmulation حسب الحاجة.