HarmonyOS API：包管理子系统通用错误码

版本：v3.1 Beta

包管理子系统通用错误码

更新时间: 2023-02-17 09:19

17700001 指定的bundleName不存在

错误信息

The specified bundle name is not found.

错误描述

调用查询等接口时，传入的bundleName不存在。

可能原因

1. 输入的bundleName有误。
2. 系统中对应的应用没有安装。

处理步骤

1. 检查bundleName拼写是否正确。
2. 确认对应的应用是否安装。

17700002 指定的moduleName不存在

错误信息

The specified module name does not exist.

错误描述

调用查询或者免安装相关接口时，传入的moduleName不存在。

可能原因

1. 输入的moduleName有误。
2. 系统中对应的应用没有安装该模块。

处理步骤

1. 检查moduleName拼写是否正确。
2. 确认对应的应用是否安装该模块。

17700003 指定的abilityName不存在

错误信息

The specified ability name does not exist.

错误描述

调用查询等接口时，传入的abilityName不存在。

可能原因

1. 输入的abilityName有误。
2. 系统中对应的应用没有安装。

处理步骤

1. 检查abilityName拼写是否正确。
2. 确认对应的应用是否安装该组件。

17700004 指定的用户不存在

错误信息

The specified user ID is not found.

错误描述

调用与用户相关接口时，传入的用户不存在。

可能原因

输入的用户名有误，系统中没有该用户。

处理步骤

1. 检查用户名拼写是否正确。
2. 确认系统中存在该用户。

17700005 指定的appId不存在

错误信息

The specified app ID is not found.

错误描述

调用appControl模块中的相关接口时，传入的appId为空字符串。

可能原因

传入的appId为空字符串。

处理步骤

检查appId是否为空字符串。

17700006 查询的权限不存在

错误信息

The specified permission is not found.

错误描述

调用bundleManager模块中的getPermissionDef接口时，传入的权限不存在。

可能原因

1. 传入的permission名称拼写有误。
2. 系统中不存在对应的权限。

处理步骤

1. 检查permission拼写是否正确。
2. 确认系统中是否有该权限。

17700007 输入的设备Id有误

错误信息

The specified device ID is not found.

错误描述

调用distributedBundle模块相关接口时，传入的设备id有误。

可能原因

1. 传入的deviceId拼写有误。
2. deviceId不存在。

处理步骤

1. 检查deviceId拼写是否正确。
2. 确认deviceId是否存在。

17700010 文件解析失败导致应用安装失败

错误信息

Failed to install the HAP because the HAP fails to be parsed.

错误描述

调用installer模块中的install接口时，传入的HAP包解析失败。

可能原因

1. hap包的格式不是zip格式。
2. hap包的配置文件不满足json格式。
3. hap包的配置文件缺少必要的字段。

处理步骤

1. 确认hap的格式是zip。
2. 确认hap的配置文件满足​​配置文件json格式​​。
3. 检查DevEco Studio编译hap时是否有错误提示，缺省字段时会有相应的报错。

17700011 签名校验失败导致应用安装失败

错误信息

Failed to install the HAP because the HAP signature fails to be verified.

错误描述

调用installer模块中的install接口时，签名校验失败导致应用安装失败。

可能原因

1. hap包没有签名。
2. hap签名信息来源不可靠。
3. 升级的hap包与已安装的hap包签名信息不一致。
4. 多个hap的签名信息不一致。

处理步骤

1. 确认hap是否签名成功。
2. 确认多个hap签名时使用的证书相同。
3. 确认升级的hap签名证书与已安装的hap相同。

17700012 安装包路径无效或者文件过大导致应用安装失败

错误信息

Failed to install the HAP because the HAP path is invalid or the HAP is too large.

错误描述

调用installer模块中的install接口时，安装包路径无效或者文件过大导致应用安装失败。

可能原因

1. 输入错误，hap包的文件路径不存在。
2. hap包的路径无法访问。
3. hap包的大小超过最大限制4G。

处理步骤

1. 确认hap是否存在。
2. 查看hap的可执行权限，是否可读。
3. 查看hap包的大小是否超过4G。

17700015 多个hap包配置信息不同导致应用安装失败

错误信息

Failed to install the HAPs because they have different configuration information.

错误描述

调用installer模块中的install接口时，多个hap包配置信息不同导致应用安装失败。

可能原因

多个hap包中配置文件app下面的字段不一致。

处理步骤

确认多个hap包中配置文件app下面的字段是否一致。

17700016 系统磁盘空间不足导致应用安装失败

错误信息

Failed to install the HAP because of insufficient system disk space.

错误描述

