533c9946创建于 5 天前历史提交

包管理子系统通用错误码

说明：

以下仅介绍本模块特有错误码，通用错误码请参考通用错误码说明文档。

17700001 指定的bundleName不存在

错误信息
The specified bundle name is not found.

错误描述
指定的bundleName不存在。

可能原因

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

处理步骤

检查bundleName拼写是否正确。
可以使用查询应用信息命令（dump）查看应用是否安装。查看输出的打印信息，应用未安装时，该命令执行会报错。
```
# 需要将com.xxx.demo替换为实际查询的bundleName
hdc shell bm dump -n com.xxx.demo
```

17700002 指定的moduleName不存在

错误信息
The specified module name is not found.

错误描述
指定的moduleName不存在。

可能原因

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

处理步骤

检查moduleName拼写是否正确。
可以使用查询应用信息命令（dump）查看对应的模块是否安装。查看输出的打印信息中hapModuleNames字段对应的列表是否存在该moduleName，不存在则说明应用未安装该模块。
```
# 需要将com.xxx.demo替换为实际查询的bundleName
hdc shell bm dump -n com.xxx.demo
```

17700003 指定的abilityName不存在

错误信息
The specified ability name is not found.

错误描述
指定的abilityName不存在。

可能原因

输入的abilityName有误。
系统中对应的应用不存在该abilityName对应的ability。
调用bundleManager.getProfileByAbility、bundleManager.getProfileByExtensionAbility 等通过abilityName、moduleName组合查询的接口时，对应的应用没有安装moduleName对应的模块，对应模块下的ability也不存在。

处理步骤

检查abilityName拼写是否正确。
可以使用查询应用信息命令（dump）查看对应的应用是否存在这个abilityName。查看输出的打印信息中hapModuleInfos字段对应的abilityInfos下是否包含name等于该abilityName，不包含则说明该abilityName不存在。
可以使用查询应用信息命令（dump）查看输出的打印信息中hapModuleNames字段对应的列表是否存在对应的moduleName，不存在则说明应用未安装该模块，对应模块下的ability也不存在。
```
# 需要将com.xxx.demo替换为实际查询的bundleName
hdc shell bm dump -n com.xxx.demo
```

17700004 指定的用户不存在

错误信息
The specified user ID is not found.

错误描述
调用与用户相关接口时，传入的用户不存在。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

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

处理步骤

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

17700005 指定的appId为空字符串

错误信息
The specified app ID is an empty string.

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

可能原因
传入的appId为空字符串。

处理步骤
检查appId是否为空字符串。

17700006 查询的权限不存在

错误信息
The specified permission is not found.

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

可能原因

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

处理步骤

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

17700007 输入的设备Id有误

错误信息
The specified device ID is not found.

错误描述
调用distributedBundleManager模块相关接口时，传入的设备id有误。

可能原因

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

处理步骤

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

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

错误信息
Failed to install the HAP because the HAP fails to be parsed.

错误描述
调用installer模块中的install接口时，传入的HAP或APP解析失败。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

HAP或APP的格式不是zip格式。
HAP的配置文件不满足json格式。
HAP的配置文件缺少必要的字段。
HAP中配置了可执行二进制文件（即module.json5中配置了executableBinaryPaths标签），但是没有配置解压模式，或当前设备不支持安装配置了该标签的HAP。
传入的安装路径中或目录下存在多个APP。
APP中不包含适合在当前设备类型上安装的HAP。

处理步骤

确认HAP或APP的格式是zip。
确认HAP的配置文件满足配置文件json格式。
检查DevEco Studio编译HAP或APP时是否有错误提示，缺省字段时会有相应的报错。
配置应用为解压模式，即在应用的module.json5配置文件中设置compressNativeLibs标签为true；或更换为PC/2in1设备。
检查传入的路径下是否包含多个APP。
确认APP内是否存在支持当前设备类型的HAP。

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

错误信息
Failed to install the HAP because the HAP signature fails to be verified.

错误描述
调用installer模块中的install接口时，签名校验失败导致应用安装失败。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

HAP或APP没有签名。
HAP或APP签名信息来源不可靠。
升级的HAP与已安装的HAP签名信息不一致。
多个HAP的签名信息不一致。

处理步骤

确认HAP包或APP包是否签名成功。
确认HAP包或APP包的签名证书是从应用市场申请。
确认多个HAP包签名时使用的证书相同。
确认升级的HAP包签名证书与已安装的HAP包相同。

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

错误信息
Failed to install the HAP because the HAP path is invalid or the HAP is too large.

错误描述
调用installer模块中的install接口时，安装包路径无效或者文件过大导致应用安装失败。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

输入错误，HAP或APP的文件路径不存在。
HAP或APP的路径无法访问。
HAP的大小超过最大限制4G。

处理步骤

确认HAP或APP是否存在。
查看HAP或APP的可执行权限，是否可读。
查看HAP的大小是否超过4G。

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

