HarmonyOS Developer DevEco Studio使用指南-应用/服务运行
使用远程真机运行应用/服务
概述
说明
该特性在DevEco Studio V2.2 Beta1及更高版本中支持。
如果开发者没有真机设备资源,则不能很方便的调试和验证HarmonyOS应用,为方便开发者,DevEco Studio提供了Remote Device远程真机设备资源供开发者使用,减少开发成本。目前,远程真机支持Phone和Wearable设备,开发者使用远程真机调试和运行应用时,同本地物理真机设备一样,需要对应用/服务进行签名才能运行。
相比远程模拟器,远程真机是部署在云端的真机设备资源,远程真机的界面渲染和操作体验更加流畅,同时也可以更好的验证应用/服务在真机设备上的运行效果,比如性能、手机网络环境等。
前提条件
说明
需要注意的是,远程真机每次释放后重新申请,服务端分配的设备都不一样。因此,每次重新申请远程真机后,都需要对应用/服务重新进行签名。
操作步骤
- 在DevEco Studio菜单栏,单击Tools > Device Manager。
- 在Remote Device页签中,单击Sign In,在浏览器中弹出华为开发者联盟帐号登录界面,请输入已实名认证的华为开发者联盟帐号的用户名和密码进行登录(查看登录授权常见问题)。
- 登录后,请单击界面的允许按钮进行授权。
在Single device中,单击设备运行按钮
,启动远程真机设备(同一时间只能启动一个设备)。
单击DevEco Studio的Run > Run'模块名称'或
,或使用默认快捷键Shift+F10(macOS为Control+R)。
- DevEco Studio会启动应用/服务的编译构建,完成后应用/服务即可运行在远程真机上。
使用本地真机运行应用/服务
在Phone和Tablet中运行应用/服务
在Phone和Tablet中运行HarmonyOS应用/服务的操作方法一致,可以采用USB连接方式或者IP Connection的连接方式。采用IP Connection连接方式要求Phone/Tablet和PC端在同一个网段,建议将Phone/Tablet和PC连接到同一个WLAN下。
使用USB连接方式
前提条件
- 在Phone或者Tablet中,打开“开发者模式”,可在设置 > 关于手机/关于平板中,连续多次单击“版本号”,直到提示“您正处于开发者模式”即可。然后在设置的系统与更新 > 开发人员选项中,打开“USB调试”开关。
- 在Phone或者Tablet中运行应用/服务,需要根据为应用/服务进行签名章节,提前对应用/服务进行签名。
操作步骤
- 使用USB方式,将Phone或者Tablet与PC端进行连接。
- 在Phone或者Tablet中,USB连接方式选择“传输文件”。
- 在Phone或者Tablet中,会弹出“是否允许USB调试”的弹框,单击确定。
在菜单栏中,单击Run>Run'模块名称'或
,或使用默认快捷键Shift+F10(macOS为Control+R)运行应用/服务。
- DevEco Studio启动HAP的编译构建和安装。安装成功后,Phone或者Tablet会自动运行安装的HarmonyOS应用/服务。
使用IP Connection连接方式
前提条件
- 已将Phone/Tablet和PC连接到同一WLAN网络。
- 已获取Phone/Tablet端的IP地址,可通过设置 > 关于手机/关于平板 > 状态信息 > IP地址进行查看。
- Phone/Tablet上的5555端口为打开状态,默认是关闭状态,可以通过使用USB连接方式连接上设备后,在PC中执行如下命令打开。
hdc tmode port 5555
更多关于命令行工具hdc的使用说明,请参见hdc使用指导。
- 在Phone/Tablet中运行应用/服务,需要根据为应用/服务进行签名章节,提前对应用/服务进行签名。
操作步骤
1. 在DevEco Studio菜单栏中,单击Tools>IP Connection,输入连接设备的IP地址,单击
,连接正常后,设备状态为online。
在菜单栏中,单击Run>Run'模块名称'或
,或使用默认快捷键Shift+F10(macOS为Control+R)运行应用/服务。
- DevEco Studio启动HAP的编译构建和安装。安装成功后,Phone/Tablet会自动运行安装的HarmonyOS应用/服务。
在Car中运行应用/服务
当前暂不支持使用Car类型真机进行运行和调试。
在TV中运行应用/服务
当前暂不支持使用商用智慧屏(TV)真机进行运行和调试,如需运行和调试智慧屏应用或原子化服务,请使用远程模拟器或远程真机。
在Wearable中运行应用/服务
在Wearable中安装和运行HarmonyOS应用/服务,可以采用USB连接方式或者IP Connection的连接方式。采用IP Connection连接方式要求Wearable和PC端在同一个网段,建议将Wearable和PC连接到同一个WLAN下。
使用USB连接方式
前提条件
- 在Wearable中,打开“开发者模式”,可在设置 >关于中,连续单击“版本号”,直到提示“您已处于开发者模式!”即可。然后在设置 >开发人员选项中,打开“HDC调试”开关。
- 在Wearable中运行应用/服务,需要根据为应用/服务进行签名章节,提前对应用/服务进行签名。
操作步骤
- 使用USB方式,连接Wearable和PC端。
- 在菜单栏中,单击Run>Run'模块名称'或
,或使用默认快捷键Shift+F10(macOS为Control+R)运行应用/服务。
- DevEco Studio启动HAP的编译构建和安装。安装成功后,Wearable会自动运行安装的HarmonyOS应用/服务。
使用IP Connection连接方式
前提条件
- 已将Wearable和PC连接到同一WLAN网络。
- 在Wearable中,打开“开发者模式”,可在设置 >关于中,连续单击“版本号”,直到提示“您已处于开发者模式!”即可。然后在设置 >开发人员选项中,打开“HDC调试”和“通过WlAN调试”开关。
- Wearable上的5555端口为打开状态。如果未打开,可以通过使用USB连接方式连接上设备后,执行如下命令打开。
hdc tmode port 5555
- 在Wearable中运行应用/服务,需要根据为应用/服务进行签名章节,提前对应用/服务进行签名。
操作步骤
- 在DevEco Studio菜单栏中,单击Tools>IP Connection,输入连接设备的IP地址,单击
,连接正常后,设备状态为online。
在菜单栏中,单击Run>Run'模块名称'或
,或使用默认快捷键Shift+F10(macOS为Control+R)运行应用/服务。
- DevEco Studio启动HAP的编译构建和安装。安装成功后,Wearable会自动运行安装的HarmonyOS应用/服务。
在Lite Wearable中运行应用/服务
在Lite Wearable中安装和运行HarmonyOS应用/服务,依赖华为手机上的运动健康和应用调测助手APP辅助进行。
前提条件
- 已将运动健康APP升级至最新版本。
- 从华为应用市场安装应用调测助手APP。
- 在Lite Wearable中运行应用/服务,需要根据为应用/服务进行签名章节,提前对应用/服务进行签名。
说明
因Lite Wearable设备无法与DevEco Studio进行连接,因此在对Lite Wearable应用/服务签名时,不能采用自动化签名方案,只能使用手动方式申请签名文件,然后再手动配置签名信息。
操作步骤
- 使用USB连接线将手机和电脑进行连接,确保连接状态是正常的。
- 手机与电脑使用USB连接时,在手机上选择传输文件连接方式。
- 在工程目录中的Build > outputs >hap中选择生成的HAP,通过手工拷贝的方式将HAP拷贝至手机中的“/sdcard/haps/”目录。
说明
如果在手机存储根目录下没有“haps”文件夹,请手工创建后再拷贝HAP到该文件夹下。
- 将Lite Wearable通过蓝牙与华为手机进行连接。
a. 进入运动健康APP,在设备页签中,单击添加设备按钮。
b. 进入手表列表中,选择对应的Lite Wearable型号。
c. 单击开始配对,按照界面指引完成Lite Wearable与华为手机之间的连接。
- 打开应用调测助手APP,界面会显示已经与华为手机连接的Lite Wearable。
说明
如果Lite Wearable与华为手机未连接,请单击应用调测助手APP界面的连接设备按钮,手机会自动打开运动健康APP添加Lite Wearable。
- 单击应用调测助手APP界面中的应用管理按钮,选择需要安装的HarmonyOS安装包进行安装。
- 安装完成后,单击Lite Wearable中的应用图标,运行HarmonyOS应用。
在Smart Vision设备中运行应用/服务
在Smart Vision中安装和运行HarmonyOS应用/服务,采用手动方式将HAP拷贝到Smart Vision的sdcard中再进行安装。
前提条件
- 在Smart Vision中运行应用/服务,需要提前完成HAP的编译打包。请注意,编译打包时,请选择打包不带签名信息的HAP。
- 获取Smart Vision应用/服务的安装工具,可从Hi3516DV300的HarmonyOS源码编译后的out\ipcamera_hi3516dv300\dev_tools下获取。
- Hi3516DV300开发板已完成HarmonyOS的镜像烧录,并完成镜像的运行,具体请参考Hi3516快速入门。
操作步骤
- 将编译生成的不带签名信息的HAP和安装工具(镜像文件生成目录中的dev_tools文件夹),拷贝到sdcard中,并将sdcard插入开发板卡槽。
- 将PC与开发板进行连接,需要同时连接串口和电源,具体可参考Hi3516开发板介绍。
- 使用串口工具连接开发板,串口工具请自行获取安装。
- 连接开发板后,执行如下命令,关闭HarmonyOS应用/服务签名校验。
./sdcard/dev_tools/bin/bm set -s
- 执行如下命令,安装HarmonyOS应用/服务。
./sdcard/dev_tools/bin/bm install -p /sdcard/airquality.hap
其中,airquality.hap为应用/服务安装包,此处替换为实际工程的应用/服务安装包名称。
- 应用/服务安装完成后,可单击桌面应用/服务图标启动应用。
在Router中运行应用/服务
在Router(路由器)中安装和运行HarmonyOS应用/服务,可以使用网线连接PC和路由器,或者将PC和路由器连接到同一个WLAN。
前提条件
- 已将Router升级为开发者版本,获取开发者版本参考获取路由器开发版本。
- 已将PC连接到Router。
- 在Router中运行应用/服务,需要根据为应用/服务进行签名章节,提前对应用/服务进行签名。
操作步骤
- 使用网线或WLAN方式,将PC和路由器进行连接。
- 在DevEco Studio的Terminal窗口,执行ipconfig命令,查看路由器IP地址。
- 在Terminal窗口,使用telnet命令登录到Router串口,示例如下,IP地址请根据上一步查询的结果进行修改。
telnet 192.168.3.1
- 在Terminal窗口,依次执行sh、su和setconsole,打开路由器串口打印功能。
在DevEco Studio菜单栏中,单击Run>Run'模块名称'或
,或使用默认快捷键Shift+F10(macOS为Control+R)运行应用/服务。
- 界面会弹出设备选择框,选择要推送的Router进行安装运行,单击OK。
- 界面会弹出输入密码的提示框,该密码是Router的Web维护页面登录密码,输入后单击OK,即可把HAP推送到Router安装。
- DevEco Studio启动HAP的编译构建和安装。安装成功后,会在Terminal中打印日志信息。
说明
具体打印日志信息,由开发者在应用/服务中自行定义。