XCFramework
XCFramework
是蘋(píng)果官方推薦的缺谴、支持的彬碱,可以更方便的表示一個(gè)多個(gè)平臺(tái)和架構(gòu)的分發(fā)二進(jìn)制的格式,需要XCode11以上晋辆。
制作靜態(tài)庫(kù)
模擬器架構(gòu)
先將工程編譯為 iphoneSimulator架構(gòu)
xcodebuild archive -project 'LEEAlert.xcodeproj' \
-scheme 'LEEAlert' \
-configuration Release \
-destination 'generic/platform=iOS Simulator' \
-archivePath '../archives/LEEAlert.framework-iphonesimulator.xcarchive' \
SKIP_INSTALL=NO
-
xcodebuild
: 在Xcode中實(shí)際使用的命令廓奕。 -
archive
: 打包抱婉。 -
project
: 工程名。 -
scheme
: 選擇 scheme桌粉。 -
configuration
: 哪種環(huán)境下蒸绩。 -
destination
: 要分發(fā)的平臺(tái),當(dāng)前指定的是 iOS Simulator铃肯。 -
archivePath
: 壓縮之后患亿,存放的路徑。 -
SKIP_INSTALL=NO
:如果設(shè)置為YES缘薛,則不會(huì)將生成的framwork文件存放在Products目錄下窍育。
真機(jī)架構(gòu)
接下來(lái),我們來(lái)編譯真機(jī)的架構(gòu)
xcodebuild archive -project 'LEEAlert.xcodeproj' \
-scheme 'LEEAlert' \
-configuration Release \
-destination 'generic/platform=iOS' \
-archivePath '../archives/LEEAlert.framework-iphoneos.xcarchive' \
SKIP_INSTALL=NO
這樣我們就生成了模擬器架構(gòu)下和真機(jī)架構(gòu)下的打包文件
在 xcarchive
文件中宴胧,在Product
文件夾下,存放著相對(duì)應(yīng)的庫(kù)文件表锻。
lipo命令合并
接下來(lái)恕齐,我們將這兩個(gè)架構(gòu)下的framework進(jìn)行合并,我們使用lipo
命令
lipo -output LEEAlert -create ../archives/LEEAlert.framework-iphoneos.xcarchive/Products/Library/Frameworks/LEEAlert.framework/LEEAlert ../archives/LEEAlert.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/LEEAlert.framework/LEEAlert
復(fù)制代碼
-
-output
: 輸出的名稱(chēng)瞬逊。 - 需要合并文件的路徑显歧。
我們會(huì)遇到一個(gè)have the same architectures (arm64) and can't be in the same fat output file
的錯(cuò)誤
fatal error: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/lipo: ../archives/LEEAlert.framework-iphoneos.xcarchive/Products/Library/Frameworks/LEEAlert.framework/LEEAlert and ../archives/LEEAlert.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/LEEAlert.framework/LEEAlert have the same architectures (arm64) and can't be in the same fat output file
復(fù)制代碼
這是因?yàn)槟M器架構(gòu)下的靜態(tài)庫(kù)有arm64
,真機(jī)架構(gòu)下的靜態(tài)庫(kù)也有arm64
确镊,有相同的架構(gòu)導(dǎo)致不能合并士骤。 我們將 x86_64 架構(gòu)從靜態(tài)庫(kù)文件中提取出來(lái),這樣就保證了只有一種架構(gòu)蕾域,不會(huì)重復(fù)拷肌。
lipo -output LEEAlert-x86_64 -extract x86_64 ../archives/LEEAlert.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/LEEAlert.framework/LEEAlert
然后我們?cè)趤?lái)進(jìn)行合并,在 archives
的同目錄下,我們新建lipo文件夾旨巷,并將產(chǎn)出存放到該目錄巨缘。
bel@beldeMacBook-Pro lipo % lipo -output LEEAlert -create ../archives/LEEAlert.framework-iphoneos.xcarchive/Products/Library/Frameworks/LEEAlert.framework/LEEAlert ../LEEAlert/LEEAlert-x86_64
接下來(lái),我們還需要給靜態(tài)庫(kù)文件配置頭文件和資源文件等信息采呐,比較繁瑣若锁。使用lipo命令來(lái)創(chuàng)建靜態(tài)庫(kù)存在兩個(gè)問(wèn)題:
1,含有相同架構(gòu)的兩個(gè)靜態(tài)庫(kù)不能合并斧吐。
2又固,配置頭文件和資源文件比較繁瑣仲器。
XCFramework
和傳統(tǒng)的framework相比:
- 1,可以用單個(gè).xcframework文件提供多個(gè)平臺(tái)的分發(fā)二進(jìn)制文件仰冠;
- 2乏冀,與
Fat Header
相比,可以按照平臺(tái)劃分沪停,可以包含相同架構(gòu)的不同平臺(tái)文件煤辨。 - 3,在使用時(shí)木张,不需要再通過(guò)腳本去剝離不需要的架構(gòu)體系众辨。
創(chuàng)建xcframework
接下來(lái)我們創(chuàng)建一個(gè)xcframework
bel@beldeMacBook-Pro xcframework % xcodebuild -create-xcframework \
-framework '../archives/LEEAlert.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/LEEAlert.framework' \
-debug-symbols '/Users/bel/Desktop/gitBox/Examples/archives/LEEAlert.framework-iphonesimulator.xcarchive/dSYMs/LEEAlert.framework.dSYM' \
-framework '../archives/LEEAlert.framework-iphoneos.xcarchive/Products/Library/Frameworks/LEEAlert.framework' \
-debug-symbols '/Users/bel/Desktop/gitBox/Examples/archives/LEEAlert.framework-iphoneos.xcarchive/BCSymbolMaps/0C1C6181-F2E0-3D17-8573-65CC6AEDBD97.bcsymbolmap' \
-debug-symbols '/Users/bel/Desktop/gitBox/Examples/archives/LEEAlert.framework-iphoneos.xcarchive/BCSymbolMaps/7D66A732-3121-386D-8397-5F44DEA908F1.bcsymbolmap' \
-debug-symbols '/Users/bel/Desktop/gitBox/Examples/archives/LEEAlert.framework-iphoneos.xcarchive/dSYMs/LEEAlert.framework.dSYM' \
-output 'LEEAlert.xcframework'
xcframework successfully written out to: /Users/bel/Desktop/gitBox/Examples/xcframework/LEEAlert.xcframework
復(fù)制代碼
-
-framework
: framework的路徑 -
-debug-symbols
:調(diào)試符號(hào),必須為絕對(duì)路徑 -
-output
: 輸出位置
這樣我們就生成了xcframework文件
舷礼。
使用xcframework創(chuàng)建的靜態(tài)庫(kù)沒(méi)有出現(xiàn)含有重復(fù)架構(gòu)的情況鹃彻,并且也有頭文件信息
在本例中我遇到了一個(gè)No 'swiftinterface' files found within
的錯(cuò)誤,這個(gè)需要將project文件中的 BUILD_FOR_LIBRARIES_FOR_DISTRIBUTION 設(shè)置為YES,然后妻献,重新編譯蛛株,就可以了。
使用xcframework
新建一個(gè)工程育拨,然后將 LEEAlert.xcframework
加入到 Frameworks里面
然后谨履,導(dǎo)入頭文件,就可以使用了
import UIKit
import LEEAlert
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
LYPerson.run()
}
}
LYXCFrameworkTe[7770:14236252] 正在跑步......
復(fù)制代碼
當(dāng)我們將文件拖入Xcode中熬丧,Xcode會(huì)根據(jù)我們運(yùn)行的架構(gòu)笋粟,選擇相對(duì)應(yīng)架構(gòu)的文件。如果我們運(yùn)行的是模擬器析蝴,只會(huì)拷貝x86架構(gòu)的文件害捕,如果運(yùn)行的是真機(jī)設(shè)備,只會(huì)拷貝arm64架構(gòu)的文件闷畸,這樣可以減少App包的體積尝盼。
這樣我們就使用XCFramework來(lái)完成了靜態(tài)庫(kù)的制作,相比較于lipo
佑菩,xcframework有幾個(gè)有點(diǎn):
- 1盾沫,無(wú)需處理頭文件。
- 2倘待,沒(méi)有重復(fù)架構(gòu)的問(wèn)題疮跑。
- 3,在鏈接的時(shí)候凸舵,會(huì)自動(dòng)選擇相應(yīng)的架構(gòu)祖娘,無(wú)需全部拷貝至App,減小了App體積。
如果使用Xcode來(lái)制作靜態(tài)庫(kù)渐苏,有興趣的可以參考一下這篇文章XCode12制作Swift和OC混編?kù)o態(tài)庫(kù)