HarmonyOS 鸿蒙Next中构建Deeplink实现下载应用

HarmonyOS 鸿蒙Next中构建Deeplink实现下载应用 描述文件存在空值字段

| 10004 | 描述文件存在空值字段 | 请检查描述文件内容，确保所有字段不为空。 |

上传的json5文件也没有空值的字段，那报错的原因是什么？


更多关于HarmonyOS 鸿蒙Next中构建Deeplink实现下载应用的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

在鸿蒙Next中构建Deeplink实现下载应用，需使用@ohos.want模块定义隐式Want，配置actions为ohos.want.action.download，并指定uri为应用包下载地址。在应用的module.json5中声明skills标签，匹配该Action与URI格式即可触发下载流程。

更多关于HarmonyOS 鸿蒙Next中构建Deeplink实现下载应用的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


根据截图及错误码10004的分析，报错“描述文件存在空值字段”通常并非指JSON5文件中的字段值为空，而是指描述文件（App Linking的配置文件或关联的applinking.json）中存在未填写或缺失的必填字段。

常见原因：

  1. App Linking配置文件中缺少必填字段：例如 appIdentifier、bundleName、fingerprint、host、path 等字段未正确填写。请检查您上传的JSON5文件是否包含所有必需的配置项。
  2. 字段值为null或空字符串：即使字段存在，如果其值为 null 或空字符串 ""，系统也会视为“空值”。请检查所有字段的值是否确实非空。
  3. 字段格式错误：某些字段（如 fingerprint）有特定格式要求（如SHA256指纹），格式错误时可能被解析为空或无效。

排查步骤：

  • 重新导出您的App Linking配置文件，确保在AGC后台生成的描述文件内容完整。
  • 打开JSON5文件，逐字段检查是否有任何字段值为 null、"" 或 undefined。
  • 特别注意 appIdentifier、host、path 等核心字段是否已正确填写且不为空。
  • 确认版本号等数字字段是否以合法形式存在（如 "version": "1.0.0" 而非 "version": ""）。

若以上检查均正常，建议将JSON5文件内容与官方示例配置文件逐行对比。

回到顶部