DevEco Studio签名认证与上传应用

DevEco Studio签名认证与上传应用

引言

通过本指南，您将彻底搞懂并完成：

​核心概念：理解证书、Profile、密钥之间的关系与作用。

​文件制备：在 DevEco Studio 中生成密钥和证书请求文件。

​官方申请：在 AppGallery Connect 平台申请正式的发布证书与 Profile 文件。

​工程签名：在 DevEco Studio 中配置签名，构建正式发布包（.app 文件）。

​一键上传：使用 DevEco Studio 内集成的功能，将应用包上传至 AGC。

‍

⏱️ 需要准备什么？

• 一台安装有 Windows 11/10 系统的电脑。
• 稳定的网络连接（用于下载，测试，上传）。
• 因人而异的时间
• 开发环境：安装并配置好 DevEco Studio。
• 开发者账号：已完成实名认证的华为开发者账号。
• 应用信息：已在 AppGallery Connect 中创建好对应的 HarmonyOS 应用或元服务项目。

‍

️ 本文教程环境

设备 AMD_R7_8845H

DevEco Studio5.1.0

Windows10 专业版

‍

学习路径图（建议按顺序进行）：

我们将依次走过：理解签名原理 → 生成请求文件 → 申请官方凭证 → 配置工程签名 → 构建与上传应用包 → 提交发布。每一步都配有截图和关键说明，助您稳妥通关。

让我们开始，为您精心打造的应用取得正式的“上市通行证”。

‍

---

‍

发布流程概览

开发者完成 HarmonyOS 应用/元服务开发后，需要将应用/元服务打包成 App Pack（.app 文件），用于上架到 AppGallery Connect。发布应用/元服务的完整流程如下图所示，本文将详细解读其中的每一个环节：

HarmonyOS 应用/元服务通过数字证书（.cer 文件）和 Profile 文件（.p7b 文件）来保证应用的完整性。一切始于在 DevEco Studio 中生成最初的密钥和证书请求文件。

1.签名原理

在开始操作前，了解几个关键文件的作用，会让后续步骤更加清晰：

密钥库（.p12） ：一个安全容器，内部存储着您的私钥和公钥。私钥必须严格保密，公钥则用于生成证书请求。包含非对称加密中使用的公钥和私钥，存储在密钥库文件中，格式为.p12，公钥和私钥对用于数字签名和验证。

证书请求文件（.csr） ：包含您的公钥和应用身份信息（如包名），用于向官方（华为 AppGallery Connect）“申请”数字证书。格式为.csr，全称为Certificate Signing Request，包含密钥对中的公钥和公共名称、组织名称、组织单位等信息，用于向AppGallery Connect申请数字证书。

数字证书（.cer） ：由华为官方颁发，是用您的公钥和身份信息生成的“电子身份证”，证明应用来源的合法性。格式为.cer，由华为AppGallery Connect颁发。

Profile 文件（.p7b） ：描述了“哪个应用”（包名）可以用“哪个证书”在“哪些设备”上运行，是应用包的运行许可文件。格式为.p7b，包含HarmonyOS应用/元服务的包名、数字证书信息、描述应用/元服务允许申请的证书权限列表，以及允许应用/元服务调试的设备列表（如果应用/元服务类型为Release类型，则设备列表为空）等内容，每个应用/元服务包中均必须包含一个Profile文件。

‍

HarmonyOS 通过数字证书与 Profile 文件等签名信息来保证应用/元服务的完整性，应用/元服务上架到 AppGallery Connect 必须通过签名校验。因此，您需要使用发布证书和 Profile 文件对应用/元服务进行签名后才能发布。

‍

---

‍

2.生成请求文件

2.1.生成密钥

打开 DevEoc Studio，在主菜单栏单击 Build > Generate Key and CSR。

如果本地已有对应的密钥，无需新生成密钥，可以在Generate Key界面中单击下方的 Skip 跳过密钥生成过程，直接使用已有密钥生成证书请求文件。

第一次使用：点击 New 创建新的密钥库，设置密钥库文件存储路径，并填写 p12 文件名。