错误信息
Failed to install the HAPs because they have different configuration information.

错误描述
调用installer模块中的install接口时，多个HAP配置信息不同导致应用安装失败。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因
多个HAP包中配置文件中app标签下面的字段信息或者签名信息不一致。

处理步骤
确认多个HAP中配置文件app下面的字段是否一致或者检查工程的signingConfigs配置是否一样。

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

错误信息
Failed to install the HAP because of insufficient system disk space.

错误描述
调用installer模块中的install接口时，系统磁盘空间不足导致应用安装失败。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因
系统空间不足。

处理步骤
确认系统是否有足够的空间。

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

错误信息
Failed to install the HAP since the version of the HAP to install is too early.

错误描述
调用installer模块中的install接口时，新安装的应用版本号低于已安装的版本号导致应用安装失败。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因
新安装的应用版本号低于已安装的版本号。

处理步骤
确认新安装的应用版本号是否不低于已安装的同应用版本号。

已安装应用版本号查询，依赖hdc工具。执行命令行后会输出已安装应用的版本号versionCode，如果输出多个versionCode，选择大于0的。如果该命令无打印值输出，表示应用未安装。
```
# 需要将com.xxx.demo替换为查询的bundleName
hdc shell "bm dump -n com.xxx.demo |grep versionCode"
```
新安装的应用查看版本，HAP或者HSP用DevEco Studio打开，查看里面module.json文件中的versionCode字段配置。
对于已安装的签名证书分发类型为app_gallery或者签名证书类型为debug的三方应用，当新安装的版本低于当前版本时，支持降级安装，具体参数配置可参考InstallParam中parameters描述。

17700018 安装失败，依赖的模块不存在

错误信息
Failed to install the HAP or HSP because the dependent module does not exist.

错误描述
安装HAP或HSP时，依赖的模块不存在。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因
依赖的模块没有安装。

处理步骤
先安装依赖的模块。

17700020 预置应用无法卸载

错误信息
The preinstalled app cannot be uninstalled.

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

可能原因

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

处理步骤

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

17700021 指定的uid无效

错误信息
The specified uid is invalid.

错误描述
调用bundleManager模块中的getBundleNameByUid时，指定的uid无效。

可能原因
传入的uid对应的应用不存在。

处理步骤
检查系统中是否存在对应的应用uid值。可以使用查询应用信息命令（dump）查看已安装应用的uid。执行命令行后会输出对应已安装应用的uid，如果输出多个uid，选择大于0的。如果该命令无打印值输出，表示应用未安装。

# 需要将com.xxx.demo替换为实际查询的bundleName
hdc shell "bm dump -n com.xxx.demo |grep uid"

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

错误信息
The input source file is invalid.

错误描述
调用bundleManager模块中的getBundleArchiveInfo接口时，传入的HAP或APP路径无效。

可能原因

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

处理步骤

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

17700023 指定的默认应用不存在

错误信息
The specified default app does not exist.

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

可能原因
设备没有设置对应的默认应用。

处理步骤
确认设备是否设置了对应的默认应用。

17700024 没有相应的配置文件

错误信息
Failed to get the profile because the specified profile is not found in the HAP.

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

可能原因

输入的metadata name在配置文件中不存在。
配置文件的内容不是json格式。
查询的配置文件类型不存在。

处理步骤

确认要查询的ability或者extensionAbility中的metadata name是否存在。
确认指定查询的profile文件的内容是否为json格式。
确认应用中是否存在与查询的profileType类型相符的配置文件。

17700025 输入的type无效

错误信息
The specified type is invalid.

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

可能原因

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

处理步骤

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

17700026 指定应用被禁用

错误信息
The specified bundle is disabled.

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

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

处理步骤
确认设备上对应的应用是否被禁用。

17700027 分布式服务未启动

错误信息
The distributed service is not running.

错误描述
当调用distributedBundleManager模块的相关接口时，分布式服务未启动。

可能原因
设备未组网。

处理步骤
确认设备是否组网成功。

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)的字段。

处理步骤

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

17700031 Overlay特征校验失败导致HAP安装失败

错误信息
Failed to install the HAP because the overlay check of the HAP failed.

错误描述
当安装overlay特征的应用时，指定的应用和待安装的overlay特征应用不为预置应用，或者目标应用/目标module是overlay特征的应用/module。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

使用应用间的overlay特性时，overlay特征应用必须为预置应用。
使用应用间的overlay特性时，目标应用必须为预置应用。
使用应用间的overlay特性时，目标应用不能是具有overlay特征的应用
目标module不能是具有overlay特征的module。

处理步骤

检查overlay特征应用是否为预置应用。
检查目标应用是否为预置应用。
检查目标应用是否不为overlay特征的应用
检查目标module是否不为overlay特征的module。

17700032 指定的应用不包含overlay特征的module

