1# MDM Kit开发指南 2<!--Kit: MDM Kit--> 3<!--Subsystem: Customization--> 4<!--Owner: @huanleima--> 5<!--Designer: @liuzuming--> 6<!--Tester: @lpw_work--> 7<!--Adviser: @Brilliantry_Rui--> 8 9## 功能介绍 10 11MDM Kit为企业MDM应用提供设备管理能力，包括企业设备管理与事件监听、应用管理、禁用管理、安全管理、设备设置、设备控制、设备信息获取、硬件外设管理、系统管理、网络通信管理等，具体API接口说明详见<!--RP7-->[API参考](../reference/apis-mdm-kit/Readme-CN.md)<!--RP7End-->。 12 13设备管理应用：具备[企业设备管理扩展能力](./mdm-kit-admin.md)的应用。 14 15## 开发步骤 16 17要完成一个设备管理应用开发，需要完成以下步骤： 18 19<!--RP1--> 20 211. 创建EnterpriseAdminExtensionAbility。 22 232. 声明接口所需权限。 24 253. MDM功能开发与调试。 26 27<!--RP1End--> 28 29 30<!--RP2--><!--RP2End--> 31 32### 创建EnterpriseAdminExtensionAbility 33 34请参阅[EnterpriseAdminExtensionAbility开发指南](./mdm-kit-admin.md)完成EnterpriseAdminExtensionAbility的创建。 35 36### 声明接口所需权限 37 38在申请权限前，请保证符合[权限使用的基本原则](../security/AccessToken/app-permission-mgmt-overview.md#权限使用的基本原则)。然后在工程Module对应的[module.json5](../quick-start/module-configuration-file.md)配置文件中"requestPermissions"标签下声明要使用的接口所需的权限。例如： 39 40```ts 41"requestPermissions": [ 42 { 43 "name": "ohos.permission.ENTERPRISE_MANAGE_RESTRICTIONS" 44 }, 45] 46``` 47 48> **说明** 49> 50> 所需要申请的权限请参考具体接口，这里提供了[企业设备管理](../reference/apis-mdm-kit/js-apis-enterprise-adminManager.md)的链接，可基于该文档查看MDM Kit内其他API文档。 51> 52> <!--RP4--><!--RP4End--> 53 54### MDM功能开发 55 561. 导包。MDM Kit目前包含应用管理、通信管理、安全管理、限制策略、系统内管理、设备设置和查询、设备控制等多种类型的API，请根据业务需求导入使用。以下为导入adminManager和restrictions的示例。 57 58 ```ts 59 import { adminManager, restrictions } from '@kit.MDMKit'; 60 ``` 61 622. 调用接口，实现相应的功能。以下为禁用设备Wi-Fi的示例。 63 64 ```ts 65 import { Want } from '@kit.AbilityKit'; 66 import { restrictions } from '@kit.MDMKit'; 67 68 let wantTemp: Want = { 69 bundleName: 'com.example.xxx', 70 abilityName: 'EnterpriseAdminAbility', 71 }; 72 try { 73 restrictions.setDisallowedPolicy(wantTemp, "wifi", true); 74 console.info("disable wifi success."); 75 } catch (error) { 76 console.error("disable wifi fail."); 77 } 78 ``` 79 80### 调试说明 81 82由于MDM接口需要在激活企业设备管理扩展能力后使用，调试时需通过hdc命令来激活/解除激活扩展能力，命令如下： 83 84```bash 85# 激活为超级设备管理应用 86hdc shell edm enable-admin -n 包名 -a 企业设备管理扩展能力类名 87# 激活为BYOD设备管理应用 88hdc shell edm enable-admin -n 包名 -a 企业设备管理扩展能力类名 -t byod 89# 解除激活 90hdc shell edm disable-admin -n 包名 91``` 92 93> **说明** 94> 95> 正式使用时，在同一设备上只能激活一个超级设备管理应用。 96> 97> BYOD（bring your own device），自带设备办公。指一些企业允许员工携带自己的笔记本电脑、平板电脑、智能手机等移动终端设备到办公场所，并可以用这些设备获取公司内部信息、使用企业特许应用的一种政策。 98> 99> <!--RP5--><!--RP5End--> 100 101<!--RP6--><!--RP6End-->