解决:发布到苹果商店时错误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 在每次打包的时候执行复制的操作
相关推荐
看浪的路人10 小时前
第2讲:ReAct 模式从零实现——不用框架,手写一个 Agent 内核
前端·react.js·前端框架
墨狂之逸才12 小时前
# React Native 0.59 在 Node 24 下的启动兼容问题:从报错到一条命令运行
react native
一木 之林16 小时前
LangChain 第6章 Agent 智能体核心:create_agent 统一入口与 ReAct 循环
前端·react.js·langchain
andyweike17 小时前
CGRect
macos·objective-c·cocoa
天道kabuto18 小时前
入门 React Native:初始化 HelloRN 项目,Android 环境排错全记录
react native
anthonyzhu18 小时前
xcode27适配iOS27多窗口生成机制处理的问题
macos·objective-c·cocoa
TheLittleBoy19 小时前
iOS 27支持的设备列表
macos·ios·cocoa·ios 27
霸道流氓气质20 小时前
在线 AI 绘图平台:Flux 模型集成、Serverless 弹性部署与 ComfyUI 工作流的 React + Spring AI 全栈实战
人工智能·react.js·serverless
Java后端的Ai之路1 天前
08_React组件API
前端·react.js·前端框架
Misnearch2 天前
React中的回调
前端·javascript·react.js