如何建立自己的 Xcode .a 檔案

在使用 Delphi 建立自己的 app 時, 有時候會需要使用到第三方廠商的 source code, 這些 source 如果是用 Xcode objective-c 撰寫, 用來提供 iOS 的某些功能, 直接使用這些驗證過的程式碼, 會比自己照著原始碼重寫一次來的快、來的可靠。

所以,最快的方法就是用 Xcode 把這些原始碼 (通常會是 .m 跟 .h 檔案) 建立一個 .a 檔案, .a 檔案是靜態函式庫, 等同於在 C 語言裡面的 .lib 檔, 連結後就不能動態改變執行檔的內容了。

以下是建立 .a 檔案的簡單步驟說明:

1.     使用 XCode建立一個新的專案

      

2.     選擇 Framework & Library -> Cocoa Touch Static Library, 然後選Next

3.     填寫 library 的基本資料, 任填就行了.

 

4.     選擇一個 folder 來存放專案檔案, 我選擇在 iOS SDK8 目錄下, Xcode會自動建立專案目錄

5.     從finder找到要加入的.m 跟 .h 檔案, 拖拉進 Xcode 專案中

6.     選擇編譯的專案組態, 必須對Device 跟 Simulator分別都進行 Build.

7.     Device 跟 Simulator 都編譯好了之後, 找到製作好的 .a 檔案, 快速找尋方法: 從 Products 點選 lib, 然後用滑鼠右鍵點選它, 選擇 Show In Finder, 就會出現一個新的 Finder 視窗, 顯示該檔案的位置。

8.     上面的 Finder 是顯示 Debug-iphones 跟 Debug-iphonesimulator兩個目錄裡面的libmyPackage.a 檔案.

9.     在 iphoneos 目錄裡面的, 是給實際裝置使用的 .a 檔案, 在 iphonesimulator目錄裡面的, 是給模擬器使用的 .a 檔案, 我們可以透過以下的 command line 來把兩個檔案合一, 檔案會變大, 但就不用選擇不同的檔案了, 這個指令的用法是 lipo –create 第一個.a檔 第二個.a檔… -output 合併檔案

在 Mac OSX 裡面, Terminal (終端機)有個很方便的設計, 就是可以從 finder 把檔案直接拖拉到終端機畫面, 可以直接把該檔案的完整路徑拖拉進去:

然後 key in –output, 再拖拉 folder 進去:

10. 輸入檔名, 剛剛指令已經完成輸入到 –output 目錄 了, 我們把檔案名輸入一下, 本例中是 libmyPackage.a

11. 按下 Enter, lipo 就會執行, 把兩個 .a 檔案合併成同一個, 完成。

補充: 預設建立的 .a 檔案是 debug 模式的, 裡面會有 debug information, 如果要建立 Release 的版本, 則需要修改一下 Build Configuration:

點選 Edit Scheme, 會出現設定畫面：

下拉 Build Configuration, 選擇 Release 即可.

重複6-12步驟, 這次要選擇 Release-iphoneos 跟 Release-iphonesimulator當中的 .a檔案, 建立出來的 .a 檔, 就會是 Release 版本的了.

注意事項: 如果第三方的 source code 裡面有使用到 Delphi IDE 預設匯入的 iOS framework 以外的 framework, 也要記得把他們透過 Delphi IDE 的 Option->Tool->SDK Manager 匯入, 才能正確運作喔.