HarmonyOS Developer DevEco Studio使用指南-使用模拟器运行应用
DevEco Studio提供模拟器供开发者运行和调试HarmonyOS应用/服务,对于Phone、TV和Wearable可以使用本地模拟器(Local Emulator)和远程模拟器(Remote Emulator),对于Tablet可以使用Remote Emulator运行应用/服务,对于Lite Wearable和Smart Vision可以使用Simulator运行应用/服务。
同时,DevEco Studio的Remote Emulator还提供超级终端模拟器(Super Device),开发者可以利用超级终端模拟器来调测跨设备应用/服务。
模拟器支持的设备情况如下表所示:
模拟器类型 | 设备类型 | API 版本 |
本地模拟器(Local Emulator) | Phone | 6、9 |
TV | 6 | |
Wearable | 6 | |
远程模拟器(Remote Emulator) | Phone | 9(P50)、8(P50)和6(P40) |
TV | 6 | |
Wearable | 6 | |
Tablet | 6 | |
超级终端模拟器(Super Device) | Phone+Phone | 6 |
Phone+Tablet | 6 | |
Phone+TV | 6 |
说明
- DevEco Studio 3.1 Beta1中,macOS(M1)只支持远程模拟器。
- 本地模拟器中,HarmonyOS 3.1 Beta1手机x86模拟器为DevEco Studio 3.1 Beta1版本新增特性,当前为早期体验版本,功能和性能正在持续优化,如有问题欢迎在线提单。
使用Local Emulator运行应用/服务
DevEco Studio提供的Local Emulator基于X86架构,可以运行和调试Phone、TV和Wearable设备的HarmonyOS应用/服务。在Local Emulator上运行应用/服务兼容签名与不签名两种类型的HAP。
Local Emulator相比于Remote Emulator的区别:Local Emulator是创建和运行在本地计算机上的,不需要登录授权,在运行和调试应用/服务时,由于没有网络数据的交换,因此可以保持很好的流畅性和稳定性;但是需要耗费一定的计算机磁盘资源,具体的资源要求为:
- Windows系统:内存推荐为16GB及以上
- macOS系统:内存推荐为8GB及以上
- 不支持在虚拟机系统上运行本地模拟器,例如不支持在Ubuntu系统上,通过安装Windows虚拟机,然后使用Windows系统安装和运行模拟器。
创建和运行Local Emulator的操作方法如下:
- 单击File > Settings > SDKs > HarmonyOS(macOS系统为DevEco Studio > Preferences > SDKs > HarmonyOS)页签,勾选并下载Platforms下的System-image和Tools下的EmulatorX86资源。
说明
Local Emulator支持Phone、TV和Wearable设备,下载System-image时,请选择对应设备的System-image。
图1 下载System-image资源
图2 下载EmulatorX86资源
- 单击菜单栏的Tools > Device Manager,在Local Emulator页签,单击Edit设置本地模拟器的存储路径Local emulator location,默认存储在C盘目录下。
- 在Local Emulator页签中,单击右下角的New Emulator按钮,创建一个本地模拟器。
在创建模拟器界面,可以选择一个默认的设备;同时也可以单击New Hardware或默认设备后的克隆
图标,添加一个新设备,以便自定义设备的相关参数,如尺寸、分辨率、内存等参数。
说明
自定义新设备,当前只支持Phone设备,TV和Wearable暂不支持。
创建New Hardware时,可以修改设备的名称、尺寸、分辨率、内存等参数。
- 选择需要创建的Hardware,单击Next,可以看到模拟器的镜像信息,如API、Version、CPU/ABI等信息。
- 单击Next,核实确定需要创建的模拟器信息,同时也可以在该界面修改模拟器信息,然后单击Finish创建本地模拟器。
在设备管理器页面,单击
启动模拟器。
- 单击DevEco Studio的Run > Run'模块名称'或
,或使用默认快捷键Shift+F10(macOS为Control+R)。
- DevEco Studio会启动应用/服务的编译构建,完成后应用/服务即可运行在Local Emulator上。
说明
使用本地模拟器过程中遇到的问题请参考本地模拟器FAQ解决。
使用Remote Emulator运行应用/服务
使用单设备模拟器运行应用/服务
Remote Emulator支持Phone、Wearable、Tablet、TV等设备类型,但不同区域(开发者帐号注册地)支持的设备类型可能不同,请以实际可申请的设备类型为准。
Remote Emulator中的单设备模拟器(Single Device)可以运行和调试Phone(P50、P40)、Tablet(MatePad Pro)、TV和Wearable设备的HarmonyOS应用/服务,可兼容签名与不签名两种类型的HAP。
Remote Emulator每次使用时长为2小时,到期前可申请延长使用时间。如果Remote Emulator到期释放后,可以重新申请资源。
- 在DevEco Studio菜单栏,单击Tools > Device Manager。
- 在Remote Emulator页签中,单击Sign in,在浏览器中弹出华为开发者联盟帐号登录界面,请输入已实名认证的华为开发者联盟帐号的用户名和密码进行登录。
说明
a. 推荐使用最新版本Chrome浏览器,如果使用Safari、360等其他浏览器,要取消阻止跨站跟踪和阻止所有Cookie功能。
b. 点击Sign in之后,如果DevEco Studio一直显示进度条等待弹框,并未有浏览器弹出并打开开发者联盟登录界面,此时您可以主动切换到浏览器查看相应的界面。更多问题可以查看远程模拟器登录常见问题.。
- 登录后,请单击界面的允许按钮进行授权,授权完成后,切换回Device Manager界面。
在Single Device中,单击设备运行按钮
,启动远程模拟设备(同一时间只能启动一个设备)。
- 单击DevEco Studio的Run > Run'模块名称'或
,或使用默认快捷键Shift+F10(macOS为Control+R)。
- DevEco Studio会启动应用/服务的编译构建,完成后应用/服务即可运行在Remote Emulator上。
使用超级终端模拟器运行应用/服务
说明
该特性在DevEco Studio V2.1 Release及更高版本中支持。
目前超级终端模拟器支持“Phone+Phone”、“Phone+Tablet”和“Phone+TV”的设备组网方式,开发者可以使用该超级终端模拟器来调测具备跨设备特性的应用/服务,如应用/服务在不同设备间的流转。
- 在DevEco Studio菜单栏,单击Tools > Device Manager。
- 在Remote Emulator页签中,单击Login。在浏览器中弹出华为开发者联盟帐号登录界面,请输入已实名认证的华为开发者联盟帐号的用户名和密码进行登录(查看远程模拟器登录常见问题)。
- 登录后,请单击界面的允许按钮进行授权。
在Super Device中,单击设备运行按钮
,启动超级终端模拟器。
在运行应用/服务中,选择Super App,然后单击Run > Run'模块名称'或
,或使用默认快捷键Shift+F10(macOS为Control+R)运行应用/服务。
- 选择各个模块运行的设备。
- DevEco Studio会启动应用/服务的编译构建,完成后应用/服务即可运行在超级终端模拟器上。
当前DevEco Studio提供了具备跨设备特性的工程模板,可以使用“Video Player Ability”模板。
说明
“Video Player Ability”可通过访问Templates Market获取,Templates Market提供更多模板资源,在创建工程的Choose your ability template页面上单击Templates Market进入。
使用Simulator运行应用/服务
DevEco Studio提供的Simulator可以运行和调试Lite Wearable和Smart Vision设备的HarmonyOS应用/服务。在Simulator上运行应用/服务兼容签名与不签名两种类型的HAP。
- 选择需要运行的设备,默认情况下DevEco Studio会自动匹配对应的设备模拟器。
- 单击DevEco Studio的Run > Run'模块名称'或
,或使用默认快捷键Shift+F10(macOS为Control+R)。
- DevEco Studio会启动应用/服务的编译构建,完成后应用/服务即可运行在Simulator上。