您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

用 Xcode 6 製作通用 Framework:動態庫與靜態庫完整流程

編輯:iOS 開發基礎

有沒有想過把自己的 SDK,或一些常用工具類做成 Framework?你可能自己寫過腳本來打包,也有很多人用過 iOS-Universal-Framework。隨著 Xcode 6 把這件事變成內建功能,該專案作者也宣布停止維護,建議大家改用 Xcode 6 製作。網路上相關教學不少,但細節往往不夠完整,以下把整個流程走一遍。

關於靜態庫與動態庫的概念差異,網路上的資料已經很多,這裡不再贅述,直接進入實作。

建立 iOS 動態庫

新增專案,把預設 Target 選為 Cocoa Touch Framework:

接著寫程式碼。這裡我簡單做了一個 Utils 類別,裡面只有一個 log 方法:

下一步是設定要對外開放的標頭檔。Framework 裡難免有不想讓使用者看到的內部輔助類別,因此只把需要公開的類別設為 Public:

這樣一來,產出的 Framework 在 Headers 目錄下也只會看到 Public 的標頭檔:

程式碼完成後直接 Run,Framework 就產生了。透過 Xcode → Window → Organizer → Projects → 你的專案,開啟 Derived Data 目錄即可找到它:

建立測試專案並引入 Framework

把 Framework 拖進測試專案,呼叫其中的程式碼:

MyUtils *utils = [MyUtils new];
[utils log:@"didFinishLaunchingWithOptions"];

執行後卻出現錯誤(Reason: Image Not Found):

原因在於我們做的是動態庫,使用時還要多一道手續——把 Framework 同時加入「Embedded Binaries」:

附帶一提,Xcode 6 之前並沒有這個選項,所以理論上 Xcode 5 及更早版本無法使用 Xcode 6 產出的動態 Framework。

如果全程都在模擬器上操作,到這裡看似一切順利。但一旦把測試專案部署到真機,問題立刻浮現:

ld: warning: ignoring file .../MyFramework.framework/MyFramework,
file was built for x86_64 which is not the architecture being linked (armv7)

Undefined symbols for architecture armv7:
  "_OBJC_CLASS_$_MyUtils", referenced from:
      objc-class-ref in AppDelegate.o
ld: symbol(s) not found for architecture armv7
clang: error: linker command failed with exit code 1 (use -v to see invocation)

錯誤訊息其實說得很明白:製作動態庫時選的是模擬器,產物自然只含 x86_64;改成真機則只含 armv7。要做出通用的動態庫,直覺做法是分別編譯兩份再合併,但每次打包都這樣手動操作實在繁瑣。與其如此,不如寫個腳本自動搞定。

製作通用動態庫

新增一個 Aggregate Target:

為它加入一個 Run Script 階段:

# 設定輸出目錄與最終 Framework 產品
# 若專案名稱與 Framework 的 Target 名稱不同,請自行指定 FMK_NAME
# 例如:FMK_NAME = "MyFramework"
FMK_NAME=${PROJECT_NAME}

# 最終產出位置,這裡放在專案根目錄
INSTALL_DIR=${SRCROOT}/Products/${FMK_NAME}.framework

# 暫存目錄,完成後會刪除
WRK_DIR=build
DEVICE_DIR=${WRK_DIR}/Release-iphoneos/${FMK_NAME}.framework
SIMULATOR_DIR=${WRK_DIR}/Release-iphonesimulator/${FMK_NAME}.framework

# 分別編譯兩種架構
xcodebuild -configuration "Release" -target "${FMK_NAME}" -sdk iphoneos clean build
xcodebuild -configuration "Release" -target "${FMK_NAME}" -sdk iphonesimulator clean build

# 清掉舊的產物
if [ -d "${INSTALL_DIR}" ]
then
rm -rf "${INSTALL_DIR}"
fi

mkdir -p "${INSTALL_DIR}"
cp -R "${DEVICE_DIR}/" "${INSTALL_DIR}/"

# 用 lipo 把兩份執行檔合併成單一通用產品
lipo -create "${DEVICE_DIR}/${FMK_NAME}" \
     "${SIMULATOR_DIR}/${FMK_NAME}" \
     -output "${INSTALL_DIR}/${FMK_NAME}"

rm -r "${WRK_DIR}"
open "${INSTALL_DIR}"

選中這個新 Target 並執行,若一切正常,會自動跳出產生的 Framework:

這樣產出的動態庫就能同時在模擬器與真機上運行了。

改用靜態庫

前面提到,這樣產生的動態庫恐怕很難在 Xcode 5 上使用。那為什麼非得堅持動態庫?一般情況下靜態庫就夠了。而改成靜態庫只需調整一個參數:

改用靜態庫後,就能把 Framework 從「Embedded Binaries」中移除。實測在 Xcode 5 下可用。把新庫導入測試專案,在模擬器與真機上跑一遍,一切正常。

但如果你手上的真機是 iPhone 5c,就會遇到另一個狀況:產出的 Framework 竟然不支援 armv7s。這到底是 Xcode 6 的問題,還是蘋果認為 armv7s 設備已經不值得支援,就不得而知了——總之 Xcode 6 新增專案時,預設的 Architectures 裡確實沒有 armv7s:

想讓產物支援 armv7s,把它加進 Architectures 後重新產生即可:

檢查 Framework 支援哪些架構

該怎麼確認產出的 Framework 涵蓋哪些平台?總不能一台台真機去試。用 lipo 查一下就好,以下是加入 armv7s 前後的對照:

$ lipo -info ./MyFramework.framework/MyFramework
Architectures in the fat file: ./MyFramework.framework/MyFramework are:
i386 x86_64 armv7 arm64

$ lipo -info ./MyFramework.framework/MyFramework
Architectures in the fat file: ./MyFramework.framework/MyFramework are:
armv7 armv7s i386 x86_64 arm64
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved