XCFramework制作

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

这样我们就生成了模拟器架构下和真机架构下的打包文件

image.png

在 xcarchive文件中，在Product文件夹下，存放着相对应的库文件。

image.png

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

image

然后我们在来进行合并,在 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文件。

image

使用xcframework创建的静态库没有出现含有重复架构的情况，并且也有头文件信息

在本例中我遇到了一个No 'swiftinterface' files found within的错误，这个需要将project文件中的 BUILD_FOR_LIBRARIES_FOR_DISTRIBUTION 设置为YES,然后，重新编译，就可以了。

image

使用xcframework

新建一个工程，然后将 LEEAlert.xcframework加入到 Frameworks里面

image

然后，导入头文件，就可以使用了

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混编静态库