建议！！！
密码必须记住 - 忘了就无法使用这个密钥库，需要重新创建，文件必须备份 - 丢失了所有签名信息丢失，无法更新已发布的应用，密码必须至少 8 位，并且从"大小写字母、数字、特殊符号"这四类中至少选择两类组合，小 tips 使用项目名 + 符号：GitCode#2025

最好是建一个加密文件，记录：
文件名: gitcode_pocket_key.p12
密码: (您设置的密码)
创建日期: 2025-12-09
用途: HarmonyOS 应用签名

点击 OK 后，如下图所示，填写一个别名

密钥库文件（.p12）就像是一个保险箱，里面可以放多把钥匙（每个钥匙就是一个密钥对，用别名来区分）或者是密钥库文件 = 钥匙串，别名 = 钥匙串上每把钥匙的标签。

请记住该密码，后续签名配置需要使用。

请记住该别名，后续签名配置需要使用。

高级设置的证书信息可以选填，点击 Next ，

2.2.生成证书请求(. CSR)文件

在 Generate Key and CSR 界面，设置 CSR 文件存储路径和 CSR 文件名。

点击 FinIsh

单击 OK 按钮，创建 CSR 文件成功，可以在存储路径下获取生成的密钥库文件（.p12）和证书请求文件（.csr）。

3.申请官方凭证

通过生成的证书请求文件，向 AppGallery Connect 申请发布证书和 Profile 文件，操作如下。

3.1.创建 HarmonyOS 应用/元服务

在 AppGallery Connect 项目中，创建一个 HarmonyOS 应用/元服务，

3.1.1 为 HarmonyOS 应用创建 APP ID

首先需要为应用生成一个独一无二的 APP ID。

登录 AppGallery Connect，https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/，选择“证书、APP ID 和 Profile”

在左侧导航栏选择“证书、APP ID 和 Profile > APP ID”，进入“APP ID”页面，点击右上角“新建”。

进入“设置应用开发基础信息”页面，填写应用基础信息，完成后点击“下一步”。

参数	说明
应用类型	选择“HarmonyOS 应用”。
应用名称	应用在华为应用市场详情页展示的名称。 应用名称中不能含有“黄赌毒”等低俗敏感字样，且不能与其他开发者的在架 HarmonyOS NEXT 应用/元服务相同。如提示名称已被占用，请更换新的名称。如果发现有人侵权盗版，可通过互动中心提起申诉。 关于应用名称的更多要求，请参考应用信息审核规范。
应用包名	说明 应用包名必须与您 DevEco Studio 工程中配置的 Bundle name 一致。 HarmonyOS 应用包名需遵守如下规范：- 包名必须唯一，不能与其他应用包名相同。 - 必须为以点号（.）分隔的字符串，且至少包含三段，每段中仅允许使用英文字母、数字、下划线（\_），如“harmony\_11.huawei.com”。首段以英文字母开头，非首段以数字或英文字母开头，每一段以数字或者英文字母结尾，如“harmony99.huawei.11\_com”。 不允许多个点号（.）连续出现，如“harmony..huawei.com”。 - 长度为 7\~128 个字符，且不可包含敏感词，不能将保留字符作为独立段呈现。以保留字符 harmony 为例，包名不能为 harmony.huawei.com、com.harmony.huawei、com.huawei.harmony。保留字符包括如下： - oh - ohos - harmony - harmonyos - openharmony - system
应用分类	说明 应用分类设置后不支持修改，请谨慎选择。 选择“应用”或“游戏”。

在“开放能力接入”页面，为应用选择所属的项目，完成后点击“确认”，应用 APP ID 即成功创建。

如需将应用添加到已有项目，点击下拉框进行选择。

如需将应用添加到新项目，直接在框中填写新项目名称。

3.1.2.为 HarmonyOS 应用开启华为开放能力

如果您的 HarmonyOS 应用需要使用华为开放能力，则必须在 AppGallery Connect 打开对应能力的开关。

华为为 HarmonyOS 应用提供了众多开放能力，如果 HarmonyOS 应用需要使用华为开放能力，则必须在 AGC 开启对应的能力开关。如无需接入开放能力，直接点击最下方“确认”，返回 APP ID 页面。

当前开启开放能力有两种方式：

直接开启：若开放能力支持勾选，表示该能力可直接开启，无需申请。

