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 e0d9bdcbff9413cc463ee502f2c4b81c99afa1b8..fd36d620f326c7bd127deb89b8e06261b99327f8 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 @@ -35,9 +35,7 @@ Stage模型支持对组件配置入口图标和入口标签。入口图标和入口标签会显示在桌面上。 - 入口图标需要在[module.json5配置文件](../quick-start/module-configuration-file.md)中配置，在abilities标签下面有icon标签。例如希望在桌面上显示该UIAbility的图标，则需要在skills标签下面的entities中添加"entity.system.home"、actions中添加"action.system.home"。同一个应用有多个UIAbility配置上述字段时，桌面上会显示出多个图标，分别对应各自的UIAbility。 - - 入口标签需要在[module.json5配置文件](../quick-start/module-configuration-file.md)中配置，在abilities标签下面有label标签。例如希望在桌面上显示该UIAbility的图标，则需要在skills标签下面的entities中添加"entity.system.home"、actions中添加"action.system.home"。同一个应用有多个UIAbility配置上述字段时，桌面上会显示出多个标签，分别对应各自的UIAbility。 + 入口图标需要在[module.json5配置文件](../quick-start/module-configuration-file.md)中配置，在abilities标签下面有icon标签。例如希望在桌面上显示该UIAbility的图标，则需要在skills标签下面的entities中添加"entity.system.home"、actions中添加"ohos.want.action.home"。同一个应用有多个UIAbility配置上述字段时，桌面上会显示出多个图标，分别对应各自的UIAbility。 ```json { @@ -54,7 +52,7 @@ "entity.system.home" ], "actions": [ - "action.system.home" + "ohos.want.action.home" ] } ], 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 95190d98594c1c9a32c76b5a12d2fbed5d840ab8..a7b664dc4149d0b5db4f41f9db298477a7a25951 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -200,7 +200,64 @@ deviceTypes示例： ## abilities标签 -ablities标签描述UIAbility组件的配置信息，标签值为数组类型，该标签下的配置只对当前UIAbility生效。 +abilities标签描述UIAbility组件的配置信息，标签值为数组类型，该标签下的配置只对当前UIAbility生效。 + +**OpenHarmony中不允许应用隐藏启动图标** + +OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置启动图标，那么系统将应用app.json中的icon作为启动图标，并显示在桌面上。
+用户点击该图标，将跳转到Settings的应用管理中对应的应用详情页面中。
+如果应用想要隐藏启动图标，需要配置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中包含Ability + * 配置文件（module.json5）中abilities配置中设置了启动图标 + * 该应用没有隐藏图标的特权 + * 返回的桌面图标为该Ability配置的图标 + * 返回的桌面Label为该Ability配置的Label（如果没有配置Label，返回包名） + * 返回的组件名为该Ability的组件名 + * 用户点击该桌面图标，页面跳转到该Ability首页 + * 该应用具有隐藏图标的特权 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。 + * 配置文件（module.json5）中abilities配置中未设置启动图标 + * 该应用没有隐藏图标的特权 + * 返回的桌面图标为app配置下的图标（app.json中icon为必填项） + * 返回的桌面Label为app配置下的label（app.json中label为必填项） + * 返回的组件名为应用详情页面的组件名（该组件为系统内置） + * 用户点击该桌面图标，页面跳转到该应用的详情页面 + * 该应用具有隐藏图标的特权 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。 +* HAP中不包含Ability + * 该应用没有隐藏图标的特权 + * 返回的桌面图标为app配置下的图标（app.json中icon为必填项） + * 返回的桌面Label为app配置下的label（app.json中label为必填项） + * 返回的组件名为应用详情页面的组件名（该组件为系统内置） + * 用户点击该桌面图标，页面跳转到该应用的详情页面 + * 该应用具有隐藏图标的特权 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。

+ **表4** **abilities标签说明** @@ -334,6 +391,38 @@ skills示例： } ``` +**增强隐式查询功能** + +支持Uri级别的前缀匹配。 +当配置文件只配置scheme，或者只配置scheme和host，或者只配置scheme，host和port时，参数传入以配置文件为前缀的Uri，配置成功。 + + + * 查询功能增强涉及以下接口
+ [@ohos.bundle.bundleManager](../reference/apis/js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)
+ 1. function queryAbilityInfo(want: Want, abilityFlags: number, callback: AsyncCallback>): void;
+ 2. function queryAbilityInfo(want: Want, abilityFlags: number, userId: number, callback: AsyncCallback>): void;
+ 3. function queryAbilityInfo(want: Want, abilityFlags: number, userId?: number): Promise>; + * 配置要求
+ abilities -> skills -> uris对象
+ 配置1： 只配置 scheme = 'http'
+ 配置2： 只配置 ( scheme = 'http' ) + ( host = 'example.com' )
+ 配置3： 只配置 ( scheme = 'http' ) + ( host = 'example.com' ) + ( port = '8080' ) + * 前缀匹配
+ 参数[want](../application-models/want-overview.md)下uri，调用queryAbilityInfo查询接口
+ 1. uri = 'https://' 无匹配
+ 2. uri = 'http://' 可以匹配 配置1
+ 3. uri = 'https://example.com' 无匹配
+ 4. uri = 'https://exa.com' 无匹配
+ 5. uri = 'http://exa.com' 可以匹配 配置1
+ 6. uri = 'http://example.com' 可以匹配 配置1 配置2
+ 7. uri = 'https://example.com:8080' 无匹配
+ 8. uri = 'http://exampleaa.com:8080' 可以匹配 配置1
+ 9. uri = 'http://example.com:9180' 可以匹配 配置1 配置2
+ 10. uri = 'http://example.com:8080' 可以匹配 配置1 配置2 配置3
+ 11. uri = 'https://example.com:9180/path' 无匹配
+ 12. uri = 'http://exampleap.com:8080/path' 可以匹配 配置1
+ 13. uri = 'http://example.com:9180/path' 可以匹配 配置1 配置2
+ 14. uri = 'http://example.com:8080/path' 可以匹配 配置1 配置2 配置3
## extensionAbilities标签 diff --git a/zh-cn/application-dev/quick-start/module-structure.md b/zh-cn/application-dev/quick-start/module-structure.md index a1c8867f3d3577f3cefc2efdd143885430565b86..5da4b2204179728ef1ddfd900fcaf75066256d98 100644 --- a/zh-cn/application-dev/quick-start/module-structure.md +++ b/zh-cn/application-dev/quick-start/module-structure.md @@ -190,6 +190,66 @@ metadata对象示例： ## abilities对象的内部结构 +**OpenHarmony中不允许应用隐藏启动图标** + +OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置启动图标，那么系统会给该应用创建一个默认的图标显示在桌面上;
+用户点击该图标，将跳转到Settings的应用管理中对应的应用详情页面中。
+如果应用想要隐藏启动图标，需要配置AllowAppDesktopIconHide应用特权，具体配置方式参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 + + +**启动图标的设置:** 需要在配置文件（config.json）中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中包含Page类型的Ability + * 配置文件（config.json）中abilities配置中设置了启动图标 + * 该应用没有隐藏图标的特权 + * 返回的桌面图标为该Ability配置的图标 + * 返回的桌面Label为该Ability配置的Label（如果没有配置Label，返回包名） + * 返回的组件名为该Ability的组件名 + * 用户点击该桌面图标，页面跳转到该Ability首页 + * 该应用具有隐藏图标的特权 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。 + * 配置文件（config.json）中abilities配置中未设置启动图标 + * 该应用没有隐藏图标的特权 + * 返回的桌面图标为系统默认图标 + * 返回的桌面Label为该应用的包名 + * 返回的组件名为应用详情页面的组件名（该组件为系统内置） + * 用户点击该桌面图标，页面跳转到该应用的详情页面 + * 该应用具有隐藏图标的特权 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。 +* HAP中不包含Page类型的Ability + * 该应用没有隐藏图标的特权 + * 返回的桌面图标为系统默认图标 + * 返回的桌面Label为该应用的包名 + * 返回的组件名为应用详情页面的组件名（该组件为系统内置） + * 用户点击该桌面图标，页面跳转到该应用的详情页面 + * 该应用具有隐藏图标的特权 + * 桌面查询时不返回应用信息，不会在桌面上显示对应的图标。 + +注：应用详情页面中显示的图标与label,可能与桌面上显示的不同。如果非Page类型的ability配置了入口图标和label，那么详情页中显示的即为配置的。

