將 JreEmulation 專案新增至 Xcode 專案

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 專案。