1# bm工具 2<!--Kit: Ability Kit--> 3<!--Subsystem: BundleManager--> 4<!--Owner: @wanghang904--> 5<!--Designer: @hanfeng6--> 6<!--Tester: @kongjing2--> 7<!--Adviser: @Brilliantry_Rui--> 8 9Bundle Manager（包管理工具，简称bm）是实现应用安装、卸载、更新、查询等功能的工具，bm为开发者提供基本的应用安装包的调试能力。 10 11## 环境要求（hdc工具） 12 13在使用本工具前，开发者需要先获取[hdc工具](../dfx/hdc.md#环境准备)，执行hdc shell。 14 15## bm工具命令列表 16 17| 命令 | 描述 | 18| -------- | -------- | 19| help | 帮助命令，用于查询bm支持的命令信息。 | 20| install | 安装命令，用于安装应用。 | 21| uninstall | 卸载命令，用于卸载应用。 | 22| dump | 查询命令，用于查询应用的相关信息。 | 23| clean | 清理命令，用于清理应用的缓存和数据。<!--Del-->此命令在root版本下可用，<!--DelEnd-->在user版本下打开开发者模式可用。| 24| <!--DelRow-->enable | 使能命令，用于使能应用，使能后应用可以继续使用。此命令在root版本下可用，在user版本下不可用。 | 25| <!--DelRow-->disable | 禁用命令，用于禁用应用，禁用后应用无法使用。此命令在root版本下可用，在user版本下不可用。 | 26| get | 获取udid命令，用于获取设备的udid。 | 27| quickfix | 快速修复相关命令，用于执行补丁相关操作，如补丁安装、补丁查询。 | 28| compile | 应用执行编译AOT命令。 | 29| copy-ap | 把应用的ap文件拷贝到/data/local/pgo目录下，供shell用户读取文件。 | 30| dump-dependencies | 查询应用依赖的模块信息。 | 31| dump-shared | 查询应用间HSP应用信息。 | 32| dump-overlay | 打印overlay应用的overlayModuleInfo。 | 33| dump-target-overlay | 打印目标应用的所有关联overlay应用的overlayModuleInfo。 | 34| install-plugin | 安装插件命令，用于安装插件。| 35| uninstall-plugin | 卸载插件命令，用于卸载插件。| 36 37 38## 帮助命令（help） 39 40```bash 41# 显示帮助信息 42bm help 43``` 44## 参数说明 45 46### userId 47 48表示当前系统账号的编号，系统账号的相关接口请参考[系统账号管理模块](../reference/apis-basic-services-kit/js-apis-osAccount.md)，下面给出几种常见的系统账号。 49 50- userId = 100，表示编号为100的系统账号，系统默认账号，在设备出厂首次启动时由系统账号管理模块创建，且创建完成后会在100账号下安装所有的预置应用。 51 52- userId = 102，表示编号为102的系统账号，由系统账号管理模块创建，<!--Del-->可以使用[createOsAccountForDomain接口](../reference/apis-basic-services-kit/js-apis-osAccount-sys.md)创建账号，<!--DelEnd-->仅支持系统应用创建账号。在100账号下安装的应用，在102账号下不会显示，如有需求，需要在102账号下重新安装。在创建102账号过程中，系统会在102账号下安装预置系统应用。 53 54- userId = 0，表示共有系统账号，也叫账号0，该共有系统账号和系统账号编号不同，不是系统账号管理模块创建的。在账号0下安装的应用，所有系统账号共享，会在每个系统账号下都会显示。所有三方应用都不能安装到账号0下。 55 56 57## 安装命令（install） 58 59```bash 60bm install [-h] [-p filePath] [-r] [-w waitingTime] [-s hspDirPath] [-u userId] 61``` 62 63 **安装命令参数列表** 64 65 66| 参数 | 参数说明 | 67| -------- | -------- | 68| -h | 帮助信息。 | 69| -p | 可选参数，指定HAP路径，多HAP应用可指定多HAP所在文件夹路径。 | 70| -r | 可选参数，覆盖安装一个HAP。默认值为覆盖安装。 | 71| -s | 根据场景判断，安装应用间HSP时为必选参数，其他场景为可选参数。安装应用间共享库， 每个路径目录下只能存在一个同包名的HSP。 | 72| -w | 可选参数，安装HAP时指定bm工具等待时间，最小的等待时长为5s，最大的等待时长为600s, 默认缺省为180s。 | 73| -u | 可选参数，指定[用户](#userid)，默认在当前活跃用户下安装应用。仅支持在当前活跃用户或0用户下安装。<br>**说明：**<br> 如果当前活跃用户是100，使用命令`bm install -p /data/local/tmp/ohos.app.hap -u 102`安装时，只会在当前活跃用户100下安装应用。 | 74 75 76示例： 77```bash 78# 安装一个hap 79bm install -p /data/local/tmp/ohos.app.hap 80# 在100用户下安装一个hap 81bm install -p /data/local/tmp/ohos.app.hap -u 100 82# 覆盖安装一个hap 83bm install -p /data/local/tmp/ohos.app.hap -r 84# 安装一个应用间共享库 85bm install -s xxx.hsp 86# 同时安装使用方应用和其依赖的应用间共享库 87bm install -p aaa.hap -s xxx.hsp yyy.hsp 88# 同时安装HAP和应用内共享库 89bm install -p /data/local/tmp/hapPath/ 90# 安装一个hap,等待时间为180s 91bm install -p /data/local/tmp/ohos.app.hap -w 180 92``` 93 94## 卸载命令（uninstall） 95 96```bash 97bm uninstall [-h] [-n bundleName] [-m moduleName] [-k] [-s] [-v versionCode] [-u userId] 98``` 99 100 **卸载命令参数列表** 101 102| 参数 | 参数说明 | 103| -------- | -------- | 104| -h | 帮助信息。 | 105| -n | 必选参数，指定Bundle名称卸载应用。| 106| -m | 可选参数，应用模块名称，指定卸载应用的一个模块。默认卸载所有模块。 | 107| -k | 可选参数，卸载应用时保存应用数据。默认卸载应用时不保存应用数据。 | 108| -s | 根据场景判断，卸载应用间HSP时必选参数，其他场景为可选参数。卸载指定的共享库。| 109| -v | 可选参数，指定共享包的版本号。默认卸载同包名的所有共享包。 | 110| -u | 可选参数，指定[用户](#userid)，默认在当前活跃用户下卸载应用。仅支持在当前活跃用户或0用户下卸载应用。<br>**说明：**<br> 如果当前活跃用户是100，使用命令`bm uninstall -n com.ohos.app -u 102`卸载时，只会在当前活跃用户100下卸载应用。 | 111 112 113示例： 114 115```bash 116# 卸载一个应用 117bm uninstall -n com.ohos.app 118# 在用户100下卸载一个应用 119bm uninstall -n com.ohos.app -u 100 120# 卸载应用的一个模块 121bm uninstall -n com.ohos.app -m entry 122# 卸载一个shared bundle 123bm uninstall -n com.ohos.example -s 124# 卸载一个shared bundle的指定版本 125bm uninstall -n com.ohos.example -s -v 100001 126# 卸载一个应用，并保留用户数据 127bm uninstall -n com.ohos.app -k 128``` 129 130 131## 查询应用信息命令（dump） 132 133```bash 134bm dump [-h] [-a] [-g] [-n bundleName] [-s shortcutInfo] [-d deviceId] [-l label] [-u userId] 135``` 136 137 **查询命令参数列表** 138 139| 参数 | 参数说明 | 140| -------- | -------- | 141| -h | 帮助信息。 | 142| -a | 可选参数，查询系统已经安装的所有应用。 | 143| -g | 可选参数，查询系统中签名为调试类型的应用包名。 | 144| -n | 可选参数，查询指定Bundle名称的详细信息。 | 145| -s | 可选参数，查询指定Bundle名称下的快捷方式信息。 | 146| -d | 可选参数，查询指定设备中的包信息。默认查询当前设备。 | 147| -l | 可选参数，用于查询指定Bundle名称的label值（应用的名称），需要与`-n`或`-a`参数组合使用。<br/>**说明**：<br/>从API version 20开始支持该命令。如果在Windows环境下输出结果包含特殊字符或中文乱码，需在cmd控制台中手动执行命令`chcp 65001`，将cmd控制台编码修改为UTF-8。 | 148| -u | 可选参数，查询指定[用户](#userid)下的应用信息，默认在当前活跃用户下查询应用信息。仅支持在当前活跃用户或0用户下查询。<br>**说明：**<br> 如果当前活跃用户是100，使用命令`bm dump -n com.ohos.app -u 102`查询时，只会在当前活跃用户100下查询应用。 | 149 150 151示例： 152 153```bash 154# 显示所有已安装的Bundle名称 155bm dump -a 156# 查询系统中签名为调试类型的应用包名 157bm dump -g 158# 查询该应用的详细信息 159bm dump -n com.ohos.app 160# 在用户100下查询该应用的详细信息 161bm dump -n com.ohos.app -u 100 162# 查询该应用的快捷方式信息 163bm dump -s -n com.ohos.app 164# 查询跨设备应用信息 165bm dump -n com.ohos.app -d xxxxx 166# 查询该应用的label值（应用的名称） 167bm dump -n com.ohos.app -l 168# 显示所有已安装应用的bundle名称和label值（应用的名称） 169bm dump -a -l 170``` 171 172## 清理命令（clean） 173 174```bash 175bm clean [-h] [-c] [-n bundleName] [-d] [-i appIndex] [-u userId] 176``` 177**清理命令参数列表** 178 179| 参数 | 参数说明 | 180| -------- | --------- | 181| -h | 帮助信息。 | 182| -c -n | -n为必选参数，-c为可选参数。清除指定Bundle名称的缓存数据。 | 183| -d -n | -n为必选参数，-d为可选参数。清除指定Bundle名称的数据目录。 | 184| -i | 可选参数，清除分身应用的数据目录。默认为0。| 185| -u | 可选参数，清理指定[用户](#userid)下的数据，默认在当前活跃用户下清理数据。仅支持在当前活跃用户或0用户下清理数据。<br>**说明：**<br> 如果当前活跃用户是100，使用命令`bm clean -c -n com.ohos.app -u 102`清理数据时，只会在当前活跃用户100下清理。 | 186 187 188示例： 189 190```bash 191# 清理该应用下的缓存数据 192bm clean -c -n com.ohos.app 193# 在用户100下清理该应用下的缓存数据 194bm clean -c -n com.ohos.app -u 100 195# 清理该应用下的用户数据 196bm clean -d -n com.ohos.app 197# 执行结果 198clean bundle data files successfully. 199``` 200 201<!--Del--> 202## 使能命令（enable） 203 204```bash 205bm enable [-h] [-n bundleName] [-a abilityName] [-u userId] 206``` 207 208 209 **使能命令参数列表** 210 211| 参数 | 参数说明 | 212| -------- | -------- | 213| -h | 帮助信息。 | 214| -n | 必选参数，使能指定Bundle名称的应用。 | 215| -a | 可选参数，使能指定Bundle名称下的元能力模块。 | 216| -u | 可选参数，使能指定[用户](#userid)下的应用，默认在当前活跃用户下使能应用。仅支持在当前活跃用户或0用户下使能应用。<br>**说明：**<br> 如果当前活跃用户是100，使用命令`bm enable -n com.ohos.app -u 102`使能应用时，只会在当前活跃用户100下使能应用。 | 217 218 219示例： 220 221```bash 222# 使能该应用 223bm enable -n com.ohos.app -a com.ohos.app.EntryAbility 224# 在用户100下使能该应用 225bm enable -n com.ohos.app -u 100 226# 执行结果 227enable bundle successfully. 228``` 229 230 231## 禁用命令（disable） 232 233```bash 234bm disable [-h] [-n bundleName] [-a abilityName] [-u userId] 235``` 236 237 238 **禁用命令参数列表** 239 240| 参数 | 参数说明 | 241| -------- | -------- | 242| -h | 帮助信息。 | 243| -n | 必选参数，禁用指定Bundle名称的应用。 | 244| -a | 可选参数，禁用指定Bundle名称下的元能力模块。 | 245| -u | 可选参数，禁用指定[用户](#userid)下的应用，默认在当前活跃用户下禁用应用。仅支持在当前活跃用户或0用户下禁用应用。<br>**说明：**<br> 如果当前活跃用户是100，使用命令`bm disable -n com.ohos.app -u 102`禁用应用时，只会在当前活跃用户100下禁用应用。 | 246 247 248示例： 249 250```bash 251# 禁用该应用 252bm disable -n com.ohos.app -a com.ohos.app.EntryAbility 253# 在用户100下禁用该应用 254bm disable -n com.ohos.app -u 100 255# 执行结果 256disable bundle successfully. 257``` 258<!--DelEnd--> 259 260 261## 获取udid命令（get） 262 263```bash 264bm get [-h] [-u] 265``` 266 267 **获取udid命令参数列表** 268 269| 参数 | 参数说明 | 270| -------- | -------- | 271| -h |帮助信息。 | 272| -u | 必选参数，获取设备的udid。| 273 274 275示例： 276 277```bash 278# 获取设备的udid 279bm get -u 280# 执行结果 281udid of current device is : 28223CADE0C 283``` 284 285 286## 快速修复命令（quickfix） 287 288```bash 289bm quickfix [-h] [-a -f filePath [-t targetPath] [-d] [-o]] [-q -b bundleName] [-r -b bundleName] 290``` 291 292注：hqf文件制作方式可参考[HQF打包指令](packing-tool.md#hqf打包指令)。 293 294 **快速修复命令参数列表** 295| 参数 | 参数说明 | 296| -------- | -------- | 297| -h | 帮助信息。 | 298| -a -f | -a为可选参数，指定-a后，-f为必选参数。执行快速修复补丁安装命令，file-path对应hqf文件，支持传递1个或多个hqf文件，或传递hqf文件所在的目录。 | 299| -q -b | -q为可选参数，指定-q后，-b为必选参数。根据包名查询补丁信息。 | 300| -r -b | -r为可选参数，指定-r后，-b为必选参数。根据包名卸载未使能的补丁。| 301| -t | 可选参数，快速修复应用到指定目标路径。| 302| -d | 可选参数，应用快速修复调试模式。| 303| -o | 可选参数，应用快速修复覆盖模式，该模式下so将被解压覆盖到应用的so目录中。| 304 305 306 307示例： 308 309```bash 310# 根据包名查询补丁包信息 311bm quickfix -q -b com.ohos.app 312# 执行结果 313# Information as follows: 314# ApplicationQuickFixInfo: 315# bundle name: com.ohos.app 316# bundle version code: xxx 317# bundle version name: xxx 318# patch version code: x 319# patch version name: 320# cpu abi: 321# native library path: 322# type: 323 324# 快速修复补丁安装 325bm quickfix -a -f /data/app/ 326# 执行结果 327apply quickfix succeed. 328# 快速修复补丁卸载 329bm quickfix -r -b com.ohos.app 330# 执行结果 331delete quick fix successfully 332``` 333 334## 共享库查询命令（dump-shared） 335 336```bash 337bm dump-shared [-h] [-a] [-n bundleName] [-m moduleName] 338``` 339 340 **共享库查询命令参数列表** 341 342| 参数 | 参数说明 | 343| -------- | -------- | 344| -h | 帮助信息。 | 345| -a | 可选参数，查询系统中所有已安装的共享库。| 346| -n | 可选参数，查询指定包名的共享库详细信息。| 347| -m | 可选参数，查询指定模块名的共享库详细信息。| 348 349 350示例： 351 352```bash 353# 显示所有已安装共享库包名 354bm dump-shared -a 355# 显示该共享库的详细信息 356bm dump-shared -n com.ohos.lib 357# 显示指定应用指定模块依赖的共享库信息 358bm dump-dependencies -n com.ohos.app -m entry 359``` 360 361## 共享库依赖关系查询命令（dump-dependencies） 362 363```bash 364bm dump-dependencies [-h] [-n bundleName] [-m moduleName] 365``` 366 367**共享库依赖关系查询命令参数列表** 368| 参数 | 参数说明 | 369| -------- | -------- | 370| -h | 帮助信息。 | 371| -n | 必选参数，查询指定应用依赖的共享库信息。| 372| -m | 可选参数，查询指定应用指定模块依赖的共享库信息。| 373 374示例： 375```Bash 376# 查询指定应用指定模块依赖的共享库信息 377bm dump-dependencies -n com.ohos.app -m entry 378``` 379 380 381## 应用执行编译AOT命令（compile） 382 383```bash 384bm compile [-h] [-m mode] [-r bundleName] [-a] 385``` 386**compile命令参数列表** 387 388| 参数 | 参数说明 | 389| -------- | -------- | 390| -h | 帮助信息。 | 391| -a | 可选参数，编译所有应用。| 392| -m | 可选参数，可选值为partial或者full。根据包名编译应用。| 393| -r | 可选参数，移除应用的结果。| 394 395示例： 396 397```bash 398# 根据包名编译应用 399bm compile -m partial com.example.myapplication 400``` 401 402## 拷贝ap文件命令（copy-ap） 403 404拷贝ap文件到指定应用的/data/local/pgo路径。 405 406```bash 407bm copy-ap [-h] [-a] [-n bundleName] 408``` 409 410**copy-ap命令参数列表** 411 412| 参数 | 参数说明 | 413| -------- | -------- | 414| -h | 帮助信息。 | 415| -a | 可选参数，默认所有包相关ap文件。拷贝所有包相关ap文件。| 416| -n | 可选参数，默认当前应用包名。根据包名拷贝对应包相关的ap文件。| 417 418示例： 419 420```bash 421# 根据包名移动对应包相关的ap文件 422bm copy-ap -n com.example.myapplication 423``` 424 425## 查询overlay应用信息命令（dump-overlay） 426 427```bash 428bm dump-overlay [-h] [-b bundleName] [-m moduleName] [-u userId] 429``` 430 431**dump-overlay命令参数列表** 432| 参数 | 参数说明 | 433| -------- | -------- | 434| -h | 帮助信息。 | 435| -b | 必选参数，获取指定Overlay应用的所有OverlayModuleInfo信息。| 436| -m | 可选参数，默认当前Overlay应用主模块名。根据指定Overlay应用的包名和module名查询OverlayModuleInfo信息。| 437| -u | 可选参数，在指定[用户](#userid)下查询OverlayModuleInfo信息，默认在当前活跃用户下查询。仅支持在当前活跃用户或0用户下查询。<br>**说明：**<br> 如果当前活跃用户是100，使用命令`bm dump-overlay -b com.ohos.app -u 102`查询OverlayModuleInfo信息，只会返回当前活跃用户100下的OverlayModuleInfo信息。 | 438 439示例： 440 441```bash 442# 根据包名来获取overlay应用com.ohos.app中的所有OverlayModuleInfo信息 443bm dump-overlay -b com.ohos.app 444 445# 在用户100下，根据包名来获取overlay应用com.ohos.app中的所有OverlayModuleInfo信息 446bm dump-overlay -b com.ohos.app -u 100 447 448# 根据包名和module来获取overlay应用com.ohos.app中overlay module为entry的所有OverlayModuleInfo信息 449bm dump-overlay -b com.ohos.app -m entry 450 451# 根据包名和module来获取overlay应用com.ohos.app中目标module为feature的所有OverlayModuleInfo信息 452bm dump-overlay -b com.ohos.app -m feature 453``` 454 455## 查询应用的overlay相关信息命令（dump-target-overlay） 456 457查询目标应用的所有关联overlay应用的overlayModuleInfo信息。 458 459```bash 460bm dump-target-overlay [-h] [-b bundleName] [-m moduleName] [-u userId] 461``` 462 463**dump-target-overlay命令参数列表** 464| 参数 | 参数说明 | 465| -------- | -------- | 466| -h | 帮助信息。 | 467| -b | 必选参数，获取指定应用的所有OverlayBundleInfo信息。| 468| -m | 可选参数，默认当前应用主模块名。根据指定的包名和module名查询OverlayModuleInfo信息。| 469| -u | 可选参数，在指定[用户](#userid)下查询OverlayModuleInfo信息，默认在当前活跃用户下查询。仅支持在当前活跃用户或0用户下查询。<br>**说明：**<br> 如果当前活跃用户是100，使用命令`bm dump-target-overlay -b com.ohos.app -u 102`查询目标应用com.ohos.app中的所有关联的OverlayBundleInfo信息，只会返回当前活跃用户100下的OverlayModuleInfo信息。 | 470 471示例： 472 473```bash 474# 根据包名来获取目标应用com.ohos.app中的所有关联的OverlayBundleInfo信息 475bm dump-target-overlay -b com.ohos.app 476 477# 在用户100下，根据包名来获取目标应用com.ohos.app中的所有关联的OverlayBundleInfo信息 478bm dump-target-overlay -b com.ohos.app -u 100 479 480# 根据包名和module来获取目标应用com.ohos.app中目标module为entry的所有关联的OverlayModuleInfo信息 481bm dump-target-overlay -b com.ohos.app -m entry 482``` 483 484## 安装插件命令（install-plugin） 485 486```bash 487bm install-plugin [-h] [-n hostBundleName] [-p filePath] 488``` 489 490**install-plugin命令参数列表** 491| 参数 | 参数说明 | 492| -------- | -------- | 493| -h | 帮助信息。 | 494| -n | 必选参数，指定待安装插件的应用包名。| 495| -p | 必选参数，指定插件文件路径。| 496 497示例： 498 499```bash 500# 安装一个插件 501bm install-plugin -n com.ohos.app -p /data/plugin.hsp 502``` 503> **说明：** 504> 505> 在同一个应用中安装同一个插件，则视作插件版本更新，插件不支持降级安装；插件版本更新后，需要重启应用插件才能生效。 506> 507> 不推荐安装与宿主应用模块同名的插件，目前运行态暂不支持。 508 509 510## 卸载插件命令（uninstall-plugin） 511 512```bash 513bm uninstall-plugin [-h] [-n hostBundleName] [-p pluginBundleName] 514``` 515 516**uninstall-plugin命令参数列表** 517| 参数 | 参数说明 | 518| -------- | -------- | 519| -h | 帮助信息。 | 520| -n | 必选参数，指定应用包名。| 521| -p | 必选参数，指定插件的包名。| 522 523示例： 524 525```bash 526# 卸载一个插件 527bm uninstall-plugin -n com.ohos.app -p com.ohos.plugin 528``` 529 530 531## bm工具错误码 532 533### 301 系统账号不存在 534**错误信息** 535 536error: user not exist. 537 538**错误描述** 539 540系统账号不存在。 541 542**可能原因** 543 544安装应用时，系统账号ID不存在。 545 546**处理步骤** 547 5481. 重启手机后再次尝试安装应用。 549 5502. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 551 552``` 553hdc file recv /data/log/hilog/ 554``` 555 556### 304 当前系统账号没有安装HAP包 557**错误信息** 558 559error: user does not install the hap. 560 561**错误描述** 562 563卸载操作时，当前系统账号没有安装HAP包。 564 565**可能原因** 566 567当前系统账号下未安装任何HAP包。 568 569**处理步骤** 570 571当前系统账号下未安装任何HAP包，请不要执行卸载应用操作。 572 573### 9568319 签名文件异常 574**错误信息** 575 576error: cannot open signature file. 577 578**错误描述** 579 580安装应用过程中，出现签名文件打开异常，导致安装失败。 581 582**可能原因** 583 584HAP包签名文件存在异常。 585 586**处理步骤** 587 5881. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。 5892. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。 590 591### 9568320 签名文件不存在 592**错误信息** 593 594error: no signature file. 595 596**错误描述** 597 598用户安装未签名的HAP包。 599 600**可能原因** 601 602HAP包没有签名。 603 604**处理步骤** 605 6061. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。 6072. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。 608 609### 9568321 签名文件解析失败 610**错误信息** 611 612error: fail to parse signature file. 613 614**错误描述** 615 616用户安装时签名文件解析失败。 617 618**可能原因** 619 620HAP包签名文件存在异常。 621 622**处理步骤** 623 6241. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。 6252. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。 626 627### 9568323 签名摘要验证未通过 628**错误信息** 629 630error: signature verification failed due to not bad digest. 631 632**错误描述** 633 634用户安装时签名验证失败。 635 636**可能原因** 637 638HAP包签名不正确。 639 640**处理步骤** 641 6421. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。 6432. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。 644 645### 9568324 签名完整性校验未通过 646**错误信息** 647 648error: signature verification failed due to out of integrity. 649 650**错误描述** 651 652用户安装时签名验证失败。 653 654**可能原因** 655 656HAP包签名不正确。 657 658**处理步骤** 659 6601. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。 6612. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。 662 663### 9568326 签名公钥存在异常 664**错误信息** 665 666error: signature verification failed due to bad public key. 667 668**错误描述** 669 670用户安装时签名验证失败，签名公钥存在异常。 671 672**可能原因** 673 674HAP包签名不正确。 675 676**处理步骤** 677 6781. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。 6792. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。 680 681### 9568327 签名获取异常 682**错误信息** 683 684error: signature verification failed due to bad bundle signature. 685 686**错误描述** 687 688用户安装时签名验证失败，签名获取异常。 689 690**可能原因** 691 692HAP包签名不正确。 693 694**处理步骤** 695 6961. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。 6972. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。 698 699### 9568328 未找到配置文件区块 700**错误信息** 701 702error: signature verification failed due to no profile block. 703 704**错误描述** 705 706用户安装时签名验证失败，未找到配置文件区块。 707 708**可能原因** 709 710HAP包签名不正确。 711 712**处理步骤** 713 7141. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。 7152. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。 716 717### 9568330 初始化签名源失败 718**错误信息** 719 720error: signature verification failed due to init source failed. 721 722**错误描述** 723 724用户安装时签名验证失败，初始化签名源失败。 725 726**可能原因** 727 728HAP包签名不正确。 729 730**处理步骤** 731 7321. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。 7332. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。 734 735### 9568257 签名文件Pkcs7校验失败 736 737**错误信息** 738 739error: fail to verify pkcs7 file. 740 741**错误描述** 742 743用户安装应用时签名Pkcs7校验失败。 744 745**可能原因** 746 7471. 证书链不完整或不受信任。 7482. 签名算法不匹配。 7493. 数据被篡改或签名文件损坏。 7504. 签名格式不匹配。 7515. 私钥不匹配。 752 753**处理步骤** 754 7551. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。 7562. 使用手动签名，请参考[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。 757 758 759### 9568344 解析配置文件失败 760**错误信息** 761 762error: install parse profile prop check error. 763 764 765 766**错误描述** 767 768在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: install parse profile prop check error”错误信息。 769 770**可能原因** 771 7721. [app.json5配置文件](../quick-start/app-configuration-file.md#配置文件标签)中的bundleName、[module.json5配置文件](../quick-start/module-configuration-file.md#配置文件标签)中name不符合命名规则。 773 774<!--Del--> 7752. [extensionAbilities](../quick-start/module-configuration-file.md#extensionabilities标签)中type字段配置为service或dataShare。 776<!--DelEnd--> 777 778 779**处理步骤** 7801. 根据命名规则调整app.json5配置文件中bundleName、module.json5文件中的name字段。 781<!--Del--> 7822. 若extensionAbilities中type字段配置为service或dataShare，应用需要配置[allowAppUsePrivilegeExtension特权](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)，配置方式如下。 783 784 1. 获取新的签名指纹。 785 786 a. 在工程级build-profile.json5(工程根目录下)文件中，signingConfigs字段内的profile的值即为签名文件的存储路径。 787 788 b. 打开该签名文件（后缀为.p7b），打开后在文件内搜索“development-certificate”，将“-----BEGIN CERTIFICATE-----”和“-----END CERTIFICATE-----”以及中间的信息拷贝到新的文本中，注意换行并去掉换行符，保存为一个新的.cer文件，如命名为xxx.cer。 789 790 新的.cer文件格式如下图（仅作为格式示意，内容以实际为准）： 791 792  793 794 c. 使用keytool工具（在DevEco Studio安装目录下的jbr/bin文件夹内），执行如下命令，通过.cer文件获取证书指纹的SHA256值。 795 ``` 796 keytool -printcert -file xxx.cer 797 ``` 798 d. 将证书指纹中SHA256的内容去掉冒号，即为最终要获得的签名指纹。 799 800 如下图（仅作为格式示意，内容以实际为准）： 801 802  803 804 去掉冒号后的签名指纹为：5753DDBC1A8EF88A62058A9FC4B6AFAFC1C5D8D1A1B86FB3532739B625F8F3DB。 805 806 2. 获取设备的特权管控白名单文件install_list_capability.json。 807 808 a. 连接设备，进入shell。 809 ``` 810 hdc shell 811 ``` 812 b. 执行如下命令查看设备的特权管控白名单文件install_list_capability.json。 813 ``` 814 // 设备中查询白名单文件的位置 815 find /system -name install_list_capability.json 816 ``` 817 c. 执行如下命令拉取install_list_capability.json。 818 ``` 819 hdc target mount 820 hdc file recv /system/etc/app/install_list_capability.json 821 ``` 822 823 3. 将步骤1获取到的签名指纹配置到install_list_capability.json文件的app_signature中，注意要配置到对应的bundleName下。 824  825 4. 将修改后的install_list_capability.json文件重新推到设备上，并重启设备。 826 827 ``` 828 hdc target mount 829 hdc file send install_list_capability.json /system/etc/app/install_list_capability.json 830 hdc shell chmod 644 /system/etc/app/install_list_capability.json 831 hdc shell reboot 832 ``` 833 5. 设备重启后，重新安装新的应用即可。<!--DelEnd--> 834 835 836### 9568305 依赖的模块不存在 837**错误信息** 838 839error: dependent module does not exist. 840 841 842 843**错误描述** 844 845在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: dependent module does not exist”错误信息。 846 847**可能原因** 848 849运行/调试的应用依赖的动态共享包（SharedLibrary）模块未安装导致安装报错。 850 851**处理步骤** 852 8531. 先安装依赖的动态共享包（SharedLibrary）模块，再在应用运行配置页勾选Keep Application Data，点击OK保存配置，再运行/调试。 854 8552. 在运行配置页，选择Deploy Multi Hap标签页，勾选Deploy Multi Hap Packages，选择依赖的模块，点击OK保存配置，再进行运行/调试。 856 8573. 单击Run > Edit Configurations，在General中，勾选Auto Dependencies。点击OK保存配置，再运行/调试。 858 859 860### 9568259 安装解析配置文件缺少字段 861**错误信息** 862 863error: install parse profile missing prop. 864 865 866 867**错误描述** 868 869在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: install parse profile missing prop”错误信息。 870 871**可能原因** 872 873配置文件app.json5和module.json5中必填字段缺失。 874 875**处理步骤** 876 877* 方法1：请参考[app.json5配置文件](../quick-start/app-configuration-file.md)和[module.json5配置文件](../quick-start/module-configuration-file.md)查看并补充必填字段。 878* 方法2：通过hilog日志判断缺失字段。 879 880 开启落盘命令： 881 ``` 882 hilog -w start 883 ``` 884 885 落盘位置：/data/log/hilog。 886 887 打开日志查看“profile prop %{public}s is missing”。如“profile prop icon is missing”表示“icon”字段缺失。 888 889 890### 9568258 安装应用的releaseType与已安装应用的releaseType不相同 891**错误信息** 892 893error: install releaseType target not same. 894 895 896 897**错误描述** 898 899在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: install releaseType target not same”错误信息。 900 901**可能原因** 902 903* 场景一：设备上已安装的旧HAP和现在要安装的新HAP所使用的SDK中的releaseType值不一样。 904* 场景二：安装的应用为多HAP时，每个HAP所使用的SDK中的releaseType值不一致。 905 906**处理步骤** 907 908* 场景一：请先卸载设备上已安装的HAP，再安装新的HAP。 909* 场景二：使用相同版本的SDK对HAP重新打包，保证多HAP的releaseType值一致。 910 911 912### 9568260 安装内部错误 913**错误信息** 914 915error: install internal error. 916 917**错误描述** 918 919安装内部错误。 920 921**可能原因** 922 923安装过程中，内部服务异常。 924 925**处理步骤** 926 927请尝试重启设备后重新安装。 928 929 930### 9568267 entry模块已存在 931**错误信息** 932 933error: install entry already exist. 934 935**错误描述** 936 937待安装应用的entry模块已存在。 938 939**可能原因** 940 941多模块应用安装要求entry模块唯一。由于待安装的模块包和已安装的模块包名称不同，但均为entry类型，违反了entry唯一性，导致安装失败。 942 943**处理步骤** 944 9451. 请先卸载设备上已安装的HAP，再安装新的HAP。 9462. 检查并确保待安装包的entry模块名称与已安装的entry模块名相同，或把待安装模块的类型改为feature后重试。 947 948 949### 9568268 安装状态错误 950**错误信息** 951 952error: install state error. 953 954**错误描述** 955 956应用安装状态更新失败。 957 958**可能原因** 959 960由于上一个应用安装包过大耗时长，应用安装时上一个应用安装任务未结束，导致安装状态更新失败。 961 962**处理步骤** 963 964请等待上一个应用安装完成后再重试。 965 966 967### 9568269 文件路径无效 968**错误信息** 969 970error: install file path invalid. 971 972**错误描述** 973 974安装时传入的安装包路径无效。 975 976**可能原因** 977 9781. 安装包路径不存在，如拼写有误等。 9792. 安装包路径长度超过256字节。 980 981**处理步骤** 982 9831. 检查安装包的路径是否存在且有访问权限。 9842. 检查安装包路径长度不超过256字节。 985 986### 9568322 由于应用来源不可信，签名验证失败 987**错误信息** 988 989error: signature verification failed due to not trusted app source. 990 991 992 993**错误描述** 994 995在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: signature verification failed due to not trusted app source”错误信息。 996 997**可能原因** 998 999<!--RP8--> 1000<!--RP8End-->签名中未包含该调试设备的UDID。 1001 1002 1003 1004**处理步骤** 1005 1006<!--RP9--> 1007<!--RP9End--><!--Del-->1. <!--DelEnd-->使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。在连接设备后，重新为应用进行签名。 1008<!--Del--> 10092. 如果使用的是手动签名，对于OpenHarmony应用，请参考[OpenHarmony应用手动签名](../security/hapsigntool-guidelines.md)，在UnsgnedDebugProfileTemplate.json文件中添加该调试设备的**UDID**。 1010 1011 1. 获取当前设备的UDID。 1012 1013 ``` 1014 //UDID获取命令 1015 hdc shell bm get -u 1016 ``` 1017 1018 2. 打开DevEco Studio安装路径，在sdk目录下找到UnsgnedDebugProfileTemplate.json配置文件。 1019 1020 ``` 1021 DevEco Studio安装路径\sdk\版本号或者default\openharmony\toolchains\lib\ 1022 1023 例如：xxxx\Huawei\DevEco Studio\sdk\HarmonyOS-NEXT-DB1\openharmony\toolchains\lib\ 1024 例如：xxxx\Huawei\DevEco Studio\sdk\default\openharmony\toolchains\lib\ 1025 ``` 1026 1027 3. 在UnsgnedDebugProfileTemplate.json文件的device-ids字段中，添加当前设备的UDID。 1028 10293. 使用文本编辑器打开已签名的HAP，检查签名中是否包含调试设备的UDID，搜索device-ids。 1030<!--DelEnd--> 1031 1032 1033### 9568286 安装应用的签名证书profile文件中的类型与已安装应用的不相同 1034**错误信息** 1035 1036error: install provision type not same. 1037 1038**错误描述** 1039 1040在启动调试或运行应用/服务时，由于安装应用的<!--RP5-->[Profile签名文件](../security/app-provision-structure.md)<!--RP5End-->中的类型与已安装应用的不相同，导致安装HAP出现错误。 1041 1042**可能原因** 1043 1044设备上已安装应用的签名证书profile文件中的类型与待安装应用不一致。 1045 1046**处理步骤** 1047 10481. 确保设备上已安装应用签名证书profile文件中的类型与待安装应用的类型一致，使用相同类型的profile文件签名，再安装新的HAP。 10492. 卸载设备上已安装的应用，再安装新的HAP。 1050 1051 1052### 9568288 磁盘空间不足导致安装失败 1053**错误信息** 1054 1055error: install failed due to insufficient disk memory. 1056 1057**错误描述** 1058 1059应用安装时会新建文件或目录，由于设备存储空间不足，创建文件或目录失败，导致应用安装失败。 1060 1061**可能原因** 1062 1063设备存储空间不足，创建文件或目录失败，导致应用安装失败。 1064 1065**处理步骤** 1066 1067查看设备存储空间并清理，保证满足安装所需空间，再重试安装应用。 1068<!--RP4--> 1069```bash 1070# 查看磁盘空间使用情况 1071hdc shell df -h /system 1072hdc shell df -h /data 1073``` 1074<!--RP4End--> 1075 1076 1077### 9568289 权限请求失败导致安装失败 1078**错误信息** 1079 1080error: install failed due to grant request permissions failed. 1081 1082 1083 1084**错误描述** 1085 1086在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: install failed due to grant request permissions failed”错误信息。 1087 1088**可能原因** 1089 1090默认应用等级为normal，只能使用normal等级的权限，如果使用了system_basic或system_core等级的权限，将导致报错。 1091 1092**处理步骤** 1093 1094根据[ACL签名指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section157591551175916)为应用申请受限ACL权限。 1095 1096 1097### 9568290 更新HAP token失败导致安装失败 1098**错误信息** 1099 1100error: install failed due to update hap token failed. 1101 1102**错误描述** 1103 1104应用安装过程中，更新HAP时，应用token授权失败。 1105 1106**可能原因** 1107 1108应用安装或更新时，调用元能力的更新token接口，接口返回失败。 1109 1110**处理步骤** 1111 11121. 重启手机后再次尝试安装应用。 1113 11142. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 1115 1116``` 1117hdc file recv /data/log/hilog/ 1118``` 1119 1120 1121<!--Del--> 1122### 9568291 singleton不一致导致安装失败 1123**错误信息** 1124 1125error: install failed due to singleton not same. 1126 1127**错误描述** 1128 1129应用更新时，应用已安装的HAP包和更新包app.json5配置文件中singleton配置（从API version 9开始废弃）不一致。 1130 1131**可能原因** 1132 1133应用已安装的HAP包和更新包app.json5配置文件中singleton配置（从API version 9开始废弃）不一致。 1134 1135**处理步骤** 1136 1137方案1：卸载已安装的应用包，再安装新的应用包。 1138 1139方案2：更新包调整singleton配置，与已安装包配置一致，重新打包，再更新应用包。<!--DelEnd--> 1140 1141<!--Del--> 1142### 9568294 应用类别不一致导致的安装失败 1143**错误信息** 1144 1145error: install failed due to apptype not same. 1146 1147**错误描述** 1148 1149应用安装时，应用已安装HAP包和待安装HAP包的签名文件中[app-feature](../security/app-provision-structure.md)配置不一致，导致安装失败。 1150 1151**可能原因** 1152 1153应用已安装HAP包和待安装HAP包包名一致，但签名文件中app-feature配置不一致。 1154 1155**处理步骤** 1156 1157* 方案1：卸载已安装的HAP包，再安装新的HAP包。 1158* 方案2：修改待安装HAP包的签名文件中的app-feature字段，确保与已安装包配置一致，重新打包、签名[应用/元服务签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing)，再重试安装。<!--DelEnd--> 1159 1160### 9568297 由于设备sdk版本较低导致安装失败 1161**错误信息** 1162 1163error: install failed due to older sdk version in the device. 1164 1165 1166 1167**错误描述** 1168 1169在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: install failed due to older sdk version in the device”错误信息。 1170 1171**可能原因** 1172 1173该问题是由于编译打包所使用的SDK版本与设备镜像版本不匹配。 1174 1175**处理步骤** 1176 1177* 场景一：设备上的镜像版本低于编译打包的SDK版本，请更新设备镜像版本。查询设备镜像版本命令： 1178 ``` 1179 hdc shell param get const.ohos.apiversion 1180 ``` 1181 如果镜像提供的api版本为10，且应用编译所使用的SDK版本也为10，仍出现该报错，可能是由于镜像版本较低，未兼容新版本SDK校验规则，请将镜像版本更新为最新版本。 1182 1183* 场景二：对于需要运行在OpenHarmony设备上的应用，请确认runtimeOS已改为OpenHarmony。 1184 1185 1186### 9568300 应用模块名不唯一导致安装失败 1187**错误信息** 1188 1189error: moduleName is not unique. 1190 1191**错误描述** 1192 1193多模块应用安装过程中，由于模块命名冲突，模块唯一性校验失败，导致安装失败。 1194 1195**可能原因** 1196 1197多模块应用安装过程中，存在模块名称冲突。 1198 1199**处理步骤** 1200 1201查看当前应用所有模块名，与各个模块的module.json5中的name进行比较，保证不一致后，重新打包，进行应用安装。 1202 1203 1204 1205### 9568332 签名不一致导致安装失败 1206**错误信息** 1207 1208error: install sign info inconsistent. 1209 1210 1211 1212**错误描述** 1213 1214在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: install sign info inconsistent”错误信息。 1215 1216**可能原因** 1217 12181. 设备上已安装的应用与新安装的应用中签名不一致或者多个包（HAP和HSP）之间的签名存在差异。若两个应用的签名[密钥](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section462703710326)或<!--RP7-->应用[Profile签名文件](../security/app-provision-structure.md)中的app-identifier<!--RP7End-->中至少有一项相同，则认为它们的签名一致。如果在DevEco Studio的“Edit Configurations”中勾选了“Keep Application Data”（即不卸载应用，直接覆盖安装），并且重新进行了签名，将导致该报错。 12192. 如果某个应用被卸载但是保留了数据，那么后面安装相同包名的应用时，需要校验其签名信息的一致性。如果两者签名信息中的[密钥](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section462703710326)和<!--RP7-->应用[Profile签名文件](../security/app-provision-structure.md)中的app-identifier<!--RP7End-->都不一致，则会导致该报错。 1220 1221 1222**处理步骤** 1223 12241. 请卸载设备上已安装的应用，或取消勾选“Keep Application Data”后，重新安装新的应用。 12252. 如果是因不同团队提供的HSP导致签名不一致问题，可以采用[集成态HSP](../quick-start/integrated-hsp.md)的方式统一提供HSP；在多HAP包的情况下，必须确保所有HAP包的签名一致。 12263. 如果某个应用被卸载但是保留了数据，后面安装相同包名但签名信息不一致的应用时，安装失败。如果出现这种情况，则需要把之前已卸载掉的应用重新安装之后，执行不保留数据地卸载，这样相同包名但签名信息不一致的应用才能安装成功。 1227 1228### 9568329 签名信息验证失败 1229**错误信息** 1230 1231error: verify signature failed. 1232 1233 1234 1235**错误描述** 1236 1237签名信息中的包名与应用的包名（bundleName）不一致。 1238 1239**可能原因** 1240 1241* 场景一：用户导入了三方提供的HSP模块，且该HSP既非[集成态HSP](../quick-start/integrated-hsp.md)，又非同包名的HSP，造成包名不一致。 1242 1243* 场景二：用户使用了错误的签名文件（后缀为.p7b）进行签名，造成包名不一致。 1244 1245 1246**处理步骤** 1247 1248* 场景一：HSP只能给同包名的应用使用，只有集成态HSP可以给不同包名的应用使用。需要用户与三方开发者确认，三方开发者应提供集成态HSP、或同包名的HSP给用户使用。 1249 1250* 场景二：检查签名流程和签名证书，参考[应用/元服务签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing)。 1251 1252 1253### 9568266 安装权限拒绝 1254**错误信息** 1255 1256error: install permission denied. 1257 1258 1259 1260**错误描述** 1261 1262使用hdc install安装HAP时出现错误，提示“code:9568266 error: install permission denied”错误信息。 1263 1264**可能原因** 1265 1266hdc install不能安装release签名的企业应用。 1267 1268**处理步骤** 1269 12701. 请使用hdc install指令安装调试debug签名的企业应用。 1271 1272 1273### 9568337 安装解析失败 1274**错误信息** 1275 1276error: install parse unexpected. 1277 1278**错误描述** 1279 1280应用推送到设备安装时，报错包管理打开HAP文件失败。 1281 1282**可能原因** 1283 1284* 场景一：设备存储空间已满，导致hdc file send文件后，因存储空间不足导致设备中文件损坏。 1285 1286* 场景二：推送HAP包到设备过程HAP包损坏。 1287 1288**处理步骤** 1289 1290* 场景一：查看设备存储空间，若已满，清理存储满足安装所需空间。 1291<!--RP4--> 1292 ```bash 1293 hdc shell df -h /system 1294 ``` 1295<!--RP4End--> 1296 1297* 场景二：查看本地HAP与推送到设备上HAP的md5值，若不一致则表示推送过程HAP损毁，请尝试重传。 1298 1299 1300### 9568316 数据代理中APL权限字段描述权限低 1301**错误信息** 1302 1303error: apl of required permission in proxy data is too low. 1304 1305**错误描述** 1306 1307proxyData标签requiredReadPermission和requiredWritePermission属性验证失败。 1308 1309**可能原因** 1310 1311用户工程module.json中，proxyData标签requiredReadPermission和requiredWritePermission属性验证失败，这两个属性要求system_basic或system_core权限等级。 1312 1313**处理步骤** 1314 13151. 检查应用定义的proxyData内容是否符合要求，参考[proxyData标签](../quick-start/module-configuration-file.md#proxydata标签)。 1316 1317 1318### 9568315 数据代理URI错误 1319**错误信息** 1320 1321error: uri in proxy data is wrong. 1322 1323**错误描述** 1324 1325proxyData标签uri属性验证失败。 1326 1327**可能原因** 1328 1329用户工程module.json中，proxyData标签uri属性验证失败，不满足uri格式要求。 1330 1331**处理步骤** 1332 13331. 检查应用定义的proxyData内容是否符合要求，参考[proxyData标签](../quick-start/module-configuration-file.md#proxydata标签)。 1334 1335 1336### 9568336 应用调试类型与已安装应用不一致 1337**错误信息** 1338 1339error: install debug type not same. 1340 1341**错误描述** 1342 1343应用调试类型（app.json的debug字段）与已安装应用不一致。 1344 1345**可能原因** 1346 1347开发者使用DevEco Studio的debug按钮安装了应用，后面打包之后又通过hdc install方式安装。 1348 1349**处理步骤** 1350 13511. 卸载已安装的应用，重新安装新应用。 1352 1353 1354### 9568296 包类型错误 1355**错误信息** 1356 1357error: install failed due to error bundle type. 1358 1359**错误描述** 1360 1361bundleType错误导致应用安装失败。 1362 1363**可能原因** 1364 1365新安装应用的bundleType与已安装的有相同bundleName应用不一致。 1366 1367**处理步骤** 1368 1369* 方法一：卸载已安装的应用，重新安装新应用。 1370 1371* 方法二：修改应用的bundleType，与已安装应用保持一致。 1372 1373 1374### 9568292 UserID为0的用户只能安装singleton应用 1375**错误信息** 1376 1377error: install failed due to zero user can only install singleton app. 1378 1379**错误描述** 1380 1381UserID 0用户只允许安装singleton权限应用。 1382 1383**可能原因** 1384 1385UserID 0用户安装了非singleton权限的应用。 1386 1387**处理步骤** 1388 13891. 应用是非singleton权限的，不需要指定用户，直接安装。 1390 ```bash 1391 hdc shell bm install -p /data/hap名.hap 1392 ``` 1393 1394 1395### 9568263 无法降级安装 1396**错误信息** 1397 1398error: install version downgrade. 1399 1400**错误描述** 1401 1402正在安装应用的VersionCode小于系统中已安装应用的VersionCode，安装失败。 1403 1404**可能原因** 1405 1406正在安装应用的VersionCode小于系统中已安装应用的VersionCode。 1407 1408**处理步骤** 1409 14101. 卸载已安装的应用，重新安装新应用。 1411 1412 1413### 9568301 模块类型不一致 1414**错误信息** 1415 1416error: moduleName is inconsistent. 1417 1418**错误描述** 1419 1420正在安装的模块名称在系统中已经存在，但模块名称不一致，导致安装失败。 1421 1422**可能原因** 1423 1424待安装应用模块名称在系统中已存在，但模块类型不一致，导致安装失败。 1425 1426**处理步骤** 1427 1428检查系统中已安装应用的模块名是否与待安装的模块名重复，若模块名称一致但类型不一致，修改对应模块module.json5中type属性。 1429 1430 1431<!--Del--> 1432### 9568302 应用多个模块singleton不一致导致安装失败 1433**错误信息** 1434 1435error: install failed due to singleton not same. 1436 1437**错误描述** 1438 1439应用多个模块singleton配置（API 9被标记废弃）不一致，导致安装失败。 1440 1441**可能原因** 1442 1443应用多模块安装时，singleton的配置不相同，singleton一致性校验不通过，导致安装失败。 1444 1445**处理步骤** 1446 1447调整所有模块的singleton配置，保持一致后再安装。<!--DelEnd--> 1448 1449 1450### 9568303 企业设备管理禁止安装 1451**错误信息** 1452 1453error: Failed to install the HAP because the installation is forbidden by enterprise device management. 1454 1455**错误描述** 1456 1457存在应用管控策略，安装失败。 1458 1459**可能原因** 1460 1461存在应用管控策略。 1462 1463**处理步骤** 1464 1465由于企业管控，暂无解决方案。请提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 1466 1467 1468### 9568304 应用不支持当前设备类型 1469**错误信息** 1470 1471error: device type is not supported. 1472 1473**错误描述** 1474 1475正在安装的应用不支持当前设备类型，安装失败。 1476 1477**可能原因** 1478 1479正在安装的应用不支持当前设备类型。 1480 1481**处理步骤** 1482 14831. 如需要适配当前设备，请在应用设备类型配置中增加当前设备类型。应用deviceTypes配置包含phone（手机）、tablet（平板）、2in1（2合1设备）、tv（智慧屏）、wearable（智能手表）和car（车机）。 1484 1485 1486### 9568308 应用包类型不一致 1487**错误信息** 1488 1489error: install bundleType not same. 1490 1491**错误描述** 1492 1493应用包类型不一致，导致安装失败。 1494 1495**可能原因** 1496 1497安装多HAP应用时，存在两个模块的bundleType属性不一致。 1498 1499**处理步骤** 1500 1501检查并确保多HAP应用中各模块app.json5的bundleType属性一致。 1502 1503 1504<!--Del--> 1505### 9568309 不允许安装应用间HSP 1506**错误信息** 1507 1508error: Failed to install the HSP due to the lack of required permission. 1509 1510**错误描述** 1511 1512安装应用间HSP时缺少特权，导致安装失败。 1513 1514**可能原因** 1515 1516安装应用间HSP时缺少特权。 1517 1518**处理步骤** 1519 1520检查设备中install_list_capability.json中该应用是否拥有AllowAppShareLibrary权限，该权限配置可参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 1521 1522 1523### 9568311 卸载的应用间HSP不存在 1524**错误信息** 1525 1526error: shared bundle is not exist. 1527 1528**错误描述** 1529 1530卸载应用间HSP时，指定的包不存在，导致卸载失败。 1531 1532**可能原因** 1533 1534卸载应用间HSP时，指定的包不存在。 1535 1536**处理步骤** 1537 1538检查需要卸载的应用间HSP是否存在。 1539``` 1540hdc shell bm dump-shared -n com.xxx.xxx.demo 1541``` 1542 1543 1544### 9568312 卸载的应用间HSP被依赖 1545**错误信息** 1546 1547error: The version of the shared bundle is dependent on other applications. 1548 1549**错误描述** 1550 1551卸载应用间HSP时，指定的包被其他应用依赖，导致卸载失败。 1552 1553**可能原因** 1554 1555卸载应用间HSP时，指定的包被其他应用依赖。 1556 1557**处理步骤** 1558 1559检查需要卸载的应用间HSP是否被其他应用依赖，若存在依赖，请先卸载依赖该HSP的应用。<!--DelEnd--> 1560 1561 1562### 9568317 应用的多进程配置与系统配置不匹配 1563**错误信息** 1564 1565error: isolationMode does not match the system. 1566 1567**错误描述** 1568 1569安装应用时，设置的isolationMode与系统配置项允许的系统配置不匹配。 1570 1571**可能原因** 1572 1573* 场景一：设备支持隔离模式，即persist.bms.supportIsolationMode为true时，HAP配置的isolationMode为nonisolationOnly。 1574 1575* 场景二：设备不支持隔离模式，即persist.bms.supportIsolationMode为false时，HAP配置的isolationMode为isolationOnly。 1576 1577**处理步骤** 1578 15791. 按照设备的隔离模式配置HAP配置文件isolationMode属性。 1580 ```bash 1581 # 查询设备persist.bms.supportIsolationMode值，若返回errNum is:106说明没配置 1582 hdc shell 1583 param get persist.bms.supportIsolationMode 1584 # 配置设备persist.bms.supportIsolationMode值 1585 hdc shell 1586 param set persist.bms.supportIsolationMode [true|false] 1587 ``` 1588 1589 1590### 9568310 兼容策略不同 1591**错误信息** 1592 1593error: compatible policy not same. 1594 1595**错误描述** 1596 1597新包与已安装包兼容策略不同。 1598 1599**可能原因** 1600 16011. 应用已安装，再安装一个同包名的应用间共享库。 16022. 应用间共享库已安装，再安装一个同包名的应用。 1603 1604**处理步骤** 1605 16061. 卸载已安装的应用或应用间共享库，再安装新包。 1607 1608 1609### 9568391 包管理服务已停止 1610**错误信息** 1611 1612error: bundle manager service is died. 1613 1614**错误描述** 1615 1616包管理服务已停止。 1617 1618**可能原因** 1619 1620系统出现未知的异常，导致包管理服务已停止或者异常退出。 1621 1622**处理步骤** 1623 16241. 重启手机后再次尝试安装应用。 1625 16262. 重复上述步骤3到5次后依旧安装失败，请查询设备的/data/log/faultlog/faultlogger/目录下是否存在包含foundation字样的crash文件。 1627 1628 ``` 1629 hdc shell 1630 cd /data/log/faultlog/faultlogger/ 1631 ls -ls 1632 ``` 1633 16343. 导出crash文件和日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 1635 1636 ``` 1637 hdc file recv /data/log/faultlog/faultlogger/ 1638 hdc file recv /data/log/hilog/ 1639 ``` 1640 1641### 9568393 验证代码签名失败 1642**错误信息** 1643 1644error: verify code signature failed. 1645 1646**错误描述** 1647 1648验证代码签名失败。 1649 1650**可能原因** 1651 1652包没有代码签名信息。 1653 1654**处理步骤** 1655 16561. 安装最新版本DevEco Studio，重新签名。 1657 1658<!--RP3--><!--RP3End--> 1659 1660### 9568399 拷贝文件失败 1661 1662**错误信息** 1663 1664error: copy file failed. 1665 1666**错误描述** 1667 1668安装应用过程中，拷贝文件失败。 1669 1670**可能原因** 1671 16721. 拷贝源文件路径或目标路径为无效路径。 16732. 源文件打开失败。 16743. 获取源文件状态失败。 16754. 源文件的大小无效。 16766. 源文件拷贝失败。 16777. 源文件没有访问权限。 16788. 更改文件权限失败。 1679 1680**处理步骤** 1681 16821. 重启手机后再次尝试安装应用。 1683 16842. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 1685 1686``` 1687hdc file recv /data/log/hilog/ 1688``` 1689 1690### 9568401 调试包仅支持运行在开发者模式设备 1691**错误信息** 1692 1693error: debug bundle can only be installed in developer mode. 1694 1695**错误描述** 1696 1697调试包仅支持运行在开发者模式设备。 1698 1699**可能原因** 1700 1701终端设备未开启“开发者模式”。 1702 1703**处理步骤** 1704 17051. 终端系统查看“设置 > 系统”中是否有“开发者选项”，如果不存在，可在“设置 > 关于本机”连续七次单击“版本号”，直到提示“开启开发者模式”，点击“确认开启”后输入PIN码（如果已设置），设备将自动重启。 17062. USB数据线连接终端和PC，在“设置 > 系统 > 开发者选项”中，打开“USB调试”开关，弹出的“允许USB调试”的弹框，点击“允许”。 17073. 启动调试或运行应用。 1708 1709### 9568404 传递签名配置文件失败 1710 1711**错误信息** 1712 1713error: delivery sign profile failed. 1714 1715**错误描述** 1716 1717安装过程中，传递代码签名配置文件出现异常，导致安装失败。 1718 1719**可能原因** 1720 17211. 文件路径不存在。 17222. 创建文件路径失败。 17233. 更改文件目录模式失败。 17244. 写配置文件数据失败。 17255. 更改配置文件模式失败。 17266. 添加配置文件数据失败。 1727 1728**处理步骤** 1729 17301. 重启手机后再次尝试安装应用。 1731 17322. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 1733 1734``` 1735hdc file recv /data/log/hilog/ 1736``` 1737 1738### 9568405 删除签名配置文件失败 1739 1740**错误信息** 1741 1742error: remove sign profile failed. 1743 1744**错误描述** 1745 1746应用卸载过程中，删除签名配置文件出现异常，导致卸载应用失败。 1747 1748**可能原因** 1749 17501. 文件路径不存在。 17512. 加载配置文件数据失败。 17523. 文件权限不是可写的。 1753 1754**处理步骤** 1755 17561. 重启手机后再次尝试卸载应用。 1757 17582. 重复上述步骤3到5次后依旧卸载失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 1759 1760``` 1761hdc file recv /data/log/hilog/ 1762``` 1763 1764### 9568386 卸载的应用不存在 1765**错误信息** 1766 1767error: uninstall missing installed bundle. 1768 1769**错误描述** 1770 1771卸载的应用不存在。 1772 1773**可能原因** 1774 1775要卸载的应用没有安装。 1776 1777**处理步骤** 1778 17791. 确认要卸载的应用是否已经安装。 1780 1781### 9568388 企业设备管理不允许卸载该应用 1782**错误信息** 1783 1784error: Failed to uninstall the HAP because the uninstall is forbidden by enterprise device management. 1785 1786**错误描述** 1787 1788企业设备管理不允许卸载该应用。 1789 1790**可能原因** 1791 1792应用被设置为不允许被卸载。 1793 1794**处理步骤** 1795 17961. 由设置方取消该应用的卸载管控。 1797 1798### 9568389 未知错误导致安装失败 1799**错误信息** 1800 1801error: unknown. 1802 1803**错误描述** 1804 1805未知的错误。 1806 1807**可能原因** 1808 1809系统未知的错误导致安装失败。 1810 1811**处理步骤** 1812 18131. 重启手机后再次尝试安装应用。 1814 18152. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 1816 1817### 9568284 安装版本不匹配 1818**错误信息** 1819 1820error: install version not compatible. 1821 1822**错误描述** 1823 1824安装版本不匹配。 1825 1826**可能原因** 1827 1828当前安装HSP的版本信息与已安装HAP的版本信息不匹配。 1829安装HSP时会做如下校验： 18301. bundleName和HAP的一致。 18312. version和HAP的一致。 18323. 签名和HAP的一致。 1833 1834**处理步骤** 1835 18361. 卸载版本信息不匹配的HAP，再安装HSP。 18372. 修改HSP版本信息与HAP一致，再安装HSP。 1838 1839### 9568287 安装包entry模块数量不合规 1840**错误信息** 1841 1842error: install invalid number of entry hap. 1843 1844**错误描述** 1845 1846安装包entry模块数量不合规。 1847 1848**可能原因** 1849 1850安装包中entry模块有多个。一个应用只能有一个entry模块，可以有多个feature模块。 1851 1852**处理步骤** 1853 18541. 保留一个entry模块，其余entry模块修改为feature（修改module.json5中type字段）。 1855 1856 1857### 9568281 安装包vendor不一致 1858**错误信息** 1859 1860error: install vendor not same. 1861 1862**错误描述** 1863 1864安装包vendor不一致。 1865 1866**可能原因** 1867 1868app.json5文件中app的vendor字段配置不一致。 1869 1870**处理步骤** 1871 18721. 若只有一个HAP，要求与已安装应用vendor字段一致，卸载重装即可。 18732. 若包含集成态HSP，要求集成态HSP与使用方HAP的vendor字段保持一致。 1874 1875### 9568272 安装包体积大小无效 1876**错误信息** 1877 1878error: install invalid hap size. 1879 1880**错误描述** 1881 1882安装包大小超出限制。 1883 1884**可能原因** 1885 1886安装包体积超过4GB大小。 1887 1888**处理步骤** 1889 1890拆分包，保证每个安装包体积不超过4GB。 1891 1892### 9568273 应用生成UID失败，导致安装失败 1893**错误信息** 1894 1895error: install generate uid error. 1896 1897**错误描述** 1898 1899应用生成UID失败，导致安装失败。 1900 1901**可能原因** 1902 1903该设备上已安装的应用数量已超过65535，导致应用安装时分配UID失败。 1904 1905**处理步骤** 1906 1907卸载不必要的应用后重试。 1908 1909### 9568274 安装服务错误 1910**错误信息** 1911 1912error: install installd service error. 1913 1914**错误描述** 1915 1916安装服务错误。 1917 1918**可能原因** 1919 1920安装服务异常。 1921 1922**处理步骤** 1923 19241. 清除缓存，重启设备。 1925 1926 1927### 9568275 包管理服务错误 1928 1929**错误信息** 1930 1931error: install bundle mgr service error. 1932 1933**错误描述** 1934 1935包管理服务错误。 1936 1937**可能原因** 1938 1939包管理服务异常，如出现空指针导致异常等。 1940 1941**处理步骤** 1942 1943重启设备或稍后重试。 1944 1945### 9568277 包名不一致，导致安装失败 1946 1947**错误信息** 1948 1949error: install bundle name not same. 1950 1951**错误描述** 1952 1953包名不一致，导致安装失败。 1954 1955**可能原因** 1956 1957待安装的路径下的多个安装包包名不一致。 1958 1959**处理步骤** 1960 1961检查待安装路径下的安装包包名，确保所有安装包的app.json5配置文件中bundleName一致。 1962 1963 1964### 9568279 版本不一致，导致安装失败 1965 1966**错误信息** 1967 1968error: install version name not same. 1969 1970**错误描述** 1971 1972版本（versionName字段）不一致，导致安装失败。 1973 1974**可能原因** 1975 1976待安装的路径下的多个安装包的versionName不一致。 1977 1978**处理步骤** 1979 1980检查待安装路径下的安装包版本，确保所有安装包的app.json5配置文件中versionName一致。 1981 1982### 9568280 minCompatibleVersionCode不一致，导致安装失败 1983 1984**错误信息** 1985 1986error: install min compatible version code not same. 1987 1988**错误描述** 1989 1990minCompatibleVersionCode字段不一致，导致安装失败。 1991 1992**可能原因** 1993 1994待安装的路径下的多个安装包的minCompatibleVersionCode不一致。 1995 1996**处理步骤** 1997 1998检查待安装路径下的安装包，确保所有安装包的app.json5配置文件中minCompatibleVersionCode一致。 1999 2000### 9568282 targetAPIVersion不一致，导致安装失败 2001 2002**错误信息** 2003 2004error: install releaseType target not same. 2005 2006**错误描述** 2007 2008targetAPIVersion字段不一致，导致安装失败。 2009 2010**可能原因** 2011 2012待安装的路径下的多个安装包的targetAPIVersion不一致。 2013 2014**处理步骤** 2015 2016检查待安装路径下的安装包，确保所有安装包的app.json5配置文件中targetAPIVersion一致。 2017 2018### 9568314 安装应用间共享库失败 2019**错误信息** 2020 2021error: Failed to install the HSP because installing a shared bundle specified by hapFilePaths is not allowed. 2022 2023**错误描述** 2024 2025安装应用间共享库失败。 2026 2027**可能原因** 2028 2029安装应用间共享HSP时使用“hdc app install ***”指令。 2030 2031**处理步骤** 2032 20331. 安装应用间HSP时使用“hdc install -s ***”指令。 2034 2035 2036### 9568349 操作文件时传入参数异常 2037**错误信息** 2038 2039error: installd param error. 2040 2041**错误描述** 2042 2043操作文件时传入参数异常，导致安装失败。 2044 2045**可能原因** 2046 2047安装过程中，传入参数无效或者传入目录路径为空。 2048 2049**处理步骤** 2050 20511. 重启手机后再次尝试安装应用。 2052 20532. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 2054 2055``` 2056# 导出日志文件 2057hdc file recv /data/log/hilog/ 2058``` 2059 2060 2061### 9568351 创建文件目录异常导致安装失败 2062**错误信息** 2063 2064error: installd create dir failed. 2065 2066**错误描述** 2067 2068创建文件目录异常，导致安装失败。 2069 2070**可能原因** 2071 2072创建文件目录时没有写权限。 2073 2074**处理步骤** 2075 20761. 重启手机后再次尝试安装应用。 2077 20782. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 2079 2080``` 2081# 导出日志文件 2082hdc file recv /data/log/hilog/ 2083``` 2084 2085 2086### 9568354 删除文件目录异常导致安装失败 2087**错误信息** 2088 2089error: installd remove dir failed. 2090 2091**错误描述** 2092 2093删除文件目录失败，导致安装失败。 2094 2095**可能原因** 2096 2097删除文件目录不存在，或者当前目录没有可写权限。 2098 2099**处理步骤** 2100 21011. 重启手机后再次尝试安装应用。 2102 21032. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 2104 2105``` 2106# 导出日志文件 2107hdc file recv /data/log/hilog/ 2108``` 2109 2110 2111### 9568355 安装包中提取文件失败 2112**错误信息** 2113 2114error: installd extract files failed. 2115 2116**错误描述** 2117 2118安装包中提取文件失败，导致安装失败。 2119 2120**可能原因** 2121 2122安装过程中，解压so的目录创建失败，导致HAP包中提取so失败。 2123 2124**处理步骤** 2125 21261. 重启手机后再次尝试安装应用。 2127 21282. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 2129 2130``` 2131# 导出日志文件 2132hdc file recv /data/log/hilog/ 2133``` 2134 2135 2136### 9568356 安装过程中重命名目录名失败 2137**错误信息** 2138 2139error: installd rename dir failed. 2140 2141**错误描述** 2142 2143重命名目录名失败，导致安装失败。 2144 2145**可能原因** 2146 2147安装过程中，重命名目录，目录名称超出260字符，或者当前目录没有可写权限。 2148 2149**处理步骤** 2150 21511. 重启手机后再次尝试安装应用。 2152 21532. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 2154 2155``` 2156# 导出日志文件 2157hdc file recv /data/log/hilog/ 2158``` 2159 2160### 9568357 清理文件失败 2161**错误信息** 2162 2163error: installd clean dir failed. 2164 2165**错误描述** 2166 2167清理文件失败，导致安装失败。 2168 2169**可能原因** 2170 2171安装过程中，待清理的文件无可写权限导致清理文件失败。 2172 2173**处理步骤** 2174 21751. 重启手机后再次尝试安装应用。 2176 21772. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 2178 2179``` 2180# 导出日志文件 2181hdc file recv /data/log/hilog/ 2182``` 2183 2184 2185### 9568359 安装设置selinux失败 2186**错误信息** 2187 2188error: installd set selinux label failed. 2189 2190**错误描述** 2191 2192安装设置selinux失败。 2193 2194**可能原因** 2195 2196签名配置文件中APL字段错误。APL有“normal”、“system_basic”和“system_core”三种等级。 2197 2198**处理步骤** 2199 22001. 确认签名文件p7b中apl字段是否有误。 2201 2202  2203 22042. 若apl字段有误，修改UnsgnedReleasedProfileTemplate.json文件中apl字段，并重新签名。 2205 2206  2207 2208### 9568398 企业MDM应用/普通企业应用不允许安装 2209**错误信息** 2210 2211error: Failed to install the HAP because an enterprise normal/MDM bundle cannot be installed on non-enterprise device. 2212 2213**错误描述** 2214 2215当前设备禁止安装企业MDM应用或普通企业应用。 2216 2217**可能原因** 2218 2219当前设备不允许安装<!--RP5-->[Profile签名文件](../security/app-provision-structure.md)<!--RP5End-->中如下两种类型的应用：enterprise_mdm（企业MDM应用）、enterprise_normal（普通企业应用）。 2220Profile签名文件类型的取值及含义请参考[ApplicationInfo.appDistributionType](../reference/apis-ability-kit/js-apis-bundleManager-applicationInfo.md#applicationinfo-1)。 2221 2222**处理步骤** 2223 2224更换Profile签名文件中的类型。 2225 2226### 9568402 禁止安装签名证书profile文件中的类型为app_gallery的release应用 2227**错误信息** 2228 2229error: Release bundle can not be installed. 2230 2231**错误描述** 2232 2233禁止通过bm命令安装<!--RP5-->[Profile签名文件](../security/app-provision-structure.md)<!--RP5End-->中的类型为app_gallery并且签名证书类型为release的应用。 2234 2235**可能原因** 2236 2237安装应用<!--RP5-->[Profile签名文件](../security/app-provision-structure.md)<!--RP5End-->中的类型为app_gallery并且签名证书类型为release。 2238 2239**处理步骤** 2240 22411. 使用<!--RP5-->[Profile签名文件](../security/app-provision-structure.md)<!--RP5End-->中的类型非app_gallery的文件对应用重新签名。 22422. 使用debug类型证书对应用重新签名。 2243 2244### 9568403 安装加密校验失败 2245**错误信息** 2246 2247error: check encryption failed. 2248 2249**错误描述** 2250 2251安装加密校验失败。 2252 2253**可能原因** 2254 2255可能是镜像版本较老；或者HAP包lib目录内非so文件导致。 2256 2257**处理步骤** 2258 22591. 安装新版本镜像。 22602. 删除HAP工程中lib目录内非so文件，重新签名打包。 2261 2262### 9568407 安装失败，native软件包安装失败 2263**错误信息** 2264 2265error: Failed to install the HAP because installing the native package failed. 2266 2267**错误描述** 2268 2269安装HAP时，native软件包安装失败。 2270 2271**可能原因** 2272 2273HAP包中需要安装的native软件包损坏。 2274 2275**处理步骤** 2276 22771. 检查HAP包中的native软件包，替换正确的native软件包并重新签名打包。参考[Native软件包开发指南](https://gitee.com/openharmony/startup_appspawn/blob/master/service/hnp/README_zh.md)。 2278 2279### 9568408 卸载应用失败，native软件包卸载失败 2280**错误信息** 2281 2282error: Failed to uninstall the HAP because uninstalling the native package failed. 2283 2284**错误描述** 2285 2286卸载应用时，native软件包卸载失败。 2287 2288**可能原因** 2289 2290应用对应的需要卸载的native软件包被占用。 2291 2292**处理步骤** 2293 22941. 检查是否存在进程占用相应的native软件包，若存在则结束进程后重新卸载。参考[Native软件包开发指南](https://gitee.com/openharmony/startup_appspawn/blob/master/service/hnp/README_zh.md)。 2295 2296### 9568409 安装失败，native软件包提取失败 2297**错误信息** 2298 2299error: Failed to install the HAP because the extract of the native package failed. 2300 2301**错误描述** 2302 2303安装HAP时，提取native软件包失败。 2304 2305**可能原因** 2306 2307HAP包中native软件包目录下不存在module.json5中配置的native软件包。 2308 2309**处理步骤** 2310 23111. 检查HAP包中的native软件包目录，重新打入需要安装的native软件包并完成签名或删除module.json5中缺失的native软件包配置信息。参考[Native软件包开发指南](https://gitee.com/openharmony/startup_appspawn/blob/master/service/hnp/README_zh.md)。 2312 2313### 9568410 安装失败，设备受管控 2314**错误信息** 2315 2316error: failed to install because the device be controlled. 2317 2318**错误描述** 2319 2320因为设备受管控导致HAP安装失败。 2321 2322**可能原因** 2323 2324设备通过非法渠道激活等原因。 2325 2326**处理步骤** 2327 23281. 确认设备是否是非法渠道获取的。 23292. 走正常设备激活流程。 2330 2331### 9568413 应用设备类型不支持当前设备 2332 2333**错误信息** 2334 2335error: check syscap filed and device type is not supported. 2336 2337**错误描述** 2338 2339应用配置的[设备类型](../quick-start/module-configuration-file.md#devicetypes标签)不支持安装。 2340 2341**可能原因** 2342 2343应用配置的[设备类型](../quick-start/module-configuration-file.md#devicetypes标签)和安装设备不一致。 2344 2345**处理步骤** 2346 2347调整正确的[设备类型](../quick-start/module-configuration-file.md#devicetypes标签)。 2348 2349### 9568415 禁止安装签名证书为debug或者配置文件debug为true的加密应用 2350**错误信息** 2351 2352error: debug encrypted bundle is not allowed to install. 2353 2354**错误描述** 2355 2356禁止安装签名证书为debug类型或者配置文件debug属性值为true的加密应用。 2357 2358**可能原因** 2359 23601. 安装了签名证书为debug类型的加密应用。 23612. 安装了配置文件中debug属性值为true的加密应用。 2362 2363**处理步骤** 2364 23651. 不支持安装签名证书为debug类型或者配置文件debug属性值为true的加密应用，可以修改为非加密应用进行安装调试。 2366 2367### 9568416 加密应用不允许安装 2368**错误信息** 2369 2370error: Encrypted bundle cannot be installed. 2371 2372**错误描述** 2373 2374加密应用不允许通过bm命令安装。 2375 2376**可能原因** 2377 2378安装的应用为加密应用。 2379 2380**处理步骤** 2381 23821. 使用[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)或者[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)重新签名后安装调试。 2383 2384### 9568417 签名校验失败 2385**错误信息** 2386 2387error: bundle cannot be installed because the appId is not same with preinstalled bundle. 2388 2389**错误描述** 2390 2391预置应用卸载后安装同bundleName的应用，由于应用的签名信息不一致禁止安装。 2392 2393**可能原因** 2394 2395安装应用签名信息中的[密钥](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section462703710326)和<!--RP7-->应用[Profile签名文件](../security/app-provision-structure.md)中的app-identifier<!--RP7End-->与已卸载的预置应用都不一致。 2396 2397**处理步骤** 2398 23991. 重新签名，保证应用签名信息中的[密钥](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section462703710326)和<!--RP7-->应用[Profile签名文件](../security/app-provision-structure.md)中的app-identifier<!--RP7End-->任意一个与预置应用的一致。 24002. 修改安装应用的[bundleName](../quick-start/app-configuration-file.md#配置文件标签)，确保与预置应用的不一致。 2401 2402### 9568418 应用设置了卸载处置规则，不允许直接卸载 2403**错误信息** 2404 2405error: Failed to uninstall the app because the app is locked. 2406 2407**错误描述** 2408 2409卸载应用时，应用存在卸载处置规则，不允许直接卸载。 2410 2411**可能原因** 2412 2413应用存在卸载处置规则，不允许直接卸载。 2414 2415**处理步骤** 2416 24171. 检查应用是否设置了卸载处置规则，由设置方取消卸载处置规则。 2418 2419### 9568420 禁止通过bm安装release的预装应用 2420**错误信息** 2421 2422error: os_integration Bundle is not allowed to install for shell. 2423 2424**错误描述** 2425 2426禁止通过bm安装release的预装应用。 2427 2428**可能原因** 2429 2430通过bm安装release的预装应用。 2431 2432**处理步骤** 2433 24341. 检查应用是否是release的预装应用。 2435 2436### 9568278 安装包的版本号不一致 2437**错误信息** 2438 2439error: install version code not same. 2440 2441**可能原因** 24421. 设备上安装的应用和安装报错的应用包版本号（versionCode）不一致。 24432. 安装多个包中存在版本号（versionCode）不一致。 2444 2445**处理步骤** 24461. 调整安装包的版本和设备中已存在的应用包的版本号（versionCode）一致，或者卸载设备中的应用，再去安装新的应用包。 24472. 调整安装的多个包的版本号（versionCode），所有的包都需要保持版本号（versionCode）一致。 2448 2449### 9568421 签名证书profile文件中的类型被限制，不允许安装到当前设备中，导致安装失败 2450**错误信息** 2451 2452error: Failed to install the HAP or HSP because the app distribution type is not allowed. 2453 2454**错误描述** 2455 2456签名证书profile文件中的类型被限制，不允许安装到当前设备中。 2457 2458**可能原因** 2459 2460该<!--RP5-->[签名Profile文件](../security/app-provision-structure.md)<!--RP5End-->中的类型被限制，禁止安装到当前设备中。 2461 2462**处理步骤** 2463 2464更换签名证书profile文件中的类型。 2465 2466### 9568423 签名证书profile文件中缺少当前设备的udid配置，不允许安装到当前设备中 2467**错误信息** 2468 2469error: Failed to install the HAP because the device is unauthorized, make sure the UDID of your device is configured in the signing profile. 2470 2471**错误描述** 2472 2473签名证书profile文件中缺少当前设备的UDID配置，不允许安装到当前设备中。 2474 2475**可能原因** 2476 2477该应用的<!--RP5-->[Profile签名文件](../security/app-provision-structure.md)<!--RP5End-->为调试类型，且未配置当前设备的UDID。 2478 2479**处理步骤** 2480 2481<!--RP6--> 2482<!--RP6End-->重新[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section18815157237)。 2483 2484 2485### 9568380 卸载系统应用失败 2486**错误信息** 2487 2488error: uninstall system app error. 2489 2490**错误描述** 2491 2492卸载系统应用失败。 2493 2494**可能原因** 2495 2496部分系统应用设置为不可卸载，不支持卸载此类应用。 2497 2498**处理步骤** 2499 2500不能卸载不可卸载的应用。 2501 2502### 9568387 卸载未安装的模块，导致卸载失败 2503**错误信息** 2504 2505error: uninstall missing installed module. 2506 2507**错误描述** 2508 2509卸载未安装的模块。 2510 2511**可能原因** 2512 2513卸载未安装的模块。 2514 2515**处理步骤** 2516 2517使用[bm dump -n](#查询应用信息命令dump)命令查看应用配置，确认要卸载的模块已经安装。 2518### 9568432 插件与应用之间的 pluginDistributionIDs 校验失败，导致安装失败 2519**错误信息** 2520 2521error: Check pluginDistributionID between plugin and host application failed. 2522 2523**错误描述** 2524 2525应用与插件的 pluginDistributionIDs 之间校验失败。 2526 2527**可能原因** 2528 2529应用与插件的 pluginDistributionIDs 没有共同值，导致校验失败。 2530 2531**处理步骤** 2532 2533重新配置应用或者插件<!--RP5-->[签名证书profile文件](../security/app-provision-structure.md)<!--RP5End-->中的 pluginDistributionIDs。配置格式如下： 2534``` 2535"app-services-capabilities":{ 2536 "ohos.permission.kernel.SUPPORT_PLUGIN":{ 2537 "pluginDistributionIDs":"value-1,value-2,···" 2538 } 2539} 2540``` 2541 2542### 9568433 应用缺少ohos.permission.SUPPORT_PLUGIN权限 2543**错误信息** 2544 2545error: Failed to install the plugin because host application check permission failed. 2546 2547**错误描述** 2548 2549应用安装插件时，应用的权限校验失败。 2550 2551**可能原因** 2552 2553应用缺少ohos.permission.SUPPORT_PLUGIN权限。 2554 2555**处理步骤** 2556 25571. 参考[权限申请指导](../security/AccessToken/declare-permissions.md)申请[ohos.permission.kernel.SUPPORT_PLUGIN权限](../security/AccessToken/restricted-permissions.md#ohospermissionkernelsupport_plugin)。 2558<!--Del--> 25592. 该权限等级为system_basic，若[应用APL等级](../security/AccessToken/app-permission-mgmt-overview.md#权限机制中的基本概念)低于system_basic，请[申请受限权限](../security/AccessToken/declare-permissions-in-acl.md)。 2560<!--DelEnd--> 2561 2562 2563### 9568333 模块名称为空 2564**错误信息** 2565 2566error: Install failed due to hap moduleName is empty. 2567 2568**错误描述** 2569 2570模块名称为空，导致安装失败。 2571 2572**可能原因** 2573 2574模块名称为空。 2575 2576**处理步骤** 2577 2578检查[module.json5](../quick-start/module-configuration-file.md)的name字段是否为空。 2579 2580### 9568331 签名信息不一致 2581**错误信息** 2582 2583error: Install incompatible signature info. 2584 2585**错误描述** 2586 2587签名信息不一致，导致安装失败。 2588 2589**可能原因** 2590 2591安装多HAP包的应用时，HAP包的签名信息不一致。 2592 2593**处理步骤** 2594 2595重新签名，使多个HAP包签名信息一致。参考[应用/元服务签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing)。 2596 2597### 9568334 模块名称重复 2598**错误信息** 2599 2600error: Install failed due to hap moduleName duplicate. 2601 2602**错误描述** 2603 2604模块名称重复，导致安装失败。 2605 2606**可能原因** 2607 2608一个应用同时安装多个模块时，模块名称存在重复。 2609 2610**处理步骤** 2611 2612同一个应用多个模块的名称要保证唯一性。 2613 2614 2615<!--Del--> 2616### 9568335 安装参数hashParams校验失败 2617**错误信息** 2618 2619error: Install failed due to check hap hash param failed. 2620 2621**错误描述** 2622 2623安装时，参数InstallParam.hashParams校验失败。 2624 2625**可能原因** 2626 2627[参数InstallParam.hashParams](../reference/apis-ability-kit/js-apis-installer-sys.md#installparam)中包含多余的模块名称。 2628 2629**处理步骤** 2630 2631检查参数InstallParam.hashParams，不能包含多余的模块名称。<!--DelEnd--> 2632 2633 2634### 9568340 配置文件缺失 2635**错误信息** 2636 2637error: Install parse no profile. 2638 2639**错误描述** 2640 2641HAP包没有配置文件，导致安装失败。 2642 2643**可能原因** 2644 2645[module.json](../quick-start/module-configuration-file.md)、[pack.info](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-compile-build#section43931054115513)等配置文件缺失。 2646 2647**处理步骤** 2648 2649使用DevEco Studio重新构建、打包、安装。 2650 2651### 9568341 安装时解析配置文件失败 2652**错误信息** 2653 2654error: Install parse bad profile. 2655 2656**错误描述** 2657 2658安装时解析配置文件失败。 2659 2660**可能原因** 2661 2662[module.json](../quick-start/module-configuration-file.md)、[pack.info](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-compile-build#section43931054115513)等配置文件格式异常。 2663 2664**处理步骤** 2665使用DevEco Studio重新构建、打包、安装。 2666 2667 2668### 9568342 配置文件数据类型错误 2669**错误信息** 2670 2671error: Install parse profile prop type error. 2672 2673**错误描述** 2674 2675安装解析配置文件时，数据类型错误，导致安装失败。 2676 2677 2678**可能原因** 2679 2680[module.json](../quick-start/module-configuration-file.md)、[pack.info](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-compile-build#section43931054115513)等配置文件存在数据类型错误的字段。 2681 2682**处理步骤** 2683 2684使用DevEco Studio重新构建、打包、安装。 2685 2686### 9568345 配置文件中的字符串长度或者数组大小过大 2687**错误信息** 2688 2689error: too large size of string or array type element in the profile. 2690 2691**错误描述** 2692 2693安装解析配置文件时，字符串长度或者数组大小过大，导致安装失败。 2694 2695**可能原因** 2696 2697[module.json](../quick-start/module-configuration-file.md)、[pack.info](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-compile-build#section43931054115513)等配置文件存在字符串长度或者数组大小过大的字段。 2698 2699**处理步骤** 2700 2701使用DevEco Studio重新构建、打包、安装。 2702 2703 2704### 9568347 解析本地so文件失败 2705**错误信息** 2706 2707error: install parse native so failed. 2708 2709**错误描述** 2710 2711在启动调试或运行C++应用/服务时，安装HAP包出现错误，提示“error: install parse native so failed”错误信息。 2712 2713**可能原因** 2714 2715设备支持的Abi类型与C++工程中配置的Abi类型不匹配。 2716 2717> **说明：** 2718> 2719> - 如果工程有依赖HSP或者HAR模块，请确保所有包含C++代码的模块配置的Abi类型包含设备支持的Abi类型。 2720> - 如果工程依赖的三方库包含so文件，请确保oh_modules/三方库/libs目录包含有设备支持的Abi目录，如libs/arm64-v8a、/libs/x86_64。 2721<!--RP1--><!--RP1End--> 2722 2723**处理步骤** 2724 27251. 将设备或模拟器与DevEco Studio进行连接，具体指导及要求可查看[运行应用/元服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-run-device)。 2726 27272. 在命令行执行如下[hdc命令](#环境要求hdc工具)，查询设备支持的Abi列表。 2728 2729 ``` 2730 hdc shell 2731 param get const.product.cpu.abilist 2732 ``` 27333. 根据查询返回结果，检查[模块级build-profile.json5](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-build-profile)文件中的[“abiFilters”参数](../napi/ohos-abi.md#在编译架构中指定abi)中的配置，规则如下： 2734 2735 <!--Del--> 2736 * 若返回结果为default，请执行如下命令，查询是否存在lib64文件夹。 2737 ``` 2738 cd /system/ 2739 ls 2740 ``` 2741  2742 * 存在lib64文件夹：则“abiFilters”参数中需要包含arm64-v8a类型。 2743 * 不存在lib64文件夹：则“abiFilters”参数中需要至少包含armeabi/armeabi-v7a中的一个类型。<!--DelEnd--> 2744 2745 2746 2747 * 若返回结果为armeabi-v7a/armeabi/arm64-v8a/x86/x86_64中的一个或多个，需要在“abiFilters”参数中至少包含返回结果中的一个Abi类型。 2748 2749### 9568348 解析 ark native SO文件失败 2750 2751**错误信息** 2752 2753error: Install parse ark native file failed. 2754 2755**错误描述** 2756 2757安装时，解析 ark native SO文件失败。 2758 2759**可能原因** 2760 2761安装多HAP时，存在Abi不一致，且与当前设备支持的Abi不匹配。 2762 2763**处理步骤** 2764 2765检查多HAP的Abi是否一致，请参考[错误码9568347](#9568347-解析本地so文件失败)的处理步骤。 2766 2767 2768### 9568350 安装时获取代理对象失败 2769**错误信息** 2770 2771error: Installd get proxy error. 2772 2773**错误描述** 2774 2775安装时获取代理对象失败。 2776 2777**可能原因** 2778 2779包管理或其他服务异常，导致获取代理失败。 2780 2781**处理步骤** 27821. 重启手机后再次尝试安装应用。 2783 27842. 重复上述步骤3到5次后依旧安装失败，请导出日志文件提[在线工单](https://developer.huawei.com/consumer/cn/support/feedback/#/)获取帮助。 2785 2786``` 2787# 导出日志文件 2788hdc file recv /data/log/hilog/ 2789``` 2790 2791### 9568434 设备不具备插件能力 2792**错误信息** 2793 2794error: Failed to install the plugin because current device does not support plugin. 2795 2796**错误描述** 2797 2798当前设备不具备插件能力，导致安装插件失败。 2799 2800**可能原因** 2801 2802设备不具备插件能力。 2803 2804**处理步骤** 2805 2806使用[param工具](./param-tool.md)设置const.bms.support_plugin的值为true，即执行hdc shell param set const.bms.support_plugin true。 2807 2808 2809### 9568435 应用包名不存在 2810**错误信息** 2811 2812error: Host application is not found. 2813 2814**错误描述** 2815 2816传入的应用包名不存在。 2817 2818**可能原因** 2819 2820应用没有安装。 2821 2822**处理步骤** 2823 2824检查传入的应用是否存在。 2825 2826 2827### 9568436 多个HSP包信息不一致 2828**错误信息** 2829 2830error: Failed to install the plugin because they have different configuration information. 2831 2832**错误描述** 2833 2834多HSP之间的包信息不一致，导致安装失败。 2835 2836**可能原因** 2837 2838安装的插件为多HSP时，多个HSP文件的包信息不一致。 2839 2840**处理步骤** 2841 2842检查多HSP之间的包信息是否一致，包括[app.json5配置文件](../quick-start/app-configuration-file.md#配置文件标签)中bundleName、bundleType、versionCode、apiReleaseType字段。 2843 2844### 9568437 插件的 pluginDistributionIDs 解析失败 2845**错误信息** 2846 2847error: Failed to install the plugin because the plugin id failed to be parsed. 2848 2849**错误描述** 2850 2851插件的 pluginDistributionIDs 解析失败，导致安装失败。 2852 2853**可能原因** 2854 2855插件签名信息中的 pluginDistributionIDs 配置不符合规范，导致解析失败。 2856 2857**处理步骤** 2858 2859参考如下格式，重新配置插件<!--RP5-->[签名证书profile文件](../security/app-provision-structure.md)<!--RP5End-->中的"app-services-capabilities"字段。 2860``` 2861"app-services-capabilities":{ 2862 "ohos.permission.kernel.SUPPORT_PLUGIN":{ 2863 "pluginDistributionIDs":"value-1,value-2,···" 2864 } 2865} 2866``` 2867 2868### 9568438 插件包名不存在 2869**错误信息** 2870 2871error: The plugin is not found. 2872 2873**错误描述** 2874 2875插件不存在。 2876 2877**可能原因** 2878 2879当前应用没有安装该插件。 2880 2881**处理步骤** 2882 2883使用[bm dump -n 命令](#查询应用信息命令dump)查询应用的信息，检查传入的插件是否安装。 2884 2885### 9568439 插件与应用包名一致 2886**错误信息** 2887 2888error: The plugin name is same as host bundle name. 2889 2890**错误描述** 2891 2892插件的包名与应用包名相同。 2893 2894**可能原因** 2895 2896插件包名与应用包名一致，导致插件安装失败。 2897 2898**处理步骤** 2899 2900重新配置插件的包名。 2901 2902### 9568441 应用不能变更U1Enabled 2903**错误信息** 2904 2905error: install failed due to U1Enabled can not change. 2906 2907**错误描述** 2908 2909签名信息中U1Enabled变更导致安装失败。 2910 2911**可能原因** 2912 2913应用<!--RP5-->[Profile签名文件](../security/app-provision-structure.md)<!--RP5End-->中allowed-acls字段的U1Enabled配置发生变更，例如： 29141. 已安装应用在allowed-acls中配置了U1Enabled，待安装应用在allowed-acls中没有配置U1Enabled。 29152. 已安装应用在allowed-acls中没有配置U1Enabled，待安装应用在allowed-acls中配置了U1Enabled。 2916 2917**处理步骤** 2918 2919方案一：重新签名，签名过程中，请参考[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section9786111152213)的支持ACL权限、或者[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section157591551175916)的使用ACL的签名配置指导进行配置，确保待安装应用与已安装应用配置一致。<br> 2920方案二：先卸载设备上已安装的应用，再尝试安装待安装应用。 2921 2922### 9568442 U1Enable配置不一致 2923**错误信息** 2924 2925error: Install failed due to the U1Enabled is not same in all haps. 2926 2927**错误描述** 2928 2929签名信息中U1Enabled配置不一致，导致安装失败。 2930 2931**可能原因** 2932 2933多HAP包签名时使用的<!--RP5-->[Profile签名文件](../security/app-provision-structure.md)<!--RP5End-->不一致导致签名信息中allowed-acls的U1Enabled配置不一致。 2934 2935**处理步骤** 2936 2937重新签名，签名过程中，请参考[自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section9786111152213)的支持ACL权限、或者[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section157591551175916)的使用ACL的签名配置指导进行配置，使多个HAP包签名信息中allowed-acls的U1Enabled信息一致。 2938 2939<!--Del--> 2940## 常见问题 2941 2942### 1. 预置系统应用已经卸载，重新安装应用时在特定场景下会报错：降级安装或者签名信息不一致 2943 2944**问题描述** 2945 2946应用已经卸载了，重新安装时报错降级安装或者签名信息不一致，但桌面上会出现对应的应用图标，能正常拉起。 2947 2948**可能原因** 2949 2950针对已卸载的预置系统应用增强了安全管控能力，安装一个相同bundleName的应用时，系统侧会先恢复预置镜像版本中的应用，然后再继续安装传入的应用。 2951 2952**处理步骤** 2953 2954根据报错信息和错误码进行处理。 2955<!--DelEnd--> 2956
