diff --git a/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md b/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md index 067419b0acce2d711705ece7587e3cd77a879b59..6a87a1421c4af956a8c724fb9b13acb9ee707605 100644 --- a/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md +++ b/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md @@ -128,7 +128,9 @@ - 如果s_uri的host为空,当w_uri和s_uri的scheme相同时匹配成功,否则匹配失败; -- 如果s_uri的path、pathStartWith和pathRegex都为空,当w_uri和s_uri完全相同时匹配成功,否则匹配失败; +- 如果s_uri的port为空,当w_uri和s_uri中的scheme和host的相同时匹配成功,否则匹配失败; + +- 如果s_uri的path、pathStartWith和pathRegex都为空,当w_uri和s_uri中的scheme,host和port的相同时匹配成功,否则匹配失败; - 如果s_uri的path不为空,当w_uri和s_uri**全路径表达式**相同时匹配成功,否则继续进行pathStartWith的匹配; @@ -144,6 +146,11 @@ > - **前缀表达式**:`scheme://host:port/pathStartWith` > > - **正则表达式**:`scheme://host:port/pathRegex` +> +> - **前缀uri表达式**:当配置文件只配置scheme,或者只配置scheme和host,或者只配置scheme,host和port时,参数传入以配置文件为前缀的Uri +> * `scheme://` +> * `scheme://host` +> * `scheme://host:port` ### type匹配规则 diff --git a/zh-cn/application-dev/application-models/figures/want-uri-type1.png b/zh-cn/application-dev/application-models/figures/want-uri-type1.png index 6dd4117fb44fb8010e4fdbffff5739634680bcd7..68cc6868b5f716c43dfee56bdb4d5d072a0351a2 100644 Binary files a/zh-cn/application-dev/application-models/figures/want-uri-type1.png and b/zh-cn/application-dev/application-models/figures/want-uri-type1.png 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 new file mode 100644 index 0000000000000000000000000000000000000000..17b7172bc5bea2f4e16af8d385834930ca4bf49f Binary files /dev/null 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 d8eb84a77e784006a56c87a74c193da37bf7389e..86ccf113fdb68fe1fd08b63af6bb615dd29b82ef 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -204,14 +204,15 @@ deviceTypes示例: abilities标签描述UIAbility组件的配置信息,标签值为数组类型,该标签下的配置只对当前UIAbility生效。 -**OpenHarmony中不允许应用隐藏启动图标** +**OpenHarmony中不允许应用隐藏入口图标** -OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置启动图标,那么系统将应用app.json中的icon作为启动图标,并显示在桌面上。
-用户点击该图标,将跳转到Settings的应用管理中对应的应用详情页面中。
-如果应用想要隐藏启动图标,需要配置AllowAppDesktopIconHide应用特权,具体配置方式参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 +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.json5)中abilities配置下设置icon,label以及skills,而且skills的配置下的必须同时包含“ohos.want.action.home” 和 “entity.system.home”: ``` { "module":{ @@ -233,32 +234,34 @@ OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置启动 } ``` -**启动图标的查询** -* HAP中包含Ability - * 配置文件(module.json5)中abilities配置中设置了启动图标 +**入口图标及入口标签的显示规则** +* HAP中包含UIAbility + * 配置文件(module.json5)中abilities配置中设置了入口图标 * 该应用没有隐藏图标的特权 - * 返回的桌面图标为该Ability配置的图标 - * 返回的桌面Label为该Ability配置的Label(如果没有配置Label,返回包名) - * 返回的组件名为该Ability的组件名 - * 用户点击该桌面图标,页面跳转到该Ability首页 + * 显示桌面图标为该UIAbility配置的图标 + * 显示桌面Label为该UIAbility配置的Label(如果没有配置Label,返回包名) + * 显示组件名为该UIAbility的组件名 + * 用户点击该桌面图标,页面跳转到该UIAbility首页 * 该应用具有隐藏图标的特权 * 桌面查询时不返回应用信息,不会在桌面上显示对应的图标。 - * 配置文件(module.json5)中abilities配置中未设置启动图标 + * 配置文件(module.json5)中abilities配置中未设置入口图标 * 该应用没有隐藏图标的特权 - * 返回的桌面图标为app配置下的图标(app.json中icon为必填项) - * 返回的桌面Label为app配置下的label(app.json中label为必填项) - * 返回的组件名为应用详情页面的组件名(该组件为系统内置) - * 用户点击该桌面图标,页面跳转到该应用的详情页面 + * 显示桌面图标为app配置下的图标(app.json中icon为必填项) + * 显示桌面Label为app配置下的label(app.json中label为必填项) + * 用户点击该桌面图标,页面跳转到该应用的详情页面(图1) * 该应用具有隐藏图标的特权 * 桌面查询时不返回应用信息,不会在桌面上显示对应的图标。 -* HAP中不包含Ability +* HAP中不包含UIAbility * 该应用没有隐藏图标的特权 - * 返回的桌面图标为app配置下的图标(app.json中icon为必填项) - * 返回的桌面Label为app配置下的label(app.json中label为必填项) - * 返回的组件名为应用详情页面的组件名(该组件为系统内置) - * 用户点击该桌面图标,页面跳转到该应用的详情页面 + * 显示桌面图标为app配置下的图标(app.json中icon为必填项) + * 显示桌面Label为app配置下的label(app.json中label为必填项) + * 用户点击该桌面图标,页面跳转到该应用的详情页面(图1) * 该应用具有隐藏图标的特权 * 桌面查询时不返回应用信息,不会在桌面上显示对应的图标。

