!7891 新增输入法框架extension相关文档

Merge pull request !7891 from 赵凌岚/master

zh-cn/application-dev/reference/apis/Readme-CN.md

@@ -28,6 +28,8 @@
     - application/[FormExtensionContext (FormExtensionContext)](js-apis-formextensioncontext.md)
     - application/[PermissionRequestResult (PermissionRequestResult)](js-apis-permissionrequestresult.md)
     - application/[ServiceExtensionContext (ServiceExtensionContext)](js-apis-service-extension-context.md)
+    - [InputMethodExtensionAbility (InputMethodExtensionAbility)](js-apis-inputmethod-extension-ability.md)
+    - [InputMethodExtensionContext (InputMethodExtensionContext)](js-apis-inputmethod-extension-context.md)
   - 通用
     - [@ohos.ability.dataUriUtils (DataUriUtils模块)](js-apis-DataUriUtils.md)
     - [@ohos.ability.errorCode (ErrorCode)](js-apis-ability-errorCode.md)

zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md

+# InputMethodExtensionAbility
+
+InputMethodExtensionAbility模块，提供生态输入法应用开发者通过InputMethodExtensionAbility、InputMethodExtensionContext接口创作输入法应用，并管理输入法应用生命周期。
+
+> **说明：**
+> 
+> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块接口仅可在Stage模型下使用。
+
+## 导入模块
+
+```
+import InputMethodExtension from '@ohos.inputmethodextensionability';
+```
+
+## 属性
+
+**系统能力**：SystemCapability.MiscServices.InputMethodFramework
+
+| 名称 | 参数类型 | 可读 | 可写 | 说明 |
+| -------- | -------- | -------- | -------- | -------- |
+| context | [InputMethodExtensionContext](js-apis-inputmethod-extension-context.md) | 是 | 否 | InputMethodExtension的上下文环境，继承自ExtensionContext。 |
+
+
+## InputMethodExtensionAbility.onCreate()
+
+onCreate(want: Want): void;
+
+Extension生命周期回调，在拉起Extension输入法应用时调用，执行初始化输入法应用操作。
+
+**系统能力**：SystemCapability.MiscServices.InputMethodFramework
+
+**参数：**
+
+  | 参数名 | 类型 | 必填 | 说明 | 
+  | -------- | -------- | -------- | -------- |
+  | want |  [Want](js-apis-application-Want.md) | 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 | 
+
+**示例：**
+
+  ```js
+  class InputMethodExt extends InputMethodExtensionAbility {
+    onCreate(want) {
+      console.log('onCreate, want:' + want.abilityName);
+    }
+  }
+  ```
+
+
+## InputMethodExtensionAbility.onDestroy()
+
+onDestroy(): void;
+
+Extension生命周期回调，在销毁输入法应用时回调，执行资源清理等操作。
+
+**系统能力**：SystemCapability.MiscServices.InputMethodFramework
+
+**示例：**
+
+  ```js
+  class InputMethodExt extends InputMethodExtensionAbility {
+    onDestroy() {
+      console.log('onDestroy');
+    }
+  }
+  ```

zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md

