UG *-bin 重发与 BLFD 踩坑总结

适用范围 应用:home/ios/ugreenhome 发布脚本:home/cicd/ci 组件:home/ios/components/* 时间跨度:从开启 BUILD_LIBRARY_FOR_DISTRIBUTION(BLFD)开始,到 18 个 *-bin 组件重发、真机验证、cicd 收口 MR 为止。 0. 什么是 BLFD,为什么要开 BLFD = BUILD_LIBRARY_FOR_DISTRIBUTION = YES,是 Swift 的 Library Evolution / Module Stability 开关。开启后,编译器在生成二进制的同时输出一份 .swiftinterface 文件,完整描述模块对外暴露的 API。Importer 编译时优先读取 .swiftinterface,从而让一个预编译的 Swift 二进制框架可以被不同 Swift / Xcode 版本的 consumer 导入,避免小版本差异导致 ABI 破坏。 UG 的 *-bin 组件是通过 CocoaPods 分发的预编译二进制 framework,开发机、Runner CI、本地环境用的 Xcode / Swift 版本不可能完全一致。不开 BLFD 时,Swift 编译器小版本差异就可能让 consumer 在链接 / 运行时出现 Symbol not found 或 dyld: cannot load。开启后,一次发布即可跨多个 Xcode 版本使用,不用为每个 Xcode / Swift 版本各打一份二进制。 ...

October 18, 2026