使用XCFramework的SwiftUI应用Archive构建失败，报错找不到‘Foo’

一、Archive失败的核心原因 #

• XCFramework架构兼容性问题：日常运行（模拟器/真机）时，Xcode只会编译对应目标平台的单一架构（比如模拟器是x86_64/arm64，真机是arm64）；但Archive默认会构建通用二进制包，包含所有支持的iOS设备架构。如果Foo.xcframework缺失Archive流程需要的架构（比如遗漏特定arm64变体、存在架构冲突），Xcode合并架构时就找不到框架符号，触发Cannot find 'Foo' in scope错误。
• 桥接文件配置疏漏：虽然Debug运行正常，但Archive的Release配置对桥接文件要求更严格。比如桥接文件只在Debug配置中指定、Foo的头文件未正确导入，或被条件编译语句（如#ifdef DEBUG）在Release模式下排除。
• Release配置优化过度：Release模式下开启的Dead Code Stripping等优化选项，可能错误剥离Foo的框架符号；或者Framework Search Paths在Release配置中未正确指向Foo.xcframework路径。

二、Archive是否会构建额外平台？ #

是的。默认情况下，Xcode的Archive操作会为项目中设置的所有目标平台和架构构建二进制文件，最终生成包含多架构的通用包（比如同时支持全系列iOS设备的arm64架构，若开启Mac Catalyst还会包含Mac架构）。而日常Run操作仅针对当前选中的设备/模拟器构建单一架构，这就是运行正常但Archive失败的关键差异。

三、解决办法 #

1. 验证XCFramework的架构完整性
   打开终端，执行命令查看Foo.xcframework包含的架构：

   xcrun lipo -info path/to/Foo.xcframework/ios-arm64/Foo.framework/Foo
   xcrun lipo -info path/to/Foo.xcframework/ios-arm64_x86_64-simulator/Foo.framework/Foo
   

   确保ios-arm64目录包含iOS设备所需的arm64架构，ios-arm64_x86_64-simulator包含模拟器的arm64和x86_64架构，无重复或冲突的架构定义。

2. 检查桥接文件配置

   • 进入项目Build Settings，搜索Objective-C Bridging Header，确认该路径在Debug和Release所有构建配置中都正确设置（建议用相对项目根目录的路径）。
   • 确保桥接文件中正确导入Foo的头文件：

     #import <Foo/Foo.h>
     

   • 排查桥接文件中是否有条件编译语句，导致Release模式下无法导入头文件。

3. 调整Release构建配置

   • 搜索Dead Code Stripping，将Release配置下的该选项设为NO，避免框架符号被意外剥离。
   • 搜索Framework Search Paths，确认Release配置下的路径包含Foo.xcframework所在目录，推荐用$(PROJECT_DIR)/相对路径形式。
   • 确认Other Linker Flags中包含-framework Foo，若没有则添加该选项。

4. 重新嵌入框架
   先移除项目中的Foo.xcframework，再重新添加，确保选择「Embed & Sign」；检查Build Phases的Embed Frameworks列表里包含Foo.xcframework，且Destination设为Frameworks、Code Sign On Copy已勾选。

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