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