华为官方：手把手教你使用鸿蒙 HarmonyOS 本地模拟器

2 月 26 日消息，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：本地模拟器 >>

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