Xcode15 Swift 制作 XCFramework

framework_sd.png

缘起

iOS 14新增了小组件功能，官方文档没有提供小组件动画或者加载gif图片相关的API，当产品问能不能实现小组件动图的时候，我理直气壮的回答NO，可是却遭到产品的灵魂发问：为什么别人家的App就可以呢？ 对呀我也想知道别人是怎么做到的。前不久终于在一篇博客上得知万能小组件的作者将小组件动画库开源了。研究了一下实现原理其实是调用苹果的一个未公开的API View._clockHandRotationEffect(.secondHand，in:.current，anchor:.center)，但这个api 在xcode14 上就被苹果干掉了，那么如何在Xcode14以上的版本调用这个api呢？虽然苹果把这条路堵上了，但还好给我们还留了一道门，那就是xcframework。它的特性就是支持二进制兼容性，可以在不同的Xcode版本和不同的平台之间进行共享和使用。那么我们只要在xcode13中将View._clockHandRotationEffect(.secondHand，in:.current，anchor:.center) 制作成xcframework 就可以在高版本Xcode中使用了。

我在制作xcframework的过程中，踩了许多坑，于是我就重新梳理出了一套流程，按着我的步骤来，保你免掉血一次通关。

前置条件：M1，Xcode14 或者 Xcode15

了解XCFramework

• XCFramework是Apple在Xcode 11中引入的一种跨平台打包格式。它被设计用于在不同的苹果平台（如iOS、macOS、watchOS等）之间共享和使用代码。
• XCFramework可以包含多个Framework，以支持不同平台和不同的设备架构。它支持二进制兼容性，可以在不同的Xcode版本和不同的平台之间进行共享和使用。
• 使用XCFramework可以更好地管理和分发跨平台的代码。它将多个平台所需的二进制文件、资源文件和头文件打包在一起，方便开发者在各个平台之间共享代码，并且可以在不同的Xcode版本中进行使用和更新。

通过 XCFramework的介绍，我们就知道了，要制作XCFramework首先得制作Framework。

创建Framework项目

1. 新建项目
   

   Untitled.png

2. 选择Framework
   

   Untitled 1.png

3. 填入基本信息
   

   Untitled 2.png

4. 新增一个swift文件，方便调试
   

   Untitled 3.png
   顺便提一下，swift不像OC可以暴露接口，在swift中要想给别的工程调用接口，记得在类，方法或属性前加public或者open，文章在后面会详细介绍权限控制符。

Framework 项目配置

1. 设置最低支持系统版本
   

   Untitled 4.png

2. Build Active Architecture Only 仅构建活动架构
   设置为"NO"时，Xcode将构建所有支持的设备架构，这样可以确保应用在不同设备上的兼容性
   

   Untitled 5.png

3. Excluded Architecture 排除架构
   即移除重复的架构, 因为真机和模拟器编译后，framework中arm64架构重复，会导致合并失败，所以移除模拟器中的arm64架构
   

   Untitled 6.png

4. Architecture 架构
   如果没有特殊要求，就用默认的arm64就可以了
   

   Untitled 7.png

5. Dead Code Stripping 无效代码剥离
   是一项优化技术，用于在iOS应用程序构建过程中删除未使用的代码，以减小最终应用的大小。但是对于framework来说, 应该设置为NO, 避免代码、调试符号等被剥离
   

   Untitled 8.png

6. Mach-O Type 类型
   这里设置类型为 Static Library（静态库）

Untitled 9.png

7. Build Libraries for Distribution 为分发构建库
   将 "Build Libraries for Distribution" 选项设置为 "Yes" 是为了确保生成的库文件包含必要的接口文件，以便于向下兼容性。这个选项告诉编译器生成 ".swiftinterface" 文件，这对于将来使用低版本的 Swift 编译器加载旧版本库非常重要。
   

   Untitled 10.png

8. Build Configuration 编译配置
   

   Untitled 11.png
   Untitled 12.png

9. 选择真机和模拟器分别 Command + B运行项目，在Product中找到framework
   

   Untitled 13.png
   Untitled 14.png

终端指令制作XCFramework

通过xcodebuild -create-xcframework命令即可完成制作 XCFramework 示例如下:

1. 终端 CD 到 Products 文件夹

   
   Untitled 15.png
   Untitled 16.png
2. 执行 xcodebuild -create-xcframework 命令

xcodebuild -create-xcframework\
                   -framework Release-iphoneos/HHTestKit.framework\
                   -framework Release-iphonesimulator/HHTestKit.framework\
                   -output HHTestKit.xcframework

Untitled 17.png

🎉🎉🎉合并成功， HHTestKit.xcframework 目录结构如下：

Untitled 18.png

附Swift权限控制符说明：

1. public:

   • 公开访问级别，最高级别。
   • 可以从任何地方访问和使用。
   • 公开的类、结构体、枚举或成员可以在定义它们的模块外部被子类化、实例化或访问。

2. internal:

   • 默认访问级别，如果不明确指定，默认为internal。
   • 可以在定义它们的模块中任何地方访问和使用。
   • 无法从模块外部访问。

3. fileprivate:

   • 文件私有访问级别。
   • 限制了只有在同一源文件中才能访问。
   • 无法在不同的源文件中访问。

4. private:

   • 私有访问级别。
   • 限制了只有在同一作用域中才能访问。
   • 无法在同一作用域外部或不同的源文件中访问。

5. open:

   • 用于类和类成员。
   • 允许其他模块继承或重写。
   • open访问级别比public更高，因为它允许其他模块继承和重写。

   ---

   感谢您的阅读和参与，HH思无邪愿与您一起在技术的道路上不断探索。如果您喜欢这篇文章，不妨留下您宝贵的赞！如果您对文章有任何疑问或建议，欢迎在评论区留言，我会第一时间处理，您的支持是我前行的动力，愿我们都能成为更好的自己！