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

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

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

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

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

התקנת כלי Build

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

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

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

פועלים לפי השלבים בקטע Building 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, כך שיכול להיות שהרשימה הזאת לא מעודכנת. אם כן, לוחצים לחיצה ימנית על התיקייה, לוחצים על "Add Files to JreEmulation.xcodeproj" (הוספת קבצים ל-JreEmulation.xcodeproj), ומוסיפים קבצים חדשים מסוג .m ו-.h מ-jre_emul/build_result/Classes ומספריות המשנה שלו.

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

מוסיפים את הפרויקט של JreEmulation לפרויקט

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

עכשיו, לאחר יצירת הפרויקט, הפרויקט של JreEmulation נבנה לפי הצורך.