往期鸿蒙全套实战文章必看:
bm工具
Bundle Manager(包管理工具,简称bm)是实现应用安装、卸载、更新、查询等功能的工具,bm为开发者提供基本的应用安装包的调试能力,例如:安装应用,卸载应用,查询安装包信息等。
说明
在使用本工具前,开发者需要先获取hdc工具,执行hdc shell。
表1 bm工具命令列表
命令 | 描述 |
---|---|
help | 帮助命令,显示bm支持的命令信息。 |
install | 安装命令,用来安装应用。 |
uninstall | 卸载命令,用来卸载应用。 |
dump | 查询命令,用来查询应用的相关信息。 |
clean | 清理命令,用来清理应用的缓存和数据。此命令在root版本下可用,在user版本下打开开发者模式可用。其它情况不可用。 |
enable | 使能命令,用来使能应用,使能后应用可以继续使用。此命令在root版本下可用,在user版本下不可用。 |
disable | 禁用命令,用来禁用应用,禁用后应用无法使用。此命令在root版本下可用,在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。 |
帮助命令
bm help
表2 help命令列表
命令 | 描述 |
---|---|
bm help | 显示bm工具的能够支持的命令信息。 |
示例:
# 显示帮助信息
bm help
安装命令
bm install [-h] [-p filePath] [-u userId] [-r] [-w waitingTime] [-s hspDirPath]
安装命令可以组合,下面列出部分命令。
表3 安装命令列表
命令 | 描述 |
---|---|
bm install -h | 显示install支持的命令信息。-h为非必选字段。 |
bm install -p <filePath> | 安装应用,支持指定路径和多个hap、hsp同时安装。安装应用时,-p为必选字段。 |
bm install -p <filePath> -u <userId> | 给指定用户安装一个应用。-u非必选字段,默认为当前活跃用户。 |
bm install -p <filePath> -r | 覆盖安装一个应用,-r为非必选字段,默认支持覆盖安装。 |
bm install -p <filePath> -r -u <userId> | 给指定用户覆盖安装一个应用。 |
bm install -p <filePath> -r -u <userId> -w <waitingTime> | 安装时指定bm工具等待时间,-w非必选字段,最小的等待时长为180s,最大的等待时长为600s, 默认缺省为5s。 |
bm install -s <hspDirPath> | 安装应用间共享库, 每个路径目录下只能存在一个同包名的HSP。-s为安装应用间HSP时必选字段,其他场景为可选字段。 |
bm install -p <filePath> -s <hspDirPath> | 同时安装使用方应用和其依赖的应用间共享库。 |
示例:
# 安装一个hap
bm install -p /data/app/ohos.app.hap
# 覆盖安装一个hap
bm install -p /data/app/ohos.app.hap -r
# 安装一个应用间共享库
bm install -s xxx.hsp
# 同时安装多个应用间共享库
bm install -s xxx.hsp yyy.hsp
# 同时安装使用方应用和其依赖的应用间共享库
bm install -p aaa.hap -s xxx.hsp yyy.hsp
卸载命令
bm uninstall [-h] [-n bundleName] [-m moduleName] [-u userId] [-k] [-s] [-v versionCode]
命令可以组合,下面列出部分命令。
表4 卸载命令列表
命令 | 描述 |
---|---|
bm uninstall -h | 显示uninstall支持的命令信息。-h为非必选字段。 |
bm uninstall -n <bundleName> | 通过指定包名卸载应用。-n为必选字段。 |
bm uninstall -n <bundleName> -u <userId> | 通过指定包名和用户卸载应用。-u非必选字段,默认为当前活跃用户。 |
bm uninstall -n <bundleName> -u <userId> -k | 通过指定包名和用户以保留用户数据方式卸载应用。-k为非必选字段。 |
bm uninstall -n <bundleName> -m <moduleName> | 通过指定包名卸载应用的一个模块。-m为非必选字段。 |
bm uninstall -n <bundleName> -s | 卸载指定的shared bundle。-s为非必选字段,卸载共享库应用时为必选字段。 |
bm uninstall -n <bundleName> -s -v <versionCode> | 卸载指定的shared bundle的指定版本。-v为非必选字段。 |
示例:
# 卸载一个应用
bm uninstall -n com.ohos.app
# 卸载应用的一个模块
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
查询应用信息命令
bm dump [-h] [-a] [-n bundleName] [-s shortcutInfo] [-u userId] [-d deviceId]
命令可以组合,下面列出部分命令。
表5 查询命令列表
命令 | 描述 |
---|---|
bm dump -h | 显示dump支持的命令信息。-h为非必选字段。 |
bm dump -a | 查询系统已经安装的所有应用包名。-a为非必选字段。 |
bm dump -n <bundleName> | 查询指定包名的详细信息。-n为非必选字段。 |
bm dump -n <bundleName> -s | 查询指定包名下的快捷方式信息。-s为非必选字段。 |
bm dump -n <bundleName> -d <deviceId> | 跨设备查询包信息。-d为非必选字段。 |
bm dump -n <bundleName> -u <userId> | 查询指定用户下指定包名的详细信息。-u为非必选字段,默认为所有用户。 |
示例:
# 显示所有已安装的Bundle名称
bm dump -a
# 查询该应用的详细信息
bm dump -n com.ohos.app -u 100
# 查询该应用的快捷方式信息
bm dump -s -n com.ohos.app -u 100
# 查询跨设备应用信息
bm dump -n com.ohos.app -d xxxxx
清理命令
bm clean [-h] [-c] [-n bundleName] [-d] [-u userId] [-i appIndex]
表6 清理命令列表
命令 | 描述 |
---|---|
bm clean -h | 显示clean支持的命令信息。-h为非必选字段。 |
bm clean -n <bundleName> -c | 清除指定包名的缓存数据。-n为必选字段,-c为非必选字段。 |
bm clean -n <bundleName> -d | 清除指定包名的数据目录。-d为非必选字段。 |
bm clean -n <bundleName> -c -u <userId> | 清除指定用户下包名的缓存数据。-u为非必选字段,默认为当前活跃用户。 |
bm clean -n <bundleName> -d -u <userId> | 清除指定用户下包名的数据目录。 |
bm clean -n <bundleName> -d -u <userId> -i <appIndex> | 清除指定用户下分身应用的数据目录。-i为非必选字段,默认为0。 |
示例:
# 清理该应用下的缓存数据
bm clean -c -n com.ohos.app -u 100
# 清理该应用下的用户数据
bm clean -d -n com.ohos.app -u 100
// 执行结果
clean bundle data files successfully.
使能命令
bm enable [-h] [-n bundleName] [-a abilityName] [-u userId]
表7 使能命令列表
命令 | 描述 |
---|---|
bm enable -h | 显示enable支持的命令信息。-h为非必选字段。 |
bm enable -n <bundleName> | 使能指定包名的应用。-n为必选字段。 |
bm enable -n <bundleName> -a <abilityName> | 使能指定包名下的元能力模块。-a为非必选字段。 |
bm enable -n <bundleName> -u <userId> | 使能指定用户和包名的应用。-u为非必选字段,默认为当前活跃用户。 |
示例:
# 使能该应用
bm enable -n com.ohos.app -a com.ohos.app.EntryAbility -u 100
// 执行结果
enable bundle successfully.
禁用命令
bm disable [-h] [-n bundleName] [-a abilityName] [-u userId]
表8 禁用命令列表
命令 | 描述 |
---|---|
bm disable -h | 显示disable支持的命令信息。-h为非必选字段。 |
bm disable -n <bundleName> | 禁用指定包名的应用。-n为必选字段。 |
bm disable -n <bundleName> -a <abilityName> | 禁用指定包名下的元能力模块。-a为非必选字段。 |
bm disable -n <bundleName> -u <userId> | 禁用指定用户和包名下的应用。-u为非必选字段,默认为当前活跃用户。 |
示例:
# 禁用该应用
bm disable -n com.ohos.app -a com.ohos.app.EntryAbility -u 100
// 执行结果
disable bundle successfully.
获取udid命令
bm get [-h] [-u]
表9 获取udid命令列表
命令 | 描述 |
---|---|
bm get -h | 显示get支持的命令信息。-h为非必选字段。 |
bm get -u | 获取设备的udid。-u为必选字段。 |
示例:
# 获取设备的udid
bm get -u
// 执行结果
udid of current device is :
23CADE0C
快速修复命令
bm quickfix [-h] [-a -f filePath [-t targetPath] [-d]] [-q -b bundleName] [-r -b bundleName]
表10 快速修复命令列表
命令 | 描述 |
---|---|
bm quickfix -h | 显示quickfix支持的命令信息。-h为非必选字段。 |
bm quickfix -a -f <filePath> | 执行补丁安装命令。-a非必选字段,指定后,-f为必选字段,未指定-a,则-f为非必选字段。 |
bm quickfix -q -b <bundleName> | 根据包名查询补丁包信息。-q为非必选字段,指定后,-b为必选字段,未指定-q,则-b为非必选字段。 |
bm quickfix -a -f <filePath> -d | 选择debug模式执行补丁安装命令。-d为非必选字段。 |
bm quickfix -a -f <filePath> -t <target-path> | 指定补丁安装目录,且不使能。-t为非必选字段。 |
bm quickfix -r -b <bundleName> | 根据包名卸载未使能的补丁。-r为非必选字段,指定后,-b为必选字段,未指定-r,则-b为非必选字段。 |
示例:
# 根据包名查询补丁包信息
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
共享库查询命令
bm dump-shared [-h] [-a] [-n bundleName] [-m moduleName]
表11 共享库查询命令列表
命令 | 描述 |
---|---|
bm dump-shared -h | 显示dump-shared支持的命令信息。-h为非必选字段。 |
bm dump-shared -a | 查询系统中已安装所有共享库。-a为非必选字段。 |
bm dump-shared -n <bundleName> | 查询指定共享库包名的详细信息。-n为非必选字段。 |
bm dump-shared -n <bundleName> -m <moduleName> | 查询指定共享库包名和模块名的详细信息。-m为非必选字段。 |
示例:
# 显示所有已安装共享库包名
bm dump-shared -a
# 显示该共享库的详细信息
bm dump-shared -n com.ohos.lib
共享库依赖关系查询命令
显示指定应用和指定模块依赖的共享库信息。
bm dump-dependencies [-h] [-n bundleName] [-m moduleName]
表12 共享库依赖关系查询命令列表
命令 | 描述 |
---|---|
bm dump-dependencies -h | 显示bm dump-dependencies支持的命令信息。-h为非必选字段。 |
bm dump-dependencies -n <bundleName> | 查询指定应用依赖的共享库信息。-n为必选字段。 |
bm dump-dependencies -n <bundleName> -m <moduleName> | 查询指定应用指定模块依赖的共享库信息。-m为非必选字段。 |
- 示例
# 显示指定应用指定模块依赖的共享库信息
bm dump-dependencies -n com.ohos.app -m entry
应用执行编译AOT命令
应用执行编译AOT命令。
bm compile [-h] [-m mode] [-r bundleName]
表13 compile命令列表
命令 | 描述 |
---|---|
bm compile -h | 显示compile支持的命令信息。-h为非必选字段。 |
bm compile -m <mode-name> | 根据包名编译应用。-m为非必选字段,可选值为partial或者full。 |
bm compile -m <mode-name> -a | 编译所有应用。-a为非必选字段。 |
bm compile -r -a | 移除所有编译应用的结果。-r为非必选字段。 |
bm compile -r <bundleName> | 移除应用的结果。 |
示例:
# 根据包名编译应用
bm compile -m partial com.example.myapplication
拷贝ap文件命令
拷贝ap文件到指定应用的/data/local/pgo路径。
bm copy-ap [-h] [-a] [-n bundleName]
表14 copy-ap命令列表
命令 | 描述 |
---|---|
bm copy-ap -h | 显示copy-ap支持的命令信息。-h为非必选字段。 |
bm copy-ap -a | 拷贝所有包相关ap文件。-a为非必选字段。 |
bm copy-ap -n <bundleName> | 根据包名拷贝对应包相关的ap文件。-n为非必选字段。 |
示例:
# 根据包名移动对应包相关的ap文件
bm copy-ap -n com.example.myapplication
查询overlay应用信息命令
打印overlay应用的overlayModuleInfo。
bm dump-overlay [-h] [-b bundleName] [-m moduleName] [-u userId] [-t targetModuleName]
表15 dump-overlay命令列表
命令 | 描述 |
---|---|
bm dump-overlay -h | 显示dump-overlay支持的命令信息。-h为非必选字段。 |
bm dump-overlay -b <bundleName> | 获取指定应用的所有OverlayModuleInfo信息。-b为必选字段。 |
bm dump-overlay -b <bundleName> -m <moduleName> | 根据指定的包名和module名查询OverlayModuleInfo信息。-m为非必选字段。 |
bm dump-overlay -b <bundleName> -t <target-moduleName> | 根据指定的包名和目标module名查询OverlayModuleInfo信息。-t为非必选字段。 |
bm dump-overlay -b <bundleName> -t <target-moduleName> -u <userId> | 根据指定的包名、目标module名和用户查询OverlayModuleInfo信息。-u为非必选字段,默认为当前活跃用户。 |
示例:
# 根据包名来获取overlay应用com.ohos.app中的所有OverlayModuleInfo信息
bm dump-overlay -b com.ohos.app
# 根据包名和module来获取overlay应用com.ohos.app中overlay module为entry的所有OverlayModuleInfo信息
bm dump-overlay -b com.ohos.app -m entry
# 根据包名和module来获取overlay应用com.ohos.app中目标module为feature的所有OverlayModuleInfo信息
bm dump-overlay -b com.ohos.app -m feature
查询应用的overlay相关信息命令
查询目标应用的所有关联overlay应用的overlayModuleInfo信息。
bm dump-target-overlay [-h] [-b bundleName] [-m moduleName] [-u userId]
表16 dump-overlay命令列表
命令 | 描述 |
---|---|
bm dump-target-overlay -h | 显示dump-target-overlay支持的命令信息。-h为非必选字段。 |
bm dump-target-overlay -b <bundleName> | 获取指定目标应用的所有OverlayBundleInfo信息。-b为必选字段。 |
bm dump-target-overlay -b <bundleName> -m <moduleName> | 根据指定的目标应用的包名和module名查询OverlayModuleInfo信息。-m为非必选字段。 |
bm dump-target-overlay -b <bundleName> -m <moduleName> -u <userId> | 根据指定的目标应用的包名、module名和用户查询OverlayModuleInfo信息。-u为非必选字段,默认为当前活跃用户。 |
示例:
# 根据包名来获取目标应用com.ohos.app中的所有关联的OverlayBundleInfo信息
bm dump-target-overlay-b com.ohos.app
# 根据包名和module来获取目标应用com.ohos.app中目标module为entry的所有关联的OverlayModuleInfo信息
bm dump-target-overlay -b com.ohos.app -m entry
bm工具错误码
9568320 签名文件不存在
错误信息
Failed to install bundle, no signature file.
错误描述
用户安装未签名的HAP包。
可能原因
HAP包未经签名认证。
处理步骤
- 使用自动签名。在连接设备后,重新为应用进行签名。
-
如果使用的是手动签名,对于HarmonyOS应用
9568347 解析本地so文件失败
错误信息
Error: install parse native so failed.
错误描述
在启动调试或运行C++应用/服务时,安装HAP包出现错误,提示“error: install parse native so failed”错误信息。
可能原因
设备支持的Abi类型与C++工程中配置的Abi类型不匹配。
处理步骤
- 将设备与DevEco Studio进行连接。
- 打开命令行工具,并进入SDK安装目录下的toolchains{版本号}目录下。
若不清楚HarmonyOS SDK安装目录,可单击File > Settings > SDK界面查看安装路径。
- 执行如下命令,查询设备支持的Abi列表,返回结果为default/armeabi-v7a/armeabi/arm64-v8a/x86/x86_64中的一个或多个Abi类型。
hdc shell param get const.product.cpu.abilist
- 根据查询返回结果,检查模块级build-profile.json5文件中的“abiFilters”参数中的配置,规则如下:
- 若返回结果为default,请执行如下命令,查询是否存在lib64文件夹。
cd /system/ ls
- 存在lib64文件夹:则“abiFilters”参数中需要包含arm64-v8a类型。
- 不存在lib64文件夹:则“abiFilters”参数中需要至少包含armeabi/armeabi-v7a中的一个类型。
-
若返回结果为armeabi-v7a/armeabi/arm64-v8a/x86/x86_64中的一个或多个,需要在“abiFilters”参数中至少包含返回结果中的一个Abi类型。
- 若返回结果为default,请执行如下命令,查询是否存在lib64文件夹。
9568344 解析配置文件失败
错误信息
Error: install parse profile prop check error.
错误描述
在启动调试或运行应用/服务时,安装HAP出现错误,提示“error: install parse profile prop check error”错误信息。
可能原因
应用使用了应用特权,但应用的签名文件发生变化后未将新的签名指纹重新配置到设备的特权管控白名单文件install_list_capability.json中。
处理步骤
-
获取新的签名指纹。
a. 在项目级build-profile.json5文件中,signingConfigs字段内的profile的值即为签名文件的存储路径。
b. 打开该签名文件(后缀为.p7b),打开后在文件内搜索“development-certificate”,将“-----BEGIN CERTIFICATE-----”和“-----END CERTIFICATE-----”以及中间的信息拷贝到新的文本中,注意换行并去掉换行符,保存为一个新的.cer文件,如命名为xxx.cer。
新的.cer文件格式如下图(仅作为格式示意,内容以实际为准):
c. 使用keytool工具(在DevEco Studio安装目录下的jbr/bin文件夹内),执行如下命令通过.cer文件获取证书指纹的SHA256值。
keytool -printcert -file xxx.cer
d. 将证书指纹中SHA256的内容去掉冒号,即为最终要获得的签名指纹。
如SHA256值为下图(仅作为格式示意,内容以实际为准):
去掉冒号后的签名指纹为:5753DDBC1A8EF88A62058A9FC4B6AFAFC1C5D8D1A1B86FB3532739B625F8F3DB
-
获取设备的特权管控白名单文件install_list_capability.json。
a. 连接设备。
b. 执行如下命令查看设备的特权管控白名单文件install_list_capability.json。
find /system -name install_list_capability.json
设备上install_list_capability.json的位置通常为以下目录地址,通过bundleName找到对应的配置文件:
/system/etc/app/install_list_capability.json
c. 执行如下命令拉取install_list_capability.json。
hdc shell mount -o rw,remount / hdc file recv /system/etc/app/install_list_capability.json
-
将步骤1获取到的签名指纹配置到install_list_capability.json文件的app_signature中,注意要配置到对应的bundleName下。
-
将修改后的install_list_capability.json文件重新推到设备上,并重启设备。
hdc shell mount -o rw,remount / hdc file send install_list_capability.json /system/etc/app/install_list_capability.json hdc shell chmod 644 /system/etc/app/install_list_capability.json hdc shell reboot
-
设备重启后,重新安装新的应用即可。
9568305 依赖的模块不存在
错误信息
Error: dependent module does not exist.
错误描述
在启动调试或运行应用/服务时,安装HAP出现错误,提示“error: dependent module does not exist”错误信息。
可能原因
运行/调试的应用依赖的动态共享包(SharedLibrary)模块未安装导致安装报错。
处理步骤
-
先安装依赖的动态共享包(SharedLibrary)模块,再在应用运行配置页勾选Keep Application Data,点击OK保存配置,再运行/调试。
-
在运行配置页,选择Deploy Multi Hap标签页,勾选Deploy Multi Hap Packages,选择依赖的模块,点击OK保存配置,再进行运行/调试。
9568259 安装解析配置文件缺少字段
错误信息
Error: install parse profile missing prop.
错误描述
在启动调试或运行应用/服务时,安装HAP出现错误,提示“error: install parse profile missing prop”错误信息。
可能原因
配置文件app.json5和module.json5中必填字段缺失。
处理步骤
-
方法1:请参考app.json5配置文件和module.json5配置文件查看并补充必填字段。
-
方法2:通过hilog日志判断缺失字段。
开启落盘命令:
hilog -w start
落盘位置:/data/log/hilog
打开日志查看“profile prop %{public}s is mission”。如“profile prop icon is mission”表示“icon”字段缺失。
9568258 安装应用的releaseType与已安装应用的releaseType不相同
错误信息
Error: install releaseType target not same.
错误描述
在启动调试或运行应用/服务时,安装HAP出现错误,提示“error: install releaseType target not same”错误信息。
可能原因
设备上已安装的旧HAP和现在要安装的新HAP所使用的SDK中的releaseType值不一样。
处理步骤
- 请先卸载设备上已安装的HAP,再安装新的HAP。
9568322 由于应用来源不可信,签名验证失败
错误信息
Error: signature verification failed due to not trusted app source.
错误描述
在启动调试或运行应用/服务时,安装HAP出现错误,提示“error: signature verification failed due to not trusted app source”错误信息。
可能原因
-
场景一:签名中未包含该调试设备的UDID。
-
场景二:签名时使用了发布证书和发布profile文件。发布证书签名的应用不能启动调试或运行。
处理步骤
-
场景一:
- 使用自动签名。在连接设备后,重新为应用进行签名。
- 如果使用的是手动签名,对于HarmonyOS应用,在UnsgnedDebugProfileTemplate.json文件中添加该调试设备的UDID
//UDID获取命令 hdc shell bm get -u
-
场景二:使用调试证书和调试profile文件重新签名应用。
9568289 权限请求失败导致安装失败
错误信息
Error: install failed due to grant request permissions failed.
错误描述
在启动调试或运行应用/服务时,安装HAP出现错误,提示“error: install failed due to grant request permissions failed”错误信息。
可能原因
默认应用等级为normal,只能使用normal等级的权限,如果使用了system_basic或system_core等级的权限,将导致报错。
处理步骤
- 在UnsgnedDebugProfileTemplate.json文件中修改apl等级,调整成system_basic或system_core等级,重新签名打包即可。
9568297 由于设备sdk版本较低导致安装失败
错误信息
Error: install failed due to older sdk version in the device.
错误描述
在启动调试或运行应用/服务时,安装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。
9568332 签名不一致导致安装失败
错误信息
Error: install sign info inconsistent.
错误描述
在启动调试或运行应用/服务时,安装HAP出现错误,提示“error: install sign info inconsistent”错误信息。
可能原因
设备上已安装的应用与新安装的应用中签名不一致。如果在Edit Configurations中勾选了“Keep Application Data”(不卸载应用,覆盖安装),并且重新进行了签名,将导致该报错。
处理步骤
- 请卸载设备上已安装的应用,或取消勾选“Keep Application Data”后,重新安装新的应用。
9568329 签名信息验证失败
错误信息
Error: verify signature failed.
错误描述
签名信息中的包名与应用的包名(bundleName)不一致。
可能原因
-
场景一:用户导入了三方提供的HSP模块,且该HSP既非集成态HSP,又非同包名的HSP,造成包名不一致。
-
场景二:用户使用了错误的签名文件(后缀为.p7b)进行签名,造成包名不一致。
处理步骤
-
场景一:HSP只能给同包名的应用使用,只有集成态HSP可以给不同包名的应用使用。需要用户与三方开发者确认,三方开发者应提供集成态HSP、或同包名的HSP给用户使用。
-
场景二:检查签名流程和签名证书。
9568266 安装权限拒绝
错误信息
Error: install permission denied.
错误描述
使用hdc install安装HAP时出现错误,提示“code:9568266 error: install permission denied”错误信息。
可能原因
hdc install不能安装release签名的企业应用。
处理步骤
- 请使用hdc install指令安装调试debug签名的企业应用。
9568337 安装解析失败
错误信息
Error: install parse unexpected.
错误描述
应用推送到设备安装时,报错包管理打开hap文件失败。
可能原因
-
场景一:设备system分区存储空间已满,导致hdc file send文件后,因存储空间不足导致设备中文件损坏。
-
场景二:推送hap包到设备过程hap包损坏。
处理步骤
-
场景一:查看设备system分许存储空间,若已满,清理存储满足安装所需空间。
hdc shell param get const.ohos.apiversion
-
场景二:查看本地hap与推送到设备上hap的md5值,若不一致则表示推送过程hap损毁,请尝试重传。
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权限等级。
处理步骤
- 检查应用定义的proxyData内容是否符合要求。
9568315 数据代理URI错误
错误信息
Error: uri in proxy data is wrong.
错误描述
proxyData标签uri属性验证失败。
可能原因
用户工程module.json中,proxyData标签uri属性验证失败,不满足uri格式要求。
处理步骤
- 检查应用定义的proxyData内容是否符合要求。
9568336 应用调试类型与已安装应用不一致
错误信息
Error: install debug type not same.
错误描述
应用调试类型(app.json的debug字段)与已安装应用不一致。
可能原因
开发者使用IDE的debug按钮安装了应用,后面打包之后又通过hdc install方式安装。
处理步骤
- 卸载已安装的应用,重新安装新应用。
9568296 包类型错误
错误信息
Error: install failed due to error bundle type.
错误描述
bundleType错误导致应用安装失败。
可能原因
新安装应用的bundleType与已安装的有相同bundleName应用不一致。
处理步骤
-
方法一:卸载已安装的应用,重新安装新应用。
-
方法二:修改应用的bundleType,与已安装应用保持一致。
9568292 UserID为0的用户只能安装singleton应用
错误信息
Error: install failed due to zero user can only install singleton app.
错误描述
UserID 0用户只允许安装singleton权限应用,singleton权限应用只允许被UserID 0用户安装。
可能原因
singleton权限应用安装未指定UserID 0。
处理步骤
- 应用是singleton权限,安装时指定UserID 0。
//指定userId安装命令 hdc install -p hap名.hap -u 0
9568263 无法降级安装
错误信息
Error: install version downgrade.
错误描述
正在安装应用的VersionCode小于系统中已安装应用的VersionCode,安装失败。
可能原因
正在安装应用的VersionCode小于系统中已安装应用的VersionCode。
处理步骤
- 卸载已安装的应用,重新安装新应用。
9568304 应用不支持当前设备类型
错误信息
Error: device type is not supported.
错误描述
正在安装的应用不支持当前设备类型,安装失败。
可能原因
正在安装的应用不支持当前设备类型。
处理步骤
- 如需要适配当前设备,请在应用设备类型配置中增加当前设备类型。应用deviceTypes配置包含phone(手机)、tablet(平板)、2in1(2合1设备)、tv(智慧屏)、wearable(智能手表)和car(车机)。
9568317 应用的多进程配置与系统配置不匹配
错误信息
Error: isolationMode does not match the system.
错误描述
安装应用时,设置的isolationMode与系统配置项允许的系统配置不匹配。
可能原因
-
场景一:设备支持隔离模式,即persist.bms.supportIsolationMode为true时,HAP配置的isolationMode为nonisolationOnly。
-
场景二:设备不支持隔离模式,即persist.bms.supportIsolationMode为false时,HAP配置的isolationMode为isolationOnly。
处理步骤
- 按照设备的隔离模式配置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]
9568315 数据代理的uri属性错误
错误信息
Error: uri in proxy data is wrong.
错误描述
应用module.json文件中proxyData标签的uri属性验证失败。
可能原因
uri不满足格式规范。
处理步骤
- 确认uri满足格式规范。
//uri格式规范 不同数据代理的uri不可重复,且需要满足datashareproxy://当前应用包名/xxx的格式
9568310 兼容策略不同
错误信息
Error: compatible policy not same.
错误描述
新包与已安装包兼容策略不同。
可能原因
设备中已安装相同包名的hap包。
处理步骤
- 卸载已安装相同包名hap包,再安装新包。
9568391 包管理服务已停止
错误信息
Error: bundle manager service is died.
错误描述
包管理服务已停止。
可能原因
使用bm install -p ***.hap方式安装预置应用会杀掉正在运行的应用,导致异常(例如foundation进程重启)。
处理步骤
- 预置应用请参考OTA升级。
9568393 验证代码签名失败
错误信息
Error: verify code signature failed.
错误描述
验证代码签名失败。
可能原因
-
场景一:包没有代码签名信息。
-
场景二:签名证书问题。
处理步骤
-
场景一:使用SDK签名工具验证包是否签名。
//验证签名指令 java -jar SDK安装路径(DevEco工具安装目录中sdk)\toolchains\lib\hap-sign-tool.jar verify-app -outCertChain out.cer -outProfile out.p7b -inFile 包路径\**.hap // 执行结果1:can not find codesign block。说明包没有签名 // 执行结果2:verify codesign success。说明包已签名
-
场景二:检查签名流程和签名证书