RN Runtime:Xcode 26 ↔ 27 二进制不兼容的原因

现象 用 Xcode 27 编译主工程时,若本地 RN Runtime 仍是 Xcode 26.6 打的预编译包,链接阶段失败: Undefined symbols for architecture arm64: method descriptor for Cxx.CxxPair.first.getter method descriptor for Cxx.CxxPair.second.getter 来源:NitroModules(AnyMap.o) 反向也成立:Xcode 27 的包拿到 Xcode 26.6 下去编,会缺另一组 Iterable / makeBorrowingIterator 相关符号。 结论(先看这个) 这不是某个编译参数(-fxxx / OTHER_SWIFT_FLAGS / BUILD_LIBRARY_FOR_DISTRIBUTION)能补丁过去的问题。 根因是: Swift 6.3.3(Xcode 26.6) → Swift 6.4(Xcode 27) 系统自带的 Swift–C++ 互通层(Cxx overlay)里,CxxPair 协议的 ABI 变了。预编译的 NitroModules 已经写死了对「旧 method descriptor」的引用;消费端换编译参数,补不出这些符号。 因此:同一套预编译 RN Runtime,不能跨 Xcode 大版本混用。 官方有痕迹,但没有面向 App 开发者的点名预警。官方提前说的是「C++ 互通还在变,用兼容模式保源码」,没有提前说「Xcode 26 的 Swift–Cxx 预编译包不能给 27 链接」。这是语言演进的必然结果,不是未公开的私有变更;发行说明漏了二进制兼容这一层。 ...

September 15, 2026