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