解决:发布到苹果商店时错误The archive did not include a dSYM for the hermes.framework with the UUIDs

React Native 发布到苹果商店的时候遇到以下错误:

sh 复制代码
The archive did not include a dSYM for the hermes.framework with the UUIDs [58A2B46F-BC4E-34AE-82CE-EF76DFDEA9A8]. Ensure that the archive's dSYM folder includes a DWARF file for hermes.framework with the expected UUIDs.

目前这个问题解决方法比较少, Google 也没有一个完全可以解决, 但是根据各种大神的回复, 进行综合之后, 得到了一个完整的通用的解决方案.

以下是以 hermes.framework 缺少 dSYMs 为例, 如果是其他的 framework 类似的处理即可.

出问题的地方在 [你的项目]/ios/Pods/hermes-engine/destroot/Library/Frameworks/universal/hermes.xcframework

sh 复制代码
.
├── Info.plist
├── ios-arm64
├── ios-arm64_x86_64-maccatalyst
├── ios-arm64_x86_64-simulator
├── xros-arm64
└── xros-arm64_x86_64-simulator

这些目录中缺少了 dSYMs

打开页面 下载 dSYM, 注意找到对应 React Native 一样的版本号, 下载 release 的包.

hermes.xcframework 的每个子目录都创建一个目录 dSYMs, 然后解压下载的 release 包, 把 hermes.framework.dSYM 放在新建的目录中. 需要注意的是不同的目录要对应不同的文件.

处理后, 我的目录结构如下, 再次打包上传, 一切正常.

sh 复制代码
.
├── Info.plist
├── ios-arm64
│   ├── dSYMs
│   │   └── hermes.framework.dSYM
│   └── hermes.framework
│       ├── Info.plist
│       └── hermes
├── ios-arm64_x86_64-maccatalyst
│   ├── dSYMs
│   │   └── hermes.framework.dSYM
│   └── hermes.framework
│       ├── Resources -> Versions/Current/Resources
│       ├── Versions
│       └── hermes -> Versions/Current/hermes
├── ios-arm64_x86_64-simulator
│   ├── dSYMs
│   │   └── hermes.framework.dSYM
│   └── hermes.framework
│       ├── Info.plist
│       └── hermes
├── xros-arm64
│   ├── dSYMs
│   │   └── hermes.framework.dSYM
│   └── hermes.framework
│       ├── Info.plist
│       └── hermes
└── xros-arm64_x86_64-simulator
    ├── dSYMs
    │   └── hermes.framework.dSYM
    └── hermes.framework
        ├── Info.plist
        └── hermes

这样打包, 发布就完成了.

如果执行了 clean, 可能文件就被清除了, 再打包, 又有问题, 可以创建一个 run script 脚本:

sh 复制代码
#!/bin/bash

echo "[Custom Script] Copy dSYMs to hermes-engine 1"

# Define source and destination paths
cp -R ${PROJECT_DIR}/dSYMs/ios-arm64/dSYMs ${PROJECT_DIR}/Pods/hermes-engine/destroot/Library/Frameworks/universal/hermes.xcframework/ios-arm64/
cp -R ${PROJECT_DIR}/dSYMs/ios-arm64_x86_64-maccatalyst/dSYMs ${PROJECT_DIR}/Pods/hermes-engine/destroot/Library/Frameworks/universal/hermes.xcframework/ios-arm64_x86_64-maccatalyst/
cp -R ${PROJECT_DIR}/dSYMs/ios-arm64_x86_64-simulator/dSYMs ${PROJECT_DIR}/Pods/hermes-engine/destroot/Library/Frameworks/universal/hermes.xcframework/ios-arm64_x86_64-simulator/
cp -R ${PROJECT_DIR}/dSYMs/xros-arm64/dSYMs ${PROJECT_DIR}/Pods/hermes-engine/destroot/Library/Frameworks/universal/hermes.xcframework/xros-arm64/
cp -R ${PROJECT_DIR}/dSYMs/xros-arm64_x86_64-simulator/dSYMs ${PROJECT_DIR}/Pods/hermes-engine/destroot/Library/Frameworks/universal/hermes.xcframework/xros-arm64_x86_64-simulator/

# Copy the directory
echo "Successfully copied dSYMs to Hermes destination"

重点注意的地方

  • 下载的 dSYMs 的版本要和 react-native 一致
  • 每个目录都要新建一个 dSYMs 文件夹
  • 每个目录复制的文件要对应, 看名字, 名字可能不完全一样
  • clean 之后会清除复制的文件, 可以在 Build Phases 中创建一个 Run Script 在每次打包的时候执行复制的操作
相关推荐
cos17 小时前
React RCE 漏洞影响自建 Umami 服务 —— 记 CVE-2025-55182
前端·安全·react.js
奋斗猿18 小时前
前端实测:RSC不是银弹,但它真的重构了我的技术栈
前端·react.js
HexCIer18 小时前
CVE-2025-55182 React Server Components "React2Shell" 深度调查与全链路响应报告
react.js·next.js
爱看书的小沐19 小时前
【小沐学WebGIS】基于Cesium.JS绘制雷达波束/几何体/传感器Sensor(Cesium / vue / react )
javascript·vue.js·react.js·雷达·cesium·传感器·波束
用户81686947472519 小时前
React 如何用 MessageChannel 模拟 requestIdleCallback
前端·react.js
ZZJsky12319 小时前
关于 React 进化历史 (上)
react.js
随风一样自由20 小时前
React中实现iframe嵌套登录页面:跨域与状态同步解决方案详解
前端·react.js·前端框架·跨域
一个处女座的程序猿O(∩_∩)O20 小时前
React Native vs React Web:深度对比与架构解析
前端·react native·react.js
@大迁世界20 小时前
紧急:React 19 和 Next.js 的 React 服务器组件存在关键漏洞
服务器·前端·javascript·react.js·前端框架
一个处女座的程序猿O(∩_∩)O21 小时前
React Native 全面解析:跨平台移动开发的利器
javascript·react native·react.js