HarmonyOS鸿蒙Next内部测试包，上传到蒲公英后，下载提示“10019”

HarmonyOS鸿蒙Next内部测试包，上传到蒲公英后，下载提示“10019” 【问题描述】：内部测试包，上传到蒲公英后，下载提示“10019”

【问题现象】：提示错误“应用验证失败，此应用存在风险。请联系开发者获取更多帮助（错误码：10019）。”

【版本信息】：开发工具：DevEco Studio 6.0.1 Release、手机系统版本：5.0.5(17)、Api语言版本:api 21

【复现代码】：无

【尝试解决方案】：

  1. 使用签名工具本地验证，结果是验证通过，重新打包依旧报错

  2. 参考https://developer.huawei.com/consumer/cn/blog/topic/03183385038742070，配置Build Mode，重新打包依旧报错

  3. 参考https://developer.huawei.com/consumer/cn/forum/topic/0203173094987030391?fid=0109140870620153026，重新配置相关证书，重新打包依旧报错

  4. 参考蒲公英《鸿蒙 HarmonyOS App 如何内测分发》https://www.pgyer.com/doc/view/harmonyos，重新打包依旧报错


更多关于HarmonyOS鸿蒙Next内部测试包，上传到蒲公英后，下载提示“10019”的实战教程也可以访问 https://www.itying.com/category-93-b0.html

4 回复

10009 错误码：modules字段值不符合规则（应用分包module信息列表，以数组形态组织，其中至少包括一个entry module信息。）

请检查modules字段值，确保符合如下规则：

  • modules不为空，或数组长度不为0。 正确示例
    "modules": [
  {
    "name": "module",
    "type": "entry",
    "deviceTypes": [
      "tablet",
      "2in1",
      "phone"
   ],
    "packageUrl": "https://host:port/uri",
    "packageHash": "hash..."
  }
],
  • 按设备类型过滤后，modules不为空，至少有一个可安装的module。例如，实际安装设备为手机，则必须至少有一个module的deviceType值包含phone。
  • 按设备类型过滤后，modules下必须至少包含一个HAP包。例如，实际安装设备为手机，则deviceType值包含phone的modules中必须至少有一个是HAP包，不能全部是应用内HSP包。

请检查json5里的配置是否正确！

详见开发文档：https://developer.huawei.com/consumer/cn/doc/app/agc-help-internal-test-release-app-0000002260691994

错误码文档：https://developer.huawei.com/consumer/cn/doc/app/agc-help-internal-test-errorcode-0000002295325157

更多关于HarmonyOS鸿蒙Next内部测试包，上传到蒲公英后，下载提示“10019”的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


安装10019报错排查:

  • 根据描述文件内容，参考下载错误码，是：描述文件sign验签失败，同时给出的建议如下：

    • 请检查描述文件的签名密钥与安装包的签名密钥，确保二者保持一致。
    • 请内部验签工具进行本地验证。

    打包使用发布证书

实在找不到原因，可以试试使用 hpack 打包。

鸿蒙Next内部测试包上传到蒲公英后提示“10019”错误，通常是由于应用签名问题导致。在鸿蒙Next中，应用签名机制与之前版本有所不同，需要确保使用正确的签名文件进行签名。请检查应用的签名配置是否正确，并确认签名文件是否有效。

根据您描述的问题，错误码“10019”通常与HarmonyOS Next应用的完整性校验和签名验证机制有关。结合您已尝试的解决方案，问题很可能出在应用包签名与分发平台环境不匹配上。

核心原因分析：

  1. HarmonyOS Next的强化安全机制：HarmonyOS Next对应用包的签名、完整性校验和分发渠道有更严格的要求。上传到第三方平台（如蒲公英）的安装包，其签名信息或包结构可能无法通过系统端侧的严格验证。
  2. 签名环境与安装环境不匹配：您在本地签名验证通过，仅说明签名本身有效。但当安装包被上传至蒲公英服务器后，其下载链路、存储方式或平台可能对安装包进行了微处理（如重新压缩、添加渠道信息），这可能会破坏HarmonyOS Next系统要求的原始签名完整性，触发“应用验证失败”。

关键排查点与解决方向：

  • 确认打包模式：请确保在DevEco Studio的build-profile.json5文件中，buildMode已明确设置为release。虽然您已参考文档配置，但需再次确认配置已生效且未在构建时被覆盖。
  • 直接安装验证：将生成的.hap安装包通过USB直接传输到HarmonyOS Next设备上，使用hdc命令（例如hdc install xxx.hap）或系统自带的“文件管理”应用进行本地安装。如果直接安装成功，则问题基本可以锁定在蒲公英的分发环节。
  • 联系蒲公英技术支持：由于问题出现在上传蒲公英后，您需要向蒲公英平台反馈此问题，并提供详细的错误码（10019）及HarmonyOS Next版本信息。询问其服务器在处理.hap文件时，是否会对文件进行任何可能影响签名完整性的操作（如解压/重压缩、添加水印等）。HarmonyOS Next对安装包的字节级完整性非常敏感。
  • 检查证书有效期与配置：再次核对用于签名的调试证书或发布证书是否在有效期内，并且在项目的signingConfigs中配置正确，特别是signAlg、profile等字段是否与证书匹配。

总结： 当前最可能的症结是第三方分发平台的处理流程与HarmonyOS Next的安装验证机制存在兼容性问题。建议优先进行本地直接安装测试以定位问题边界，并同步与蒲公英平台沟通其分发机制。

回到顶部