Melotopia For HarmonyOS 的 HAP 签名安装包在 DevEco Studio 中安装的详细步骤

以下是 Melotopia For HarmonyOS 的 HAP 签名安装包在 DevEco Studio 中安装的详细步骤，结合搜索结果整理如下：

一、环境准备

1. 设备要求
   • 确保目标设备为 HarmonyOS 系统（手机/平板），并开启 开发者模式 和 USB 调试：

   ◦ 进入 设置 > 关于手机 > 版本号，连续点击 7 次激活开发者模式。

   ◦ 返回设置，进入 系统和更新 > 开发人员选项，开启 USB 调试。

   • 使用 USB 数据线连接设备与电脑，并授权电脑调试权限。

2. 工具安装
   • 安装 DevEco Studio（需配置 HarmonyOS SDK，路径需包含 toolchains 目录）。

   • 下载 HDC 命令行工具（位于 SDK 的 toolchains 目录），并将其路径加入系统环境变量。

二、签名配置

1. 生成签名文件
   • 密钥文件（.p12）：在 DevEco Studio 中通过 Build > Generate Key and CSR 生成，设置密码和别名（Alias）。

   • 证书请求文件（.csr）：与 .p12 文件同时生成，用于向华为申请证书。

   • 数字证书（.cer）：登录 https://developer.huawei.com/consumer/cn/service/josp/agc/index.html，在 证书管理 中提交 .csr 文件生成。

   • Profile 文件（.p7b）：在开发者平台 HAP Provision Profile 管理 中绑定证书和设备，生成调试 Profile。

2. DevEco Studio 签名配置
   • 打开项目，进入 Project Structure > Signing Configs：

   ◦ 选择 .p12 文件路径，填写密码、别名及 .cer 文件路径。

   ◦ 在 build-profile.json5 中配置签名信息（如 signingConfig）。

三、打包 HAP 文件

1. 自动签名打包
   • 勾选 Automatically generate signature（适用于调试场景），点击 Build > Build Hap(s)/App(s) > Build Hap(s)，生成的 HAP 包位于 entry/build/default/outputs/default/ 目录。

2. 手动签名打包
   • 若需自定义证书，需在 app.json5 中配置签名路径及密码，重新执行打包命令。

四、安装 HAP 包

1. 通过 HDC 命令安装
   • 打开 CMD/PowerShell，输入以下命令：
   hdc app install <HAP包路径>

   示例：
   hdc app install E:\project\entry-default-signed.hap

   • 若安装失败，检查设备是否授权、HDC 端口是否冲突，或重启 HDC 服务。

2. 通过 DevEco Studio 直接运行
   • 在 IDE 中选择已连接的真机设备，点击运行按钮（或按 Shift+F10），DevEco Studio 会自动执行打包和安装流程。

五、常见问题解决

1. 安装失败提示 INSTALL_FAILED_APP_SOURCE_NOT_TRUSTED
   • 原因：签名证书未在华为开发者平台绑定设备。

   • 解决：在 AppGallery Connect 的 设备管理 中添加设备 UDID，并重新生成 Profile 文件。

2. HDC 命令无法识别
   • 检查环境变量是否配置正确，或手动进入 SDK 的 toolchains 目录执行命令。

3. HAP 包无法直接安装
   • HarmonyOS 不支持直接点击安装 HAP 包，必须通过 HDC 或 DevEco Studio 工具链完成。

六、扩展建议

• 多设备调试：若需安装到多台设备，需在华为开发者平台为每个设备生成独立的 Profile 文件。

• 发布流程：测试完成后，需通过 AppGallery Connect 提交正式签名包，审核通过后用户可从应用市场下载。

通过以上步骤，可完成 Melotopia For HarmonyOS 的 HAP 包签名、打包及真机安装。如需进一步优化，可参考华为官方网页或 DevEco Studio 的调试日志分析问题。