手动签名方式调试HarmonyOS应用/服务

在发布HarmonyOS应用/服务前，建议您在本地进行调试，以查看和验证应用/服务运行效果，减少发布过程中可能遇到的问题。

为了确保HarmonyOS应用/服务的完整性，HarmonyOS通过数字证书和Profile文件来对应用/服务进行管控，只有签名过的HAP才能安装到设备上运行。因此，为了保证应用/服务能够安装到调试设备上， 您需要提前申请相应的调试证书与调试Profile。

说明

本文档介绍如何通过手动签名方式调试HarmonyOS应用/服务。如果您的应用/服务调试时可以联网，建议您使用HUAWEI DevEco Studio自动化签名的方式对应用/服务进行签名并调试。

操作流程

申请调试证书

快速互动体验

前提条件

已生成证书请求文件（CSR）。

操作步骤

1. 登录AppGallery Connect，选择“用户与访问”。注意未实名开发者可在当前页面的顶部菜单下拉列表中选择“用户与访问”。
2. 在左侧导航栏选择“证书管理”，进入证书管理页面，点击“新增证书”。

3. 在弹出的“新增证书”窗口，填写要申请的证书信息，点击“提交”。参数说明证书名称不超过100个字符。证书类型选择“调试证书”。上传证书请求文件（CSR）上传已生成的证书请求文件（CSR）。
4. 证书申请成功后，证书管理页面展示证书名称、证书类型和失效日期。
   • 点击“下载”，可下载证书。
   • 如证书已过期或无需再使用，点击“废除”即可删除。

说明

您最多可申请两个调试证书。

注册调试设备

快速互动体验

前提条件

您已准备好调试设备，设备要求运行HarmonyOS。

操作步骤

1. 登录AppGallery Connect，选择“用户与访问”。注意未实名开发者可在当前页面的顶部菜单下拉列表中选择“用户与访问”。

2. 在左侧导航栏选择“设备管理”，进入设备管理页面。
   • 如需添加单个设备，点击右上角的“添加设备”，在弹出窗口填写设备信息，完成后点击“提交”。参数说明名称不超过100个字符。类型要注册的调试设备类型，支持选择运动手表、智能手表、智慧屏、手机或路由器。UDID设备唯一标识符，是由字母和数字组成的64位字符串。您可在对应的调试设备上获取其UDID，调试设备要求运行HarmonyOS系统。关于各类型设备如何获取UDID，请参见UDID获取方法。
   • 如需批量添加设备，点击右上角的“批量添加设备”，在弹出窗口进行以下操作：
     1. 在弹出窗口中点击“下载模板”。
     2. 在下载的模板表格中填写批量导入的设备信息。参数说明设备名称不超过100个字符。设备类型要注册的调试设备类型，可选择运动手表（liteWearable）、智能手表（wearable）、智慧屏（tv）、路由器（router）或手机（phone）。UDID注意请将“UDID”列单元格设置为文本格式。设备唯一标识符，是由字母和数字组成的64位字符串。您可在对应的调试设备上获取其UDID，调试设备要求运行HarmonyOS系统。关于各类型设备如何获取UDID，请参见UDID获取方法。
     3. 点击“点击上传文件”，上传填写好的模板文件，或直接拖拽文件上传。完成后点击“提交”。
3. 设备添加成功后，您可在“设备管理”页面查看各设备的名称、类型、UDID。说明您最多可添加100个调试设备。
4. 如需删除调试设备，勾选一个或多个设备，点击“批量删除设备”，在弹出窗口中点击“确认”即可。说明如果设备已被Profile绑定，您需要在“管理HAP Provision Profile”页面中删除Profile后，再进行删除设备的操作。

申请调试Profile

快速互动体验

前提条件

• 已创建您的AGC项目，并已在项目下创建HarmonyOS应用/服务。
• 已申请调试证书，并注册至少一个调试设备。

操作步骤

