xcframework生成与使用

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. 生成架构文件

//  (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信息。

LLVM查看

• 2. 胖二进制
     胖二进制含义：就是多个二进制架构文件合并在一起，且不能出现相同的架构。合并时会将不同架构文件的 mach header 挨着在一起形成 fat header，并不是真正的合并。

• 3. lipo命令
     lipo命令含义：创建或操作通用文件。
     合并库文件：使用lipo 命令，但是该命令合并的库文件不能有相同架构的命令，需要手动处理头文件、资源文件
     缺点：1、相同架构的文件不能合并。2、需要手动要合并文件的头文件和里面的资源内容 3、还需手动处理DYSM文件
     合并命令：lipo -output 合并后文件名 -create 合并库文件路径1 合并库文件路径2

     
     
     lipo合并多架构出现的重复问题.png

 //  提取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

• 4. 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'

• 5. 生成含有调试文件的XCFramework文件
     生成XCFramework文件没有DeBug调试模式下的信息，所以需要生成待调试信息的XCFramework文件
     注意：-debug-symbols后面的路径必须是绝对路径

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'

• 6. XCFramework文件的使用
     使用方法：直接将项目拖入 Target-》General-》Frameworks，Libraries，Embedded Content中就可以直接使用XCFramework文件了。
     编译成功后，在生成的APP里面可以看到SYTimer.framework被复制了一份，这份文件是根据当前编译的架构自动选择对应架构所以相比于lipo 命令XCFramework文件具有以下优点：1、不用选择头文件 2、不用管理重复架构的问题 3、可以把调试符号放入项目。