HBuilderX安卓真机运行安装失败解决汇总
前置方案
1. 确认USB调试和连接模式
(1)开启USB调试:进入手机设置 > 开发者选项 > 确保USB调试已开启(如无开发者选项,连续点击“版本号”激活)。
(2)连接模式:将USB连接模式改为文件传输(MTP)。
(3)授权提示:首次连接时,手机会弹出“允许USB调试吗?”的提示,勾选始终允许后确认。
2. 关闭ADB冲突进程
结束冲突程序:关闭其他安卓工具(如Android Studio、模拟器、手机助手等)。
重启ADB服务:
在HBuilderX中点击菜单栏 运行 > 重启ADB服务。
或手动执行命令:
adb kill-server
adb start-server
具体问题具体分析
报错:检测到当前使用的ADB不支持反向代理,如果出现连接不上的问题,请更换HBuilder自带的ADB进行真机运行或保持手机和电脑在同一个局域网下
解决:
1.运行=>运行到手机或模拟器=>ADB路径设置=>Android模拟器端口设置为Hbuilder原本的端口,我的是26944(使用模拟器前会更改端口可能导致真机不匹配)
如果第一次运行,查看adb默认路径是否为空,填写自己的正确配置路径,我的是D:/Program Files/Nox/bin/adb.exe
2.找到HBuilderX\plugins\launcher-tools\tools\adbs文件,将除了1.0.31和1.0.36两个文件夹的文件备份之后删除,然后将1.0.36文件下的文件直接复制粘贴到该路径下,然后重启HBuilder X,启动项目。
报错:Failed to install D:\Program Files\HBuilderX\plugins\launcher\base\android_base.apk
1.更换USB线/接口:使用原装数据线,优先连接电脑后置USB口。
2.修复HBuilderX安装:
重新下载HBuilderX,覆盖安装或更换安装路径(如D:\HBuilderX,避免空格路径)。
手动替换APK:
从正常设备或同事处获取android_base.apk,替换原文件(路径:plugins\launcher\base\)。