有沒有想過把自己的 SDK,或一些常用工具類做成 Framework?你可能自己寫過腳本來打包,也有很多人用過 iOS-Universal-Framework。隨著 Xcode 6 把這件事變成內建功能,該專案作者也宣布停止維護,建議大家改用 Xcode 6 製作。網路上相關教學不少,但細節往往不夠完整,以下把整個流程走一遍。
關於靜態庫與動態庫的概念差異,網路上的資料已經很多,這裡不再贅述,直接進入實作。
新增專案,把預設 Target 選為 Cocoa Touch Framework:

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

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

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

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


把 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 涵蓋哪些平台?總不能一台台真機去試。用 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