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->Frameworks，Frameworks存在一个叫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_v7和arm64两种架构。这个和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的优势：
- 不用手动处理头文件、资源文件等内容（
lipo合并后需要链接） - 重复架构可自行处理，（免去
lipo指令重复时需要提取指定架构的步骤） - 更方便的导入调式符号，直接在指令中完成
- 自动链接相应平台架构的库文件，将不需要的架构去掉（上线时自动去掉模拟器架构）
