闭源Swift框架Xcode兼容性问题：跨版本构建兼容方案咨询

我太懂这个痛点了——Xcode 9.2和9.3简直是Swift框架开发者的噩梦，刚好卡在Swift 4.0/3.2到4.1的ABI变化节点上，直接编译的框架一跨版本就报那个烦人的版本不兼容错误。下面是我亲测有效的几个解决方案，按优先级排序：

1. 优先改用静态框架（最省心的方案） #

• 动态框架的核心问题在于它会绑定编译时的Swift runtime版本，而Swift在5.0之前ABI完全不稳定，不同版本的Swift runtime根本无法兼容。静态框架则是直接被链接到客户的主程序中，会使用主程序的Swift runtime来解析代码，只要你的框架代码没有用目标Swift版本不支持的语法，就能完美兼容。
• 操作步骤：在框架项目的Build Settings里，找到Mach-O Type，把它从Dynamic Library改成Static Library，重新编译即可。
• 注意：静态框架无法直接包含资源文件，如果你的框架有图片、xib等资源，需要单独打包成bundle交给客户，或者在框架代码中通过bundle路径加载资源。

2. 分版本编译框架（最稳妥的动态框架方案） #

如果业务必须使用动态框架，那只能针对每个目标Xcode版本单独编译：

• 用Xcode 9.2（对应Swift 3.2/4.0）编译一个专供Xcode 9.2及以下用户的框架版本；
• 用Xcode 9.3（对应Swift 4.1）编译另一个专供Xcode 9.3及以上用户的版本；
• 给客户提供清晰的版本说明，明确告知哪个框架版本对应哪个Xcode版本。
• 进阶技巧：可以用xcodebuild命令行脚本自动完成多版本编译，比如指定-toolchain参数调用不同Xcode的工具链，然后把编译产物整理到不同目录下，减少手动操作的麻烦。

3. 限制框架使用的Swift语法到最低兼容版本 #

不管用静态还是动态框架，都要确保你的框架代码没有使用高版本Swift特有的语法：

• 比如Swift 4.1新增的条件一致性优化、Sequence的新方法等，这些语法在Swift 4.0/3.2环境中根本无法编译；
• 在框架项目的Build Settings里，把SWIFT_VERSION设置为4.0，这样Xcode会自动检查并提示你是否有超出Swift 4.0的语法；
• 如果需要兼容Swift 3.2，把SWIFT_VERSION设为3.2，同时开启Use Legacy Swift Language Version（不过这个选项在Xcode 9.3以后就被移除了，所以只适合用Xcode 9.2编译的版本）。

额外避坑提醒 #

• 绝对不要尝试用lipo合并不同Swift版本编译的动态框架，这会导致更严重的运行时崩溃，因为它们绑定的Swift runtime完全不兼容；
• 如果你后续要支持更高版本的Xcode（比如Xcode 10+），记得Swift 5.0以后ABI稳定了，只要你的框架是用Swift 5.0及以上编译的，就能兼容后续所有Swift版本。

内容的提问来源于stack exchange，提问作者Andrea