错误信息
The specified bundle does not contain any overlay module.

错误描述
查询指定应用中overlay特征module的overlayModuleInfo时，指定的应用不包含overlay特征module。

可能原因
指定的应用不包含overlay特征module。

处理步骤
检查指定的应用是否不包含overlay特征module。

17700033 指定的module不是overlay特征的module

错误信息
The specified module is not an overlay module.

错误描述
查询指定的overlay特征module的overlayModuleInfo时，指定的module不是overlay特征module。

可能原因
指定的module不是overlay特征的module。

处理步骤
检查指定的module是否不为overlay特征的module。

17700034 指定的module是overlay特征的module

错误信息
The specified module is an overlay module.

错误描述
查询指定的目标module所关联的overlayModuleInfo时，指定的module是overlay特征module。

可能原因
指定的module是overlay特征的module。

处理步骤
检查指定的module是否为overlay特征的module。

17700035 指定的应用只包含overlay特征的module

错误信息
The specified bundle is an overlay bundle.

错误描述
查询指定应用的目标module所关联的overlayModuleInfo时，指定的应用只包含overlay特征的module。

可能原因
指定的应用只包含overlay特征的module。

处理步骤
检查指定的应用是否只包含overlay特征的module。

17700036 共享库缺少AllowAppShareLibrary特权导致安装失败

错误信息
Failed to install the HSP due to the lack of required permission.

错误描述
共享库未申请配置AllowAppShareLibrary特权，可能存在安全隐私风险，不允许安装。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因
发布共享库前，未申请配置AllowAppShareLibrary特权。

处理步骤
为共享库申请配置AllowAppShareLibrary特权，重新签名并发布。

17700037 被卸载的shared library版本被其他应用依赖

错误信息
The version of the shared bundle is dependent on other applications.

错误描述
当卸载shared library某一版本时，指定的shared library的版本被其他应用依赖，卸载失败。

可能原因

当前卸载的版本是shared library的最高版本，且该shared library被其他应用依赖。
当前卸载时未指定shared library的版本，会卸载shared library的所有版本，该shared library被其他应用依赖。

处理步骤

检查被卸载的shared library是否被其他应用依赖。
检查被卸载的版本是否为shared library的最高版本。

17700038 被卸载的shared library不存在

错误信息
The specified shared bundle does not exist.

错误描述
当卸载shared library时，卸载的shared library不存在。

可能原因

当前指定卸载的版本不存在与被卸载的shared library中。
当前指定卸载的shared library不存在与设备中。

处理步骤

检查被卸载的shared library是否存在于当前设备中。
检查被卸载的版本是否存在于被卸载的shared library中。

17700039 不允许安装应用间共享库

错误信息
Failed to install the HSP because installing a shared bundle specified by hapFilePaths is not allowed.

错误描述
安装应用时，传入的安装包为应用间共享库类型。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

通过bm工具安装应用时，-p参数传入了应用间共享库的安装包路径。
通过install接口安装应用时，hapFilePaths参数传入了应用间共享库的安装包路径。

处理步骤

通过-p参数指定应用间共享库的安装包路径。
通过installParam参数的sharedBundleDirPaths字段指定应用间共享库的安装包路径。

17700040 不允许卸载应用间共享库

错误信息
The specified bundle is a shared bundle which cannot be uninstalled.

错误描述
卸载应用时，传入的是应用间共享库的包名。

可能原因

通过bm工具卸载应用时，-n参数传入了应用间共享库的包名。
通过uninstall接口卸载应用时，bundleName传入的是应用间共享库的包名。

处理步骤

通过-n参数指定卸载的应用为共享库应用。
通过UninstallParam参数的bundleName及versionCode指定卸载的共享库的包名及版本。

17700041 企业设备管理不允许安装该应用

错误信息
Failed to install the HAP because the installation is forbidden by enterprise device management.

错误描述
安装应用时，admin权限管理不允许安装。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因
企业设备管理不允许安装该应用。

处理步骤
请在设备中检查应用是否被企业设备管理禁止安装。

17700042 数据代理中的uri配置错误

错误信息
Failed to install the HAP because of incorrect URI in the data proxy.

错误描述
安装应用时，数据代理的uri配置错误。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

uri中的包名与当前应用的包名不一致。
uri重复。

处理步骤

修改uri中的包名为当前应用的包名。
修改重复的uri，每一个数据代理的uri都是唯一的。

17700043 数据代理中的权限配置错误

错误信息
Failed to install the HAP because of low APL in the non-system data proxy (required APL: system_basic or system_core).

错误描述
安装应用时，非系统应用的数据代理的权限等级过低，应为system_basic或system_core。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

非系统应用的数据代理未配置权限。
非系统应用的数据代理的权限等级过低。

处理步骤

在数据代理中配置读权限和写权限。
修改读权限和写权限，并确认其权限等级为system_basic或system_core。

