手把手教你使用 HarmonyOS 本地模拟器

2021 年的华为开发者大会（HDC2021）上，我们随 DevEco Studio 3.0 Beta1 版本发布首次推出了本地模拟器（也称为 Local Emulator），支持模拟手机品类。我们通过下面的视频来回顾下手机本地模拟器的使用效果。

本期，我们将为大家介绍 HarmonyOS 本地模拟器的版本演进，并手把手教大家使用 HarmonyOS 本地模拟器。

一、本地模拟器的版本演进

2021 年 12 月 31 日，经过一个版本的迭代优化，随 DevEco Studio 3.0 Beta2 版本发布的本地模拟器新增了智能手表和智慧屏的模拟器品类。

本地模拟器分别针对智能手表和智慧屏的特征，定制了其独有的特性。

• 智能手表：支持心率、步数的模拟数据注入，支持旋转表冠按钮的模拟。

图 1 智能手表

• 智慧屏：支持遥控器的模拟。

图 2 智慧屏

下面，我们通过一段视频来看看智能手表和智慧屏品类本地模拟器的使用效果。

通过以上对本地模拟器的介绍，不难看出本地模拟器具有以下优势：

• 直接运行在用户本地计算机上，不需要登录授权，零延迟，也不受使用时长限制，拥有和真机一样的性能。

• 提供 audio、battery、location 等多种通用器件模拟，为开发者提供了一个近似真机的运行环境。

• 对华为设备提供产品专属模拟，如智能手表的旋转按压功能键，以及智慧屏的遥控器模拟等。

• 支持 Java、JS、C/C++单语言调试和 JS+Java 跨语言调试能力，帮助开发者更方便、高效地调试应用。

二、使用前的准备工作

了解了本地模拟器之后，下面我们要重点为大家讲解如何使用本地模拟器。在使用本地模拟器之前，我们需要做好以下准备工作：

1. 本地模拟器是创建和运行在本地计算机上的，需确保本地计算机满足以下资源要求：

• Windows 系统：8GB 及以上

• macOS 系统：8GB 及以上

说明：不支持在虚拟机系统上运行本地模拟器，例如不支持在 Ubuntu 系统上，通过安装 Windows 虚拟机，然后使用 Windows 系统安装和运行模拟器。

2. 检查 DevEco Studio 的版本：

DevEco Studio V3.0 Beta1 及更高版本才支持本地模拟器，当前推荐使用 DevEco Studio V3.0 Beta2 版本。

3. 使用本地模拟器前，需要安装相应的镜像包，具体操作如下：

（1）打开 DevEco Studio，选择“Files > Settings”（macOS 系统则选择“DevEco Studio > Preferences”）。

（2）如图 3 所示，在“SDK Manager > HarmonyOS Legacy SDK”页签，勾选“Platforms”下的镜像包。不同的的镜像包对应不同的设备类型，System-image-phone 镜像包对应手机，System-image-tv 镜像包对应智慧屏，System-image-wearable 镜像包对应智能手表。

图 3 下载镜像包

（3）点击“Apply”进行安装。

4. 安装本地模拟器。

在菜单栏选择“Tools > Device Manager”，进入图 4 所示界面，点击“Install”即可安装本地模拟器。

图 4 安装本地模拟器

三、创建和使用本地模拟器

完成了上面的准备工作，接下来就是本文的重点，教大家如何创建和使用本地模拟器。

1.（可选）自定义本地模拟器文件存放路径。

本地模拟器文件的默认存放路径为：C:\Users\用户名\AppData\Local\Huawei\HarmonyOSEmulator\deployed。如果 C 盘空间紧张，可以通过新增一个系统的环境变量 HarmonyOS_HVD_HOME 自定义存放路径，指向空间充裕的目录。

2. 创建本地模拟器。

（1）打开 DevEco Studio，选择“Tools > Device Manager”。如图 3 所示，在 Local Emulator 页签中，点击右下角的 New Emulator 按钮，开始创建本地模拟器。

图 5 创建本地模拟器

（2）选择一个设备来创建本地模拟器。

如图 4 所示，DevEco Studio 默认提供 Huawei_Phone、Huawei_TV 和 Huawei_Wearable 三个设备，分别对应手机、智慧屏和智能手表。针对华为设备的特征，DevEco Studio 对这三个设备预置了尺寸、分辨率等参数。

图 6 选择一个设备

开发者点击 New Hardware 或 Huawei_Phone 后的克隆 图标，可以创建新的手机设备，自定义设备的名称、尺寸、分辨率、内存等参数（如图 7）。

图 7 自定义手机参数

开发者从默认的三个设备或者创建的手机设备中，选择一个设备来创建本地模拟器。

（3）选择好设备后，点击 Next，可以看到本地模拟器的镜像信息。

（4）再次点击 Next，检查本地模拟器的配置信息，如有需要此时还可以修改配置信息。确认无误后，点击 Finish 完成本地模拟器的创建。

创建成功后，在 Local Emulator 页签可以看到新创建的本地模拟器，如图 8 所示。

图 8 本地模拟器创建成功

3. 运行本地模拟器。

（1）在 Local Emulator 页签（如图 8），点击即可启动本地模拟器。

（2）点击 DevEco Studio 工具栏中的按钮运行工程，或使用默认快捷键 Shift+F10（Mac 为 Control+R）运行工程。

图 9 运行工程

（3）DevEco Studio 会启动应用的编译构建，完成后应用即可运行在本地模拟器上。以手机设备为例，运行效果如图 10 所示。

图 10 运行本地模拟器

图 8 所示的手机本地模拟器，除了可以像真机一样直接在手机屏幕内操作，右侧的工具栏提供了操作便捷、丰富和数据注入能力，包括：调整音量、电池模拟、GPS 模拟、网络模拟、虚拟传感器模拟等。

本地模拟器目前支持手机、智能手表和智慧屏三种设备类型。图 11 展示了同一套代码同时在智能手表、手机和智慧屏三个设备上的运行效果。

图 11 本地模拟器运行效果

四、结束语

本期介绍了本地模拟器的使用，你掌握了吗？欢迎大家来使用和探索本地模拟器的更多丰富功能~

在使用本地模拟器过程中，如果遇到问题，可先参考 FAQ：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/faq-local-emulator-0000001116085454

如果问题仍然没有解决，可通过华为开发者论坛向我们反馈：

https://developer.huawei.com/consumer/cn/forum/block/deveco-studio

我们将在后续版本中支持更多设备的本地模拟器，也将对大家反馈的问题进行优化和改进，提升大家的使用体验。请继续关注我们，感谢有你！