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

你可能感兴趣的:(XCFramework制作)