17700044 安装包设置的多进程配置项与系统配置项设置矛盾

错误信息
Failed to install the HAP because the isolationMode configured is not supported.

错误描述
安装应用时，设置的isolationMode与系统配置项所允许的系统配置项矛盾。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

设备支持隔离模式，即persist.bms.supportIsolationMode为true时，HAP配置的isolationMode为nonisolationOnly。
设备不支持隔离模式，即persist.bms.supportIsolationMode为false时，HAP配置的isolationMode为isolationOnly。

处理步骤
按照设备的隔离模式正确配置HAP字段isolationMode。

17700045 企业设备管理不允许卸载该应用

错误信息
Failed to uninstall the HAP because the uninstall is forbidden by enterprise device management.

错误描述
卸载应用时，admin权限管理不允许卸载。

可能原因
企业设备管理不允许安装该应用。

处理步骤
请在设备中检查应用是否被企业设备管理禁止卸载安装。

17700047 要更新的应用版本没有大于当前版本

错误信息
Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode.

错误描述
安装应用时，要更新的应用版本没有大于当前版本。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

安装应用的版本号小于等于已安装应用的版本号。
installFlag被设置为NORMAL，此时待更新的应用的版本号必须大于当前已安装的版本。

处理步骤

设置应用的版本号大于当前版本，查看版本号的方法请参考错误码17700017的操作步骤。
如果希望应用更新但版本号不升级，需要设置installFlag为REPLACE_EXISTING。

17700048 代码签名校验失败

错误信息
Failed to install the HAP because the code signature verification failed.

错误描述
安装应用时，安装包的代码签名文件校验失败。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

代码签名文件对应的module在安装包中不存在。
代码签名文件路径无效。
代码签名文件和对应的安装包不匹配。

处理步骤

检查代码签名文件对应的module是否包含在安装包路径之中。
检查提供的代码签名文件的路径是否合法。
使用和安装包匹配的代码签名文件。

17700049 应用自升级时安装的应用与调用方包名不同

错误信息
Failed to install the HAP because the bundleName is different from the bundleName of the caller application.

错误描述
企业mdm应用自升级时，安装的应用与调用方包名不同。

可能原因
要安装的HAP或HSP不属于当前应用。

处理步骤
检查要安装的HAP或HSP是否属于当前应用。

17700050 企业MDM应用/普通企业应用不允许安装

错误信息
Failed to install the HAP because an enterprise normal/MDM bundle cannot be installed on non-enterprise devices.

错误描述
当前设备禁止安装企业MDM应用或普通企业应用。

可能原因
当前设备不允许安装Profile签名文件>中如下两种类型的应用：enterprise_mdm（企业MDM应用）、enterprise_normal（普通企业应用）。Profile签名文件类型的取值及含义请参考ApplicationInfo.appDistributionType。

处理步骤
更换Profile签名文件中的类型。

17700051 应用自升级时调用方的签名证书profile文件中的类型不是企业mdm

错误信息
Failed to install the HAP because the distribution type of the caller application is not enterprise_mdm.

错误描述
企业mdm应用自升级时，调用方签名证书profile文件中的类型不是企业mdm。

可能原因
调用方签名证书profile文件中的类型不是企业mdm。

处理步骤
检查应用的签名文件是否正确配置。

17700052 非开发者模式下不允许安装调试应用

错误信息
Failed to install the HAP because a debug bundle can be installed only in developer mode.

错误描述
安装调试应用时，设备处于非开发者模式，不允许安装。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因
应用为调试应用，而设备处于非开发者模式。

处理步骤
执行hdc shell param get const.security.developermode.state，若返回结果为false，说明该设备无法安装调试应用。

17700053 非应用市场调用

错误信息
The caller is not AppGallery.

错误描述
非应用市场的应用调用，仅供应用市场调用的接口。

可能原因
调用者不是应用市场。

处理步骤
请检查调用者是否是应用市场。

17700054 权限校验失败导致应用安装失败

错误信息
Failed to install the HAP because the HAP requests wrong permissions.

错误描述
待安装的应用申请了错误的权限，导致安装失败。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

非MDM应用申请了MDM类型的权限。
应用的权限级别比其申请权限的权限级别低。

处理步骤

排查是否申请了MDM类型的权限，MDM类型的权限仅针对应用类型为MDM的应用开放。
排查申请的权限是否为开放权限。详情请见权限列表。

17700055 指定的link无效

错误信息
The specified link is invalid.

错误描述
调用bundleManager模块中的canOpenLink时，指定的link无效。

可能原因
输入的link格式有误。

处理步骤
检查link格式是否正确。

17700056 指定link的scheme未在querySchemes字段下配置

错误信息
The scheme of the specified link is not in the querySchemes.

错误描述
调用bundleManager模块中的canOpenLink时，指定link的scheme未在querySchemes字段下配置。

