1# 包管理子系统ChangeLog
2
3## cl.bundlemanager.1 底层能力变更，安装应用时增加签名证书中bundle-name的校验，需要与应用的bundleName相同，否则会安装失败。
4
5安装应用时增加了对[签名证书profile文件](../../../application-dev/security/app-provision-structure.md)中bundle-name字段的校验，该字段内容需要配置为对应应用的bundleName。
6
7如果bundle-name的内容与应用配置文件中的bundleName不一致，会出现安装失败。具体报错为：
8```
9error: verify signature failed.
10```
11
12**变更影响**<br>
13对之前的版本镜像无影响，对使用3.2.10.5版本及之后的系统镜像，如果未修改签名证书中的bundle-name字段，会出现应用安装失败问题。
14
15**关键的接口/组件变更**<br>
16不涉及接口及组件变更
17
18**适配指导**<br>
19原有应用在新的系统镜像上出现'error: verify signature failed'，可以修改签名证书profile文件中的bundle-name为对应应用的bundleName，生成新的签名证书（后缀为.p7b），重新给应用签名即可。
20签名工具及签名证书的生成方式可以参考：[签名工具指导](../../../application-dev/security/hapsigntool-guidelines.md)
21
22## cl.bundlemanager.2 底层能力变更，增加对无图标应用的管控，如果应用未配置入口图标，则会在桌面上显示一个默认图标，点击后跳转至应用详情页。
23
24增加对无图标应用的管控，如果应用未配置入口图标且未申请隐藏图标特权(AllowHideDesktopIcon)，则会在桌面上显示一个默认图标，点击后跳转至应用详情页。此处的未配置入口图标规则如下：
251. 应用中未配置abilities字段
262. 应用中配置了abilities字段，但是没有任何一个page类型的ability中skills如下，即同时包含"ohos.want.action.home"和"entity.system.home"：
27    ```json
28     "skills": [
29              {
30                "actions": [
31                  "ohos.want.action.home"
32                ],
33                "entities": [
34                  "entity.system.home"
35                ]
36              }
37            ]
38    ```
39对于符合上面规则的应用，均属于无图标应用，通过hdc_std install 或者 bm install的方式安装，均会在桌面上显示一个默认图标。
40
41如果应用不需要再桌面显示图标，需要申请相应的隐藏图标特权AllowHideDesktopIcon，并在签名证书文件中或者白名单(install_list_capability.json)配置，可以参考：[应用特权配置指南](../../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。
42
43如果应该需要在桌面显示图标，则需要在abilities中选择一个ability配置skills，同时包含"ohos.want.action.home"和"entity.system.home"。
44
45**变更影响**<br>
46对之前的版本镜像无影响，对使用3.2.10.5版本及之后的系统镜像，如果应用未配置图标，通过命令行的安装方式会在桌面显示默认图标。
47
48**关键的接口/组件变更**<br>
49不涉及接口及组件变更
50
51**适配指导**<br>
52如果应用不需要再桌面显示图标，需要申请相应的隐藏图标特权AllowHideDesktopIcon，并在签名证书文件中或者白名单(install_list_capability.json)配置，可以参考：[应用特权配置指南](../../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。
53
54如果应该需要在桌面显示图标，则需要在abilities中选择一个ability配置skills，同时包含"ohos.want.action.home"和"entity.system.home"。
55
56## cl.bundlemanager.3 底层能力变更，特权AllowAppUsePrivilegeExtension、AllowAppMultiProcess和AllowFormVisibleNotify不支持通过签名证书配置，仅支持通过白名单install_list_capability.json申请这三个特权。
57
58特权AllowAppUsePrivilegeExtension、AllowAppMultiProcess和AllowFormVisibleNotify不支持通过签名证书配置，仅支持通过白名单install_list_capability.json申请这三个特权。对于在签名证书中申请使用上面三个特权的应用，在新版本上可能出现安装失败或者配置特权无效的问题。
59
60如果出现了下面的报错，可能是因为特权整改导致的，应用需要适配新的规则，可以参考：[应用特权配置指南](../../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。
61```
62error: install parse profile prop check error.
63```
64
65对于xts或者本地调试的demo，无法修改板子上install_list_capability.json的，可以修改应用的bundleName，需要以"com.acts."为开头，同时在签名证书中申请对应的特权。
66
67申请特权AllowAppUsePrivilegeExtension，通常是在应用的配置文件中使用了extensionAbilities字段，且其中的type属性为dataShare或者service。如果未配置特权，就会出现安装失败问题。
68
69**变更影响**<br>
70对之前的版本镜像无影响，对使用3.2.10.5版本及之后的系统镜像，如果未在白名单install_list_capability.json中申请所需的特权，可能会出现应用安装失败问题。
71
72**关键的接口/组件变更**<br>
73不涉及接口及组件变更
74
75**适配指导**<br>
76如果出现了下面的报错，可能是因为特权整改导致的，应用需要适配新的规则，可以参考：[应用特权配置指南](../../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。
77```
78error: install parse profile prop check error.
79```
80
81对于xts或者本地调试的demo，无法修改开发板上install_list_capability.json的，可以修改应用的bundleName，需要以"com.acts."为开头，同时在签名证书中申请对应的特权。
82
83## cl.bundlemanager.4 底层能力变更，安装hap时，hap中的文件不再解压到安装目录。
84
85安装hap后，安装目录下只会存在hap文件，应用不能再使用拼接路径访问解压后的资源文件，应用想要访问资源文件，需要使用标准的资源管理接口。
86
87**变更影响**<br>
88如果应用使用拼接路径的形式访问资源文件，会访问失败。需要修改成使用资源管理接口访问资源文件。
89
90**关键的接口/组件变更**<br>
91不涉及接口及组件变更
92
93**适配指导**<br>
94资源管理子系统提供Js接口访问资源文件。参考[访问资源文件](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-resource-manager.md#getrawfilecontent9)
95