From bd51f17a6b3511a2b6866e2b7363931d020324b4 Mon Sep 17 00:00:00 2001 From: xiaohutu Date: Fri, 21 Oct 2022 11:09:43 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20=E7=9C=9F=E6=9C=BA?= =?UTF-8?q?=E8=BF=90=E8=A1=8C=E5=B8=B8=E8=A7=81=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/tutorial/run/run-app-faq.md | 52 ++++++++++++++++++++------------ 1 file changed, 33 insertions(+), 19 deletions(-) diff --git a/docs/tutorial/run/run-app-faq.md b/docs/tutorial/run/run-app-faq.md index 5b4147c46..a89af9afa 100644 --- a/docs/tutorial/run/run-app-faq.md +++ b/docs/tutorial/run/run-app-faq.md @@ -63,14 +63,21 @@ HBuilderX支持项目类型较多，只有`uni-app`、`5+app`、`wap2app`可以 ### 3.2 Mac: 连接Android手机@mac-android +- 特别注意：HBuilderX菜单【设置 - 运行设置】，如果自定义过adb路径，请检查adb路径是否有效，注意必须是有效的adb（通常程序名都是adb)。如不确定，清除掉试试。然后重启HBuilderX。 +- 如果是检测不到mumu等Android模拟器，HBuilderX菜单【设置 - 运行设置】,请检查配置的端口号。 +- 关闭HBuilderX，打开任务管理器，看下是否存在adb进程，如存在，请杀死所有adb进程。 + +1. 重启电脑重试，重启电脑通常能解决90%的问题。 +2. 如重启HBuilderX仍然不行，请使用命令行(终端.app)，切换到HBuilderX自带的adb目录。 +3. HBuilderX正式版的adb目录位置：tools/adbs目录（MAC下为HBuilderX.app/Contents/tools/adbs目录）；HBuilderX Alpha版的adb目录位置：plugins/launcher/tools/adbs目录（MAC下为`/Applications/HBuilderX-Alpha.app/Contents/HBuilderX/plugins/launcher/tools/adbs`目录） +4. 在adbs目录下运行`./adb kill-server`重试。 + +**修改adb_usb.ini** 1. 关于本机(指Mac系统的关于本机，非手机) --> 系统报告 -> usb -> 你所连接的device --> 厂商ID或者供应商ID(Vendor ID) -2. 在终端执行如下命令：echo xxxxxx >> ~/.android/adb_usb.ini （“xxxxxx”为厂商ID或者供应商ID(Vendor ID)，有些系统下echo命令并不能正确写入文件，可在~/.android/目录下修改或新建adb_usb.ini添加xxxxxx） -3. 重启HBuilderX。 -4. 如重启HBuilderX仍然不行，请使用命令行(终端.app)，切换到HBuilderX自带的adb目录。 -5. HBuilderX正式版的adb目录位置：tools/adbs目录（MAC下为HBuilderX.app/Contents/tools/adbs目录） -6. HBuilderX Alpha版的adb目录位置：plugins/launcher/tools/adbs目录（MAC下为`/Applications/HBuilderX-Alpha.app/Contents/HBuilderX/plugins/launcher/tools/adbs`目录） -7. 在adbs目录下运行`./adb kill-server`重试。 -8. 重启电脑重试。 +2. 在终端执行如下命令：echo xxxxxx >> ~/.android/adb_usb.ini （“xxxxxx”为厂商ID或者供应商ID(Vendor ID)，有些系统下echo命令并不能正确写入文件，可在~/.android/目录下修改或新建adb_usb.ini添加xxxxxx），重启HBuilderX。 + +> 如果上面的方法还无法解决，菜单【帮助】【查看运行日志】，看下日志中存在什么相关的错误。 +> 也可到[DCloud论坛](https://ask.dcloud.net.cn/)发帖。发帖时，详细说明操作系统信息、HBuilderX版本号、手机型号以及手机系统信息，并提供运行日志。 ## 4. Windows 连接手机/模拟器说明@windows @@ -86,9 +93,9 @@ HBuilderX支持项目类型较多，只有`uni-app`、`5+app`、`wap2app`可以 #### 4.1.2 注意事项： -- Windows Android: 如果是华为手机，下列各种方法都尝试后还不行，请安装[华为手机助手](https://consumer.huawei.com/cn/support/content/zh-cn00731203/?ivk_sa=1024320u) -- HBuilderX，【设置 - 运行设置】，是否自定义过adb路径。如有自定义，请检查adb路径是否有效。如不确定，清除掉试试。然后重启HBuilderX -- 关闭HBuilderX，打开任务管理器，看下是否存在adb进程，如存在，请杀死所有adb进程 +- 特别注意：HBuilderX菜单【设置 - 运行设置】，如果自定义过adb路径，请检查adb路径是否有效，注意必须是有效的adb（通常windows下，程序名都是adb.exe)。如不确定，清除掉试试。然后重启HBuilderX +- 如果是检测不到夜神、mumu等Android模拟器，HBuilderX菜单【设置 - 运行设置】,请检查配置的端口号。 +- 关闭HBuilderX，打开任务管理器，看下是否存在adb进程，如存在，请杀死所有adb进程。 1. 如果在启动HBuilderX后才安装驱动连接上手机，可能需要重启HBuilderX。 2. 使用`管理员权限`运行HBuilderX。 @@ -99,8 +106,23 @@ HBuilderX支持项目类型较多，只有`uni-app`、`5+app`、`wap2app`可以 7. 禁止这些软件监听手机插入（一般在该软件的设置中）、禁止自动启动。 8. 有些软件结束adb进程后又会自动启动，所以得将`adb.exe`文件重命名一下，实在不行卸载了这些流氓软件。 9. 关闭所有手机助手及进程里各种`adb.exe`（包括`kadb.exe`等），再试。 +10. 如果是华为手机，下列各种方法都尝试后还不行，请安装[华为手机助手](https://consumer.huawei.com/cn/support/content/zh-cn00731203/?ivk_sa=1024320u) +11. 如果是华为荣耀Magic UI系列手机，检测不到手机，请参考 [华为荣耀Magic UI系列手机ADB连接手机方法](https://ask.dcloud.net.cn/article/40005) + +> 如果上面的方法还无法解决，菜单【帮助】【查看运行日志】，看下日志中存在什么相关的错误。 +> 也可到[DCloud论坛](https://ask.dcloud.net.cn/)发帖。发帖时，详细说明操作系统信息、HBuilderX版本号、手机型号以及手机系统信息，并提供运行日志。 + +#### 4.1.3 其它问题 -#### 4.1.3 adb占用问题 +如果以上方式仍然不行，还有一种可能是手机对adb的版本有特定要求（遇到一些魅族手机有此问题），此时需要更换HBuilder的adb版本。 +- HBuilder安装目录下带了多个版本的adb。 +- HBuilder的adb目录位置：tools/adbs目录（MAC下为HBuilder.app/Contents/tools/adbs目录） +- HBuilderX的adb目录位置：plugins/launcher/tools/adbs目录（MAC下为`/Applications/HBuilderX-Alpha.app/Contents/HBuilderX/plugins/launcher/tools/adbs`目录） +替换版本前，将默认版本的adb.exe备份下。然后把1.0.31版的adb.exe拷贝出来替换主目录下的exe。 + +> 当然也可下载[Android SDK](https://developer.android.google.cn/)，将其中的adb替换HBuilderX自带的adb. + +#### 4.1.4 adb占用问题 如果你找不到被谁占用，则还可以使用如下方式检测，寻找幕后黑手： 1. 打开命令行窗口 @@ -124,14 +146,6 @@ HBuilderX支持项目类型较多，只有`uni-app`、`5+app`、`wap2app`可以 adb.exe（名称一般不是adb.exe，以adb.exe举例）为启动的adb进程。 或者手工在任务管理器中定位这个进程，打开任务管理器后，进入进程选项卡，如果列表里有PID，直接找；如果列表里没有PID，点菜单查看-选择列，勾上PID。 -#### 4.1.4 其它问题 - -如果以上方式仍然不行，还有一种可能是手机对adb的版本有特定要求（遇到一些魅族手机有此问题），此时需要更换HBuilder的adb版本。 -- HBuilder安装目录下带了多个版本的adb。 -- HBuilder的adb目录位置：tools/adbs目录（MAC下为HBuilder.app/Contents/tools/adbs目录） -- HBuilderX的adb目录位置：plugins/launcher/tools/adbs目录（MAC下为`/Applications/HBuilderX-Alpha.app/Contents/HBuilderX/plugins/launcher/tools/adbs`目录） -替换版本前，将默认版本的adb.exe备份下。然后把1.0.31版的adb.exe拷贝出来替换主目录下的exe。 - ### 4.2 Windows: 连接iOS手机@windows-ios #### 4.2.1 iTunes下载说明@windows-download-itunes -- GitLab