鸿蒙应用打包上架流程

鸿蒙（HarmonyOS）作为华为自主研发的操作系统，近年来引起了开发者和用户的广泛关注。如何开发一款鸿蒙应用并成功上架到华为应用市场，成为许多开发者迫切想要了解的话题。本文将以简洁易懂的方式，带你完成从应用打包到成功上架的全流程。

第一步：准备工作

在开始打包之前，需要完成以下准备：

开发环境配置
- 确保安装了 DevEco Studio，这是开发鸿蒙应用的官方 IDE。
- 配置 JDK（推荐 1.8 版本）、Node.js 和 npm 环境。
- 下载鸿蒙 SDK 并在 DevEco Studio 中正确添加。
开发者账号注册
- 登录华为开发者官网，注册开发者账号。
- 完成企业或个人开发者认证。
应用信息准备
- 确保已经在“应用管理”中创建了你的应用，并填写了基本信息（名称、简介、图标等）。
- 准备好应用的隐私政策文件，这是上架必需项。

第二步：应用打包

应用打包是将你的代码转换为可以运行的安装包（.hap 或 .app）。以下是关键步骤：
在这里插入图片描述

1. 配置打包参数

在 DevEco Studio 中：

打开 build.gradle 文件，设置应用的 applicationId 和版本信息：
```
applicationId "com.example.myapp"
versionCode 1
versionName "1.0.0"
```

确保使用了正确的签名配置：

在 build-profile.json5 文件中，填写签名证书的路径和密码。

示例配置如下：

"signingConfigs": [{"name": "default","type": "HarmonyOS","material": {"certpath": "path/to/cert.cer","storePassword": "your_store_password","keyAlias": "debugKey","keyPassword": "your_key_password","profile": "path/to/profile.p7b","signAlg": "SHA256withECDSA","storeFile": "path/to/keystore.p12"}},{"name": "release","type": "HarmonyOS","material": {"certpath": "path/to/release_cert.cer","storePassword": "release_store_password","keyAlias": "releaseKey","keyPassword": "release_key_password","profile": "path/to/release_profile.p7b","signAlg": "SHA256withECDSA","storeFile": "path/to/release_keystore.p12"}}
],
"products": [{"name": "default","signingConfig": "release","compatibleSdkVersion": "5.0.0(12)","runtimeOS": "HarmonyOS","buildOption": {"strictMode": {"caseSensitiveCheck": true,"useNormalizedOHMUrl": true}}}
]

2. 生成密钥和证书请求文件

在 DevEco Studio 中，依次执行以下步骤：

菜单选择 Build > Generate Key and CSR。
在弹出的对话框中：
- Key Store File：选择已有密钥库文件（.p12 文件），或者点击 New 新建。
- 如果新建：
  - 填写密钥库文件的路径和名称。
  - 设置密钥库密码（至少包含大写字母、小写字母、数字和特殊符号中的两种，长度不小于 8 位）。
- 点击 OK，生成密钥库文件。
填写密钥信息：
- Alias：密钥别名，用于标识密钥。
- Password：密钥密码，与密钥库密码一致。
- Validity：证书有效期（建议设置为 25 年或以上）。
- 证书基本信息如组织、城市、国家码等。
指定 CSR 文件存储路径并命名，点击 Finish。

完成后，会生成 .p12 文件（密钥库文件）和 .csr 文件（证书请求文件）。
在这里插入图片描述

3. 申请发布证书

登录 AppGallery Connect。
在左侧导航栏选择“用户与访问 > 证书管理”。
点击“新增证书”，上传刚生成的 .csr 文件并填写相关信息。
提交后，下载生成的 .cer 文件（发布证书）。

4. 配置签名信息

打开 DevEco Studio，选择 File > Project Structure > Signing Configs。
填写以下信息：
- Store File：选择生成的 .p12 文件。
- Store Password：填写密钥库密码。
- Key alias：填写密钥别名。
- Key password：填写密钥密码。
- Sign alg：设置为 SHA256withECDSA。
- Profile file：选择下载的 .p7b 文件（Profile 文件）。
- Certpath file：选择下载的 .cer 文件（发布证书）。
点击 OK 保存。

5. 生成安装包

在 DevEco Studio 中，点击 Build > Build Hap(s)/APP(s)，选择适合的构建选项。打包完成后，你将在 output 文件夹中找到生成的 .hap 文件。

第三步：测试与优化

在提交应用前，确保应用质量达到要求：

功能测试
- 在鸿蒙设备或模拟器上运行你的 .hap 文件，验证应用的各项功能是否正常。
- 使用 DevEco Studio 内置的调试工具检查性能瓶颈。
兼容性测试
- 使用华为提供的云测服务进行兼容性测试，确保应用在不同设备上的表现一致。
安全检查
- 确保没有隐私权限滥用或敏感信息泄露。
- 使用 hap-signature-checker 工具检查签名完整性。