+ + **表8** **abilities对象的内部结构说明** | 属性名称 | 含义 | 数据类型 | 是否可缺省 | @@ -351,6 +411,40 @@ skills示例： ] ``` +**增强隐式查询功能** + +支持Uri级别的前缀匹配。 +当配置文件只配置scheme，或者只配置scheme和host，或者只配置scheme，host和port时，参数传入以配置文件为前缀的Uri，配置成功。 + + * 查询功能增强涉及以下接口
+ [@ohos.bundle.bundleManager](../reference/apis/js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)
+ 1. function queryAbilityInfo(want: Want, abilityFlags: number, callback: AsyncCallback>): void;
+ 2. function queryAbilityInfo(want: Want, abilityFlags: number, userId: number, callback: AsyncCallback>): void;
+ 3. function queryAbilityInfo(want: Want, abilityFlags: number, userId?: number): Promise>; + * 配置要求
+ abilities -> skills -> uris对象
+ 配置1： 只配置 scheme = 'http'
+ 配置2： 只配置 ( scheme = 'http' ) + ( host = 'www.example.com' )
+ 配置3： 只配置 ( scheme = 'http' ) + ( host = 'www.example.com' ) + ( port = '8080' ) + * 前缀匹配
+ [want](../application-models/want-overview.md)下uri，调用queryAbilityInfo查询接口
+ 1. uri = 'https://' 无匹配
+ 2. uri = 'http://' 可以匹配 配置1
+ 3. uri = 'https://www.example.com' 无匹配
+ 4. uri = 'https://www.exa.com' 无匹配
+ 5. uri = 'http://www.exa.com' 可以匹配 配置1
+ 6. uri = 'http://www.example.com' 可以匹配 配置1 配置2
+ 7. uri = 'https://www.example.com:8080' 无匹配
+ 8. uri = 'http://www.exampleaa.com:8080' 可以匹配 配置1
+ 9. uri = 'http://www.example.com:9180' 可以匹配 配置1 配置2
+ 10. uri = 'http://www.example.com:8080' 可以匹配 配置1 配置2 配置3
+ 11. uri = 'https://www.example.com:9180/query/student/name' 无匹配
+ 12. uri = 'http://www.exampleap.com:8080/query/student/name' 可以匹配 配置1
+ 13. uri = 'http://www.example.com:9180/query/student/name' 可以匹配 配置1 配置2
+ 14. uri = 'http://www.example.com:8080/query/student/name' 可以匹配 配置1 配置2 配置3
+ + + ## reqPermissions权限申请 **表12** **reqPermissions权限申请字段说明** diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md b/zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md index eed71d969771b698c751d7093c5a5697253d99d5..bec1ddd3a1f79fb9892f1718544af54034a29b1d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md @@ -99,7 +99,7 @@ featureAbility.startAbility( { want: { - action: 'action.system.home', + action: 'ohos.want.action.home', entities: ['entity.system.home'], type: 'MIMETYPE', flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, @@ -176,7 +176,7 @@ featureAbility.startAbilityForResult( { want: { - action: 'action.system.home', + action: 'ohos.want.action.home', entities: ['entity.system.home'], type: 'MIMETYPE', flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, @@ -230,7 +230,7 @@ featureAbility.startAbilityForResult( { want: { - action: 'action.system.home', + action: 'ohos.want.action.home', entities: ['entity.system.home'], type: 'MIMETYPE', flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, @@ -282,7 +282,7 @@ featureAbility.terminateSelfWithResult( resultCode: 1, want: { - action: 'action.system.home', + action: 'ohos.want.action.home', entities: ['entity.system.home'], type: 'MIMETYPE', flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, @@ -339,7 +339,7 @@ featureAbility.terminateSelfWithResult( resultCode: 1, want: { - action: 'action.system.home', + action: 'ohos.want.action.home', entities: ['entity.system.home'], type: 'MIMETYPE', flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md b/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md index e72eb4246eac4e18116566d4a3556f723a5de2ff..d392a1603b632ce9f0741e72efd4025687712c23 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md @@ -47,7 +47,7 @@ particleAbility.startAbility( { want: { - action: 'action.system.home', + action: 'ohos.want.action.home', entities: ['entity.system.home'], type: 'MIMETYPE', flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, @@ -98,7 +98,7 @@ particleAbility.startAbility( { want: { - action: 'action.system.home', + action: 'ohos.want.action.home', entities: ['entity.system.home'], type: 'MIMETYPE', flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, diff --git a/zh-cn/application-dev/security/app-provision-structure.md b/zh-cn/application-dev/security/app-provision-structure.md index 542660387d477046f84009bfe31cd54458c22818..2f95b201c3bba1cf7bc5083d9d99360201241603 100644 --- a/zh-cn/application-dev/security/app-provision-structure.md +++ b/zh-cn/application-dev/security/app-provision-structure.md @@ -63,6 +63,8 @@ HarmonyAppProvision文件示例： ### bundle-info对象内部结构 +**说明：** HarmonyAppProvision文件中的bundle-info对象中bundle-name需要和所签名应用的包名bundleName（config.json/module.json5）保持一致。为了防止同一个HarmonyAppProvision配置文件任意用于不同应用的签名，在应用安装过程中，系统会校验HAP签名信息的bundleName与HAP的配置文件中的bundleName是否一致，如果不一致，HAP无法安装。 + | 属性名称 | 含义 | 数据类型 | 是否必选 | 是否可缺省 | | ------------------------ | ------------------------------- | ------- | -------- | --------- | | developer-id | 表示开发者的唯一ID号，用于OEM厂商标识开发者，开源社区版本该属性不做强制要求。 | 字符串 | 必选 | 不可缺省 |