+ +应用的详情页例图 + +![应用的详情页例图](figures/application_details.jpg) **表4** **abilities标签说明** diff --git a/zh-cn/application-dev/quick-start/module-structure.md b/zh-cn/application-dev/quick-start/module-structure.md index 768baa8a429e1e2cf306f8f15c5aec0321337a20..69afd5d9b435430d8ca9d1b014be649e5de0c700 100644 --- a/zh-cn/application-dev/quick-start/module-structure.md +++ b/zh-cn/application-dev/quick-start/module-structure.md @@ -190,14 +190,15 @@ metadata对象示例: ## abilities对象的内部结构 -**OpenHarmony中不允许应用隐藏启动图标** +**OpenHarmony中不允许应用隐藏入口图标** -OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置启动图标,那么系统会给该应用创建一个默认的图标显示在桌面上;
-用户点击该图标,将跳转到Settings的应用管理中对应的应用详情页面中。
-如果应用想要隐藏启动图标,需要配置AllowAppDesktopIconHide应用特权,具体配置方式参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 +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”: +**入口图标的设置:** 需要在配置文件(config.json)中abilities配置下设置icon,label以及skills,而且skills的配置下必须同时包含“ohos.want.action.home” 和 “entity.system.home”: ``` { "module":{ @@ -220,34 +221,36 @@ OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置启动 } ``` -**启动图标的查询** -* HAP中包含Page类型的Ability - * 配置文件(config.json)中abilities配置中设置了启动图标 +**入口图标及入口标签的显示规则** +* HAP中包含Page类型的PageAbility + * 配置文件(config.json)中abilities配置中设置了入口图标 * 该应用没有隐藏图标的特权 - * 返回的桌面图标为该Ability配置的图标 - * 返回的桌面Label为该Ability配置的Label(如果没有配置Label,返回包名) - * 返回的组件名为该Ability的组件名 - * 用户点击该桌面图标,页面跳转到该Ability首页 + * 显示桌面图标为该PageAbility配置的图标 + * 显示桌面Label为该PageAbility配置的Label(如果没有配置Label,返回包名) + * 显示组件名为该PageAbility的组件名 + * 用户点击该桌面图标,页面跳转到该PageAbility首页 * 该应用具有隐藏图标的特权 * 桌面查询时不返回应用信息,不会在桌面上显示对应的图标。 - * 配置文件(config.json)中abilities配置中未设置启动图标 + * 配置文件(config.json)中abilities配置中未设置入口图标 * 该应用没有隐藏图标的特权 - * 返回的桌面图标为系统默认图标 - * 返回的桌面Label为该应用的包名 - * 返回的组件名为应用详情页面的组件名(该组件为系统内置) - * 用户点击该桌面图标,页面跳转到该应用的详情页面 + * 显示桌面图标为系统默认图标 + * 显示桌面Label为该应用的包名 + * 用户点击该桌面图标,页面跳转到该应用的详情页面(图1) * 该应用具有隐藏图标的特权 * 桌面查询时不返回应用信息,不会在桌面上显示对应的图标。 -* HAP中不包含Page类型的Ability +* HAP中不包含Page类型的PageAbility * 该应用没有隐藏图标的特权 - * 返回的桌面图标为系统默认图标 - * 返回的桌面Label为该应用的包名 - * 返回的组件名为应用详情页面的组件名(该组件为系统内置) - * 用户点击该桌面图标,页面跳转到该应用的详情页面 + * 显示桌面图标为系统默认图标 + * 显示桌面Label为该应用的包名 + * 用户点击该桌面图标,页面跳转到该应用的详情页面(图1) * 该应用具有隐藏图标的特权 * 桌面查询时不返回应用信息,不会在桌面上显示对应的图标。 -注:应用详情页面中显示的图标与label,可能与桌面上显示的不同。如果非Page类型的ability配置了入口图标和label,那么详情页中显示的即为配置的。

+注:应用详情页面(图1)中显示的label可能与桌面上显示的不同。如果非Page类型的PageAbility配置了入口图标和label,那么详情页中显示的即为配置的。

+ +图1 + +![应用的详情页例图](figures/application_details.jpg) **表8** **abilities对象的内部结构说明**