Xcode 6製作動態及靜態Framework

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

有沒有寫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

相關文章