HarmonyOS 鸿蒙Next中运行报错 ErrorCode: 00401004

HarmonyOS 鸿蒙Next中运行报错 ErrorCode: 00401004 下载了一个demo，一运行就报错：

ErrorCode: 00401004
ErrorDescription: Please try to match the API version of the device and the app. The current device does not contain the following SysCap attributes in the rpcid.json file: SystemCapability.ArkUi.Graphics3D. Make sure the device supports all the SysCap attributes required for running the app.

cke_228.png


更多关于HarmonyOS 鸿蒙Next中运行报错 ErrorCode: 00401004的实战教程也可以访问 https://www.itying.com/category-93-b0.html

3 回复

开发者您好，可尝试在hap模块的src/main目录下新建syscap.json文件，移除错误提示中不支持的SysCap特性，以上述报错为例：

// entry/src/main/syscap.json

{
  "devices": {
    "general": ["default"]  // 同module.json5中的deviceTypes
  },
  "production": {
    "removedSysCaps": [
      "SystemCapability.ArkUi.Graphics3Dh",
    ]
  }
}

更多关于HarmonyOS 鸿蒙Next中运行报错 ErrorCode: 00401004的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


该错误码00401004通常与权限配置相关。请检查应用配置文件中的权限声明是否完整，确保已声明运行所需权限。同时确认权限是否属于受限权限类别，若是则需补充动态授权逻辑。权限名称需与系统权限列表严格匹配。

这个错误是由于设备与应用的API版本不匹配导致的。具体来说，设备缺少应用所需的系统能力 SystemCapability.ArkUi.Graphics3D，该能力在设备的 rpcid.json 文件中未包含。

解决方法：

  1. 检查设备支持的API版本：确认设备系统版本是否支持应用所需的API级别。
  2. 调整应用的API版本：在应用的 module.json5 文件中，将 targetAPIVersion 修改为设备支持的版本，例如从高版本调整为低版本（如从10降至9）。
  3. 验证SysCap配置：确保应用声明的系统能力（如 SystemCapability.ArkUi.Graphics3D）在目标设备上可用。可通过设备的 rpcid.json 文件或官方文档确认支持的能力列表。

修改后重新编译运行即可解决。

回到顶部