1# @ohos.enterprise.EnterpriseAdminExtensionAbility（企业设备管理扩展能力）(系统接口) 2 3本模块提供企业设备管理扩展能力。 4 5企业管理员应用需要存在一个EnterpriseAdminExtensionAbility并重写相关接口，以此具备模块提供的各项能力，比如接收由系统发送的该应用被激活或者去激活的通知。 6 7> **说明：** 8> 9> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 10> 11> 本模块接口仅可在Stage模型下使用。 12> 13> 本模块接口均为系统接口。 14 15## 导入模块 16 17```ts 18import EnterpriseAdminExtensionAbility from '@ohos.enterprise.EnterpriseAdminExtensionAbility' 19``` 20 21## EnterpriseAdminExtensionAbility.onAdminEnabled 22 23onAdminEnabled(): void 24 25设备管理员被激活事件回调。 26 27**系统能力**：SystemCapability.Customization.EnterpriseDeviceManager 28 29 30 31**示例：** 32 33```ts 34export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbility { 35 onAdminEnabled() { 36 } 37}; 38``` 39 40## EnterpriseAdminExtensionAbility.onAdminDisabled 41 42onAdminDisabled(): void 43 44设备管理员被去激活事件回调。 45 46**系统能力**：SystemCapability.Customization.EnterpriseDeviceManager 47 48 49 50**示例：** 51 52```ts 53export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbility { 54 onAdminDisabled() { 55 } 56}; 57``` 58 59## EnterpriseAdminExtensionAbility.onBundleAdded 60 61onBundleAdded(bundleName: string): void 62 63应用安装事件回调。 64 65**系统能力**：SystemCapability.Customization.EnterpriseDeviceManager 66 67 68 69**参数：** 70 71| 参数名 | 类型 | 必填 | 说明 | 72| ----- | ----------------------------------- | ---- | ------- | 73| bundleName | string | 是 | 安装应用Bundle名称。 | 74 75**示例：** 76 77```ts 78export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbility { 79 onBundleAdded(bundleName: string) { 80 console.info(`Succeeded in calling onBundleAdded callback, added bundle name : ${bundleName}`); 81 } 82}; 83``` 84 85## EnterpriseAdminExtensionAbility.onBundleRemoved 86 87onBundleRemoved(bundleName: string): void 88 89应用卸载事件回调。 90 91**系统能力**：SystemCapability.Customization.EnterpriseDeviceManager 92 93 94 95**参数：** 96 97| 参数名 | 类型 | 必填 | 说明 | 98| ----- | ----------------------------------- | ---- | ------- | 99| bundleName | string | 是 | 卸载应用Bundle名称。 | 100 101**示例：** 102 103```ts 104export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbility { 105 onBundleRemoved(bundleName: string) { 106 console.info(`Succeeded in calling onBundleRemoved callback, removed bundle name : ${bundleName}`); 107 } 108}; 109``` 110 111## EnterpriseAdminExtensionAbility.onAppStart<sup>10+</sup> 112 113onAppStart(bundleName: string): void 114 115应用启动事件回调。 116 117**系统能力**：SystemCapability.Customization.EnterpriseDeviceManager 118 119 120 121**参数：** 122 123| 参数名 | 类型 | 必填 | 说明 | 124| ----- | ----------------------------------- | ---- | ------- | 125| bundleName | string | 是 | 启动应用Bundle名称。 | 126 127**示例：** 128 129```ts 130export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbility { 131 onAppStart(bundleName: string) { 132 console.info(`Succeeded in calling onAppStart callback, started bundle name : ${bundleName}`); 133 } 134}; 135``` 136 137## EnterpriseAdminExtensionAbility.onAppStop<sup>10+</sup> 138 139onAppStop(bundleName: string): void 140 141应用停止事件回调。 142 143**系统能力**：SystemCapability.Customization.EnterpriseDeviceManager 144 145 146 147**参数：** 148 149| 参数名 | 类型 | 必填 | 说明 | 150| ----- | ----------------------------------- | ---- | ------- | 151| bundleName | string | 是 | 停止应用Bundle名称。 | 152 153**示例：** 154 155```ts 156export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbility { 157 onAppStop(bundleName: string) { 158 console.info(`Succeeded in calling onAppStop callback, stopped bundle name : ${bundleName}`); 159 } 160}; 161``` 162## EnterpriseAdminExtensionAbility.onSystemUpdate<sup>11+</sup> 163 164onSystemUpdate(systemUpdateInfo: systemManager.SystemUpdateInfo): void 165 166系统更新事件回调。 167 168**系统能力**：SystemCapability.Customization.EnterpriseDeviceManager 169 170 171 172**参数：** 173 174| 参数名 | 类型 | 必填 | 说明 | 175| ---------------- | ------------------------------------------------------- | --- | ---------- | 176| systemUpdateInfo | [systemManager.SystemUpdateInfo](js-apis-enterprise-systemManager-sys.md#systemupdateinfo11) | 是 | 系统更新的版本信息。 | 177 178**示例：** 179 180```ts 181import systemManager from '@ohos.enterprise.systemManager'; 182export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbility { 183 onSystemUpdate(systemUpdateInfo: systemManager.SystemUpdateInfo) { 184 console.info(`Succeeded in calling onSystemUpdate callback, version name : ${systemUpdateInfo.versionName}`); 185 } 186}; 187``` 188 189## EnterpriseAdminExtensionAbility.onStart<sup>11+</sup> 190 191onStart(): void 192 193EnterpriseAdminExtensionAbility启动事件回调。 194 195**系统能力**：SystemCapability.Customization.EnterpriseDeviceManager 196 197 198 199**示例：** 200 201```ts 202export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbility { 203 onStart() { 204 console.info(`Succeeded in calling onStart callback.`); 205 } 206}; 207``` 208