Skip to content

D
Docs

OpenHarmony / Docs
大约 1 年 前同步成功

通知 159
Star 292
Fork 28
D
Docs

体验新版 GitCode，发现更多精彩内容 >>

未验证 提交 2729a6ef 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!16709 资料优化调整 

Merge pull request !16709 from jiangminsen/master
上级 8e8585ac 5149bbd4
隐藏空白更改
内联 并排
Showing with 66 addition and 117 deletion
zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md
浏览文件 @ 2729a6ef
......@@ -88,10 +88,6 @@
调用方传入的want参数中设置uri和type参数发起组件启动请求，系统会遍历当前系统已安装的组件列表，并逐个匹配待匹配Ability的skills配置中的uris数组，如果待匹配Ability的skills配置中的uris数组中只要有一个可以匹配调用方传入的want参数中设置的uri和type即为匹配成功。
**图3** want参数中uri和type皆不为空时的匹配规则
![want-uri-type1](figures/want-uri-type1.png)
实际应用中，uri和type共存在四种情况，下面将讲解四种情况的具体匹配规则：
- 调用方传入的want参数的uri和type都为空。
......@@ -111,6 +107,13 @@
1. 如果待匹配Ability的skills配置中的uris数组为空，匹配失败。
2. 如果待匹配Ability的skills配置中的uris数组存在一条数据[uri匹配](#uri匹配规则)和[type匹配](#type匹配规则)需要均匹配成功，则匹配成功，否则匹配失败。
最左uri匹配：当配置文件待匹配Ability的skills配置中的uris数组中只配置scheme；或者只配置scheme和host；或者只配置scheme，host和port时。
传入want参数的uri的最左边依次需要和scheme;或者scheme和host;或者scheme,host,port都匹配，才满足最左uri匹配。
**图3** want参数中uri和type皆不为空时的匹配规则
![want-uri-type1](figures/want-uri-type1.png)
下图为了简化描述，称want中传入的uri为w_uri，称want中传入的type为w_type, 待匹配Ability的skills配置中uris为s_uris，其中每个元素为s_uri；按自上而下顺序匹配。
......@@ -128,7 +131,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 +149,11 @@
> - **前缀表达式**：`scheme://host:port/pathStartWith`
>
> - **正则表达式**：`scheme://host:port/pathRegex`
>
> - **前缀uri表达式**：当配置文件只配置scheme，或者只配置scheme和host，或者只配置scheme，host和port时，参数传入以配置文件为前缀的Uri
> * `scheme://`
> * `scheme://host`
> * `scheme://host:port`
### type匹配规则
......
zh-cn/application-dev/quick-start/module-configuration-file.md
浏览文件 @ 2729a6ef
......@@ -204,14 +204,15 @@ deviceTypes示例：
abilities标签描述UIAbility组件的配置信息，标签值为数组类型，该标签下的配置只对当前UIAbility生效。
**OpenHarmony中不允许应用隐藏启动图标**
**OpenHarmony中不允许应用隐藏入口图标**
OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置启动图标，那么系统将应用app.json中的icon作为启动图标，并显示在桌面上。<br>
用户点击该图标，将跳转到Settings的应用管理中对应的应用详情页面中。<br>
如果应用想要隐藏启动图标，需要配置AllowAppDesktopIconHide应用特权，具体配置方式参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。
OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置入口图标，那么系统将应用app.json中的icon作为入口图标，并显示在桌面上。<br>
用户点击该图标，将跳转到设置应用管理中对应的应用详情页面（图1）中。<br>
如果应用想要隐藏入口图标，需要配置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）
* 该应用具有隐藏图标的特权
* 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。<br><br>
应用的详情页例图
![应用的详情页例图](figures/application_details.jpg)
**表4** **abilities标签说明**
......@@ -394,39 +397,6 @@ skills示例：
}
```
**增强隐式查询功能**
支持Uri级别的前缀匹配。
当配置文件只配置scheme，或者只配置scheme和host，或者只配置scheme，host和port时，参数传入以配置文件为前缀的Uri，配置成功。
* 查询功能增强涉及以下接口<br>
[@ohos.bundle.bundleManager](../reference/apis/js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)<br>
1. function queryAbilityInfo(want: Want, abilityFlags: number, callback: AsyncCallback\<Array\<AbilityInfo>>): void;<br>
2. function queryAbilityInfo(want: Want, abilityFlags: number, userId: number, callback: AsyncCallback\<Array\<AbilityInfo>>): void;<br>
3. function queryAbilityInfo(want: Want, abilityFlags: number, userId?: number): Promise\<Array\<AbilityInfo>>;
* 配置要求<br>
abilities -> skills -> uris对象 <br>
配置1： 只配置 scheme = 'http' <br>
配置2： 只配置 ( scheme = 'http' ) + ( host = 'example.com' ) <br>
配置3： 只配置 ( scheme = 'http' ) + ( host = 'example.com' ) + ( port = '8080' )
* 前缀匹配<br>
参数[want](../application-models/want-overview.md)下uri，调用queryAbilityInfo查询接口<br>
1. uri = 'https://' 无匹配<br>
2. uri = 'http://' 可以匹配 配置1<br>
3. uri = 'https://example.com' 无匹配<br>
4. uri = 'https://exa.com' 无匹配<br>
5. uri = 'http://exa.com' 可以匹配 配置1<br>
6. uri = 'http://example.com' 可以匹配 配置1 配置2<br>
7. uri = 'https://example.com:8080' 无匹配<br>
8. uri = 'http://exampleaa.com:8080' 可以匹配 配置1<br>
9. uri = 'http://example.com:9180' 可以匹配 配置1 配置2<br>
10. uri = 'http://example.com:8080' 可以匹配 配置1 配置2 配置3<br>
11. uri = 'https://example.com:9180/path' 无匹配<br>
12. uri = 'http://exampleap.com:8080/path' 可以匹配 配置1<br>
13. uri = 'http://example.com:9180/path' 可以匹配 配置1 配置2<br>
14. uri = 'http://example.com:8080/path' 可以匹配 配置1 配置2 配置3<br>
## extensionAbilities标签
描述extensionAbilities的配置信息，标签值为数组类型，该标签下的配置只对当前extensionAbilities生效。
......
zh-cn/application-dev/quick-start/module-structure.md
浏览文件 @ 2729a6ef
......@@ -190,14 +190,15 @@ metadata对象示例：
## abilities对象的内部结构
**OpenHarmony中不允许应用隐藏启动图标**
**OpenHarmony中不允许应用隐藏入口图标**
OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置启动图标，那么系统会给该应用创建一个默认的图标显示在桌面上;<br>
用户点击该图标，将跳转到Settings的应用管理中对应的应用详情页面中。<br>
如果应用想要隐藏启动图标，需要配置AllowAppDesktopIconHide应用特权，具体配置方式参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。
OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置入口图标，那么系统会给该应用创建一个默认的图标显示在桌面上;<br>
用户点击该图标，将跳转到Settings的应用管理中对应的应用详情页面（图1）中。<br>
如果应用想要隐藏入口图标，需要配置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，那么详情页中显示的即为配置的。<br><br>
图1
![应用的详情页例图](figures/application_details.jpg)
**表8** **abilities对象的内部结构说明**
......@@ -411,40 +414,6 @@ skills示例：
]
```
**增强隐式查询功能**
支持Uri级别的前缀匹配。
当配置文件只配置scheme，或者只配置scheme和host，或者只配置scheme，host和port时，参数传入以配置文件为前缀的Uri，配置成功。
* 查询功能增强涉及以下接口<br>
[@ohos.bundle.bundleManager](../reference/apis/js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)<br>
1. function queryAbilityInfo(want: Want, abilityFlags: number, callback: AsyncCallback\<Array\<AbilityInfo>>): void;<br>
2. function queryAbilityInfo(want: Want, abilityFlags: number, userId: number, callback: AsyncCallback\<Array\<AbilityInfo>>): void;<br>
3. function queryAbilityInfo(want: Want, abilityFlags: number, userId?: number): Promise\<Array\<AbilityInfo>>;
* 配置要求<br>
abilities -> skills -> uris对象 <br>
配置1： 只配置 scheme = 'http' <br>
配置2： 只配置 ( scheme = 'http' ) + ( host = 'www.example.com' ) <br>
配置3： 只配置 ( scheme = 'http' ) + ( host = 'www.example.com' ) + ( port = '8080' )
* 前缀匹配<br>
[want](../application-models/want-overview.md)下uri，调用queryAbilityInfo查询接口<br>
1. uri = 'https://' 无匹配<br>
2. uri = 'http://' 可以匹配 配置1<br>
3. uri = 'https://www.example.com' 无匹配<br>
4. uri = 'https://www.exa.com' 无匹配<br>
5. uri = 'http://www.exa.com' 可以匹配 配置1<br>
6. uri = 'http://www.example.com' 可以匹配 配置1 配置2<br>
7. uri = 'https://www.example.com:8080' 无匹配<br>
8. uri = 'http://www.exampleaa.com:8080' 可以匹配 配置1<br>
9. uri = 'http://www.example.com:9180' 可以匹配 配置1 配置2<br>
10. uri = 'http://www.example.com:8080' 可以匹配 配置1 配置2 配置3<br>
11. uri = 'https://www.example.com:9180/query/student/name' 无匹配<br>
12. uri = 'http://www.exampleap.com:8080/query/student/name' 可以匹配 配置1<br>
13. uri = 'http://www.example.com:9180/query/student/name' 可以匹配 配置1 配置2<br>
14. uri = 'http://www.example.com:8080/query/student/name' 可以匹配 配置1 配置2 配置3<br>
## reqPermissions权限申请
**表12** **reqPermissions权限申请字段说明**
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或