From 36512cf81162bd0e87ec485357e8c84918af6a3a Mon Sep 17 00:00:00 2001 From: wangtiantian Date: Sat, 14 Jan 2023 09:34:52 +0800 Subject: [PATCH] IssueNo:#I6AI7P Description:add bms changelog Sig:SIG_ApplicaitonFramework Feature or Bugfix:Bugfix Binary Source:No Signed-off-by: wangtiantian --- .../changelogs-bundlemanager.md | 81 +++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.5/changelogs-bundlemanager.md diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.5/changelogs-bundlemanager.md b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.5/changelogs-bundlemanager.md new file mode 100644 index 0000000000..a1521cfc0f --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.5/changelogs-bundlemanager.md @@ -0,0 +1,81 @@ +# 包管理子系统ChangeLog + +## cl.bundlemanager.1 底层能力变更，安装应用时增加签名证书中bundle-name的校验，需要与应用的bundleName相同，否则会安装失败。 + +安装应用时增加了对[签名证书profile文件](../../../application-dev/security/app-provision-structure.md)中bundle-name字段的校验，该字段内容需要配置为对应应用的bundleName。 + +如果bundle-name的内容与应用配置文件中的bundleName不一致，会出现安装失败。具体报错为： +``` +error: verify signature failed. +``` + +**变更影响**
+对之前的版本镜像无影响，对使用3.2.10.5版本及之后的系统镜像，如果未修改签名证书中的bundle-name字段，会出现应用安装失败问题。 + +**关键的接口/组件变更**
+不涉及接口及组件变更 + +**适配指导**
+原有应用在新的系统镜像上出现'error: verify signature failed'，可以修改签名证书profile文件中的bundle-name为对应应用的bundleName，生成新的签名证书（后缀为.p7b），重新给应用签名即可。 +签名工具及签名证书的生成方式可以参考：[签名工具指导](../../../application-dev/security/hapsigntool-guidelines.md) + +## cl.bundlemanager.2 底层能力变更，增加对无图标应用的管控，如果应用未配置入口图标，则会在桌面上显示一个默认图标，点击后跳转至应用详情页。 + +增加对无图标应用的管控，如果应用未配置入口图标且未申请隐藏图标特权(AllowHideDesktopIcon)，则会在桌面上显示一个默认图标，点击后跳转至应用详情页。此处的未配置入口图标规则如下： +1. 应用中未配置abilities字段 +2. 应用中配置了abilities字段，但是没有任何一个page类型的ability中skills如下，即同时包含"action.system.home"和"entity.system.home"： + ```json + "skills": [ + { + "actions": [ + "action.system.home" + ], + "entities": [ + "entity.system.home" + ] + } + ] + ``` +对于符合上面规则的应用，均属于无图标应用，通过hdc_std install 或者 bm install的方式安装，均会在桌面上显示一个默认图标。 + +如果应用不需要再桌面显示图标，需要申请相应的隐藏图标特权AllowHideDesktopIcon，并在签名证书文件中或者白名单(install_list_capability.json)配置，可以参考：[应用特权配置指南](../../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 + +如果应该需要在桌面显示图标，则需要在abilities中选择一个ability配置skills，同时包含"action.system.home"和"entity.system.home"。 + +**变更影响**
+对之前的版本镜像无影响，对使用3.2.10.5版本及之后的系统镜像，如果应用未配置图标，通过命令行的安装方式会在桌面显示默认图标。 + +**关键的接口/组件变更**
+不涉及接口及组件变更 + +**适配指导**
+如果应用不需要再桌面显示图标，需要申请相应的隐藏图标特权AllowHideDesktopIcon，并在签名证书文件中或者白名单(install_list_capability.json)配置，可以参考：[应用特权配置指南](../../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 + +如果应该需要在桌面显示图标，则需要在abilities中选择一个ability配置skills，同时包含"action.system.home"和"entity.system.home"。 + +## cl.bundlemanager.3 底层能力变更，特权AllowAppUsePrivilegeExtension、AllowAppMultiProcess和AllowFormVisibleNotify不支持通过签名证书配置，仅支持通过白名单install_list_capability.json申请这三个特权。 + +特权AllowAppUsePrivilegeExtension、AllowAppMultiProcess和AllowFormVisibleNotify不支持通过签名证书配置，仅支持通过白名单install_list_capability.json申请这三个特权。对于在签名证书中申请使用上面三个特权的应用，在新版本上可能出现安装失败或者配置特权无效的问题。 + +如果出现了下面的报错，可能是因为特权整改导致的，应用需要适配新的规则，可以参考：[应用特权配置指南](../../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 +``` +error: install parse profile prop check error. +``` + +对于xts或者本地调试的demo，无法修改板子上install_list_capability.json的，可以修改应用的bundleName，需要以"com.acts."为开头，同时在签名证书中申请对应的特权。 + +申请特权AllowAppUsePrivilegeExtension，通常是在应用的配置文件中使用了extensionAbilities字段，且其中的type属性为dataShare或者service。如果未配置特权，就会出现安装失败问题。 + +**变更影响**
+对之前的版本镜像无影响，对使用3.2.10.5版本及之后的系统镜像，如果未在白名单install_list_capability.json中申请所需的特权，可能会出现应用安装失败问题。 + +**关键的接口/组件变更**
+不涉及接口及组件变更 + +**适配指导**
+如果出现了下面的报错，可能是因为特权整改导致的，应用需要适配新的规则，可以参考：[应用特权配置指南](../../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 +``` +error: install parse profile prop check error. +``` + +对于xts或者本地调试的demo，无法修改板子上install_list_capability.json的，可以修改应用的bundleName，需要以"com.acts."为开头，同时在签名证书中申请对应的特权。 \ No newline at end of file -- GitLab