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