Flutter应用上传App Store遇警告：TestFlight无法查看到已上传构建

问题描述 #

上传Flutter应用至App Store时收到如下警告：

The archive did not include a dSYM for the HyphenateChat.framework with the UUIDs [XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX]. Ensure that the archive's dSYM folder includes a DWARF file for HyphenateChat.framework with the expected UUIDs.

使用Agora Chat SDK与Agora Chat UI SDK，Xcode显示构建已上传，但TestFlight中无法查看构建，通过Product>Archive准备构建后选择TestFlight上传。

解决方案 #

1. 检查Xcode调试符号生成配置 #

• 打开Xcode项目，进入Build Settings
• 搜索Debug Information Format，确保Debug和Release模式均设置为DWARF with dSYM File
• 确认Build Options下的Generate Debug Symbols已勾选为YES

2. 手动添加HyphenateChat.framework的dSYM文件 #

• 定位到Flutter项目的ios/Pods/HyphenateChat目录（或SDK安装路径）
• 右键点击HyphenateChat.framework，选择Show Package Contents，查看dSYMs文件夹内是否存在对应UUID的DWARF文件
• 若存在该文件，在Xcode的Target页面进入Build Phases，添加一个New Copy Files Phase：
  • 目标选择Products Directory
  • 将找到的dSYM文件拖入该Phase的文件列表中

3. 清理缓存并重新构建归档 #

• 终端执行：

  flutter clean
  cd ios
  pod install
  

• 在Xcode中执行Product -> Clean Build Folder
• 重新执行Product -> Archive，完成后再次尝试上传至TestFlight

4. 验证Apple端构建状态 #

• 登录Apple开发者后台，进入App Store Connect -> 你的应用 -> TestFlight -> Builds，查看构建是否处于Processing状态
• 检查注册的开发者邮箱，Apple会发送构建处理失败的详细错误邮件（Xcode显示上传成功不代表Apple已成功处理）

额外提示 #

确保Agora Chat SDK与UI SDK使用最新版本，旧版本可能存在dSYM打包逻辑的问题。

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