!16614 【资料补充】同步d.ts服务路由api

Merge pull request !16614 from junyi233/myfeature

zh-cn/application-dev/reference/apis/js-apis-bundleManager-businessAbilityInfo.md

+# BusinessAbilityInfo
+
+> **说明：**
+> 本模块首批接口从API version 10 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+
+包含基本业务路由信息。
+
+## BusinessAbilityInfo
+
+**系统能力**: SystemCapability.BundleManager.BundleFramework.Core
+
+| 名称                              | 类型                                                         | 可读 | 可写 | 说明                 |
+| --------------------------------- | ------------------------------------------------------------ | ---- | ---- | -------------------- |
+| bundleName                        | string                                                       | 是   | 否   | 表示应用程序的bundleName。 |
+| moduleName                        | string                                                       | 是   | 否   | 表示应用程序的moduleName。 |
+| name                              | string                                                       | 是   | 否   | 业务路由ability名。 |
+| labelId                           | number                                                       | 是   | 否   | 模块标签的资源id。       |
+| descriptionId                     | number                                                       | 是   | 否   | 描述信息的资源id。       |
+| iconId                            | number                                                       | 是   | 否   | 描述ability信息的图标id。 |
+| businessType | [businessAbilityRouter.BusinessType](js-apis-businessAbilityRouter.md#businesstype) | 是 | 否 | 标识枚举业务类型。 |
+| applicationInfo | Array\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)> | 是   | 否   | 应用程序的信息。  |

zh-cn/application-dev/reference/apis/js-apis-businessAbilityRouter.md

+# @ohos.app.businessAbilityRouter (业务路由模块)
+
+本模块用于查询当前设备上安装的各种应用程序的路由ability信息。通过业务路由提供标准的业务模板和业务管理能力，开发者可以按照指定的业务类别注册标准业务，丰富的业务形成一个庞大的超市。系统应用或者三方应用可以从业务路由中获取所需业务，并选择合适的业务使用。同时业务路由提供统一的跳转管控规则，控制应用与业务之间的合理跳转，杜绝前后台任意的跳转行为，避免三方应用通过跳转变相分发，解决安全弱、体验差的问题。
+
+> **说明：**
+>
+> 本模块首批接口从API version 10 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+
+本模块接口为系统接口。
+
+## 导入模块
+
+``` ts
+import businessAbilityRouter from '@ohos.app.businessAbilityRouter';
+```
+
+## 权限列表
+
+| 权限                                       | 权限等级     | 描述                 |
+| ------------------------------------------ | ------------ | -------------------- |
+| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息。 |
+
+权限等级参考[权限等级说明](../../security/accesstoken-overview.md#权限等级说明)。
+
+## BusinessType
+
+此枚举值用于标识过滤条件类型。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
+
+**系统接口：** 此接口为系统接口。
+
+| 名称        | 值   | 说明                                 |
+| ----------- | ---- | ------------------------------------ |
+| SHARE       | 0    | 标识具有共享类型的ability信息。 |
+| UNSPECIFIED | 255  | 标识未指定类型的ability信息。   |
+
+## BusinessAbilityFilter
+
+此过滤值用于过滤查询的ability类型。
+
+**系统能力：** SystemCapability.BundleManager.BundleFrameWork.FreeInstall
+
+**系统接口：** 此接口为系统接口。
+
+| 名称         | 类型         | 可读 | 可写 | 说明                                   |
+| ------------ | ------------ | ---- | ---- | -------------------------------------- |
+| businessType | BusinessType | 是   | 否   | 标识ability信息的类型。           |
+| mimeType     | string       | 是   | 否   | 标识支持mime类型的ability信息。 |
+| uri          | string       | 是   | 否   | 标识ability信息支持的uri。        |
+
+## businessAbilityRouter.queryBusinessAbilityInfo
+
+queryBusinessAbilityInfo(filter: BusinessAbilityFilter, callback: AsyncCallback\<Array\<BusinessAbilityInfo\>\>): void;
+
+以异步方法通过给定的过滤条件查询ability信息。使用callback异步回调。成功返回查询到的路由ability信息，失败返回对应错误信息。
+
+**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+
+**系统能力：** SystemCapability.BundleManager.BundleFramework.Core
+
+**系统API：**  此接口为系统接口。
+
+**参数：**
+
+| 参数名       | 类型     | 必填   | 说明                                    |
+| ----------- | ------ | ---- | --------------------------------------- |
+| filter | [BusinessAbilityFilter](#businessabilityfilter) | 是    | 支持按业务类型过滤的对象。 |
+| callback | AsyncCallback\<Array\<[BusinessAbilityInfo](js-apis-bundleManager-businessAbilityInfo.md#businessabilityinfo)\>\> | 是 | 回调函数。返回查询到的ability信息，否则为错误对象。 |
+
+**示例：**
+
+```ts
+import businessAbilityRouter from '@ohos.app.businessAbilityRouter';
+let filter = {businessType: businessAbilityRouter.BusinessType.SHARE};
+
+try {
+    businessAbilityRouter.queryBusinessAbilityInfo(filter)
+        .then(() => {
+            console.info('queryBusinessAbilityInfo success');
+        }).catch((error) => {
+            console.error('queryBusinessAbilityInfo failed ' + error.message);
+        });
+} catch (error) {
+    console.error('queryBusinessAbilityInfo failed ' + error.message);
+}
+```
+
+## businessAbilityRouter.queryBusinessAbilityInfo
+
+queryBusinessAbilityInfo(filter: BusinessAbilityFilter): Promise\<Array\<BusinessAbilityInfo\>\>;
+
+以异步方法通过给定的过滤条件查询ability信息。使用Promise异步回调，成功返回查询到的路由ability信息，失败返回对应错误信息。
+
+**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+
+**系统能力：** SystemCapability.BundleManager.BundleFramework.Core
+
+**系统API：**  此接口为系统接口。
+
+**参数：**
+
+| 参数名       | 类型                              | 必填   | 说明                                    |
+| ----------- | ------------------------------- | ---- | --------------------------------------- |
+| filter | [BusinessAbilityFilter](#businessabilityfilter) | 是    | 包含要查询的ability信息的筛选类型。  |
+
+**返回值：**
+
+| 类型                                                         | 说明                                        |
+| ------------------------------------------------------------ | ------------------------------------------- |
+| Promise\<Array\<[BusinessAbilityInfo](js-apis-bundleManager-businessAbilityInfo.md#businessabilityinfo)\>\> | Promise对象，返回符合过滤条件的ability信息。 |
+
+**示例：**
+
+```ts
+import businessAbilityRouter from '@ohos.app.businessAbilityRouter';
+let filter = {businessType: businessAbilityRouter.BusinessType.SHARE};
+
+try {
+    businessAbilityRouter.queryBusinessAbilityInfo(filter, (error, data) => {
+        if (error) {
+            console.error('queryBusinessAbilityInfo failed ' + error.message);
+            return;
+        }
+        console.info('queryBusinessAbilityInfo success');
+    });
+} catch (error) {
+    console.error('queryBusinessAbilityInfo failed ' + error.message);
+}
+```