当前位置:首页 > 系统教程 > 正文

手把手教你HarmonyOS应用手动签名:从DevEco Studio配置到AGC平台操作

在开发HarmonyOS应用时,手动签名是发布应用的关键步骤。本文将详细介绍从DevEco Studio配置到AGC平台操作的完整流程,即使是小白也能轻松掌握HarmonyOS手动签名的要点。

一、准备工作

首先,确保你已安装最新版DevEco Studio,并注册华为开发者账号。在AppGallery Connect(AGC)中创建你的应用,获取应用包名等信息。这些是DevEco Studio签名配置的基础。

二、在DevEco Studio中生成密钥库和证书指纹

步骤1:打开你的HarmonyOS项目,点击菜单栏的 Build > Generate Key and CSR

步骤2:在弹出的对话框中,选择新建密钥库,填写密钥库密码、别名、密钥密码以及证书信息(如组织、城市等)。点击Next,选择保存路径,生成密钥库文件(.p12或.jks)。

步骤3:生成后,在DevEco Studio的终端中运行特定命令(如keytool -list -v -keystore your.keystore)来查看证书指纹,包括SHA256指纹。这一步获取的指纹将用于AGC证书管理

手把手教你HarmonyOS应用手动签名:从DevEco Studio配置到AGC平台操作 HarmonyOS手动签名  DevEco Studio签名配置 AGC证书管理 应用签名流程 第1张

三、在AGC平台上配置签名证书指纹

步骤1:登录AppGallery Connect,选择你的应用,进入“开发”>“证书管理”。

步骤2:点击“添加证书”,选择“手动签名”,填写证书名称,并将上一步获取的SHA256指纹粘贴到对应字段。保存后,系统会生成对应的证书指纹配置。

步骤3:下载最新的 agconnect-services.json 文件,并将其放置到项目的 entry 模块根目录下。这个文件包含了AGC平台的应用配置信息,是应用签名流程中不可或缺的一环。

四、在DevEco Studio中配置签名信息

步骤1:在项目级 build.gradle 文件中,找到 androidohos 闭包,添加 signingConfigs 配置,指向你生成的密钥库文件、密码和别名。

步骤2:确保 agconnect-services.json 已正确放置,并在 build.gradle 中应用AGC插件。

步骤3:构建应用(Build > Build APK(s)),如果签名配置正确,将生成已签名的应用包。可以通过命令行或DevEco Studio的日志验证签名信息。

常见问题及注意事项

- 确保密钥库文件安全,不要泄露密码。- 证书指纹必须与AGC平台完全一致,包括字母大小写。- 如果遇到签名验证失败,请检查DevEco Studio签名配置AGC证书管理中的指纹是否匹配。- 每次更新证书,都需要重新下载 agconnect-services.json 并替换。

通过以上步骤,你已经完成了HarmonyOS手动签名的完整配置。掌握应用签名流程有助于你顺利发布应用至华为应用市场。如果在操作中遇到问题,欢迎在评论区交流。