Xcode 6製作動態及靜態Framework

記憶有你發表於2016-02-16
XCodeFramework

有沒有寫SDK或者要將一些常用的工具類做成Framework的經歷? 你或許自己寫指令碼完成了這項工作，相信也有很多的人使用 iOS-Universal-Framework ，隨著Xcode 6的釋出，相信小夥伴們已經都知道了，Xcode 6支援做Framework了. 同時iOS-Universal-Framework開發者也宣佈不在繼續維持此專案的開發，建議開發者使用Xcode 6製作，目前網上也有很多製作iOS Framework的資料，但大多都不夠詳細，接下來本文會詳情介紹一下在Xcode 6下製作iOS Framework.

關於靜態庫和動態庫的概念，網上資料很多，這裡不做敘述，只講解制作過程。

建立iOS動態庫

新建工程並選擇預設Target為Cocoa Touch Framework, 如圖:

11.png

做編碼工作，在這裡我簡單的寫了一個Utils的類，並寫了一個log方法

12.png

設定開放的標頭檔案:Framework中有些類可能是一些私有的輔助工具，不需要使用者看到，在這裡只需要把開放出去的類放到Public下, 如圖

13.png

這樣生成的Framework的Headers目錄下也只能看到Public的標頭檔案

14.png

編碼完成之後，直接Run就能成功生成Framework檔案了，選擇 xCode->Window->Organizer->Projects->Your Project, 開啟工程的Derived Data目錄，這樣就能找到生成的Framework檔案了，如圖

15.png

16.png

新建測試工程，使用生成的Framework

將Framework檔案匯入到測試工程，呼叫Framework中的程式碼

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

執行報錯(Reason: Image Not Found)

18.png

為什麼會這樣的？因為我們做的是動態庫，在使用的時候需要額外加一個步驟,要把Framework同時新增到‘Embedded Binaries’中

19.png

注意: 在XCode 6之前是沒有這個選項的(我沒發現)，所以理論上XCode 5及之前的版本無法使用Xcode 6下生成的Framework動態庫。

到這裡，假定你整個過程都是使用的模擬器做的，那看上去會很順利。這時候嘗試將測試工程部署到真機上，問題來了

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

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)

為什麼會這樣？錯誤提示已經很明顯了，因為我們製作動態庫的時候，選的裝置是模擬器，如果選真機的話，那生成的庫也只能在真機上使用，那我們該怎樣製作一個通用的動態庫呢? 簡單的方法是分別生成模擬器和真機上執行的庫，然後在合併，這個方法，在每次生成動態庫的時候，過程都會很繁瑣，下面我們用一個指令碼來自動完成它。

製作通用動態庫

新建Aggregate Target

20.png

新增script到新建的Target

21.png


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Sets the target folders and the final framework product.
# 如果工程名稱和Framework的Target名稱不一樣的話，要自定義FMKNAME
# 例如: FMK_NAME = "MyFramework"
FMK_NAME=${PROJECT_NAME}
# Install dir will be the final output to the framework.
# The following line create it in the root folder of the current project.
INSTALL_DIR=${SRCROOT}/Products/${FMK_NAME}.framework
# Working dir will be deleted after the framework creation.
WRK_DIR=build
DEVICE_DIR=${WRK_DIR}/Release-iphoneos/${FMK_NAME}.framework
SIMULATOR_DIR=${WRK_DIR}/Release-iphonesimulator/${FMK_NAME}.framework
# -configuration ${CONFIGURATION}
# Clean and Building both architectures.
xcodebuild -configuration "Release" -target "${FMK_NAME}" -sdk iphoneos clean build
xcodebuild -configuration "Release" -target "${FMK_NAME}" -sdk iphonesimulator clean build
# Cleaning the oldest.
if [ -d "${INSTALL_DIR}" ]
then
rm -rf "${INSTALL_DIR}"
fi
mkdir -p "${INSTALL_DIR}"
cp -R "${DEVICE_DIR}/" "${INSTALL_DIR}/"
# Uses the Lipo Tool to merge both binary files (i386 + armv6/armv7) into one Universal final product.
lipo -create "${DEVICE_DIR}/${FMK_NAME}" "${SIMULATOR_DIR}/${FMK_NAME}" -output "${INSTALL_DIR}/${FMK_NAME}"
rm -r "${WRK_DIR}"
open "${INSTALL_DIR}"

選中新建的Target，Run, 如果沒有異常的話，會自動彈出生成的Framework檔案

22.png

這樣生成的動態庫就能同時支援模擬器和真機了。

Xcode 6下製作通用靜態庫

上面我們也提到了，這樣生成的動態庫恐怕很難在Xcode 5上使用，那我們為什麼非要用動態庫呢，一般情況下不是用靜態庫就好了嗎？ So Easy!只需要修改一個引數即可生成靜態庫了。

23.png

使用靜態庫的話，就可以把Framework從‘Embedded Binaries’中刪除了. 親測在Xcode 5下可用。把新生成的庫匯入到測試工程，試試在模擬器和真機上執行，一切OK.

不巧，如果你用的真機是iPhone5 C, 那悲劇又要發成了，生成的Framework竟然不支援armv7s,不知是Xcode 6的bug，還是因為蘋果認為使用armv7s的裝置太少，可以不支援了.Xcode 新建工程，預設的Architectures竟然不包含armv7s.

24.png

想要生成的庫支援armv7s,把armv7s新增到Architectures中，重新生成Framework即可

25.png

判斷一個Framework支援哪些架構

我們該怎麼驗證生成的Framework支援哪些平臺呢，總不能一個個測試吧？當然不用.下面的命令是加上armv7s前後生成的framework的對比

1
2
3
4
Yearsdembp:Products Years$ lipo -info ./MyFramework.framework/MyFramework 
Architectures in the fat file: ./MyFramework.framework/MyFramework are: i386 x86_64 armv7 arm64 
Yearsdembp:Products Years$ lipo -info ./MyFramework.framework/MyFramework 
Architectures in the fat file: ./MyFramework.framework/MyFramework are: armv7 armv7s i386 x86_64 arm64

來源地址: http://www.cocoachina.com/ios/20141126/10322.html

相關文章