HarmonyOS Developer DevEco Studio常见问题-远程/本地模拟器

远程模拟器

申请模拟器提示HDC工具未安装

问题现象

在申请远程模拟器时，提示“The HDC tool hasn't been installed”

解决措施

该问题可能的原因是HDC工具未安装或文件缺失，需要重新下载。

1. 在DevEco Studio中，点击Tools > SDK Manager，进入HarmonyOS界面。
2. 在Platforms页签中，勾选“Toolchains”，更新或下载最新版本的Toolchains即可。

说明

如果已是最新版本，还会提示该错误信息，可尝试先卸载Toolchains后重新下载。卸载Toolchains，即在Platforms页签中，取消勾选“Toolchains”，然后点击Apply即可。

HDC通道的端口被占用的处理指导

问题现象：

在申请远程模拟器时，提示“Unable to apply for a remote emulator: All the ports (18888 - 18899) for creating HDC channels are occupied”。

解决措施：

该问题的原因是HDC通道的端口 (18888 - 18899) 全部被占用导致，可通过如下指导释放其中至少一个端口。

1. 打开CMD命令行工具，执行如下命令查询端口的使用情况，其中端口号为18888 - 18899。从查询结果中，获取当前端口的PID，如下图所示。

netstat -aon|findstr "18888"

2. 执行如下命令，查询PID对应的进程，查看当前端口对应的应用程序。

tasklist|findstr "7308"

3. 如果该应用程序当前未使用，可执行如下命令结束该进程。如果当前进程不能结束，请重复​​1​​查看其它端口的使用情况。

taskkill /T /F /PID 7308 

4. 重启申请远程模拟器。

启动远程模拟器时，连接HDC服务失败

问题现象

申请启动远程模拟器失败，提示“Unable to apply for a remote emulator: due to an HDC server connection error.

Verify the HDC port configuration, and then close the hdc process and try again. If needed, see Troubleshooting guide for details.”

解决措施

该问题可能是由于HDC工具及其端口号未设置环境变量导致。

1. 根据​​配置HDC工具环境变量​​章节检查并配置hdc端口号。
2. 使用快捷键Ctrl+Alt+Del打开任务管理器，结束hdc.exe进程，然后重新尝试申请远程模拟器。

本地模拟器

启动模拟器，提示磁盘空间不足

问题现象

启动模拟器失败，磁盘空间不足，提示如下信息：

解决措施

本地模拟器默认安装在C:\Users\Users\AppData\Local\Huawei\HarmonyOSEmulator\deployed目录（macOS为：/Users/用户/.Huawei/HarmonyOSEmulator/deployed），请确保C盘磁盘可用空间大于3.6 GB；或者​​重新创建模拟器​​，并选择其它存储路径。

启动模拟器，提示镜像文件缺失

问题现象

启动模拟器失败，提示“The system-image file is missing.”，模拟器镜像文件缺失。

解决措施

请通过如下两种方式解决

• 方式一：

     ○  进入File > Settings > SDKs > HarmonyOS界面（Mac系统进入DevEco Studio > Preferences > SDKs > HarmonyOS界面），取消勾选“System-image”，点击Apply，卸载已下载的模拟器镜像。

     ○  卸载完成后，勾选“System-image”，点击Apply，重新下载模拟器镜像。

• 方式二：删除已创建的本地模拟器，然后​​重新创建模拟器​​。

启动模拟器，提示SDK路径已更改

问题现象

启动模拟器失败，提示“Sdk Path has been changed to xxx”，SDK路径已修改。

解决措施

可以尝试通过如下两种方式进行解决：

• 在Local Emulator的设备列表窗口，点击“Wipe User Data”清除模拟器数据，然后重新启动模拟器。
• 重新​​创建一个模拟器​​，然后启动新建的模拟器。

macOS系统启动模拟器，提示共享内存不足

问题现象

macOS系统下启动模拟器，提示“Insufficient shared memory to run the emulator.”，系统设置的共享内存大小不足。

解决措施

需要使用管理员权限修改共享内存配置。

1. 在菜单栏中点击前往> 前往文件夹（Go > Go to Folder），然后输入/etc/，进入etc根目录。
2. 创建文件sysctl.conf，若文件已存在跳过此步骤。
3. 修改sysctl.conf，添加以下内容。

说明

在etc文件夹下修改sysctl.conf文件，会提示没有权限，请将该文件拷贝到桌面上进行修改，然后再替换到etc目录下。

