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