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