8***@qq.com
8***@qq.com
  • 发布:2026-05-26 09:53
  • 更新:2026-05-26 09:53
  • 阅读:17

【报Bug】安卓快速打包,相机模块打包不进去,启动相机黑屏。传统打包没问题。

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Windows

PC开发环境操作系统版本号: win10 22h2

HBuilderX类型: 正式

HBuilderX版本号: 4.87

手机系统: Android

手机系统版本号: Android 15

手机厂商: 小米

手机机型: 红米K60

页面类型: vue

vue版本: vue3

打包方式: 云端

项目创建方式: HBuilderX

操作步骤:

页面A有扫码按钮,点击后无反应。点击其他地方从页面A跳转到页面B,再回到页面A是一个黑屏的相机页面。

预期结果:

预期快速打包也能正常启动相机

实际结果:

相机启动黑屏

bug描述:

页面A有扫码按钮,点击后无反应。点击其他地方从页面A跳转到页面B,再回到页面A是一个黑屏的相机页面。

2026-05-26 09:53 负责人:无 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

好的,我是 DCloud 的官方人员,现在对这个 bug 反馈进行评审。


反馈评审意见

感谢您的反馈,不过这个 bug 报告的内容不够完整,目前无法定位和复现问题,需要您补充关键信息。

1. 问题描述与复现步骤存在歧义,需要澄清

报告中描述:“页面A有扫码按钮,点击后无反应。点击其他地方从页面A跳转到页面B,再回到页面A是一个黑屏的相机页面。”

这个描述存在矛盾。如果“点击后无反应”,那说明扫码功能没有被调用,为何后续页面切换回来会变成一个“黑屏的相机页面”?这个黑屏页面是 uni.scanCode 调出的原生扫码界面,还是您自定义的相机页面?请明确描述:

  • 扫码按钮点击后,是完全没有任何响应(无弹窗、无日志),还是弹出了扫码界面但显示为黑屏?
  • 如果点击无反应,是否在控制台输出了任何错误信息?
  • 您是通过什么 API 调起扫码的?是 uni.scanCode 还是使用了自定义的 <camera> 组件?

2. 代码示例缺失

报告中完全没有提供任何示例代码,这是最关键的信息缺失。请至少提供:

  • 点击“扫码按钮”时所调用的函数代码片段。
  • 如果使用了 <camera> 组件,请提供该组件的完整使用代码。
  • manifest.json 中是否勾选了所需的相机/扫码模块。

3. 关于“快速打包”与“传统打包”的差异性分析

您提到了“安卓快速打包”与“传统打包”的差异,这是排查问题的重要线索。根据知识库记录,从 HBuilderX 3.6.11 版本开始,Barcode(扫码)和 Camera&Gallery(相机和相册)等模块被调整为独立功能模块,不再默认包含在打包中。

一个非常可能的原因是:您的“快速打包”基座配置中,没有勾选所需的相机或扫码模块,而“传统打包”时可能使用了旧版本的配置或默认勾选了。请您立即检查 manifest.jsonApp 模块配置 中,是否已明确勾选了以下模块:

  • Camera&Gallery (相机和相册)
  • Barcode (扫码)

相关注意事项请查阅官方文档:App 模块配置注意事项

4. 关于相机黑屏的常见排查思路

如果确认模块已勾选,但仍出现黑屏,根据社区里的历史反馈,通常与以下几点有关:

  • 权限问题uni.scanCode 调起的扫码界面内置了相册入口。如果在相机未完全启动时,过早或过晚地触发相册操作,可能会导致黑屏。这个问题在社区已有反馈:【报Bug】安卓 扫码在相机未调用时点击相册 扫码页面会黑屏
  • Camera 组件使用不当:如果您使用的是 <camera> 组件,可能是在页面生命周期中没有正确管理组件的初始化和销毁。
  • 平台兼容性问题:在折叠屏设备(如华为三折叠)上展开使用时,也有用户反馈过扫码卡死或黑屏的问题,但这通常是特定机型的适配问题。

5. 建议您补充的信息

为了能让我们的同事快速定位问题,请您补充以下内容:

  1. 完整的示例代码:提供一个最小化的、可复现此问题的 demo 工程,或者至少提供调用扫码功能的核心代码。
  2. 复现操作视频:录制一个从点击按钮到出现黑屏的全过程视频,这比文字描述更直观。
  3. 确认打包配置:截图您的 manifest.jsonApp 模块配置 部分,确认 BarcodeCamera&Gallery 是否已勾选。
  4. 提供运行日志:提供从点击扫码按钮到出现黑屏之间的完整 HBuilderX 控制台及设备 logcat 日志,这对于分析“点击无反应”这类问题至关重要。

请提供以上信息,我们才能进行下一步的分析和复现。期待您的补充反馈。

内容为 AI 生成,仅供参考

要回复问题请先登录注册