调用installer模块中的install接口时，系统磁盘空间不足导致应用安装失败。

可能原因

系统空间不足。

处理步骤

确认系统是否有足够的空间。

17700017 新安装的应用版本号低于已安装的版本号导致应用安装失败

错误信息

Failed to install the HAP since the version of the HAP to install is too early.

错误描述

调用installer模块中的install接口时，新安装的应用版本号低于已安装的版本号导致应用安装失败。

可能原因

新安装的应用版本号低于已安装的版本号。

处理步骤

确认新安装的应用版本号是否比已安装的同应用版本号高。

17700020 预置应用无法卸载

错误信息

The preinstalled app cannot be uninstalled.

错误描述

调用installer模块中的uninstall接口卸载预置应用时，无法卸载。

可能原因

1. 传入的bundleName拼写有误。
2. 对应的预置应用无法卸载。

处理步骤

1. 确认bundleName是否拼写正确。
2. 确认对应的预置应用是否可卸载。

17700021 指定的uid无效

错误信息

The specified uid is invalid.

错误描述

调用bundleManager模块中的getBundleNameByUid接口时，指定的uid无效。

可能原因

1. 传入的uid拼写有误。
2. 传入的uid在系统中不存在。

处理步骤

1. 检查uid的拼写。
2. 检查系统中是否存在该uid。

17700022 输入的待解析源文件无效

错误信息

The input source file is invalid.

错误描述

调用bundleManager模块中的getBundleArchiveInfo接口时，传入的HAP路径无效。

可能原因

1. 待解析的源文件不存在。
2. 待解析的源文件不符合zip格式。

处理步骤

1. 确认待解析的源文件是否存在。
2. 确认待解析的源文件符合zip格式。

17700023 指定的默认应用不存在

错误信息

The specified default app does not exist.

错误描述

调用defaultAppManager模块中的getDefaultApplication接口时，指定的默认应用不存在。

可能原因

设备没有设置对应的默认应用。

处理步骤

确认设备是否设置了对应的默认应用。

17700024 没有相应的配置文件

错误信息

Failed to get the profile because there is no profile in the HAP.

错误描述

调用查询profile文件的相关接口时，没有相应的配置文件。

可能原因

1. 输入的metadata name在配置文件中不存在。
2. 配置文件的内容不是json格式。

处理步骤

1. 确认要查询的ability或者extensionAbility中的metadata name是否存在。
2. 确认指定查询的profile文件的内容是否为json格式。

17700025 输入的type无效

错误信息

The specified type is invalid.

错误描述

调用defaultAppManager模块的相关接口时，输入的type无效。

可能原因

1. 输入的type拼写有误。
2. 输入的type不存在。

处理步骤

确认输入的type是否拼写正确。

17700026 指定应用被禁用

错误信息

The specified bundle is disabled.

错误描述

当调用查询应用的相关信息接口时，指定应用被禁用。

可能原因

设备上对应的应用已经被禁用，无法查询。

处理步骤

确认设备上对应的应用是否被禁用。

17700027 分布式服务未启动

错误信息

The distributed service is not running.

错误描述

当调用distributedBundle模块的相关接口时，分布式服务未启动。

可能原因

设备未组网。

处理步骤

确认设备是否组网成功。

17700028 输入的ability与type不匹配

错误信息

The ability does not match the type.

错误描述

当调用defaultAppManager模块中的setDefaultApplication接口时，输入的ability与type不匹配。

可能原因

输入的ability和type拼写有误。

处理步骤

确认输入的ability和type拼写是否正确。

17700029 指定的ability被禁用

错误信息

The specified ability is disabled.

错误描述

当调用查询ability相关信息的接口时，指定的ability被禁用。

可能原因

指定的ability被禁用。

处理步骤

确认指定的ability是否被禁用，可以使用bm工具命令查询对应的应用信息。

17700030 指定的应用不支持清除缓存文件

错误信息

The specified bundle does not support clearing of cache files.

错误描述

当调用bundleManager模块中的cleanBundleCacheFiles接口时，指定的应用不支持清除缓存文件。

可能原因

指定的应用为系统应用且在签名证书中配置了不能清除数据(AllowAppDataNotCleared)的字段。

处理步骤

1.确认指定的应用是否为系统应用，可以使用bm工具命令查询对应的应用信息，查看isSystemApp是否为true。

2.确认指定的应用是否配置了能清除缓存(AllowAppDataNotCleared)的字段，可以使用bm工具命令查询对应的应用信息，查看userDataClearable是否为true。

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/errorcode-bundle-0000001478062013-V3?catalogVersion=V3​​