可能原因
未在querySchemes字段下配置指定link的scheme。

处理步骤
检查是否在querySchemes字段下配置了相应的URL scheme，可以参考使用canOpenLink判断应用是否可访问。

17700057 指定的应用不是预置应用

错误信息
Failed to uninstall updates because the HAP is not pre-installed.

错误描述
调用installer模块中的uninstallUpdates时，指定的应用不是预置应用。

可能原因
指定的应用不是预置应用，无法调用uninstallUpdates接口。

处理步骤
确认指定的应用是否为预置应用。

17700058 指定的应用禁止在本设备或指定用户下安装

错误信息
Failed to install the HAP because this application is prohibited from being installed on this device or by specified users.

错误描述
指定的应用禁止在本设备或指定用户下安装。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

当前使用的设备是洗白机。
指定的应用不支持在指定的用户下安装。

处理步骤

确认使用的设备是否是洗白机。
将指定的应用安装在其他用户下。

17700059 指定的开发者ID不存在

错误信息
The specified developerId is invalid.

错误描述
调用bundleManager模块中的getAllBundleInfoByDeveloperId时，指定的developerId无效。

可能原因
设备上未安装指定开发者ID的应用。

处理步骤
检查输入的开发者ID有效性。

17700060 指定的应用不允许被卸载

错误信息
The specified application cannot be uninstalled.

错误描述
调用BundleInstaller模块中的uninstall接口或bundleManager模块中的switchUninstallState时，指定的应用不允许被卸载。

可能原因

调用uninstall接口卸载指定应用时，应用由于自身业务拒绝了此次卸载操作。
调用switchUninstallState接口时，指定的应用具有不可卸载特权。

处理步骤

查看应用提示的无法卸载的具体原因，并进行相应操作。
检查指定的应用是否具有不可卸载特权。

17700061 指定的应用分身索引无效

错误信息
The appIndex is invalid.

错误描述
调用应用分身相关的接口时，指定的应用分身索引无效。

可能原因

分身索引超出允许的范围。
应用没有该索引的分身。
创建应用分身时，该索引已存在。

处理步骤

检查索引是否在允许范围内。
检查应用是否有该索引的分身。
检查是否调用createAppClone，且该索引的应用分身是否已存在。

17700062 应用设置了卸载处置规则，不允许直接卸载

错误信息
Failed to uninstall the app because the app has uninstall rule.

错误描述
卸载应用时，应用存在卸载处置规则，不允许直接卸载。

可能原因
应用存在卸载处置规则，不允许直接卸载。

处理步骤
检查应用是否设置了卸载处置规则，由设置方对规则进行处理。

17700065 ShortcutInfo结构体中指定的want，不支持被拉起

错误信息
The ability specified by want in the ShortcutInfo struct cannot be started.

错误描述
调用launcherBundleManager模块中的startShortcut时，ShortcutInfo结构体中的want指定的ability不支持被拉起。

可能原因
ShortcutInfo结构体中的want指定的ability不存在，ShortcutInfo结构体中的want指定的ability不能被拉起等。

处理步骤
检查ShortcutInfo结构体中的want有效性。

17700066 安装失败，native软件包安装失败

错误信息
Failed to install the HAP because installing the native package failed.

错误描述
安装HAP时，native软件包安装失败。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因
native软件包配置信息有误。

处理步骤
检查native软件包的配置信息。

17700067 卸载应用失败，native软件包卸载失败

错误信息
Failed to uninstall the HAP because uninstalling the native package failed.

错误描述
卸载应用时，native软件包卸载失败。

可能原因
需要卸载的native软件包被占用。

处理步骤
检查是否存在进程占用相应native软件包。

17700069 应用不支持创建分身

错误信息
The app does not support the creation of an appClone instance.

错误描述
应用不支持创建分身。

可能原因

未配置分身模式。
企业安全策略不允许设置分身。

处理步骤

检查应用是否配置了分身模式。详见创建应用分身。
检查企业设备是否设置了不支持创建分身的企业安全策略，可以通过打开设备->设置>系统->应用分身，查看应用是否支持创建分身。

17700070 指定的快捷方式id不合法

错误信息
The specified shortcut id is illegal.

错误描述
快捷方式id是不合法的。

可能原因
已经存在相同包名、分身索引、用户id和快捷方式id的快捷方式信息；传参对应的快捷方式id不存在，或快捷方式id为空字符串。

处理步骤

检查包名或者快捷方式id是否正确。

17700071 不允许企业应用安装

错误信息
It is not allowed to install the enterprise bundle.

错误描述
BundleInstaller.installPreexistingApp，不允许通过其安装企业应用。

可能原因
因策略管制，不允许通过特定的接口，安装企业应用。

处理步骤
请更换install接口。

17700072 Launch Want不存在

错误信息
The launch want is not found.

错误描述
调用bundleManager.getLaunchWant接口时，应用的启动组件Want信息不存在。

