这个报错的核心原因很明确：你用Xcode 12（对应Swift 5.3）编译的Custom.framework，其模块格式和Xcode 11.6（Swift 5.2.4）的编译器不兼容——Swift的次版本（比如5.2和5.3）之间，编译器生成的.swiftmodule文件结构有差异，即使开启BUILD_LIBRARY_FOR_DISTRIBUTION也无法解决这个跨版本兼容问题，因为这个flag主要是针对同一次版本内的ABI稳定优化，而非跨次版本兼容。

下面给你几个可行的解决方案，按推荐优先级排序：

方案一：对齐CI与项目的Xcode/Swift版本（最稳妥） #

• 调整你的Jenkins CI环境，改用Xcode 11.6来构建自定义框架。这样框架的Swift编译版本（5.2.4）和项目完全匹配，从根源上消除版本不兼容问题，也能避免后续潜在的语法、API兼容坑。

方案二：用Xcode 12构建兼容Swift 5.2的框架（如果必须保留Xcode12 CI） #

如果你因为某些原因必须用Xcode12构建框架，可以通过以下步骤让产物兼容Swift5.2.4：

1. 确认框架的Xcode构建设置中，BUILD_LIBRARY_FOR_DISTRIBUTION已经设为YES（你已经开启，这一步保持即可）
2. 在框架的Build Settings里，找到Swift Language Version，手动设置为Swift 5.2（不要用默认的5.3）。这样Xcode12会以Swift5.2的规则编译框架，生成的.swiftmodule就能被5.2.4的编译器识别。
3. 检查框架代码中是否使用了Swift5.3特有的语法（比如多模式catch语句、Result类型的扩展语法等），如果有，需要替换为Swift5.2兼容的写法，否则会编译失败。
4. 同步更新框架的Podspec文件，将s.swift_version字段设置为"5.2"，确保CocoaPods安装时能正确识别版本信息。

方案三：升级项目的Xcode版本（如果项目允许） #

如果项目的依赖和业务场景允许，直接将项目的开发环境升级到Xcode12或更高版本，让项目的Swift版本和框架保持一致，也能快速解决导入问题。不过升级前要确认项目的第三方依赖是否兼容新版本Xcode，避免引入新的问题。

额外提醒 #

BUILD_LIBRARY_FOR_DISTRIBUTION的作用是生成.swiftinterface文件，让框架在同一次Swift版本内（比如5.3.1和5.3.2）支持ABI兼容，但它无法跨越不同的次版本（5.2 vs 5.3）——这两个版本的编译器对模块的处理逻辑有差异，所以这个flag帮不上忙。

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