Bundle模块(JS端SDK接口)
说明: 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 API9 当前为Canary版本,仅供试用,不保证接口可稳定调用。
导入模块
import bundle from '@ohos.bundle';
开发前请熟悉鸿蒙开发指导文档 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
系统能力
SystemCapability.BundleManager.BundleFramework
权限列表
权限 | 权限等级 | 描述 |
---|---|---|
ohos.permission.GET_BUNDLE_INFO | normal | 仅限查询本应用信息 |
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息 |
ohos.permission.INSTALL_BUNDLE | system_core | 可安装、卸载应用 |
bundle.getApplicationInfo
getApplicationInfo(bundleName: string, bundleFlags: number, userId?: number): Promise
以异步方法根据给定的包名获取ApplicationInfo,使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 要查询的应用程序包名称。 |
bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
userId | number | 否 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
返回值:
类型 | 说明 |
---|---|
Promise<[ApplicationInfo]> | Promise形式返回应用程序信息。 |
示例:
let bundleName = "com.example.myapplication";
let bundleFlags = 0;
let userId = 100;
bundle.getApplicationInfo(bundleName, bundleFlags, userId)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getApplicationInfo
getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback): void
以异步方法根据给定的包名获取ApplicationInfo,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 要查询的应用程序包名称。 |
bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
userId | number | 是 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
callback | AsyncCallback<[ApplicationInfo]> | 是 | 程序启动作为入参的回调函数,返回应用程序信息。 |
示例:
let bundleName = "com.example.myapplication";
let bundleFlags = 0;
let userId = 100;
bundle.getApplicationInfo(bundleName, bundleFlags, userId, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getApplicationInfo
getApplicationInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback): void
以异步方法根据给定的包名获取ApplicationInfo,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 要查询的应用程序包名称。 |
bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
callback | AsyncCallback<[ApplicationInfo]> | 是 | 程序启动作为入参的回调函数,返回应用程序信息。 |
示例:
let bundleName = "com.example.myapplication";
let bundleFlags = 0;
bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAllBundleInfo
getAllBundleInfo(bundleFlag: BundleFlag, userId?: number): Promise>
以异步方法获取系统中所有可用的BundleInfo,使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
userId | number | 否 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
返回值:
类型 | 说明 |
---|---|
Promise> | Promise形式返回所有可用的BundleInfo |
示例:
let bundleFlag = 0;
let userId = 100;
bundle.getAllBundleInfo(bundleFlag, userId)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAllBundleInfo
getAllBundleInfo(bundleFlag: BundleFlag, callback: AsyncCallback>): void
以异步方法获取系统中所有可用的BundleInfo,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数,返回所有可用的BundleInfo。 |
示例:
let bundleFlag = 0;
bundle.getAllBundleInfo(bundleFlag, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAllBundleInfo
getAllBundleInfo(bundleFlag: BundleFlag, userId: number, callback: AsyncCallback>): void
以异步方法获取系统中所有可用的BundleInfo,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
userId | number | 是 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数,返回所有可用的BundleInfo。 |
示例:
let bundleFlag = 0;
let userId = 100;
bundle.getAllBundleInfo(bundleFlag, userId, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getBundleInfo
getBundleInfo(bundleName: string, bundleFlags: number, options?: BundleOptions): Promise
以异步方法根据给定的包名获取BundleInfo,使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 包名 |
bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
options | [BundleOptions] | 否 | 包含userid。 |
返回值:
类型 | 说明 |
---|---|
Promise<[BundleInfo]> | 返回值为Promise对象,Promise中包含包信息。 |
示例:
let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
"userId" : 100
};
bundle.getBundleInfo(bundleName, bundleFlags, options)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getBundleInfo
getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback): void
以异步方法根据给定的包名获取BundleInfo,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 包名 |
bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
callback | AsyncCallback<[BundleInfo]> | 是 | 程序启动作为入参的回调函数,返回包信息。 |
示例:
let bundleName = "com.example.myapplication";
let bundleFlags = 1;
bundle.getBundleInfo(bundleName, bundleFlags, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getBundleInfo
getBundleInfo(bundleName: string, bundleFlags: number, options: BundleOptions, callback: AsyncCallback): void
以异步方法根据给定的包名获取BundleInfo,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 包名 |
bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
options | [BundleOptions] | 是 | 包含userid。 |
callback | AsyncCallback<[BundleInfo]> | 是 | 程序启动作为入参的回调函数,返回包信息。 |
示例:
let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
"userId" : 100
};
bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAllApplicationInfo
getAllApplicationInfo(bundleFlags: number, userId?: number): Promise>
获取指定用户下所有已安装的应用信息,通过Promise获取返回值。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
userId | number | 否 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
返回值:
类型 | 说明 |
---|---|
Promise> | 返回值为Promise对象,Promise中包含应用信息列表。 |
示例:
let bundleFlags = 8;
let userId = 100;
bundle.getAllApplicationInfo(bundleFlags, userId)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAllApplicationInfo
getAllApplicationInfo(bundleFlags: number, userId: number, callback: AsyncCallback>): void
获取指定用户下所有已安装的应用信息,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
userId | number | 否 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数,返回应用信息列表。 |
示例:
let bundleFlags = 8;
let userId = 100;
bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAllApplicationInfo
getAllApplicationInfo(bundleFlags: number, callback: AsyncCallback>) : void;
获取指定用户下所有已安装的应用信息,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。 |
callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数,返回应用信息列表。 |
示例:
let bundleFlags = 8;
bundle.getAllApplicationInfo(bundleFlags, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getBundleInstaller
getBundleInstaller(): Promise;
获取用于安装包的接口
需要权限:
ohos.permission.INSTALL_BUNDLE
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
返回值:
类型 | 说明 |
---|---|
Promise<[BundleInstaller]> | 返回值为Promise对象,Promise中包含安装信息。 |
bundle.getBundleInstaller
getBundleInstaller(callback: AsyncCallback): void;
获取用于安装包的接口
需要权限:
ohos.permission.INSTALL_BUNDLE
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
callback | AsyncCallback<[BundleInstaller]> | 是 | 安装应用程序包。 |
bundle.getBundleArchiveInfo
getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCallback) : void
获取有关ohos能力包(HAP)中包含的应用程序包的信息
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
hapFilePath | string | 是 | 指示存储HAP的路径,路径应该是数据的相对路径。 |
bundleFlags | number | 是 | 指示用于指定要删除的BundleInfo对象中包含的信息的标志。 |
callback | AsyncCallback<[BundleInfo]> | 是 | 程序启动作为入参的回调函数,返回BundleInfo信息。 |
bundle.getBundleArchiveInfo
getBundleArchiveInfo(hapFilePath: string, bundleFlags: number) : Promise;
获取有关ohos能力包(HAP)中包含的应用程序包的信息
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
hapFilePath | string | 是 | 指示存储HAP的路径,路径应该是数据的相对路径。 |
bundleFlags | number | 是 | 指示用于指定要删除的BundleInfo对象中包含的信息的标志。 |
返回值:
类型 | 说明 |
---|---|
Promise<[BundleInfo]> | 返回值为Promise对象,Promise中包含应用包的信息。 |
bundle.cleanBundleCacheFiles8+
cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback): void;
清除指定应用程序的缓存数据
需要权限:
ohos.permission.REMOVE_CACHE_FILES
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 指示要清除其缓存数据的应用程序包名称. |
callback | AsyncCallback | 是 | 为返回操作结果而调用的回调。 |
bundle.cleanBundleCacheFiles8+
cleanBundleCacheFiles(bundleName: string): Promise
清除指定应用程序的缓存数据
需要权限:
ohos.permission.REMOVE_CACHE_FILES
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 指示要清除其缓存数据的应用程序包名称. |
返回值:
类型 | 说明 |
---|---|
Promise | 返回值为Promise对象,Promise中为空。 |
bundle.setApplicationEnabled8+
setApplicationEnabled(bundleName: string, isEnable: boolean, callback: AsyncCallback): void;
设置是否启用指定的应用程序
需要权限:
ohos.permission.CHANGE_ABILITY_ENABLED_STATE
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名称。 |
isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用,false禁用。 |
callback | AsyncCallback | 是 | 为返回操作结果而调用的回调。 |
bundle.setApplicationEnabled8+
setApplicationEnabled(bundleName: string, isEnable: boolean): Promise
设置是否启用指定的应用程序
需要权限:
ohos.permission.CHANGE_ABILITY_ENABLED_STATE
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名称。 |
isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用,false禁用。 |
返回值:
类型 | 说明 |
---|---|
Promise | 返回值为Promise对象,Promise中为空。 |
bundle.setAbilityEnabled8+
setApplicationEnabled(bundleName: string, isEnable: boolean, callback: AsyncCallback): void;
设置是否启用指定的功能
需要权限:
ohos.permission.CHANGE_ABILITY_ENABLED_STATE
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
info | [AbilityInfo] | 是 | Ability信息。 |
isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用,false禁用。 |
callback | AsyncCallback | 是 | 为返回操作结果而调用的回调。 |
bundle.setAbilityEnabled8+
setAbilityEnabled(info: AbilityInfo, isEnable: boolean): Promise
设置是否启用指定的功能
需要权限:
ohos.permission.CHANGE_ABILITY_ENABLED_STATE
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
info | [AbilityInfo] | 是 | Ability信息。 |
isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用,false禁用。 |
返回值:
类型 | 说明 |
---|---|
Promise | 返回值为Promise对象,Promise中为空。 |
bundle.getPermissionDef8+
getPermissionDef(permissionName: string, callback: AsyncCallback): void;
按权限名称获取权限的详细信息
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
permissionName | string | 是 | 指定权限的名称。 |
callback | AsyncCallback<[PermissionDef]> | 是 | 程序启动作为入参的回调函数,返回定义的权限信息。 |
bundle.getPermissionDef8+
getPermissionDef(permissionName: string): Promise
按权限名称获取权限的详细信息
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
permissionName | string | 是 | 指定权限的名称。 |
返回值:
类型 | 说明 |
---|---|
Promise<[PermissionDef]> | 返回值为Promise对象,Promise中包含定义的权限信息对象。 |
bundle.setModuleUpgradeFlag9+
setModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: UpgradeFlag, callback: AsyncCallback):void;
设置模块是否需要升级
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名称。 |
moduleName | string | 是 | 应用程序模块名称。 |
upgradeFlag | [UpgradeFlag] | 是 | 仅供内部系统使用标志位 |
callback | AsyncCallback | 是 | 为返回操作结果而调用的回调。 |
bundle.setModuleUpgradeFlag9+
setModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: UpgradeFlag): Promise
设置模块是否需要升级
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名称。 |
moduleName | string | 是 | 应用程序模块名称。 |
upgradeFlag | [UpgradeFlag] | 是 | 仅供内部系统使用标志位 |
返回值:
类型 | 说明 |
---|---|
Promise | 返回值为Promise对象,Promise中为空。 |
bundle.isModuleRemovable9+
isModuleRemovable(bundleName: string, moduleName: string, callback: AsyncCallback): void;
检查指定模块是否被移除
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名称。 |
moduleName | string | 是 | 应用程序模块名称。 |
callback | AsyncCallback | 是 | 程序启动作为入参的回调函数,返回boolean信息。 |
bundle.isModuleRemovable9+
isModuleRemovable(bundleName: string, moduleName: string): Promise
检查指定模块是否被移除
系统能力:
SystemCapability.BundleManager.BundleFramework
系统API:
此接口为系统接口,三方应用不支持调用
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名称。 |
moduleName | string | 是 | 应用程序模块名称。 |
返回值:
类型 | 说明 |
---|---|
Promise | Promise形式返回boolean信息。 |
bundle.getAbilityInfo
getAbilityInfo(bundleName: string, abilityName: string): Promise
通过包名称和abilityName获取Ability信息,使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名。 |
abilityName | string | 是 | Ability名称。 |
返回值:
类型 | 说明 |
---|---|
Promise<[AbilityInfo]> | Promise形式返回Ability信息。 |
示例:
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAbilityInfo
getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback): void;
通过包名称和abilityName获取Ability信息,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名。 |
abilityName | string | 是 | Ability名称。 |
callback | AsyncCallback<[AbilityInfo]> | 是 | 程序启动作为入参的回调函数,返回Ability信息。 |
示例:
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAbilityInfo9+
getAbilityInfo(bundleName: string, moduleName: string, abilityName: string): Promise
通过包名称、moduleName和abilityName获取Ability信息,使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名。 |
moduleName | string | 是 | Module名称。 |
abilityName | string | 是 | Ability名称。 |
返回值:
类型 | 说明 |
---|---|
Promise<[AbilityInfo]> | Promise形式返回Ability信息。 |
示例:
let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, moduleName, abilityName)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAbilityInfo9+
getAbilityInfo(bundleName: string, moduleName: string, abilityName: string, callback: AsyncCallback): void;
通过包名称、moduleName和abilityName获取Ability信息,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名。 |
moduleName | string | 是 | Module名称。 |
abilityName | string | 是 | Ability名称。 |
callback | AsyncCallback<[AbilityInfo]> | 是 | 程序启动作为入参的回调函数,返回Ability信息。 |
示例:
let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, moduleName, abilityName, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAbilityLabel8+
getAbilityLabel(bundleName: string, abilityName: string): Promise
通过包名称和abilityName获取应用名称,使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名。 |
abilityName | string | 是 | Ability名称。 |
返回值:
类型 | 说明 |
---|---|
Promise | Promise形式返回应用名称信息。 |
示例:
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, abilityName)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAbilityLabel8+
getAbilityLabel(bundleName: string, abilityName: string, callback : AsyncCallback): void
通过包名称和abilityName获取应用名称,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名。 |
abilityName | string | 是 | Ability名称。 |
callback | AsyncCallback | 是 | 程序启动作为入参的回调函数,返回应用名称信息。 |
示例:
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, abilityName, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAbilityLabel9+
getAbilityLabel(bundleName: string, moduleName: string, abilityName: string): Promise
通过包名称、moduleName和abilityName获取应用名称,使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名。 |
moduleName | string | 是 | Module名称。 |
abilityName | string | 是 | Ability名称。 |
返回值:
类型 | 说明 |
---|---|
Promise | Promise形式返回应用名称信息。 |
示例:
let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, moduleName, abilityName)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAbilityLabel9+
getAbilityLabel(bundleName: string, moduleName: string, abilityName: string, callback : AsyncCallback): void
通过包名称、moduleName和abilityName获取应用名称,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 应用程序包名。 |
moduleName | string | 是 | Module名称。 |
abilityName | string | 是 | Ability名称。 |
callback | AsyncCallback | 是 | 程序启动作为入参的回调函数,返回应用名称信息。 |
示例:
let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, moduleName, abilityName, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.isAbilityEnabled8+
isAbilityEnabled(info: AbilityInfo): Promise
以异步方法根据给定的AbilityInfo查询ability是否已经启用,使用Promise形式返回结果。
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
info | [AbilityInfo] | 是 | Ability的配置信息 |
返回值:
类型 | 说明 |
---|---|
Promise | Promise形式返回boolean代表是否启用。 |
示例:
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)= >{
bundle.isAbilityEnabled(abilityInfo).then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
})
bundle.isAbilityEnabled8+
isAbilityEnabled(info : AbilityInfo, callback : AsyncCallback): void
以异步方法根据给定的AbilityInfo查询ability是否已经启用,使用callback形式返回结果。
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
info | [AbilityInfo] | 是 | Ability的配置信息 |
callback | AsyncCallback | 是 | 返回boolean代表是否启用 |
示例:
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)= >{
bundle.isAbilityEnabled(abilityInfo, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
})
bundle.isApplicationEnabled8+
isApplicationEnabled(bundleName: string): Promise
以异步方法根据给定的包名查询指定应用程序是否已经启用,使用Promise形式返回结果。
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 要查询的应用程序包名称。 |
返回值:
类型 | 说明 |
---|---|
Promise | Promise形式返回boolean代表是否启用。 |
示例:
let bundleName = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.isApplicationEnabled8+
isApplicationEnabled(bundleName: string, callback : AsyncCallback): void
以异步方法根据给定的包名查询指定应用程序是否已经启用,使用callback形式返回结果。
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 要查询的应用程序包名称。 |
callback | AsyncCallback | 是 | 返回boolean代表是否启用 |
示例:
let bundleName = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.queryAbilityByWant
queryAbilityByWant(want: Want, bundleFlags: number, userId?: number): Promise>
以异步方法根据给定的意图获取Ability信息,使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
want | [Want] | 是 | 包含要查询的应用程序包名称的意图。 |
bundleFlags | number | 是 | 用于指定返回abilityInfo信息。默认值:0,取值范围:大于等于0。 |
userId | number | 否 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0 |
返回值:
类型 | 说明 |
---|---|
Promise> | Promise形式返回Ability信息。 |
示例:
let bundleFlags = 0;
let userId = 100;
let want = {
bundleName : "com.example.myapplication",
abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryAbilityByWant(want, bundleFlags, userId)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.queryAbilityByWant
queryAbilityByWant(want: Want, bundleFlags: number, userId: number, callback: AsyncCallback>): void
以异步方法根据给定的意图获取Ability信息,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
want | [Want] | 是 | 指示包含要查询的应用程序包名称的意图。 |
bundleFlags | number | 是 | 用于指定返回abilityInfo信息。默认值:0,取值范围:大于等于0。 |
userId | number | 是 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0 |
callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数,返回Ability信息。 |
示例:
let bundleFlags = 0;
let userId = 100;
let want = {
bundleName : "com.example.myapplication",
abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryAbilityByWant(want, bundleFlags, userId, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.queryAbilityByWant
queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback>): void;
以异步方法根据给定的意图获取Ability信息,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
want | [Want] | 是 | 指示包含要查询的应用程序包名称的意图。 |
bundleFlags | number | 是 | 用于指定返回abilityInfo信息。默认值:0,取值范围:大于等于0。 |
callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数,返回Ability信息。 |
示例:
let bundleFlags = 0;
let want = {
bundleName : "com.example.myapplication",
abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryAbilityByWant(want, bundleFlags, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getLaunchWantForBundle
getLaunchWantForBundle(bundleName: string): Promise
以异步方法查询拉起指定应用的want对象,使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 要查询的应用程序包名称。 |
返回值:
类型 | 说明 |
---|---|
Promise<[Want]> | 返回值为Promise对象,Promise中包含拉起指定应用的Want对象。 |
示例:
let bundleName = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getLaunchWantForBundle
getLaunchWantForBundle(bundleName: string, callback: AsyncCallback): void;
以异步方法查询拉起指定应用的want对象,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 要查询的应用程序包名称。 |
callback | AsyncCallback<[Want]> | 是 | 程序启动作为入参的回调函数,返回拉起指定应用的want对象。 |
示例:
let bundleName = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getNameForUid8+
getNameForUid(uid: number): Promise
以异步方法通过uid获取对应的包名,使用Promise形式返回结果。
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
uid | number | 是 | 要查询的uid。 |
返回值:
类型 | 说明 |
---|---|
Promise | 返回值为Promise对象,Promise中包含指定uid的包名。 |
示例:
let uid = 20010005;
bundle.getNameForUid(uid)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getNameForUid8+
getNameForUid(uid: number, callback: AsyncCallback) : void
以异步方法通过uid获取对应的包名,使用callback形式返回结果。
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
uid | number | 是 | 要查询的uid。 |
callback | AsyncCallback | 是 | 程序启动作为入参的回调函数,返回指定uid的包名。 |
示例:
let uid = 20010005;
bundle.getNameForUid(uid, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAbilityIcon8+
getAbilityIcon(bundleName: string, abilityName: string): Promise;
以异步方法通过bundleName和abilityName获取对应Icon的[PixelMap],使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 要查询的bundleName。 |
abilityName | string | 是 | 要查询的abilityName。 |
返回值:
类型 | 说明 |
---|---|
Promise | 返回值为[PixelMap]。 |
示例:
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, abilityName)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAbilityIcon8+
getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback): void;
以异步方法通过bundleName和abilityName获取对应Icon的[PixelMap],使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 要查询的bundleName。 |
abilityName | string | 是 | 要查询的abilityName。 |
callback | AsyncCallback | 是 | 程序启动作为入参的回调函数,返回指定[PixelMap]。 |
示例:
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, abilityName, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAbilityIcon9+
getAbilityIcon(bundleName: string, moduleName: string, abilityName: string): Promise;
以异步方法通过bundleName、moduleName和abilityName获取对应Icon的[PixelMap],使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 要查询的bundleName。 |
moduleName | string | 是 | moduleName。 |
abilityName | string | 是 | 要查询的abilityName。 |
返回值:
类型 | 说明 |
---|---|
Promise | 返回值为[PixelMap]。 |
示例:
let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, moduleName, abilityName)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAbilityIcon9+
getAbilityIcon(bundleName: string, moduleName: string, abilityName: string, callback: AsyncCallback): void;
以异步方法通过bundleName、moduleName和abilityName获取对应Icon的[PixelMap],使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
bundleName | string | 是 | 要查询的bundleName。 |
moduleName | string | 是 | moduleName。 |
abilityName | string | 是 | 要查询的abilityName。 |
callback | AsyncCallback | 是 | 程序启动作为入参的回调函数,返回指定[PixelMap]。 |
示例:
let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, moduleName, abilityName, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.queryExtensionAbilityInfos9+
queryExtensionAbilityInfos(want: Want, extensionType: number, extensionFlags: number, userId?: number): Promise>
以异步方法根据给定的意图获取ExtensionAbility信息,使用Promise形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
want | [Want] | 是 | 包含要查询的应用程序包名称的意图。 |
extensionType | number | 是 | 用于指定查找的extensionAbilityInfo的类型。 默认值:0,取值范围:枚举值: [ExtensionAbilityType] |
extensionFlags | number | 是 | 用于指定返回ExtensionAbilityInfo信息。默认值:0,取值范围:枚举值: [ExtensionFlags] |
userId | number | 否 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0 |
返回值:
类型 | 说明 |
---|---|
Promise> | Promise形式返回ExtensionAbility信息。 |
示例:
let extensionType = 0;
let extensionFlags = 0;
let userId = 100;
let want = {
bundleName : "com.example.myapplication",
abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryExtensionAbilityInfos(want, extensionType, extensionFlags, userId)
.then((data) = > {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.queryExtensionAbilityInfos9+
queryExtensionAbilityInfos(want: Want, extensionType: number, extensionFlags: number, userId: number, callback: AsyncCallback>): void
以异步方法根据给定的意图获取ExtensionAbility信息,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
want | [Want] | 是 | 指示包含要查询的应用程序包名称的意图。 |
extensionType | number | 是 | 用于指定查找的extensionAbilityInfo的类型。 默认值:0,取值范围:枚举值: [ExtensionAbilityType] |
extensionFlags | number | 是 | 用于指定返回ExtensionAbilityInfo信息。默认值:0,取值范围:枚举值: [ExtensionFlags] |
userId | number | 是 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0 |
callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数,返回ExtensionAbility信息。 |
示例:
let extensionType = 0;
let extensionFlags = 0;
let userId = 100;
let want = {
bundleName : "com.example.myapplication",
abilityName : "com.example.myapplication.MainAbility"
};
const receiver = function onReceive(err, data) {
var errValue = JSON.stringify(err)
var dataValue = JSON.stringify(data)
console.error('Operation failed. Cause: ' + errValue);
console.error('Operation failed. Cause: ' + dataValue);
}
bundle.queryExtensionAbilityInfos(want, extensionType, extensionFlags, userId, receiver)
bundle.queryExtensionAbilityInfos9+
queryExtensionAbilityInfos(want: Want, extensionType: number, extensionFlags: number, callback: AsyncCallback>): void;
以异步方法根据给定的意图获取ExtensionAbility信息,使用callback形式返回结果。
需要权限:
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
系统能力:
SystemCapability.BundleManager.BundleFramework
参数:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
want | [Want]( | 是 | 指示包含要查询的应用程序包名称的意图。 |
extensionType | number | 是 | 用于指定查找的extensionAbilityInfo的类型。 默认值:0,取值范围:枚举值: [ExtensionAbilityType] |
extensionFlags | number | 是 | 用于指定返回ExtensionAbilityInfo信息。默认值:0,取值范围:枚举值: [ExtensionFlags] |
callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数,返回ExtensionAbility信息。 |
示例:
let extensionType = 0;
let extensionFlags = 0;
let want = {
bundleName : "com.example.myapplication",
abilityName : "com.example.myapplication.MainAbility"
};
const receiver = function onReceive(err, data) {
var errValue = JSON.stringify(err)
var dataValue = JSON.stringify(data)
console.error('Operation failed. Cause: ' + errValue);
console.error('Operation failed. Cause: ' + dataValue);
}
bundle.queryExtensionAbilityInfos(want, extensionType, extensionFlags, receiver)
InstallErrorCode
系统能力: SystemCapability.BundleManager.BundleFramework
名称 | 默认值 | 说明 |
---|---|---|
SUCCESS | 0 | 安装成功 |
STATUS_INSTALL_FAILURE | 1 | 安装失败(不存在安装的应用) |
STATUS_INSTALL_FAILURE_ABORTED | 2 | 安装中止 |
STATUS_INSTALL_FAILURE_INVALID | 3 | 安装参数无效 |
STATUS_INSTALL_FAILURE_CONFLICT | 4 | 安装冲突 (常见于升级和已有应用基本信息不一致) |
STATUS_INSTALL_FAILURE_STORAGE | 5 | 存储包信息失败 |
STATUS_INSTALL_FAILURE_INCOMPATIBLE | 6 | 安装不兼容(常见于版本降级安装或者签名信息错误) |
STATUS_UNINSTALL_FAILURE | 7 | 卸载失败 (不存在卸载的应用) |
STATUS_UNINSTALL_FAILURE_BLOCKED | 8 | 卸载中止 (没有使用) |
STATUS_UNINSTALL_FAILURE_ABORTED | 9 | 卸载中止 (参数无效导致) |
STATUS_UNINSTALL_FAILURE_CONFLICT | 10 | 卸载冲突 (卸载系统应用失败, 结束应用进程失败) |
STATUS_INSTALL_FAILURE_DOWNLOAD_TIMEOUT | 0x0B | 安装失败 (下载超时) |
STATUS_INSTALL_FAILURE_DOWNLOAD_FAILED | 0x0C | 安装失败 (下载失败) |
STATUS_RECOVER_FAILURE_INVALID8+ | 0x0D | 恢复预置应用失败 |
STATUS_ABILITY_NOT_FOUND | 0x40 | Ability未找到 |
STATUS_BMS_SERVICE_ERROR | 0x41 | BMS服务错误 |
STATUS_FAILED_NO_SPACE_LEFT8+ | 0x42 | 设备空间不足 |
STATUS_GRANT_REQUEST_PERMISSIONS_FAILED8+ | 0x43 | 应用授权失败 |
STATUS_INSTALL_PERMISSION_DENIED8+ | 0x44 | 安装权限拒绝 |
STATUS_UNINSTALL_PERMISSION_DENIED8+ | 0x45 | 卸载权限拒绝 |
BundleFlag
包的标志
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
名称 | 默认值 | 说明 |
---|---|---|
GET_BUNDLE_DEFAULT | 0x00000000 | 获取默认的应用信息 |
GET_BUNDLE_WITH_ABILITIES | 0x00000001 | 获取包括Ability信息的包信息 |
GET_ABILITY_INFO_WITH_PERMISSION | 0x00000002 | 获取包括权限的Ability信息 |
GET_ABILITY_INFO_WITH_APPLICATION | 0x00000004 | 获取包括应用的Ability信息 |
GET_APPLICATION_INFO_WITH_PERMISSION | 0x00000008 | 获取包括权限的应用信息 |
GET_BUNDLE_WITH_REQUESTED_PERMISSION | 0x00000010 | 获取包括所需权限的包信息 |
GET_ABILITY_INFO_WITH_METADATA8+ | 0x00000020 | 获取ability的元数据信息 |
GET_BUNDLE_WITH_EXTENSION_ABILITY9+ | 0x00000020 | 获取包括Ability信息的扩展包信息 |
GET_APPLICATION_INFO_WITH_METADATA8+ | 0x00000040 | 获取应用的元数据信息 |
GET_ABILITY_INFO_SYSTEMAPP_ONLY8+ | 0x00000080 | 获取仅包括系统应用的ability信息 |
GET_ABILITY_INFO_WITH_DISABLE8+ | 0x00000100 | 获取包括被禁用的ability信息 |
GET_APPLICATION_INFO_WITH_DISABLE8+ | 0x00000200 | 获取包括被禁用的应用信息 |
GET_ALL_APPLICATION_INFO | 0xFFFF0000 | 获取应用所有的信息 |
BundleOptions
包的选项
系统能力: SystemCapability.BundleManager.BundleFramework
名称 | 类型 | 可读 | 可写 | 说明 |
---|---|---|---|---|
userId | number | 是 | 是 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
AbilityType
Ability类型
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
名称 | 类型 | 说明 |
---|---|---|
UNKNOWN | 无 | 未知Ability类型 |
PAGE | 无 | Ability有一个UI界面 |
SERVICE | 无 | Ability没有UI界面 |
DATA | 无 | Ability用于提供数据访问服务 |
DisplayOrientation
屏幕显示方向
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
名称 | 类型 | 说明 |
---|---|---|
UNSPECIFIED | 无 | 屏幕方向--不指定 |
LANDSCAPE | 无 | 屏幕方向--横屏 |
PORTRAIT | 无 | 屏幕方向--竖屏 |
FOLLOW_RECENT | 无 | 屏幕方向--紧跟上一个组件 |
LaunchMode
启动模式
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
名称 | 类型 | 说明 |
---|---|---|
SINGLETON | 0 | Ability只有一个示例 |
STANDARD | 1 | Ability有多个示例 |
AbilitySubType
Ability的子类型
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
名称 | 类型 | 说明 |
---|---|---|
UNSPECIFIED | 0 | 未定义Ability子类型 |
CA | 1 | Ability子类型是带有 UI 的服务 |
ExtensionAbilityType9+
ExtensionAbility的类型
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
名称 | 类型 | 说明 |
---|---|---|
FORM9+ | 0 | ExtensionAbility的类型包括卡片 |
WORK_SCHEDULER9+ | 1 | ExtensionAbility的类型包括行程安排 |
INPUT_METHOD9+ | 2 | ExtensionAbility的类型包括输入法 |
SERVICE9+ | 3 | ExtensionAbility的类型包括服务 |
ACCESSIBILITY9+ | 4 | ExtensionAbility的类型包括无障碍 |
DATA_SHARE9+ | 5 | ExtensionAbility的类型包括数据共享 |
FILE_SHARE9+ | 6 | ExtensionAbility的类型包括文件共享 |
STATIC_SUBSCRIBER9+ | 7 | ExtensionAbility的类型包括订阅者 |
WALLPAPER9+ | 8 | ExtensionAbility的类型包括墙纸 |
BACKUP9+ | 9 | ExtensionAbility的类型包括数据备份恢复 |
WINDOW9+ | 10 | ExtensionAbility的窗口类型扩展信息 |
UNSPECIFIED9+ | 20 | ExtensionAbility未指定类型 |
ExtensionFlag9+
扩展标志
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
名称 | 默认值 | 说明 |
---|---|---|
GET_EXTENSION_INFO_DEFAULT9+ | 0x00000000 | 获取默认的extensionAbilityInfo |
GET_EXTENSION_INFO_WITH_PERMISSION9+ | 0x00000002 | 获取携带权限信息的extensionAbilityInfo |
GET_EXTENSION_INFO_WITH_APPLICATION9+ | 0x00000004 | 获取携带应用信息的extensionAbilityInfo |
GET_EXTENSION_INFO_WITH_METADATA9+ | 0x00000020 | 获取携带元数据信息的extensionAbilityInfo |
ColorMode
颜色模式
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
名称 | 类型 | 说明 |
---|---|---|
AUTO_MODE | -1 | 自动模式 |
DARK_MODE | 0 | 黑色模式 |
LIGHT_MODE | 1 | 亮度模式 |
GrantStatus
授予状态
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
名称HarmonyOS与OpenHarmony鸿蒙文档籽料:mau123789是v直接拿 | 类型 | 说明 |
---|---|---|
PERMISSION_DENIED | -1 | 拒绝许可 |
PERMISSION_GRANTED | 0 | 批准 |
UpgradeFlag
此项仅供内部系统使用
系统API:
此接口为系统接口,三方应用不支持调用
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
名称 | 值 | 说明 |
---|---|---|
NOT_UPGRADE9+ | 0 | 模块无需升级 |
SINGLE_UPGRADE9+ | 1 | 单个模块需要升级 |
RELATION_UPGRADE9+ | 2 | 关系模块需要升级 |
审核编辑 黄宇
-
接口
+关注
关注
33文章
8575浏览量
151012 -
bundled
+关注
关注
0文章
4浏览量
9100 -
bms
+关注
关注
107文章
996浏览量
65944 -
鸿蒙
+关注
关注
57文章
2339浏览量
42804
发布评论请先 登录
相关推荐
评论