华为官方:手把手教你使用鸿蒙 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:本地模拟器 >>
    如果问题仍然没有解决,可通过华为开发者论坛反馈。