bm工具
====

Bundle Manager（包管理工具，简称bm）是实现应用安装、卸载、更新、查询等功能的工具，bm为开发者提供基本的应用安装包的调试能力。

#### 环境要求（hdc工具）

在使用本工具前，开发者需要先获取[hdc工具](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hdc#环境准备)，执行hdc shell。

#### bm工具命令列表

| 命令 | 描述 |
| :-- | :-- |
| help | 帮助命令，用于查询bm支持的命令信息。 |
| install | 安装命令，用于安装应用。 |
| uninstall | 卸载命令，用于卸载应用。 |
| dump | 查询命令，用于查询应用的相关信息。 |
| clean | 清理命令，用于清理应用的缓存和数据。在user版本下打开开发者模式可用。 |
| get | 获取udid命令，用于获取设备的udid。 |
| quickfix | 快速修复相关命令，用于执行补丁相关操作，如补丁安装、补丁查询。 |
| compile | 应用执行编译AOT命令。 |
| copy-ap | 把应用的ap文件拷贝到/data/local/pgo目录下，供shell用户读取文件。 |
| dump-dependencies | 查询应用依赖的模块信息。 |
| dump-shared | 查询应用间HSP应用信息。 |
| dump-overlay | 打印overlay应用的overlayModuleInfo。 |
| dump-target-overlay | 打印目标应用的所有关联overlay应用的overlayModuleInfo。 |
| install-plugin | 安装插件命令，用于安装插件。 |
| uninstall-plugin | 卸载插件命令，用于卸载插件。 |

#### 帮助命令（help）

\# 显示帮助信息
bm help

#### 参数说明

#### \[h2\]userId

表示当前系统账号的编号，系统账号的相关接口请参考[@ohos.account.osAccount (系统账号管理)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-osaccount)，下面给出几种常见的系统账号。

*   userId = 100，表示编号为100的系统账号，系统默认账号，在设备出厂首次启动时由系统账号管理模块创建，且创建完成后会在100账号下安装所有的预置应用。
    
*   userId = 102，表示编号为102的系统账号，由系统账号管理模块创建，仅支持系统应用创建账号。在100账号下安装的应用，在102账号下不会显示，如有需求，需要在102账号下重新安装。在创建102账号过程中，系统会在102账号下安装预置系统应用。
    
*   userId = 0，表示共有系统账号，也叫账号0，该共有系统账号和系统账号编号不同，不是系统账号管理模块创建的。在账号0下安装的应用，所有系统账号共享，会在每个系统账号下都会显示。所有三方应用都不能安装到账号0下。
    

#### 安装命令（install）

bm install \[-h\] \[-p filePath\] \[-r\] \[-w waitingTime\] \[-s hspDirPath\] \[-u userId\] \[-d\] \[-g\]

**安装命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-p | 可选参数，指定待安装的HAP/HSP路径，多HAP/HSP应用可指定多HAP/HSP所在文件夹路径。从API version 22开始，支持指定待安装的APP路径，也可指定只存在一个APP的文件夹路径。 |
| \-r | 可选参数，覆盖安装一个HAP/HSP。默认缺省，缺省时表示覆盖安装。 |
| \-s | 
安装应用间HSP时为必选参数，其他场景为可选参数。用于指定待安装应用间HSP的路径。从API version 24开始，当指定目录时，路径目录下可以存在多个同包名、不同模块名的HSP。API version 23及之前版本，路径目录下只能存在一个HSP。

**说明：**

应用间HSP不对三方应用开放，三方无法安装应用间HSP。

 |
| \-w | 可选参数，安装HAP时指定bm工具等待时间，最小的等待时长为180s，最大的等待时长为600s, 默认缺省为180s。 |
| \-u | 

可选参数，指定[用户](#userid)，默认在当前活跃用户下安装应用。仅支持在当前活跃用户或0用户下安装。

**说明：**

如果当前活跃用户是100，使用命令bm install -p /data/local/tmp/ohos.app.hap -u 102安装时，只会在当前活跃用户100下安装应用。

 |
| \-d | 可选参数，允许应用降级安装，即设备已安装较高版本的应用，也可以覆盖安装较低版本的应用。仅支持签名证书分发类型为app\_gallery或者签名证书类型为debug的三方应用降级安装。从API version 23开始支持。 |
| \-g | 

可选参数，安装签名证书类型为debug的应用时自动授予[user\_grant](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-permission-mgmt-overview#user_grant用户授权)和[manual\_settings](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-permission-mgmt-overview#manual_settings手动设置授权)权限。

仅对[开发者模式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-developer-mode#section530763213432)下的签名证书类型为debug的应用生效。可以通过[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)中的type字段查看签名证书类型。

签名证书类型为debug的应用更新为签名证书类型为release的应用时取消已授予的[user\_grant](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-permission-mgmt-overview#user_grant用户授权)和[manual\_settings](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-permission-mgmt-overview#manual_settings手动设置授权)权限。从API version 24开始支持。

 |

示例：

\# 安装一个hap
bm install -p /data/local/tmp/ohos.app.hap
# 在100用户下安装一个hap
bm install -p /data/local/tmp/ohos.app.hap -u 100
# 覆盖安装一个hap
bm install -p /data/local/tmp/ohos.app.hap -r
# 安装一个应用间共享库
bm install -s xxx.hsp
# 同时安装使用方应用和其依赖的应用间共享库
bm install -p aaa.hap -s xxx.hsp yyy.hsp
# 同时安装HAP和应用内共享库
bm install -p /data/local/tmp/hapPath/
# 安装一个hap,等待时间为180s
bm install -p /data/local/tmp/ohos.app.hap -w 180
# 设备已安装了一个高版本的应用，覆盖安装一个同包名低版本的hap
bm install -p /data/local/tmp/ohos.app.hap -d
# 安装签名证书类型为debug的应用时自动授予user\_grant权限和manual\_settings权限
bm install -p /data/local/tmp/ohos.app.hap -g

#### 卸载命令（uninstall）

bm uninstall \[-h\] \[-n bundleName\] \[-m moduleName\] \[-k\] \[-s\] \[-v versionCode\] \[-u userId\]

**卸载命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-n | 必选参数，指定Bundle名称卸载应用。 |
| \-m | 可选参数，应用模块名称，指定卸载应用的一个模块。默认卸载所有模块。 |
| \-k | 可选参数，卸载应用时保存应用数据。默认卸载应用时不保存应用数据。 |
| \-s | 根据场景判断，卸载应用间HSP时必选参数，其他场景为可选参数。卸载指定的共享库。 |
| \-v | 可选参数，指定共享包的版本号。默认卸载同包名的所有共享包。 |
| \-u | 
可选参数，指定[用户](#userid)，默认在当前活跃用户下卸载应用。仅支持在当前活跃用户或0用户下卸载应用。

**说明：**

如果当前活跃用户是100，使用命令bm uninstall -n com.ohos.app -u 102卸载时，只会在当前活跃用户100下卸载应用。

 |

示例：

\# 卸载一个应用
bm uninstall -n com.ohos.app
# 在用户100下卸载一个应用
bm uninstall -n com.ohos.app -u 100
# 卸载应用的一个模块
bm uninstall -n com.ohos.app -m entry
# 卸载一个shared bundle
bm uninstall -n com.ohos.example -s
# 卸载一个shared bundle的指定版本
bm uninstall -n com.ohos.example -s -v 100001
# 卸载一个应用，并保留用户数据
bm uninstall -n com.ohos.app -k

#### 查询应用信息命令（dump）

bm dump \[-h\] \[-a\] \[-g\] \[-n bundleName\] \[-s shortcutInfo\] \[-d deviceId\] \[-l label\] \[-u userId\]

**查询命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-a | 可选参数，查询系统已经安装的所有应用。 |
| \-g | 可选参数，查询系统中签名为调试类型的应用包名。 |
| \-n | 可选参数，查询指定Bundle名称的详细信息。 |
| \-s | 可选参数，查询指定Bundle名称下的快捷方式信息。 |
| \-d | 可选参数，查询指定设备中的包信息。默认查询当前设备。 |
| \-l | 
可选参数，用于查询指定Bundle名称的label值（应用的名称），需要与-n或-a参数组合使用。

**说明**：

从API version 20开始支持该命令。如果在Windows环境下输出结果包含特殊字符或中文乱码，需在cmd控制台中手动执行命令chcp 65001，将cmd控制台编码修改为UTF-8。

 |
| \-u | 

可选参数，查询指定[用户](#userid)下的应用信息，默认在当前活跃用户下查询应用信息。仅支持在当前活跃用户或0用户下查询。

**说明：**

如果当前活跃用户是100，使用命令bm dump -n com.ohos.app -u 102查询时，只会在当前活跃用户100下查询应用。

 |

示例：

\# 显示所有已安装的Bundle名称
bm dump -a
# 查询系统中签名为调试类型的应用包名
bm dump -g
# 查询该应用的详细信息
bm dump -n com.ohos.app
# 在用户100下查询该应用的详细信息
bm dump -n com.ohos.app -u 100
# 查询该应用的快捷方式信息
bm dump -s -n com.ohos.app
# 查询跨设备应用信息
bm dump -n com.ohos.app -d xxxxx
# 查询该应用的label值（应用的名称）
bm dump -n com.ohos.app -l
# 显示所有已安装应用的bundle名称和label值（应用的名称）
bm dump -a -l

#### 清理命令（clean）

bm clean \[-h\] \[-c\] \[-n bundleName\] \[-d\] \[-i appIndex\] \[-u userId\]

**清理命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-c -n | \-n为必选参数，-c为可选参数。清除指定Bundle名称的缓存数据。 |
| \-d -n | \-n为必选参数，-d为可选参数。清除指定Bundle名称的数据目录。 |
| \-i | 可选参数，清除分身应用的数据目录。默认为0。 |
| \-u | 
可选参数，清理指定[用户](#userid)下的数据，默认在当前活跃用户下清理数据。仅支持在当前活跃用户或0用户下清理数据。

**说明：**

如果当前活跃用户是100，使用命令bm clean -c -n com.ohos.app -u 102清理数据时，只会在当前活跃用户100下清理。

 |

示例：

\# 清理该应用下的缓存数据
bm clean -c -n com.ohos.app
# 在用户100下清理该应用下的缓存数据
bm clean -c -n com.ohos.app -u 100
# 清理该应用下的用户数据
bm clean -d -n com.ohos.app
# 执行结果
clean bundle data files successfully.

#### 获取udid命令（get）

bm get \[-h\] \[-u\]

**获取udid命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-u | 必选参数，获取设备的udid。 |

示例：

\# 获取设备的udid
bm get -u
# 执行结果
udid of current device is :
23CADE0C

#### 快速修复命令（quickfix）

bm quickfix \[-h\] \[-a -f filePath \[-t targetPath\] \[-d\] \[-o\]\] \[-q -b bundleName\] \[-r -b bundleName\]

注：hqf文件制作方式可参考[HQF打包指令](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/packing-tool#hqf打包指令)。

**快速修复命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-a -f | \-a为可选参数，指定-a后，-f为必选参数。执行快速修复补丁安装命令，file-path对应hqf文件，支持传递1个或多个hqf文件，或传递hqf文件所在的目录。 |
| \-q -b | \-q为可选参数，指定-q后，-b为必选参数。根据包名查询补丁信息。 |
| \-r -b | \-r为可选参数，指定-r后，-b为必选参数。根据包名卸载未使能的补丁。 |
| \-t | 可选参数，快速修复应用到指定目标路径。 |
| \-d | 可选参数，应用快速修复调试模式。 |
| \-o | 可选参数，应用快速修复覆盖模式，该模式下so将被解压覆盖到应用的so目录中。 |

示例：

\# 根据包名查询补丁包信息
bm quickfix -q -b com.ohos.app
# 执行结果
# Information as follows:
# ApplicationQuickFixInfo:
#  bundle name: com.ohos.app
#  bundle version code: xxx
#  bundle version name: xxx
#  patch version code: x
#  patch version name:
#  cpu abi:
#  native library path:
#  type:

# 快速修复补丁安装
bm quickfix -a -f /data/app/
# 执行结果
apply quickfix succeed.
# 快速修复补丁卸载
bm quickfix -r -b com.ohos.app
# 执行结果
delete quick fix successfully

#### 共享库查询命令（dump-shared）

bm dump-shared \[-h\] \[-a\] \[-n bundleName\]

**共享库查询命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-a | 可选参数，查询系统中所有已安装的共享库。 |
| \-n | 可选参数，查询指定包名的共享库详细信息。 |

示例：

\# 显示所有已安装共享库包名
bm dump-shared -a
# 显示该共享库的详细信息
bm dump-shared -n com.ohos.lib

#### 共享库依赖关系查询命令（dump-dependencies）

bm dump-dependencies \[-h\] \[-n bundleName\] \[-m moduleName\]

**共享库依赖关系查询命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-n | 必选参数，查询指定应用依赖的共享库信息。 |
| \-m | 必选参数，查询指定应用指定模块依赖的共享库信息。 |

示例：

\# 查询指定应用指定模块依赖的共享库信息
bm dump-dependencies -n com.ohos.app -m entry

#### 应用执行编译AOT命令（compile）

bm compile \[-h\] \[-m mode\] \[-r bundleName\] \[-a\]

**compile命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-a | 可选参数，编译所有应用。 |
| \-m | 可选参数，可选值为partial或者full。根据包名编译应用。 |
| \-r | 可选参数，移除应用的结果。 |

示例：

\# 根据包名编译应用
bm compile -m partial com.example.myapplication

#### 拷贝ap文件命令（copy-ap）

拷贝ap文件到指定应用的/data/local/pgo路径。

bm copy-ap \[-h\] \[-a\] \[-n bundleName\]

**copy-ap命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-a | 可选参数，默认所有包相关ap文件。拷贝所有包相关ap文件。 |
| \-n | 可选参数，默认当前应用包名。根据包名拷贝对应包相关的ap文件。 |

示例：

\# 根据包名移动对应包相关的ap文件
bm copy-ap -n com.example.myapplication

#### 查询overlay应用信息命令（dump-overlay）

bm dump-overlay \[-h\] \[-b bundleName\] \[-m moduleName\] \[-t targetModuleName\] \[-u userId\]

**dump-overlay命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-b | 必选参数，获取指定Overlay应用的所有OverlayModuleInfo信息。 |
| \-m | 可选参数，根据指定Overlay特征module的名称查询OverlayModuleInfo信息，默认当前Overlay应用主模块名。 |
| \-t | 可选参数，根据指定目标module的名称查询OverlayModuleInfo信息，默认参数为空。 |
| \-u | 
可选参数，在指定[用户](#userid)下查询OverlayModuleInfo信息，默认在当前活跃用户下查询。仅支持在当前活跃用户或0用户下查询。

**说明：**

如果当前活跃用户是100，使用命令bm dump-overlay -b com.ohos.app -u 102查询OverlayModuleInfo信息，只会返回当前活跃用户100下的OverlayModuleInfo信息。

 |

示例：

\# 根据包名来获取overlay应用com.ohos.app中的所有OverlayModuleInfo信息
bm dump-overlay -b com.ohos.app

# 在用户100下，根据包名来获取overlay应用com.ohos.app中的所有OverlayModuleInfo信息
bm dump-overlay -b com.ohos.app -u 100

# 根据包名和module来获取overlay应用com.ohos.app中overlay module为libraryModuleName的所有OverlayModuleInfo信息
bm dump-overlay -b com.ohos.app -m libraryModuleName

# 根据目标包名和module来获取overlay应用com.ohos.app中目标module为entryModuleName的所有OverlayModuleInfo信息
bm dump-overlay -b com.ohos.app -t entryModuleName

#### 查询应用的overlay相关信息命令（dump-target-overlay）

查询目标应用的所有关联overlay应用的overlayModuleInfo信息。

bm dump-target-overlay \[-h\] \[-b bundleName\] \[-m moduleName\] \[-u userId\]

**dump-target-overlay命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-b | 必选参数，获取指定应用的所有OverlayBundleInfo信息。 |
| \-m | 可选参数，默认当前应用主模块名。根据指定的包名和module名查询OverlayModuleInfo信息。 |
| \-u | 
可选参数，在指定[用户](#userid)下查询OverlayModuleInfo信息，默认在当前活跃用户下查询。仅支持在当前活跃用户或0用户下查询。

**说明：**

如果当前活跃用户是100，使用命令bm dump-target-overlay -b com.ohos.app -u 102查询目标应用com.ohos.app中的所有关联的OverlayBundleInfo信息，只会返回当前活跃用户100下的OverlayModuleInfo信息。

 |

示例：

\# 根据包名来获取目标应用com.ohos.app中的所有关联的OverlayBundleInfo信息
bm dump-target-overlay -b com.ohos.app

# 在用户100下，根据包名来获取目标应用com.ohos.app中的所有关联的OverlayBundleInfo信息
bm dump-target-overlay -b com.ohos.app -u 100

# 根据包名和module来获取目标应用com.ohos.app中目标module为entry的所有关联的OverlayModuleInfo信息
bm dump-target-overlay -b com.ohos.app -m entry

#### 安装插件命令（install-plugin）

bm install-plugin \[-h\] \[-n hostBundleName\] \[-p filePath\]

**install-plugin命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-n | 必选参数，指定待安装插件的应用包名。 |
| \-p | 必选参数，指定插件文件路径。 |

示例：

\# 安装一个插件
bm install-plugin -n com.ohos.app -p /data/plugin.hsp

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e5/v3/dqhp7vS_QkaJw5_6TP40rg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=A3FEC0B70580AEC4525FCFB6525FD897F771AA6A4745489A7B1029B1656FDD68)

在同一个应用中安装同一个插件，则视作插件版本更新，插件不支持降级安装；插件版本更新后，需要重启应用插件才能生效。

不推荐安装与宿主应用模块同名的插件，目前运行态暂不支持。

#### 卸载插件命令（uninstall-plugin）

bm uninstall-plugin \[-h\] \[-n hostBundleName\] \[-p pluginBundleName\]

**uninstall-plugin命令参数列表**

| 参数 | 参数说明 |
| :-- | :-- |
| \-h | 帮助信息。 |
| \-n | 必选参数，指定应用包名。 |
| \-p | 必选参数，指定插件的包名。 |

示例：

\# 卸载一个插件
bm uninstall-plugin -n com.ohos.app -p com.ohos.plugin

#### bm工具错误码

#### \[h2\]301 系统账号不存在

**错误信息**

error: user not exist.

**错误描述**

系统账号不存在。

**可能原因**

安装应用时，系统账号ID不存在。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    hdc file recv /data/log/hilog/
    

#### \[h2\]304 当前系统账号没有安装HAP包

**错误信息**

error: user does not install the hap.

**错误描述**

卸载操作时，当前系统账号没有安装HAP包。

**可能原因**

当前系统账号下未安装任何HAP包。

**处理步骤**

当前系统账号下未安装任何HAP包，请不要执行卸载应用操作。

#### \[h2\]9568319 签名文件异常

**错误信息**

error: cannot open signature file.

**错误描述**

安装应用过程中，出现签名文件打开异常，导致安装失败。

**可能原因**

HAP包签名文件存在异常。

**处理步骤**

方法一. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。

方法二. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

#### \[h2\]9568320 签名文件不存在

**错误信息**

error: no signature file.

**错误描述**

用户安装未签名的HAP/HSP包。

**可能原因**

HAP/HSP包没有签名。

**处理步骤**

请开发者根据实际场景选择自动签名或者手动签名，例如无法连接互联网的情况下推荐使用手动签名方式，详情参考[使用场景说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section54361623194519)。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7d/v3/Ygzt1zU2S4-im8vZ3MrXDg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=599E808EFAD829672061B4E426DDD4F1D01E75E96B3C0A6A0825B400BFCA668F)

在工程级build-profile.json5文件下的products标签中，signingConfig字段为非必填字段，若该字段缺失，将导致签名失效。详情请参考[products](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-build-profile-app#section45865492619)标签下的字段说明。

方法一. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。

方法二. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

方法三. 如果安装APP时报这个错误码，需要在[工程级build-profile.json5文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-build-profile-app)里配置[packOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-build-profile-app#section03812484215)的appWithSignedPkg属性为true，保证APP里的HAP/HSP有签名。

#### \[h2\]9568321 签名文件解析失败

**错误信息**

error: fail to parse signature file.

**错误描述**

用户安装时签名文件解析失败。

**可能原因**

HAP包签名文件存在异常。

**处理步骤**

方法一. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。

方法二. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

#### \[h2\]9568323 签名摘要验证未通过

**错误信息**

error: signature verification failed due to not bad digest.

**错误描述**

用户安装时签名验证失败。

**可能原因**

HAP包签名不正确。

**处理步骤**

方法一. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。

方法二. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

#### \[h2\]9568324 签名完整性校验未通过

**错误信息**

error: signature verification failed due to out of integrity.

**错误描述**

用户安装时签名验证失败。

**可能原因**

HAP包签名不正确。

**处理步骤**

方法一. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。

方法二. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

#### \[h2\]9568326 签名公钥存在异常

**错误信息**

error: signature verification failed due to bad public key.

**错误描述**

用户安装时签名验证失败，签名公钥存在异常。

**可能原因**

HAP包签名不正确。

**处理步骤**

方法一. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。

方法二. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

#### \[h2\]9568327 签名获取异常

**错误信息**

error: signature verification failed due to bad bundle signature.

**错误描述**

用户安装时签名验证失败，签名获取异常。

**可能原因**

HAP包签名不正确。

**处理步骤**

方法一. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。

方法二. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

#### \[h2\]9568328 未找到配置文件区块

**错误信息**

error: signature verification failed due to no profile block.

**错误描述**

用户安装时签名验证失败，未找到配置文件区块。

**可能原因**

HAP包签名不正确。

**处理步骤**

方法一. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。

方法二. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

#### \[h2\]9568330 初始化签名源失败

**错误信息**

error: signature verification failed due to init source failed.

**错误描述**

用户安装时签名验证失败，初始化签名源失败。

**可能原因**

HAP包签名不正确。

**处理步骤**

方法一. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。

方法二. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

#### \[h2\]9568257 签名文件Pkcs7校验失败

**错误信息**

error: fail to verify pkcs7 file.

**错误描述**

用户安装应用时签名Pkcs7校验失败。

**可能原因**

1.  证书链不完整或不受信任。
2.  签名算法不匹配。
3.  数据被篡改或签名文件损坏。
4.  签名格式不匹配。
5.  私钥不匹配。

**处理步骤**

方法一. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。

方法二. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

#### \[h2\]9568344 解析配置文件失败

**错误信息**

error: install parse profile prop check error.

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c2/v3/C0L0qm9SSL6byZJ8Q8jUbw/zh-cn_image_0000002625108273.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=017DB59111B3A941C98974B879681C3045FC8A1BC4D0CFC94CF1358EA6B585E6)

**错误描述**

在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: install parse profile prop check error”错误信息。

**可能原因**

1.  [app.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file#配置文件标签)中的bundleName、[module.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#配置文件标签)中name不符合命名规则。

**处理步骤**

1.  根据命名规则调整app.json5配置文件中bundleName、module.json5文件中的name字段。

#### \[h2\]9568305 依赖的模块不存在

**错误信息**

error: Failed to install the HAP or HSP because the dependent module does not exist.

**错误描述**

在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: Failed to install the HAP or HSP because the dependent module does not exist.”错误信息。

**可能原因**

运行/调试的应用依赖的动态共享包（HSP）模块未安装导致安装报错。

**处理步骤**

场景一：依赖的HSP与HAP在同一工程内：

*   方法一：先通过[bm install -p](#安装命令install)命令安装依赖的动态共享包（HSP）模块，再在应用运行配置页勾选Keep Application Data，点击OK保存配置，再运行/调试。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/51/v3/SJlcghE3Q3u02VU4pHArfQ/zh-cn_image_0000002594668756.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=D4BCE1B23ABE858B076E56BE71DB1C42CD5C2BBF61945EB947A1D90DA2FC14F8)
    
*   方法二：在运行配置页，选择Deploy Multi Hap标签页，勾选Deploy Multi Hap Packages，选择依赖的模块，点击OK保存配置，再进行运行/调试。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c/v3/g6_CNdWgQfeeTSNYd-AxMA/zh-cn_image_0000002594828684.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=A10EEE95B593592A7B6C506136B0B02A51359E0A6E81A31E832764FC880C89DD)
    
*   方法三：单击Run > Edit Configurations，在General中，勾选Auto Dependencies。点击OK保存配置，再运行/调试。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d/v3/94NwaVueQ3KDv9LmDyqwgQ/zh-cn_image_0000002625188131.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=194D96C0C181D34D654AB9F8236ECCEECCB1D6AA510CC3BFCB8539FD2B67125E)
    

场景二：依赖的HSP与HAP不在同一工程内：

在安装HAP前，使用[bm install](#安装命令install)命令安装依赖的HSP。

场景三：依赖集成态HSP：

如果依赖集成态HSP，通过hdc工具安装应用时，需要同时或提前安装集成态HSP编译后的包。是否依赖集成态HSP，可以通过如下方法查询：

DevEco Studio自动安装运行应用时，查看Run中的日志，如果存在remote\_hsp目录，说明依赖集成态HSP，remote\_hsp目录下的HSP文件就是集成态HSP编译后的包。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/26/v3/D_LAj4MUSGahvRzBmuwxeA/zh-cn_image_0000002625108275.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=42E4BFA9AAA6E930193F70CD908FC41EB4EB8872E781AC2A3DE93C550912CE8D)

#### \[h2\]9568259 安装解析配置文件缺少字段

**错误信息**

error: install parse profile missing prop.

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/dd/v3/9uKEaGItTG-WumCHGBVvFg/zh-cn_image_0000002594668758.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=962B34E8623688FA5247CAA2CD7E37DAE35013E84CF3814090C673BDEF4B6537)

**错误描述**

在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: install parse profile missing prop”错误信息。

**可能原因**

配置文件app.json5和module.json5中必填字段缺失。

**处理步骤**

*   方法1：请参考[app.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file)和[module.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)查看并补充必填字段。
    
*   方法2：通过hilog日志判断缺失字段。
    
    开启落盘命令：
    
    hilog -w start
    
    落盘位置：/data/log/hilog。
    
    打开日志查看“profile prop %{public}s is missing”。如“profile prop icon is missing”表示“icon”字段缺失。
    

#### \[h2\]9568258 安装应用的releaseType与已安装应用的releaseType不相同

**错误信息**

error: install releaseType target not same.

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3b/v3/fwDCDWkoThGfW8kxVu18zg/zh-cn_image_0000002594828686.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=8FAF3047A7CBCDB481F8E9742E26A27AB5B857DB6F3D6F6527D6DC7050982AB6)

**错误描述**

在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: install releaseType target not same”错误信息。

**可能原因**

*   场景一：设备上已安装的旧HAP和现在要安装的新HAP所使用的SDK中的releaseType值不一样。
*   场景二：安装的应用为多HAP时，每个HAP所使用的SDK中的releaseType值不一致。

**处理步骤**

*   场景一：请先卸载设备上已安装的HAP（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），再安装新的HAP。
*   场景二：使用相同版本的SDK对HAP重新打包，保证多HAP的releaseType值一致。

#### \[h2\]9568260 安装内部错误

**错误信息**

error: install internal error.

**错误描述**

安装内部错误。

**可能原因**

安装过程中，内部服务异常。

**处理步骤**

请尝试重启设备后重新安装。

#### \[h2\]9568261 安装器对象构造失败

**错误信息**

error: install host installer failed.

**错误描述**

获取安装器对象失败。

**可能原因**

安装过程中，内部服务异常。

**处理步骤**

请尝试重启设备后重新安装。

#### \[h2\]9568262 安装解析应用失败

**错误信息**

error: install parse failed.

**错误描述**

安装解析应用失败。

**可能原因**

1.  使用了[bm install](#安装命令install)命令安装插件。
2.  使用了[bm install](#安装命令install)命令安装[bundleType](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file#配置文件标签)为skill类型的包。
3.  待安装应用的module.json中配置了skillProfiles，但配置的skill名称、skill目录名与SKILL.md中frontmatter的name不一致。

**处理步骤**

1.  安装插件请使用[bm install-plugin](#安装插件命令install-plugin)命令。
2.  skill类型的包不支持命令行安装，请修改应用[bundleType](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file#配置文件标签)的类型。
3.  检查module.json中skillProfiles下skill的name、skills目录下的子目录名称、SKILL.md中frontmatter的name，确保三者一致。

#### \[h2\]9568265 安装过程中内部参数有误

**错误信息**

error: install param error.

**错误描述**

内部参数不正确。

**可能原因**

安装过程中后台服务出现异常，导致参数发生变化，不符合预期。

**处理步骤**

请尝试重启设备后重新安装。

#### \[h2\]9568270 安装包名称不正确

**错误信息**

error: install invalid hap name.

**错误描述**

安装包名称后缀不正确。

**可能原因**

安装包名称后缀不正确，非.hap、.hsp、.hqf结尾。

**处理步骤**

检查安装包的名称后缀是否正确。

#### \[h2\]9568276 安装应用已存在

**错误信息**

error: install already exist.

**错误描述**

应用已存在，bundleName重复导致安装失败。

**可能原因**

bundleName重复导致安装失败。

**处理步骤**

请更换应用的bundleName。

#### \[h2\]9568267 entry模块已存在

**错误信息**

error: install entry already exist.

**错误描述**

待安装应用的entry模块已存在。

**可能原因**

多模块应用安装要求entry模块唯一。由于待安装的模块包和已安装的模块包名称不同，但均为entry类型，违反了entry唯一性，导致安装失败。

**处理步骤**

1.  请先卸载设备上已安装的HAP（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），再安装新的HAP。
2.  检查并确保待安装包的entry模块名称与已安装的entry模块名相同，或把待安装模块的类型改为feature后重试。

#### \[h2\]9568268 安装状态错误

**错误信息**

error: install state error.

**错误描述**

应用安装状态更新失败。

**可能原因**

由于上一个应用安装包过大耗时长，应用安装时上一个应用安装任务未结束，导致安装状态更新失败。

**处理步骤**

请等待上一个应用安装完成后再重试。

#### \[h2\]9568269 文件路径无效

**错误信息**

error: install file path invalid.

**错误描述**

安装时传入的安装包路径无效。

**可能原因**

1.  安装包路径不存在，如拼写有误等。
2.  安装包路径长度超过256字节。

**处理步骤**

1.  检查安装包的路径是否存在且有访问权限。
2.  检查安装包路径长度不超过256字节。

#### \[h2\]9568322 由于应用来源不可信，签名验证失败

**错误信息**

error: signature verification failed due to not trusted app source.

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c6/v3/fcZjnjo0Tp-19VpdjeQ6Lw/zh-cn_image_0000002625188133.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=327DCDE08E2D396A3BD7228D8CD6E347A42CB1B486D5062FF0D5ABEEBA606A51)

**错误描述**

在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: signature verification failed due to not trusted app source”错误信息。

**可能原因**

*   场景一：签名时使用了[发布profile文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-profile-0000002248341090)。发布证书签名的应用不能启动调试或运行。
    
*   场景二：在[build-profile.json5](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-build-profile-app#section153288223224)文件中，配置的profile文件与.cer文件不匹配。
    
*   场景三：签名中未包含该调试设备的UDID。
    

**处理步骤**

*   场景一：使用[调试profile文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-debug-profile-0000002248181278)重新签名应用。
    
*   场景二：请确保profile文件是由配置中的.cer文件生成的，可以登录[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/)，选择“证书、APP ID和Profile”，在左侧导航栏选择“证书、APP ID和Profile > Profile”，进入“Profile”页面，选择配置的profile文件，右侧操作点击“查看”，确认“查看Profile”页面中“归属证书”是否与配置的.cer文件一致。
    
*   场景三：使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。
    

#### \[h2\]9568286 安装应用的签名证书profile文件中的类型与已安装应用的不相同

**错误信息**

error: install provision type not same.

**错误描述**

在启动调试或运行应用/服务时，由于安装应用的[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)中的类型与已安装应用的不相同，导致安装HAP出现错误。

**可能原因**

设备上已安装应用的签名证书profile文件中的类型与待安装应用不一致。

**处理步骤**

1.  确保设备上已安装应用签名证书profile文件中的类型与待安装应用的类型一致，使用相同类型的profile文件签名，再安装新的HAP。
2.  卸载设备上已安装的应用（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），再安装新的HAP。

#### \[h2\]9568288 磁盘空间不足导致安装失败

**错误信息**

error: install failed due to insufficient disk memory.

**错误描述**

应用安装时会新建文件或目录，由于设备存储空间不足，创建文件或目录失败，导致应用安装失败。

**可能原因**

设备存储空间不足，创建文件或目录失败，导致应用安装失败。

**处理步骤**

查看应用安装的设备存储空间并清理，保证满足安装所需空间，再重试安装应用。模拟器上存储空间清理之后仍然失败，请尝试创建新的模拟器设备，并设置更大的存储空间，详情请参考[创建新的模拟器](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-create#section1764055173710)。

#### \[h2\]9568289 权限请求失败导致安装失败

**错误信息**

error: install failed due to grant request permissions failed.

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a5/v3/4atcFAB6RVW0GXqXNCf9Zw/zh-cn_image_0000002625108277.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=C71F191BF888AD6BBB40E0DB1D20EEE8551B275340C6A199D17E128FF8292043)

**错误描述**

在启动调试或运行应用/服务时，安装HAP出现错误，提示授予请求权限失败。从API version 18开始，会在请求失败信息后打印具体的权限名称。

**可能原因**

应用APL等级为normal，只能使用APL等级为normal的权限，如果使用了system\_basic或system\_core等级的权限，将导致报错，具体请参考[权限机制中的基本概念](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-permission-mgmt-overview#权限机制中的基本概念)。

**处理步骤**

根据报错描述中的权限名称在[应用权限列表](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-permissions)中排查权限是否存在。

*   如果不存在，需要查看需要该权限的API接口的文档说明，以确保权限支持申请。例如：[setDevicePairingConfirmation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bluetooth-connection#connectionsetdevicepairingconfirmation)接口所需权限中，ohos.permission.MANAGE\_BLUETOOTH仅系统应用支持申请，此时请更换为ohos.permission.ACCESS\_BLUETOOTH权限。
    
*   如果存在，请查看对应的权限文档的要求，申请权限，同时请关注权限是否支持申请。例如：[受限开放权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/restricted-permissions)请参考文档[申请受限权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/declare-permissions-in-acl)。[企业类应用可用权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/permissions-for-enterprise-apps)仅企业类应用支持申请，三方应用不支持。
    

#### \[h2\]9568290 更新HAP token失败导致安装失败

**错误信息**

error: install failed due to update hap token failed.

**错误描述**

应用安装过程中，更新HAP时，应用token授权失败。

**可能原因**

应用安装或更新时，调用元能力的更新token接口，接口返回失败。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568291 singleton不一致导致安装失败

**错误信息**

error: install failed due to singleton not same.

**错误描述**

应用更新时，应用已安装的HAP包和更新包app.json5配置文件中singleton配置（从API version 9开始废弃）不一致。

**可能原因**

应用已安装的HAP包和更新包app.json5配置文件中singleton配置（从API version 9开始废弃）不一致。

**处理步骤**

方案1：卸载已安装的应用包（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），再安装新的应用包。

方案2：更新包调整singleton配置，与已安装包配置一致，重新打包，再更新应用包。

#### \[h2\]9568293 SysCap不一致导致安装失败

**错误信息**

error: install failed due to check syscap filed.

**错误描述**

SysCap不一致导致安装失败。

**可能原因**

多个HAP/HSP中配置的[SysCap](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/syscap#syscap的用途)不一致。

**处理步骤**

检查多HAP/HSP中配置的SysCap，请保持一致。

#### \[h2\]9568297 由于设备sdk版本较低导致安装失败

**错误信息**

error: install failed due to older sdk version in the device.

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9c/v3/-w3uw1hCReuU2oyLsmCtzg/zh-cn_image_0000002594668760.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=7354F30E46B1D4242806B64EAC621BD43C7BB94C87AE393F3BB8C251889B6C99)

**错误描述**

在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: install failed due to older sdk version in the device”错误信息。

**可能原因**

该问题是由于编译打包所使用的SDK版本与设备镜像版本不匹配。

**处理步骤**

*   场景一：设备上的镜像版本低于编译打包的SDK版本，请更新设备镜像版本。查询设备镜像版本命令：
    
    hdc shell param get const.ohos.apiversion
    
    如果镜像提供的api版本为10，且应用编译所使用的SDK版本也为10，仍出现该报错，可能是由于镜像版本较低，未兼容新版本SDK校验规则，请将镜像版本更新为最新版本。
    
*   场景二：对于需要运行在HarmonyOS设备上的应用，请确认runtimeOS已改为HarmonyOS。
    

#### \[h2\]9568299 安装信息异常

**错误信息**

error: install failed due to ark native file is incompatible.

**错误描述**

安装信息异常。

**可能原因**

安装信息为空或者出现异常导致安装失败。

**处理步骤**

设备重启之后再重新安装。

#### \[h2\]9568300 应用模块名不唯一导致安装失败

**错误信息**

error: moduleName is not unique.

**错误描述**

多模块应用安装过程中，由于模块命名冲突，模块唯一性校验失败，导致安装失败。

**可能原因**

多模块应用安装过程中，存在模块名称冲突。

**处理步骤**

查看当前应用所有模块名，与各个模块的module.json5中的name进行比较，保证不一致后，重新打包，进行应用安装。

#### \[h2\]9568332 签名不一致导致安装失败

**错误信息**

error: install sign info inconsistent.

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/62/v3/pm6dU3iCT0mnpcAEb-tX5Q/zh-cn_image_0000002594828688.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=02D070881D59D876F35C2E440EEBE8E89ABA99B43D0A009BDE68B40F17E55FDC)

**错误描述**

在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: install sign info inconsistent”错误信息。

**可能原因**

1.  设备上已安装的应用与新安装的应用中签名不一致或者多个包（HAP和HSP）之间的签名存在差异。若两个应用的签名[密钥](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section462703710326)或[APP ID](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506#section16423184171915)中至少有一项相同，则认为它们的签名一致。如果在DevEco Studio的“Edit Configurations”中勾选了“Keep Application Data”（即不卸载应用，直接覆盖安装），并且重新进行了签名，将导致该报错。
2.  如果某个应用被卸载但是保留了数据，那么后面安装相同包名的应用时，需要校验其签名信息的一致性。如果两者签名信息中的[密钥](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section462703710326)和[APP ID](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506#section16423184171915)都不一致，则会导致该报错。

**处理步骤**

1.  请卸载设备上已安装的应用（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），或取消勾选“Keep Application Data”后，重新安装新的应用。
2.  如果是因不同团队提供的HSP导致签名不一致问题，可以采用[集成态HSP](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/integrated-hsp)的方式统一提供HSP；在多HAP包的情况下，必须确保所有HAP包的签名一致。
3.  如果某个应用被卸载但是保留了数据，后面安装相同包名但签名信息不一致的应用时，安装失败。如果出现这种情况，则需要把之前已卸载掉的应用重新安装之后，执行不保留数据地卸载，这样相同包名但签名信息不一致的应用才能安装成功。

#### \[h2\]9568329 签名信息验证失败

**错误信息**

error: verify signature failed.

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b9/v3/NhvmEEubShS-Vr3AVWshEQ/zh-cn_image_0000002625188135.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=01229F8DC828753D7ED42B20EAE757BEDED82A79849D54F125936180EF9B64D8)

**错误描述**

签名信息中的包名与应用的包名（bundleName）不一致。

**可能原因**

*   场景一：用户导入了三方提供的HSP模块，且该HSP既非[集成态HSP](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/integrated-hsp)，又非同包名的HSP，造成包名不一致。
    
*   场景二：用户使用了错误的签名文件（后缀为.p7b）进行签名，造成包名不一致。
    

**处理步骤**

*   场景一：HSP只能给同包名的应用使用，只有集成态HSP可以给不同包名的应用使用。需要用户与三方开发者确认，三方开发者应提供集成态HSP、或同包名的HSP给用户使用。
    
*   场景二：检查签名流程和签名证书，参考[配置调试签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing)。
    

#### \[h2\]9568266 安装权限拒绝

**错误信息**

error: install permission denied.

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b4/v3/L6ekUwQMQJ26NRZeJveRFg/zh-cn_image_0000002625108279.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=ABCFD589D370803BD45F62985FA217B9929D241AA41C6796D9EA617889A5E7AE)

**错误描述**

使用hdc install安装HAP时出现错误，提示“code:9568266 error: install permission denied”错误信息。

**可能原因**

hdc install不能安装release签名的企业应用。

**处理步骤**

1.  请使用hdc install指令安装调试debug签名的企业应用。

#### \[h2\]9568337 安装解析失败

**错误信息**

error: install parse unexpected.

**错误描述**

应用推送到设备安装时，报错包管理打开HAP文件失败。

**可能原因**

*   场景一：设备存储空间已满，导致hdc file send文件后，因存储空间不足导致设备中文件损坏。
    
*   场景二：推送HAP包到设备过程HAP包损坏。
    

**处理步骤**

*   场景一：查看设备存储空间，若已满，清理存储满足安装所需空间。
    
*   场景二：查看本地HAP与推送到设备上HAP的md5值，若不一致则表示推送过程HAP损毁，请尝试重传。
    

#### \[h2\]9568316 数据代理中APL权限字段描述权限低

**错误信息**

error: apl of required permission in proxy data is too low.

**错误描述**

proxyData标签requiredReadPermission和requiredWritePermission属性验证失败。

**可能原因**

用户工程module.json中，proxyData标签requiredReadPermission和requiredWritePermission属性验证失败，这两个属性要求system\_basic或system\_core权限等级。

**处理步骤**

1.  检查应用定义的proxyData内容是否符合要求，参考[proxyData标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#proxydata标签)。

#### \[h2\]9568315 数据代理URI错误

**错误信息**

error: uri in proxy data is wrong.

**错误描述**

proxyData标签uri属性验证失败。

**可能原因**

用户工程module.json中，proxyData标签uri属性验证失败，不满足uri格式要求。

**处理步骤**

1.  检查应用定义的proxyData内容是否符合要求，参考[proxyData标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#proxydata标签)。

#### \[h2\]9568318 签名文件无效

**错误信息**

error: signature file path is invalid.

**错误描述**

签名文件无效。

**可能原因**

签名文件异常或者安装包损坏。

**处理步骤**

使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)或者[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)重新签名后安装调试。

#### \[h2\]9568325 由于文件过大，签名验证失败

**错误信息**

error: signature verification failed due to oversize file.

**错误描述**

由于文件过大，签名验证失败。

**可能原因**

签名文件大小超过限制。

**处理步骤**

使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)或者重新申请签名证书，在[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)重新签名后安装调试。

#### \[h2\]9568336 应用调试类型与已安装应用不一致

**错误信息**

error: install debug type not same.

**错误描述**

应用调试类型（app.json的debug字段）与已安装应用不一致。

**可能原因**

开发者使用DevEco Studio的debug按钮安装了应用，后面打包之后又通过hdc install方式安装。

**处理步骤**

1.  卸载已安装的应用（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），重新安装新应用。

#### \[h2\]9568296 包类型错误

**错误信息**

error: install failed due to error bundle type.

**错误描述**

bundleType错误导致应用安装失败。

**可能原因**

新安装应用的bundleType与已安装的有相同bundleName应用不一致。

**处理步骤**

*   方法一：卸载已安装的应用（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），重新安装新应用。
    
*   方法二：修改应用的bundleType，与已安装应用保持一致。
    

#### \[h2\]9568292 UserID为0的用户只能安装singleton应用

**错误信息**

error: install failed due to zero user can only install singleton app.

**错误描述**

UserID 0用户只允许安装singleton权限应用。

**可能原因**

UserID 0用户安装了非singleton权限的应用。

**处理步骤**

1.  应用是非singleton权限的，不需要指定用户，直接安装。
    
    hdc shell bm install -p /data/hap名.hap
    

#### \[h2\]9568263 无法降级安装

**错误信息**

error: install version downgrade.

**错误描述**

正在安装应用的VersionCode小于系统中已安装应用的VersionCode，安装失败。

**可能原因**

正在安装应用的VersionCode小于系统中已安装应用的VersionCode。

**处理步骤**

1.  卸载已安装的应用（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），重新安装新应用。
    
2.  对于已安装的证书分发类型为app\_gallery或者签名证书类型为debug的三方应用，当新安装的版本低于当前版本时，支持降级安装，可以使用-d命令实现降级安装。
    
    hdc shell bm install -p /data/example.hap -d
    

#### \[h2\]9568264 安装检验签名一致性失败

**错误信息**

error: install verification failed.

**错误描述**

安装时，校验签名一致性失败。

**可能原因**

校验唯一标识[appIdentifier](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/common-problem-of-application#什么是appidentifier)不一样，导致安装失败。

**处理步骤**

方法一：如果应用可以卸载，可以先卸载应用（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），再重新安装。

方法二：签名文件Profile可以用文本编辑器打开，搜索app-identifier字段，调整安装参数中的appIdentifier，需要和签名文件Profile保持一致。

#### \[h2\]9568301 模块类型不一致

**错误信息**

error: moduleName is inconsistent.

**错误描述**

正在安装的模块名称在系统中已经存在，但模块名称不一致，导致安装失败。

**可能原因**

待安装应用模块名称在系统中已存在，但模块类型不一致，导致安装失败。

**处理步骤**

检查系统中已安装应用的模块名是否与待安装的模块名重复，若模块名称一致但类型不一致，修改对应模块module.json5中type属性。

#### \[h2\]9568303 企业设备管理禁止安装

**错误信息**

error: Failed to install the HAP because the installation is forbidden by enterprise device management.

**错误描述**

存在应用管控策略，安装失败。

**可能原因**

存在应用管控策略。

**处理步骤**

由于企业管控，暂无解决方案。请提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。

#### \[h2\]9568304 应用不支持当前设备类型

**错误信息**

error: device type is not supported.

**错误描述**

正在安装的应用不支持当前设备类型，安装失败。

**可能原因**

正在安装的应用不支持当前设备类型。

**处理步骤**

1.  如需要适配当前设备，请在应用设备类型配置中增加当前设备类型。应用deviceTypes配置包含phone（手机）、tablet（平板）、2in1（2合1设备）、tv（智慧屏）、wearable（智能手表）和car（车机）。

#### \[h2\]9568308 应用包类型不一致

**错误信息**

error: install bundleType not same.

**错误描述**

应用包类型不一致，导致安装失败。

**可能原因**

安装多HAP应用时，存在两个模块的bundleType属性不一致。

**处理步骤**

检查并确保多HAP应用中各模块app.json5的bundleType属性一致。

#### \[h2\]9568317 应用的多进程配置与系统配置不匹配

**错误信息**

error: isolationMode does not match the system.

**错误描述**

安装应用时，设置的isolationMode与系统配置项允许的系统配置不匹配。

**可能原因**

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

**处理步骤**

1.  按照设备的隔离模式配置HAP配置文件isolationMode属性。
    
    \# 查询设备persist.bms.supportIsolationMode值，若返回errNum is:106说明没配置
    hdc shell
    param get persist.bms.supportIsolationMode
    # 配置设备persist.bms.supportIsolationMode值
    hdc shell
    param set persist.bms.supportIsolationMode \[true|false\]
    

#### \[h2\]9568310 兼容策略不同

**错误信息**

error: compatible policy not same.

**错误描述**

新包与已安装包兼容策略不同。

**可能原因**

1.  应用已安装，再安装一个同包名的应用间共享库。
2.  应用间共享库已安装，再安装一个同包名的应用。

**处理步骤**

1.  卸载已安装的应用（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成）或应用间共享库，再安装新包。

#### \[h2\]9568391 包管理服务已停止

**错误信息**

error: bundle manager service is died.

**错误描述**

包管理服务已停止。

**可能原因**

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

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请查询设备的/data/log/faultlog/faultlogger/目录下是否存在包含foundation字样的crash文件。
    
    hdc shell
    cd /data/log/faultlog/faultlogger/
    ls -ls
    
3.  导出crash文件和日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    hdc file recv /data/log/faultlog/faultlogger/
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568393 验证代码签名失败

**错误信息**

error: verify code signature failed.

**错误描述**

验证代码签名失败。

**可能原因**

包没有代码签名信息。

**处理步骤**

1.  安装最新版本DevEco Studio，重新签名。
    
2.  应用当前使用的签名不符合HarmonyOS应用签名的要求，应该替换为HarmonyOS应用的签名。
    

#### \[h2\]9568399 拷贝文件失败

**错误信息**

error: copy file failed.

**错误描述**

安装应用过程中，拷贝文件失败。

**可能原因**

1.  拷贝源文件路径或目标路径为无效路径。
2.  源文件打开失败。
3.  获取源文件状态失败。
4.  源文件的大小无效。
5.  源文件拷贝失败。
6.  源文件没有访问权限。
7.  更改文件权限失败。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568401 调试包仅支持运行在开发者模式设备

**错误信息**

error: debug bundle can only be installed in developer mode.

**错误描述**

调试包仅支持运行在开发者模式设备。

**可能原因**

终端设备未开启“开发者模式”。

**处理步骤**

1.  终端系统查看“设置 > 系统”中是否有“开发者选项”，如果不存在，可在“设置 > 关于本机”连续七次单击“版本号”，直到提示“开启开发者模式”，点击“确认开启”后输入PIN码（如果已设置），设备将自动重启。
2.  USB数据线连接终端和PC，在“设置 > 系统 > 开发者选项”中，打开“USB调试”开关，弹出的“允许USB调试”的弹框，点击“允许”。
3.  启动调试或运行应用。

#### \[h2\]9568404 传递签名配置文件失败

**错误信息**

error: delivery sign profile failed.

**错误描述**

安装过程中，传递代码签名配置文件出现异常，导致安装失败。

**可能原因**

1.  文件路径不存在。
2.  创建文件路径失败。
3.  更改文件目录模式失败。
4.  写配置文件数据失败。
5.  更改配置文件模式失败。
6.  添加配置文件数据失败。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568405 删除签名配置文件失败

**错误信息**

error: remove sign profile failed.

**错误描述**

应用卸载过程中，删除签名配置文件出现异常，导致卸载应用失败。

**可能原因**

1.  文件路径不存在。
2.  加载配置文件数据失败。
3.  文件权限不是可写的。

**处理步骤**

1.  重启手机后再次尝试卸载应用（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成）。
    
2.  重复上述步骤3到5次后依旧卸载失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568381 应用进程删除失败

**错误信息**

error: uninstall killing app error.

**错误描述**

卸载应用时应用进程删除失败。

**可能原因**

进程号错误导致应用进程删除失败。

**处理步骤**

设备重启之后再尝试卸载应用。

#### \[h2\]9568382 卸载应用时包名或者模块名称为空

**错误信息**

error: uninstall invalid name.

**错误描述**

卸载应用时bundleName为空或者moduleName为空。

**可能原因**

卸载应用时，参数bundleName和moduleName异常为空。

**处理步骤**

设备重启之后再尝试卸载应用。

#### \[h2\]9568384 卸载应用时bm工具进程权限异常

**错误信息**

error: uninstall permission denied.

**错误描述**

卸载应用时bm工具进程权限异常。

**可能原因**

bm工具进程异常或者权限丢失，导致卸载应用时无权限。

**处理步骤**

1.  设备重启之后再尝试卸载应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    \# 导出日志文件
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568385 卸载服务异常

**错误信息**

error: uninstall bundle mgr service error.

**错误描述**

卸载服务异常。

**可能原因**

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

**处理步骤**

1.  重启手机后再次尝试卸载应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请查询设备的/data/log/faultlog/faultlogger/目录下是否存在包含foundation字样的crash文件。
    
    hdc shell
    cd /data/log/faultlog/faultlogger/
    ls -ls
    
3.  导出crash文件和日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    hdc file recv /data/log/faultlog/faultlogger/
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568386 卸载的应用不存在

**错误信息**

error: uninstall missing installed bundle.

**错误描述**

卸载的应用不存在。

**可能原因**

要卸载的应用没有安装。

**处理步骤**

1.  确认要卸载的应用是否已经安装。

#### \[h2\]9568388 企业设备管理不允许卸载该应用

**错误信息**

error: Failed to uninstall the HAP because the uninstall is forbidden by enterprise device management.

**错误描述**

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

**可能原因**

应用被设置为不允许被卸载。

**处理步骤**

1.  由设置方取消该应用的卸载管控。

#### \[h2\]9568389 未知错误导致安装失败

**错误信息**

error: unknown.

**错误描述**

未知的错误。

**可能原因**

系统未知的错误导致安装失败。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    \# 导出日志文件
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568284 安装版本不匹配

**错误信息**

error: install version not compatible.

**错误描述**

安装版本不匹配。

**可能原因**

当前安装HSP的版本信息与已安装HAP的版本信息不匹配。

安装HSP时会做如下校验：

1.  bundleName和HAP的一致。
2.  version和HAP的一致。
3.  签名和HAP的一致。

**处理步骤**

1.  卸载版本信息不匹配的HAP（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），再安装HSP。
2.  修改HSP版本信息与HAP一致，再安装HSP。

#### \[h2\]9568287 安装包entry模块数量不合规

**错误信息**

error: install invalid number of entry hap.

**错误描述**

安装包entry模块数量不合规。

**可能原因**

安装包中entry模块有多个。一个应用只能有一个entry模块，可以有多个feature模块。

**处理步骤**

1.  保留一个entry模块，其余entry模块修改为feature（修改module.json5中type字段）。

#### \[h2\]9568281 安装包vendor不一致

**错误信息**

error: install vendor not same.

**错误描述**

安装包vendor不一致。

**可能原因**

app.json5文件中app的vendor字段配置不一致。

**处理步骤**

1.  若只有一个HAP，要求与已安装应用vendor字段一致，卸载重装即可（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成）。
2.  若包含集成态HSP，要求集成态HSP与使用方HAP的vendor字段保持一致。

#### \[h2\]9568272 安装包体积大小无效

**错误信息**

error: install invalid hap size.

**错误描述**

安装包大小超出限制。

**可能原因**

安装包体积超过4GB大小。

**处理步骤**

拆分包，保证每个安装包体积不超过4GB。

#### \[h2\]9568273 应用生成UID失败，导致安装失败

**错误信息**

error: install generate uid error.

**错误描述**

应用生成UID失败，导致安装失败。

**可能原因**

该设备上已安装的应用数量已超过65535，导致应用安装时分配UID失败。

**处理步骤**

卸载不必要的应用后重试（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成）。

#### \[h2\]9568274 安装服务错误

**错误信息**

error: install installd service error.

**错误描述**

安装服务错误。

**可能原因**

安装服务异常。

**处理步骤**

1.  清除缓存，重启设备。

#### \[h2\]9568275 包管理服务错误

**错误信息**

error: install bundle mgr service error.

**错误描述**

包管理服务错误。

**可能原因**

包管理服务异常，如出现空指针导致异常等。

**处理步骤**

重启设备或稍后重试。

#### \[h2\]9568277 包名不一致，导致安装失败

**错误信息**

error: install bundle name not same.

**错误描述**

包名不一致，导致安装失败。

**可能原因**

待安装的路径下的多个安装包包名不一致。

**处理步骤**

检查待安装路径下的安装包包名，确保所有安装包的app.json5配置文件中bundleName一致。

#### \[h2\]9568279 版本不一致，导致安装失败

**错误信息**

error: install version name not same.

**错误描述**

版本（versionName字段）不一致，导致安装失败。

**可能原因**

待安装的路径下的多个安装包的versionName不一致。

**处理步骤**

检查待安装路径下的安装包版本，确保所有安装包的app.json5配置文件中versionName一致。

#### \[h2\]9568280 minCompatibleVersionCode不一致，导致安装失败

**错误信息**

error: install min compatible version code not same.

**错误描述**

minCompatibleVersionCode字段不一致，导致安装失败。

**可能原因**

待安装的路径下的多个安装包的minCompatibleVersionCode不一致。

**处理步骤**

检查待安装路径下的安装包，确保所有安装包的app.json5配置文件中minCompatibleVersionCode一致。

#### \[h2\]9568282 targetAPIVersion不一致，导致安装失败

**错误信息**

error: install releaseType target not same.

**错误描述**

targetAPIVersion字段不一致，导致安装失败。

**可能原因**

待安装的路径下的多个安装包的targetAPIVersion不一致。

**处理步骤**

检查待安装路径下的安装包，确保所有安装包的app.json5配置文件中targetAPIVersion一致。

#### \[h2\]9568314 安装应用间共享库失败

**错误信息**

error: Failed to install the HSP because installing a shared bundle specified by hapFilePaths is not allowed.

**错误描述**

安装应用间共享库失败。

**可能原因**

安装应用间共享HSP时使用“hdc app install \*\*\*”指令。

**处理步骤**

1.  安装应用间HSP时使用“hdc install -s \*\*\*”指令。

#### \[h2\]9568349 操作文件时传入参数异常

**错误信息**

error: installd param error.

**错误描述**

操作文件时传入参数异常，导致安装失败。

**可能原因**

安装过程中，传入参数无效或者传入目录路径为空。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    \# 导出日志文件
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568351 创建文件目录异常导致安装失败

**错误信息**

error: installd create dir failed.

**错误描述**

创建文件目录异常，导致安装失败。

**可能原因**

创建文件目录时没有写权限。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    \# 导出日志文件
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568354 删除文件目录异常导致安装失败

**错误信息**

error: installd remove dir failed.

**错误描述**

删除文件目录失败，导致安装失败。

**可能原因**

删除文件目录不存在，或者当前目录没有可写权限。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    \# 导出日志文件
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568355 安装包中提取文件失败

**错误信息**

error: installd extract files failed.

**错误描述**

安装包中提取文件失败，导致安装失败。

**可能原因**

安装过程中，解压so的目录创建失败，导致HAP包中提取so失败。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    \# 导出日志文件
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568356 安装过程中重命名目录名失败

**错误信息**

error: installd rename dir failed.

**错误描述**

重命名目录名失败，导致安装失败。

**可能原因**

安装过程中，重命名目录，目录名称超出260字符，或者当前目录没有可写权限。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    \# 导出日志文件
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568357 清理文件失败

**错误信息**

error: installd clean dir failed.

**错误描述**

清理文件失败，导致安装失败。

**可能原因**

安装过程中，待清理的文件无可写权限导致清理文件失败。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    \# 导出日志文件
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568359 安装设置selinux失败

**错误信息**

error: installd set selinux label failed.

**错误描述**

安装设置selinux失败。

**可能原因**

签名配置文件中APL字段错误。APL有“normal”、“system\_basic”和“system\_core”三种等级。

**处理步骤**

1.  确认签名文件p7b中apl字段是否有误。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0e/v3/5Y0pysZgRn-iHlyOMnnj3g/zh-cn_image_0000002594668762.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=6E1181574BCA9E072A4461D95C5A584E948D7238948C301361B9F82A2393AB44)
    
2.  若apl字段有误，修改UnsgnedReleasedProfileTemplate.json文件中apl字段，并重新签名。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/20/v3/WD8cQSSZTmCGQ8nmaKsS_Q/zh-cn_image_0000002594828690.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=AFE31454B2C2240D248801904F87537DCA9F882D4A09202F055FD4150CD32170)
    

#### \[h2\]9568360 安装overlay应用出现错误

**错误信息**

error: internal error of overlay installation.

**错误描述**

安装overlay应用出现错误。

**可能原因**

解析overlay安装包失败或者安装内部出现异常导致安装失败。

**处理步骤**

方法一：重新编译overlay应用再尝试安装。

方法二：设备重启之后，再尝试安装。

#### \[h2\]9568361 overlay应用中目标包名为空导致安装失败

**错误信息**

error: invalid bundle name of overlay installation.

**错误描述**

overlay应用中目标包名为空导致安装失败。

**可能原因**

overlay应用中targetBundleName为空。

**处理步骤**

检查overlay应用中的[app.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file)的targetBundleName字段是否配置。

#### \[h2\]9568362 overlay应用中目标模块名称为空导致安装失败

**错误信息**

error: invalid module name of overlay installation.

**错误描述**

overlay应用中目标模块名称为空导致安装失败。

**可能原因**

overlay应用中targetModuleName为空。

**处理步骤**

检查overlay应用中的[module.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)的targetModuleName字段是否配置。

#### \[h2\]9568398 企业MDM应用/普通企业应用不允许安装

**错误信息**

error: Failed to install the HAP because an enterprise normal/MDM bundle cannot be installed on non-enterprise device.

**错误描述**

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

**可能原因**

当前设备不允许安装[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)中如下两种类型的应用：enterprise\_mdm（企业MDM应用）、enterprise\_normal（普通企业应用）。Profile签名文件类型的取值及含义请参考[ApplicationInfo.appDistributionType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-applicationinfo#applicationinfo-1)。

**处理步骤**

更换Profile签名文件中的类型。

#### \[h2\]9568402 禁止安装签名证书profile文件中的类型为app\_gallery的release应用

**错误信息**

error: Release bundle can not be installed.

**错误描述**

禁止通过bm命令安装[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)中的类型为app\_gallery并且签名证书类型为release的应用。

**可能原因**

安装应用[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)中的类型为app\_gallery并且签名证书类型为release。

**处理步骤**

1.  使用[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)中的类型非app\_gallery的文件对应用重新签名。
2.  使用debug类型证书对应用重新签名。

#### \[h2\]9568403 安装加密校验失败

**错误信息**

error: check encryption failed.

**错误描述**

安装加密校验失败。

**可能原因**

可能是镜像版本较老；或者HAP包lib目录内非so文件导致。

**处理步骤**

1.  安装新版本镜像。
2.  删除HAP工程中lib目录内非so文件，重新签名打包。

#### \[h2\]9568407 安装失败，native软件包安装失败

**错误信息**

error: Failed to install the HAP because installing the native package failed.

**错误描述**

安装HAP时，native软件包安装失败。

**可能原因**

HAP包中需要安装的native软件包损坏。

**处理步骤**

1.  检查HAP包中的native软件包，替换正确的native软件包并重新签名打包。参考[Native软件包开发指南](https://gitcode.com/openharmony/startup_appspawn/blob/master/service/hnp/README_zh.md)。

#### \[h2\]9568408 卸载应用失败，native软件包卸载失败

**错误信息**

error: Failed to uninstall the HAP because uninstalling the native package failed.

**错误描述**

卸载应用时，native软件包卸载失败。

**可能原因**

应用对应的需要卸载的native软件包被占用。

**处理步骤**

1.  检查是否存在进程占用相应的native软件包，若存在则结束进程后重新卸载。参考[Native软件包开发指南](https://gitcode.com/openharmony/startup_appspawn/blob/master/service/hnp/README_zh.md)。

#### \[h2\]9568409 安装失败，native软件包提取失败

**错误信息**

error: Failed to install the HAP because the extract of the native package failed.

**错误描述**

安装HAP时，提取native软件包失败。

**可能原因**

HAP包中native软件包目录下不存在module.json5中配置的native软件包。

**处理步骤**

1.  检查HAP包中的native软件包目录，重新打入需要安装的native软件包并完成签名或删除module.json5中缺失的native软件包配置信息。参考[Native软件包开发指南](https://gitcode.com/openharmony/startup_appspawn/blob/master/service/hnp/README_zh.md)。

#### \[h2\]9568410 安装失败，设备受管控

**错误信息**

error: failed to install because the device be controlled.

**错误描述**

因为设备受管控导致HAP安装失败。

**可能原因**

设备通过非法渠道激活等原因。

**处理步骤**

1.  确认设备是否是非法渠道获取的。
2.  走正常设备激活流程。

#### \[h2\]9568412 卸载请求被应用程序拒绝

**错误信息**

error: The uninstall request is rejected by the application.

**错误描述**

卸载请求被应用程序拒绝。

**可能原因**

目标应用不允许卸载。

**处理步骤**

暂无处理方案，可以提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。

#### \[h2\]9568413 应用设备类型不支持当前设备

**错误信息**

error: check syscap filed and device type is not supported.

**错误描述**

应用配置的[设备类型](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#devicetypes标签)或者[requiredDeviceFeatures标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#requireddevicefeatures标签)配置的设备特性不支持安装。

**可能原因**

应用配置的设备类型或者requiredDeviceFeatures标签配置的设备特性和安装设备不一致。

**处理步骤**

调整正确的设备类型，如果设备类型配置准确，请确保requiredDeviceFeatures标签符合设置要求。

#### \[h2\]9568415 禁止安装签名证书为debug或者配置文件debug为true的加密应用

**错误信息**

error: debug encrypted bundle is not allowed to install.

**错误描述**

禁止安装签名证书为debug类型或者配置文件debug属性值为true的加密应用。

**可能原因**

1.  安装了签名证书为debug类型的加密应用。
2.  安装了配置文件中debug属性值为true的加密应用。

**处理步骤**

1.  不支持安装签名证书为debug类型或者配置文件debug属性值为true的加密应用，可以修改为非加密应用进行安装调试。

#### \[h2\]9568416 加密应用不允许安装

**错误信息**

error: Encrypted bundle cannot be installed.

**错误描述**

加密应用不允许通过bm命令安装。

**可能原因**

安装的应用为加密应用。

**处理步骤**

1.  使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)或者[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)重新签名后安装调试。

#### \[h2\]9568417 签名校验失败

**错误信息**

error: bundle cannot be installed because the appId is not same with preinstalled bundle.

**错误描述**

预置应用卸载后安装同bundleName的应用，由于应用的签名信息不一致禁止安装。

**可能原因**

虽然已卸载预置应用，但在安装新应用之前，系统仍会先安装预置应用包，随后再安装新应用包。这是因为预置应用的安装签名信息中的密钥和[APP ID](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506#section16423184171915)，与新安装的应用对应信息不一致。

**处理步骤**

方法一：重新签名。

通过重新签名，确保应用签名信息中的[密钥](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section462703710326)和[APP ID](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506#section16423184171915)至少有一项与预置应用保持一致。

如果直接使用DevEco Studio自动签名，由于生成的签名信息均为随机值，与预置应用不匹配，将导致应用安装失败。因此，您需要用之前[申请发布Profile](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-profile-0000002248341090)的账号，重新[申请调试Profile](https://developer.huawei.com/consumer/cn/doc/app/agc-help-debug-profile-0000002248181278)或直接使用发布Profile对应用重新签名，完成签名后，重新安装应用。

方法二：更换bundleName。

修改安装应用的[bundleName](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file#配置文件标签)，确保与预置应用的bundleName不一致。

#### \[h2\]9568418 应用设置了卸载处置规则，不允许直接卸载

**错误信息**

error: Failed to uninstall the app because the app is locked.

**错误描述**

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

**可能原因**

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

**处理步骤**

1.  检查应用是否设置了卸载处置规则，由设置方取消卸载处置规则。

#### \[h2\]9568420 禁止通过bm安装release的预置应用

**错误信息**

error: os\_integration Bundle is not allowed to install for shell.

**错误描述**

禁止通过bm安装release的预置应用。

**可能原因**

通过bm安装release的预置应用。

**处理步骤**

检查应用是否为预置的release版本。如果是，需要替换应用的[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)的类型，重新签名并安装。

#### \[h2\]9568278 安装包的版本号不一致

**错误信息**

error: install version code not same.

**可能原因**

1.  设备上安装的应用和安装报错的应用包版本号（versionCode）不一致。
2.  安装多个包中存在版本号（versionCode）不一致。

**处理步骤**

1.  调整安装包的版本和设备中已存在的应用包的版本号（versionCode）一致，或者卸载设备中的应用（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），再去安装新的应用包。
2.  调整安装的多个包的版本号（versionCode），所有的包都需要保持版本号（versionCode）一致。

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

**错误信息**

error: Failed to install the HAP or HSP because the app distribution type is not allowed.

**错误描述**

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

**可能原因**

该[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)中的类型被限制，禁止安装到当前设备中。

**处理步骤**

更换签名证书profile文件中的类型。

#### \[h2\]9568423 签名证书profile文件中缺少当前设备的udid配置，不允许安装到当前设备中

**错误信息**

error: Failed to install the HAP because the device is unauthorized, make sure the UDID of your device is configured in the signing profile.

**错误描述**

签名证书profile文件中缺少当前设备的UDID配置，不允许安装到当前设备中。

**可能原因**

该应用的[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)为调试类型，且未配置当前设备的UDID。

**处理步骤**

方式一：根据[指导](https://developer.huawei.com/consumer/cn/doc/app/agc-help-debug-profile-0000002248181278)将当前设备添加到调试类型证书或使用[发布类型证书](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-profile-0000002248341090)重新签名。

方式二：重新[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。

#### \[h2\]9568380 卸载系统应用失败

**错误信息**

error: uninstall system app error.

**错误描述**

卸载系统应用失败。

**可能原因**

部分系统应用设置为不可卸载，不支持卸载此类应用。

**处理步骤**

不能卸载不可卸载的应用。

#### \[h2\]9568387 卸载未安装的模块，导致卸载失败

**错误信息**

error: uninstall missing installed module.

**错误描述**

卸载未安装的模块。

**可能原因**

卸载未安装的模块。

**处理步骤**

使用[bm dump -n](#查询应用信息命令dump)命令查看应用配置，确认要卸载的模块已经安装。

#### \[h2\]9568432 插件与应用之间的 pluginDistributionIDs 校验失败，导致安装失败

**错误信息**

error: Check pluginDistributionID between plugin and host application failed.

**错误描述**

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

**可能原因**

应用与插件的 pluginDistributionIDs 没有共同值，导致校验失败。

**处理步骤**

重新配置应用或者插件[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)中的 pluginDistributionIDs。配置格式如下：

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

#### \[h2\]9568433 应用缺少ohos.permission.kernel.SUPPORT\_PLUGIN权限

**错误信息**

error: Failed to install the plugin because host application check permission failed.

**错误描述**

应用安装插件时，应用的权限校验失败。

**可能原因**

应用缺少ohos.permission.kernel.SUPPORT\_PLUGIN权限。

**处理步骤**

1.  参考[权限申请指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/declare-permissions)申请[ohos.permission.kernel.SUPPORT\_PLUGIN权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/restricted-permissions#ohospermissionkernelsupport_plugin)。

#### \[h2\]9568333 模块名称为空

**错误信息**

error: Install failed due to hap moduleName is empty.

**错误描述**

模块名称为空，导致安装失败。

**可能原因**

模块名称为空。

**处理步骤**

检查[module.json5](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)的name字段是否为空。

#### \[h2\]9568331 签名信息不一致

**错误信息**

error: Install incompatible signature info.

**错误描述**

签名信息不一致，导致安装失败。

**可能原因**

安装多HAP包的应用时，HAP包的签名信息不一致。

**处理步骤**

重新签名，使多个HAP包签名信息一致。参考[配置调试签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing)。

#### \[h2\]9568334 模块名称重复

**错误信息**

error: Install failed due to hap moduleName duplicate.

**错误描述**

模块名称重复，导致安装失败。

**可能原因**

一个应用同时安装多个模块时，模块名称存在重复。

**处理步骤**

同一个应用多个模块的名称要保证唯一性。

#### \[h2\]9568340 配置文件缺失

**错误信息**

error: Install parse no profile.

**错误描述**

HAP包没有配置文件，导致安装失败。

**可能原因**

[module.json](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)、[pack.info](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-compile-build#section43931054115513)等配置文件缺失。

**处理步骤**

使用DevEco Studio重新构建、打包、安装。

#### \[h2\]9568341 安装时解析配置文件失败

**错误信息**

error: Install parse bad profile.

**错误描述**

安装时解析配置文件失败。

**可能原因**

[module.json](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)、[pack.info](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-compile-build#section43931054115513)等配置文件格式异常。

**处理步骤**

使用DevEco Studio重新构建、打包、安装。

#### \[h2\]9568342 配置文件数据类型错误

**错误信息**

error: Install parse profile prop type error.

**错误描述**

安装解析配置文件时，数据类型错误，导致安装失败。

**可能原因**

[module.json](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)、[pack.info](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-compile-build#section43931054115513)等配置文件存在数据类型错误的字段。

**处理步骤**

使用DevEco Studio重新构建、打包、安装。

#### \[h2\]9568345 配置文件中的字符串长度或者数组大小过大

**错误信息**

error: too large size of string or array type element in the profile.

**错误描述**

安装解析配置文件时，字符串长度或者数组大小过大，导致安装失败。

**可能原因**

[module.json](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)、[pack.info](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-compile-build#section43931054115513)等配置文件存在字符串长度或者数组大小过大的字段。

**处理步骤**

使用DevEco Studio重新构建、打包、安装。

#### \[h2\]9568346 解析安装包获取SysCap信息失败

**错误信息**

error: install parse syscap error.

**错误描述**

安装过程中，解析安装包获取[SysCap](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/syscap#syscap的用途)信息失败。

**可能原因**

HAP/HSP包损坏。

**处理步骤**

尝试重新安装，如果还是失败，请重新编译签名打包出新的包，再安装新编译的HAP/HSP。

#### \[h2\]9568347 解析本地so文件失败

**错误信息**

error: install parse native so failed.

**错误描述**

在启动调试或运行C++应用/服务时，安装HAP包出现错误，提示“error: install parse native so failed”错误信息。

**可能原因**

设备支持的Abi类型与C++工程中配置的Abi类型不匹配。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7a/v3/eFhogUAOQFiWA8gQkhhNxg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=7BBB4113D0A85EA9A4C5C991F8171913B713025A16768996310D470069E94450)

*   如果工程有依赖HSP或者HAR模块，请确保所有包含C++代码的模块配置的Abi类型包含设备支持的Abi类型。
*   如果工程依赖的三方库包含so文件，请确保oh\_modules/三方库/libs目录包含有设备支持的Abi目录，如libs/arm64-v8a、/libs/x86\_64。
    
    对于HarmonyOS应用，在DevEco Studio NEXT Developer Beta1（5.0.3.200）及以上版本不支持编译armeabi-v7a架构的so文件。
    

**处理步骤**

1.  将设备或模拟器与DevEco Studio进行连接，具体指导及要求可查看[使用本地真机运行应用](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-run-device)。
    
2.  在命令行执行如下[hdc命令](#环境要求hdc工具)，查询设备支持的Abi列表。
    
    hdc shell
    param get const.product.cpu.abilist
    
3.  根据查询返回结果，检查[模块级build-profile.json5](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-build-profile)文件中的[“abiFilters”参数](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ohos-abi#在编译架构中指定abi)中的配置，规则如下：
    
    *   若返回结果为armeabi-v7a/armeabi/arm64-v8a/x86/x86\_64中的一个或多个，需要在“abiFilters”参数中至少包含返回结果中的一个Abi类型。

#### \[h2\]9568348 解析 ark native SO文件失败

**错误信息**

error: Install parse ark native file failed.

**错误描述**

安装时，解析 ark native SO文件失败。

**可能原因**

安装多HAP时，存在Abi不一致，且与当前设备支持的Abi不匹配。

**处理步骤**

检查多HAP的Abi是否一致，请参考[错误码9568347](#section9568347-解析本地so文件失败)的处理步骤。

#### \[h2\]9568350 安装时获取代理对象失败

**错误信息**

error: Installd get proxy error.

**错误描述**

安装时获取代理对象失败。

**可能原因**

包管理或其他服务异常，导致获取代理失败。

**处理步骤**

1.  重启手机后再次尝试安装应用。
    
2.  重复上述步骤3到5次后依旧安装失败，请导出日志文件，提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。
    
    \# 导出日志文件
    hdc file recv /data/log/hilog/
    

#### \[h2\]9568434 设备不具备插件能力

**错误信息**

error: Failed to install the plugin because current device does not support plugin.

**错误描述**

当前设备不具备插件能力，导致安装插件失败。

**可能原因**

设备不具备插件能力。

**处理步骤**

使用[param工具](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/param-tool)设置const.bms.support\_plugin的值为true，即执行hdc shell param set const.bms.support\_plugin true。

#### \[h2\]9568435 应用包名不存在

**错误信息**

error: Host application is not found.

**错误描述**

传入的应用包名不存在。

**可能原因**

应用没有安装。

**处理步骤**

检查传入的应用是否存在。

#### \[h2\]9568436 多个HSP包信息不一致

**错误信息**

error: Failed to install the plugin because they have different configuration information.

**错误描述**

多HSP之间的包信息不一致，导致安装失败。

**可能原因**

安装的插件为多HSP时，多个HSP文件的包信息不一致。

**处理步骤**

检查多HSP之间的包信息是否一致，包括[app.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file#配置文件标签)中bundleName、bundleType、versionCode、apiReleaseType字段。

#### \[h2\]9568437 插件的 pluginDistributionIDs 解析失败

**错误信息**

error: Failed to install the plugin because the plugin id failed to be parsed.

**错误描述**

插件的 pluginDistributionIDs 解析失败，导致安装失败。

**可能原因**

插件签名信息中的 pluginDistributionIDs 配置不符合规范，导致解析失败。

**处理步骤**

参考如下格式，重新配置插件[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)中的"app-services-capabilities"字段。

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

#### \[h2\]9568438 插件包名不存在

**错误信息**

error: The plugin is not found.

**错误描述**

插件不存在。

**可能原因**

当前应用没有安装该插件。

**处理步骤**

使用[bm dump -n 命令](#查询应用信息命令dump)查询应用的信息，检查传入的插件是否安装。

#### \[h2\]9568439 插件与应用包名一致

**错误信息**

error: The plugin name is same as host bundle name.

**错误描述**

插件的包名与应用包名相同。

**可能原因**

插件包名与应用包名一致，导致插件安装失败。

**处理步骤**

重新配置插件的包名。

#### \[h2\]9568441 应用不能变更U1Enabled

**错误信息**

error: install failed due to U1Enabled can not change.

**错误描述**

签名信息中U1Enabled变更导致安装失败。

**可能原因**

应用[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)中allowed-acls字段的U1Enabled配置发生变更，例如：

1.  已安装应用在allowed-acls中配置了U1Enabled，待安装应用在allowed-acls中没有配置U1Enabled。
2.  已安装应用在allowed-acls中没有配置U1Enabled，待安装应用在allowed-acls中配置了U1Enabled。

**处理步骤**

方案一：重新签名，签名过程中，请参考[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)的支持ACL权限、或者[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)的使用ACL的签名配置指导进行配置，确保待安装应用与已安装应用配置一致。

方案二：先卸载设备上已安装的应用（PC/2in1设备需要确保所有用户下都卸载完成，手机/平板侧需要关注隐私空间和主用户下是否卸载完成），再尝试安装待安装应用。

#### \[h2\]9568442 U1Enable配置不一致

**错误信息**

error: Install failed due to the U1Enabled is not same in all haps.

**错误描述**

签名信息中U1Enabled配置不一致，导致安装失败。

**可能原因**

多HAP包签名时使用的[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)不一致导致签名信息中allowed-acls的U1Enabled配置不一致。

**处理步骤**

重新签名，签名过程中，请参考[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)的支持ACL权限、或者[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)的使用ACL的签名配置指导进行配置，使多个HAP包签名信息中allowed-acls的U1Enabled信息一致。

#### \[h2\]9568445 一次仅支持安装一个APP包

**错误信息**

error: only one app can be installed at a time.

**错误描述**

安装APP时，每次只允许安装一个APP，安装多个APP会导致安装失败，且不允许HAP/HSP和APP一起安装。

**可能原因**

通过bm install -p命令安装应用时，

1.  \-p指定了多个APP路径。
2.  \-p传入的路径下包含多个APP包。
3.  \-p传入的路径下既包含APP包又包含了HAP/HSP。
4.  \-p指定了APP包路径的同时，又通过-s指定了应用间HSP路径。

**处理步骤**

每次只指定一个APP路径，或传入路径下仅包含一个APP。如果通过-p指定了APP包路径，不再使用-s。

#### \[h2\]9568446 解压APP失败

**错误信息**

error: decompress app failed.

**错误描述**

用户安装APP时，解压APP失败。

**可能原因**

APP包的格式不正确。

**处理步骤**

重新[打包APP](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/packing-tool#app打包指令)。

#### \[h2\]9568447 APP中没有能在当前设备安装的包

**错误信息**

error: no suitable haps or hsps in the app.

**错误描述**

要安装的APP包不适用于当前设备。

**可能原因**

APP中没有适合当前设备的HAP包或者HSP包。

**处理步骤**

如需要适配当前设备，请在应用设备类型配置中增加当前[设备类型](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#devicetypes标签)，然后重新[打包APP](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/packing-tool#app打包指令)。

#### \[h2\]9568448 验证APP签名失败

**错误信息**

error: verify app signature failed.

**错误描述**

用户安装APP时签名验证失败。

**可能原因**

APP包签名不正确或没有签名。

**处理步骤**

方法一. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。

方法二. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

#### \[h2\]9568449 二进制文件校验失败

**错误信息**

error: check bin file failed.

**错误描述**

用户安装应用时，二进制文件校验失败。

**可能原因**

1.  在应用的module.json5配置文件中配置了[executableBinaryPaths标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#executablebinarypaths标签)，但是应用未配置解压模式。
2.  该设备不支持安装配置了[executableBinaryPaths标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#executablebinarypaths标签)的应用。

**处理步骤**

1.  配置应用为解压模式，即在应用的[module.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#配置文件标签)中设置compressNativeLibs标签为true。
2.  更换为PC/2in1设备。

#### \[h2\]9568450 安装失败，应用包需为签名证书类型为debug的应用

**错误信息**

error: Failed to install because the bundle must be debug type.

**错误描述**

应用包需为签名证书类型为debug的应用。

**可能原因**

[开发者模式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-developer-mode#section530763213432)下使用[\-g参数](#安装命令install)授权签名证书类型为非debug的应用。可以通过[Profile签名文件](https://developer.huawei.com/consumer/cn/doc/app/agc-help-profile-overview-0000002283260125)中的type字段来查看签名证书类型。

**处理步骤**

使用debug类型证书对应用重新签名。