申请开启：若开放能力不可勾选，表示该能力暂未完全开放，需要申请通过才可开启。

‍

开放能力开关分为应用级别和项目级别两种。应用级别的开关仅对当前应用生效，项目级别的开关对当前整个项目生效。

开放能力配置信息会写入 Profile，建议您在申请 Profile 前完成所需开放能力的配置。如果您在申请 Profile 后修改了开放能力配置，请重新下载 Profile。

应用创建完成后，若需新添加或修改开放能力，可前往“APP ID”菜单，点击应用名称，进入“应用详情”页操作。

若开放能力支持勾选，表示该能力可直接开启。在“开放能力”栏勾选您想要开启的开放能力开关，点击右上角“保存”即可。支持多选，一次操作（勾选或者取消勾选）的能力开关不得超过 10 个。

若开放能力不可勾选，表示该能力暂未完全开放，需申请通过才可开启。 下文以数字盾服务为例，介绍开放能力申请的大致流程。各开放能力申请流程和具体要求可能存在一定差异，请以实际界面为准。

点击对应能力的“申请”按钮。

在“新建业务申请”窗口填写申请原因，必要时可上传附件，然后点击“提交”。各能力对申请原因与附件的要求可能存在差异，请按实际界面要求操作。

进入互动中心页面，可看到申请已提交的消息。

返回“开放能力接入”页面，原“申请”按钮变为“申请中”。

申请审批通过后，互动中心会发送通知消息给您，同时您也会收到邮件通知。“申请中”按钮会变为置灰显示的“申请”，同时对应的能力开关会为您自动开启。

后续如需关闭开放能力，可取消勾选对应的能力开关，点击“保存”。一次操作的能力开关不得超过 10 个。修改能力开关状态后，请务必重新下载 Profile。

若开放能力包含主能力和子能力，需参考以上步骤分别申请主能力和子能力。以华为账号服务为例，“华为账号”为主能力，其下包含“获取收货地址”等多个子能力。当前 AGC 已默认为应用开启“华为账号”主能力，子能力则需分别自行申请开启。

3.1.3 为 APP ID 关联创建待发布的 HarmonyOS 应用

第三步：为 APP ID 关联创建待发布的 HarmonyOS 应用
APP ID 生成后，您还需为 APP ID 创建待发布的应用。此步骤完成后，创建的应用才会展示在“APP 与元服务”列表内。

APP ID 生成后，您还需为其关联创建待发布的应用，完成后应用才会展示在“APP 与元服务”列表内。

在“APP ID”页面，找到创建的 APP ID，点击“操作”列“发布”前往创建。

在“APP 与元服务 > HarmonyOS”页签，点击应用列表右侧“新建发布”，也可以为 APP ID 关联创建应用

在弹出的“发布 HarmonyOS Next 应用/元服务”窗口，将应用信息补充完整。点击“确认”，进入“应用信息”界面。

参数	说明
应用包名	自动填充您创建的应用包名。
应用名称	自动填充您创建的应用名称，支持修改，但需满足如下条件：- 不能与本账号下、同一语言、同一设备类型、且发布地区包含中国大陆的在架 HarmonyOS NEXT 应用的名称相同。当前，语言检测范围包含以下五种：简体中文、繁体中文（中国台湾）、繁体中文（中国香港特别行政区）、美式英语、英式英语。 - 不能与其他开发者名下、同一语言、且发布地区包含中国大陆的在架 HarmonyOS NEXT 应用/元服务的名称相同。当前，语言检测范围包含以下五种：简体中文、繁体中文（中国台湾）、繁体中文（中国香港特别行政区）、美式英语、英式英语。 如提示名称已被占用，请更换新的名称。如果发现有人侵权盗版，可通过互动中心提起申诉。
支持设备	选择应用发布后运行的设备。- 应用分发至中国大陆地区时： - 支持选择手机、平板、PC/2in1、智慧屏、手表设备。其中，“手表”指代运动手表和/或智能手表。若勾选“手表”，应用创建完成后，应用信息页面“支持设备”栏将默认勾选智能手表，您可继续添加或切换成运动手表，详见配置支持设备。 - 在应用提交上架前，您可随时在应用信息页面修改支持设备，支持由单设备改为多设备，或多设备改为单设备。但是应用一旦发布，升级版本只支持增加设备，无法删除已选择的设备。- 应用分发至中国大陆以外的国家或地区时：- 当前仅智能手表和运动手表应用支持分发至中国大陆以外的国家或地区，因此请勾选“手表”。应用创建完成后，应用信息页面“支持设备”栏将默认勾选智能手表，您可继续添加或切换成运动手表，详见配置支持设备。 - 在应用提交上架前，您可随时在应用信息页面修改支持设备，支持由单设备改为多设备，或多设备改为单设备。但是应用一旦发布，升级版本只支持增加设备，无法删除已选择的设备。

