生成IPA/XCArchive时外部Framework文件找不到问题求助

问题分析 #

该错误的核心原因是Archive阶段的路径解析异常（错误路径中存在多余空格），或外部Framework的模块配置、嵌入签名设置不符合打包要求。常规构建/运行正常但Archive失败，说明问题集中在打包阶段的特殊构建逻辑上。

解决方案 #

1. 修正Framework的嵌入与签名配置 #

• 打开项目Target的General > Frameworks, Libraries, and Embedded Content：
  • 第三方闭源Framework：设置Embed选项为Embed & Sign
  • 自研Framework（已完成签名）：设置为Embed Without Signing
• 检查Framework的路径引用：在Build Phases > Link Binary With Libraries中选中目标Framework，打开右侧File Inspector，将Location设置为Relative to Project或Relative to Build Products，避免绝对路径导致的解析错误。

2. 修复module.modulemap的路径与内容 #

• 验证Framework内部的模块配置：打开XXXXXFramework.framework包，确认Modules/module.modulemap存在，且内容与Framework名称一致，示例正确配置：

  framework module XXXXXFramework {
      umbrella header "XXXXXFramework.h"
      export *
      module * { export * }
  }
  

• 清理构建路径变量的多余空格：在项目Build Settings > FRAMEWORK_SEARCH_PATHS中，替换所有绝对路径为相对变量（如$(SRCROOT)/Frameworks），确保路径无多余空格或无效字符。

3. 调整Archive专属构建配置 #

• 正确排除架构：不要全局排除arm64（会导致App Store验证失败），仅在Build Settings > Excluded Architectures的Any iOS Simulator SDK或Debug配置下添加arm64，Release和Any iOS SDK保持为空。
• 修正Skip Install设置：主App Target的Skip Install设为NO，自研Framework的Target（若存在）设为YES，避免Archive阶段重复安装冲突。
• 清理Derived Data：通过Xcode菜单进入Settings > Locations > Derived Data，删除当前项目的Derived Data文件夹，再执行Cmd+Shift+K清理Build Folder，重新尝试Archive。

4. 添加Run Script修复路径异常 #

若上述方案无效，添加Run Script Phase修正路径中的多余空格：

• 在Build Phases中新增Run Script Phase，拖动至Embed Frameworks之前，脚本内容：

  FRAMEWORK_PATH="${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/XXXXXFramework.framework"
  if [ -f "${FRAMEWORK_PATH}/Modules/module.modulemap" ]; then
      sed -i '' 's/\/\s*\.\.\//\/..\//g' "${FRAMEWORK_PATH}/Modules/module.modulemap"
  fi
  

• 该脚本会自动修正module.modulemap中存在的多余空格路径问题，确保Archive阶段能正确识别文件。

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