解决:发布到苹果商店时错误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 在每次打包的时候执行复制的操作
相关推荐
抱抱宝20 小时前
Agent-study项目教程(03):手写 Mini-ReAct Agent(不依赖框架)
javascript·人工智能·gpt·react.js·prompt·agent
想要成为糕糕手1 天前
🚀 在浏览器里跑 DeepSeek-R1?WebGPU 端侧推理实战(六)—— 完结篇:消息渲染与流式收尾
react.js·typescript·llm
YIAN1 天前
从 Hash 底层原理到 React Router v6 实战:我学会了什么?
前端·react.js·vue-router
YUS云生1 天前
大模型学习·第46天:Agent智能体核心概念与ReAct框架
前端·学习·react.js
To_OC1 天前
后端接口还没交付,前端如何独立把整套业务跑通
前端·react.js·全栈
程序员跑路1 天前
Barrel Export、Jest、Babel 与依赖图
react.js
l1m0_1 天前
告别反复修改Prompt:AI生成React应用并落地开发的实战复盘
前端·react.js·ui·ai·设计
xexpertS1 天前
前端工程转型实践:从 Ember 迁移到 React,提升构建速度与研发效能
前端·react.js·前端框架
张元清1 天前
React useFocus Hook:追踪并控制元素焦点状态 (2026)
javascript·react.js
一朵好运莲1 天前
智能体使用 Chrome DevTools MCP 调试浏览器
开发语言·javascript·react.js