可能原因
应用没有entities配置包含“entity.system.home”和actions配置包含“ohos.want.action.home”的UIAbility。

处理步骤
应用需要有entities配置包含“entity.system.home”并且actions配置包含“ohos.want.action.home”的UIAbility。

17700073 由于设备上存在具有相同包名称但不同签名信息的应用程序，导致安装失败

错误信息
Failed to install the HAP because an application with the same bundle name but different signature information exists on the device.

错误描述
由于设备上存在具有相同包名称但不同签名信息的应用程序，导致安装失败。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

由于设备上存在具有相同包名称但不同签名信息的已安装应用程序，导致安装失败。
设备上存在相同包名但签名信息不一致的应用被保留数据地卸载，导致安装失败。

处理步骤

卸载设备上相同包名的应用。
若设备上存在相同包名但签名信息不一致的应用被保留数据地卸载，导致安装失败，则先安装已卸载的应用之后不保留数据地卸载掉。

17700074 传入的appIdentifier无效

错误信息
The specified appIdentifier is invalid.

错误描述
调用appControl模块中的相关接口时，传入的appIdentifier为无效。

可能原因
传入的appIdentifier为空字符串。

处理步骤
检查appIdentifier是否为空字符串。

17700075 want指定的bundleName与调用方不符

错误信息
The specified bundleName of want is not the same with caller.

错误描述
设置卸载处置规则时，want指定的bundleName与调用方不相同。

可能原因
设置卸载处置规则时，want指定的bundleName与调用方不相同。

处理步骤
修改want指定的bundleName与调用方相同。

17700076 签名证书profile文件中的类型被限制，不允许安装到当前设备中，导致安装失败

错误信息
Failed to install the HAP or HSP because the app distribution type is not allowed.

错误描述
签名证书profile文件中的类型被限制，不允许安装到当前设备中。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因
该签名证书profile文件中的类型被限制，禁止安装到当前设备中。

处理步骤
更换签名证书profile文件中的类型。

17700077 安装应用失败，但安装对应的预置应用成功

错误信息
Failed to install the HAP and restore to preinstalled bundle.

错误描述
安装指定应用前，若对应的预置应用已卸载，会优先安装预置应用，预置应用安装成功后安装指定应用失败。BundleInstaller.install抛出该错误码时，错误信息后会追加内部错误码用于定位错误原因，例如[8519687]。

可能原因

待安装应用的版本号小于等于预置版本号。

处理步骤

检查并确保指定应用版本号大于对应的预置应用版本号。
重新安装指定应用。

17700080 源路径中存在无效路径

错误信息
The source paths are invalid.

错误描述
源路径无效。

可能原因

源路径数组为空。
源路径包含"../"特殊路径。
所有路径均无法转到指定路径。

处理步骤
传入真实存在的路径，不能包含"../特殊路径"。

17700081 目标路径为无效路径

错误信息
The destination path is invalid.

错误描述
目标路径无效。

可能原因

目标路径为空。
目标路径包含"../"特殊路径。
目标路径不能转换为指定路径。

处理步骤
传入真实存在的路径，不能包含"../"特殊路径。

17700082 用户身份认证失败

错误信息
User authentication failed.

错误描述
用户身份认证失败。

可能原因

当前系统不支持用户身份认证。
当前用户没有开启用户身份认证。
因用户身份认证信息错误、用户取消身份认证等，导致用户身份认证失败。

处理步骤

确认当前系统是否支持用户身份认证，若不支持，该接口不支持使用。
确认用户是否开启身份认证。
用户重新输入准确的认证信息，保证身份认证成功。

17700083 用户身份认证超时

错误信息
Waiting for user authentication timeout.

错误描述
等待用户身份认证超时。

可能原因
用户身份认证超时，用户身份认证等待时间为5分钟。

处理步骤
用户在等待时间内完成身份认证。

17700084 源路径中存在未开启权限路径

错误信息
There are inaccessible path in the source paths.

错误描述
源路径中存在未开启读权限的路径。

可能原因
源路径中的任一路径均未开启读权限。

处理步骤
传入真实存在并且开启读权限的路径。

17700085 目标路径未开启写权限

错误信息
The destination path cannot be accessed.

错误描述
无法访问目标路径。

可能原因
目标路径未开启写入权限。

处理步骤
传入真实存在并且开启写权限的路径。

17700086 发生系统错误

错误信息
System error occurred during copy execution.

错误描述
拷贝执行过程中发生系统错误。

可能原因
文件拷贝时，出现目的路径空间容量不足、源路径下的文件被移除等文件操作相关错误。

处理步骤

检查目标路径空间是否充足。
检查源路径文件是否存在。

17700087 当前设备不支持安装插件

错误信息
Failed to install the plugin because the current device does not support plugins.

错误描述
当前设备不支持插件能力。

可能原因
设备不具备插件能力，安装插件失败。

