diff --git a/zh-cn/application-dev/application-models/application-component-configuration-stage.md b/zh-cn/application-dev/application-models/application-component-configuration-stage.md index d8859fe551f7136464f693591d912dd83ffd862f..f18c3f91b64df70a7beb9e26f4755a25530e3380 100644 --- a/zh-cn/application-dev/application-models/application-component-configuration-stage.md +++ b/zh-cn/application-dev/application-models/application-component-configuration-stage.md @@ -62,6 +62,35 @@ } } ``` +- **OpenHarmony中不允许应用隐藏入口图标** + + OpenHarmony系统对无图标应用严格管控，防止一些恶意应用故意配置无入口图标，导致用户找不到软件所在的位置，无法操作卸载应用，在一定程度上保证用户的手机安全。 + + 如果应用确需隐藏入口图标，需要配置AllowAppDesktopIconHide应用特权，具体配置方式参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。详细的入口图标及入口标签的显示规则如下。 + + * HAP中包含UIAbility + * 配置文件（module.json5）中abilities配置中设置了入口图标 + * 该应用没有隐藏图标的特权 + * 系统将使用该UIAbility配置的icon作为入口图标，并显示在桌面上。用户点击该图标，页面跳转到该UIAbility首页。 + * 系统将使用该UIAbility配置的label作为入口标签，并显示在桌面上（如果没有配置label，返回包名）。 + * 该应用具有隐藏图标的特权 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的入口图标和标签。 + * 配置文件（module.json5）中abilities配置中未设置入口图标 + * 该应用没有隐藏图标的特权 + * 系统将使用app.json中的icon作为入口图标，并显示在桌面上（app.json中icon为必填项）。用户点击该图标，页面跳转到应用管理中对应的应用详情页面（参考下图）。 + * 系统将使用app.json中的label作为入口标签，并显示在桌面上（app.json中label为必填项）。 + * 该应用具有隐藏图标的特权 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的入口图标和标签。 + * HAP中不包含UIAbility + * 该应用没有隐藏图标的特权 + * 系统将使用app.json中的icon作为入口图标，并显示在桌面上（app.json中icon为必填项）。用户点击该图标，页面跳转到应用管理中对应的应用详情页面（参考下图）。 + * 系统将使用app.json中的label作为入口标签，并显示在桌面上（app.json中label为必填项）。 + * 该应用具有隐藏图标的特权 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的入口图标和标签。

+ + **应用的详情页示意图** + ![应用的详情页例图](figures/application_details.jpg) + - **应用版本声明配置** 应用版本声明需要在工程的AppScope目录下的[app.json5配置文件](../quick-start/app-configuration-file.md)中配置versionCode标签和versionName标签。versionCode用于标识应用的版本号，该标签值为32位非负整数。此数字仅用于确定某个版本是否比另一个版本更新，数值越大表示版本越高。versionName标签标识版本号的文字描述。 diff --git a/zh-cn/application-dev/application-models/figures/application_details.jpg b/zh-cn/application-dev/application-models/figures/application_details.jpg new file mode 100644 index 0000000000000000000000000000000000000000..6447a151123bcf4f1e45e72f0318430e4aac18cf Binary files /dev/null and b/zh-cn/application-dev/application-models/figures/application_details.jpg differ diff --git a/zh-cn/application-dev/quick-start/figures/application_details.jpg b/zh-cn/application-dev/quick-start/figures/application_details.jpg index 17b7172bc5bea2f4e16af8d385834930ca4bf49f..6447a151123bcf4f1e45e72f0318430e4aac18cf 100644 Binary files a/zh-cn/application-dev/quick-start/figures/application_details.jpg and b/zh-cn/application-dev/quick-start/figures/application_details.jpg differ diff --git a/zh-cn/application-dev/quick-start/module-configuration-file.md b/zh-cn/application-dev/quick-start/module-configuration-file.md index 627910eb37db56b73eac22436f2b918f0f62fe24..88dbf4009deca67351b9fd8f1961cb75918ef5a8 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -221,66 +221,6 @@ deviceTypes示例： abilities标签描述UIAbility组件的配置信息，标签值为数组类型，该标签下的配置只对当前UIAbility生效。 -**OpenHarmony中不允许应用隐藏入口图标** - -OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置入口图标，那么系统将应用app.json中的icon作为入口图标，并显示在桌面上。
-用户点击该图标，将跳转到设置应用管理中对应的应用详情页面（图1）中。
-如果应用想要隐藏入口图标，需要配置AllowAppDesktopIconHide应用特权，具体配置方式参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 - -**场景说明：** 该功能能防止一些恶意应用，故意配置无入口图标，导致用户找不到软件所在的位置，无法操作卸载应用，在一定程度上保证用户的手机安全 - -**入口图标的设置:** 需要在配置文件（module.json5）中abilities配置下设置icon，label以及skills,而且skills的配置下的必须同时包含“ohos.want.action.home” 和 “entity.system.home”: -``` -{ - "module":{ - - ... - - "abilities": [{ - "icon": "$media:icon", - "label": "Login", - "skills": [{ - "actions": ["ohos.want.action.home"], - "entities": ["entity.system.home"], - "uris": [] - }] - }], - ... - - } -} -``` - -**入口图标及入口标签的显示规则** -* HAP中包含UIAbility - * 配置文件（module.json5）中abilities配置中设置了入口图标 - * 该应用没有隐藏图标的特权 - * 显示桌面图标为该UIAbility配置的图标 - * 显示桌面Label为该UIAbility配置的Label（如果没有配置Label，返回包名） - * 显示组件名为该UIAbility的组件名 - * 用户点击该桌面图标，页面跳转到该UIAbility首页 - * 该应用具有隐藏图标的特权 - * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。 - * 配置文件（module.json5）中abilities配置中未设置入口图标 - * 该应用没有隐藏图标的特权 - * 显示桌面图标为app配置下的图标（app.json中icon为必填项） - * 显示桌面Label为app配置下的label（app.json中label为必填项） - * 用户点击该桌面图标，页面跳转到该应用的详情页面（图1） - * 该应用具有隐藏图标的特权 - * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。 -* HAP中不包含UIAbility - * 该应用没有隐藏图标的特权 - * 显示桌面图标为app配置下的图标（app.json中icon为必填项） - * 显示桌面Label为app配置下的label（app.json中label为必填项） - * 用户点击该桌面图标，页面跳转到该应用的详情页面（图1） - * 该应用具有隐藏图标的特权 - * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。

- -应用的详情页例图 - -![应用的详情页例图](figures/application_details.jpg) - - **表6** **abilities标签说明** | 属性名称 | 含义 | 数据类型 | 是否可缺省 | diff --git a/zh-cn/application-dev/quick-start/module-structure.md b/zh-cn/application-dev/quick-start/module-structure.md index 0c331c169ac3b2f6d7dd784c6f931f290ebf30fd..b622552293564d8f14996711d6f455beca315af8 100644 --- a/zh-cn/application-dev/quick-start/module-structure.md +++ b/zh-cn/application-dev/quick-start/module-structure.md @@ -190,14 +190,6 @@ metadata对象示例： ## abilities对象的内部结构 -**OpenHarmony中不允许应用隐藏入口图标** - -OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置入口图标，那么系统会给该应用创建一个默认的图标显示在桌面上;
-用户点击该图标，将跳转到Settings的应用管理中对应的应用详情页面（图1）中。
-如果应用想要隐藏入口图标，需要配置AllowAppDesktopIconHide应用特权，具体配置方式参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 - -**场景说明：** 该功能能防止一些恶意应用，故意配置无入口图标，导致用户找不到软件所在的位置，无法操作卸载应用，在一定程度上保证用户的手机安全 - **入口图标的设置:** 需要在配置文件（config.json）中abilities配置下设置icon，label以及skills,而且skills的配置下必须同时包含“ohos.want.action.home” 和 “entity.system.home”: ``` { @@ -220,35 +212,34 @@ OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置入口 } } ``` +**OpenHarmony中不允许应用隐藏入口图标** + +OpenHarmony系统对无图标应用严格管控，防止一些恶意应用故意配置无入口图标，导致用户找不到软件所在的位置，无法操作卸载应用，在一定程度上保证用户的手机安全。 -**入口图标及入口标签的显示规则** +如果应用确需隐藏入口图标，需要配置AllowAppDesktopIconHide应用特权，具体配置方式参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。详细的入口图标及入口标签的显示规则如下。 * HAP中包含Page类型的PageAbility * 配置文件（config.json）中abilities配置中设置了入口图标 * 该应用没有隐藏图标的特权 - * 显示桌面图标为该PageAbility配置的图标 - * 显示桌面Label为该PageAbility配置的Label（如果没有配置Label，返回包名） - * 显示组件名为该PageAbility的组件名 - * 用户点击该桌面图标，页面跳转到该PageAbility首页 + * 系统将使用该PageAbility配置的icon作为入口图标，并显示在桌面上。用户点击该图标，页面跳转到该PageAbility首页。 + * 系统将使用该PageAbility配置的label作为入口标签，并显示在桌面上（如果没有配置label，返回包名）。 * 该应用具有隐藏图标的特权 - * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的入口图标和标签。 * 配置文件（config.json）中abilities配置中未设置入口图标 * 该应用没有隐藏图标的特权 - * 显示桌面图标为系统默认图标 - * 显示桌面Label为该应用的包名 - * 用户点击该桌面图标，页面跳转到该应用的详情页面（图1） + * 系统将使用系统默认图标作为入口图标，并显示在桌面上。用户点击该图标，页面跳转到应用管理中对应的应用详情页面（参考下图）。 + * 系统将使用应用的包名作为入口标签，并显示在桌面上。 * 该应用具有隐藏图标的特权 - * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的入口图标和标签。 * HAP中不包含Page类型的PageAbility * 该应用没有隐藏图标的特权 - * 显示桌面图标为系统默认图标 - * 显示桌面Label为该应用的包名 - * 用户点击该桌面图标，页面跳转到该应用的详情页面（图1） + * 系统将使用系统默认图标作为入口图标，并显示在桌面上。用户点击该图标，页面跳转到应用管理中对应的应用详情页面（参考下图）。 + * 系统将使用应用的包名作为入口标签，并显示在桌面上。 * 该应用具有隐藏图标的特权 - * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的入口图标和标签。 -注：应用详情页面（图1）中显示的label可能与桌面上显示的不同。如果非Page类型的PageAbility配置了入口图标和label，那么详情页中显示的即为配置的。

+注：应用详情页面中显示的label可能与桌面上显示的不同。如果非Page类型的PageAbility配置了入口图标和label，那么详情页中显示的即为配置的。
-图1 +**应用的详情页示意图** ![应用的详情页例图](figures/application_details.jpg)