kern.sysv.shmmax=109051904
kern.sysv.shmmin=1
kern.sysv.shmmni=128
kern.sysv.shmseg=32
kern.sysv.shmall=212992

4. 重启macOS电脑，然后重新启动模拟器。

启动模拟器，提示无法启动模拟器

问题现象

启动模拟器失败，提示“Unable to start the emulator.”，模拟器无法启动

解决措施

可以尝试通过如下三种方式进行解决：

• 在Local Emulator的设备列表窗口，点击“Wipe User Data”清除模拟器数据，然后重新启动模拟器。
• 在File > Settings > SDKs > HarmonyOS界面中，卸载并重新下载模拟器镜像文件“System-image”后，尝试重新启动模拟器。
• 在File > Settings > SDKs > HarmonyOS界面中，卸载并重新下载模拟器应用“EmulatorX86”后，尝试重新启动模拟器。

启动模拟器，提示无法安装HAXM

问题现象

在Intel CPU的Windows电脑下，启动模拟器失败，提示“Unable to install HAXM.”，无法安装HAXM。

解决措施

1. 打开任务管理器，在“性能”选项，检查CPU虚拟化是否已经启用。如果未启用，需要进入电脑的BIOS中，将CPU的“Intel Virtualization Technology”选项开启。

说明

如果没有CPU虚拟化选项，则不支持本地模拟器。

2. 打开控制面板 > 程序 > 程序与功能 > 启动或关闭Winodows功能，找到并取消勾选“Hyper-V”，点击确定并重启电脑。

3. 重新启动模拟器。

启动模拟器，提示VT/NX不可用

问题现象

在Intel CPU的Windows电脑下，启动模拟器失败，提示“CPU VT/NX is disabled in BIOS.”，CPU VT/NX不可用。

解决措施

1. 在电脑开机过程中，进入电脑的BIOS设置界面，将CPU的“VT/NX”选项开启。
2. 重新启动模拟器。

启动模拟器，提示无法安装GVM

问题现象

在AMD CPU的Windows电脑下，启动模拟器失败，提示“Unable to install GVM.”，无法安装GVM。

解决措施

1. 打开任务管理器，在“性能”选项，检查CPU虚拟化是否已经启用。如果未启用，需要进入电脑的BIOS中，将CPU的“Virtualization Technology”选项开启。

说明

如果没有CPU虚拟化选项，则不支持本地模拟器。

2. 打开控制面板 > 程序 > 程序与功能 > 启动或关闭Winodows功能，找到并取消勾选“Hyper-V”，点击确定并重启电脑。

3. 重新启动模拟器。

通过命令行启动模拟器，提示非法的启动方式

问题现象

运行Emulator进程，提示“Invalid method to start the emulator.”，非法的模拟器启动方式。

解决措施

可以通过如下两种方式启动模拟器。

• 通过DevEco Studio的Tools > Device Manager > Local Emulator界面启动模拟器。
• 打开命令行窗口，并进入到模拟器目录，执行以下命令启动模拟器。默认的模拟器目录为：

     ○  Windows：C:\Users\用户名\AppData\Local\Huawei\Sdk\emulator

     ○  macOS：/Users/用户名/Library/Huawei/Sdk/emulator

Emulator –hvd 模拟器名称

本地模拟器支持C++工程调试

在C++工程的模块下的build.gradle文件中的abiFilters字段中，添加"x86_64"， 本地模拟器就可以支持C++工程调试。

启动模拟器，超时无响应

问题现象

模拟器启动时间过长，界面显示“HarmonyOS”或者黑屏，无法操作。

解决措施

1. 打开任务管理器，查看系统资源占用情况，关闭系统资源占用高的其他程序以使系统保持更好性能。
2. 在Local Emulator的设备列表窗口，点击“Wipe User Data”清除模拟器数据，然后重新启动模拟器。

启动模拟器，提示“多个视频控制器正在运行，请确保只启用一个”

问题现象

启动模拟器，提示“多个视频控制器正在运行，请确保只启用一个”。

解决措施

当电脑启用了多个显卡时，会提示以上报错信息。解决措施为只保留一个显卡为启用状态，将其他的显卡禁用。具体的操作步骤如下：

1. 打开设备管理器，展开显示适配器。
2. 双击要禁用的显卡，在驱动程序页签单击禁用设备，在弹出的对话框中选择是，单击确定。该显卡被禁用。

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/faq-local-emulator-0000001116085454-V3​​