处理步骤
使用param工具设置const.bms.support_plugin的值为true，即执行hdc shell param set const.bms.support_plugin true。

17700088 应用缺少安装插件的权限

错误信息
Failed to install the plugin because the host application lacks ohos.permission.kernel.SUPPORT_PLUGIN.

错误描述
应用缺少ohos.permission.kernel.SUPPORT_PLUGIN权限，安装插件失败。

可能原因

应用没有申请ohos.permission.kernel.SUPPORT_PLUGIN权限。
应用申请了该权限，但是权限没有生效。

处理步骤

参考权限申请指导申请ohos.permission.kernel.SUPPORT_PLUGIN权限。
该权限等级为system_basic，若应用APL等级低于system_basic，请申请受限权限。

17700089 插件的 pluginDistributionIDs 解析失败

错误信息
Failed to install the plugin because the plugin id fails to be parsed.

错误描述
解析插件profile签名文件中的pluginDistributionIDs失败，插件安装失败。

可能原因
插件应用签名文件中的pluginDistributionIDs配置不符合规范。

处理步骤
参考如下格式，重新配置插件profile文件中的"app-services-capabilities"字段。

"app-services-capabilities":{
    "ohos.permission.kernel.SUPPORT_PLUGIN":{
        "pluginDistributionIDs":"value-1,value-2,···"
    }
}

17700090 插件与应用之间 pluginDistributionIDs 校验失败

错误信息
Failed to install the plugin because the plugin id fails to be verified.

错误描述
插件与应用的pluginDistributionIDs之间没有共同值，校验失败，该应用上无法安装这个插件。

可能原因
插件与应用的pluginDistributionIDs之间没有共同值。

处理步骤
重新配置应用或者插件profile文件中的pluginDistributionIDs。配置格式如下：

"app-services-capabilities":{
    "ohos.permission.kernel.SUPPORT_PLUGIN":{
        "pluginDistributionIDs":"value-1,value-2,···"
    }
}

17700091 插件与主体同包名

错误信息
Failed to install the plugin because the plugin name is the same as the host bundle name.

错误描述
插件的包名与应用的包名一致，不符合插件与应用之间异包名的规格，安装插件失败。

可能原因
插件的包名与应用的包名一致。

处理步骤
重新配置插件的包名。

17700092 插件包名不存在

错误信息
Failed to uninstall the plugin because the specified plugin is not found.

错误描述
插件包名不存在，导致插件卸载时失败。

可能原因
插件没有在应用中安装。

处理步骤
使用bm dump -n 命令查询应用信息，确认插件是否安装。

17700093 指定的skillName不存在

错误信息

The specified skillName is not found.

错误描述

未找到与指定skillName匹配的Skill信息，指定的skillName不存在。

可能原因

传入查询接口的skillName有误。
传入查询接口的Skill没有安装。

处理步骤

排查skillName，确认拼写无误。
使用bm工具安装对应Skill所在的应用。

17700101 包管理服务异常

错误信息
Bundle manager service exception.

错误描述
包管理服务异常。

可能原因
场景一：

系统出现未知的异常，导致包管理服务已停止或者异常退出。

场景二：

系统抛出未捕获的错误码，例如IPC失败、文件拷贝失败等。

处理步骤

重启手机后再次尝试请求接口。
重复上述步骤3到5次后依旧请求失败，请查询设备的/data/log/faultlog/faultlogger/目录下是否存在包含foundation字样的crash文件。
```
hdc shell
cd /data/log/faultlog/faultlogger/
ls -ls
```

导出crash文件和日志文件提在线工单获取帮助。

hdc file recv /data/log/faultlog/faultlogger/
hdc file recv /data/log/hilog/

17700201 abc文件校验失败

错误信息
Failed to verify the abc file.

错误描述
.abc文件路径校验失败。

可能原因
.abc文件不可信。

处理步骤
请传递可信.abc文件路径。

17700202 abc文件删除失败

错误信息
Failed to delete the abc file.

错误描述
.abc文件删除失败。

可能原因
.abc文件不存在。

处理步骤
请传递有效的.abc文件的路径。

17700301 扩展资源添加失败

错误信息
Failed to add extended resources.

错误描述
扩展资源添加失败。

可能原因
HSP文件不存在或不可信。

处理步骤
请传递正确且可信HSP文件路径。

17700302 扩展资源删除失败

错误信息
Failed to remove extended resources.

错误描述
扩展资源删除失败。

可能原因
moduleName对应的HSP不存在。

处理步骤
请传递有效的moduleName。

17700303 扩展资源查询失败

错误信息
Failed to obtain extended resources.

错误描述
扩展资源查询失败。

可能原因
bundleName没有HSP。

处理步骤
请传递有效的bundleName。

17700304 动态图标使能失败

错误信息
Failed to enable the dynamic icon.

错误描述
动态图标使能失败。

