@ohos.bundle.innerBundleManager (innerBundleManager模块)(系统接口)

本模块提供launcher应用使用的接口。

说明:

本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

本模块从API version 9开始不再支持。建议使用launcherBundleManagerbundleMonitor替代。

本模块为系统接口。

导入模块

import innerBundleManager from '@ohos.bundle.innerBundleManager';

系统能力

SystemCapability.BundleManager.BundleFramework

innerBundleManager.getLauncherAbilityInfos(deprecated)

getLauncherAbilityInfos(bundleName: string, userId: number, callback: AsyncCallback<Array<LauncherAbilityInfo>>) : void

以异步方法根据给定的Bundle名称获取LauncherAbilityInfos,使用callback形式返回结果。

从API version 9开始不再支持。建议使用launcherBundleManager.getLauncherAbilityInfo替代。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

系统接口:

此接口为系统接口。

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用Bundle名称。
userId number 用户ID。取值范围:大于等于0。
callback AsyncCallback<Array<LauncherAbilityInfo>> 程序启动作为入参的回调函数,返回程序信息。

innerBundleManager.getLauncherAbilityInfos(deprecated)

getLauncherAbilityInfos(bundleName: string, userId: number) : Promise<Array<LauncherAbilityInfo>>

以异步方法根据给定的Bundle名称获取LauncherAbilityInfos,使用Promise形式返回结果。

从API version 9开始不再支持。建议使用launcherBundleManager.getLauncherAbilityInfo替代。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

系统接口:

此接口为系统接口。

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用Bundle名称。
userId number 用户ID。取值范围:大于等于0。

返回值:

类型 说明
Promise<Array<LauncherAbilityInfo>> Promise形式返回程序信息。

innerBundleManager.on(deprecated)

on(type:"BundleStatusChange", bundleStatusCallback : BundleStatusCallback, callback: AsyncCallback<string>) : void

注册Callback。

从API version 9开始不再支持。建议使用bundleMonitor.on替代。

需要权限:

ohos.permission.LISTEN_BUNDLE_CHANGE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统接口:

此接口为系统接口。

参数:

参数名 类型 必填 说明
type string 指示应执行命令,只支持BundleStatusChange。
bundleStatusCallback BundleStatusCallback 指示要注册的回调。
callback AsyncCallback<string> 程序启动作为入参的回调函数,返回正确结果或错误信息。

innerBundleManager.on(deprecated)

on(type:"BundleStatusChange", bundleStatusCallback : BundleStatusCallback) : Promise<string>

注册Callback。

从API version 9开始不再支持。建议使用bundleMonitor.on替代。

需要权限:

ohos.permission.LISTEN_BUNDLE_CHANGE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统接口:

此接口为系统接口。

参数:

参数名 类型 必填 说明
type string 指示应执行命令,只支持BundleStatusChange。
bundleStatusCallback BundleStatusCallback 指示要注册的回调。

返回值:

类型 说明
Promise<string> Promise形式返回正确结果或错误信息。

innerBundleManager.off(deprecated)

off(type:"BundleStatusChange", callback: AsyncCallback<string>) : void

取消注册Callback。

从API version 9开始不再支持。建议使用bundleMonitor.off替代。

需要权限:

ohos.permission.LISTEN_BUNDLE_CHANGE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统接口:

此接口为系统接口。

参数:

参数名 类型 必填 说明
type string 指示应执行命令,只支持BundleStatusChange。
callback AsyncCallback<string> 程序启动作为入参的回调函数,返回正确结果或错误信息。

innerBundleManager.off(deprecated)

off(type:"BundleStatusChange") : Promise<string>

取消注册Callback。

从API version 9开始不再支持。建议使用bundleMonitor.off替代。

需要权限:

ohos.permission.LISTEN_BUNDLE_CHANGE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统接口:

此接口为系统接口。

参数:

参数名 类型 必填 说明
type string 指示应执行命令,只支持BundleStatusChange。

返回值:

类型 说明
Promise<string> Promise形式返回正确结果或错误信息。

innerBundleManager.getAllLauncherAbilityInfos(deprecated)

getAllLauncherAbilityInfos(userId: number, callback: AsyncCallback<Array<LauncherAbilityInfo>>) : void

以异步方法获取所有的LauncherAbilityInfos,使用callback形式返回结果。

从API version 9开始不再支持。建议使用launcherBundleManager.getAllLauncherAbilityInfo替代。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

系统接口:

此接口为系统接口。

参数:

参数名 类型 必填 说明
userId number 用户ID。取值范围:大于等于0。
callback AsyncCallback<Array<LauncherAbilityInfo>> 程序启动作为入参的回调函数,返回程序信息。

innerBundleManager.getAllLauncherAbilityInfos(deprecated)

getAllLauncherAbilityInfos(userId: number) : Promise<Array<LauncherAbilityInfo>>

以异步方法获取LauncherAbilityInfos,使用Promise形式返回结果。

从API version 9开始不再支持。建议使用launcherBundleManager.getAllLauncherAbilityInfo替代。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

系统接口:

此接口为系统接口。

参数:

参数名 类型 必填 说明
userId number 用户ID。取值范围:大于等于0。

返回值:

类型 说明
Promise<Array<LauncherAbilityInfo>> Promise形式返回程序信息。

innerBundleManager.getShortcutInfos(deprecated)

getShortcutInfos(bundleName :string, callback: AsyncCallback<Array<ShortcutInfo>>) : void

以异步方法根据给定的Bundle名称获取快捷方式信息,使用callback形式返回结果。

从API version 9开始不再支持。建议使用launcherBundleManager.getShortcutInfo替代。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

系统接口:

此接口为系统接口。

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用Bundle名称。
callback AsyncCallback<Array<ShortcutInfo>> 程序启动作为入参的回调函数,返回快捷方式信息。

innerBundleManager.getShortcutInfos(deprecated)

getShortcutInfos(bundleName : string) : Promise<Array<ShortcutInfo>>

以异步方法根据给定的Bundle名称获取快捷方式信息,使用Promise形式返回结果。

从API version 9开始不再支持。建议使用launcherBundleManager.getShortcutInfo替代。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

系统接口:

此接口为系统接口。

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用Bundle名称。

返回值:

类型 说明
Promise<Array<ShortcutInfo>> Promise形式返回快捷方式信息。