!15802 补充应用开发导读内容、EnterpriseAdminExtensionAbility内容合入分支

Merge pull request !15802 from ningning/OpenHarmony-3.2-Beta5

zh-cn/application-dev/application-dev-guide-for-gitee.md

@@ -40,6 +40,8 @@
 - [应用测试](application-test/Readme-CN.md)
 - [IDL工具规格及使用说明书](IDL/idl-guidelines.md)
 - [Native API的相关指导](napi/Readme-CN.md)
+- [文件管理](file-management/medialibrary-overview.md)
+- [一次开发，多端部署](key-features/multi-device-app-dev/foreword.md)
 
 ### 工具
 

zh-cn/application-dev/application-dev-guide.md

@@ -40,6 +40,8 @@
 - [应用测试](application-test/arkxtest-guidelines.md)
 - [IDL工具规格及使用说明书](IDL/idl-guidelines.md)
 - [Native API的相关指导](napi/napi-guidelines.md)
+- [文件管理](file-management/medialibrary-overview.md)
+- [一次开发，多端部署](key-features/multi-device-app-dev/foreword.md)
 
 
 ### 工具

zh-cn/application-dev/application-models/Readme-CN.md

@@ -19,6 +19,7 @@
       - [ServiceExtensionAbility](serviceextensionability.md)
       - [DataShareExtensionAbility（仅对系统应用开放）](datashareextensionability.md)
       - [FormExtensionAbility（服务卡片）](widget-development-stage.md)
+      - [EnterpriseAdminExtensionAbility](enterprise-extensionAbility.md)
     - [AbilityStage组件容器](abilitystage.md)
     - [应用上下文Context](application-context-stage.md)
     - 信息传递载体Want

zh-cn/application-dev/application-models/enterprise-extensionAbility.md