可能原因
HSP包没有正确的图标资源。

处理步骤
使能动态图标前确保moduleName对应的HSP有效且包含图标资源。

17700305 动态图标去使能失败

错误信息
Failed to disable the dynamic icon.

错误描述
动态图标去使能失败。

可能原因
bundleName没有动态图标。

处理步骤
去使能动态图标前确保bundleName存在动态图标。

17700306 动态图标查询失败

错误信息
Failed to obtain the dynamic icon.

错误描述
动态图标查询失败。

可能原因
bundleName没有动态图标。

处理步骤
查询动态图标前确保bundleName存在动态图标。

17700307 由于存在自定义主题，动态图标无法生效

错误信息
Dynamic icons cannot take effect due to existing custom themes.

错误描述
由于存在自定义主题，动态图标无法生效。

可能原因
用户使用了自定义主题（例如在主题应用中设置了非官方的主题），主题包内包含了相应应用的图标资源。此时接口调用方来使能对应应用的动态图标会失败，抛出17700307错误码。

处理步骤

检查当前使用的主题是否为自定义主题。
可以切换为官方主题后重新调用使能接口。

17700308 备用图标名称没有在配置文件中配置

错误信息

The alternateIconName must match the name field under alternateIcons in the app.json5 file.

错误描述

备用图标名称必须与app.json5中alternateIcons标签配置的name字段匹配。

可能原因

传入的alternateIconName在app.json5的alternateIcons标签中未配置。

处理步骤

alternateIconName传入app.json5的alternateIcons标签中配置的name。
在app.json5的alternateIcons标签中配置接口传入的alternateIconName。

17700309 当前没有设置备用图标

错误信息

No alternate icon is enabled.

错误描述

没有设置备用图标。

可能原因

当前应用未设置备用图标，在alternateIconName传入空字符串恢复默认图标时会抛出17700309。

处理步骤

当前应用未设置备用图标，不需要取消备用图标。

17700310 设置备用图标失败

错误信息

Failed to set the alternate icon.

错误描述

设置备用图标失败。

可能原因

分身应用暂不支持设置备用图标。
用户使用了自定义主题（例如在主题应用中设置了非官方的主题），主题包内包含了本应用的图标资源。此时调用接口启用备用图标会失败，并抛出17700310错误码。

处理步骤

检查当前使用的主题是否为自定义主题，可以切换为官方主题后重新调用接口。

17700311 查询备用图标失败

错误信息

Failed to obtain alternate icon.

错误描述

查询备用图标失败。

可能原因

分身应用暂不支持备用图标。当分身应用查询备用图标会失败，抛出17700311错误码。

处理步骤

检查当前应用是否是分身应用，分身应用暂不支持查询备用图标，请使用主应用查询备用图标。

17700351 无效的文件类型

错误信息
Invalid fileTypes.

错误描述
无效的文件类型。

可能原因
文件类型数组无效，例如：

数组长度超过1024。
数组包含空项。
某项长度超过512个字符。
数组包含通配符或general.object。

处理步骤
请检查文件类型数组是否错误，阅读参数规格约束，按照可能原因进行排查。

18100001 ShortcutInfo列表中bundleName和appIndex不一一对应

错误信息
A combination of bundleName and appIndex in the shutcutInfo list is different from the others.

错误描述
shortcutInfo列表中，存在bundleName和appIndex的组合与其他不一致。

可能原因
shortcutInfo列表中，存在bundleName和appIndex的组合与其他不一致。

例如在调用shortcutManager.addDynamicShortcutInfos接口时传入了如下列表:

const bundleName = "com.example.dynamic";
const bundleName1 = "com.example.dynamic1";
let moduleName = 'entry';
const arrShortcutInfo: Array<shortcutManager.ShortcutInfo> = [
  { id: "1", bundleName: bundleName, moduleName: moduleName, appIndex: 0, sourceType: 2 },
  { id: "2", bundleName: bundleName, moduleName: moduleName, appIndex: 0, sourceType: 2 },
    // 校验失败，因为bundleName和appIndex与其他shortcutInfo不一样
  { id: "3", bundleName: bundleName1, moduleName: moduleName, appIndex: 0, sourceType: 2 }
]

或者：

const bundleName = "com.example.dynamic";
let moduleName = 'entry';
const arrShortcutInfo: Array<shortcutManager.ShortcutInfo> = [
  { id: "1", bundleName: bundleName, moduleName: moduleName, appIndex: 0, sourceType: 2 },
  { id: "2", bundleName: bundleName, moduleName: moduleName, appIndex: 0, sourceType: 2 },
  // 校验失败，因为bundleName和appIndex与其他shortcutInfo不一样
  { id: "3", bundleName: bundleName, moduleName: moduleName, appIndex: 1, sourceType: 2 }
]

处理步骤
请检查shortcutInfo列表中，是否有不同的bundleName和appIndex组合。