HarmonyOS鸿蒙Next中关于真机测试我踩过的坑，保证100%可以进行真机测试

HarmonyOS鸿蒙Next中关于真机测试我踩过的坑，保证100%可以进行真机测试 在手机系统和其他的在模拟机上测试都没问题的情况下，但是在真机下总是无法测试的问题，一直提示一下问题

09:52:32.183: $ hdc shell bm install -p data/local/tmp/e3af52b5f8384ec6abf3112b8bbbebd4 in 175 ms

Install Failed: error: failed to install bundle.

code:9568320

error: no signature file.

Open signing configs

09:52:32.280: $ hdc shell rm -rf data/local/tmp/e3af52b5f8384ec6abf3112b8bbbebd4

09:52:32.281: Launch com.example.mytoolapp failed, starting handle failure progress

Error while Deploy Hap


更多关于HarmonyOS鸿蒙Next中关于真机测试我踩过的坑，保证100%可以进行真机测试的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

鸿蒙Next真机测试需确保设备已升级至对应版本，并开启开发者模式。在DevEco Studio中正确配置签名文件，使用自动签名或手动生成。检查设备USB调试权限，连接后需在设备端授权信任。若遇无法识别，尝试更换数据线或USB端口。确保项目配置中的bundleName与签名信息一致。

更多关于HarmonyOS鸿蒙Next中关于真机测试我踩过的坑，保证100%可以进行真机测试的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


这个错误的核心是 签名问题。错误信息 error: no signature file 和 code:9568320 明确指出，您尝试安装的 HAP 包没有有效的签名，而 HarmonyOS Next 的真机调试强制要求使用经过授权的签名文件。

根本原因与解决方案：

  1. 未使用调试证书签名：这是最常见的原因。HarmonyOS Next 真机调试必须使用在 AGC（AppGallery Connect） 中为该项目生成的调试证书（Debug Certificate）对 HAP 进行签名。模拟器（Simulator）通常使用临时或通用证书，与真机不兼容。

    • 解决：确保您项目的签名配置（signingConfigs）已正确设置，并指向从 AGC 下载的调试证书（.p12 文件）和对应的 debugProfile（.p7b 文件）。在 build-profile.json5 中检查 "signingConfigs" 和 "buildModeSet" 下的 "signingConfig" 配置。

  2. 证书未绑定设备：调试证书需要将目标真机的 UDID 添加到 AGC 项目的设备列表中。

    • 解决：
      • 在 AGC 中进入您的 HarmonyOS 项目。
      • 在“用户与访问” > “设备管理”中添加该设备的 UDID。
      • 重新下载调试证书和 Profile 文件（因为设备列表更新后，证书会失效）。
      • 在 DevEco Studio 中更新签名配置路径。

  3. 签名配置未生效或选错：在 DevEco Studio 中，您可能配置了多个签名方案（如 debug、release），但当前构建模式未选择正确的调试签名配置。

    • 解决：在 DevEco Studio 顶部工具栏的“运行/调试配置”下拉菜单中，确认当前选中的是 带调试签名的方案（例如 entry@debug@Phone）。检查 build-profile.json5，确保 "buildModeSet" 下的 "debug" 模式关联了正确的 "signingConfig"。

  4. 证书已过期：调试证书有效期为一年。如果证书过期，需要重新生成并下载。

    • 解决：登录 AGC，在“证书管理”中查看调试证书状态。若过期，请生成新证书并更新项目配置。

标准操作流程（确保100%成功）：

  1. 准备设备：在真机上开启“开发者模式”和“USB调试”。通过 hdc shell bm get -u 获取 UDID。
  2. AGC 配置：将 UDID 添加到项目设备列表。下载最新的调试证书（.p12）和调试 Profile（.p7b）。
  3. 项目配置：在 DevEco Studio 的 build-profile.json5 中，正确配置 signingConfigs 路径（指向刚下载的文件）。确保 "debug" 构建模式引用了该配置。
  4. 清理与构建：执行 Build > Clean Project 和 Build > Rebuild Project。
  5. 运行：使用数据线连接手机，在工具栏选择正确的调试构建方案（如 entry@debug@Phone），点击运行按钮。

完成以上步骤后，您的应用将使用与设备绑定的有效调试证书签名，即可成功安装到真机进行测试。

回到顶部