x***@163.com
x***@163.com
  • 发布:2026-01-21 18:20
  • 更新:2026-01-21 19:14
  • 阅读:17

用hbuilderx开发uni-app类型的安卓手机app,无法使用自定义基座运行调试

分类:uni-app

用hbuilderx开发uni-app类型的安卓手机app,无法使用自定义基座运行调试,在标准基座下调试运行没有问题能正常用真机调试,但是就是有个功能需要打自定义基座才能调用,自定义基座能制作成功,就是在hbuilderx中点击运行->使用自定义基座运行->已安装基座,编译运行后报错:

[广告] 18:16:24.935 uni一键登录,无需手动输入手机号,比短信验证码更便宜、更简单的用户注册/登录方案,详情
18:16:24.957 项目 adbtest 开始编译
18:16:27.076 4.85
18:16:27.079 请注意运行模式下,因日志输出、sourcemap以及未压缩源码等原因,性能和包体积,均不及发行模式。
18:16:27.313 正在编译中...
18:16:33.930 项目 adbtest 编译成功。
18:16:34.291 正在建立手机连接...
18:17:05.489 同步资源失败,未得到同步资源的授权,请停止运行后重新运行,并注意手机上的授权提示
18:17:05.489 如果此时手机没有任何反应,请检查自定义基座是否正确;如果是离线制作的自定义基座包,请检查离线包制作是否正确!

2026-01-21 18:20 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

该问题请在专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

现象

  • 标准基座可以正常真机调试
  • 自定义基座制作成功,但在 HBuilderX 里点击【运行 → 使用自定义基座运行 → 已安装基座】后,控制台提示
    同步资源失败,未得到同步资源的授权,请停止运行后重新运行,并注意手机上的授权提示  
  • 手机端没有任何授权弹窗,基座也没有被拉起

原因
自定义基座要能被 HBuilderX 识别并用于“热同步调试”,必须同时满足下面 3 件事:

  1. 包名与 manifest.json 中填写的完全一致;
  2. 签名证书与 manifest.json 中配置的证书(debug 证书或自有证书)完全一致;
  3. 基座 apk 必须包含调试引擎(即离线 SDK 里 libdcloud.so 等调试库),否则 HBuilderX 无法通过 adb 建立 socket 连接,也就无法同步资源。

只要其中任何一项不一致,就会出现“同步资源失败,未得到同步资源的授权”的提示。

排查 / 解决步骤

  1. 确认手机上确实安装的是“调试版”自定义基座

    • 路径:项目根目录 /unpackage/debug/android_debug.apk
    • 如果之前用 Android Studio 或命令行 adb install 安装过,请先卸载旧包:
      adb uninstall 您的包名  
  2. 检查包名与证书

    • manifest.json → “App” → “Android 包名” 与离线打包时 Gradle 中 applicationId 完全一致;
    • manifest.json → “App” → “模块权限配置” → “签名证书” 与离线打包时使用的 keystore 完全一致(MD5、SHA1 都要一致)。
  3. 重新制作包含调试引擎的自定义基座

    • 使用 HBuilderX 4.71+ 的“云打包”方式最省事:
      发行 → 原生 App-云打包 → 勾选“制作自定义调试基座” → 等待云端打包完成 → 自动下载到 unpackage/debug/android_debug.apk。
    • 如果坚持离线打包,请确保在离线 SDK 的 libs 目录里包含 libdcloud.solibweexcore.so 等调试库,并且在 build.gradle 中把 debuggable true 打开,再重新生成 apk。
  4. 安装并运行

    • 手动把新生成的 android_debug.apk 拖到手机安装;
    • 回到 HBuilderX:运行 → 运行到手机 → 使用自定义基座运行 → 已安装基座 → 选择对应包名;
    • 第一次启动手机会弹出“是否允许 USB 调试”或“是否允许显示悬浮窗”等授权,务必全部允许;
    • 如果手机是小米/红米,请关闭“MIUI 优化”(开发者选项里)或把“USB 安装”提示的倒计时点掉,否则 adb 安装会被拦截。
  5. 仍有问题时

    • adb logcat | grep hbuilder 查看实时日志,确认是否有“permission denied”或“signature mismatch”字样;
    • 确认电脑端 8848、9974 端口未被防火墙占用(HBuilderX 与基座通过这两个端口同步资源)。

按以上步骤重新制作并安装调试版自定义基座后,HBuilderX 就能正常“热同步”代码,调试时不会再出现“同步资源失败”的提示。

内容为 AI 生成,仅供参考
x***@163.com

x***@163.com (作者) - xgia001@163.com

我是重新开另一个uni-app项目,手动将android_debug.apk文件安装到手机,我记得之前用自定义基座调试也没有手动安装过android_debug.apk,一直是能运行到自定义基座调试的,昨天突然想想就把手机上的apk调试程序安装好的程序从手机移除了,就一直用自定义基座调试不了,

另外,有2个地方可以打自定义基座包,一个是从:运行-》运行到手机模拟器-》制作自定义调试基座,
一个是:发行-》Android云打包-》制作自定义调试基座,
这2种方式是一样的吧;

还有一个问题问下,传统包和安心打包区别是什么?

要回复问题请先登录注册