開發 iOS 應用時難免要使用第三方類庫。本文整理三種常見的整合方式,以及各自容易踩到的坑。
方法一:直接把原始碼複製進專案
最簡單粗暴的方式,就是把第三方類庫的所有 .h 與 .m 檔直接拖進 Xcode 專案。注意事項:
- 若第三方類庫參照了某些系統框架,專案中還需額外引入那些框架。
- 若目前專案啟用了 ARC,而第三方類庫「未使用」ARC,需在 Targets → Build Phases → Compile Sources 中,為那些 .m 檔加上 -fno-objc-arc 標記。
- 反之,若專案「未啟用」ARC,卻要引用使用了 ARC 的第三方類庫,則需為其 .m 檔加上 -fobjc-arc 標記。
此外,可在原始碼中透過編譯器指令 __has_feature(objc_arc) 來偵測專案是否使用 ARC。
方法二:引用 .xcodeproj 產生的靜態庫
- 把靜態庫與標頭檔複製到專案路徑下;
- 在 Targets → Summary → Linked Frameworks and Libraries(或 Build Phases → Link Binary With Libraries)中加入靜態庫;
- 在 Build Settings → Search Paths → User Header Search Paths 加入標頭檔路徑,可為絕對路徑或相對路徑,常見寫法如
$(PROJECT_DIR)/usr。
注意事項:
- 若類庫把資源封裝在 .bundle 中,.bundle 需與 .xcodeproj 一起拖入專案。
- 某些靜態庫還需在 Build Settings → Linking → Other Linker Flags 加入 -ObjC、-all_load 等標記。
- 若當前專案與第三方類庫同時使用了另一個相同的第三方類庫,可能產生符號重複衝突,此時需在該第三方類庫的 .xcodeproj 中,把重複的 .m 與 .h 從 Compile Sources 與 Copy Headers 移除。
- 第三方類庫參照的系統框架若專案未引入,也可能導致編譯錯誤(例如類庫用了 QuartzCore.framework,專案就要一併引入)。
方法三:借助 CocoaPods 管理第三方
開發時常會用到大量開源庫(如 JSONKit、AFNetworking),而這些庫又可能彼此依賴,「子子孫孫無窮盡」。手動一個個下載、更新版本非常麻煩。
CocoaPods 正是解決這類痛點的依賴管理工具:只要一行命令,就能自動處理下載與版本更新,且絕大多數知名開源庫都支援它。對 iOS 開發者而言,掌握 CocoaPods 幾乎是必備的基本技能。