d***@163.com
d***@163.com
  • 发布:2026-04-27 11:07
  • 更新:2026-04-27 11:07
  • 阅读:12

uni-app Vue3 项目,iOS 自定义调试基座和 iOS 正式包中,弹出 HTML5+ Runtime 提示:打包时未添加 Gallery 模块

分类:uni-app

问题描述

uni-app Vue3 项目,iOS 自定义调试基座和 iOS 正式包中,调用相册保存海报时,弹出 HTML5+ Runtime 提示:打包时未添加 Gallery 模块
同时项目里还出现过 未添加 Push 模块 的提示
该问题在“自定义调试基座”和“iOS 正式包安装到真机”两种情况下都能复现,不是仅标准基座复现
因此怀疑是 iOS 打包产物中的原生模块注册异常,而不是前端页面代码问题
项目环境

HBuilderX 版本:5.07
项目类型:uni-app Vue3
运行平台:iOS 真机
打包方式已验证:
iOS 自定义调试基座
iOS 正式包
两者安装到手机后,现象一致
manifest 配置

文件:frontend/src/manifest.json:18
当前已配置:
"modules": {
"Payment": {},
"Push": {},
"Gallery": {}
}

iOS 包名配置:
文件:frontend/src/manifest.json:43
bundleIdentifier: "com.shuwan.app"
已验证事实

Gallery 配置已经进入编译产物
文件:frontend/dist/build/app/manifest.json:19
编译产物内可见:
"permissions": {
"Payment": {},
"Gallery": {},
"UniNView": {
"description": "UniNView原生渲染"
}
}

说明 manifest 配置没有丢,至少已进入前端编译结果
复现步骤

使用 HBuilderX 5.07 打 iOS 自定义调试基座,安装到真机
或打 iOS 正式包,安装到真机
打开页面 #/pages/invite/index
点击“保存海报”
弹出错误:
HTML5+ Runtime
打包时未添加 Gallery 模块,请参考 https://ask.dcloud.net.cn/article/283
页面代码位置

文件:frontend/src/pages/invite/index.vue:137
当前保存逻辑已经直接走原生 plus.gallery.save(...)
不是只调用 uni.saveImageToPhotosAlbum
运行时日志

页面运行日志如下,说明当前运行时里 JS 侧确实能访问到 plus.gallery:
TempFilePath success: _doc/uniapp_temp_1777227153197/canvas/17772272046930.png
Save poster runtime info json: {"tempFilePath":"_doc/uniapp_temp_1777227153197/canvas/17772272046930.png","plusDefined":true,"galleryDefined":true,"gallerySaveType":"function","runtimeAppid":"UNI63E6CC0","runtimeVersion":"1.0.0"}
Save poster runtime gallery type: object
Using plus.gallery.save path
但调用后仍弹:
HTML5+ Runtime
打包时未添加 Gallery 模块
关键矛盾点

运行时日志显示:
plusDefined: true
galleryDefined: true
gallerySaveType: "function"
但实际调用 plus.gallery.save 后,仍提示“未添加 Gallery 模块”
同项目里还出现过 Push 模块缺失提示
因此怀疑:
iOS 打包产物中的原生模块注册状态异常
或 HBuilderX 5.07 / 云打包在当前项目下对 Gallery、Push 的模块装配有问题
已排除项

不是 H5 问题
不是二维码/海报生成问题,canvasToTempFilePath 已成功
不是仅标准基座问题,因为 iOS 正式包 安装到真机后也复现
不是页面未更新问题,因为新加的日志已在真机控制台出现
不是 manifest 漏配问题,因为 frontend/src/manifest.json:18 已配置 Gallery、Push
不是编译产物没带配置,因为 frontend/dist/build/app/manifest.json:19 已出现 Gallery

2026-04-27 11:07 负责人:无 分享
已邀请:

要回复问题请先登录注册