点击“确认”，进入“应用信息”界面。您可点击顶部“APP 与元服务”页签，返回应用列表。

在应用列表“HarmonyOS”页签，可查看已创建的应用。

‍

‍

‍

3.2.申请发布证书

在 AppGallery Connect 中申请、下载发布证书和 Profile 文件，每个账号最多可申请 3 个发布证书。

准备好证书请求文件。

‍

登录 AppGallery Connect，选择“证书、APP ID 和 Profile”。

‍

‍

在左侧导航栏选择“证书、APP ID 和 Profile > 证书”，进入“证书”页面，点击“新增证书”。

在弹出的“新增证书”窗口填写要申请的证书信息，点击“提交”。

参数	说明
证书名称	自定义证书名称，不超过 100 个字符。
证书类型	选择“发布证书”。
选取证书请求文件（CSR）	上传准备好的证书请求文件。

证书申请成功后，“证书”页面展示证书名称等信息。点击“下载”，将生成的证书保存至本地，供后续发布签名使用。

使用发布证书和发布 Profile 文件进行手动签名，只能用来打包应用上架，不能用来运行调试工程。

证书申请成功即为“生效”状态。目前实名认证开发者的发布证书有效期为 3 年。证书到期目前暂不影响在架应用，但更新版本时若上传过期证书签名的软件包会失败，建议您及时更换证书与 Profile。

在发布阶段，如果您更新发布证书，则需要同步更新发布 Profile，如果您配置了公钥指纹，也需要同步做更新。

若证书状态变为“失效”或“已吊销”，表示当前证书已不可用，且通过此证书申请的 Profile 也会全部失效或吊销。您需要重新申请证书与 Profile。

证书一旦废除将不可恢复，且通过此证书申请的 Profile 也会全部失效，请谨慎操作。废除证书目前暂不影响在架应用，但更新版本时您需要使用同一个 CSR 文件生成新的证书，并使用新证书更新 Profile 文件。

‍

3.3.申请 Profile 文件

在发布阶段，您需要使用发布证书和发布 Profile 重新手动签名后，才能编译构建正式发布包。一个应用最多可申请 100 个 Profile 文件。

创建 HarmonyOS 应用，已申请发布证书。（如需使用 ACL 权限）已申请并获取 ACL 权限。

‍

登录 AppGallery Connect，选择“证书、APP ID 和 Profile”。

在左侧导航栏选择“证书、APP ID 和 Profile > Profile”，进入“Profile”页面，点击右上角“添加”。

在“添加 Profile”页面，填写应用名称、Profile 名称等必填信息。

参数	说明
应用名称	选择需要申请发布 Profile 的应用/元服务名称。
包名	选择应用名称后自动填充。
Profile 名称	不超过 100 个字符。
类型	选择“发布”。
选择证书	点击“选择”，选择一个发布证书。

点击右上角“添加”，发布 Profile 申请成功，同时 Profile 关联的发布证书对应的指纹已自动添加到当前应用/元服务。如果应用/元服务集成的华为开放能力依赖公钥指纹，后续您无需再为其手动配置公钥指纹。如不涉及指纹配置，请忽略此提示。

如提示当前应用/元服务添加的证书指纹数量达到上限，则请先删除部分不需要的公钥指纹，再手动配置公钥指纹。

点击“下载”，将生成的 Profile 保存至本地，供后续发布签名使用。Profile 申请成功即为“生效”状态。若 Profile 状态变为“失效”或“已吊销”，表示当前 Profile 已不可用，您需要重新申请 Profile。

