公钥指纹是应用签名证书的摘要信息,用于校验应用的真实性。如应用当前集成的华为相关服务(如华为账号服务)依赖公钥指纹,需要在应用调试或上架前将公钥指纹配置到AppGallery Connect。

一、公钥指纹

公钥指纹是应用签名证书(.cer文件)的摘要信息,用于校验应用的真实性

说明 内容
调试与发布证书不同 调试和发布使用的签名证书不同,因此调试和发布前请分别基于使用的证书配置相应的公钥指纹
数量限制 每个HarmonyOS应用/元服务最多支持添加50个公钥指纹
生效时间 指纹配置后最迟25小时生效

二、添加公钥指纹

2.1 操作步骤

  1. 登录AppGallery Connect,点击"开发与服务"

  2. 在项目列表中找到项目,在项目中点击HarmonyOS应用/元服务

  3. 在"项目设置 → 常规"页面的"应用"区域,点击"SHA256证书/公钥指纹"后的"添加公钥指纹"

  4. 在"添加SHA256公钥指纹"窗口,"添加方式"选择"选择指纹"

  5. 选择应用/元服务使用的证书对应的指纹,点击"确认"

注意

  • 调试阶段请选择调试证书指纹

  • 发布阶段请选择发布证书指纹

  • 过期或废弃的证书不在此展示

2.2 快速生效方法

     指纹最迟在25小时后生效。如急需指纹生效,请执行以下操作:

  1. 在指纹成功配置10分钟

  2. 改变应用/元服务工程"app.json5"文件中的"versionCode"字段的值触发指纹生效

  3. 例如:原先值为"1000000",修改为"1000001"

三、删除公钥指纹

操作步骤

  1. 登录AGC,进入"项目设置 → 常规"页面

  2. 在"SHA256证书/公钥指纹"栏中找到需删除的公钥指纹

  3. 点击删除按钮

  4. 核对指纹信息无误后,点击"确认"

注意:删除指纹会导致需要对应用合法进行校验的所有API调用失败,请谨慎操作

   鸿蒙AGC配置公钥指纹用于校验应用真实性,调试和发布需分别配置对应证书指纹,每个应用最多50个,指纹最迟25小时生效(修改versionCode可加速),删除指纹会导致依赖校验的API调用失败。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