预构建第三方依赖为二进制框架的Xcode构建问题咨询

1. 搞定库进化警告+宿主能导入B/C的矛盾 #

别用@_implementationOnly import，这玩意儿会把B/C藏成私有实现，宿主肯定导不了。要解决警告，必须让B/C本身都开启库进化支持：

• 要是B/C是你自己编译的，在它们的Xcode Target Build Settings里，把BUILD_BINARY_FOR_DISTRIBUTION设为YES，同时SKIP_INSTALL设为NO，这样归档的时候才会生成完整的模块文件（包括.swiftinterface）。
• 要是B/C是第三方现成的二进制框架，得确认人家本身就开了库进化支持，不然警告消不掉，还保证不了A的二进制兼容性。

2. 解决.swiftinterface找不到B模块的问题 #

你分发Framework A的时候，必须同时把B/C的二进制框架（xcframework格式）一起发出去。宿主项目里得同时添加A、B、C三个框架：

• 把它们都加到宿主Target的Frameworks, Libraries, and Embedded Content里。
• 归档A的时候，得确保Xcode能找到B/C的.swiftinterface，不然生成的A的.swiftinterface就会报找不到模块的错。

3. 解决静态依赖导致的未定义符号错误 #

用静态框架B出现未定义符号，基本是链接环节没弄对，按这几步排查：

• 查看Framework A的Build Settings里，Other Linker Flags有没有加-ObjC或者-all_load（如果B里有Category或者全局静态变量，必须加这个才能让链接器找到符号）。
• 如果A是动态框架，编译A的时候得把静态框架B的符号合并进去：把B加到A的Link Binary With Libraries里，归档的时候要确认静态库符号已经嵌进动态框架了。
• 如果A是静态框架，宿主必须自己把B也加到Link Binary With Libraries里——静态框架不会自动传递依赖，所有层级的静态依赖都得宿主手动链接。

几个关键提醒 #

• 动态和静态框架的依赖逻辑不一样：动态框架能把静态依赖的符号嵌进去，静态框架的依赖必须宿主手动添加。
• 所有要分发的框架，架构（比如arm64、x86_64）、iOS版本、Swift版本必须统一，不然链接或者运行时肯定出问题。
• 归档xcframework建议用命令行手动操作，比Xcode自动归档靠谱，能避免丢失依赖引用：

  # 归档B的iOS真机版本
  xcodebuild archive -scheme FrameworkB -destination "generic/platform=iOS" -archivePath "./build/FrameworkB-ios.xcarchive" BUILD_LIBRARY_FOR_DISTRIBUTION=YES SKIP_INSTALL=NO
  # 归档B的模拟器版本
  xcodebuild archive -scheme FrameworkB -destination "generic/platform=iOS Simulator" -archivePath "./build/FrameworkB-ios-sim.xcarchive" BUILD_LIBRARY_FOR_DISTRIBUTION=YES SKIP_INSTALL=NO
  # 生成xcframework
  xcodebuild -create-xcframework -framework ./build/FrameworkB-ios.xcarchive/Products/Library/Frameworks/FrameworkB.framework -framework ./build/FrameworkB-ios-sim.xcarchive/Products/Library/Frameworks/FrameworkB.framework -output ./build/FrameworkB.xcframework
  

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