4.配置工程签名

使用制作的私钥（.p12）文件、在 AppGallery Connect 中申请的证书（.cer）文件和 Profile（.p7b）文件，在 DevEco Studio 配置工程的签名信息，构建携带发布签名信息的 APP。

在 File > Project Structure > Project > Signing Configs > default 界面中，取消勾选“Automatically generate signature”和“Associate with registered application”，然后配置工程的签名信息。

Store File：选择密钥库文件，文件后缀为.p12。
Store Password：输入密钥库密码。
Key Alias：输入密钥的别名信息。
Key Password：输入密钥的密码。
Sign Alg：签名算法，固定为 SHA256withECDSA。
Profile File：选择申请的发布 Profile 文件，文件后缀为.p7b。
Certpath File：选择申请的发布数字证书文件，文件后缀为.cer。

设置完签名信息后，单击 OK 进行保存，然后使用 DevEco Studio 生成 APP，

5.构建与上传应用包

5.1.编译构建.app 文件

应用上架时，要求应用包类型为 Release 类型。

打包 APP 时，DevEco Studio 会将工程目录下的所有 HAP/HSP 模块打包到 APP 中，因此，如果工程目录中存在不需要打包到 APP 的 HAP/HSP 模块，请手动删除后再进行编译构建生成 APP。

单击 Build > Build Hap(s)/APP(s) > Build APP(s) ，等待编译构建完成已签名的应用包。当未指定构建模式时，构建 APP 包，默认 Release 模式；构建 HAP/HSP/HAR 包，默认 Debug 模式。即 Build APP(s) 时，默认构建的 APP 包为 Release 类型，符合上架要求，开发者无需进行另外设置。

编译构建完成后，可以在工程目录 build > outputs > default 下，获取带签名的应用包。

IDE 版本 5.1.0，起初密钥库与认证文件都在自定义位置，编译 app 时始终报错，然后修改其位置为当前项目的根目录下即可，路径参考 C:\Users\EAWAC\DevEcoStudioProjects\gitcode_pocket\material\gitcode_pocket.cer

‍

5.2.上传软件包

DevEco Studio 5.0.5.200 版本开始，支持在 DevEco Studio 内上传应用软件包。上传软件包前，请先创建应用。

Tips

约束与限制

该功能仅支持中国境内（不包含中国香港、中国澳门、中国台湾）。

该功能将会把您的应用包传至 App Gallery Connect 用于测试或上架。为了您的信息安全，请勿上传带有个人敏感信息的数据（如密码、源代码、私钥、调试安装包、业务日志等信息）。

仅 Build Mode 为 Release 的应用支持上传软件包，且确保软件包已配置 Release 签名。

同时支持通过 App Gallery Connect 上传软件包。

‍

在 DevEco Studio 菜单栏，点击 Build > Upload Product，点击 Sign in 登录华为开发者账号。

登录成功后，返回 DevEco Studio 进入软件包上传界面。

确认当前工程的 product 信息，选择需要上传的软件包类型，点击 OK 开始上传。

若当前上传的软件包仅做测试发布，请选择 Generate app package and upload it to AppGallery Connect for test。
若软件包需要在全网正式发布，请选择 Generate app package and upload it to AppGallery Connect for test and publish。
如需上传符号表信息，请勾选 Upload your app's symbols 选项。

上传的 product 可以通过点击 DevEco Studio 编辑区域右上方图标进行查看及切换。

可通过 app.json5 中 bundleName/versionName 字段修改当前 product 对应的包名/版本号信息。必须使用当前开发者账号下已在 AppGallery 注册且真实存在的包名。

‍

上传完成后，出现云测试的结果，点击 View Full result in AppGallery Connect 可进入 AGC 查看软件包上传记录和检测结果，​点击 Close 关闭上传页面。

6.提交发布

发布 HarmonyOS 应用-发布应用-AppGallery Connect（HarmonyOS 5 及以上） - 华为 HarmonyOS 开发者

这是发布时需要的一些信息，注意事项就不赘述了，在准备好上述信息，修改完成后，只需要在 5.2 上传时，勾选成为发布即可。