1. 登录AppGallery Connect，选择“我的项目”。注意未实名开发者可在当前页面的顶部菜单下拉列表中选择“我的项目”。
2. 找到您的项目，点击您创建的HarmonyOS应用/服务。
3. 选择“HarmonyOS应用 > HAP Provision Profile管理”，进入“管理HAP Provision Profile”页面，点击右上角“添加”。

4. 在弹出的“HarmonyAppProvision信息”窗口添加调试Profile，完成后点击“提交”。参数说明名称不超过100个字符。类型选择“调试”。选择证书点击“选择”，选择一个调试证书。注意首次发布应用/服务时，申请调试Profile请勿选择发布证书。升级应用/服务时，除去调试证书，您还可额外选择当前在架应用/服务的发布证书，以继承获取已上架应用/服务的数据与权限。选择设备点击“选择”，选择一个或多个调试设备。最多可选择100个调试设备。申请受限权限若软件包因特殊场景要求使用受限权限，如读取、 添加、移除或更改联系人数据等，请您务必在此处进行申请，否则您的应用/服务将无法在调试设备上安装调试。点击“选择”，勾选需要申请的权限，点击“确定”即可。
5. 调试Profile申请成功后，“管理HAP Provision Profile”页面展示Profile名称、Profile类型、添加的证书、状态（默认为“生效”）、更新时间（即审核通过时间）和失效日期。
   • 点击“删除”，在确认框中点击“确认”，可删除Profile文件。
   • 点击“下载”，可下载Profile文件。
   • 点击“查看设备”，可查看Profile绑定的调试设备。
   • 点击“查看”，可了解Profile绑定的证书、设备、申请的受限权限等更多信息。

说明

您最多可申请100个Profile文件。

调试应用/服务

1. 下载调试证书，详见申请调试证书-步骤4。
2. 下载调试Profile，详见申请调试Profile-步骤5。
3. 在HarmonyOS应用/服务调试包中集成调试Profile，使用调试证书对应的私钥对HarmonyOS应用/服务调试包进行签名，详见手动方式对HarmonyOS应用/服务签名。签名配置完成后，即可构建调试包，详见编译构建生成HAP。
4. 在调试Profile绑定的调试设备上安装调试包，即可启动调试，详见使用真机进行调试。

UDID获取方法

• 手机的UDID获取方法如下：
  1. 打开“设置 > 关于手机”，多次点击版本号，打开开发者模式。
  2. 打开“设置 > 系统和更新”，在最下方找到“开发人员选项”，打开“USB调试”开关。
  3. 使用PC连接手机后，打开命令行工具，进入HDC目录（一般为：HarmonyOS SDK安装目录/toolchains/{版本号}），输入hdc shell bm get –udid命令，获取设备的UDID。
• 智能手表的UDID获取方法如下：
  1. 打开智能手表的“设置 > 关于手表”，多次点击版本号，打开开发者模式。
  2. 打开“设置”，在最下方找到“开发人员选项”，打开“HDC调试”开关。
  3. 使用PC连接智能手表后，打开命令行工具，进入HDC目录（一般为：HarmonyOS SDK安装目录/toolchains/{版本号}），输入hdc shell bm get –udid命令，获取设备的UDID。

• 路由器的UDID获取方法如下：
  1. 在DevEco Studio的Terminal窗口，使用telnet命令登录到Router串口，并打开路由器串口打印，具体请参考在Router中运行应用。
  2. 在Terminal窗口输入debug cms get udid命令，获取设备的UDID。
• 运动手表的UDID获取方法如下：
  1. 从华为应用市场下载并安装应用调测助手和运动健康app。
  2. 打开应用调测助手，选择底部的“Lite Wearable”页签。
  3. 点击“连接设备”，自动打开运动健康app。
  4. 在运动健康app的“设备”页签中，点击“添加设备”。
  5. 在“手表”列表，选择对应的手表型号。
  6. 点击“开始配对”，按界面指引完成运动手表与华为手机的配对。配对成功后，应用调测助手界面会显示运动手表型号和UDID， 点击“复制 ”即可复制UDID到剪贴板。
• 智慧屏：当前不支持获取智慧屏的UDID。