+# EnterpriseAdminExtensionAbility开发指南
+
+## EnterpriseAdminExtensionAbility简介
+
+企业设备管理扩展能力，是MDM应用必备组件。当开发者为企业开发MDM（Mobile Device Management）应用时，需继承EnterpriseAdminExtensionAbility，在EnterpriseAdminExtensionAbility实例中实现MDM业务逻辑，EnterpriseAdminExtensionAbility实现了系统管理状态变化通知功能，并定义了管理应用激活、去激活、应用安装、卸载事件等回调接口。
+
+## 约束与限制
+
+- **_功能限制_**
+
+  仅支持设备管理员应用使用。
+  
+
+## 场景:监听设备管理器激活、去激活、应用安装、卸载事件
+
+### 概述
+
+onAdminEnabled：由企业管理员或者员工部署MDM应用，激活设备管理器，系统通知MDM应用已激活DeviceAdmin权限。MDM应用可在onAdminEnabled回调函数中进行初始化策略设置。
+
+onAdminDisabled：由系统或者员工去激活设备管理器，通知去激活DeviceAdmin权限，应用可以通知企业管理员设备已脱管。
+
+onBundleAdded:  企业应用管理场景下，企业管理员订阅应用安装卸载事件，端侧应用安装和卸载事件通知MDM应用，MDM应用可以在回调函数中进行事件上报，通知企业管理员。
+
+onBundleRemoved: 企业应用管理场景下，企业管理员取消订阅应用安装卸载事件。
+
+### 接口说明
+
+| 类名                            | 接口名称                                  | 描述                         |
+| :------------------------------ | ----------------------------------------- | ---------------------------- |
+| EnterpriseAdminExtensionAbility | onAdminDisabled(): void                   | 设备管理器应用去激活回调方法 |
+| EnterpriseAdminExtensionAbility | onBundleAdded(bundleName: string): void   | 应用安装回调方法             |
+| EnterpriseAdminExtensionAbility | onAdminEnabled(): void                    | 设备管理器应用激活回调方法   |
+| EnterpriseAdminExtensionAbility | onBundleRemoved(bundleName: string): void | 应用卸载回调方法             |
+
+### 开发步骤
+
+开发者在实现EnterpriseAdminExtensionAbility的时候，需先激活设备管理员应用，并在设备管理员应用的代码目录下新建ExtensionAbility，具体步骤如下。
+
+1. 在工程Module对应的ets目录下，右键选择“New > Directory”，新建一个目录并命名为EnterpriseExtAbility。
+2. 在EnterpriseExtAbility目录，右键选择“New > TypeScript File”，新建一个TypeScript文件并命名为EnterpriseExtAbility.ts。
+3. 打开EnterpriseExtAbility.ts文件，导入EnterpriseAdminExtensionAbility模块，自定义类继承EnterpriseAdminExtensionAbility并加上需要的应用通知回调方法，如onAdminEnabled()、onAdminDisabled()等回调方法。当设备管理员应用被激活或者去激活时，则可以在对应回调方法中接受系统发送通知。
+
+```ts
+import EnterpriseAdminExtensionAbility from '@ohos.enterprise.EnterpriseAdminExtensionAbility';
+
+export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbility {
+
+    onAdminEnabled() {
+        console.info("onAdminEnabled");
+    }
+
+    onAdminDisabled() {
+        console.info("onAdminDisabled");
+    }
+    
+    onBundleAdded(bundleName: string) {
+        console.info("EnterpriseAdminAbility onBundleAdded bundleName:" + bundleName)
+    }
+
+    onBundleRemoved(bundleName: string) {
+        console.info("EnterpriseAdminAbility onBundleRemoved bundleName" + bundleName)
+    }
+};
+```
+
+​	4.在工程Module对应的[module.json5](../quick-start/module-configuration-file.md)配置文件中注册ServiceExtensionAbility，type标签需要设置为“enterpriseAdmin”，srcEntrance标签表示当前ExtensionAbility组件所对应的代码路径。
+
+```ts
+"extensionAbilities": [
+      {
+        "name": "ohos.samples.enterprise_admin_ext_ability",
+        "type": "enterpriseAdmin",
+        "visible": true,
+        "srcEntrance": "./ets/enterpriseextability/EnterpriseAdminAbility.ts"
+      }
+    ]
+```
+
+## 使用示例
+
+通过@ohos.enterprise.adminManager模块中的subscribeManagedEvent接口和unsubscribeManagedEvent接口进行企业设备管理事件的订阅，订阅应用安装、卸载事件。当订阅成功后，端侧应用安装和卸载事件通知MDM应用，MDM应用可以在回调函数中进行事件上报，通知企业管理员。
+
+```ts
+  @State managedEvents: Array<adminManager.ManagedEvent> = [0,1]
+  @State subscribeManagedEventMsg: string = ""
+  @State unsubscribeManagedEventMsg: string = ""
+
+  async subscribeManagedEventCallback() {
+    await adminManager.subscribeManagedEvent(this.admin,
+      [adminManager.ManagedEvent.MANAGED_EVENT_BUNDLE_ADDED,
+      adminManager.ManagedEvent.MANAGED_EVENT_BUNDLE_REMOVED], (error) => {
+        if (error) {
+          this.subscribeManagedEventMsg = 'subscribeManagedEvent Callback::errorCode: ' + error.code + ' errorMessage: ' + error.message
+        } else {
+          this.subscribeManagedEventMsg = 'subscribeManagedEvent Callback::success'
+        }
+      })
+  }
+
+  async unsubscribeManagedEventPromise() {
+    await adminManager.unsubscribeManagedEvent(this.admin,
+      [adminManager.ManagedEvent.MANAGED_EVENT_BUNDLE_ADDED,
+      adminManager.ManagedEvent.MANAGED_EVENT_BUNDLE_REMOVED]).then(() => {
+      this.unsubscribeManagedEventMsg = 'unsubscribeManagedEvent Promise::success'
+    }).catch((error) => {
+      this.unsubscribeManagedEventMsg = 'unsubscribeManagedEvent Promise::errorCode: ' + error.code + ' errorMessage: ' + error.message
+    })
+  }
+```
+
+
+
+## 相关实例
+
+针对EnterpriseAdminExtensionAbility开发，有以下相关示例可供参考：
+
+[EnterpriseAdminExtensionAbility：EnterpriseAdminExtensionAbility的创建与使用(ArkTS) (API9)](https://gitee.com/openharmony/applications_app_samples/tree/master/customization/EnterpriseAdminExtensionAbility)
+