1# @ohos.enterprise.bundleManager（包管理） 2 3本模块提供包管理能力，包括添加包安装白名单、获取包安装白名单、移除包安装白名单等。 4 5> **说明：** 6> 7> 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8> 9> 本模块接口仅可在Stage模型下使用。 10> 11> 本模块接口仅对[设备管理应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。 12 13## 导入模块 14 15```ts 16import bundleManager from '@ohos.enterprise.bundleManager'; 17``` 18 19## bundleManager.addAllowedInstallBundles 20 21addAllowedInstallBundles(admin: Want, appIds: Array\<string>, callback: AsyncCallback<void>): void 22 23指定设备管理应用添加应用至包安装白名单，添加至白名单的应用允许在当前用户下安装，否则不允许安装，使用callback异步回调。 24 25**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 26 27**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 28 29**系统API**: 此接口为系统接口。 30 31**参数：** 32 33| 参数名 | 类型 | 必填 | 说明 | 34| -------- | ---------------------------------------- | ---- | ------------------------------- | 35| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 36| appIds | Array<string> | 是 | 应用ID数组。 | 37| callback | AsyncCallback<void> | 是 | 回调函数。当接口调用成功，err为null，否则为错误对象。 | 38 39**错误码**： 40 41以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 42 43| 错误码ID | 错误信息 | 44| ------- | ---------------------------------------------------------------------------- | 45| 9200001 | the application is not an administrator of the device. | 46| 9200002 | the administrator application does not have permission to manage the device. | 47 48**示例：** 49 50```ts 51import Want from '@ohos.app.ability.Want'; 52let wantTemp: Want = { 53 bundleName: 'com.example.myapplication', 54 abilityName: 'EntryAbility', 55}; 56let appIds: Array<string> = ['com.example.myapplication']; 57 58bundleManager.addAllowedInstallBundles(wantTemp, appIds, (err) => { 59 if (err) { 60 console.error(`Failed to add allowed install bundles. Code is ${err.code}, message is ${err.message}`); 61 return; 62 } 63 console.info('Succeeded in adding allowed install bundles'); 64}); 65``` 66 67## bundleManager.addAllowedInstallBundles 68 69addAllowedInstallBundles(admin: Want, appIds: Array\<string>, userId: number, callback: AsyncCallback<void>): void 70 71指定设备管理应用添加应用至包安装白名单，添加至白名单的应用允许在指定用户（通过userId指定）下安装，否则不允许安装，使用callback异步回调。 72 73**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 74 75**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 76 77**系统API**: 此接口为系统接口。 78 79**参数：** 80 81| 参数名 | 类型 | 必填 | 说明 | 82| ----- | ----------------------------------- | ---- | ------- | 83| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 84| appIds | Array<string> | 是 | 应用ID数组。 | 85| userId | number | 是 | 用户ID，指定具体用户。取值范围：大于等于0。 | 86| callback | AsyncCallback<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 87 88**错误码**： 89 90以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 91 92| 错误码ID | 错误信息 | 93| ------- | ---------------------------------------------------------------------------- | 94| 9200001 | the application is not an administrator of the device. | 95| 9200002 | the administrator application does not have permission to manage the device. | 96 97**示例：** 98 99```ts 100import Want from '@ohos.app.ability.Want'; 101let wantTemp: Want = { 102 bundleName: 'com.example.myapplication', 103 abilityName: 'EntryAbility', 104}; 105let appIds: Array<string> = ['com.example.myapplication']; 106 107bundleManager.addAllowedInstallBundles(wantTemp, appIds, 100, (err) => { 108 if (err) { 109 console.error(`Failed to add allowed install bundles. Code is ${err.code}, message is ${err.message}`); 110 return; 111 } 112 console.info('Succeeded in adding allowed install bundles'); 113}); 114``` 115 116## bundleManager.addAllowedInstallBundles 117 118addAllowedInstallBundles(admin: Want, appIds: Array\<string>, userId?: number): Promise<void> 119 120指定设备管理应用添加应用至包安装白名单，添加至白名单的应用允许在当前/指定用户下安装，否则不允许安装。使用promise异步回调。 121 122**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 123 124**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 125 126**系统API**: 此接口为系统接口。 127 128**参数：** 129 130| 参数名 | 类型 | 必填 | 说明 | 131| ----- | ----------------------------------- | ---- | ------- | 132| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 133| appIds | Array<string> | 是 | 应用ID数组。 | 134| userId | number | 否 |用户ID，取值范围：大于等于0。<br> - 调用接口时，若传入userId，表示指定用户。<br> - 调用接口时，若未传入userId，表示当前用户。 | 135 136**返回值：** 137 138| 类型 | 说明 | 139| --------------------- | ------------------------- | 140| Promise<void> | 无返回结果的Promise对象。当指定设备管理应用添加包安装白名单失败时，会抛出错误对象。 | 141 142**错误码**： 143 144以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 145 146| 错误码ID | 错误信息 | 147| ------- | ---------------------------------------------------------------------------- | 148| 9200001 | the application is not an administrator of the device. | 149| 9200002 | the administrator application does not have permission to manage the device. | 150 151**示例：** 152 153```ts 154import Want from '@ohos.app.ability.Want'; 155import { BusinessError } from '@ohos.base'; 156let wantTemp: Want = { 157 bundleName: 'com.example.myapplication', 158 abilityName: 'EntryAbility', 159}; 160let appIds: Array<string> = ['com.example.myapplication']; 161 162bundleManager.addAllowedInstallBundles(wantTemp, appIds, 100).then(() => { 163 console.info('Succeeded in adding allowed install bundles'); 164}).catch((err: BusinessError) => { 165 console.error(`Failed to add allowed install bundles. Code is ${err.code}, message is ${err.message}`); 166}); 167``` 168 169## bundleManager.removeAllowedInstallBundles 170 171removeAllowedInstallBundles(admin: Want, appIds: Array\<string>, callback: AsyncCallback<void>): void 172 173指定设备管理应用在包安装白名单中移除应用，在白名单存在的情况下，不在包安装白名单中的应用不允许在当前用户下安装，使用callback异步回调。 174 175**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 176 177**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 178 179**系统API**: 此接口为系统接口。 180 181**参数：** 182 183| 参数名 | 类型 | 必填 | 说明 | 184| -------- | ---------------------------------------- | ---- | ------------------------------- | 185| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 186| appIds | Array<string> | 是 | 应用ID数组。 | 187| callback | AsyncCallback<void> | 是 | 回调函数。当接口调用成功，err为null，否则为错误对象。 | 188 189**错误码**： 190 191以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 192 193| 错误码ID | 错误信息 | 194| ------- | ---------------------------------------------------------------------------- | 195| 9200001 | the application is not an administrator of the device. | 196| 9200002 | the administrator application does not have permission to manage the device. | 197 198**示例：** 199 200```ts 201import Want from '@ohos.app.ability.Want'; 202let wantTemp: Want = { 203 bundleName: 'com.example.myapplication', 204 abilityName: 'EntryAbility', 205}; 206let appIds: Array<string> = ['com.example.myapplication']; 207 208bundleManager.removeAllowedInstallBundles(wantTemp, appIds, (err) => { 209 if (err) { 210 console.error(`Failed to remove allowed install bundles. Code is ${err.code}, message is ${err.message}`); 211 return; 212 } 213 console.info('Succeeded in removing allowed install bundles'); 214}); 215``` 216 217## bundleManager.removeAllowedInstallBundles 218 219removeAllowedInstallBundles(admin: Want, appIds: Array\<string>, userId: number, callback: AsyncCallback<void>): void 220 221指定设备管理应用在包安装白名单中移除应用，在白名单存在的情况下，不在包安装白名单中的应用不允许在指定用户（通过userId指定）下安装，使用callback异步回调。 222 223**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 224 225**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 226 227**系统API**: 此接口为系统接口。 228 229**参数：** 230 231| 参数名 | 类型 | 必填 | 说明 | 232| ----- | ----------------------------------- | ---- | ------- | 233| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 234| appIds | Array<string> | 是 | 应用ID数组。 | 235| userId | number | 是 | 用户ID，指定具体用户。取值范围：大于等于0。 | 236| callback | AsyncCallback<void> | 是 | 回调函数。当接口调用成功，err为null，否则为错误对象。 | 237 238**错误码**： 239 240以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 241 242| 错误码ID | 错误信息 | 243| ------- | ---------------------------------------------------------------------------- | 244| 9200001 | the application is not an administrator of the device. | 245| 9200002 | the administrator application does not have permission to manage the device. | 246 247**示例：** 248 249```ts 250import Want from '@ohos.app.ability.Want'; 251let wantTemp: Want = { 252 bundleName: 'com.example.myapplication', 253 abilityName: 'EntryAbility', 254}; 255let appIds: Array<string> = ['com.example.myapplication']; 256 257bundleManager.removeAllowedInstallBundles(wantTemp, appIds, 100, (err) => { 258 if (err) { 259 console.error(`Failed to remove allowed install bundles. Code is ${err.code}, message is ${err.message}`); 260 return; 261 } 262 console.info('Succeeded in removing allowed install bundles'); 263}); 264``` 265 266## bundleManager.removeAllowedInstallBundles 267 268removeAllowedInstallBundles(admin: Want, appIds: Array\<string>, userId?: number): Promise<void> 269 270指定设备管理应用在包安装白名单中移除应用，在白名单存在的情况下，不在包安装白名单中的应用不允许在当前/指定用户下安装。使用promise异步回调。 271 272**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 273 274**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 275 276**系统API**: 此接口为系统接口。 277 278**参数：** 279 280| 参数名 | 类型 | 必填 | 说明 | 281| ----- | ----------------------------------- | ---- | ------- | 282| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 283| appIds | Array\<string> | 是 | 应用ID数组。 | 284| userId | number | 否 | 用户ID，取值范围：大于等于0。<br> - 调用接口时，若传入userId，表示指定用户。<br> - 调用接口时，若未传入userId，表示当前用户。 | 285 286**返回值：** 287 288| 类型 | 说明 | 289| --------------------- | ------------------------- | 290| Promise<void> | 无返回结果的Promise对象。当指定设备管理应用移除包安装白名单失败时，会抛出错误对象。 | 291 292**错误码**： 293 294以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 295 296| 错误码ID | 错误信息 | 297| ------- | ---------------------------------------------------------------------------- | 298| 9200001 | the application is not an administrator of the device. | 299| 9200002 | the administrator application does not have permission to manage the device. | 300 301**示例：** 302 303```ts 304import Want from '@ohos.app.ability.Want'; 305import { BusinessError } from '@ohos.base'; 306let wantTemp: Want = { 307 bundleName: 'com.example.myapplication', 308 abilityName: 'EntryAbility', 309}; 310let appIds: Array<string> = ['com.example.myapplication']; 311 312bundleManager.removeAllowedInstallBundles(wantTemp, appIds, 100).then(() => { 313 console.info('Succeeded in removing allowed install bundles'); 314}).catch((err: BusinessError) => { 315 console.error(`Failed to remove allowed install bundles. Code is ${err.code}, message is ${err.message}`); 316}); 317``` 318 319## bundleManager.getAllowedInstallBundles 320 321getAllowedInstallBundles(admin: Want, callback: AsyncCallback<Array<string>>): void 322 323指定设备管理应用获取当前用户下的包安装白名单，使用callback异步回调。 324 325**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 326 327**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 328 329**系统API**: 此接口为系统接口。 330 331**参数：** 332 333| 参数名 | 类型 | 必填 | 说明 | 334| -------- | ---------------------------------------- | ---- | ------------------------------- | 335| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 336| callback | AsyncCallback<Array<string>> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 337 338**错误码**： 339 340以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 341 342| 错误码ID | 错误信息 | 343| ------- | ---------------------------------------------------------------------------- | 344| 9200001 | the application is not an administrator of the device. | 345| 9200002 | the administrator application does not have permission to manage the device. | 346 347**示例：** 348 349```ts 350import Want from '@ohos.app.ability.Want'; 351let wantTemp: Want = { 352 bundleName: 'com.example.myapplication', 353 abilityName: 'EntryAbility', 354}; 355 356bundleManager.getAllowedInstallBundles(wantTemp, (err, result) => { 357 if (err) { 358 console.error(`Failed to get allowed install bundles. Code is ${err.code}, message is ${err.message}`); 359 return; 360 } 361 console.info(`Succeeded in getting allowed install bundles, result : ${JSON.stringify(result)}`); 362}); 363``` 364 365## bundleManager.getAllowedInstallBundles 366 367getAllowedInstallBundles(admin: Want, userId: number, callback: AsyncCallback<Array<string>>): void 368 369指定设备管理应用获取指定用户（通过userId指定）下的包安装白名单，使用callback异步回调。 370 371**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 372 373**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 374 375**系统API**: 此接口为系统接口。 376 377**参数：** 378 379| 参数名 | 类型 | 必填 | 说明 | 380| -------- | ---------------------------------------- | ---- | ------------------------------- | 381| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 382| userId | number | 是 | 用户ID，指定具体用户。取值范围：大于等于0。 | 383| callback | AsyncCallback<Array<string>> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 384 385**错误码**： 386 387以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 388 389| 错误码ID | 错误信息 | 390| ------- | ---------------------------------------------------------------------------- | 391| 9200001 | the application is not an administrator of the device. | 392| 9200002 | the administrator application does not have permission to manage the device. | 393 394**示例：** 395 396```ts 397import Want from '@ohos.app.ability.Want'; 398let wantTemp: Want = { 399 bundleName: 'com.example.myapplication', 400 abilityName: 'EntryAbility', 401}; 402 403bundleManager.getAllowedInstallBundles(wantTemp, 100, (err, result) => { 404 if (err) { 405 console.error(`Failed to get allowed install bundles. Code is ${err.code}, message is ${err.message}`); 406 return; 407 } 408 console.info(`Succeeded in getting allowed install bundles, result : ${JSON.stringify(result)}`); 409}); 410``` 411 412## bundleManager.getAllowedInstallBundles 413 414getAllowedInstallBundles(admin: Want, userId?: number): Promise<Array<string>> 415 416指定设备管理应用获取当前/指定用户下的包安装白名单，使用promise异步回调。 417 418**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 419 420**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 421 422**系统API**: 此接口为系统接口。 423 424**参数：** 425 426| 参数名 | 类型 | 必填 | 说明 | 427| ----- | ----------------------------------- | ---- | ------- | 428| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 429| userId | number | 否 | 用户ID，取值范围：大于等于0。<br> - 调用接口时，若传入userId，表示指定用户。<br> - 调用接口时，若未传入userId，表示当前用户。 | 430 431**返回值：** 432 433| 类型 | 说明 | 434| --------------------- | ------------------------- | 435| Promise<Array<string>> | Promise对象，返回当前用户下的包安装白名单。 | 436 437**错误码**： 438 439以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 440 441| 错误码ID | 错误信息 | 442| ------- | ---------------------------------------------------------------------------- | 443| 9200001 | the application is not an administrator of the device. | 444| 9200002 | the administrator application does not have permission to manage the device. | 445 446**示例：** 447 448```ts 449import Want from '@ohos.app.ability.Want'; 450import { BusinessError } from '@ohos.base'; 451let wantTemp: Want = { 452 bundleName: 'com.example.myapplication', 453 abilityName: 'EntryAbility', 454}; 455 456bundleManager.getAllowedInstallBundles(wantTemp, 100).then((result) => { 457 console.info(`Succeeded in getting allowed install bundles, result : ${JSON.stringify(result)}`); 458}).catch((err: BusinessError) => { 459 console.error(`Failed to get allowed install bundles. Code is ${err.code}, message is ${err.message}`); 460}); 461``` 462 463## bundleManager.addDisallowedInstallBundles 464 465addDisallowedInstallBundles(admin: Want, appIds: Array\<string>, callback: AsyncCallback<void>): void 466 467指定设备管理应用添加应用至包安装黑名单，添加至黑名单的应用不允许在当前用户下安装，使用callback异步回调。 468 469**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 470 471**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 472 473**系统API**: 此接口为系统接口。 474 475**参数：** 476 477| 参数名 | 类型 | 必填 | 说明 | 478| -------- | ---------------------------------------- | ---- | ------------------------------- | 479| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 480| appIds | Array<string> | 是 | 应用ID数组。 | 481| callback | AsyncCallback<void> | 是 | 回调函数。当接口调用成功，err为null，否则为错误对象。 | 482 483**错误码**： 484 485以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 486 487| 错误码ID | 错误信息 | 488| ------- | ---------------------------------------------------------------------------- | 489| 9200001 | the application is not an administrator of the device. | 490| 9200002 | the administrator application does not have permission to manage the device. | 491 492**示例：** 493 494```ts 495import Want from '@ohos.app.ability.Want'; 496let wantTemp: Want = { 497 bundleName: 'com.example.myapplication', 498 abilityName: 'EntryAbility', 499}; 500let appIds: Array<string> = ['com.example.myapplication']; 501 502bundleManager.addDisallowedInstallBundles(wantTemp, appIds, (err) => { 503 if (err) { 504 console.error(`Failed to add disallowed install bundles. Code is ${err.code}, message is ${err.message}`); 505 return; 506 } 507 console.info('Succeeded in adding disallowed install bundles'); 508}); 509``` 510 511## bundleManager.addDisallowedInstallBundles 512 513addDisallowedInstallBundles(admin: Want, appIds: Array\<string>, userId: number, callback: AsyncCallback<void>): void 514 515指定设备管理应用添加应用至包安装黑名单，添加至黑名单的应用不允许在指定用户（通过userId指定）下安装。使用callback异步回调。 516 517**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 518 519**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 520 521**系统API**: 此接口为系统接口。 522 523**参数：** 524 525| 参数名 | 类型 | 必填 | 说明 | 526| ----- | ----------------------------------- | ---- | ------- | 527| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 528| appIds | Array<string> | 是 | 应用ID数组。 | 529| userId | number | 是 | 用户ID，指定具体用户。取值范围：大于等于0。 | 530| callback | AsyncCallback<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 531 532**错误码**： 533 534以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 535 536| 错误码ID | 错误信息 | 537| ------- | ---------------------------------------------------------------------------- | 538| 9200001 | the application is not an administrator of the device. | 539| 9200002 | the administrator application does not have permission to manage the device. | 540 541**示例：** 542 543```ts 544import Want from '@ohos.app.ability.Want'; 545let wantTemp: Want = { 546 bundleName: 'com.example.myapplication', 547 abilityName: 'EntryAbility', 548}; 549let appIds: Array<string> = ['com.example.myapplication']; 550 551bundleManager.addDisallowedInstallBundles(wantTemp, appIds, 100, (err) => { 552 if (err) { 553 console.error(`Failed to add disallowed install bundles. Code is ${err.code}, message is ${err.message}`); 554 return; 555 } 556 console.info('Succeeded in adding disallowed install bundles'); 557}); 558``` 559 560## bundleManager.addDisallowedInstallBundles 561 562addDisallowedInstallBundles(admin: Want, appIds: Array\<string>, userId?: number): Promise<void> 563 564指定设备管理应用添加应用至包安装黑名单，添加至黑名单的应用不允许在当前/指定用户下安装。使用promise异步回调。 565 566**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 567 568**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 569 570**系统API**: 此接口为系统接口。 571 572**参数：** 573 574| 参数名 | 类型 | 必填 | 说明 | 575| ----- | ----------------------------------- | ---- | ------- | 576| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 577| appIds | Array<string> | 是 | 应用ID数组。 | 578| userId | number | 否 | 用户ID，取值范围：大于等于0。<br> - 调用接口时，若传入userId，表示指定用户。<br> - 调用接口时，若未传入userId，表示当前用户。 | 579 580**返回值：** 581 582| 类型 | 说明 | 583| --------------------- | ------------------------- | 584| Promise<void> | 无返回结果的Promise对象。当指定设备管理应用添加包安装黑名单失败时，会抛出错误对象。 | 585 586**错误码**： 587 588以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 589 590| 错误码ID | 错误信息 | 591| ------- | ---------------------------------------------------------------------------- | 592| 9200001 | the application is not an administrator of the device. | 593| 9200002 | the administrator application does not have permission to manage the device. | 594 595**示例：** 596 597```ts 598import Want from '@ohos.app.ability.Want'; 599import { BusinessError } from '@ohos.base'; 600let wantTemp: Want = { 601 bundleName: 'com.example.myapplication', 602 abilityName: 'EntryAbility', 603}; 604let appIds: Array<string> = ['com.example.myapplication']; 605 606bundleManager.addDisallowedInstallBundles(wantTemp, appIds, 100).then(() => { 607 console.info('Succeeded in adding disallowed install bundles'); 608}).catch((err: BusinessError) => { 609 console.error(`Failed to add disallowed install bundles. Code is ${err.code}, message is ${err.message}`); 610}); 611``` 612 613## bundleManager.removeDisallowedInstallBundles 614 615removeDisallowedInstallBundles(admin: Want, appIds: Array\<string>, callback: AsyncCallback<void>): void 616 617指定设备管理应用在包安装黑名单中移除应用，在黑名单存在的情况下，在包安装黑名单中的应用不允许在当前用户下安装。使用callback异步回调。 618 619**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 620 621**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 622 623**系统API**: 此接口为系统接口。 624 625**参数：** 626 627| 参数名 | 类型 | 必填 | 说明 | 628| -------- | ---------------------------------------- | ---- | ------------------------------- | 629| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 630| appIds | Array<string> | 是 | 应用ID数组。 | 631| callback | AsyncCallback<void> | 是 | 回调函数。当接口调用成功，err为null，否则为错误对象。 | 632 633**错误码**： 634 635以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 636 637| 错误码ID | 错误信息 | 638| ------- | ---------------------------------------------------------------------------- | 639| 9200001 | the application is not an administrator of the device. | 640| 9200002 | the administrator application does not have permission to manage the device. | 641 642**示例：** 643 644```ts 645import Want from '@ohos.app.ability.Want'; 646let wantTemp: Want = { 647 bundleName: 'com.example.myapplication', 648 abilityName: 'EntryAbility', 649}; 650let appIds: Array<string> = ['com.example.myapplication']; 651 652bundleManager.removeDisallowedInstallBundles(wantTemp, appIds, (err) => { 653 if (err) { 654 console.error(`Failed to remove disallowed install bundles. Code is ${err.code}, message is ${err.message}`); 655 return; 656 } 657 console.info('Succeeded in removing disallowed install bundles'); 658}); 659``` 660 661## bundleManager.removeDisallowedInstallBundles 662 663removeDisallowedInstallBundles(admin: Want, appIds: Array\<string>, userId: number, callback: AsyncCallback<void>): void 664 665指定设备管理应用在包安装黑名单中移除应用，在黑名单存在的情况下，在包安装黑名单中的应用不允许在指定用户（通过userId指定）下安装，使用callback异步回调。 666 667**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 668 669**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 670 671**系统API**: 此接口为系统接口。 672 673**参数：** 674 675| 参数名 | 类型 | 必填 | 说明 | 676| ----- | ----------------------------------- | ---- | ------- | 677| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 678| appIds | Array<string> | 是 | 应用ID数组。 | 679| userId | number | 是 | 用户ID，指定具体用户。取值范围：大于等于0。 | 680| callback | AsyncCallback<void> | 是 | 回调函数。当接口调用成功，err为null，否则为错误对象。 | 681 682**错误码**： 683 684以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 685 686| 错误码ID | 错误信息 | 687| ------- | ---------------------------------------------------------------------------- | 688| 9200001 | the application is not an administrator of the device. | 689| 9200002 | the administrator application does not have permission to manage the device. | 690 691**示例：** 692 693```ts 694import Want from '@ohos.app.ability.Want'; 695let wantTemp: Want = { 696 bundleName: 'com.example.myapplication', 697 abilityName: 'EntryAbility', 698}; 699let appIds: Array<string> = ['com.example.myapplication']; 700 701bundleManager.removeDisallowedInstallBundles(wantTemp, appIds, 100, (err) => { 702 if (err) { 703 console.error(`Failed to remove disallowed install bundles. Code is ${err.code}, message is ${err.message}`); 704 return; 705 } 706 console.info('Succeeded in removing disallowed install bundles'); 707}); 708``` 709 710## bundleManager.removeDisallowedInstallBundles 711 712removeDisallowedInstallBundles(admin: Want, appIds: Array\<string>, userId?: number): Promise<void> 713 714指定设备管理应用在包安装黑名单中移除应用，在黑名单存在的情况下，在包安装黑名单中的应用不允许在当前/指定用户下安装。使用promise异步回调。 715 716**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 717 718**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 719 720**系统API**: 此接口为系统接口。 721 722**参数：** 723 724| 参数名 | 类型 | 必填 | 说明 | 725| ----- | ----------------------------------- | ---- | ------- | 726| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 727| appIds | Array\<string> | 是 | 应用ID数组。 | 728| userId | number | 否 | 用户ID，取值范围：大于等于0。<br> - 调用接口时，若传入userId，表示指定用户。<br> - 调用接口时，若未传入userId，表示当前用户。 | 729 730**返回值：** 731 732| 类型 | 说明 | 733| --------------------- | ------------------------- | 734| Promise<void> | 无返回结果的Promise对象。当指定设备管理应用移除包安装黑名单失败时，会抛出错误对象。 | 735 736**错误码**： 737 738以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 739 740| 错误码ID | 错误信息 | 741| ------- | ---------------------------------------------------------------------------- | 742| 9200001 | the application is not an administrator of the device. | 743| 9200002 | the administrator application does not have permission to manage the device. | 744 745**示例：** 746 747```ts 748import Want from '@ohos.app.ability.Want'; 749import { BusinessError } from '@ohos.base'; 750let wantTemp: Want = { 751 bundleName: 'com.example.myapplication', 752 abilityName: 'EntryAbility', 753}; 754let appIds: Array<string> = ['com.example.myapplication']; 755 756bundleManager.removeDisallowedInstallBundles(wantTemp, appIds, 100).then(() => { 757 console.info('Succeeded in removing disallowed install bundles'); 758}).catch((err: BusinessError) => { 759 console.error(`Failed to remove disallowed install bundles. Code is ${err.code}, message is ${err.message}`); 760}); 761``` 762 763## bundleManager.getDisallowedInstallBundles 764 765getDisallowedInstallBundles(admin: Want, callback: AsyncCallback<Array<string>>): void 766 767指定设备管理应用获取当前用户下的包安装黑名单，使用callback异步回调。 768 769**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 770 771**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 772 773**系统API**: 此接口为系统接口。 774 775**参数：** 776 777| 参数名 | 类型 | 必填 | 说明 | 778| -------- | ---------------------------------------- | ---- | ------------------------------- | 779| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 780| callback | AsyncCallback<Array<string>> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 781 782**错误码**： 783 784以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 785 786| 错误码ID | 错误信息 | 787| ------- | ---------------------------------------------------------------------------- | 788| 9200001 | the application is not an administrator of the device. | 789| 9200002 | the administrator application does not have permission to manage the device. | 790 791**示例：** 792 793```ts 794import Want from '@ohos.app.ability.Want'; 795let wantTemp: Want = { 796 bundleName: 'com.example.myapplication', 797 abilityName: 'EntryAbility', 798}; 799 800bundleManager.getDisallowedInstallBundles(wantTemp, (err, result) => { 801 if (err) { 802 console.error(`Failed to get disallowed install bundles. Code is ${err.code}, message is ${err.message}`); 803 return; 804 } 805 console.info(`Succeeded in getting disallowed install bundles, result : ${JSON.stringify(result)}`); 806}); 807``` 808 809## bundleManager.getDisallowedInstallBundles 810 811getDisallowedInstallBundles(admin: Want, userId: number, callback: AsyncCallback<Array<string>>): void 812 813指定设备管理应用获取指定用户（通过userId指定）下的包安装黑名单，使用callback异步回调。 814 815**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 816 817**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 818 819**系统API**: 此接口为系统接口。 820 821**参数：** 822 823| 参数名 | 类型 | 必填 | 说明 | 824| -------- | ---------------------------------------- | ---- | ------------------------------- | 825| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 826| userId | number | 是 | 用户ID，指定具体用户。取值范围：大于等于0。 | 827| callback | AsyncCallback<Array<string>> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 828 829**错误码**： 830 831以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 832 833| 错误码ID | 错误信息 | 834| ------- | ---------------------------------------------------------------------------- | 835| 9200001 | the application is not an administrator of the device. | 836| 9200002 | the administrator application does not have permission to manage the device. | 837 838**示例：** 839 840```ts 841import Want from '@ohos.app.ability.Want'; 842let wantTemp: Want = { 843 bundleName: 'com.example.myapplication', 844 abilityName: 'EntryAbility', 845}; 846 847bundleManager.getDisallowedInstallBundles(wantTemp, 100, (err, result) => { 848 if (err) { 849 console.error(`Failed to get disallowed install bundles. Code is ${err.code}, message is ${err.message}`); 850 return; 851 } 852 console.info(`Succeeded in getting disallowed install bundles, result : ${JSON.stringify(result)}`); 853}); 854``` 855 856## bundleManager.getDisallowedInstallBundles 857 858getDisallowedInstallBundles(admin: Want, userId?: number): Promise<Array<string>> 859 860指定设备管理应用获取当前/指定用户下的包安装黑名单，使用promise异步回调。 861 862**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 863 864**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 865 866**系统API**: 此接口为系统接口。 867 868**参数：** 869 870| 参数名 | 类型 | 必填 | 说明 | 871| ----- | ----------------------------------- | ---- | ------- | 872| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 873| userId | number | 否 | 用户ID，取值范围：大于等于0。<br> - 调用接口时，若传入userId，表示指定用户。<br> - 调用接口时，若未传入userId，表示当前用户。 | 874 875**返回值：** 876 877| 类型 | 说明 | 878| --------------------- | ------------------------- | 879| Promise<Array<string>> | Promise对象，返回当前用户下的包安装白名单。 | 880 881**错误码**： 882 883以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 884 885| 错误码ID | 错误信息 | 886| ------- | ---------------------------------------------------------------------------- | 887| 9200001 | the application is not an administrator of the device. | 888| 9200002 | the administrator application does not have permission to manage the device. | 889 890**示例：** 891 892```ts 893import Want from '@ohos.app.ability.Want'; 894import { BusinessError } from '@ohos.base'; 895let wantTemp: Want = { 896 bundleName: 'com.example.myapplication', 897 abilityName: 'EntryAbility', 898}; 899 900bundleManager.getDisallowedInstallBundles(wantTemp, 100).then((result) => { 901 console.info(`Succeeded in getting disallowed install bundles, result : ${JSON.stringify(result)}`); 902}).catch((err: BusinessError) => { 903 console.error(`Failed to get disallowed install bundles. Code is ${err.code}, message is ${err.message}`); 904}); 905``` 906 907## bundleManager.addDisallowedUninstallBundles 908 909addDisallowedUninstallBundles(admin: Want, appIds: Array\<string>, callback: AsyncCallback<void>): void 910 911指定设备管理应用添加应用至包卸载黑名单，添加至黑名单的应用不允许在当前用户下卸载，使用callback异步回调。 912 913**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 914 915**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 916 917**系统API**: 此接口为系统接口。 918 919**参数：** 920 921| 参数名 | 类型 | 必填 | 说明 | 922| -------- | ---------------------------------------- | ---- | ------------------------------- | 923| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 924| appIds | Array<string> | 是 | 应用ID数组。 | 925| callback | AsyncCallback<void> | 是 | 回调函数。当接口调用成功，err为null，否则为错误对象。 | 926 927**错误码**： 928 929以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 930 931| 错误码ID | 错误信息 | 932| ------- | ---------------------------------------------------------------------------- | 933| 9200001 | the application is not an administrator of the device. | 934| 9200002 | the administrator application does not have permission to manage the device. | 935 936**示例：** 937 938```ts 939import Want from '@ohos.app.ability.Want'; 940let wantTemp: Want = { 941 bundleName: 'com.example.myapplication', 942 abilityName: 'EntryAbility', 943}; 944let appIds: Array<string> = ['com.example.myapplication']; 945 946bundleManager.addDisallowedUninstallBundles(wantTemp, appIds, (err) => { 947 if (err) { 948 console.error(`Failed to add disallowed uninstall bundles. Code is ${err.code}, message is ${err.message}`); 949 return; 950 } 951 console.info('Succeeded in adding disallowed uninstall bundles'); 952}); 953``` 954 955## bundleManager.addDisallowedUninstallBundles 956 957addDisallowedUninstallBundles(admin: Want, appIds: Array\<string>, userId: number, callback: AsyncCallback<void>): void 958 959指定设备管理应用添加应用至包卸载黑名单，添加至黑名单的应用不允许在指定用户（通过userId指定）下卸载。使用callback异步回调。 960 961**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 962 963**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 964 965**系统API**: 此接口为系统接口。 966 967**参数：** 968 969| 参数名 | 类型 | 必填 | 说明 | 970| ----- | ----------------------------------- | ---- | ------- | 971| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 972| appIds | Array<string> | 是 | 应用ID数组。 | 973| userId | number | 是 | 用户ID，指定具体用户。取值范围：大于等于0。 | 974| callback | AsyncCallback<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 975 976**错误码**： 977 978以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 979 980| 错误码ID | 错误信息 | 981| ------- | ---------------------------------------------------------------------------- | 982| 9200001 | the application is not an administrator of the device. | 983| 9200002 | the administrator application does not have permission to manage the device. | 984 985**示例：** 986 987```ts 988import Want from '@ohos.app.ability.Want'; 989let wantTemp: Want = { 990 bundleName: 'com.example.myapplication', 991 abilityName: 'EntryAbility', 992}; 993let appIds: Array<string> = ['com.example.myapplication']; 994 995bundleManager.addDisallowedUninstallBundles(wantTemp, appIds, 100, (err) => { 996 if (err) { 997 console.error(`Failed to add disallowed uninstall bundles. Code is ${err.code}, message is ${err.message}`); 998 return; 999 } 1000 console.info('Succeeded in adding disallowed uninstall bundles'); 1001}); 1002``` 1003 1004## bundleManager.addDisallowedUninstallBundles 1005 1006addDisallowedUninstallBundles(admin: Want, appIds: Array\<string>, userId?: number): Promise<void> 1007 1008指定设备管理应用添加应用至包卸载黑名单，添加至黑名单的应用不允许在当前/指定用户下卸载。使用promise异步回调。 1009 1010**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 1011 1012**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1013 1014**系统API**: 此接口为系统接口。 1015 1016**参数：** 1017 1018| 参数名 | 类型 | 必填 | 说明 | 1019| ----- | ----------------------------------- | ---- | ------- | 1020| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1021| appIds | Array<string> | 是 | 应用ID数组。 | 1022| userId | number | 否 | 用户ID，取值范围：大于等于0。<br> - 调用接口时，若传入userId，表示指定用户。<br> - 调用接口时，若未传入userId，表示当前用户。 | 1023 1024**返回值：** 1025 1026| 类型 | 说明 | 1027| --------------------- | ------------------------- | 1028| Promise<void> | 无返回结果的Promise对象。当指定设备管理应用添加包卸载黑名单失败时，会抛出错误对象。 | 1029 1030**错误码**： 1031 1032以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1033 1034| 错误码ID | 错误信息 | 1035| ------- | ---------------------------------------------------------------------------- | 1036| 9200001 | the application is not an administrator of the device. | 1037| 9200002 | the administrator application does not have permission to manage the device. | 1038 1039**示例：** 1040 1041```ts 1042import Want from '@ohos.app.ability.Want'; 1043import { BusinessError } from '@ohos.base'; 1044let wantTemp: Want = { 1045 bundleName: 'com.example.myapplication', 1046 abilityName: 'EntryAbility', 1047}; 1048let appIds: Array<string> = ['com.example.myapplication']; 1049 1050bundleManager.addDisallowedUninstallBundles(wantTemp, appIds, 100).then(() => { 1051 console.info('Succeeded in adding disallowed uninstall bundles'); 1052}).catch((err: BusinessError) => { 1053 console.error(`Failed to add disallowed uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1054}); 1055``` 1056 1057## bundleManager.removeDisallowedUninstallBundles 1058 1059removeDisallowedUninstallBundles(admin: Want, appIds: Array\<string>, callback: AsyncCallback<void>): void 1060 1061指定设备管理应用在包卸载黑名单中移除应用，在黑名单存在的情况下，在包卸载黑名单中的应用不允许在当前用户下卸载，使用callback异步回调。 1062 1063**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 1064 1065**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1066 1067**系统API**: 此接口为系统接口。 1068 1069**参数：** 1070 1071| 参数名 | 类型 | 必填 | 说明 | 1072| -------- | ---------------------------------------- | ---- | ------------------------------- | 1073| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1074| appIds | Array<string> | 是 | 应用ID数组。 | 1075| callback | AsyncCallback<void> | 是 | 回调函数。当接口调用成功，err为null，否则为错误对象。 | 1076 1077**错误码**： 1078 1079以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1080 1081| 错误码ID | 错误信息 | 1082| ------- | ---------------------------------------------------------------------------- | 1083| 9200001 | the application is not an administrator of the device. | 1084| 9200002 | the administrator application does not have permission to manage the device. | 1085 1086**示例：** 1087 1088```ts 1089import Want from '@ohos.app.ability.Want'; 1090let wantTemp: Want = { 1091 bundleName: 'com.example.myapplication', 1092 abilityName: 'EntryAbility', 1093}; 1094let appIds: Array<string> = ['com.example.myapplication']; 1095 1096bundleManager.removeDisallowedUninstallBundles(wantTemp, appIds, (err) => { 1097 if (err) { 1098 console.error(`Failed to remove disallowed uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1099 return; 1100 } 1101 console.info('Succeeded in removing disallowed uninstall bundles'); 1102}); 1103``` 1104 1105## bundleManager.removeDisallowedUninstallBundles 1106 1107removeDisallowedUninstallBundles(admin: Want, appIds: Array\<string>, userId: number, callback: AsyncCallback<void>): void 1108 1109指定设备管理应用在包卸载黑名单中移除应用，在黑名单存在的情况下，在包卸载黑名单中的应用不允许在指定用户（通过userId指定）下卸载。使用callback异步回调。 1110 1111**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 1112 1113**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1114 1115**系统API**: 此接口为系统接口。 1116 1117**参数：** 1118 1119| 参数名 | 类型 | 必填 | 说明 | 1120| ----- | ----------------------------------- | ---- | ------- | 1121| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1122| appIds | Array<string> | 是 | 应用ID数组。 | 1123| userId | number | 是 | 用户ID，指定具体用户。取值范围：大于等于0。 | 1124| callback | AsyncCallback<void> | 是 | 回调函数。当接口调用成功，err为null，否则为错误对象。 | 1125 1126**错误码**： 1127 1128以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1129 1130| 错误码ID | 错误信息 | 1131| ------- | ---------------------------------------------------------------------------- | 1132| 9200001 | the application is not an administrator of the device. | 1133| 9200002 | the administrator application does not have permission to manage the device. | 1134 1135**示例：** 1136 1137```ts 1138import Want from '@ohos.app.ability.Want'; 1139let wantTemp: Want = { 1140 bundleName: 'com.example.myapplication', 1141 abilityName: 'EntryAbility', 1142}; 1143let appIds: Array<string> = ['com.example.myapplication']; 1144 1145bundleManager.removeDisallowedUninstallBundles(wantTemp, appIds, 100, (err) => { 1146 if (err) { 1147 console.error(`Failed to remove disallowed uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1148 return; 1149 } 1150 console.info('Succeeded in removing disallowed uninstall bundles'); 1151}); 1152``` 1153 1154## bundleManager.removeDisallowedUninstallBundles 1155 1156removeDisallowedUninstallBundles(admin: Want, appIds: Array\<string>, userId?: number): Promise<void> 1157 1158指定设备管理应用在包卸载黑名单中移除应用。在黑名单存在的情况下，在包卸载黑名单中的应用不允许在当前/指定用户下卸载。使用promise异步回调。 1159 1160**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 1161 1162**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1163 1164**系统API**: 此接口为系统接口。 1165 1166**参数：** 1167 1168| 参数名 | 类型 | 必填 | 说明 | 1169| ----- | ----------------------------------- | ---- | ------- | 1170| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1171| appIds | Array\<string> | 是 | 应用ID数组。 | 1172| userId | number | 否 | 用户ID，取值范围：大于等于0。<br> - 调用接口时，若传入userId，表示指定用户。<br> - 调用接口时，若未传入userId，表示当前用户。 | 1173 1174**返回值：** 1175 1176| 类型 | 说明 | 1177| --------------------- | ------------------------- | 1178| Promise<void> | 无返回结果的Promise对象。当指定设备管理应用移除包卸载黑名单失败时会抛出错误对象。 | 1179 1180**错误码**： 1181 1182以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1183 1184| 错误码ID | 错误信息 | 1185| ------- | ---------------------------------------------------------------------------- | 1186| 9200001 | the application is not an administrator of the device. | 1187| 9200002 | the administrator application does not have permission to manage the device. | 1188 1189**示例：** 1190 1191```ts 1192import Want from '@ohos.app.ability.Want'; 1193import { BusinessError } from '@ohos.base'; 1194let wantTemp: Want = { 1195 bundleName: 'com.example.myapplication', 1196 abilityName: 'EntryAbility', 1197}; 1198let appIds: Array<string> = ['com.example.myapplication']; 1199 1200bundleManager.removeDisallowedUninstallBundles(wantTemp, appIds, 100).then(() => { 1201 console.info('Succeeded in removing disallowed uninstall bundles'); 1202}).catch((err: BusinessError) => { 1203 console.error(`Failed to remove disallowed uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1204}); 1205``` 1206 1207## bundleManager.getDisallowedUninstallBundles 1208 1209getDisallowedUninstallBundles(admin: Want, callback: AsyncCallback<Array<string>>): void 1210 1211指定设备管理应用获取当前用户下的包卸载黑名单，使用callback异步回调。 1212 1213**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 1214 1215**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1216 1217**系统API**: 此接口为系统接口。 1218 1219**参数：** 1220 1221| 参数名 | 类型 | 必填 | 说明 | 1222| -------- | ---------------------------------------- | ---- | ------------------------------- | 1223| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1224| callback | AsyncCallback<Array<string>> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 1225 1226**错误码**： 1227 1228以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1229 1230| 错误码ID | 错误信息 | 1231| ------- | ---------------------------------------------------------------------------- | 1232| 9200001 | the application is not an administrator of the device. | 1233| 9200002 | the administrator application does not have permission to manage the device. | 1234 1235**示例：** 1236 1237```ts 1238import Want from '@ohos.app.ability.Want'; 1239let wantTemp: Want = { 1240 bundleName: 'com.example.myapplication', 1241 abilityName: 'EntryAbility', 1242}; 1243 1244bundleManager.getDisallowedUninstallBundles(wantTemp, (err, result) => { 1245 if (err) { 1246 console.error(`Failed to get disallowed uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1247 return; 1248 } 1249 console.info(`Succeeded in getting disallowed uninstall bundles, result : ${JSON.stringify(result)}`); 1250}); 1251``` 1252 1253## bundleManager.getDisallowedUninstallBundles 1254 1255getDisallowedUninstallBundles(admin: Want, userId: number, callback: AsyncCallback<Array<string>>): void 1256 1257指定设备管理应用获取指定用户（通过userId指定）下的包卸载黑名单，使用callback异步回调。 1258 1259**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 1260 1261**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1262 1263**系统API**: 此接口为系统接口。 1264 1265**参数：** 1266 1267| 参数名 | 类型 | 必填 | 说明 | 1268| -------- | ---------------------------------------- | ---- | ------------------------------- | 1269| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1270| userId | number | 是 | 用户ID，指定具体用户。取值范围：大于等于0。 | 1271| callback | AsyncCallback<Array<string>> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 1272 1273**错误码**： 1274 1275以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1276 1277| 错误码ID | 错误信息 | 1278| ------- | ---------------------------------------------------------------------------- | 1279| 9200001 | the application is not an administrator of the device. | 1280| 9200002 | the administrator application does not have permission to manage the device. | 1281 1282**示例：** 1283 1284```ts 1285import Want from '@ohos.app.ability.Want'; 1286let wantTemp: Want = { 1287 bundleName: 'com.example.myapplication', 1288 abilityName: 'EntryAbility', 1289}; 1290 1291bundleManager.getDisallowedUninstallBundles(wantTemp, 100, (err, result) => { 1292 if (err) { 1293 console.error(`Failed to get disallowed uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1294 return; 1295 } 1296 console.info(`Succeeded in getting disallowed uninstall bundles, result : ${JSON.stringify(result)}`); 1297}); 1298``` 1299 1300## bundleManager.getDisallowedUninstallBundles 1301 1302getDisallowedUninstallBundles(admin: Want, userId?: number): Promise<Array<string>> 1303 1304指定设备管理应用获取当前/指定用户下包卸载黑名单接口，使用promise异步回调。 1305 1306**需要权限：** ohos.permission.ENTERPRISE_SET_BUNDLE_INSTALL_POLICY 1307 1308**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1309 1310**系统API**: 此接口为系统接口。 1311 1312**参数：** 1313 1314| 参数名 | 类型 | 必填 | 说明 | 1315| ----- | ----------------------------------- | ---- | ------- | 1316| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1317| userId | number | 否 | 用户ID，取值范围：大于等于0。<br> - 调用接口时，若传入userId，表示指定用户。<br> - 调用接口时，若未传入userId，表示当前用户。 | 1318 1319**返回值：** 1320 1321| 类型 | 说明 | 1322| --------------------- | ------------------------- | 1323| Promise<Array<string>> | Promise对象，返回当前用户下的包卸载白名单。 | 1324 1325**错误码**： 1326 1327以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1328 1329| 错误码ID | 错误信息 | 1330| ------- | ---------------------------------------------------------------------------- | 1331| 9200001 | the application is not an administrator of the device. | 1332| 9200002 | the administrator application does not have permission to manage the device. | 1333 1334**示例：** 1335 1336```ts 1337import Want from '@ohos.app.ability.Want'; 1338import { BusinessError } from '@ohos.base'; 1339let wantTemp: Want = { 1340 bundleName: 'com.example.myapplication', 1341 abilityName: 'EntryAbility', 1342}; 1343 1344bundleManager.getDisallowedUninstallBundles(wantTemp, 100).then((result) => { 1345 console.info(`Succeeded in getting disallowed uninstall bundles, result : ${JSON.stringify(result)}`); 1346}).catch((err: BusinessError) => { 1347 console.error(`Failed to get disallowed uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1348}); 1349``` 1350 1351## bundleManager.uninstall 1352 1353uninstall(admin: Want, bundleName: string, callback: AsyncCallback<void>): void 1354 1355指定设备管理应用卸载当前用户下的指定包，且不保留包数据。使用callback异步回调。 1356 1357**需要权限：** ohos.permission.ENTERPRISE_INSTALL_BUNDLE 1358 1359**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1360 1361**系统API**: 此接口为系统接口。 1362 1363**参数：** 1364 1365| 参数名 | 类型 | 必填 | 说明 | 1366| -------- | ---------------------------------------- | ---- | ------------------------------- | 1367| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1368| bundleName | string | 是 | 包名。 | 1369| callback | AsyncCallback<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 1370 1371**错误码**： 1372 1373以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1374 1375| 错误码ID | 错误信息 | 1376| ------- | ---------------------------------------------------------------------------- | 1377| 9200001 | the application is not an administrator of the device. | 1378| 9200002 | the administrator application does not have permission to manage the device. | 1379 1380**示例：** 1381 1382```ts 1383import Want from '@ohos.app.ability.Want'; 1384let wantTemp: Want = { 1385 bundleName: 'com.example.myapplication', 1386 abilityName: 'EntryAbility', 1387}; 1388 1389bundleManager.uninstall(wantTemp, 'bundleName', (err) => { 1390 if (err) { 1391 console.error(`Failed to uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1392 return; 1393 } 1394 console.info('Succeeded in uninstalling bundles'); 1395}); 1396``` 1397 1398## bundleManager.uninstall 1399 1400uninstall(admin: Want, bundleName: string, userId: number, callback: AsyncCallback<void>): void 1401 1402指定设备管理应用卸载指定用户下（由参数userId指定）的指定包，且不保留包数据。使用callback异步回调。 1403 1404**需要权限：** ohos.permission.ENTERPRISE_INSTALL_BUNDLE 1405 1406**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1407 1408**系统API**: 此接口为系统接口。 1409 1410**参数：** 1411 1412| 参数名 | 类型 | 必填 | 说明 | 1413| -------- | ---------------------------------------- | ---- | ------------------------------- | 1414| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1415| bundleName | string | 是 | 包名。 | 1416| userId | number | 是 | 用户ID，指定具体用户。取值范围：大于等于0。 | 1417| callback | AsyncCallback<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 1418 1419**错误码**： 1420 1421以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1422 1423| 错误码ID | 错误信息 | 1424| ------- | ---------------------------------------------------------------------------- | 1425| 9200001 | the application is not an administrator of the device. | 1426| 9200002 | the administrator application does not have permission to manage the device. | 1427 1428**示例：** 1429 1430```ts 1431import Want from '@ohos.app.ability.Want'; 1432let wantTemp: Want = { 1433 bundleName: 'com.example.myapplication', 1434 abilityName: 'EntryAbility', 1435}; 1436 1437bundleManager.uninstall(wantTemp, 'bundleName', 100, (err) => { 1438 if (err) { 1439 console.error(`Failed to uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1440 return; 1441 } 1442 console.info('Succeeded in uninstalling bundles'); 1443}); 1444``` 1445 1446## bundleManager.uninstall 1447 1448uninstall(admin: Want, bundleName: string, isKeepData: boolean, callback: AsyncCallback<void>): void 1449 1450指定设备管理应用卸载当前用户下的指定包，选择是否保留包数据（由isKeepData指定）。使用callback异步回调。 1451 1452**需要权限：** ohos.permission.ENTERPRISE_INSTALL_BUNDLE 1453 1454**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1455 1456**系统API**: 此接口为系统接口。 1457 1458**参数：** 1459 1460| 参数名 | 类型 | 必填 | 说明 | 1461| -------- | ---------------------------------------- | ---- | ------------------------------- | 1462| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1463| bundleName | string | 是 | 包名。 | 1464| isKeepData | boolean | 是 | 是否保留包数据，true表示保留，false表示不保留。 | 1465| callback | AsyncCallback<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 1466 1467**错误码**： 1468 1469以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1470 1471| 错误码ID | 错误信息 | 1472| ------- | ---------------------------------------------------------------------------- | 1473| 9200001 | the application is not an administrator of the device. | 1474| 9200002 | the administrator application does not have permission to manage the device. | 1475 1476**示例：** 1477 1478```ts 1479import Want from '@ohos.app.ability.Want'; 1480let wantTemp: Want = { 1481 bundleName: 'com.example.myapplication', 1482 abilityName: 'EntryAbility', 1483}; 1484 1485bundleManager.uninstall(wantTemp, 'bundleName', true, (err) => { 1486 if (err) { 1487 console.error(`Failed to uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1488 return; 1489 } 1490 console.info('Succeeded in uninstalling bundles'); 1491}); 1492``` 1493 1494## bundleManager.uninstall 1495 1496uninstall(admin: Want, bundleName: string, userId: number, isKeepData: boolean, callback: AsyncCallback<void>): void 1497 1498指定设备管理应用卸载指定用户下（由参数userId指定）的指定包接口，选择是否保留包数据（由isKeepData指定）。使用callback异步回调。 1499 1500**需要权限：** ohos.permission.ENTERPRISE_INSTALL_BUNDLE 1501 1502**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1503 1504**系统API**: 此接口为系统接口。 1505 1506**参数：** 1507 1508| 参数名 | 类型 | 必填 | 说明 | 1509| -------- | ---------------------------------------- | ---- | ------------------------------- | 1510| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1511| bundleName | string | 是 | 包名。 | 1512| userId | number | 是 | 用户ID，指定具体用户。取值范围：大于等于0。 | 1513| isKeepData | boolean | 是 | 是否保留包数据，true表示保留，false表示不保留。 | 1514| callback | AsyncCallback<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 1515 1516**错误码**： 1517 1518以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1519 1520| 错误码ID | 错误信息 | 1521| ------- | ---------------------------------------------------------------------------- | 1522| 9200001 | the application is not an administrator of the device. | 1523| 9200002 | the administrator application does not have permission to manage the device. | 1524 1525**示例：** 1526 1527```ts 1528import Want from '@ohos.app.ability.Want'; 1529let wantTemp: Want = { 1530 bundleName: 'com.example.myapplication', 1531 abilityName: 'EntryAbility', 1532}; 1533 1534bundleManager.uninstall(wantTemp, 'bundleName', 100, true, (err) => { 1535 if (err) { 1536 console.error(`Failed to uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1537 return; 1538 } 1539 console.info('Succeeded in uninstalling bundles'); 1540}); 1541``` 1542 1543## bundleManager.uninstall 1544 1545uninstall(admin: Want, bundleName: string, userId?: number, isKeepData?: boolean): Promise<void> 1546 1547指定设备管理应用卸载当前/指定用户下的指定包接口，选择是否保留包数据（由isKeepData指定）。使用promise异步回调。 1548 1549**需要权限：** ohos.permission.ENTERPRISE_INSTALL_BUNDLE 1550 1551**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1552 1553**系统API**: 此接口为系统接口。 1554 1555**参数：** 1556 1557| 参数名 | 类型 | 必填 | 说明 | 1558| ----- | ----------------------------------- | ---- | ------- | 1559| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1560| bundleName | string | 是 | 包名。 | 1561| userId | number | 否 | 用户ID，取值范围：大于等于0。<br> - 调用接口时，若传入userId，表示指定用户。<br> - 调用接口时，若未传入userId，表示当前用户。 | 1562| isKeepData | boolean | 否 | 是否保留包数据，true表示保留，false表示不保留。 | 1563 1564**返回值：** 1565 1566| 类型 | 说明 | 1567| --------------------- | ------------------------- | 1568| Promise<void> | 无返回结果的Promise对象。当包卸载失败时抛出错误对象。 | 1569 1570**错误码**： 1571 1572以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1573 1574| 错误码ID | 错误信息 | 1575| ------- | ---------------------------------------------------------------------------- | 1576| 9200001 | the application is not an administrator of the device. | 1577| 9200002 | the administrator application does not have permission to manage the device. | 1578 1579**示例：** 1580 1581```ts 1582import Want from '@ohos.app.ability.Want'; 1583import { BusinessError } from '@ohos.base'; 1584let wantTemp: Want = { 1585 bundleName: 'com.example.myapplication', 1586 abilityName: 'EntryAbility', 1587}; 1588 1589bundleManager.uninstall(wantTemp, 'bundleName', 100, true).then(() => { 1590 console.info('Succeeded in uninstalling bundles'); 1591}).catch((err: BusinessError) => { 1592 console.error(`Failed to uninstall bundles. Code is ${err.code}, message is ${err.message}`); 1593}); 1594``` 1595 1596## bundleManager.install 1597 1598install(admin: Want, hapFilePaths: Array\<string>, callback: AsyncCallback\<void>): void 1599 1600指定设备管理应用安装指定路径下的应用包。使用callback异步回调。 1601 1602**需要权限：** ohos.permission.ENTERPRISE_INSTALL_BUNDLE 1603 1604**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1605 1606**系统API**: 此接口为系统接口。 1607 1608**参数：** 1609 1610| 参数名 | 类型 | 必填 | 说明 | 1611| -------- | ---------------------------------------- | ---- | ------------------------------- | 1612| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1613| hapFilePaths | Array\<string> | 是 | 待安装应用包路径数组。 | 1614| callback | AsyncCallback<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 1615 1616**错误码**： 1617 1618以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1619 1620| 错误码ID | 错误信息 | 1621| ------- | ---------------------------------------------------------------------------- | 1622| 9200001 | the application is not an administrator of the device. | 1623| 9200002 | the administrator application does not have permission to manage the device. | 1624| 9201002 | the application install failed. | 1625 1626**示例：** 1627 1628```ts 1629import Want from '@ohos.app.ability.Want'; 1630let wantTemp: Want = { 1631 bundleName: 'com.example.myapplication', 1632 abilityName: 'EntryAbility', 1633}; 1634let hapFilePaths: Array<string> = ['/data/storage/el2/base/haps/entry/testinstall/ExtensionTest.hap']; 1635 1636bundleManager.install(wantTemp, hapFilePaths, (err) => { 1637 if (err) { 1638 console.error(`Failed to install bundles. Code is ${err.code}, message is ${err.message}`); 1639 return; 1640 } 1641 console.info('Succeeded in installing bundles'); 1642}); 1643``` 1644 1645## bundleManager.install 1646 1647install(admin: Want, hapFilePaths: Array\<string>, installParam: InstallParam, callback: AsyncCallback\<void>): void 1648 1649指定设备管理应用安装指定路径下的指定安装参数的应用包,。使用callback异步回调。 1650 1651**需要权限：** ohos.permission.ENTERPRISE_INSTALL_BUNDLE 1652 1653**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1654 1655**系统API**: 此接口为系统接口。 1656 1657**参数：** 1658 1659| 参数名 | 类型 | 必填 | 说明 | 1660| -------- | ---------------------------------------- | ---- | ------------------------------- | 1661| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1662| hapFilePaths | Array\<string> | 是 | 待安装应用包路径数组。 | 1663| installParam | [InstallParam](#installparam) | 是 | 应用包安装参数。 | 1664| callback | AsyncCallback<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 1665 1666**错误码**： 1667 1668以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1669 1670| 错误码ID | 错误信息 | 1671| ------- | ---------------------------------------------------------------------------- | 1672| 9200001 | the application is not an administrator of the device. | 1673| 9200002 | the administrator application does not have permission to manage the device. | 1674| 9201002 | the application install failed. | 1675 1676**示例：** 1677 1678```ts 1679import Want from '@ohos.app.ability.Want'; 1680let wantTemp: Want = { 1681 bundleName: 'com.example.myapplication', 1682 abilityName: 'EntryAbility', 1683}; 1684let hapFilePaths: Array<string> = ['/data/storage/el2/base/haps/entry/testinstall/ExtensionTest.hap']; 1685let installParam: bundleManager.InstallParam = { 1686 userId: 100, 1687 installFlag: 1, 1688}; 1689 1690bundleManager.install(wantTemp, hapFilePaths, installParam, (err) => { 1691 if (err) { 1692 console.error(`Failed to install bundles. Code is ${err.code}, message is ${err.message}`); 1693 return; 1694 } 1695 console.info('Succeeded in installing bundles'); 1696}); 1697``` 1698 1699## bundleManager.install 1700 1701install(admin: Want, hapFilePaths: Array\<string>, installParam?: InstallParam): Promise\<void> 1702 1703指定设备管理应用安装指定路径下的应用包。使用promise异步回调。 1704 1705**需要权限：** ohos.permission.ENTERPRISE_INSTALL_BUNDLE 1706 1707**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1708 1709**系统API**: 此接口为系统接口。 1710 1711**参数：** 1712 1713| 参数名 | 类型 | 必填 | 说明 | 1714| ----- | ----------------------------------- | ---- | ------- | 1715| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 1716| hapFilePaths | Array\<string> | 是 | 待安装应用包路径数组。 | 1717| installParam | [InstallParam](#installparam) | 否 | 应用包安装参数。 | 1718 1719**返回值：** 1720 1721| 类型 | 说明 | 1722| --------------------- | ------------------------- | 1723| Promise<void> | 无返回结果的Promise对象。当包安装失败时，抛出错误对象。 | 1724 1725**错误码**： 1726 1727以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 1728 1729| 错误码ID | 错误信息 | 1730| ------- | ---------------------------------------------------------------------------- | 1731| 9200001 | the application is not an administrator of the device. | 1732| 9200002 | the administrator application does not have permission to manage the device. | 1733| 9201002 | the application install failed. | 1734 1735**示例：** 1736 1737```ts 1738import Want from '@ohos.app.ability.Want'; 1739import { BusinessError } from '@ohos.base'; 1740let wantTemp: Want = { 1741 bundleName: 'com.example.myapplication', 1742 abilityName: 'EntryAbility', 1743}; 1744let hapFilePaths: Array<string> = ['/data/storage/el2/base/haps/entry/testinstall/ExtensionTest.hap']; 1745 1746bundleManager.install(wantTemp, hapFilePaths).then(() => { 1747 console.info('Succeeded in installing bundles'); 1748}).catch((err: BusinessError) => { 1749 console.error(`Failed to install bundles. Code is ${err.code}, message is ${err.message}`); 1750}); 1751``` 1752 1753## InstallParam 1754 1755应用包安装需指定的参数信息。 1756 1757 **系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 1758 1759 **系统接口：** 此接口为系统接口。 1760 1761| 名称 | 类型 | 必填 | 说明 | 1762| ------------------------------ | ------------------------------ | ------------------ | ------------------ | 1763| userId | number | 否 | 指示用户id，默认值：调用方所在用户，取值范围：大于等于0。 1764| installFlag | number | 否 | 安装标志。枚举值：0：应用初次安装，1：应用覆盖安装，2：应用免安装，默认值为应用初次安装。 |