XCFramework
XCFramework
是苹果官方推荐的、支持的,可以更方便的表示一个多个平台和架构的分发二进制的格式,需要XCode11以上。
制作静态库
模拟器架构
先将工程编译为 iphoneSimulator架构
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中实际使用的命令。 -
archive
: 打包。 -
project
: 工程名。 -
scheme
: 选择 scheme。 -
configuration
: 哪种环境下。 -
destination
: 要分发的平台,当前指定的是 iOS Simulator。 -
archivePath
: 压缩之后,存放的路径。 -
SKIP_INSTALL=NO
:如果设置为YES,则不会将生成的framwork文件存放在Products目录下。
真机架构
接下来,我们来编译真机的架构
xcodebuild archive -project 'LEEAlert.xcodeproj' \
-scheme 'LEEAlert' \
-configuration Release \
-destination 'generic/platform=iOS' \
-archivePath '../archives/LEEAlert.framework-iphoneos.xcarchive' \
SKIP_INSTALL=NO
这样我们就生成了模拟器架构下和真机架构下的打包文件
在 xcarchive
文件中,在Product
文件夹下,存放着相对应的库文件。
lipo命令合并
接下来,我们将这两个架构下的framework进行合并,我们使用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
复制代码
-
-output
: 输出的名称。 - 需要合并文件的路径。
我们会遇到一个have the same architectures (arm64) and can't be in the same fat output file
的错误
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
复制代码
这是因为模拟器架构下的静态库有arm64
,真机架构下的静态库也有arm64
,有相同的架构导致不能合并。 我们将 x86_64 架构从静态库文件中提取出来,这样就保证了只有一种架构,不会重复。
lipo -output LEEAlert-x86_64 -extract x86_64 ../archives/LEEAlert.framework-iphonesimulator.xcarchive/Products/Library/Frameworks/LEEAlert.framework/LEEAlert
然后我们在来进行合并,在 archives
的同目录下,我们新建lipo文件夹,并将产出存放到该目录。
bel@beldeMacBook-Pro lipo % lipo -output LEEAlert -create ../archives/LEEAlert.framework-iphoneos.xcarchive/Products/Library/Frameworks/LEEAlert.framework/LEEAlert ../LEEAlert/LEEAlert-x86_64
接下来,我们还需要给静态库文件配置头文件和资源文件等信息,比较繁琐。使用lipo命令来创建静态库存在两个问题:
1,含有相同架构的两个静态库不能合并。
2,配置头文件和资源文件比较繁琐。
XCFramework
和传统的framework相比:
- 1,可以用单个.xcframework文件提供多个平台的分发二进制文件;
- 2,与
Fat Header
相比,可以按照平台划分,可以包含相同架构的不同平台文件。 - 3,在使用时,不需要再通过脚本去剥离不需要的架构体系。
创建xcframework
接下来我们创建一个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
复制代码
-
-framework
: framework的路径 -
-debug-symbols
:调试符号,必须为绝对路径 -
-output
: 输出位置
这样我们就生成了xcframework文件
。
使用xcframework创建的静态库没有出现含有重复架构的情况,并且也有头文件信息
在本例中我遇到了一个No 'swiftinterface' files found within
的错误,这个需要将project文件中的 BUILD_FOR_LIBRARIES_FOR_DISTRIBUTION 设置为YES,然后,重新编译,就可以了。
使用xcframework
新建一个工程,然后将 LEEAlert.xcframework
加入到 Frameworks里面
然后,导入头文件,就可以使用了
import UIKit
import LEEAlert
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
LYPerson.run()
}
}
LYXCFrameworkTe[7770:14236252] 正在跑步......
复制代码
当我们将文件拖入Xcode中,Xcode会根据我们运行的架构,选择相对应架构的文件。如果我们运行的是模拟器,只会拷贝x86架构的文件,如果运行的是真机设备,只会拷贝arm64架构的文件,这样可以减少App包的体积。
这样我们就使用XCFramework来完成了静态库的制作,相比较于lipo
,xcframework有几个有点:
- 1,无需处理头文件。
- 2,没有重复架构的问题。
- 3,在链接的时候,会自动选择相应的架构,无需全部拷贝至App,减小了App体积。
如果使用Xcode来制作静态库,有兴趣的可以参考一下这篇文章XCode12制作Swift和OC混编静态库