## 功能介绍

MDM Kit为企业MDM应用提供设备管理能力，包括企业设备管理与事件监听、应用管理、禁用管理、安全管理、设备设置、设备控制、设备信息获取、硬件外设管理、系统管理、网络通信管理等，具体API接口说明详见[API参考](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/mdm-arkts)。

设备管理应用：具备[企业设备管理扩展能力](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/mdm-kit-admin)的应用。

## 开发步骤

要完成一个设备管理应用开发，需要完成以下步骤：

1. 申请资质。
2. 创建EnterpriseAdminExtensionAbility。
3. 声明接口所需权限。
4. MDM功能开发与调试。
5. 分发部署。

### 申请资质

在开发应用前，需要在AppGallery Connect中配置项目和应用信息。包括：

* [注册成为企业开发者](https://developer.huawei.com/consumer/cn/doc/start/registration-and-verification-0000001053628148)。
* [创建项目](https://developer.huawei.com/consumer/cn/doc/app/agc-help-createproject-0000001100334664)和[创建应用](https://developer.huawei.com/consumer/cn/doc/app/agc-help-createapp-0000001146718717)。
* [申请MDM应用的证书](https://developer.huawei.com/consumer/cn/doc/app/agc-help-enterprise-mdm-cert-0000002283256801)和[Profile](https://developer.huawei.com/consumer/cn/doc/app/agc-help-enterprise-mdm-profile-0000002248341094)。

### 创建EnterpriseAdminExtensionAbility

请参阅[EnterpriseAdminExtensionAbility开发指南](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/mdm-kit-admin)完成EnterpriseAdminExtensionAbility的创建。

### 声明接口所需权限

在申请权限前，请保证符合[权限使用的基本原则](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-permission-mgmt-overview#权限使用的基本原则)。然后在工程Module对应的[module.json5](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)配置文件中"requestPermissions"标签下声明要使用的接口所需的权限。例如：

收起

自动换行

深色代码主题

复制

```
1. "requestPermissions": [
2. // ···
3. {
4. "name": "ohos.permission.ENTERPRISE_MANAGE_RESTRICTIONS"
5. },
6. // ···
7. ],
```

[module.json5](https://gitcode.com/HarmonyOS_Samples/guide-snippets/blob/HarmonyOS-feature-20251117/EnterpriseAdminExtensionAbility/EnterpriseAdminExtensionAbility/entry/src/main/module.json5#L61-L77)

说明

所需要申请的权限请参考具体接口，这里提供了[企业设备管理](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-enterprise-adminmanager)的链接，可基于该文档查看MDM Kit内其他API文档。

声明的MDM权限必须在申请MDM应用的证书和Profile时完成申请，否则后面应用还是无法获取到该权限。

### MDM功能开发

1. 导包。MDM Kit目前包含应用管理、通信管理、安全管理、限制策略、系统管理、设备设置和查询、设备控制等多种类型的API，请根据业务需求导入使用。以下为导入adminManager和restrictions的示例。

   收起

   自动换行

   深色代码主题

   复制

   ```
   1. import { adminManager, restrictions } from '@kit.MDMKit';
   ```

   [EnterpriseAdminAbility.ets](https://gitcode.com/HarmonyOS_Samples/guide-snippets/blob/HarmonyOS-feature-20251117/EnterpriseAdminExtensionAbility/EnterpriseAdminExtensionAbility/entry/src/main/ets/enterpriseadminability/EnterpriseAdminAbility.ets#L17-L19)
2. 调用接口，实现相应的功能。以下为禁用设备Wi-Fi的示例。

   收起

   自动换行

   深色代码主题

   复制

   ```
   1. import { adminManager, restrictions } from '@kit.MDMKit';
   2. // ...
   3. import { Want } from '@kit.AbilityKit';
   4. // ...
   5. private wantTemp: Want = {
   6. bundleName: 'com.example.mdmsample',
   7. abilityName: 'EnterpriseAdminAbility',
   8. };
   9. // ...
   10. try {
   11. restrictions.setDisallowedPolicy(this.wantTemp, 'wifi', isDisallow);
   12. console.info(isDisallow ? 'disable wifi success.' : 'enable wifi success.');
   13. // ...
   14. } catch (err) {
   15. console.error('setDisallowedPolicy fail.');
   16. // ...
   17. }
   ```

   [EnterpriseAdminAbility.ets](https://gitcode.com/HarmonyOS_Samples/guide-snippets/blob/HarmonyOS-feature-20251117/EnterpriseAdminExtensionAbility/EnterpriseAdminExtensionAbility/entry/src/main/ets/enterpriseadminability/EnterpriseAdminAbility.ets#L16-L113)

### 调试说明

由于MDM接口需要在激活企业设备管理扩展能力后使用，调试时需通过hdc命令来激活/解除激活扩展能力，命令如下：

收起

自动换行

深色代码主题

复制

```
1. # 激活为超级设备管理应用
2. hdc shell edm enable-admin -n 包名 -a 企业设备管理扩展能力类名
3. # 激活为BYOD设备管理应用
4. hdc shell edm enable-admin -n 包名 -a 企业设备管理扩展能力类名 -t byod
5. # 解除激活
6. hdc shell edm disable-admin -n 包名
```

说明

正式使用时，在同一设备上只能激活一个超级设备管理应用。

BYOD（bring your own device），自带设备办公。指一些企业允许员工携带自己的笔记本电脑、平板电脑、智能手机等移动终端设备到办公场所，并可以用这些设备获取公司内部信息、使用企业特许应用的一种政策。

调试之前，需要完成资质申请。

### 分发部署

将开发、调试完成的MDM应用申请商用：参见[企业MDM应用商用申请](https://developer.huawei.com/business/cn/doc/HEM/developer-commercial-license-0000002469392504)。

将已商用发布的MDM应用部署到设备上：参见[如何管理部署策略](https://developer.huawei.com/business/cn/doc/HEM/hem_user-guide_add-reseller_management-devices-ot-0000002307766441)，将部署配置的部署类型一栏勾选上MDM应用部署。