如何让Xcode链接器移除重复符号？XCFramework迁移遇相关问题

方案一：移除"Link Binary With Libraries"，让Xcode自动识别XCFramework头文件 #

• 设置框架搜索路径：在项目Build Settings中找到FRAMEWORK_SEARCH_PATHS，添加XCFramework所在的父目录（例如你的XCFramework放在$(PROJECT_DIR)/Vendor下，就添加$(PROJECT_DIR)/Vendor）。建议使用$(PROJECT_DIR)这类环境变量，避免路径硬编码。
• 补充编译器搜索参数（可选）：如果头文件仍无法被索引，在OTHER_CFLAGS和OTHER_CPLUSPLUSFLAGS中添加-F$(PROJECT_DIR)/Vendor（替换为实际父目录路径），强制编译器搜索该路径下的框架文件。
• 保留分SDK链接器配置：继续使用你设置的分架构OTHER_LDFLAGS，确保-force_load指向对应SDK下XCFramework内部的静态库文件。这样既保证静态库所有内容被完整加载，又不会触发重复符号问题。

方案二：保留"Link Binary With Libraries"，消除重复符号 #

如果必须保留该构建阶段，可通过以下步骤解决重复符号：

• 设置XCFramework为不嵌入：在"Link Binary With Libraries"中选中该XCFramework，右侧"Embed"选项设置为Do Not Embed（静态框架无需嵌入App包）。
• 调整链接器标志：移除OTHER_LDFLAGS中针对该XCFramework的-force_load条目。若仍需加载静态库中所有Objective-C代码，保留全局的-ObjC标志即可——静态XCFramework通过"Link Binary"阶段添加后，Xcode会自动处理链接，结合-ObjC足以覆盖绝大多数静态分析无法识别的Objective-C代码场景。

关键注意事项 #

• 确保你的XCFramework是静态框架（与原fat框架类型一致），动态框架无需使用-force_load，链接逻辑完全不同。
• 头文件导入需使用<FrameworkName/HeaderName.h>的框架式导入语法，而非相对路径导入，这样才能让Xcode正确匹配XCFramework内的头文件结构。

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