iOS开发进阶六:lipo指令和XCFramework

背景:XCFramework之前的多架构合并

我们生成一个库文件,可能有模拟器的架构,也可能有真机的架构。但我们通常给别人提供SDK的时候都是将各种平台架构的库合在一起。引入一个库文件,就可以支持调试和在真机上运行。这种格式的库我们通常叫他Fat Binary(胖二进制)

xcodebuild指令

xcodebuild -- build Xcode projects and workspaces,Xcode中自带的打包工具,平时我们用xcode打包就是用的这个玩意。

xcodebuild archive     #打包操作     
           -archivePath <archivePath>  #打包后的输出路径
           -project <projectName>  #项目名称
           -workspace <workspaceName> #项目空间名称
           -scheme <schemeName>    #指定是项目中哪个scheme,可以从-list命令中获取
           -configuration <Debug|Release>   #哪种环境,Debug还是Release
           -destination <DESTINATIONSPECIFIER>  #分发的平台

编译一个模拟器架构的库

xcodebuild archive -project 'SYTimer.xcodeproj' \
-scheme 'SYTimer' \
-configuration Release \
-destination 'generic/platform=iOS Simulator' \
-archivePath '../archives/SYTimer.framework-iphonesimulator.xcarchive' \
SKIP_INSTALL=NO

执行完后会在项目同级目录生成一个archives文件夹,里面包含iphonesimulator.xcarchive文件,右键显示包内容,会看到Products->Library->FrameworksFrameworks存在一个叫SYTimer.framework的库,这个库就是我们编译好的framework

xcodebuild打包指令.png

从图中可以看到多了一个参数:

SKIP_INSTALL=NO

设置这个参数的意义在于:是否将编译好的库拷贝到Products目录下,如果SKIP_INSTALL=YES,则Products目录下为空。我们做库合并时,需要用到Framework,所以必须加上这个参数。

编译一个真机架构的库

修改xcodebuild指令中的分发平台输出路径参数:

-destination 'generic/platform=iOS' \
-archivePath '../archives/SYTimer.framework-iphoneos.xcarchive' \

lipo指令将模拟器和真机架构合并

使用file SYTimer命令可以查看库文件包含的架构。

打包命令中,并没有指定架构。但打包后SYTimer可执行文件中,包含了arm_v7arm64两种架构。这个和SYTimer项目中的Build Settings设置有关,在打包时也执行了Build Settings中的设置。

架构合并需要使用lipo命令。将不同的架构合并到一起,生成一个胖二进制。但lipo命令却不能将包含相同架构的库进行合并。在上面生成的两个库文件中均包含了arm64,无法进行合并。

lipo -output SYTimer -create ../archives/SYTimer.framework-iphoneos.xcarchive/Products/Library/Frameworks/SYTimer.framework/SYTimer ../archives/SYTimer.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/SYTimer.framework/SYTimer
lipo指令合并相同架构发生错误.png

lipo指令无法合并的解决办法

使用lipo命令,最大的问题就是包含相同架构,无法合并Fat Binary。这种情况只能将所需的架构提取出来,再进行合并。

lipo -output SYTimer-x86_64 -extract x86_64 ../archives/SYTimer.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/SYTimer.framework/SYTimer

从模拟器中提取x86_64架构,输出到当前目录生成SYTimer-x86_64文件。再与真机库进行合并,因为arm64只有真机存在,所以可以执行合并成功了。

lipo -output SYTimer -create ../archives/SYTimer.framework-iphoneos.xcarchive/Products/Library/Frameworks/SYTimer.framework/SYTimer  SYTimer-x86_64
lipo指令合并成功.png

生成XCFramework

  • XCFramework:是苹果官方推荐的、支持的,可以更方便的表示一个多个平台和架构的分发进制库的格式。
  • 需要Xcode11以上支持。
  • 是为更好的支持Mac Catalyst和ARM芯片的macOS。
  • 专门在2019年提出的Framework的另一种先进格式。

和传统的Framework相⽐:

  • 可以⽤单个.xcframework⽂件提供多个平台的分发⼆进制⽂件
  • Fat Header相⽐,可以按照平台划分,可以包含相同架构的不同平台的⽂件
  • 在使⽤时,不需要再通过脚本去剥离不需要的架构体系

