在鸿蒙应用开发中,调试阶段如使用手动签名,必须配置调试Profile。

一、前提条件

条件 说明
创建应用/元服务 已创建 HarmonyOS应用或创建 元服务
调试证书 已申请 调试证书
调试设备 已注册 调试设备
ACL权限(如需) 已申请 并获取ACL权限
账号权限 已获取 "访问调试类Profile"权限

注意

  • 一个应用最多可申请100个Profile文件

  • 申请ACL权限的入口已调整至项目下的"ACL权限"页签,创建Profile时仅支持添加已获取的ACL权限

二、操作步骤

步骤1:进入Profile页面

登录AppGallery Connect,选择"证书、APP ID和Profile"。左侧导航栏选择"证书、APP ID和Profile → Profile",点击右上角"添加"。

步骤2:填写Profile信息

参数 说明
应用名称 选择需要申请调试Profile的应用名称
包名 选择应用名称后自动填充
Profile名称 不超过100个字符
类型 选择"调试"
选择证书 选择一个调试证书(不支持发布证书)
选择设备 选择一个或多个调试设备,最多100个

步骤3:(可选)添加ACL权限

如需要ACL权限:

  1. 选中"受限ACL权限(HarmonyOS API9及以上)"选项

  2. 应用/元服务获取的所有ACL权限都将被添加至Profile内

  3. 点击"查看"可查看已获取的ACL权限

  4. 如需增加更多权限,可点击"去申请"前往ACL权限页面申请

步骤4:提交并下载

点击右上角"添加",调试Profile申请成功。点击"下载",将生成的Profile保存至本地,供后续签名使用。

三、Profile管理

3.1 状态说明

状态 说明
生效 Profile可用
失效/已吊销 Profile不可用,需重新申请

3.2 编辑设备

"生效"状态的调试Profile支持修改绑定的调试设备:

  1. 点击"编辑设备"

  2. 重新选择调试设备

  3. 修改后会生成新的调试Profile

  4. 请在生效后重新下载调试Profile

其他注意事项

注意事项 说明
ACL权限变化 创建Profile后修改了ACL权限,需重新创建新的Profile
证书指纹配置 如集成依赖公钥指纹的开放能力,需配置 公钥指纹
公钥指纹提示 若应用未配置关联的调试证书指纹,系统会提示配置

   申请调试Profile需先准备调试证书和注册调试设备,ACL权限需先获取再添加到Profile(如需要)。Profile类型必须选择"调试",证书仅支持调试证书,最多绑定100个设备。ACL权限变化需重新创建Profile,修改设备后需重新下载。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