הוספת הפרויקט של JreEmulation לפרויקט ה-Xcode

אפשר ליצור את ספריית האמולציה של J2ObjC באמצעות Xcode וגם לכלול אותה כפרויקט משנה בפרויקטים של Xcode. כך תוכלו לקבוע את ההגדרות שישמשו ליצירת הספרייה הזו, כדי שתוכלו להשתמש בה בצורה הטובה ביותר בפרויקטים שלכם.

הורדת קוד המקור

אחת משתי האפשרויות: - להוריד ולהעלות את חבילת המקור הנוכחית לספרייה מקומית. או - משכפלים את עץ קוד המקור באמצעות git. היתרון של בדיקה של מקור מקומי הוא שקל יותר להתעדכן בשינויים האחרונים בפרויקט J2ObjC, אבל נדרש ידע מסוים במערכות לניהול גרסאות.

קוד המקור יכול להופיע בכל מקום במערכת המקומית. למטרות המסמך הזה נשתמש ב-/usr/local/src/j2objc, אך נשנה את הנתיב בהתאם לצורך.

התקנת כלי Build

כדי לבנות J2ObjC, צריך להתקין את כלי שורת הפקודה של Xcode ואת Apache Maven. ריכזנו בשבילכם כמה טיפים:

אלו הם חיפושים ב-Google במקום דפים סטטיים, מאחר שההתקנה עשויה להשתנות לעיתים קרובות בגרסאות חדשות של Mac OS X ו-Xcode.

בניית הפרויקט

פועלים לפי השלבים לבניית J2ObjC. גרסאות build של שורת הפקודה הן אופציונליות, אבל קל יותר לניפוי באגים מאשר בהפעלה שלהן ב-Xcode.

במהלך ניפוי באגים ב-JRE, מומלץ להוסיף את השורות הבאות בחלק העליון של jre_emul/environment.mk לפני הרצת build נקי:

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 מסמן קבצים חסרים באדום. בגלל שהקבצים האלה נוצרים במהלך ה-build, בהתחלה הם יהיו בצבע אדום עד שהפרויקט יסתיים.
  • אנחנו מוסיפים באופן קבוע כיתות חדשות לספריית האמולציה של JRE, לכן יכול להיות שהרשימה הזו לא עדכנית. אם כן, צריך ללחוץ לחיצה ימנית על התיקייה הזו, ללחוץ על 'הוספת קבצים ל-JreEmulation.xcodeproj' ולהוסיף קבצים חדשים .m ו-.h מהקובץ jre_emul/build_result/Classes ומספריות המשנה שלו.

כדי ליצור את פרויקט JreEmulation, בוחרים את היעד jre_emul ולוחצים על הלחצן Run ב-Xcode. כדי ליצור ולהריץ את בדיקות היחידה, לוחצים על החץ למטה שלצד הלחצן הפעלה ובוחרים באפשרות בדיקה.

הוספת פרויקט JreEmulation לפרויקט

  • בחלונית Project Naviagator שבצד ימין, לוחצים לחיצה ימנית על הפרויקט ובוחרים באפשרות Add Files to Project Name (הוספת קבצים ל-Project Name).
  • מאתרים את הקובץ jre_emul/JreEmulation.xcodeproj ולוחצים על הלחצן הוספה.
  • לוחצים על הפרויקט ובוחרים את היעד העיקרי ואז בוחרים בכרטיסייה 'שלבי הבנייה' של היעד.
  • פותחים את הקטע 'יעד תלות', לוחצים על הלחצן + ובוחרים את היעד jre_emul.
  • פותחים את הקטע 'קישור בינארי עם ספריות', לוחצים על הלחצן + ובוחרים באפשרות libjre_emul.a.
  • בוחרים בכרטיסייה Build Settings (הגדרות Build) של היעד, מוצאים את Header Search Paths ומוסיפים את הנתיב לספרייה /usr/local/src/j2objc/dist/include (מחליפים את המיקום בפועל).

עכשיו, אחרי שהפרויקט נוצר, פרויקט JreEmulation