在Xcode 13.0中使用Xcode 12.5.1构建的iOS框架报SDK不兼容错误

这个是跨Xcode版本集成预编译Swift框架的常见问题，大量开发者在Swift大版本迭代更新时都遇到过同类报错，核心原因是默认构建的Swift框架没有开启模块稳定性支持，不同版本的Swift编译器无法识别其他版本生成的Swift模块。

可执行解决方案 #

• 方案1：开启框架的分发构建支持（长期最优解）
  在你的iOS框架项目的Xcode Build Settings中，将Build Libraries for Distribution选项设置为YES。开启该选项后，编译器会同时生成通用的Swift模块接口文件（.swiftinterface），而非仅绑定当前Swift版本的二进制模块，后续不管是更高还是兼容版本的Xcode都可以正常集成使用该框架。
  注意开启该配置后，需要避免在框架代码中使用Swift私有API、@_spi标记的内部接口等未稳定特性，否则可能导致接口文件生成失败。
• 方案2：匹配对应版本的工具链（临时无需改框架的解法）
  你可以下载Xcode 12.5.1对应的Swift 5.4.2官方工具链，安装后在Xcode 13的「设置 - 工具链」面板中选择该旧版本工具链进行项目编译，即可绕过版本校验报错。该方案的缺点是你无法在集成项目中使用Swift 5.5及更高版本的新语法特性。
• 方案3：用Xcode 13重新构建框架（最快临时适配方案）
  直接使用Xcode 13重新编译出一版对应Swift 5.5的框架包，单独提供给使用Xcode 13及以上版本的接入方使用，该方案无需修改原有构建逻辑，缺点是需要多维护一份不同Xcode版本构建的框架产物，后续版本迭代会增加管理成本。

常见踩坑说明 #

如果开启Build Libraries for Distribution后仍然出现报错，可以检查以下两项配置：

• 确认框架项目的SWIFT_VERSION设置为通用的兼容版本，未绑定仅旧版本支持的Swift语法规则
• 确认Swift Compiler - Code Generation > Optimization Level未设置为仅调试/仅当前版本生效的激进优化选项

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