解决:发布到苹果商店时错误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 在每次打包的时候执行复制的操作
相关推荐
@大迁世界1 天前
2026年React大洗牌:React Hooks 将迎来重大升级
前端·javascript·react.js·前端框架·ecmascript
wayne2141 天前
React Native 0.85 — 新动画后端 & Jest 预设独立包
react native
吃西瓜的年年1 天前
react(三)action 表单
前端·javascript·react.js
我命由我123451 天前
在 React 项目中,可以执行 npm start 命令,但是,无法执行 npm build 命令
前端·javascript·vue.js·react.js·前端框架·json·ecmascript
aosky1 天前
手机远程畅玩OpenAI Codex
macos·智能手机·cocoa
卸任1 天前
Electron霸屏功能总结
前端·react.js·electron
Digitally1 天前
荣耀手机数据迁移至 iPhone 教程
智能手机·cocoa·iphone
TheRouter1 天前
AI Agent 开发中的模型调度策略:何时用便宜模型,何时用强模型
前端·人工智能·react.js
Joyee6911 天前
RN 的新渲染器 Fabric
前端·react native
ZHENGZJM1 天前
前端基石:React + Vite + TypeScript 项目搭建
前端·react.js·typescript