Skip to content

D
Docs

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

通知 159
Star 292
Fork 28
D
Docs

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

提交 8236fa7a 编写于 作者: qq_41863798's avatar qq_41863798
浏览文件
操作

api 9 

Signed-off-by: qq_41863798's avatarlijiaying <1640106564@qq.com>
上级 98af4af0
隐藏空白更改
内联 并排
Showing with 197 addition and 0 deletion
zh-cn/application-dev/reference/apis/js-apis-Bundle.md
浏览文件 @ 8236fa7a
......@@ -1196,6 +1196,126 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
```
## bundle.queryExtensionAbilityInfosByWant
function queryExtensionAbilityInfosByWant(want: Want, extensionFlags: number, userId?: number): Promise<Array<ExtensionAbilityInfo>>
以异步方法根据给定的意图获取ExtensionAbility信息，使用Promise形式返回结果。
**需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED, ohos.permission.GET_BUNDLE_INFO
**系统能力：**
SystemCapability.BundleManager.BundleFramework
**参数：**
| 名称 | 类型 | 必填 | 描述 |
| ----------- | ------ | ---- | ------------------------------------------------------------ |
| want | Want | 是 | 包含要查询的应用程序包名称的意图。 |
| extensionFlags | number | 是 | 用于指定返回ExtensionAbilityInfo信息。默认值：0，取值范围：大于等于0。 |
| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0 |
**返回值：**
| 类型 | 说明 |
| ---------------------------- | ---------------------------- |
| Promise<Array\<ExtensionAbilityInfo>> | Promise形式返回ExtensionAbility信息。 |
**示例：**
```js
let extensionFlags = 0;
let userId = 100;
let want = {
bundleName : "com.example.myapplication",
abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryExtensionAbilityInfosByWant(want, extensionFlags, userId)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
```
## bundle.queryExtensionAbilityInfosByWant
function queryExtensionAbilityInfosByWant(want: Want, extensionFlags: number, userId: number, callback: AsyncCallback<Array<ExtensionAbilityInfo>>): void
以异步方法根据给定的意图获取ExtensionAbility信息，使用callback形式返回结果。
**系统能力：**
SystemCapability.BundleManager.BundleFramework
**参数：**
| 名称 | 类型 | 必填 | 描述 |
| ----------- | ---------------------------------- | ---- | ------------------------------------------------------------ |
| want | Want | 是 | 指示包含要查询的应用程序包名称的意图。 |
| extensionFlags | number | 是 | 用于指定返回ExtensionAbilityInfo信息。默认值：0，取值范围：枚举值，大于等于0。 |
| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0 |
| callback | AsyncCallback<Array\<ExtensionAbilityInfo>> | 是 | 程序启动作为入参的回调函数，返回ExtensionAbility信息。 |
**示例：**
```js
let extensionFlags = 0;
let userId = 100;
let want = {
bundleName : "com.example.myapplication",
abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryExtensionAbilityInfosByWant(want, extensionFlags, userId, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
```
## bundle.queryExtensionAbilityInfosByWant
function queryExtensionAbilityInfosByWant(want: Want, extensionFlags: number, callback: AsyncCallback<Array<ExtensionAbilityInfo>>): void;
以异步方法根据给定的意图获取ExtensionAbility信息，使用callback形式返回结果。
**系统能力：**
SystemCapability.BundleManager.BundleFramework
**参数：**
| 名称 | 类型 | 必填 | 描述 |
| ----------- | ---------------------------------- | ---- | ------------------------------------------------------------ |
| want | Want | 是 | 指示包含要查询的应用程序包名称的意图。 |
| extensionFlags | number | 是 | 用于指定返回ExtensionAbilityInfo信息。默认值：0，取值范围：大于等于0。 |
| callback | AsyncCallback<Array\<ExtensionAbilityInfo>> | 是 | 程序启动作为入参的回调函数，返回ExtensionAbility信息。 |
**示例：**
```js
let extensionFlags = 0;
let want = {
bundleName : "com.example.myapplication",
abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryExtensionAbilityInfosByWant(want, extensionFlags, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
```
## ElementName
**系统能力:** 以下各项对应的系统能力均为SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask
......@@ -1231,6 +1351,7 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
| GET_APPLICATION_INFO_WITH_PERMISSION | 0x00000008 | 获取包括权限的应用信息 |
| GET_BUNDLE_WITH_REQUESTED_PERMISSION | 0x00000010 | 获取包括所需权限的包信息 |
| GET_ABILITY_INFO_WITH_METADATA | 0x00000020 | 获取ability的元数据信息 |
| GET_BUNDLE_WITH_EXTENSION_ABILITY | 0x00000020 | 获取包括Ability信息的扩展包信息 |
| GET_APPLICATION_INFO_WITH_METADATA | 0x00000040 | 获取应用的元数据信息 |
| GET_ABILITY_INFO_SYSTEMAPP_ONLY | 0x00000080 | 获取仅包括系统应用的ability信息 |
| GET_ABILITY_INFO_WITH_DISABLE | 0x00000100 | 获取包括被禁用的ability信息 |
......@@ -1278,6 +1399,7 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
| minCompatibleVersionCode | number | 是 | 否 | 分布式场景下的应用包兼容的最低版本 |
| entryInstallationFree | boolean | 是 | 否 | Entry是否支持免安装 |
| reqPermissionStates | Array<number> | 是 | 否 | 申请权限的授予状态 |
| extensionAbilityInfo | Array<ExtensionAbilityInfo> | 是 | 否 | ability的可扩展信息 |
## ApplicationInfo
......@@ -1305,9 +1427,11 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
| customizeData | Map<string, Array<CustomizeData>> | 是 | 是 | 应用程序的自定义数据 |
| codePath | string | 是 | 否 | 应用程序的安装目录 |
| metaData | Map<string, Array<CustomizeData>> | 是 | 否 | 应用程序的自定义元信息 |
| metaData | Map<string, Array<Metadata>> | 是 | 否 | 应用程序的元信息 |
| removable | boolean | 是 | 否 | 应用程序是否可以被移除 |
| accessTokenId | number | 是 | 否 | 应用程序的accessTokenId |
| uid | number | 是 | 否 | 应用程序的uid |
| entityType | string | 是 | 否 | 应用程序的实体类型 |
## ModuleInfo
......@@ -1357,6 +1481,8 @@ Hap模块信息
| mainAbilityName | string | 是 | 否 | 入口Ability名称 |
| installationFree | boolean | 是 | 否 | 是否支持免安装 |
| mainElementName | string | 是 | 否 | 入口ability信息 |
| extensionAbilityInfo | Array<ExtensionAbilityInfo> | 是 | 否 | extensionAbility信息 |
| metadata | Array<Metadata> | 是 | 否 | Ability的元信息 |
## ReqPermissionDetail
......@@ -1415,6 +1541,7 @@ Ability信息
| uri | string | 是 | 否 | 获取Ability的统一资源标识符（URI） |
| labelId | number | 是 | 否 | Ability的标签id |
| subType | AbilitySubType | 是 | 否 | Ability中枚举使用的模板的子类型 |
| metaData | Array<CustomizeData> | 是 | 否 | ability的自定义信息 |
| metaData | Array<Metadata> | 是 | 否 | ability的自定义元信息 |
| enabled | boolean | 是 | 否 | ability是否可用 |
......@@ -1465,3 +1592,73 @@ Ability的子类型
| ----------- | ---- | ----------------------------- |
| UNSPECIFIED | 0 | 未定义Ability子类型 |
| CA | 1 | Ability子类型是带有 UI 的服务 |
## ExtensionAbilityType
ExtensionAbility的类型
**系统能力:** 以下各项对应的系统能力均为SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask
| 名称 | 类型 | 说明 |
| -------------------- | ---- | ----------------------------- |
| FORM | 0 | ExtensionAbility的类型包括卡片 |
| WORK_SCHEDULER | 1 | ExtensionAbility的类型包括行程安排 |
| INPUT_METHOD | 2 | ExtensionAbility的类型包括输入法 |
| SERVICE | 3 | ExtensionAbility的类型包括服务 |
| ACCESSIBILITY | 4 | ExtensionAbility的类型包括无障碍 |
| DATA_SHARE | 5 | ExtensionAbility的类型包括数据共享 |
| FILE_SHARE | 6 | ExtensionAbility的类型包括文件共享 |
| STATIC_SUBSCRIBER | 7 | ExtensionAbility的类型包括订阅者 |
| WALLPAPER | 8 | ExtensionAbility的类型包括墙纸 |
| UNSPECIFIED | 9 | ExtensionAbility未指定类型 |
## ExtensionFlag
扩展标志
**系统能力:** 以下各项对应的系统能力均为SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask
| 名称 | 默认值 | 说明 |
| ------ | ------ | ------ |
| GET_EXTENSION_INFO_DEFAULT | 0x00000000 | 获取默认的extensionAbilityInfo |
| GET_EXTENSION_INFO_WITH_PERMISSION | 0x00000002 | 获取携带权限信息的extensionAbilityInfo |
| GET_EXTENSION_INFO_WITH_APPLICATION | 0x00000004 | 获取携带应用信息的extensionAbilityInfo |
| GET_EXTENSION_INFO_WITH_METADATA | 0x00000020 | 获取携带元数据信息的extensionAbilityInfo |
## ExtensionAbilityInfo
ExtensionAbility信息
**系统能力:** 以下各项对应的系统能力均为SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| bundleName | string | 是 | 否 | 应用包名 |
| moduleName | string | 是 | 否 | ExtensionAbility所属的HAP包的名称 |
| name | string | 是 | 否 | ExtensionAbility名称 |
| labelId | number | 是 | 否 | ExtensionAbility的标签id |
| descriptionId | number | 是 | 否 | ExtensionAbility的描述id |
| iconId | number | 是 | 否 | ExtensionAbility的图标id |
| isVisible | boolean | 是 | 否 | 判断ExtensionAbility是否可以被其他应用调用 |
| extensionAbilityType | bundle.ExtensionAbilityType | 是 | 否 | ExtensionAbility类型 |
| permissions | Array<string> | 是 | 否 | 被其他应用ExtensionAbility调用时需要申请的权限集合 |
| applicationInfo | ApplicationInfo | 是 | 否 | 应用程序的配置信息 |
| metaData | Array<Metadata> | 是 | 否 | ExtensionAbility的元信息 |
| enabled | boolean | 是 | 否 | ExtensionAbility是否可用 |
| readPermission | string | 是 | 否 | 读取ExtensionAbility数据所需的权限 |
| writePermission | string | 是 | 否 | 向ExtensionAbility写数据所需的权限 |
## Metadata
元数据信息
**系统能力:** 以下各项对应的系统能力均为SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----- | ------ | ---- | ---- | ---------------- |
| name | string | 是 | 是 | 元数据名称 |
| value | string | 是 | 是 | 元数据值 |
| resource | string | 是 | 是 | 元数据资源 |
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或