鸿蒙 AGC：配置公钥指纹

公钥指纹是应用签名证书的摘要信息，用于校验应用的真实性。如应用当前集成的华为相关服务（如华为账号服务）依赖公钥指纹，需要在应用调试或上架前将公钥指纹配置到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调用失败。