归档iOS应用时缺失VdoFramework.framework的dSYM（UUID不匹配）求助

错误提示 #

The archive did not include a dSYM for the VdoFramework.framework with the UUIDs [EB84B14A-CE4D-3DA8-8EEE-F8EE8970E161]. Ensure that the archive's dSYM folder includes a DWARF file for VdoFramework.framework with the expected UUIDs.

问题描述 #

归档iOS应用后，上传至App Store Connect失败，原因是归档文件未包含VdoFramework.framework对应UUID的dSYM文件，或现有dSYM的UUID与要求不匹配。

复现步骤 #

• 使用Xcode归档应用
• 尝试将构建版本上传至App Store Connect
• 收到VdoFramework.framework的dSYM缺失或UUID不匹配的错误提示

预期行为 #

• 归档文件包含正确的dSYM
• 构建版本可顺利上传至App Store Connect

实际行为 #

• 因VdoFramework.framework的dSYM缺失或UUID不匹配，构建上传失败

已尝试的解决方案 #

• 用dwarfdump --uuid命令验证dSYM存在性
• 清理并重新构建项目
• 确认Xcode设置中DEBUG_INFORMATION_FORMAT = dwarf-with-dsym
• 手动查找dSYM但发现UUID不匹配

环境信息 #

• Xcode版本：16.2
• Flutter版本：3.29.2
• CocoaPods版本：1.16.2

补充疑问 #

• 如何确保正确的dSYM被生成并包含在归档中？
• 是否可以重新生成或手动关联正确的UUID？

解决方案 #

1. 检查第三方框架自带的dSYM #

部分第三方框架会自带dSYM文件，先做以下验证：

• 找到项目中VdoFramework.framework的存放路径
• 查看同级目录或框架包内是否存在VdoFramework.framework.dSYM
• 分别执行以下命令对比UUID：

  dwarfdump --uuid VdoFramework.framework/VdoFramework
  dwarfdump --uuid VdoFramework.framework.dSYM
  

  确认两者UUID完全一致

2. 全层级配置dSYM生成开关 #

除了项目级设置，还要检查目标及Pods的配置：

• 打开Xcode项目，选择主目标，进入Build Settings
• 搜索Debug Information Format，确保Release配置下设置为DWARF with dSYM File
• 进入Pods项目，找到VdoFramework对应的目标，同样将Debug Information Format设置为DWARF with dSYM File（若框架通过CocoaPods引入）

3. 验证归档中的dSYM #

归档完成后，手动检查dSYM是否存在且匹配：

• 在Xcode的Organizer中选中归档包，右键选择Show in Finder
• 右键归档包选择Show Package Contents，进入dSYMs文件夹
• 若存在VdoFramework.framework.dSYM，用dwarfdump --uuid验证其UUID是否与错误提示中的一致

4. 重新编译框架生成匹配的dSYM #

如果框架是自行编译的，重新生成正确的dSYM：

• 打开VdoFramework的项目，确保DEBUG_INFORMATION_FORMAT设置为dwarf-with-dsym
• 以Release模式重新编译框架，获取生成的dSYM文件
• 将新的框架和dSYM文件替换到主项目中

5. 手动添加dSYM到归档 #

如果归档中缺少对应dSYM，可手动补充：

• 找到UUID匹配的VdoFramework.framework.dSYM文件
• 打开归档包的dSYMs文件夹，将dSYM文件复制进去
• 重新尝试上传构建版本

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