1# @ohos.bundle.innerBundleManager (innerBundleManager模块)(系统接口) 2<!--Kit: Ability Kit--> 3<!--Subsystem: BundleManager--> 4<!--Owner: @wanghang904--> 5<!--Designer: @hanfeng6--> 6<!--Tester: @kongjing2--> 7<!--Adviser: @Brilliantry_Rui--> 8 9本模块提供launcher应用使用的接口。 10 11> **说明：** 12> 13> 本模块首批接口从API version 8 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 14> 15> 本模块从API version 9开始不再支持。建议使用[launcherBundleManager](js-apis-launcherBundleManager-sys.md)及[bundleMonitor](js-apis-bundleMonitor-sys.md)替代。 16> 17> 本模块为系统接口。 18 19## 导入模块 20 21```typescript 22import innerBundleManager from '@ohos.bundle.innerBundleManager'; 23``` 24 25## 系统能力 26 27SystemCapability.BundleManager.BundleFramework 28 29 30## innerBundleManager.getLauncherAbilityInfos<sup>(deprecated)</sup> 31 32getLauncherAbilityInfos(bundleName: string, userId: number, callback: AsyncCallback<Array<LauncherAbilityInfo>>) : void 33 34根据给定的Bundle名称获取LauncherAbilityInfos，使用callback异步回调。 35> 从API version 9开始不再支持。建议使用[launcherBundleManager.getLauncherAbilityInfo](js-apis-launcherBundleManager-sys.md#launcherbundlemanagergetlauncherabilityinfo9)替代。 36 37**需要权限：** 38 39ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 40 41**系统能力：** 42 43SystemCapability.BundleManager.BundleFramework 44 45**系统接口：** 46 47此接口为系统接口。 48 49**参数：** 50 51| 参数名 | 类型 | 必填 | 说明 | 52| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------ | 53| bundleName | string | 是 | 要查询的应用Bundle名称。 | 54| userId | number | 是 | 用户ID。取值范围：大于等于0。 | 55| callback | AsyncCallback\<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo-sys.md)>> | 是 | 程序启动作为入参的回调函数，返回程序信息。 | 56 57 58## innerBundleManager.getLauncherAbilityInfos<sup>(deprecated)</sup> 59 60getLauncherAbilityInfos(bundleName: string, userId: number) : Promise<Array<LauncherAbilityInfo>> 61 62根据给定的Bundle名称获取LauncherAbilityInfos，使用Promise异步回调。 63> 从API version 9开始不再支持。建议使用[launcherBundleManager.getLauncherAbilityInfo](js-apis-launcherBundleManager-sys.md#launcherbundlemanagergetlauncherabilityinfo9)替代。 64 65**需要权限：** 66 67ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 68 69**系统能力：** 70 71SystemCapability.BundleManager.BundleFramework 72 73**系统接口：** 74 75此接口为系统接口。 76 77**参数：** 78 79| 参数名 | 类型 | 必填 | 说明 | 80| ---------- | ------ | ---- | ----------------------------- | 81| bundleName | string | 是 | 要查询的应用Bundle名称。 | 82| userId | number | 是 | 用户ID。取值范围：大于等于0。 | 83 84**返回值：** 85 86| 类型 | 说明 | 87| ------------------------------------------------------------ | ------------------------- | 88| Promise\<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo-sys.md)>> | Promise形式返回程序信息。 | 89 90## innerBundleManager.on<sup>(deprecated)</sup> 91 92on(type:"BundleStatusChange", bundleStatusCallback : BundleStatusCallback, callback: AsyncCallback<string>) : void 93 94注册Callback。 95> 从API version 9开始不再支持。建议使用[bundleMonitor.on](js-apis-bundleMonitor-sys.md#bundlemonitoron)替代。 96 97**需要权限：** 98 99ohos.permission.LISTEN_BUNDLE_CHANGE 100 101**系统能力：** 102 103SystemCapability.BundleManager.BundleFramework 104 105**系统接口：** 106 107此接口为系统接口。 108 109**参数：** 110 111| 参数名 | 类型 | 必填 | 说明 | 112| -------------------- | --------------------- | ---- | ---------------------------------------------------- | 113| type | string | 是 | 指示应执行命令，只支持BundleStatusChange。 | 114| bundleStatusCallback | [BundleStatusCallback](js-apis-Bundle-BundleStatusCallback-sys.md) | 是 | 指示要注册的回调。 | 115| callback | AsyncCallback\<string> | 是 | 程序启动作为入参的回调函数，返回正确结果或错误信息。 | 116 117## innerBundleManager.on<sup>(deprecated)</sup> 118 119on(type:"BundleStatusChange", bundleStatusCallback : BundleStatusCallback) : Promise<string> 120 121注册Callback。 122> 从API version 9开始不再支持。建议使用[bundleMonitor.on](js-apis-bundleMonitor-sys.md#bundlemonitoron)替代。 123 124**需要权限：** 125 126ohos.permission.LISTEN_BUNDLE_CHANGE 127 128**系统能力：** 129 130SystemCapability.BundleManager.BundleFramework 131 132**系统接口：** 133 134此接口为系统接口。 135 136**参数：** 137 138| 参数名 | 类型 | 必填 | 说明 | 139| -------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------ | 140| type | string | 是 | 指示应执行命令，只支持BundleStatusChange。 | 141| bundleStatusCallback | [BundleStatusCallback](js-apis-Bundle-BundleStatusCallback-sys.md) | 是 | 指示要注册的回调。 | 142 143**返回值：** 144 145| 类型 | 说明 | 146| --------------- | ----------------------------------- | 147| Promise\<string> | Promise形式返回正确结果或错误信息。 | 148 149## innerBundleManager.off<sup>(deprecated)</sup> 150 151off(type:"BundleStatusChange", callback: AsyncCallback<string>) : void 152 153取消注册Callback。 154> 从API version 9开始不再支持。建议使用[bundleMonitor.off](js-apis-bundleMonitor-sys.md#bundlemonitoroff)替代。 155 156**需要权限：** 157 158ohos.permission.LISTEN_BUNDLE_CHANGE 159 160**系统能力：** 161 162SystemCapability.BundleManager.BundleFramework 163 164**系统接口：** 165 166此接口为系统接口。 167 168**参数：** 169 170| 参数名 | 类型 | 必填 | 说明 | 171| -------- | --------------------- | ---- | ---------------------------------------------------- | 172| type | string | 是 | 指示应执行命令，只支持BundleStatusChange。 | 173| callback | AsyncCallback\<string> | 是 | 程序启动作为入参的回调函数，返回正确结果或错误信息。 | 174 175## innerBundleManager.off<sup>(deprecated)</sup> 176 177off(type:"BundleStatusChange") : Promise<string> 178 179取消注册Callback。 180> 从API version 9开始不再支持。建议使用[bundleMonitor.off](js-apis-bundleMonitor-sys.md#bundlemonitoroff)替代。 181 182**需要权限：** 183 184ohos.permission.LISTEN_BUNDLE_CHANGE 185 186**系统能力：** 187 188SystemCapability.BundleManager.BundleFramework 189 190**系统接口：** 191 192此接口为系统接口。 193 194**参数：** 195 196| 参数名 | 类型 | 必填 | 说明 | 197| ------ | ------ | ---- | ------------------------------------------ | 198| type | string | 是 | 指示应执行命令，只支持BundleStatusChange。 | 199 200**返回值：** 201 202| 类型 | 说明 | 203| --------------- | ----------------------------------- | 204| Promise\<string> | Promise形式返回正确结果或错误信息。 | 205 206## innerBundleManager.getAllLauncherAbilityInfos<sup>(deprecated)</sup> 207 208getAllLauncherAbilityInfos(userId: number, callback: AsyncCallback<Array<LauncherAbilityInfo>>) : void 209 210获取所有的LauncherAbilityInfos，使用callback异步回调。 211> 从API version 9开始不再支持。建议使用[launcherBundleManager.getAllLauncherAbilityInfo](js-apis-launcherBundleManager-sys.md#launcherbundlemanagergetalllauncherabilityinfo9)替代。 212 213**需要权限：** 214 215ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 216 217**系统能力：** 218 219SystemCapability.BundleManager.BundleFramework 220 221**系统接口：** 222 223此接口为系统接口。 224 225**参数：** 226 227| 参数名 | 类型 | 必填 | 说明 | 228| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- | 229| userId | number | 是 | 用户ID。取值范围：大于等于0。 | 230| callback | AsyncCallback\<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo-sys.md)>> | 是 | 程序启动作为入参的回调函数，返回程序信息。 | 231 232## innerBundleManager.getAllLauncherAbilityInfos<sup>(deprecated)</sup> 233 234getAllLauncherAbilityInfos(userId: number) : Promise<Array<LauncherAbilityInfo>> 235 236获取LauncherAbilityInfos，使用Promise异步回调。 237> 从API version 9开始不再支持。建议使用[launcherBundleManager.getAllLauncherAbilityInfo](js-apis-launcherBundleManager-sys.md#launcherbundlemanagergetalllauncherabilityinfo9)替代。 238 239**需要权限：** 240 241ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 242 243**系统能力：** 244 245SystemCapability.BundleManager.BundleFramework 246 247**系统接口：** 248 249此接口为系统接口。 250 251**参数：** 252 253| 参数名 | 类型 | 必填 | 说明 | 254| ------ | ------ | ---- | ----------------------------------------------------- | 255| userId | number | 是 | 用户ID。取值范围：大于等于0。 | 256 257**返回值：** 258 259| 类型 | 说明 | 260| ------------------------------------------------------------ | ------------------------- | 261| Promise\<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo-sys.md)>> | Promise形式返回程序信息。 | 262 263## innerBundleManager.getShortcutInfos<sup>(deprecated)</sup> 264 265getShortcutInfos(bundleName :string, callback: AsyncCallback<Array<ShortcutInfo>>) : void 266 267根据给定的Bundle名称获取快捷方式信息，使用callback异步回调。 268> 从API version 9开始不再支持。建议使用[launcherBundleManager.getShortcutInfo](js-apis-launcherBundleManager-sys.md#launcherbundlemanagergetshortcutinfo9)替代。 269 270**需要权限：** 271 272ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 273 274**系统能力：** 275 276SystemCapability.BundleManager.BundleFramework 277 278**系统接口：** 279 280此接口为系统接口。 281 282**参数：** 283 284| 参数名 | 类型 | 必填 | 说明 | 285| ---------- | ------------------------------------------------------------ | ---- | ---------------------------------------------- | 286| bundleName | string | 是 | 要查询的应用Bundle名称。 | 287| callback | AsyncCallback\<Array<[ShortcutInfo](js-apis-bundle-ShortcutInfo-sys.md)>> | 是 | 程序启动作为入参的回调函数，返回快捷方式信息。 | 288 289## innerBundleManager.getShortcutInfos<sup>(deprecated)</sup> 290 291getShortcutInfos(bundleName : string) : Promise<Array<ShortcutInfo>> 292 293根据给定的Bundle名称获取快捷方式信息，使用Promise异步回调。 294> 从API version 9开始不再支持。建议使用[launcherBundleManager.getShortcutInfo](js-apis-launcherBundleManager-sys.md#launcherbundlemanagergetshortcutinfo9)替代。 295 296**需要权限：** 297 298ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 299 300**系统能力：** 301 302SystemCapability.BundleManager.BundleFramework 303 304**系统接口：** 305 306此接口为系统接口。 307 308**参数：** 309 310| 参数名 | 类型 | 必填 | 说明 | 311| ---------- | ------ | ---- | ------------------------ | 312| bundleName | string | 是 | 要查询的应用Bundle名称。 | 313 314**返回值：** 315 316| 类型 | 说明 | 317| -------------------------------------------------------- | ----------------------------- | 318| Promise\<Array<[ShortcutInfo](js-apis-bundle-ShortcutInfo-sys.md)>> | Promise形式返回快捷方式信息。 | 319