+# InputMethodExtensionContext
+
+InputMethodExtensionContext模块是InputMethodExtensionAbility的上下文环境，继承自ExtensionContext。
+
+InputMethodExtensionContext模块提供InputMethodExtensionAbility具有的能力和接口，包括启动、停止、绑定、解绑Ability。
+
+> **说明：**
+> 
+> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。  
+> 本模块接口仅可在Stage模型下使用。
+
+## 使用说明
+
+在使用InputMethodExtensionContext的功能前，需要通过InputMethodExtensionAbility子类实例获取。
+
+```js
+  import InputMethodExtensionAbility from '@ohos.inputmethodextensionability';
+  class MainAbility extends InputMethodExtensionAbility {
+      onCreate() {
+          let context = this.context;
+      }
+  }
+```
+
+## InputMethodExtensionContext.startAbility
+
+startAbility(want: Want, callback: AsyncCallback<void>): void;
+
+启动Ability，包含一个Want类型参数。callback形式返回启动结果。
+
+**系统能力**：SystemCapability.MiscServices.InputMethodFramework
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| want | [Want](js-apis-application-Want.md)  | 是 | Want类型参数，传入需要启动的ability的信息，如ability名称，包名等。 |
+| callback | AsyncCallback<void> | 是 | 回调函数，返回接口调用是否成功的结果。 |
+
+**示例：**
+
+  ```js
+    let want = {
+      "bundleName": "com.example.myapp",
+      "abilityName": "MyAbility"};
+      this.context.startAbility(want, (err) => {
+      console.log('startAbility result:' + JSON.stringify(err));
+    });
+  ```
+
+## InputMethodExtensionContext.startAbility
+
+startAbility(want: Want, options?: StartOptions): Promise\<void>;
+
+启动Ability，包含Want类型参数，以及可选填的StartOption类型参数。通过Promise方法返回结果。
+
+**系统能力**：SystemCapability.MiscServices.InputMethodFramework
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| want | [Want](js-apis-application-Want.md)  | 是 | Want类型参数，传入需要启动的ability的信息，如ability名称，包名等。 |
+| options | [StartOptions](js-apis-application-StartOptions.md) | 否 | 启动Ability所携带的参数。 |
+
+**返回值：**
+
+  | 类型 | 说明 | 
+  | -------- | -------- |
+  | Promise&lt;void&gt; | 返回一个Promise，包含接口的结果。 | 
+
+**示例：**
+
+  ```js
+    let want = {
+        "bundleName": "com.example.myapp",
+        "abilityName": "MyAbility"
+    };
+    this.context.startAbility(want).then((data) => {
+        console.log('success:' + JSON.stringify(data));
+    }).catch((error) => {
+        console.log('failed:' + JSON.stringify(error));
+    });
+
+  ```
+
+## InputMethodExtensionContext.startAbility
+
+startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&gt;): void
+
+启动Ability，包含有两个参数，Want类型和StartOption类型参数。callback形式返回启动结果。
+
+**系统能力**：SystemCapability.MiscServices.InputMethodFramework
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| want | [Want](js-apis-application-Want.md)  | 是 | 启动Ability的want信息。 |
+| options | [StartOptions](js-apis-application-StartOptions.md) | 是 | 启动Ability所携带的参数。 |
+| callback | AsyncCallback&lt;void&gt; | 是 | callback形式返回启动结果。 |
+
+**示例：**
+
+  ```js
+  var want = {
+  	"deviceId": "",
+  	"bundleName": "com.extreme.test",
+  	"abilityName": "MainAbility"
+  };
+  var options = {
+  	windowMode: 0,
+  };
+  this.context.startAbility(want, options, (error) => {
+    console.log("error.code = " + error.code)
+  })
+  ```
+
+## InputMethodExtensionContext.terminateSelf
+
+terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
+
+停止输入法应用自身，通过Callback方法返回接口调用是否成功。
+
+**系统能力**：SystemCapability.MiscServices.InputMethodFramework
+
+**参数：**
+
+| 参数名   | 类型                      | 必填 | 说明                                   |
+| -------- | ------------------------- | ---- | -------------------------------------- |
+| callback | AsyncCallback&lt;void&gt; | 是   | 回调函数，返回接口调用是否成功的结果。 |
+
+**示例：**
+
+  ```js
+this.context.terminateSelf((err) => {
+  console.log('terminateSelf result:' + JSON.stringify(err));
+});
+  ```
+
+## InputMethodExtensionContext.terminateSelf
+
+terminateSelf(): Promise&lt;void&gt;;
+
+停止输入法应用自身。通过Promise返回结果。
+
+**系统能力**：SystemCapability.MiscServices.InputMethodFramework
+
+**返回值：**
+
+  | 类型 | 说明 | 
+  | -------- | -------- |
+  | Promise&lt;void&gt; | 返回一个Promise，包含接口的结果。 | 
+
+**示例：**
+
+  ```js
+  this.context.terminateSelf().then((data) => {
+      console.log('success:' + JSON.stringify(data));
+  }).catch((error) => {
+      console.log('failed:' + JSON.stringify(error));
+  });
+  ```