在发布HarmonyOS应用/服务前,建议您在本地进行调试,以查看和验证应用/服务运行效果,减少发布过程中可能遇到的问题。
为了确保HarmonyOS应用/服务的完整性,HarmonyOS通过数字证书和Profile文件来对应用/服务进行管控,只有签名过的HAP才能安装到设备上运行。因此,为了保证应用/服务能够安装到调试设备上, 您需要提前申请相应的调试证书与调试Profile。
说明
本文档介绍如何通过手动签名方式调试HarmonyOS应用/服务。如果您的应用/服务调试时可以联网,建议您使用HUAWEI DevEco Studio自动化签名的方式对应用/服务进行签名并调试。
操作流程
申请调试证书
快速互动体验
前提条件
操作步骤
- 登录AppGallery Connect,选择“用户与访问”。注意未实名开发者可在当前页面的顶部菜单下拉列表中选择“用户与访问”。
- 在左侧导航栏选择“证书管理”,进入证书管理页面,点击“新增证书”。
- 在弹出的“新增证书”窗口,填写要申请的证书信息,点击“提交”。
参数说明证书名称不超过100个字符。证书类型选择“调试证书”。上传证书请求文件(CSR)上传已生成的证书请求文件(CSR)。 - 证书申请成功后,证书管理页面展示证书名称、证书类型和失效日期。
说明
您最多可申请两个调试证书。
注册调试设备
快速互动体验
前提条件
您已准备好调试设备,设备要求运行HarmonyOS。
操作步骤
- 登录AppGallery Connect,选择“用户与访问”。注意未实名开发者可在当前页面的顶部菜单下拉列表中选择“用户与访问”。
- 在左侧导航栏选择“设备管理”,进入设备管理页面。
- 如需添加单个设备,点击右上角的“添加设备”,在弹出窗口填写设备信息,完成后点击“提交”。
参数说明名称不超过100个字符。类型要注册的调试设备类型,支持选择运动手表、智能手表、智慧屏、手机或路由器。UDID设备唯一标识符,是由字母和数字组成的64位字符串。您可在对应的调试设备上获取其UDID,调试设备要求运行HarmonyOS系统。关于各类型设备如何获取UDID,请参见UDID获取方法。 - 如需批量添加设备,点击右上角的“批量添加设备”,在弹出窗口进行以下操作:
- 在弹出窗口中点击“下载模板”。
- 在下载的模板表格中填写批量导入的设备信息。参数说明设备名称不超过100个字符。设备类型要注册的调试设备类型,可选择运动手表(liteWearable)、智能手表(wearable)、智慧屏(tv)、路由器(router)或手机(phone)。UDID注意请将“UDID”列单元格设置为文本格式。设备唯一标识符,是由字母和数字组成的64位字符串。您可在对应的调试设备上获取其UDID,调试设备要求运行HarmonyOS系统。关于各类型设备如何获取UDID,请参见UDID获取方法。
- 点击“点击上传文件”,上传填写好的模板文件,或直接拖拽文件上传。完成后点击“提交”。
- 如需添加单个设备,点击右上角的“添加设备”,在弹出窗口填写设备信息,完成后点击“提交”。
- 设备添加成功后,您可在“设备管理”页面查看各设备的名称、类型、UDID。
说明您最多可添加100个调试设备。 - 如需删除调试设备,勾选一个或多个设备,点击“批量删除设备”,在弹出窗口中点击“确认”即可。说明如果设备已被Profile绑定,您需要在“管理HAP Provision Profile”页面中删除Profile后,再进行删除设备的操作。
申请调试Profile
快速互动体验
前提条件
- 已创建您的AGC项目,并已在项目下创建HarmonyOS应用/服务。
- 已申请调试证书,并注册至少一个调试设备。
操作步骤
- 登录AppGallery Connect,选择“我的项目”。注意未实名开发者可在当前页面的顶部菜单下拉列表中选择“我的项目”。
- 找到您的项目,点击您创建的HarmonyOS应用/服务。
- 选择“HarmonyOS应用 > HAP Provision Profile管理”,进入“管理HAP Provision Profile”页面,点击右上角“添加”。
- 在弹出的“HarmonyAppProvision信息”窗口添加调试Profile,完成后点击“提交”。
参数说明名称不超过100个字符。类型选择“调试”。选择证书点击“选择”,选择一个调试证书。注意首次发布应用/服务时,申请调试Profile请勿选择发布证书。升级应用/服务时,除去调试证书,您还可额外选择当前在架应用/服务的发布证书,以继承获取已上架应用/服务的数据与权限。选择设备点击“选择”,选择一个或多个调试设备。最多可选择100个调试设备。申请受限权限若软件包因特殊场景要求使用受限权限,如读取、 添加、移除或更改联系人数据等,请您务必在此处进行申请,否则您的应用/服务将无法在调试设备上安装调试。点击“选择”,勾选需要申请的权限,点击“确定”即可。 - 调试Profile申请成功后,“管理HAP Provision Profile”页面展示Profile名称、Profile类型、添加的证书、状态(默认为“生效”)、更新时间(即审核通过时间)和失效日期。
说明
您最多可申请100个Profile文件。
调试应用/服务
- 下载调试证书,详见申请调试证书-步骤4。
- 下载调试Profile,详见申请调试Profile-步骤5。
- 在HarmonyOS应用/服务调试包中集成调试Profile,使用调试证书对应的私钥对HarmonyOS应用/服务调试包进行签名,详见手动方式对HarmonyOS应用/服务签名。签名配置完成后,即可构建调试包,详见编译构建生成HAP。
- 在调试Profile绑定的调试设备上安装调试包,即可启动调试,详见使用真机进行调试。
UDID获取方法
- 手机的UDID获取方法如下:
- 打开“设置 > 关于手机”,多次点击版本号,打开开发者模式。
- 打开“设置 > 系统和更新”,在最下方找到“开发人员选项”,打开“USB调试”开关。
- 使用PC连接手机后,打开命令行工具,进入HDC目录(一般为:HarmonyOS SDK安装目录/toolchains/{版本号}),输入hdc shell bm get –udid命令,获取设备的UDID。
- 智能手表的UDID获取方法如下:
- 打开智能手表的“设置 > 关于手表”,多次点击版本号,打开开发者模式。
- 打开“设置”,在最下方找到“开发人员选项”,打开“HDC调试”开关。
- 使用PC连接智能手表后,打开命令行工具,进入HDC目录(一般为:HarmonyOS SDK安装目录/toolchains/{版本号}),输入hdc shell bm get –udid命令,获取设备的UDID。
- 路由器的UDID获取方法如下:
- 在DevEco Studio的Terminal窗口,使用telnet命令登录到Router串口,并打开路由器串口打印,具体请参考在Router中运行应用。
- 在Terminal窗口输入debug cms get udid命令,获取设备的UDID。
- 运动手表的UDID获取方法如下:
- 智慧屏:当前不支持获取智慧屏的UDID。