将两个架构的Framework合并成XCFramework

使用xcodebuild命令,将模拟器和真机两个平台的Framework合并成XCFramework

xcodebuild -create-xcframework \
-framework '../archives/SYTimer.framework-iphoneos.xcarchive/Products/Library/Frameworks/SYTimer.framework' \
-framework '../archives/SYTimer.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/SYTimer.framework' \
-output 'SYTimer.xcframework'
xcodebuild将两个架构Framework编译成XCFramework.png

一般XCFramework需要包含BitCode和dSYMs方便崩溃时恢复调用栈,那么修改创建XCFramework的命令如下:

xcodebuild -create-xcframework \
-framework '../archives/SYTimer.framework-iphoneos.xcarchive/Products/Library/Frameworks/SYTimer.framework' \
-debug-symbols '/Users/chenshuangchao/Desktop/archives/SYTimer.framework-iphoneos.xcarchive/BCSymbolMaps/618E16C1-20B9-39A5-98A1-42E947A26ADB.bcsymbolmap' \
-debug-symbols '/Users/chenshuangchao/Desktop/archives/SYTimer.framework-iphoneos.xcarchive/BCSymbolMaps/6E502109-851C-3FA9-A5B9-8A1373F73FE5.bcsymbolmap' \
-debug-symbols '/Users/chenshuangchao/Desktop/archives/SYTimer.framework-iphoneos.xcarchive/dSYMs/SYTimer.framework.dSYM' \
-framework '../archives/SYTimer.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/SYTimer.framework' \
-debug-symbols '/Users/chenshuangchao/Desktop/archives/SYTimer.framework-iphonesimulator.xcarchive/dSYMs/SYTimer.framework.dSYM' \
-output 'SYTimer.xcframework'
  • 只有真机才有BitCode。
  • BitCode和dSYMs的文件路径必须传绝对路径,否则会出现错误the path does not point to a valid debug symbols file。

上面指令也可以用脚本实现

ARCHIVES=/Users/chenshuangchao/Desktop/archives
# -debug-symbols:必须使用绝对路径
# Shell变量必须放在""中
xcodebuild -create-xcframework \
-framework '../archives/SYTimer.framework-iphoneos.xcarchive/Products/Library/Frameworks/SYTimer.framework' \
-debug-symbols "${ARCHIVES}/SYTimer.framework-iphoneos.xcarchive/BCSymbolMaps/9D87CD30-46F3-302A-ADCF-BF46F07578D4.bcsymbolmap" \
-debug-symbols "${ARCHIVES}/SYTimer.framework-iphoneos.xcarchive/BCSymbolMaps/ACA28AC6-6E0E-3F6F-8105-BC1175739A0B.bcsymbolmap" \
-debug-symbols "${ARCHIVES}/SYTimer.framework-iphoneos.xcarchive/dSYMs/SYTimer.framework.dSYM" \
-framework '../archives/SYTimer.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/SYTimer.framework' \
-debug-symbols "${ARCHIVES}/SYTimer.framework-iphonesimulator.xcarchive/dSYMs/SYTimer.framework.dSYM" \
-output 'SYTimer.xcframework'
给XCFramework添加debug-symbols成功.png

xcframework文件和普通Framework文件的使用别无二致。xcframework中打包了多个平台的Framework,比普通Framework文件更大。但在实际使用中,xcframework会根据当前链接的平台架构,仅链接相应的库文件,不会将整个xcframework全部链接。

XCFramework的结构.png

xcframework的优势:

  1. 不用手动处理头文件、资源文件等内容(lipo合并后需要链接)
  2. 重复架构可自行处理,(免去lipo指令重复时需要提取指定架构的步骤)
  3. 更方便的导入调式符号,直接在指令中完成
  4. 自动链接相应平台架构的库文件,将不需要的架构去掉(上线时自动去掉模拟器架构)
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,013评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,205评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,370评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,168评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,153评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,954评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,271评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,916评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,382评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,877评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,989评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,624评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,209评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,199评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,418评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,401评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,700评论 2 345

推荐阅读更多精彩内容