J2ObjC 的 JRE 模擬程式庫可使用 Xcode 建立,亦可做為 Xcode 專案中的子專案加入。這可讓您控管建構該程式庫時採用的設定,以便讓專案獲得最佳使用。
下載原始碼
選擇下列其中一種做法:下載目前的來源套件並將其解壓縮至本機目錄,或使用 git 複製原始碼樹狀結構。本機版本簽出的優點是能更輕鬆地即時掌握最新的 J2ObjC 專案變更,但必須對版本管控系統有一定的瞭解。
原始碼可以位於本機系統的任何位置,關於本文件,我們會使用 /usr/local/src/j2objc
,但您可以依個人需求變更路徑。
安裝建構工具
您需安裝 Xcode 的指令列工具和 Apache Maven,才能建構 J2ObjC。以下提供幾項訣竅:
這些是 Google 搜尋,而不是靜態網頁,因為安裝作業經常會因新的 Mac OS X 和 Xcode 版本而有所不同。
建構專案
按照 Building J2ObjC (建構 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 測試,這些測試是在指令列中使用
jre_emul
目錄中的make test
建構及執行。 - 轉譯類別:這些是藉由翻譯 JRE 程式庫 Java 來源檔案所建立的檔案。注意:
- Xcode 會標示缺少的檔案,並以紅色標示。由於這些檔案是在建構期間建立,因此在專案建構之前,這些檔案一開始會顯示為紅色。
- 我們會定期將新類別新增至 JRE 模擬程式庫,因此這份清單可能過舊。如果有,請在這個資料夾上按一下滑鼠右鍵,點選「Add Files to JreEmulation.xcodeproj」,然後新增
jre_emul/build_result/Classes
和其子目錄中的.m
和.h
檔案。
如要建構 JreEmulation 專案,請選取 jre_emul
目標,然後按一下 Xcode 的「Run」按鈕。如要建構並執行單元測試,請按一下「Run」按鈕旁的向下箭頭,然後選取「Test」。
將 JreEmulation 專案新增至專案中
- 在左側的「Project Naviagator」面板中,在專案上按一下滑鼠右鍵,然後選取「Add Files to Project Name」。
- 找出
jre_emul/JreEmulation.xcodeproj
檔案,然後按一下「Add」按鈕。 - 按一下專案並選取主要目標,然後選取目標的「版本階段」分頁標籤。
- 開啟「目標依附元件」部分,按一下「+」+按鈕,然後選取
jre_emul
目標。 - 開啟「連結二進位檔和程式庫」部分,按一下「+」+按鈕,然後選取
libjre_emul.a
。 - 接著選取目標的「Build Settings」分頁標籤,找出「Header Search Paths」(標頭搜尋路徑),然後將路徑新增至
/usr/local/src/j2objc/dist/include
目錄 (取代實際位置)。
現在當您建構專案時,會視需要建構 JreEmulation 專案。