xcframework生成与使用
1、XCFramework定义?
XCFramework:是苹果官⽅推荐的、⽀持的,可以更⽅便的表示⼀个多个平台和架构的分发⼆进制库的格式。需要Xcode11以上⽀持。是为更好的⽀持Mac Catalyst(用于 iPad)和ARM芯⽚的macOS。专⻔在2019年提出的framework的另⼀种先进格式。
2、XCFramework和传统的framework相⽐的三个优点:
- 可以⽤单个.xcframework⽂件提供多个平台的分发⼆进制⽂件;
- 与Fat Header相⽐,可以按照平台划分,可以包含相同架构的不同平台的⽂件;
- 在使⽤时,不需要再通过脚本去剥离不需要的架构体系。
3、架构
- iOS/iPad:arm64
- iOS/iPad Simulator:x86_64 arm64
- Mac Catalyst: x86_64 arm64
- Mac: x86_64 arm64
4、XCFramework的多架构合并
- 生成架构文件
// (1)生成模拟器的架构文件
// 编译工程
xcodebuild archive -project 'SYTimer.xcodeproj' \
// 指定scheme
-scheme 'SYTimer' \
// 指定configuration
-configuration Release \
// 指定分发平台
-destination 'generic/platform=iOS Simulator' \
// 指定生成文件的路径及名称这里生成模拟器的架构文件
-archivePath '../archives/SYTimer.framework-iphonesimulator.xcarchive' \
// 指定SKIP_INSTALL为NO只有设置为NO时才会将生成的文件放进指定的archives目录下
SKIP_INSTALL=NO
// (2)生成真机的架构文件
xcodebuild archive -project 'SYTimer.xcodeproj' \
-scheme 'SYTimer' \
-configuration Release \
-destination 'generic/platform=iOS' \
-archivePath '../archives/SYTimer.framework-iphoneos.xcarchive' \
SKIP_INSTALL=NO
为什么生成的SYTimer.framework-iphoneos.xcarchive有调试文件?
答:在 release 模式下,生成真机文件时会自动打开bitcode,生成模拟器文件时会自动关闭bitcode。bitcode 打开后,会在 MAC 中生成一个新的段,段名叫 __LLVM,这个段就包含了 bitcode 的信息。模拟器生成的文件里面是没有__LLVM,所以就不会有 bitcode信息。
- 胖二进制
胖二进制含义:就是多个二进制架构文件合并在一起,且不能出现相同的架构。合并时会将不同架构文件的 mach header 挨着在一起形成 fat header,并不是真正的合并。
- 胖二进制
-
lipo命令
lipo命令含义:创建或操作通用文件。
合并库文件:使用lipo 命令,但是该命令合并的库文件不能有相同架构的命令,需要手动处理头文件、资源文件
缺点:1、相同架构的文件不能合并。2、需要手动要合并文件的头文件和里面的资源内容 3、还需手动处理DYSM文件
合并命令:lipo -output 合并后文件名 -create 合并库文件路径1 合并库文件路径2
-
// 提取SYTimer.framework-iphonesimulator.xcarchive里面x86_64架构的可执行文件
lipo -output SYTimer-x86_64 -extract x86_64 ../archives/SYTimer.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/SYTimer.framework/SYTimer
// 提取SYTimer.framework-iphoneos.xcarchive里面arm64架构的可执行文件
lipo -output SYTimer-arm64 -extract arm64 ../archives/SYTimer.framework-iphoneos.xcarchive/Products/Library/Frameworks/SYTimer.framework/SYTimer
// 合并提取出来的两个架构的文件
lipo -output SYTimer -create ../lipo/SYTimer-arm64 ../lipo/SYTimer-x86_64
- 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'
- 生成含有调试文件的XCFramework文件
生成XCFramework文件没有DeBug调试模式下的信息,所以需要生成待调试信息的XCFramework文件
注意:-debug-symbols后面的路径必须是绝对路径
- 生成含有调试文件的XCFramework文件
xcodebuild -create-xcframework -framework '../archives/SYTimer.framework-iphoneos.xcarchive/Products/Library/Frameworks/SYTimer.framework' \
-debug-symbols '/Users/xiaokang/Desktop/逻辑学习/逻辑高级强化/20210125强化班第五课/第五节、动态库与静态库实战/self/多架构合并/archives/SYTimer.framework-iphoneos.xcarchive/BCSymbolMaps/04D74607-6CFC-3746-831A-42374DF25FAD.bcsymbolmap' \
-debug-symbols '/Users/xiaokang/Desktop/逻辑学习/逻辑高级强化/20210125强化班第五课/第五节、动态库与静态库实战/self/多架构合并/archives/SYTimer.framework-iphoneos.xcarchive/BCSymbolMaps/C82E676C-12D6-301C-B131-8AD6D36A27CD.bcsymbolmap' \
-debug-symbols '/Users/xiaokang/Desktop/逻辑学习/逻辑高级强化/20210125强化班第五课/第五节、动态库与静态库实战/self/多架构合并/archives/SYTimer.framework-iphoneos.xcarchive/dSYMs/SYTimer.framework.dSYM' \
-framework '../archives/SYTimer.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/SYTimer.framework' \
-debug-symbols '/Users/xiaokang/Desktop/逻辑学习/逻辑高级强化/20210125强化班第五课/第五节、动态库与静态库实战/self/多架构合并/archives/SYTimer.framework-iphonesimulator.xcarchive/dSYMs/SYTimer.framework.dSYM' \
-output 'SYTimer.xcframework'
- XCFramework文件的使用
使用方法:直接将项目拖入 Target-》General-》Frameworks,Libraries,Embedded Content中就可以直接使用XCFramework文件了。
编译成功后,在生成的APP里面可以看到SYTimer.framework被复制了一份,这份文件是根据当前编译的架构自动选择对应架构所以相比于lipo 命令XCFramework文件具有以下优点:1、不用选择头文件 2、不用管理重复架构的问题 3、可以把调试符号放入项目。
- XCFramework文件的使用