diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-Want.md b/zh-cn/application-dev/reference/apis/js-apis-ability-Want.md
deleted file mode 100644
index 81fe4d7c103b60d3627a6ee03aaef1ab4411b9f6..0000000000000000000000000000000000000000
--- a/zh-cn/application-dev/reference/apis/js-apis-ability-Want.md
+++ /dev/null
@@ -1,67 +0,0 @@
-# Want
-
-Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为startAbility的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据, 如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当Ability A需要启动Ability B并传入一些数据时, 可使用Want作为载体将这些数据传递给Ability B。
-
-> **说明：**
->
-> 本模块首批接口从API version 6开始支持，从API version 9废弃，替换模块为[Want (Want)](js-apis-app-ability-Want.md)。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
-
-| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 |
-| ----------- | -------- |-------- | -------------------- | ---- | ------------------------------------------------------------ |
-| deviceId | 是 | 否 | string | 否 | 表示运行指定Ability的设备ID。 |
-| bundleName | 是 | 否 | string | 否 | 表示包名。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 |
-| abilityName | 是 | 否 | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 |
-| uri | 是 | 否 | string | 否 | 表示Uri。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme, schemeSpecificPart, authority和path信息。 |
-| type | 是 | 否 | string | 否 | 表示MIME type类型，打开文件的类型，主要用于文管打开文件。比如："text/xml" 、 "image/*"等，MIME定义参考：https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。 |
-| flags | 是 | 否 | number | 否 | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-featureAbility.md#flags说明)。 |
-| action | 是 | 否 | string | 否 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。 |
-| parameters | 是 | 否 | {[key: string]: any} | 否 | 表示WantParams，由开发者自行决定传入的键值对。默认会携带以下key值：
ohos.aafwk.callerPid 表示拉起方的pid。
ohos.aafwk.param.callerToken 表示拉起方的token。
ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。 |
-| entities | 是 | 否 | Array\ | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 |
-| moduleName9+ | 是 | 否 | string | 否 | 表示待启动的Ability所属的模块（module）。 |
-
-具体字段描述参考ability/want.d.ts文件
-
-**示例：**
-
-- 基础用法
-
- ``` ts
- var want = {
- "deviceId": "", // deviceId为空表示本设备
- "bundleName": "com.extreme.test",
- "abilityName": "MainAbility",
- "moduleName": "entry" // moduleName非必选
- };
- this.context.startAbility(want, (error) => {
- // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
- console.log("error.code = " + error.code)
- })
- ```
-
-- 传递FD数据，FD表示文件描述符(FileDescriptor)
-
- ``` ts
- import fileio from '@ohos.fileio';
- var fd;
- try {
- fd = fileio.openSync("/data/storage/el2/base/haps/pic.png");
- } catch(e) {
- console.log("openSync fail:" + JSON.stringify(e));
- }
- var want = {
- "deviceId": "", // deviceId为空表示本设备
- "bundleName": "com.extreme.test",
- "abilityName": "MainAbility",
- "moduleName": "entry", // moduleName非必选
- "parameters": {
- "keyFd":{"type":"FD", "value":fd}
- }
- };
- this.context.startAbility(want, (error) => {
- // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
- console.log("error.code = " + error.code)
- })
- ```
-
diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-ability.md b/zh-cn/application-dev/reference/apis/js-apis-ability-ability.md
index 473f7205a65f12057ca108f9e0903e71f975ad03..91b1a00d9d222ff4760d91b3030c21c29502efd3 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-ability-ability.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-ability-ability.md
@@ -15,24 +15,25 @@ import ability from '@ohos.ability.ability'
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
-| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 |
-| ----------- | -------- |-------- | -------------------- | ---- | ------------------------------------------------------------ |
-| DataAbilityHelper | 是 | 否 | number | 否 | DataAbilityHelper二级模块。 |
-| PacMap | 是 | 否 | Want | 否 | PacMap二级模块。 |
-| DataAbilityOperation | 是 | 否 | Want | 否 | DataAbilityOperation二级模块。 |
-| DataAbilityResult | 是 | 否 | Want | 否 | DataAbilityResult二级模块。 |
-| AbilityResult | 是 | 否 | Want | 否 | AbilityResult二级模块。 |
-| ConnectOptions | 是 | 否 | Want | 否 | ConnectOptions二级模块。 |
-| StartAbilityParameter | 是 | 否 | Want | 否 | StartAbilityParameter二级模块。 |
+| 名称 | 读写属性 | 类型 | 必填 | 描述 |
+| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
+| DataAbilityHelper | 只读 | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 否 | DataAbilityHelper二级模块。 |
+| PacMap | 只读 | [PacMap](js-apis-inner-ability-dataAbilityHelper.md#PacMap) | 否 | PacMap二级模块。 |
+| DataAbilityOperation | 只读 | [DataAbilityOperation](js-apis-inner-ability-dataAbilityOperation.md) | 否 | DataAbilityOperation二级模块。 |
+| DataAbilityResult | 只读 | [DataAbilityResult](js-apis-inner-ability-dataAbilityResult.md) | 否 | DataAbilityResult二级模块。 |
+| AbilityResult | 只读 | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 否 | AbilityResult二级模块。 |
+| ConnectOptions | 只读 | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 否 | ConnectOptions二级模块。 |
+| StartAbilityParameter | 只读 | [StartAbilityParameter](js-apis-inner-ability-startAbilityParameter.md) | 否 | StartAbilityParameter二级模块。 |
**示例：**
-
- ```ts
- let dataAbilityHelper: ability.DataAbilityHelper;
- let pacMap: ability.PacMap;
- let dataAbilityOperation: ability.DataAbilityOperation;
- let dataAbilityResult: ability.DataAbilityResult;
- let abilityResult: ability.AbilityResult;
- let connectOptions: ability.ConnectOptions;
- let startAbilityParameter: ability.StartAbilityParameter;
- ```
\ No newline at end of file
+```ts
+import ability from '@ohos.ability.ability';
+
+let dataAbilityHelper: ability.DataAbilityHelper;
+let pacMap: ability.PacMap;
+let dataAbilityOperation: ability.DataAbilityOperation;
+let dataAbilityResult: ability.DataAbilityResult;
+let abilityResult: ability.AbilityResult;
+let connectOptions: ability.ConnectOptions;
+let startAbilityParameter: ability.StartAbilityParameter;
+```
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-abilityResult.md b/zh-cn/application-dev/reference/apis/js-apis-ability-abilityResult.md
deleted file mode 100644
index ccd5569638750040a8df200103c1b31b07895948..0000000000000000000000000000000000000000
--- a/zh-cn/application-dev/reference/apis/js-apis-ability-abilityResult.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# AbilityResult7+
-
-定义ability拉起、销毁之后返回的结果码和数据。
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
-
-| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 |
-| ----------- | -------- |-------- | -------------------- | ---- | ------------------------------------------------------------ |
-| resultCode | 是 | 否 | number | 否 | 表示ability拉起、销毁之后返回的结果码。 |
-| want | 是 | 否 | [Want](js-apis-ability-Want.md) | 否 | 表示ability销毁之后返回的数据。 |
-
-**示例：**
- ```ts
- let want = {
- bundleName: 'com.example.mydocapplication',
- abilityName: 'MainAbility',
- };
- this.context.startAbilityForResult(want, (error, data) => {
- let resultCode = data.resultCode;
- let want = data.want;
- });
- ```
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-context.md b/zh-cn/application-dev/reference/apis/js-apis-ability-context.md
index 46993cecb7612502669e7972a14fa79e541d7f2f..1b798c86f44a7dd6e01abff75c6272649f2c4411 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-ability-context.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-ability-context.md
@@ -32,7 +32,7 @@ class MainAbility extends Ability {
| -------- | -------- | -------- | -------- | -------- |
| abilityInfo | AbilityInfo | 是 | 否 | Abilityinfo相关信息 |
| currentHapModuleInfo | HapModuleInfo | 是 | 否 | 当前hap包的信息 |
-| config | [Configuration](js-apis-configuration.md) | 是 | 否 | 表示配置信息。 |
+| config | [Configuration](js-apis-application-configuration.md) | 是 | 否 | 表示配置信息。 |
## AbilityContext.startAbility
@@ -46,7 +46,7 @@ startAbility(want: Want, callback: AsyncCallback<void>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| callback | AsyncCallback<void> | 是 | callback形式返回启动结果 |
**错误码：**
@@ -95,8 +95,8 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void&
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
-| options | [StartOptions](js-apis-application-StartOptions.md) | 是 | 启动Ability所携带的参数。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
+| options | [StartOptions](js-apis-application-startOptions.md) | 是 | 启动Ability所携带的参数。 |
| callback | AsyncCallback<void> | 是 | callback形式返回启动结果。 |
**错误码：**
@@ -148,8 +148,8 @@ startAbility(want: Want, options?: StartOptions): Promise<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
-| options | [StartOptions](js-apis-application-StartOptions.md) | 否 | 启动Ability所携带的参数。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
+| options | [StartOptions](js-apis-application-startOptions.md) | 否 | 启动Ability所携带的参数。 |
**返回值：**
@@ -206,8 +206,8 @@ startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>):
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want |[Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
-| callback | AsyncCallback<[AbilityResult](js-apis-featureAbility.md#abilityresult)> | 是 | 执行结果回调函数。 |
+| want |[Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
+| callback | AsyncCallback<[AbilityResult](js-apis-inner-ability-abilityResult.md)> | 是 | 执行结果回调函数。 |
**错误码：**
@@ -256,9 +256,9 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want |[Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
-| options | [StartOptions](js-apis-application-StartOptions.md) | 是 | 启动Ability所携带的参数。 |
-| callback | AsyncCallback<[AbilityResult](js-apis-featureAbility.md#abilityresult)> | 是 | 执行结果回调函数。 |
+| want |[Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
+| options | [StartOptions](js-apis-application-startOptions.md) | 是 | 启动Ability所携带的参数。 |
+| callback | AsyncCallback<[AbilityResult](js-apis-inner-ability-abilityResult.md)> | 是 | 执行结果回调函数。 |
**错误码：**
@@ -311,15 +311,15 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityRes
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
-| options | [StartOptions](js-apis-application-StartOptions.md) | 否 | 启动Ability所携带的参数。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
+| options | [StartOptions](js-apis-application-startOptions.md) | 否 | 启动Ability所携带的参数。 |
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
-| Promise<[AbilityResult](js-apis-featureAbility.md#abilityresult)> | Promise形式返回执行结果。 |
+| Promise<[AbilityResult](js-apis-inner-ability-abilityResult.md)> | Promise形式返回执行结果。 |
**错误码：**
@@ -373,7 +373,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| callback | AsyncCallback\ | 是 | 启动Ability的回调函数，返回Ability结果。 |
@@ -430,9 +430,9 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
-| options | [StartOptions](js-apis-application-StartOptions.md) | 是 | 启动Ability所携带的参数。 |
+| options | [StartOptions](js-apis-application-startOptions.md) | 是 | 启动Ability所携带的参数。 |
| callback | AsyncCallback\ | 是 | 启动Ability的回调函数。 |
**错误码：**
@@ -491,9 +491,9 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
-| options | [StartOptions](js-apis-application-StartOptions.md) | 否 | 启动Ability所携带的参数。 |
+| options | [StartOptions](js-apis-application-startOptions.md) | 否 | 启动Ability所携带的参数。 |
**返回值：**
@@ -553,7 +553,7 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| callback | AsyncCallback\ | 是 | 启动Ability的回调函数。 |
**错误码：**
@@ -604,7 +604,7 @@ startServiceExtensionAbility(want: Want): Promise\;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
**错误码：**
@@ -656,7 +656,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| callback | AsyncCallback\ | 是 | 启动Ability的回调函数。 |
@@ -711,7 +711,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
**错误码：**
@@ -762,7 +762,7 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| callback | AsyncCallback\ | 是 | 启动Ability的回调函数。 |
**错误码：**
@@ -813,7 +813,7 @@ stopServiceExtensionAbility(want: Want): Promise\;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
**错误码：**
@@ -865,7 +865,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| callback | AsyncCallback\ | 是 | 启动Ability的回调函数。 |
@@ -920,7 +920,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
**错误码：**
@@ -1042,7 +1042,7 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<voi
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| parameter | [AbilityResult](js-apis-featureAbility.md#abilityresult) | 是 | 返回给调用startAbilityForResult 接口调用方的相关信息。 |
+| parameter | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 是 | 返回给调用startAbilityForResult 接口调用方的相关信息。 |
| callback | AsyncCallback<void> | 是 | callback形式返回停止结果。 |
**错误码：**
@@ -1097,7 +1097,7 @@ terminateSelfWithResult(parameter: AbilityResult): Promise<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| parameter | [AbilityResult](js-apis-featureAbility.md#abilityresult) | 是 | 返回给startAbilityForResult 调用方的信息。 |
+| parameter | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 是 | 返回给startAbilityForResult 调用方的信息。 |
**返回值：**
@@ -1153,12 +1153,14 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
-| options | [ConnectOptions](js-apis-featureAbility.md#connectoptions) | 是 | 远端对象实例。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
+| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 否 | 远端对象实例。 |
**返回值：**
@@ -1214,9 +1216,9 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
-| options | [ConnectOptions](js-apis-featureAbility.md#connectoptions) | 是 | 远端对象实例。 |
+| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 否 | 远端对象实例。 |
**返回值：**
@@ -1264,6 +1266,8 @@ disconnectServiceExtensionAbility(connection: number): Promise\;
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -1286,7 +1290,7 @@ disconnectServiceExtensionAbility(connection: number): Promise\;
**示例：**
```ts
- // connection为connectAbility中的返回值
+ // connection为connectServiceExtensionAbility中的返回值
var connection = 1;
try {
@@ -1315,6 +1319,8 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\ | 是 | 启动Ability的回调函数。 |
@@ -1514,9 +1518,9 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。|
-| options | [StartOptions](js-apis-application-StartOptions.md) | 是 | 启动Ability所携带的参数。 |
+| options | [StartOptions](js-apis-application-startOptions.md) | 否 | 启动Ability所携带的参数。 |
| callback | AsyncCallback\ | 是 | 启动Ability的回调函数。 |
**错误码：**
@@ -1574,9 +1578,9 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 启动Ability的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
-| options | [StartOptions](js-apis-application-StartOptions.md) | 是 | 启动Ability所携带的参数。 |
+| options | [StartOptions](js-apis-application-startOptions.md) | 否 | 启动Ability所携带的参数。 |
**错误码：**
@@ -1629,7 +1633,7 @@ requestPermissionsFromUser(permissions: Array<string>, requestCallback: As
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| permissions | Array<string> | 是 | 权限列表。 |
-| callback | AsyncCallback<[PermissionRequestResult](js-apis-permissionrequestresult.md)> | 是 | 回调函数，返回接口调用是否成功的结果。 |
+| callback | AsyncCallback<[PermissionRequestResult](js-apis-inner-application-permissionRequestResult.md)> | 是 | 回调函数，返回接口调用是否成功的结果。 |
**示例：**
@@ -1660,7 +1664,7 @@ requestPermissionsFromUser(permissions: Array<string>) : Promise<Permis
| 类型 | 说明 |
| -------- | -------- |
-| Promise<[PermissionRequestResult](js-apis-permissionrequestresult.md)> | 返回一个Promise，包含接口的结果。 |
+| Promise<[PermissionRequestResult](js-apis-inner-application-permissionRequestResult.md)> | 返回一个Promise，包含接口的结果。 |
**示例：**
@@ -1831,7 +1835,7 @@ restoreWindowStage(localStorage: LocalStorage) : void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| localStorage | LocalStorage | 是 | 用于恢复window stage的存储数据。 |
+| localStorage | image.LocalStorage | 是 | 用于恢复window stage的存储数据。 |
**示例：**
diff --git a/zh-cn/application-dev/reference/apis/js-apis-DataUriUtils.md b/zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md
similarity index 86%
rename from zh-cn/application-dev/reference/apis/js-apis-DataUriUtils.md
rename to zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md
index 0332b8e41ed1e3e567e70403dad7627f9fb6ce9c..f4f85d8c761d630dc96f7b06ca49f19c850d75d3 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-DataUriUtils.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md
@@ -8,7 +8,7 @@ DataUriUtils模块提供用于处理使用DataAbilityHelper方案的对象的实
## 导入模块
-```js
+```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
```
@@ -22,7 +22,7 @@ getId(uri: string): number
**参数：**
-| 参数名 | 类型 | 必填 | 说明 |
+| 名称 | 类型 | 必填 | 描述 |
| ---- | ------ | ---- | --------------------------- |
| uri | string | 是 | 指示要从中获取ID的uri对象。 |
@@ -34,7 +34,7 @@ getId(uri: string): number
**示例：**
-```js
+```ts
dataUriUtils.getId("com.example.dataUriUtils/1221")
```
@@ -50,7 +50,7 @@ attachId(uri: string, id: number): string
**参数：**
-| 参数名 | 类型 | 必填 | 说明 |
+| 名称 | 类型 | 必填 | 描述 |
| ---- | ------ | ---- | --------------------------- |
| uri | string | 是 | 指示要从中获取ID的uri对象。 |
| id | number | 是 | 指示要附加的ID。 |
@@ -63,7 +63,7 @@ attachId(uri: string, id: number): string
**示例：**
-```js
+```ts
var idint = 1122;
dataUriUtils.attachId(
"com.example.dataUriUtils",
@@ -83,7 +83,7 @@ deleteId(uri: string): string
**参数：**
-| 参数名 | 类型 | 必填 | 说明 |
+| 名称 | 类型 | 必填 | 描述 |
| ---- | ------ | ---- | --------------------------- |
| uri | string | 是 | 指示要从中删除ID的uri对象。 |
@@ -95,7 +95,7 @@ deleteId(uri: string): string
**示例：**
-```js
+```ts
dataUriUtils.deleteId("com.example.dataUriUtils/1221")
```
@@ -111,7 +111,7 @@ updateId(uri: string, id: number): string
**参数：**
-| 参数名 | 类型 | 必填 | 说明 |
+| 名称 | 类型 | 必填 | 描述 |
| ---- | ------ | ---- | ------------------- |
| uri | string | 是 | 指示要更新的uri对象 |
| id | number | 是 | 指示新ID |
@@ -124,7 +124,7 @@ updateId(uri: string, id: number): string
**示例：**
-```js
+```ts
var idint = 1122;
dataUriUtils.updateId(
"com.example.dataUriUtils",
diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-errorCode.md b/zh-cn/application-dev/reference/apis/js-apis-ability-errorCode.md
index c07de214397189e8a7e398658bd5170b1d01d71c..f6920f90812f2216b5c0418f539f007e5b4c8fc5 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-ability-errorCode.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-ability-errorCode.md
@@ -10,7 +10,7 @@ ErrorCode是定义启动功能时使用的错误代码。
## 导入模块
-```
+```ts
import errorCode from '@ohos.ability.errorCode'
```
@@ -24,5 +24,5 @@ import errorCode from '@ohos.ability.errorCode'
| ------------------------------ | ---- | ---------------------------------------- |
| NO_ERROR | 0 | 没有错误。 |
| INVALID_PARAMETER | -1 | 无效的参数。 |
-| ABILITY_NOT_FOUND | -2 | 找不到能力。 |
+| ABILITY_NOT_FOUND | -2 | 找不到ABILITY。 |
| PERMISSION_DENY | -3 | 拒绝许可。 |
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md b/zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md
similarity index 76%
rename from zh-cn/application-dev/reference/apis/js-apis-featureAbility.md
rename to zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md
index e2b69809cec615ad647fd038d59bc0a413907685..fc088036e35587e3e3b27896c7c78b8422fec7cc 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md
@@ -1,947 +1,784 @@
-# FeatureAbility模块(JS端SDK接口)
-
-FeatureAbility模块提供带有UI设计与用户交互的能力，包括启动新的ability、获取dataAbilityHelper、设置此Page Ability、获取当前Ability对应的窗口，连接服务等。
-
-> **说明：**
->
-> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-> 本模块接口仅可在FA模型下使用。
-
-## 使用限制
-
-FeatureAbility模块的接口只能在Page类型的Ability调用
-
-## 导入模块
-
-```
-import featureAbility from '@ohos.ability.featureAbility';
-```
-
-## featureAbility.startAbility
-
-startAbility(parameter: StartAbilityParameter, callback: AsyncCallback\): void
-
-启动新的ability（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| --------- | ---------------------------------------- | ---- | -------------- |
-| parameter | [StartAbilityParameter](#startabilityparameter) | 是 | 表示被启动的Ability。 |
-| callback | AsyncCallback\ | 是 | 被指定的回调方法。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-import wantConstant from '@ohos.ability.wantConstant';
-featureAbility.startAbility(
- {
- want:
- {
- action: "",
- entities: [""],
- type: "",
- flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
- deviceId: "",
- bundleName: "com.example.myapplication",
- /* FA模型中abilityName由package + Ability name组成 */
- abilityName: "com.example.entry.secondAbility",
- uri: ""
- },
- },
- (err, data) => {
- console.info("startAbility err: " + JSON.stringify(err) + "data: " + JSON.stringify(data));
- }
-);
-```
-
-
-
-## featureAbility.startAbility
-
-startAbility(parameter: StartAbilityParameter): Promise\
-
-启动新的ability（Promise形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| --------- | ---------------------------------------- | ---- | -------------- |
-| parameter | [StartAbilityParameter](#startabilityparameter) | 是 | 表示被启动的Ability。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-import wantConstant from '@ohos.ability.wantConstant';
-featureAbility.startAbility(
- {
- want:
- {
- action: "action.system.home",
- entities: ["entity.system.home"],
- type: "MIMETYPE",
- flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
- deviceId: "",
- bundleName: "com.example.myapplication",
- /* FA模型中abilityName由package + Ability name组成 */
- abilityName: "com.example.entry.secondAbility",
- uri: ""
- },
- }
-).then((data) => {
- console.info("startAbility data: " + JSON.stringify(data));
-});
-```
-
-## featureAbility.acquireDataAbilityHelper7+
-
-acquireDataAbilityHelper(uri: string): DataAbilityHelper
-
-获取dataAbilityHelper。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| ---- | ------ | ---- | ------------ |
-| uri | string | 是 | 指示要打开的文件的路径。 |
-
-**返回值：**
-
-| 类型 | 说明 |
-| ----------------- | ------------------------------- |
-| DataAbilityHelper | 用来协助其他Ability访问DataAbility的工具类。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-var dataAbilityHelper = featureAbility.acquireDataAbilityHelper(
- "dataability:///com.example.DataAbility"
-);
-```
-
-## featureAbility.startAbilityForResult7+
-
-startAbilityForResult(parameter: StartAbilityParameter, callback: AsyncCallback\): void
-
-启动一个ability，并在该ability被销毁时返回执行结果（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| --------- | ---------------------------------------- | ---- | -------------- |
-| parameter | [StartAbilityParameter](#startabilityparameter) | 是 | 表示被启动的Ability。 |
-| callback | AsyncCallback\<[AbilityResult](#abilityresult)> | 是 | 被指定的回调方法。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-import wantConstant from '@ohos.ability.wantConstant';
-featureAbility.startAbilityForResult(
- {
- want:
- {
- action: "action.system.home",
- entities: ["entity.system.home"],
- type: "MIMETYPE",
- flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
- deviceId: "",
- bundleName: "com.example.myapplication",
- /* FA模型中abilityName由package + Ability name组成 */
- abilityName: "com.example.entry.secondAbility",
- uri:""
- },
- },
- (err, data) => {
- console.info("startAbilityForResult err: " + JSON.stringify(err) + "data: " + JSON.stringify(data));
- }
-);
-```
-
-## featureAbility.startAbilityForResult7+
-
-startAbilityForResult(parameter: StartAbilityParameter): Promise\
-
-启动一个ability，并在该ability被销毁时返回执行结果（Promise形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| --------- | ---------------------------------------- | ---- | ------------- |
-| parameter | [StartAbilityParameter](#startabilityparameter) | 是 | 表示被启动的Ability |
-
-**返回值：**
-
-| 类型 | 说明 |
-| ---------------------------------------- | ------- |
-| Promise\<[AbilityResult](#abilityresult)> | 返回执行结果。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-import wantConstant from '@ohos.ability.wantConstant';
-featureAbility.startAbilityForResult(
- {
- want:
- {
- action: "action.system.home",
- entities: ["entity.system.home"],
- type: "MIMETYPE",
- flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
- deviceId: "",
- bundleName: "com.example.myapplication",
- /* FA模型中abilityName由package + Ability name组成 */
- abilityName: "com.example.entry.secondAbility",
- uri:"",
- parameters:
- {
- mykey0: 1111,
- mykey1: [1, 2, 3],
- mykey2: "[1, 2, 3]",
- mykey3: "xxxxxxxxxxxxxxxxxxxxxx",
- mykey4: [1, 15],
- mykey5: [false, true, false],
- mykey6: ["aaaaaa", "bbbbb", "ccccccccccc"],
- mykey7: true,
- },
- },
- },
-).then((data) => {
- console.info("startAbilityForResult data: " + JSON.stringify(data));
-});
-```
-
-## featureAbility.terminateSelfWithResult7+
-
-terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback\): void
-
-设置此Page Ability将返回给调用者的结果代码和数据并破坏此Page Ability（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| --------- | ------------------------------- | ---- | -------------- |
-| parameter | [AbilityResult](#abilityresult) | 是 | 表示被启动的Ability。 |
-| callback | AsyncCallback\ | 是 | 被指定的回调方法。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-import wantConstant from '@ohos.ability.wantConstant';
-featureAbility.terminateSelfWithResult(
- {
- resultCode: 1,
- want:
- {
- action: "action.system.home",
- entities: ["entity.system.home"],
- type: "MIMETYPE",
- flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
- deviceId: "",
- bundleName: "com.example.myapplication",
- /* FA模型中abilityName由package + Ability name组成 */
- abilityName: "com.example.entry.secondAbility",
- uri:"",
- parameters: {
- mykey0: 2222,
- mykey1: [1, 2, 3],
- mykey2: "[1, 2, 3]",
- mykey3: "ssssssssssssssssssssssssss",
- mykey4: [1, 15],
- mykey5: [false, true, false],
- mykey6: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
- mykey7: true,
- }
- },
- },
- (err) => {
- console.info("err: " + JSON.stringify(err))
- }
-);
-```
-
-## featureAbility.terminateSelfWithResult7+
-
-terminateSelfWithResult(parameter: AbilityResult): Promise\
-
-设置此Page Ability将返回给调用者的结果代码和数据并破坏此Page Ability（Promise形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| --------- | ------------------------------- | ---- | ------------- |
-| parameter | [AbilityResult](#abilityresult) | 是 | 表示被启动的Ability |
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------------- | --------------- |
-| Promise\ | 以Promise形式返回结果。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-import wantConstant from '@ohos.ability.wantConstant';
-featureAbility.terminateSelfWithResult(
- {
- resultCode: 1,
- want:
- {
- action: "action.system.home",
- entities: ["entity.system.home"],
- type: "MIMETYPE",
- flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
- deviceId: "",
- bundleName: "com.example.myapplication",
- /* FA模型中abilityName由package + Ability name组成 */
- abilityName: "com.example.entry.secondAbility",
- uri:"",
- parameters: {
- mykey0: 2222,
- mykey1: [1, 2, 3],
- mykey2: "[1, 2, 3]",
- mykey3: "ssssssssssssssssssssssssss",
- mykey4: [1, 15],
- mykey5: [false, true, false],
- mykey6: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
- mykey7: true,
- }
- },
- }
-).then((data) => {
- console.info("==========================>terminateSelfWithResult=======================>");
-});
-```
-
-## featureAbility.hasWindowFocus7+
-
-hasWindowFocus(callback: AsyncCallback\): void
-
-检查Ability的主窗口是否具有窗口焦点（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | ----------------------- | ---- | ---------------------------------------- |
-| callback | AsyncCallback\ | 是 | 被指定的回调方法。
如果此Ability当前具有视窗焦点，则返回true；否则返回false。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-featureAbility.hasWindowFocus((err, data) => {
- console.info("hasWindowFocus err: " + JSON.stringify(err) + "data: " + JSON.stringify(data));
-});
-```
-
-## featureAbility.hasWindowFocus7+
-
-hasWindowFocus(): Promise\
-
-检查Ability的主窗口是否具有窗口焦点（Promise形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**返回值：**
-
-| 类型 | 说明 |
-| ----------------- | ------------------------------------- |
-| Promise\ | 如果此Ability当前具有视窗焦点，则返回true；否则返回false。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-featureAbility.hasWindowFocus().then((data) => {
- console.info("hasWindowFocus data: " + JSON.stringify(data));
-});
-```
-
-## featureAbility.getWant
-
-getWant(callback: AsyncCallback\): void
-
-获取从Ability发送的Want（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | ----------------------------- | ---- | --------- |
-| callback | AsyncCallback\<[Want](js-apis-application-Want.md)> | 是 | 被指定的回调方法。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-featureAbility.getWant((err, data) => {
- console.info("getWant err: " + JSON.stringify(err) + "data: " + JSON.stringify(data));
-});
-```
-
-## featureAbility.getWant
-
-getWant(): Promise\
-
-获取从Ability发送的Want（Promise形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**返回值：**
-
-| 类型 | 说明 |
-| ----------------------- | ---------------- |
-| Promise\<[Want](js-apis-application-Want.md)> | 以Promise的形式返回结果。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-featureAbility.getWant().then((data) => {
- console.info("getWant data: " + JSON.stringify(data));
-});
-```
-
-## featureAbility.getContext
-
-getContext(): Context
-
-获取应用上下文。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**返回值：**
-
-| 类型 | 说明 |
-| ------- | ---------- |
-| Context | 返回应用程序上下文。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-var context = featureAbility.getContext()
-context.getBundleName((err, data) => {
- console.info("getBundleName err: " + JSON.stringify(err) + "data: " + JSON.stringify(data));
-});
-```
-
-## featureAbility.terminateSelf7+
-
-terminateSelf(callback: AsyncCallback\): void
-
-设置Page Ability返回给被调用方的结果代码和数据，并销毁此Page Ability（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------------------- | ---- | -------- |
-| callback | AsyncCallback\ | 是 | 被指定的回调方法 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-featureAbility.terminateSelf(
- (err) => {
- console.info("err: " + JSON.stringify(err))
- }
-)
-```
-
-## featureAbility.terminateSelf7+
-
-terminateSelf(): Promise\
-
-设置Page Ability返回给被调用方的结果代码和数据，并销毁此Page Ability（Promise形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------------- | ---------------- |
-| Promise\ | 以Promise的形式返回结果。 |
-
-**示例：**
-
-```javascript
-import featureAbility from '@ohos.ability.featureAbility';
-featureAbility.terminateSelf().then((data) => {
- console.info("==========================>terminateSelf=======================>");
-});
-```
-
-## featureAbility.connectAbility7+
-
-connectAbility(request: Want, options:ConnectOptions): number
-
-将当前ability连接到指定ServiceAbility（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| ------- | -------------- | ---- | --------------------- |
-| request | [Want](js-apis-application-Want.md) | 是 | 表示被连接的ServiceAbility。 |
-| options | [ConnectOptions](#connectoptions) | 是 | 被指定的回调方法。 |
-
-## ConnectOptions
-
-ConnectOptions类型说明
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
-
-| 参数名 | 可读|可写 | 类型 | 必填 | 说明 |
-| ------------ | -- | -- | -------- | ---- | ------------------------- |
-| onConnect7+ | 是|否 | function | 是 | 连接成功时的回调函数。 |
-| onDisconnect7+ | 是|否 | function | 是 | 连接失败时的回调函数。 |
-| onFailed7+ | 是|否 | function | 是 | ConnectAbility调用失败时的回调函数。 |
-
-**返回值：**
-
-| 类型 | 说明 |
-| ------ | -------------------- |
-| number | 连接的ServiceAbilityID。 |
-
-**示例：**
-
-```javascript
-import rpc from '@ohos.rpc';
-import featureAbility from '@ohos.ability.featureAbility';
-function onConnectCallback(element, remote){
- console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
-}
-function onDisconnectCallback(element){
- console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
-}
-function onFailedCallback(code){
- console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
-}
-var connectId = featureAbility.connectAbility(
- {
- deviceId: "",
- bundleName: "com.ix.ServiceAbility",
- abilityName: "ServiceAbilityA",
- },
- {
- onConnect: onConnectCallback,
- onDisconnect: onDisconnectCallback,
- onFailed: onFailedCallback,
- },
-);
-```
-
-## featureAbility.disconnectAbility7+
-
-disconnectAbility(connection: number, callback:AsyncCallback\): void
-
-断开与指定ServiceAbility的连接（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| ---------- | -------------------- | ---- | ----------------------- |
-| connection | number | 是 | 指定断开连接的ServiceAbilityID |
-| callback | AsyncCallback\ | 是 | 被指定的回调方法 |
-
-**示例：**
-
-```javascript
-import rpc from '@ohos.rpc';
-import featureAbility from '@ohos.ability.featureAbility';
-function onConnectCallback(element, remote){
- console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
-}
-function onDisconnectCallback(element){
- console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
-}
-function onFailedCallback(code){
- console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
-}
-var connectId = featureAbility.connectAbility(
- {
- bundleName: "com.ix.ServiceAbility",
- abilityName: "ServiceAbilityA",
- },
- {
- onConnect: onConnectCallback,
- onDisconnect: onDisconnectCallback,
- onFailed: onFailedCallback,
- },
-);
-var result = featureAbility.disconnectAbility(connectId,
- (error) => {
- console.log('featureAbilityTest DisConnectJsSameBundleName result errCode : ' + error.code)
- },
-);
-```
-
-## featureAbility.disconnectAbility7+
-
-disconnectAbility(connection: number): Promise\
-
-断开与指定ServiceAbility的连接（Promise形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| ---------- | ------ | ---- | ----------------------- |
-| connection | number | 是 | 指定断开连接的ServiceAbilityID |
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------------- | --------------- |
-| Promise\ | 以Promise形式返回结果。 |
-
-**示例：**
-
-```javascript
-import rpc from '@ohos.rpc';
-import featureAbility from '@ohos.ability.featureAbility';
-function onConnectCallback(element, remote){
- console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
-}
-function onDisconnectCallback(element){
- console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
-}
-function onFailedCallback(code){
- console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
-}
-var connectId = featureAbility.connectAbility(
- {
- bundleName: "com.ix.ServiceAbility",
- abilityName: "ServiceAbilityA",
- },
- {
- onConnect: onConnectCallback,
- onDisconnect: onDisconnectCallback,
- onFailed: onFailedCallback,
- },
-);
-
-featureAbility.disconnectAbility(connectId).then((data) => {
- console.log('data : ' + data);
-}).catch((error)=>{
- console.log('featureAbilityTest result errCode : ' + error.code);
-});
-```
-
-
-## featureAbility.getWindow7+
-
-getWindow(callback: AsyncCallback\): void
-
-获取当前Ability对应的窗口（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | ----------------------------- | ---- | ----------------------------- |
-| callback | AsyncCallback\ | 是 | 返回与当前Ability对应的窗口。 |
-
-**示例：**
-
-```javascript
-featureAbility.getWindow((err, data) => {
- console.info("getWindow err: " + JSON.stringify(err) + "data: " + typeof(data));
-});
-```
-
-## featureAbility.getWindow7+
-
-getWindow(): Promise\;
-
-获取当前Ability对应的窗口（Promise形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**返回值：**
-
-| 类型 | 说明 |
-| ----------------------- | ----------------------------- |
-| Promise\ | 返回与当前Ability对应的窗口。 |
-
-**示例：**
-
-```javascript
-featureAbility.getWindow().then((data) => {
- console.info("getWindow data: " + typeof(data));
-});
-```
-
-## ConnectOptions.onConnect7+
-
-onConnect(elementName: ElementName, remote: rpc.IRemoteObject): void;
-
-连接成功时的回调函数。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| ----------- | ----------------- | ---- | -------- |
-| elementName | ElementName | 是 | 元素名。 |
-| remote | rpc.IRemoteObject | 是 | rpc远程对象。 |
-
-**示例：**
-
-```javascript
-import rpc from '@ohos.rpc';
-import featureAbility from '@ohos.ability.featureAbility';
-function onConnectCallback(element, remote){
- console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
-}
-function onDisconnectCallback(element){
- console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
-}
-function onFailedCallback(code){
- console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
-}
-var connectId = featureAbility.connectAbility(
- {
- deviceId: "",
- bundleName: "com.ix.ServiceAbility",
- abilityName: "ServiceAbilityA",
- },
- {
- onConnect: onConnectCallback,
- onDisconnect: onDisconnectCallback,
- onFailed: onFailedCallback,
- },
-);
-```
-
-## ConnectOptions.onDisconnect7+
-
-onDisconnect(elementName: ElementName): void;
-
-连接失败时的回调函数。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| ----------- | ----------- | ---- | ---- |
-| elementName | ElementName | 是 | 元素名。 |
-
-**示例：**
-
-```javascript
-import rpc from '@ohos.rpc';
-import featureAbility from '@ohos.ability.featureAbility';
-function onConnectCallback(element, remote){
- console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
-}
-function onDisconnectCallback(element){
- console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
-}
-function onFailedCallback(code){
- console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
-}
-var connectId = featureAbility.connectAbility(
- {
- deviceId: "",
- bundleName: "com.ix.ServiceAbility",
- abilityName: "ServiceAbilityA",
- },
- {
- onConnect: onConnectCallback,
- onDisconnect: onDisconnectCallback,
- onFailed: onFailedCallback,
- },
-);
-```
-
-## ConnectOptions.onFailed7+
-
-onFailed(code: number): void;
-
-ConnectAbility调用失败时的回调函数。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| ---- | ------ | ---- | --------- |
-| code | number | 是 | number类型。 |
-
-**示例：**
-
-```javascript
-import rpc from '@ohos.rpc';
-import featureAbility from '@ohos.ability.featureAbility';
-function onConnectCallback(element, remote){
- console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
-}
-function onDisconnectCallback(element){
- console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
-}
-function onFailedCallback(code){
- console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
-}
-var connectId = featureAbility.connectAbility(
- {
- deviceId: "",
- bundleName: "com.ix.ServiceAbility",
- abilityName: "ServiceAbilityA",
- },
- {
- onConnect: onConnectCallback,
- onDisconnect: onDisconnectCallback,
- onFailed: onFailedCallback,
- },
-);
-```
-
-
-
-
-
-## AbilityWindowConfiguration
-
-使用时通过featureAbility.AbilityWindowConfiguration获取。
-
-**示例：**
-
-```
-featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED
-```
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
-
-| 名称 | 值 | 说明 |
-| ---------------------------------------- | ---- | ---------------------------------------- |
-| WINDOW_MODE_UNDEFINED7+ | 0 | 未定义。 |
-| WINDOW_MODE_FULLSCREEN7+ | 1 | 全屏。 |
-| WINDOW_MODE_SPLIT_PRIMARY7+ | 100 | 分屏主屏。 |
-| WINDOW_MODE_SPLIT_SECONDARY7+ | 101 | 分屏次屏。 |
-| WINDOW_MODE_FLOATING7+ | 102 | 悬浮窗。 |
-
-
-## AbilityStartSetting
-
-abilityStartSetting属性是一个定义为[key: string]: any的对象，key对应设定类型为：AbilityStartSetting枚举类型，value对应设定类型为：AbilityWindowConfiguration枚举类型。
-
-使用时通过featureAbility.AbilityStartSetting获取。
-
-**示例：**
-
-```
-featureAbility.AbilityStartSetting.BOUNDS_KEY
-```
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
-
-| 名称 | 值 | 说明 |
-| ---------------------------- | --------------- | ---------------------------------------- |
-| BOUNDS_KEY7+ | "abilityBounds" | 窗口显示大小属性的参数名。 |
-| WINDOW_MODE_KEY7+ | "windowMode" | 窗口显示模式属性的参数名。|
-| DISPLAY_ID_KEY7+ | "displayId" | 窗口显示设备ID属性的参数名。 |
-
-## ErrorCode
-
-获取错误代码。
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
-
-| 名称 | 值 | 说明 |
-| ------------------------------ | ---- | ---------------------------------------- |
-| NO_ERROR7+ | 0 | 没有错误。 |
-| INVALID_PARAMETER7+ | -1 | 无效的参数。 |
-| ABILITY_NOT_FOUND7+ | -2 | 找不到能力。 |
-| PERMISSION_DENY7+ | -3 | 拒绝许可。 |
-
-
-## DataAbilityOperationType
-
-指示数据的操作类型。
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
-
-| 名称 | 值 | 说明 |
-| ------------------------ | ---- | ---------------------------------------- |
-| TYPE_INSERT7+ | 1 | 插入类型。 |
-| TYPE_UPDATE7+ | 2 | 修改类型。 |
-| TYPE_DELETE7+ | 3 | 删除类型。 |
-| TYPE_ASSERT7+ | 4 | 声明类型。 |
-
-
-
-## AbilityResult
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
-
-| 名称 | 类型 | 可读| 可写 | 必填 | 说明 |
-| --------------- |-------- | ------ | ------------- | ---- | ------------------------------------- |
-| resultCode7+| number| 是 | 否 | 是 | 指示销毁该能力后返回的结果代码。您可以定义结果代码来识别错误（暂不支持）。 |
-| want7+ | [Want](js-apis-application-Want.md)| 是 | 否 | 否 | 指示销毁该能力后返回的数据。您可以定义返回的数据。此参数可以为null。 |
-
-## StartAbilityParameter
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
-
-| 名称 | 类型 | 可读| 可写 | 必填 | 说明 |
-| ------------------- | -------- | -------------------- | ---- | -------------------------------------- |
-| want | [Want](js-apis-application-Want.md)| 是 | 否 | 是 | 表示需要包含有关目标启动能力的信息。 |
-| abilityStartSetting | {[key: string]: any} | 是 |否 | 否 | 表示能力的特殊属性，当开发者启动能力时，该属性可以作为调用中的输入参数传递。 |
-
-## flags说明
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
-
-| 名称 | 值 | 说明 |
-| ------------------------------------ | ---------- | ---------------------------------------- |
-| FLAG_AUTH_READ_URI_PERMISSION | 0x00000001 | 指示对URI执行读取操作的授权。 |
-| FLAG_AUTH_WRITE_URI_PERMISSION | 0x00000002 | 指示对URI执行写入操作的授权。 |
-| FLAG_ABILITY_FORWARD_RESULT | 0x00000004 | 将结果返回给元能力。 |
-| FLAG_ABILITY_CONTINUATION | 0x00000008 | 确定是否可以将本地设备上的功能迁移到远程设备。 |
-| FLAG_NOT_OHOS_COMPONENT | 0x00000010 | 指定组件是否属于OHOS。 |
-| FLAG_ABILITY_FORM_ENABLED | 0x00000020 | 指定是否启动某个能力。 |
-| FLAG_AUTH_PERSISTABLE_URI_PERMISSION | 0x00000040 | 指示URI上可能持久化的授权。
**系统API**: 此接口为系统接口，三方应用不支持调用。 |
-| FLAG_AUTH_PREFIX_URI_PERMISSION | 0x00000080 | 按照前缀匹配的方式验证URI权限。
**系统API**: 此接口为系统接口，三方应用不支持调用。 |
-| FLAG_ABILITYSLICE_MULTI_DEVICE | 0x00000100 | 支持分布式调度系统中的多设备启动。 |
-| FLAG_START_FOREGROUND_ABILITY | 0x00000200 | 指示无论主机应用程序是否已启动，都将启动使用服务模板的功能。
**系统API**: 此接口为系统接口，三方应用不支持调用。 |
-| FLAG_ABILITY_CONTINUATION_REVERSIBLE | 0x00000400 | 表示迁移是可拉回的。 |
-| FLAG_INSTALL_ON_DEMAND | 0x00000800 | 如果未安装指定的功能，请安装该功能。 |
-| FLAG_INSTALL_WITH_BACKGROUND_MODE | 0x80000000 | 如果未安装，使用后台模式安装该功能。 |
-| FLAG_ABILITY_CLEAR_MISSION | 0x00008000 | 指示清除其他任务的操作。可以为传递给 **[ohos.app.Context](js-apis-ability-context.md)** 中**startAbility**方法的**Want**设置此标志，并且必须与**flag_ABILITY_NEW_MISSION**一起使用。 |
-| FLAG_ABILITY_NEW_MISSION | 0x10000000 | 指示在历史任务堆栈上创建任务的操作。 |
-| FLAG_ABILITY_MISSION_TOP | 0x20000000 | 指示如果启动能力的现有实例已位于任务堆栈的顶部，则将重用该实例。否则，将创建一个新的能力实例。 |
-
+# FeatureAbility模块(JS端SDK接口)
+
+FeatureAbility模块提供带有UI设计与用户交互的能力，包括启动新的ability、获取dataAbilityHelper、设置此Page Ability、获取当前Ability对应的窗口，连接服务等。
+
+> **说明：**
+>
+> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块接口仅可在FA模型下使用。
+
+## 使用限制
+
+FeatureAbility模块的接口只能在Page类型的Ability调用
+
+## 导入模块
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+```
+
+## featureAbility.startAbility
+
+startAbility(parameter: StartAbilityParameter, callback: AsyncCallback\): void
+
+启动新的ability（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| --------- | ---------------------------------------- | ---- | -------------- |
+| parameter | [StartAbilityParameter](js-apis-inner-ability-startAbilityParameter.md) | 是 | 表示被启动的Ability。 |
+| callback | AsyncCallback\ | 是 | 被指定的回调方法。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+import wantConstant from '@ohos.ability.wantConstant';
+featureAbility.startAbility(
+ {
+ want:
+ {
+ action: "",
+ entities: [""],
+ type: "",
+ flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
+ deviceId: "",
+ bundleName: "com.example.myapplication",
+ /* FA模型中abilityName由package + Ability name组成 */
+ abilityName: "com.example.entry.secondAbility",
+ uri: ""
+ },
+ },
+ (err, data) => {
+ console.info("startAbility err: " + JSON.stringify(err) + "data: " + JSON.stringify(data));
+ }
+);
+```
+
+
+
+## featureAbility.startAbility
+
+startAbility(parameter: StartAbilityParameter): Promise\
+
+启动新的ability（Promise形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| --------- | ---------------------------------------- | ---- | -------------- |
+| parameter | [StartAbilityParameter](js-apis-inner-ability-startAbilityParameter.md) | 是 | 表示被启动的Ability。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+import wantConstant from '@ohos.ability.wantConstant';
+featureAbility.startAbility(
+ {
+ want:
+ {
+ action: "action.system.home",
+ entities: ["entity.system.home"],
+ type: "MIMETYPE",
+ flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
+ deviceId: "",
+ bundleName: "com.example.myapplication",
+ /* FA模型中abilityName由package + Ability name组成 */
+ abilityName: "com.example.entry.secondAbility",
+ uri: ""
+ },
+ }
+).then((data) => {
+ console.info("startAbility data: " + JSON.stringify(data));
+});
+```
+
+## featureAbility.acquireDataAbilityHelper7+
+
+acquireDataAbilityHelper(uri: string): DataAbilityHelper
+
+获取dataAbilityHelper。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ---- | ------ | ---- | ------------ |
+| uri | string | 是 | 指示要打开的文件的路径。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------------- | ------------------------------- |
+| DataAbilityHelper | 用来协助其他Ability访问DataAbility的工具类。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+var dataAbilityHelper = featureAbility.acquireDataAbilityHelper(
+ "dataability:///com.example.DataAbility"
+);
+```
+
+## featureAbility.startAbilityForResult7+
+
+startAbilityForResult(parameter: StartAbilityParameter, callback: AsyncCallback\): void
+
+启动一个ability，并在该ability被销毁时返回执行结果（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| --------- | ---------------------------------------- | ---- | -------------- |
+| parameter | [StartAbilityParameter](js-apis-inner-ability-startAbilityParameter.md) | 是 | 表示被启动的Ability。 |
+| callback | AsyncCallback\<[AbilityResult](js-apis-inner-ability-abilityResult.md)> | 是 | 被指定的回调方法。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+import wantConstant from '@ohos.ability.wantConstant';
+featureAbility.startAbilityForResult(
+ {
+ want:
+ {
+ action: "action.system.home",
+ entities: ["entity.system.home"],
+ type: "MIMETYPE",
+ flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
+ deviceId: "",
+ bundleName: "com.example.myapplication",
+ /* FA模型中abilityName由package + Ability name组成 */
+ abilityName: "com.example.entry.secondAbility",
+ uri:""
+ },
+ },
+ (err, data) => {
+ console.info("startAbilityForResult err: " + JSON.stringify(err) + "data: " + JSON.stringify(data));
+ }
+);
+```
+
+## featureAbility.startAbilityForResult7+
+
+startAbilityForResult(parameter: StartAbilityParameter): Promise\
+
+启动一个ability，并在该ability被销毁时返回执行结果（Promise形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| --------- | ---------------------------------------- | ---- | ------------- |
+| parameter | [StartAbilityParameter](js-apis-inner-ability-startAbilityParameter.md) | 是 | 表示被启动的Ability |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ---------------------------------------- | ------- |
+| Promise\<[AbilityResult](js-apis-inner-ability-abilityResult.md)> | 返回执行结果。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+import wantConstant from '@ohos.ability.wantConstant';
+featureAbility.startAbilityForResult(
+ {
+ want:
+ {
+ action: "action.system.home",
+ entities: ["entity.system.home"],
+ type: "MIMETYPE",
+ flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
+ deviceId: "",
+ bundleName: "com.example.myapplication",
+ /* FA模型中abilityName由package + Ability name组成 */
+ abilityName: "com.example.entry.secondAbility",
+ uri:"",
+ parameters:
+ {
+ mykey0: 1111,
+ mykey1: [1, 2, 3],
+ mykey2: "[1, 2, 3]",
+ mykey3: "xxxxxxxxxxxxxxxxxxxxxx",
+ mykey4: [1, 15],
+ mykey5: [false, true, false],
+ mykey6: ["aaaaaa", "bbbbb", "ccccccccccc"],
+ mykey7: true,
+ },
+ },
+ },
+).then((data) => {
+ console.info("startAbilityForResult data: " + JSON.stringify(data));
+});
+```
+
+## featureAbility.terminateSelfWithResult7+
+
+terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback\): void
+
+设置此Page Ability将返回给调用者的结果代码和数据并破坏此Page Ability（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| --------- | ------------------------------- | ---- | -------------- |
+| parameter | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 是 | 表示被启动的Ability。 |
+| callback | AsyncCallback\ | 是 | 被指定的回调方法。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+import wantConstant from '@ohos.ability.wantConstant';
+featureAbility.terminateSelfWithResult(
+ {
+ resultCode: 1,
+ want:
+ {
+ action: "action.system.home",
+ entities: ["entity.system.home"],
+ type: "MIMETYPE",
+ flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
+ deviceId: "",
+ bundleName: "com.example.myapplication",
+ /* FA模型中abilityName由package + Ability name组成 */
+ abilityName: "com.example.entry.secondAbility",
+ uri:"",
+ parameters: {
+ mykey0: 2222,
+ mykey1: [1, 2, 3],
+ mykey2: "[1, 2, 3]",
+ mykey3: "ssssssssssssssssssssssssss",
+ mykey4: [1, 15],
+ mykey5: [false, true, false],
+ mykey6: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
+ mykey7: true,
+ }
+ },
+ },
+ (err) => {
+ console.info("err: " + JSON.stringify(err))
+ }
+);
+```
+
+## featureAbility.terminateSelfWithResult7+
+
+terminateSelfWithResult(parameter: AbilityResult): Promise\
+
+设置此Page Ability将返回给调用者的结果代码和数据并破坏此Page Ability（Promise形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| --------- | ------------------------------- | ---- | ------------- |
+| parameter | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 是 | 表示被启动的Ability |
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------------- | --------------- |
+| Promise\ | 以Promise形式返回结果。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+import wantConstant from '@ohos.ability.wantConstant';
+featureAbility.terminateSelfWithResult(
+ {
+ resultCode: 1,
+ want:
+ {
+ action: "action.system.home",
+ entities: ["entity.system.home"],
+ type: "MIMETYPE",
+ flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
+ deviceId: "",
+ bundleName: "com.example.myapplication",
+ /* FA模型中abilityName由package + Ability name组成 */
+ abilityName: "com.example.entry.secondAbility",
+ uri:"",
+ parameters: {
+ mykey0: 2222,
+ mykey1: [1, 2, 3],
+ mykey2: "[1, 2, 3]",
+ mykey3: "ssssssssssssssssssssssssss",
+ mykey4: [1, 15],
+ mykey5: [false, true, false],
+ mykey6: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
+ mykey7: true,
+ }
+ },
+ }
+).then((data) => {
+ console.info("==========================>terminateSelfWithResult=======================>");
+});
+```
+
+## featureAbility.hasWindowFocus7+
+
+hasWindowFocus(callback: AsyncCallback\): void
+
+检查Ability的主窗口是否具有窗口焦点（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------------------- | ---- | ---------------------------------------- |
+| callback | AsyncCallback\ | 是 | 被指定的回调方法。
如果此Ability当前具有视窗焦点，则返回true；否则返回false。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+featureAbility.hasWindowFocus((err, data) => {
+ console.info("hasWindowFocus err: " + JSON.stringify(err) + "data: " + JSON.stringify(data));
+});
+```
+
+## featureAbility.hasWindowFocus7+
+
+hasWindowFocus(): Promise\
+
+检查Ability的主窗口是否具有窗口焦点（Promise形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------------- | ------------------------------------- |
+| Promise\ | 如果此Ability当前具有视窗焦点，则返回true；否则返回false。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+featureAbility.hasWindowFocus().then((data) => {
+ console.info("hasWindowFocus data: " + JSON.stringify(data));
+});
+```
+
+## featureAbility.getWant
+
+getWant(callback: AsyncCallback\): void
+
+获取从Ability发送的Want（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------------------------- | ---- | --------- |
+| callback | AsyncCallback\<[Want](js-apis-application-want.md)> | 是 | 被指定的回调方法。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+featureAbility.getWant((err, data) => {
+ console.info("getWant err: " + JSON.stringify(err) + "data: " + JSON.stringify(data));
+});
+```
+
+## featureAbility.getWant
+
+getWant(): Promise\
+
+获取从Ability发送的Want（Promise形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------------------- | ---------------- |
+| Promise\<[Want](js-apis-application-want.md)> | 以Promise的形式返回结果。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+featureAbility.getWant().then((data) => {
+ console.info("getWant data: " + JSON.stringify(data));
+});
+```
+
+## featureAbility.getContext
+
+getContext(): Context
+
+获取应用上下文。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**返回值：**
+
+| 类型 | 说明 |
+| ------- | ---------- |
+| Context | 返回应用程序上下文。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+var context = featureAbility.getContext()
+context.getBundleName((err, data) => {
+ console.info("getBundleName err: " + JSON.stringify(err) + "data: " + JSON.stringify(data));
+});
+```
+
+## featureAbility.terminateSelf7+
+
+terminateSelf(callback: AsyncCallback\): void
+
+设置Page Ability返回给被调用方的结果代码和数据，并销毁此Page Ability（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------------- | ---- | -------- |
+| callback | AsyncCallback\ | 是 | 被指定的回调方法 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+featureAbility.terminateSelf(
+ (err) => {
+ console.info("err: " + JSON.stringify(err))
+ }
+)
+```
+
+## featureAbility.terminateSelf7+
+
+terminateSelf(): Promise\
+
+设置Page Ability返回给被调用方的结果代码和数据，并销毁此Page Ability（Promise形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------------- | ---------------- |
+| Promise\ | 以Promise的形式返回结果。 |
+
+**示例：**
+
+```ts
+import featureAbility from '@ohos.ability.featureAbility';
+featureAbility.terminateSelf().then((data) => {
+ console.info("==========================>terminateSelf=======================>");
+});
+```
+
+## featureAbility.connectAbility7+
+
+connectAbility(request: Want, options:ConnectOptions): number
+
+将当前ability连接到指定ServiceAbility（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------- | -------------- | ---- | --------------------- |
+| request | [Want](js-apis-application-want.md) | 是 | 表示被连接的ServiceAbility。 |
+| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 是 | 被指定的回调方法。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ------ | -------------------- |
+| number | 连接的ServiceAbilityID。 |
+
+**示例：**
+
+```ts
+import rpc from '@ohos.rpc';
+import featureAbility from '@ohos.ability.featureAbility';
+function onConnectCallback(element, remote){
+ console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
+}
+function onDisconnectCallback(element){
+ console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
+}
+function onFailedCallback(code){
+ console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
+}
+var connectId = featureAbility.connectAbility(
+ {
+ deviceId: "",
+ bundleName: "com.ix.ServiceAbility",
+ abilityName: "ServiceAbilityA",
+ },
+ {
+ onConnect: onConnectCallback,
+ onDisconnect: onDisconnectCallback,
+ onFailed: onFailedCallback,
+ },
+);
+```
+
+## featureAbility.disconnectAbility7+
+
+disconnectAbility(connection: number, callback:AsyncCallback\): void
+
+断开与指定ServiceAbility的连接（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ---------- | -------------------- | ---- | ----------------------- |
+| connection | number | 是 | 指定断开连接的ServiceAbilityID |
+| callback | AsyncCallback\ | 是 | 被指定的回调方法 |
+
+**示例：**
+
+```ts
+import rpc from '@ohos.rpc';
+import featureAbility from '@ohos.ability.featureAbility';
+function onConnectCallback(element, remote){
+ console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
+}
+function onDisconnectCallback(element){
+ console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
+}
+function onFailedCallback(code){
+ console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
+}
+var connectId = featureAbility.connectAbility(
+ {
+ bundleName: "com.ix.ServiceAbility",
+ abilityName: "ServiceAbilityA",
+ },
+ {
+ onConnect: onConnectCallback,
+ onDisconnect: onDisconnectCallback,
+ onFailed: onFailedCallback,
+ },
+);
+var result = featureAbility.disconnectAbility(connectId,
+ (error) => {
+ console.log('featureAbilityTest DisConnectJsSameBundleName result errCode : ' + error.code)
+ },
+);
+```
+
+## featureAbility.disconnectAbility7+
+
+disconnectAbility(connection: number): Promise\
+
+断开与指定ServiceAbility的连接（Promise形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ---------- | ------ | ---- | ----------------------- |
+| connection | number | 是 | 指定断开连接的ServiceAbilityID |
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------------- | --------------- |
+| Promise\ | 以Promise形式返回结果。 |
+
+**示例：**
+
+```ts
+import rpc from '@ohos.rpc';
+import featureAbility from '@ohos.ability.featureAbility';
+function onConnectCallback(element, remote){
+ console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
+}
+function onDisconnectCallback(element){
+ console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
+}
+function onFailedCallback(code){
+ console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
+}
+var connectId = featureAbility.connectAbility(
+ {
+ bundleName: "com.ix.ServiceAbility",
+ abilityName: "ServiceAbilityA",
+ },
+ {
+ onConnect: onConnectCallback,
+ onDisconnect: onDisconnectCallback,
+ onFailed: onFailedCallback,
+ },
+);
+
+featureAbility.disconnectAbility(connectId).then((data) => {
+ console.log('data : ' + data);
+}).catch((error)=>{
+ console.log('featureAbilityTest result errCode : ' + error.code);
+});
+```
+
+
+## featureAbility.getWindow7+
+
+getWindow(callback: AsyncCallback\): void
+
+获取当前Ability对应的窗口（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------------------------- | ---- | ----------------------------- |
+| callback | AsyncCallback\ | 是 | 返回与当前Ability对应的窗口。 |
+
+**示例：**
+
+```ts
+featureAbility.getWindow((err, data) => {
+ console.info("getWindow err: " + JSON.stringify(err) + "data: " + typeof(data));
+});
+```
+
+## featureAbility.getWindow7+
+
+getWindow(): Promise\;
+
+获取当前Ability对应的窗口（Promise形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------------------- | ----------------------------- |
+| Promise\ | 返回与当前Ability对应的窗口。 |
+
+**示例：**
+
+```ts
+featureAbility.getWindow().then((data) => {
+ console.info("getWindow data: " + typeof(data));
+});
+```
+
+## AbilityWindowConfiguration
+
+使用时通过featureAbility.AbilityWindowConfiguration获取。
+
+**示例：**
+
+```
+featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED
+```
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
+
+| 名称 | 值 | 说明 |
+| ---------------------------------------- | ---- | ---------------------------------------- |
+| WINDOW_MODE_UNDEFINED7+ | 0 | 未定义。 |
+| WINDOW_MODE_FULLSCREEN7+ | 1 | 全屏。 |
+| WINDOW_MODE_SPLIT_PRIMARY7+ | 100 | 分屏主屏。 |
+| WINDOW_MODE_SPLIT_SECONDARY7+ | 101 | 分屏次屏。 |
+| WINDOW_MODE_FLOATING7+ | 102 | 悬浮窗。 |
+
+
+## AbilityStartSetting
+
+abilityStartSetting属性是一个定义为[key: string]: any的对象，key对应设定类型为：AbilityStartSetting枚举类型，value对应设定类型为：AbilityWindowConfiguration枚举类型。
+
+使用时通过featureAbility.AbilityStartSetting获取。
+
+**示例：**
+
+```
+featureAbility.AbilityStartSetting.BOUNDS_KEY
+```
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
+
+| 名称 | 值 | 说明 |
+| ---------------------------- | --------------- | ---------------------------------------- |
+| BOUNDS_KEY7+ | "abilityBounds" | 窗口显示大小属性的参数名。 |
+| WINDOW_MODE_KEY7+ | "windowMode" | 窗口显示模式属性的参数名。|
+| DISPLAY_ID_KEY7+ | "displayId" | 窗口显示设备ID属性的参数名。 |
+
+## ErrorCode
+
+获取错误代码。
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
+
+| 名称 | 值 | 说明 |
+| ------------------------------ | ---- | ---------------------------------------- |
+| NO_ERROR7+ | 0 | 没有错误。 |
+| INVALID_PARAMETER7+ | -1 | 无效的参数。 |
+| ABILITY_NOT_FOUND7+ | -2 | 找不到能力。 |
+| PERMISSION_DENY7+ | -3 | 拒绝许可。 |
+
+
+## DataAbilityOperationType
+
+指示数据的操作类型。
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
+
+| 名称 | 值 | 说明 |
+| ------------------------ | ---- | ---------------------------------------- |
+| TYPE_INSERT7+ | 1 | 插入类型。 |
+| TYPE_UPDATE7+ | 2 | 修改类型。 |
+| TYPE_DELETE7+ | 3 | 删除类型。 |
+| TYPE_ASSERT7+ | 4 | 声明类型。 |
+
+## flags说明
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
+
+| 名称 | 值 | 说明 |
+| ------------------------------------ | ---------- | ---------------------------------------- |
+| FLAG_AUTH_READ_URI_PERMISSION | 0x00000001 | 指示对URI执行读取操作的授权。 |
+| FLAG_AUTH_WRITE_URI_PERMISSION | 0x00000002 | 指示对URI执行写入操作的授权。 |
+| FLAG_ABILITY_FORWARD_RESULT | 0x00000004 | 将结果返回给元能力。 |
+| FLAG_ABILITY_CONTINUATION | 0x00000008 | 确定是否可以将本地设备上的功能迁移到远程设备。 |
+| FLAG_NOT_OHOS_COMPONENT | 0x00000010 | 指定组件是否属于OHOS。 |
+| FLAG_ABILITY_FORM_ENABLED | 0x00000020 | 指定是否启动某个能力。 |
+| FLAG_AUTH_PERSISTABLE_URI_PERMISSION | 0x00000040 | 指示URI上可能持久化的授权。
**系统API**: 此接口为系统接口，三方应用不支持调用。 |
+| FLAG_AUTH_PREFIX_URI_PERMISSION | 0x00000080 | 按照前缀匹配的方式验证URI权限。
**系统API**: 此接口为系统接口，三方应用不支持调用。 |
+| FLAG_ABILITYSLICE_MULTI_DEVICE | 0x00000100 | 支持分布式调度系统中的多设备启动。 |
+| FLAG_START_FOREGROUND_ABILITY | 0x00000200 | 指示无论主机应用程序是否已启动，都将启动使用服务模板的功能。
**系统API**: 此接口为系统接口，三方应用不支持调用。 |
+| FLAG_ABILITY_CONTINUATION_REVERSIBLE | 0x00000400 | 表示迁移是可拉回的。 |
+| FLAG_INSTALL_ON_DEMAND | 0x00000800 | 如果未安装指定的功能，请安装该功能。 |
+| FLAG_INSTALL_WITH_BACKGROUND_MODE | 0x80000000 | 如果未安装，使用后台模式安装该功能。 |
+| FLAG_ABILITY_CLEAR_MISSION | 0x00008000 | 指示清除其他任务的操作。可以为传递给 **[ohos.app.Context](js-apis-ability-context.md)** 中**startAbility**方法的**Want**设置此标志，并且必须与**flag_ABILITY_NEW_MISSION**一起使用。 |
+| FLAG_ABILITY_NEW_MISSION | 0x10000000 | 指示在历史任务堆栈上创建任务的操作。 |
+| FLAG_ABILITY_MISSION_TOP | 0x20000000 | 指示如果启动能力的现有实例已位于任务堆栈的顶部，则将重用该实例。否则，将创建一个新的能力实例。 |
+
diff --git a/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md b/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md
similarity index 94%
rename from zh-cn/application-dev/reference/apis/js-apis-particleAbility.md
rename to zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md
index b414aab9865a84fcee7e2e891625b63a558e2420..a734d00e81529e0e5bd964b71b44f78ad88428ac 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md
@@ -1,556 +1,556 @@
-# particleAbility模块
-
-particleAbility模块提供了Service类型Ability的能力，包括启动、停止指定的particleAbility，获取dataAbilityHelper，连接、断开当前Ability与指定ServiceAbility等。
-
-> **说明：**
->
-> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-> 本模块接口仅可在FA模型下使用。
-
-## 使用限制
-
-particleAbility模块用来对Data和Service类型的Ability进行操作。
-
-## 导入模块
-
-```js
-import particleAbility from '@ohos.ability.particleAbility'
-```
-
-## particleAbility.startAbility
-
-startAbility(parameter: StartAbilityParameter, callback: AsyncCallback\): void
-
-使用此方法启动指定的particleAbility（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| --------- | ----------------------------------------------- | ---- | ----------------- |
-| parameter | [StartAbilityParameter](js-apis-featureAbility.md#startabilityparameter) | 是 | 指示启动的ability |
-| callback | AsyncCallback\ | 是 | 被指定的回调方法 |
-
-**示例：**
-
-```js
-import particleAbility from '@ohos.ability.particleAbility'
-import wantConstant from '@ohos.ability.wantConstant'
-
-particleAbility.startAbility(
- {
- want:
- {
- action: "action.system.home",
- entities: ["entity.system.home"],
- type: "MIMETYPE",
- flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
- deviceId: "",
- bundleName: "com.example.Data",
- abilityName: "com.example.Data.MainAbility",
- uri: ""
- },
- },
- (error, result) => {
- console.log('particleAbility startAbility errCode:' + error + 'result:' + result)
- },
-)
-```
-
-## particleAbility.startAbility
-
-startAbility(parameter: StartAbilityParameter): Promise\;
-
-使用此方法启动指定的particleAbility（Promise形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| --------- | ----------------------------------------------- | ---- | ----------------- |
-| parameter | [StartAbilityParameter](js-apis-featureAbility.md#startabilityparameter) | 是 | 指示启动的ability |
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------------- | ------------------------- |
-| Promise\ | 使用Promise形式返回结果。 |
-
-**示例：**
-
-```js
-import particleAbility from '@ohos.ability.particleAbility'
-import wantConstant from '@ohos.ability.wantConstant'
-
-particleAbility.startAbility(
- {
- want:
- {
- action: "action.system.home",
- entities: ["entity.system.home"],
- type: "MIMETYPE",
- flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
- deviceId: "",
- bundleName: "com.example.Data",
- abilityName: "com.example. Data.MainAbility",
- uri: ""
- },
- },
-).then((data) => {
- console.info("particleAbility startAbility");
-});
-```
-
-## particleAbility.terminateSelf
-
-terminateSelf(callback: AsyncCallback\): void
-
-终止particleAbility（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------------------- | ---- | -------------------- |
-| callback | AsyncCallback\ | 是 | 表示被指定的回调方法 |
-
-**示例：**
-
-```js
-import particleAbility from '@ohos.ability.particleAbility'
-
-particleAbility.terminateSelf(
- (error, result) => {
- console.log('particleAbility terminateSelf errCode:' + error + 'result:' + result)
- }
-)
-```
-
-## particleAbility.terminateSelf
-
-terminateSelf(): Promise\
-
-终止particleAbility（Promise形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------------- | ------------------------- |
-| Promise\ | 使用Promise形式返回结果。 |
-
-**示例：**
-
-```js
-import particleAbility from '@ohos.ability.particleAbility'
-
-particleAbility.terminateSelf().then((data) => {
- console.info("particleAbility terminateSelf");
-});
-```
-
-
-
-## particleAbility.acquireDataAbilityHelper
-
-acquireDataAbilityHelper(uri: string): DataAbilityHelper
-
-获取dataAbilityHelper。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| :--- | ------ | ---- | ------------------------ |
-| uri | string | 是 | 指示要打开的文件的路径。 |
-
-**返回值：**
-
-| 类型 | 说明 |
-| ----------------- | -------------------------------------------- |
-| DataAbilityHelper | 用来协助其他Ability访问DataAbility的工具类。 |
-
-**示例：**
-
-```js
-import particleAbility from '@ohos.ability.particleAbility'
-
-var uri = "";
-particleAbility.acquireDataAbilityHelper(uri)
-```
-
-
-## particleAbility.startBackgroundRunning
-
-startBackgroundRunning(id: number, request: NotificationRequest, callback: AsyncCallback<void>): void;
-
-向系统申请长时任务，使用callback形式返回结果，建议使用新接口[backgroundTaskManager.startBackgroundRunning](js-apis-backgroundTaskManager.md#backgroundtaskmanagerstartbackgroundrunning8)。
-
-**需要权限:** ohos.permission.KEEP_BACKGROUND_RUNNING
-
-**系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
-
-**参数：**
-
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | id | number | 是 | 长时任务通知id号 |
- | request | [NotificationRequest](js-apis-notification.md#notificationrequest) | 是 | 通知参数，用于显示通知栏的信息 |
- | callback | AsyncCallback<void> | 是 | callback形式返回启动长时任务的结果 |
-
- **示例**：
-
-```js
-import notification from '@ohos.notification';
-import particleAbility from '@ohos.ability.particleAbility';
-import wantAgent from '@ohos.wantAgent';
-
-function callback(err, data) {
- if (err) {
- console.error("Operation failed cause: " + JSON.stringify(err));
- } else {
- console.info("Operation succeeded");
- }
-}
-
-let wantAgentInfo = {
- wants: [
- {
- bundleName: "com.example.myapplication",
- abilityName: "com.example.myapplication.MainAbility"
- }
- ],
- operationType: wantAgent.OperationType.START_ABILITY,
- requestCode: 0,
- wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
-};
-
-wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
- let basicContent = {
- title: "title",
- text: "text"
- };
- let notificationContent = {
- contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
- normal: basicContent
- };
- let request = {
- content: notificationContent,
- wantAgent: wantAgentObj
- };
- let id = 1;
- particleAbility.startBackgroundRunning(id, request, callback);
-});
-
-```
-
-## particleAbility.startBackgroundRunning
-
-startBackgroundRunning(id: number, request: NotificationRequest): Promise<void>
-
-**需要权限:** ohos.permission.KEEP_BACKGROUND_RUNNING
-
-**系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
-
-向系统申请长时任务，使用promise形式返回结果，建议使用新接口[backgroundTaskManager.startBackgroundRunning](js-apis-backgroundTaskManager.md#backgroundtaskmanagerstartbackgroundrunning8-1)。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| id | number | 是 | 长时任务通知id号 |
-| request | [NotificationRequest](js-apis-notification.md#notificationrequest) | 是 | 通知参数，用于显示通知栏的信息 |
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------------- | ------------------------- |
-| Promise\ | 使用Promise形式返回结果。 |
-
-**示例**：
-
-```js
-import notification from '@ohos.notification';
-import particleAbility from '@ohos.ability.particleAbility';
-import wantAgent from '@ohos.wantAgent';
-
-let wantAgentInfo = {
- wants: [
- {
- bundleName: "com.example.myapplication",
- abilityName: "com.example.myapplication.MainAbility"
- }
- ],
- operationType: wantAgent.OperationType.START_ABILITY,
- requestCode: 0,
- wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
-};
-
-wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
- let basicContent = {
- title: "title",
- text: "text"
- };
- let notificationContent = {
- contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
- normal: basicContent
- };
- let request = {
- content: notificationContent,
- wantAgent: wantAgentObj
- };
- let id = 1;
- particleAbility.startBackgroundRunning(id, request).then(() => {
- console.info("Operation succeeded");
- }).catch((err) => {
- console.error("Operation failed cause: " + JSON.stringify(err));
- });
-});
-
-```
-
-## particleAbility.cancelBackgroundRunning
-
-cancelBackgroundRunning(callback: AsyncCallback<void>): void;
-
-向系统申请取消长时任务，使用callback形式返回结果，建议使用新接口[backgroundTaskManager.stopBackgroundRunning](js-apis-backgroundTaskManager.md#backgroundtaskmanagerstopbackgroundrunning8)。
-
-**系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
-
- **参数：**
-
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<void> | 是 | callback形式返回启动长时任务的结果 |
-
- **示例**：
-
-```js
-import particleAbility from '@ohos.ability.particleAbility';
-
-function callback(err, data) {
- if (err) {
- console.error("Operation failed cause: " + JSON.stringify(err));
- } else {
- console.info("Operation succeeded");
- }
-}
-
-particleAbility.cancelBackgroundRunning(callback);
-
-```
-
-## particleAbility.cancelBackgroundRunning
-
-cancelBackgroundRunning(): Promise<void>;
-
-向系统申请取消长时任务，使用promise形式返回结果，建议使用新接口[backgroundTaskManager.stopBackgroundRunning](js-apis-backgroundTaskManager.md#backgroundtaskmanagerstopbackgroundrunning8-1)。
-
-**系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------------- | ------------------------- |
-| Promise\ | 使用Promise形式返回结果。 |
-
- **示例**：
-
-```js
-import particleAbility from '@ohos.ability.particleAbility';
-
-particleAbility.cancelBackgroundRunning().then(() => {
- console.info("Operation succeeded");
-}).catch((err) => {
- console.error("Operation failed cause: " + JSON.stringify(err));
-});
-
-```
-
-## particleAbility.connectAbility
-
-connectAbility(request: Want, options:ConnectOptions): number
-
-将当前ability连接到指定ServiceAbility（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| ------- | -------------- | ---- | ---------------------------- |
-| request | [Want](js-apis-application-Want.md) | 是 | 表示被连接的ServiceAbility。 |
-| options | ConnectOptions | 是 | 被指定的回调方法。 |
-
-
-**ConnectOptions类型说明：**
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
-
-| 参数名 | 读写属性 | 类型 | 必填 | 说明 |
-| ------------ | ---- | -------- | ---- | ------------------------- |
-| onConnect | 只读 | function | 是 | 连接成功时的回调函数。 |
-| onDisconnect | 只读 | function | 是 | 连接失败时的回调函数。 |
-| onFailed | 只读 | function | 是 | ConnectAbility调用失败时的回调函数。 |
-
-**示例**：
-
-```js
-import rpc from '@ohos.rpc'
-
-function onConnectCallback(element, remote) {
- console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
-}
-
-function onDisconnectCallback(element) {
- console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
-}
-
-function onFailedCallback(code) {
- console.log('particleAbilityTest ConnectAbility onFailed errCode : ' + code)
-}
-
-var connId = particleAbility.connectAbility(
- {
- bundleName: "com.ix.ServiceAbility",
- abilityName: "ServiceAbilityA",
- },
- {
- onConnect: onConnectCallback,
- onDisconnect: onDisconnectCallback,
- onFailed: onFailedCallback,
- },
-);
-
-particleAbility.disconnectAbility(connId).then((data) => {
- console.log(" data: " + data);
-}).catch((error) => {
- console.log('particleAbilityTest result errCode : ' + error.code)
-});
-
-```
-
-## particleAbility.disconnectAbility
-
-disconnectAbility(connection: number, callback:AsyncCallback\): void;
-
-将功能与服务功能断开连接。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**参数：**
-
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<void> | 是 | callback形式返回断开连接的结果 |
-
-**示例**：
-
-```js
-import rpc from '@ohos.rpc'
-
-function onConnectCallback(element, remote) {
- console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
-}
-
-function onDisconnectCallback(element) {
- console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
-}
-
-function onFailedCallback(code) {
- console.log('particleAbilityTest ConnectAbility onFailed errCode : ' + code)
-}
-
-var connId = particleAbility.connectAbility(
- {
- bundleName: "com.ix.ServiceAbility",
- abilityName: "ServiceAbilityA",
- },
- {
- onConnect: onConnectCallback,
- onDisconnect: onDisconnectCallback,
- onFailed: onFailedCallback,
- },
-);
-var result = particleAbility.disconnectAbility(connId).then((data) => {
- console.log(" data: " + data);
-}).catch((error) => {
- console.log('particleAbilityTest result errCode : ' + error.code)
-});
-```
-
-
-## particleAbility.disconnectAbility
-
-disconnectAbility(connection: number): Promise\;
-
-将功能与服务功能断开连接。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------------- | ------------------------- |
-| Promise\ | 使用Promise形式返回结果。 |
-
-**示例**：
-
-```js
-import rpc from '@ohos.rpc'
-
-function onConnectCallback(element, remote) {
- console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
-}
-
-function onDisconnectCallback(element) {
- console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
-}
-
-function onFailedCallback(code) {
- console.log('particleAbilityTest ConnectAbility onFailed errCode : ' + code)
-}
-
-var connId = particleAbility.connectAbility(
- {
- bundleName: "com.ix.ServiceAbility",
- abilityName: "ServiceAbilityA",
- },
- {
- onConnect: onConnectCallback,
- onDisconnect: onDisconnectCallback,
- onFailed: onFailedCallback,
- },
-);
-
-particleAbility.disconnectAbility(connId).then((data) => {
- console.log(" data: " + data);
-}).catch((error) => {
- console.log('particleAbilityTest result errCode : ' + error.code)
-});
-
-```
-
-## ErrorCode
-
-获取错误代码。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
-
-| 名称 | 值 | 说明 |
-| ----------------------------- | ---- | ------------------------------------------------------------ |
-| INVALID_PARAMETER | -1 | 无效的参数。 |
-
-
-
-
-
-
-
-
-
+# particleAbility模块
+
+particleAbility模块提供了Service类型Ability的能力，包括启动、停止指定的particleAbility，获取dataAbilityHelper，连接、断开当前Ability与指定ServiceAbility等。
+
+> **说明：**
+>
+> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块接口仅可在FA模型下使用。
+
+## 使用限制
+
+particleAbility模块用来对Data和Service类型的Ability进行操作。
+
+## 导入模块
+
+```ts
+import particleAbility from '@ohos.ability.particleAbility'
+```
+
+## particleAbility.startAbility
+
+startAbility(parameter: StartAbilityParameter, callback: AsyncCallback\): void
+
+使用此方法启动指定的particleAbility（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| --------- | ----------------------------------------------- | ---- | ----------------- |
+| parameter | [StartAbilityParameter](js-apis-inner-ability-startAbilityParameter.md) | 是 | 指示启动的ability |
+| callback | AsyncCallback\ | 是 | 被指定的回调方法 |
+
+**示例：**
+
+```ts
+import particleAbility from '@ohos.ability.particleAbility'
+import wantConstant from '@ohos.ability.wantConstant'
+
+particleAbility.startAbility(
+ {
+ want:
+ {
+ action: "action.system.home",
+ entities: ["entity.system.home"],
+ type: "MIMETYPE",
+ flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
+ deviceId: "",
+ bundleName: "com.example.Data",
+ abilityName: "com.example.Data.MainAbility",
+ uri: ""
+ },
+ },
+ (error, result) => {
+ console.log('particleAbility startAbility errCode:' + error + 'result:' + result)
+ },
+)
+```
+
+## particleAbility.startAbility
+
+startAbility(parameter: StartAbilityParameter): Promise\;
+
+使用此方法启动指定的particleAbility（Promise形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| --------- | ----------------------------------------------- | ---- | ----------------- |
+| parameter | [StartAbilityParameter](js-apis-inner-ability-startAbilityParameter.md) | 是 | 指示启动的ability |
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------------- | ------------------------- |
+| Promise\ | 使用Promise形式返回结果。 |
+
+**示例：**
+
+```ts
+import particleAbility from '@ohos.ability.particleAbility'
+import wantConstant from '@ohos.ability.wantConstant'
+
+particleAbility.startAbility(
+ {
+ want:
+ {
+ action: "action.system.home",
+ entities: ["entity.system.home"],
+ type: "MIMETYPE",
+ flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
+ deviceId: "",
+ bundleName: "com.example.Data",
+ abilityName: "com.example. Data.MainAbility",
+ uri: ""
+ },
+ },
+).then((data) => {
+ console.info("particleAbility startAbility");
+});
+```
+
+## particleAbility.terminateSelf
+
+terminateSelf(callback: AsyncCallback\): void
+
+终止particleAbility（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------------- | ---- | -------------------- |
+| callback | AsyncCallback\ | 是 | 表示被指定的回调方法 |
+
+**示例：**
+
+```ts
+import particleAbility from '@ohos.ability.particleAbility'
+
+particleAbility.terminateSelf(
+ (error, result) => {
+ console.log('particleAbility terminateSelf errCode:' + error + 'result:' + result)
+ }
+)
+```
+
+## particleAbility.terminateSelf
+
+terminateSelf(): Promise\
+
+终止particleAbility（Promise形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------------- | ------------------------- |
+| Promise\ | 使用Promise形式返回结果。 |
+
+**示例：**
+
+```ts
+import particleAbility from '@ohos.ability.particleAbility'
+
+particleAbility.terminateSelf().then((data) => {
+ console.info("particleAbility terminateSelf");
+});
+```
+
+
+
+## particleAbility.acquireDataAbilityHelper
+
+acquireDataAbilityHelper(uri: string): DataAbilityHelper
+
+获取dataAbilityHelper。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| :--- | ------ | ---- | ------------------------ |
+| uri | string | 是 | 指示要打开的文件的路径。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------------- | -------------------------------------------- |
+| DataAbilityHelper | 用来协助其他Ability访问DataAbility的工具类。 |
+
+**示例：**
+
+```ts
+import particleAbility from '@ohos.ability.particleAbility'
+
+var uri = "";
+particleAbility.acquireDataAbilityHelper(uri)
+```
+
+
+## particleAbility.startBackgroundRunning
+
+startBackgroundRunning(id: number, request: NotificationRequest, callback: AsyncCallback<void>): void;
+
+向系统申请长时任务，使用callback形式返回结果，建议使用新接口[backgroundTaskManager.startBackgroundRunning](js-apis-backgroundTaskManager.md#backgroundtaskmanagerstartbackgroundrunning8)。
+
+**需要权限:** ohos.permission.KEEP_BACKGROUND_RUNNING
+
+**系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | id | number | 是 | 长时任务通知id号 |
+ | request | [NotificationRequest](js-apis-notification.md#notificationrequest) | 是 | 通知参数，用于显示通知栏的信息 |
+ | callback | AsyncCallback<void> | 是 | callback形式返回启动长时任务的结果 |
+
+ **示例**：
+
+```ts
+import notification from '@ohos.notification';
+import particleAbility from '@ohos.ability.particleAbility';
+import wantAgent from '@ohos.wantAgent';
+
+function callback(err, data) {
+ if (err) {
+ console.error("Operation failed cause: " + JSON.stringify(err));
+ } else {
+ console.info("Operation succeeded");
+ }
+}
+
+let wantAgentInfo = {
+ wants: [
+ {
+ bundleName: "com.example.myapplication",
+ abilityName: "com.example.myapplication.MainAbility"
+ }
+ ],
+ operationType: wantAgent.OperationType.START_ABILITY,
+ requestCode: 0,
+ wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
+};
+
+wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
+ let basicContent = {
+ title: "title",
+ text: "text"
+ };
+ let notificationContent = {
+ contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
+ normal: basicContent
+ };
+ let request = {
+ content: notificationContent,
+ wantAgent: wantAgentObj
+ };
+ let id = 1;
+ particleAbility.startBackgroundRunning(id, request, callback);
+});
+
+```
+
+## particleAbility.startBackgroundRunning
+
+startBackgroundRunning(id: number, request: NotificationRequest): Promise<void>
+
+**需要权限:** ohos.permission.KEEP_BACKGROUND_RUNNING
+
+**系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
+
+向系统申请长时任务，使用promise形式返回结果，建议使用新接口[backgroundTaskManager.startBackgroundRunning](js-apis-backgroundTaskManager.md#backgroundtaskmanagerstartbackgroundrunning8-1)。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| id | number | 是 | 长时任务通知id号 |
+| request | [NotificationRequest](js-apis-notification.md#notificationrequest) | 是 | 通知参数，用于显示通知栏的信息 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------------- | ------------------------- |
+| Promise\ | 使用Promise形式返回结果。 |
+
+**示例**：
+
+```ts
+import notification from '@ohos.notification';
+import particleAbility from '@ohos.ability.particleAbility';
+import wantAgent from '@ohos.wantAgent';
+
+let wantAgentInfo = {
+ wants: [
+ {
+ bundleName: "com.example.myapplication",
+ abilityName: "com.example.myapplication.MainAbility"
+ }
+ ],
+ operationType: wantAgent.OperationType.START_ABILITY,
+ requestCode: 0,
+ wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
+};
+
+wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
+ let basicContent = {
+ title: "title",
+ text: "text"
+ };
+ let notificationContent = {
+ contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
+ normal: basicContent
+ };
+ let request = {
+ content: notificationContent,
+ wantAgent: wantAgentObj
+ };
+ let id = 1;
+ particleAbility.startBackgroundRunning(id, request).then(() => {
+ console.info("Operation succeeded");
+ }).catch((err) => {
+ console.error("Operation failed cause: " + JSON.stringify(err));
+ });
+});
+
+```
+
+## particleAbility.cancelBackgroundRunning
+
+cancelBackgroundRunning(callback: AsyncCallback<void>): void;
+
+向系统申请取消长时任务，使用callback形式返回结果，建议使用新接口[backgroundTaskManager.stopBackgroundRunning](js-apis-backgroundTaskManager.md#backgroundtaskmanagerstopbackgroundrunning8)。
+
+**系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
+
+ **参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | callback | AsyncCallback<void> | 是 | callback形式返回启动长时任务的结果 |
+
+ **示例**：
+
+```ts
+import particleAbility from '@ohos.ability.particleAbility';
+
+function callback(err, data) {
+ if (err) {
+ console.error("Operation failed cause: " + JSON.stringify(err));
+ } else {
+ console.info("Operation succeeded");
+ }
+}
+
+particleAbility.cancelBackgroundRunning(callback);
+
+```
+
+## particleAbility.cancelBackgroundRunning
+
+cancelBackgroundRunning(): Promise<void>;
+
+向系统申请取消长时任务，使用promise形式返回结果，建议使用新接口[backgroundTaskManager.stopBackgroundRunning](js-apis-backgroundTaskManager.md#backgroundtaskmanagerstopbackgroundrunning8-1)。
+
+**系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------------- | ------------------------- |
+| Promise\ | 使用Promise形式返回结果。 |
+
+ **示例**：
+
+```ts
+import particleAbility from '@ohos.ability.particleAbility';
+
+particleAbility.cancelBackgroundRunning().then(() => {
+ console.info("Operation succeeded");
+}).catch((err) => {
+ console.error("Operation failed cause: " + JSON.stringify(err));
+});
+
+```
+
+## particleAbility.connectAbility
+
+connectAbility(request: Want, options:ConnectOptions): number
+
+将当前ability连接到指定ServiceAbility（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------- | -------------- | ---- | ---------------------------- |
+| request | [Want](js-apis-application-want.md) | 是 | 表示被连接的ServiceAbility。 |
+| options | ConnectOptions | 是 | 被指定的回调方法。 |
+
+
+**ConnectOptions类型说明：**
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+| 参数名 | 读写属性 | 类型 | 必填 | 说明 |
+| ------------ | ---- | -------- | ---- | ------------------------- |
+| onConnect | 只读 | function | 是 | 连接成功时的回调函数。 |
+| onDisconnect | 只读 | function | 是 | 连接失败时的回调函数。 |
+| onFailed | 只读 | function | 是 | ConnectAbility调用失败时的回调函数。 |
+
+**示例**：
+
+```ts
+import rpc from '@ohos.rpc'
+
+function onConnectCallback(element, remote) {
+ console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
+}
+
+function onDisconnectCallback(element) {
+ console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
+}
+
+function onFailedCallback(code) {
+ console.log('particleAbilityTest ConnectAbility onFailed errCode : ' + code)
+}
+
+var connId = particleAbility.connectAbility(
+ {
+ bundleName: "com.ix.ServiceAbility",
+ abilityName: "ServiceAbilityA",
+ },
+ {
+ onConnect: onConnectCallback,
+ onDisconnect: onDisconnectCallback,
+ onFailed: onFailedCallback,
+ },
+);
+
+particleAbility.disconnectAbility(connId).then((data) => {
+ console.log(" data: " + data);
+}).catch((error) => {
+ console.log('particleAbilityTest result errCode : ' + error.code)
+});
+
+```
+
+## particleAbility.disconnectAbility
+
+disconnectAbility(connection: number, callback:AsyncCallback\): void;
+
+将功能与服务功能断开连接。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | callback | AsyncCallback<void> | 是 | callback形式返回断开连接的结果 |
+
+**示例**：
+
+```ts
+import rpc from '@ohos.rpc'
+
+function onConnectCallback(element, remote) {
+ console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
+}
+
+function onDisconnectCallback(element) {
+ console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
+}
+
+function onFailedCallback(code) {
+ console.log('particleAbilityTest ConnectAbility onFailed errCode : ' + code)
+}
+
+var connId = particleAbility.connectAbility(
+ {
+ bundleName: "com.ix.ServiceAbility",
+ abilityName: "ServiceAbilityA",
+ },
+ {
+ onConnect: onConnectCallback,
+ onDisconnect: onDisconnectCallback,
+ onFailed: onFailedCallback,
+ },
+);
+var result = particleAbility.disconnectAbility(connId).then((data) => {
+ console.log(" data: " + data);
+}).catch((error) => {
+ console.log('particleAbilityTest result errCode : ' + error.code)
+});
+```
+
+
+## particleAbility.disconnectAbility
+
+disconnectAbility(connection: number): Promise\;
+
+将功能与服务功能断开连接。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------------- | ------------------------- |
+| Promise\ | 使用Promise形式返回结果。 |
+
+**示例**：
+
+```ts
+import rpc from '@ohos.rpc'
+
+function onConnectCallback(element, remote) {
+ console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
+}
+
+function onDisconnectCallback(element) {
+ console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
+}
+
+function onFailedCallback(code) {
+ console.log('particleAbilityTest ConnectAbility onFailed errCode : ' + code)
+}
+
+var connId = particleAbility.connectAbility(
+ {
+ bundleName: "com.ix.ServiceAbility",
+ abilityName: "ServiceAbilityA",
+ },
+ {
+ onConnect: onConnectCallback,
+ onDisconnect: onDisconnectCallback,
+ onFailed: onFailedCallback,
+ },
+);
+
+particleAbility.disconnectAbility(connId).then((data) => {
+ console.log(" data: " + data);
+}).catch((error) => {
+ console.log('particleAbilityTest result errCode : ' + error.code)
+});
+
+```
+
+## ErrorCode
+
+获取错误代码。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel
+
+| 名称 | 值 | 说明 |
+| ----------------------------- | ---- | ------------------------------------------------------------ |
+| INVALID_PARAMETER | -1 | 无效的参数。 |
+
+
+
+
+
+
+
+
+
diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md b/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
index f59251079e3feb37f06349cfe2646bb8cde16168..f38f18bb47d632cc24fb8aa484dd13c5602a5dea 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
@@ -8,7 +8,7 @@ wantConstant模块提供want中操作want常数和解释Flags说明的能力。
## 导入模块
-```js
+```ts
import wantConstant from '@ohos.ability.wantConstant';
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-Want.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-Want.md
deleted file mode 100644
index 1abcd1c631adf66ec00cee8af6409b7935cd03ba..0000000000000000000000000000000000000000
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-Want.md
+++ /dev/null
@@ -1,67 +0,0 @@
-# Want
-
-Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为startAbility的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据, 如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当Ability A需要启动Ability B并传入一些数据时, 可使用Want作为载体将这些数据传递给Ability B。
-
-> **说明：**
->
-> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
-
-| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 |
-| ----------- | -------- |-------- | -------------------- | ---- | ------------------------------------------------------------ |
-| deviceId | 是 | 否 | string | 否 | 表示运行指定Ability的设备ID。 |
-| bundleName | 是 | 否 | string | 否 | 表示包名。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 |
-| abilityName | 是 | 否 | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 |
-| uri | 是 | 否 | string | 否 | 表示Uri。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme, schemeSpecificPart, authority和path信息。 |
-| type | 是 | 否 | string | 否 | 表示MIME type类型，打开文件的类型，主要用于文管打开文件。比如："text/xml" 、 "image/*"等，MIME定义参考：https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。 |
-| flags | 是 | 否 | number | 否 | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-featureAbility.md#flags说明)。 |
-| action | 是 | 否 | string | 否 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。 |
-| parameters | 是 | 否 | {[key: string]: any} | 否 | 表示WantParams，由开发者自行决定传入的键值对。默认会携带以下key值：
ohos.aafwk.callerPid 表示拉起方的pid。
ohos.aafwk.param.callerToken 表示拉起方的token。
ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。 |
-| entities | 是 | 否 | Array\ | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 |
-| moduleName9+ | 是 | 否 | string | 否 | 表示待启动的Ability所属的模块（module）。 |
-
-具体字段描述参考ability/want.d.ts文件
-
-**示例：**
-
-- 基础用法
-
- ``` ts
- var want = {
- "deviceId": "", // deviceId为空表示本设备
- "bundleName": "com.extreme.test",
- "abilityName": "MainAbility",
- "moduleName": "entry" // moduleName非必选
- };
- this.context.startAbility(want, (error) => {
- // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
- console.log("error.code = " + error.code)
- })
- ```
-
-- 传递FD数据，FD表示文件描述符(FileDescriptor)
-
- ``` ts
- import fileio from '@ohos.fileio';
- var fd;
- try {
- fd = fileio.openSync("/data/storage/el2/base/haps/pic.png");
- } catch(e) {
- console.log("openSync fail:" + JSON.stringify(e));
- }
- var want = {
- "deviceId": "", // deviceId为空表示本设备
- "bundleName": "com.extreme.test",
- "abilityName": "MainAbility",
- "moduleName": "entry", // moduleName非必选
- "parameters": {
- "keyFd":{"type":"FD", "value":fd}
- }
- };
- this.context.startAbility(want, (error) => {
- // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
- console.log("error.code = " + error.code)
- })
- ```
-
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-ability.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-ability.md
new file mode 100644
index 0000000000000000000000000000000000000000..dcd745df9f0a802c2b69d23e6b5d3c703a1eefb9
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-ability.md
@@ -0,0 +1,62 @@
+# Ability
+
+Ability模块提供对Ability生命周期、上下文环境等调用管理的能力，包括Ability创建、销毁、转储客户端信息等。
+
+> **说明：**
+>
+> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块接口仅可在Stage模型下使用。
+
+## 导入模块
+
+```ts
+import Ability from '@ohos.app.ability.Ability';
+```
+
+## Ability.onConfigurationUpdated
+
+onConfigurationUpdated(config: Configuration): void;
+
+当系统配置更新时调用。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 表示需要更新的配置信息。 |
+
+**示例：**
+
+ ```ts
+ class myAbility extends Ability {
+ onConfigurationUpdated(config) {
+ console.log('onConfigurationUpdated, config:' + JSON.stringify(config));
+ }
+ }
+ ```
+
+## Ability.onMemoryLevel
+
+onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
+
+当系统已决定调整内存时调用。例如，当该功能在后台运行时，没有足够的内存来运行尽可能多的后台进程时可以使用。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | level | [AbilityConstant.MemoryLevel](js-apis-app-ability-abilityConstant.md#abilityconstantmemorylevel) | 是 | 回调返回内存微调级别，显示当前内存使用状态。|
+
+**示例：**
+
+ ```ts
+ class myAbility extends Ability {
+ onMemoryLevel(level) {
+ console.log('onMemoryLevel, level:' + JSON.stringify(level));
+ }
+ }
+ ```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
index 176430808dbc106d85134a96b18fd719fd21d606..7f78b6a5df8a8a315c2e581c7b8a28468e7821d0 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
@@ -11,7 +11,7 @@ AbilityConstant提供启动参数的接口的能力，包括设置初次开始
## 导入模块
-```js
+```ts
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegator.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegator.md
index 7c6c02ee8355aafe62c89bb0d7860b9a20bfe8e7..17c1632822c178865d8598062ef9f959e049d6db 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegator.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegator.md
@@ -9,7 +9,7 @@ AbilityDelegator提供添加用于监视指定ability的生命周期状态更改
## 使用说明
通过AbilityDelegatorRegistry中getAbilityDelegator方法获取。
-```js
+```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'
var abilityDelegator;
@@ -37,7 +37,7 @@ addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\): void
**示例：**
-```js
+```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
@@ -79,7 +79,7 @@ addAbilityMonitor(monitor: AbilityMonitor): Promise\
**示例：**
-```js
+```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
@@ -116,7 +116,7 @@ removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\): v
**示例：**
-```js
+```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
@@ -158,7 +158,7 @@ removeAbilityMonitor(monitor: AbilityMonitor): Promise\
- 示例
-```js
+```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
@@ -195,7 +195,7 @@ waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\):
**示例：**
-```js
+```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
@@ -233,7 +233,7 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCall
**示例：**
-```js
+```ts
var abilityDelegator;
var timeout = 100;
@@ -277,7 +277,7 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise\
**示例：**
-```js
+```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
@@ -309,11 +309,11 @@ getAppContext(): Context
| 类型 | 说明 |
| ------------------------------------- | ------------------------------------------- |
-| [Context](js-apis-Context.md#Context) | 应用[Context](js-apis-Context.md#Context)。 |
+| [Context](js-apis-inner-application-context.md) | 应用[Context](js-apis-inner-application-context.md)。 |
**示例：**
-```js
+```ts
var abilityDelegator;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
@@ -340,11 +340,11 @@ getAbilityState(ability: Ability): number
| 类型 | 说明 |
| ------ | ------------------------------------------------------------ |
-| number | 指定ability的生命周期状态。状态枚举值使用[AbilityLifecycleState](js-apis-abilityDelegatorRegistry.md#AbilityLifecycleState)。 |
+| number | 指定ability的生命周期状态。状态枚举值使用[AbilityLifecycleState](js-apis-application-abilityDelegatorRegistry.md#AbilityLifecycleState)。 |
**示例：**
-```js
+```ts
var abilityDelegator;
var ability;
@@ -375,7 +375,7 @@ getCurrentTopAbility(callback: AsyncCallback\): void
**示例：**
-```js
+```ts
var abilityDelegator;
var ability;
@@ -404,7 +404,7 @@ getCurrentTopAbility(): Promise\
**示例：**
-```js
+```ts
var abilityDelegator;
var ability;
@@ -429,12 +429,12 @@ startAbility(want: Want, callback: AsyncCallback\): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------- | ---- | ------------------ |
-| want | [Want](js-apis-app-ability-Want.md) | 是 | 启动Ability参数 |
+| want | [Want](js-apis-app-ability-want.md) | 是 | 启动Ability参数 |
| callback | AsyncCallback\ | 是 | 表示指定的回调方法 |
**示例：**
-```js
+```ts
var abilityDelegator;
var want = {
bundleName: "bundleName",
@@ -461,7 +461,7 @@ startAbility(want: Want): Promise\
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------------------------------- | ---- | --------------- |
-| want | [Want](js-apis-app-ability-Want.md) | 是 | 启动Ability参数 |
+| want | [Want](js-apis-app-ability-want.md) | 是 | 启动Ability参数 |
**返回值：**
@@ -471,7 +471,7 @@ startAbility(want: Want): Promise\
**示例：**
-```js
+```ts
var abilityDelegator;
var want = {
bundleName: "bundleName",
@@ -503,7 +503,7 @@ doAbilityForeground(ability: Ability, callback: AsyncCallback\): void
**示例：**
-```js
+```ts
var abilityDelegator;
var ability;
@@ -541,7 +541,7 @@ doAbilityForeground(ability: Ability): Promise\
**示例：**
-```js
+```ts
var abilityDelegator;
var ability;
@@ -574,7 +574,7 @@ doAbilityBackground(ability: Ability, callback: AsyncCallback\): void
**示例：**
-```js
+```ts
var abilityDelegator;
var ability;
@@ -612,7 +612,7 @@ doAbilityBackground(ability: Ability): Promise\
**示例：**
-```js
+```ts
var abilityDelegator;
var ability;
@@ -644,7 +644,7 @@ printSync(msg: string): void
**示例：**
-```js
+```ts
var abilityDelegator;
var msg = "msg";
@@ -671,7 +671,7 @@ print(msg: string, callback: AsyncCallback\): void
**示例：**
-```js
+```ts
var abilityDelegator;
var msg = "msg";
@@ -705,7 +705,7 @@ print(msg: string): Promise\
**示例：**
-```js
+```ts
var abilityDelegator;
var msg = "msg";
@@ -730,11 +730,11 @@ executeShellCommand(cmd: string, callback: AsyncCallback\): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------ |
| cmd | string | 是 | shell命令字符串 |
-| callback | AsyncCallback\<[ShellCmdResult](js-apis-application-shellCmdResult.md#ShellCmdResult)> | 是 | 表示指定的回调方法 |
+| callback | AsyncCallback\<[ShellCmdResult](js-apis-inner-application-shellCmdResult.md)> | 是 | 表示指定的回调方法 |
**示例：**
-```js
+```ts
var abilityDelegator;
var cmd = "cmd";
@@ -760,11 +760,11 @@ executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\ | 是 | 表示指定的回调方法 |
+| callback | AsyncCallback\<[ShellCmdResult](js-apis-inner-application-shellCmdResult.md)> | 是 | 表示指定的回调方法 |
**示例：**
-```js
+```ts
var abilityDelegator;
var cmd = "cmd";
var timeout = 100;
@@ -796,11 +796,11 @@ executeShellCommand(cmd: string, timeoutSecs?: number): Promise\
| 类型 | 说明 |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
-| Promise\<[ShellCmdResult](js-apis-application-shellCmdResult.md#ShellCmdResult)> | 以Promise形式返回Shell命令执行结果[ShellCmdResult](js-apis-application-shellCmdResult.md#ShellCmdResult)对象。 |
+| Promise\<[ShellCmdResult](js-apis-inner-application-shellCmdResult.md)> | 以Promise形式返回Shell命令执行结果[ShellCmdResult](js-apis-inner-application-shellCmdResult.md)对象。 |
**示例：**
-```js
+```ts
var abilityDelegator;
var cmd = "cmd";
var timeout = 100;
@@ -831,7 +831,7 @@ finishTest(msg: string, code: number, callback: AsyncCallback\): void
**示例：**
-```js
+```ts
var abilityDelegator;
var msg = "msg";
@@ -866,7 +866,7 @@ finishTest(msg: string, code: number): Promise\
**示例：**
-```js
+```ts
var abilityDelegator;
var msg = "msg";
@@ -893,7 +893,7 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\;
**示例：**
-```js
+```ts
var abilityDelegator;
var monitor = {
@@ -962,7 +962,7 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\
**示例：**
-```js
+```ts
var abilityDelegator;
var monitor = {
@@ -1000,7 +1000,7 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\;
**示例：**
-```js
+```ts
var abilityDelegator;
var monitor = {
@@ -1031,7 +1031,7 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\ **说明：**
+>
+> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+
+## 导入模块
+
+```ts
+import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'
+```
+
+## AbilityLifecycleState
+
+Ability生命周期状态。
+
+**系统能力** ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+| 名称 | 值 | 说明 |
+| ------------- | ---- | --------------------------- |
+| UNINITIALIZED | 0 | 表示无效状态。 |
+| CREATE | 1 | 表示Ability处于已创建状态。 |
+| FOREGROUND | 2 | 表示Ability处于前台状态。 |
+| BACKGROUND | 3 | 表示Ability处于后台状态。 |
+| DESTROY | 4 | 表示Ability处于已销毁状态。 |
+
+## AbilityDelegatorRegistry.getAbilityDelegator
+
+getAbilityDelegator(): AbilityDelegator
+
+获取应用程序的AbilityDelegator对象
+
+**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+| 类型 | 说明 |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| [AbilityDelegator](js-apis-inner-application-abilityDelegator.md#AbilityDelegator) | [AbilityDelegator](js-apis-inner-application-abilityDelegator.md#AbilityDelegator)对象。可以用来调度测试框架相关功能。 |
+
+**示例：**
+
+```ts
+var abilityDelegator;
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+```
+
+## AbilityDelegatorRegistry.getArguments
+
+getArguments(): AbilityDelegatorArgs
+
+获取单元测试参数AbilityDelegatorArgs对象
+
+**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+| 类型 | 说明 |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| [AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md) | [AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md)对象。可以用来获取测试参数。 |
+
+**示例：**
+
+```ts
+var args = AbilityDelegatorRegistry.getArguments();
+console.info("getArguments bundleName:" + args.bundleName);
+console.info("getArguments testCaseNames:" + args.testCaseNames);
+console.info("getArguments testRunnerClassName:" + args.testRunnerClassName);
+```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md
index e2cc4c4bbc6d582b4dd42d905f5e71d98209f799..4ef2992fad4b4f2e000512fbb86105fffc9cb617 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md
@@ -10,7 +10,7 @@ AbilityLifecycleCallback模块提供应用上下文ApplicationContext的生命
## 导入模块
-```js
+```ts
import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback";
```
@@ -156,7 +156,7 @@ onAbilityContinue(ability: Ability): void;
**示例：**
- ```js
+ ```ts
import Ability from "@ohos.application.Ability";
export default class MyAbility extends Ability {
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
index f88bb99df81b2d6c7fb0420b51557010dd5c6c49..d5be1795d209d5b13979e8bb1a903fc09f14e3c7 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
@@ -9,7 +9,7 @@ AbilityManager模块提供对Ability相关信息和状态信息进行获取、
## 导入模块
-```js
+```ts
import AbilityManager from '@ohos.app.ability.abilityManager'
```
@@ -48,7 +48,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\): void
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.app.ability.abilityManager';
var config = {
@@ -89,7 +89,7 @@ updateConfiguration(config: Configuration): Promise\
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.app.ability.abilityManager';
var config = {
@@ -126,7 +126,7 @@ getAbilityRunningInfos(callback: AsyncCallback\>): vo
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.app.ability.abilityManager';
try {
@@ -157,7 +157,7 @@ getAbilityRunningInfos(): Promise\>
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.app.ability.abilityManager';
try {
@@ -191,7 +191,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\): void;
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.app.ability.abilityManager';
try {
@@ -292,7 +292,7 @@ getTopAbility(): Promise\;
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.app.ability.abilityManager';
try {
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityMonitor.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityMonitor.md
index fcb0cad63f457c37b34f3bec78279a41ca60d269..fb42a774cde5684b3448f5fe36dfefb119f3c723 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityMonitor.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityMonitor.md
@@ -10,7 +10,7 @@ AbilityMonitor模块提供匹配满足指定条件的受监视能力对象的方
通过abilityDelegator中的addAbilityMonitor来设置。
-```js
+```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'
var abilityDelegator;
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilitystage.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md
similarity index 82%
rename from zh-cn/application-dev/reference/apis/js-apis-app-ability-abilitystage.md
rename to zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md
index 0863a4a46a1e98ca5cddf4fa5adcce74d866fc91..5a8bdfce407d25923433354df3240dc56ec391b2 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilitystage.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md
@@ -2,16 +2,16 @@
AbilityStage是HAP包的运行时类。
-AbilityStage模块提供在HAP加载的时候，通知开发者，可以在此进行该HAP的初始化（如资源预加载，线程创建等）能力。
+AbilityStage类提供在HAP加载的时候，通知开发者，可以在此进行该HAP的初始化（如资源预加载，线程创建等）能力。
> **说明：**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-## 导入模块
+## 导入类
-```js
+```ts
import AbilityStage from '@ohos.app.ability.AbilityStage';
```
@@ -25,7 +25,7 @@ onCreate(): void
**示例：**
- ```js
+ ```ts
class MyAbilityStage extends AbilityStage {
onCreate() {
console.log("MyAbilityStage.onCreate is called")
@@ -46,7 +46,7 @@ onAcceptWant(want: Want): string;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | want | [Want](js-apis-application-Want.md) | 是 | Want类型参数，传入需要启动的ability的信息，如ability名称，包名等。 |
+ | want | [Want](js-apis-app-ability-want.md) | 是 | Want类型参数，传入需要启动的ability的信息，如ability名称，包名等。 |
**返回值：**
@@ -56,7 +56,7 @@ onAcceptWant(want: Want): string;
**示例：**
- ```js
+ ```ts
class MyAbilityStage extends AbilityStage {
onAcceptWant(want) {
console.log("MyAbilityStage.onAcceptWant called");
@@ -78,11 +78,11 @@ onConfigurationUpdated(config: Configuration): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | config | [Configuration](js-apis-configuration.md) | 是 | 发生全局配置变更时触发回调，当前全局配置包括系统语言、深浅色模式。 |
+ | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 发生全局配置变更时触发回调，当前全局配置包括系统语言、深浅色模式。 |
**示例：**
- ```js
+ ```ts
class MyAbilityStage extends AbilityStage {
onConfigurationUpdated(config) {
console.log('onConfigurationUpdated, language:' + config.language);
@@ -102,11 +102,11 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | level | [AbilityConstant.MemoryLevel](js-apis-application-abilityConstant.md#abilityconstantmemorylevel) | 是 | 回调返回内存微调级别，显示当前内存使用状态。|
+ | level | [AbilityConstant.MemoryLevel](js-apis-app-ability-abilityConstant.md#abilityconstantmemorylevel) | 是 | 回调返回内存微调级别，显示当前内存使用状态。|
**示例：**
- ```js
+ ```ts
class MyAbilityStage extends AbilityStage {
onMemoryLevel(level) {
console.log('onMemoryLevel, level:' + JSON.stringify(level));
@@ -124,4 +124,4 @@ context: AbilityStageContext;
| 属性名 | 类型 | 说明 |
| ----------- | --------------------------- | ------------------------------------------------------------ |
-| context | [AbilityStageContext](js-apis-abilitystagecontext.md) | 在启动能力阶段进行初始化时回调。 |
+| context | [AbilityStageContext](js-apis-inner-application-abilityStageContext.md) | 在启动能力阶段进行初始化时回调。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md
new file mode 100644
index 0000000000000000000000000000000000000000..5705224c816e4bce54a334b847ee3fb5a2aebc4f
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md
@@ -0,0 +1,713 @@
+# appManager
+
+appManager模块提供App管理的能力，包括查询当前是否处于稳定性测试场景、查询是否为ram受限设备、获取应用程序的内存大小、获取有关运行进程的信息等。
+
+> **说明：**
+>
+> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+
+## 导入模块
+
+```ts
+import app from '@ohos.app.ability.appManager';
+```
+
+## appManager.isRunningInStabilityTest9+
+
+static isRunningInStabilityTest(callback: AsyncCallback<boolean>): void
+
+查询当前是否处于稳定性测试场景。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | callback | AsyncCallback<boolean> | 否 | 返回当前是否处于稳定性测试场景。 |
+
+**示例：**
+
+ ```ts
+ import app from '@ohos.application.appManager';
+ app.isRunningInStabilityTest((err, flag) => {
+ console.log('startAbility result:' + JSON.stringify(err));
+ })
+ ```
+
+
+## appManager.isRunningInStabilityTest9+
+
+static isRunningInStabilityTest(): Promise<boolean>
+
+查询当前是否处于稳定性测试场景。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+ | 类型 | 说明 |
+ | -------- | -------- |
+ | Promise<boolean> | 返回当前是否处于稳定性测试场景。 |
+
+**示例：**
+
+ ```ts
+ import app from '@ohos.application.appManager';
+ app.isRunningInStabilityTest().then((flag) => {
+ console.log('success:' + JSON.stringify(flag));
+ }).catch((error) => {
+ console.log('failed:' + JSON.stringify(error));
+ });
+ ```
+
+
+## appManager.isRamConstrainedDevice
+
+isRamConstrainedDevice(): Promise\;
+
+查询是否为ram受限设备。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+ | 类型 | 说明 |
+ | -------- | -------- |
+ | Promise<boolean> | 是否为ram受限设备。 |
+
+**示例：**
+
+ ```ts
+ app.isRamConstrainedDevice().then((data) => {
+ console.log('success:' + JSON.stringify(data));
+ }).catch((error) => {
+ console.log('failed:' + JSON.stringify(error));
+ });
+ ```
+
+## appManager.isRamConstrainedDevice
+
+isRamConstrainedDevice(callback: AsyncCallback\): void;
+
+查询是否为ram受限设备。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | callback | AsyncCallback<boolean> | 否 | 返回当前是否是ram受限设备。 |
+
+**示例：**
+
+ ```ts
+ app.isRamConstrainedDevice((err, data) => {
+ console.log('startAbility result failed:' + JSON.stringify(err));
+ console.log('startAbility result success:' + JSON.stringify(data));
+ })
+ ```
+
+## appManager.getAppMemorySize
+
+getAppMemorySize(): Promise\;
+
+获取应用程序的内存大小。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+ | 类型 | 说明 |
+ | -------- | -------- |
+ | Promise<number> | 应用程序内存大小。 |
+
+**示例：**
+
+ ```ts
+ app.getAppMemorySize().then((data) => {
+ console.log('success:' + JSON.stringify(data));
+ }).catch((error) => {
+ console.log('failed:' + JSON.stringify(error));
+ });
+ ```
+
+## appManager.getAppMemorySize
+
+getAppMemorySize(callback: AsyncCallback\): void;
+
+获取应用程序的内存大小。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | callback | AsyncCallback<number> | 否 | 应用程序内存大小。 |
+
+**示例：**
+
+ ```ts
+ app.getAppMemorySize((err, data) => {
+ console.log('startAbility result failed :' + JSON.stringify(err));
+ console.log('startAbility result success:' + JSON.stringify(data));
+ })
+ ```
+## appManager.getProcessRunningInfos(deprecated)
+
+getProcessRunningInfos(): Promise\>;
+
+获取有关运行进程的信息。
+
+> 从 API Version 9 开始废弃，建议使用[appManager.getProcessRunningInformation9+](#appmanagergetprocessrunninginformation9)替代。
+
+**需要权限**：ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------- | -------- |
+| Promise\> | 获取有关运行进程的信息。 |
+
+**示例：**
+
+ ```ts
+ app.getProcessRunningInfos().then((data) => {
+ console.log('success:' + JSON.stringify(data));
+ }).catch((error) => {
+ console.log('failed:' + JSON.stringify(error));
+ });
+ ```
+
+## appManager.getProcessRunningInfos(deprecated)
+
+getProcessRunningInfos(callback: AsyncCallback\>): void;
+
+获取有关运行进程的信息。
+
+> 从 API Version 9 开始废弃，建议使用[appManager.getProcessRunningInformation9+](#appmanagergetprocessrunninginformation9-1)替代。
+
+**需要权限**：ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| callback | AsyncCallback\> | 否 | 获取有关运行进程的信息。 |
+
+**示例：**
+
+ ```ts
+ app.getProcessRunningInfos((err, data) => {
+ console.log('startAbility result failed :' + JSON.stringify(err));
+ console.log('startAbility result success:' + JSON.stringify(data));
+ })
+ ```
+
+## appManager.getProcessRunningInformation9+
+
+getProcessRunningInformation(): Promise\>;
+
+获取有关运行进程的信息。
+
+**需要权限**：ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------- | -------- |
+| Promise\> | 获取有关运行进程的信息。 |
+
+**示例：**
+
+ ```ts
+ app.getProcessRunningInformation().then((data) => {
+ console.log('success:' + JSON.stringify(data));
+ }).catch((error) => {
+ console.log('failed:' + JSON.stringify(error));
+ });
+ ```
+
+## appManager.getProcessRunningInformation9+
+
+getProcessRunningInformation(callback: AsyncCallback\>): void;
+
+获取有关运行进程的信息。
+
+**需要权限**：ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| callback | AsyncCallback\> | 否 | 获取有关运行进程的信息。 |
+
+**示例：**
+
+ ```ts
+ app.getProcessRunningInformation((err, data) => {
+ console.log('startAbility result failed :' + JSON.stringify(err));
+ console.log('startAbility result success:' + JSON.stringify(data));
+ })
+ ```
+
+## appManager.registerApplicationStateObserver9+
+
+registerApplicationStateObserver(observer: ApplicationStateObserver): number;
+
+注册全部应用程序状态观测器。
+
+**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 否 | 返回观察者的数字代码。 |
+
+**示例：**
+
+ ```ts
+ var applicationStateObserver = {
+ onForegroundApplicationChanged(appStateData) {
+ console.log('------------ onForegroundApplicationChanged -----------', appStateData);
+ },
+ onAbilityStateChanged(abilityStateData) {
+ console.log('------------ onAbilityStateChanged -----------', abilityStateData);
+ },
+ onProcessCreated(processData) {
+ console.log('------------ onProcessCreated -----------', processData);
+ },
+ onProcessDied(processData) {
+ console.log('------------ onProcessDied -----------', processData);
+ },
+ onProcessStateChanged(processData) {
+ console.log('------------ onProcessStateChanged -----------', processData);
+ }
+ }
+ const observerCode = app.registerApplicationStateObserver(applicationStateObserver);
+ console.log('-------- observerCode: ---------', observerCode);
+ ```
+
+## appManager.registerApplicationStateObserver9+
+
+registerApplicationStateObserver(observer: ApplicationStateObserver, bundleNameList: Array\): number;
+
+注册指定应用程序状态观测器。
+
+**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 否 | 返回观察者的数字代码。 |
+| bundleNameList | Array | 否 | 表示需要注册监听的bundleName数组。最大值128。 |
+
+**示例：**
+
+ ```ts
+ var applicationStateObserver = {
+ onForegroundApplicationChanged(appStateData) {
+ console.log('------------ onForegroundApplicationChanged -----------', appStateData);
+ },
+ onAbilityStateChanged(abilityStateData) {
+ console.log('------------ onAbilityStateChanged -----------', abilityStateData);
+ },
+ onProcessCreated(processData) {
+ console.log('------------ onProcessCreated -----------', processData);
+ },
+ onProcessDied(processData) {
+ console.log('------------ onProcessDied -----------', processData);
+ },
+ onProcessStateChanged(processData) {
+ console.log('------------ onProcessStateChanged -----------', processData);
+ }
+ }
+ var bundleNameList = ['bundleName1', 'bundleName2'];
+ const observerCode = app.registerApplicationStateObserver(applicationStateObserver, bundleNameList);
+ console.log('-------- observerCode: ---------', observerCode);
+ ```
+## appManager.unregisterApplicationStateObserver9+
+
+unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\): void;
+
+取消注册应用程序状态观测器。
+
+**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| observerId | number | 否 | 表示观察者的编号代码。 |
+| callback | AsyncCallback\ | 否 | 表示指定的回调方法。 |
+
+**示例：**
+
+ ```ts
+ var observerId = 100;
+ function unregisterApplicationStateObserverCallback(err) {
+ if (err) {
+ console.log('------------ unregisterApplicationStateObserverCallback ------------', err);
+ }
+ }
+ app.unregisterApplicationStateObserver(observerId, unregisterApplicationStateObserverCallback);
+ ```
+
+## appManager.unregisterApplicationStateObserver9+
+
+unregisterApplicationStateObserver(observerId: number): Promise\;
+
+取消注册应用程序状态观测器。
+
+**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| observerId | number | 否 | 表示观察者的编号代码。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------- | -------- |
+| Promise\ | 返回执行结果。 |
+
+**示例：**
+
+ ```ts
+ var observerId = 100;
+ app.unregisterApplicationStateObserver(observerId)
+ .then((data) => {
+ console.log('----------- unregisterApplicationStateObserver success ----------', data);
+ })
+ .catch((err) => {
+ console.log('----------- unregisterApplicationStateObserver fail ----------', err);
+ })
+ ```
+
+## appManager.getForegroundApplications9+
+
+getForegroundApplications(callback: AsyncCallback\>): void;
+
+获取前台进程的应用程序。
+
+**需要权限**：ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| callback | AsyncCallback\> | 否 | 表示应用的状态数据。 |
+
+**示例：**
+
+ ```ts
+ function getForegroundApplicationsCallback(err, data) {
+ if (err) {
+ console.log('--------- getForegroundApplicationsCallback fail ---------', err);
+ } else {
+ console.log('--------- getForegroundApplicationsCallback success ---------', data)
+ }
+ }
+ app.getForegroundApplications(getForegroundApplicationsCallback);
+ ```
+
+## appManager.getForegroundApplications9+
+
+getForegroundApplications(): Promise\>;
+
+获取前台进程的应用程序。
+
+**需要权限**：ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------- | -------- |
+| Promise\> | 返回进程运行信息的数组。 |
+
+**示例：**
+
+ ```ts
+ app.getForegroundApplications()
+ .then((data) => {
+ console.log('--------- getForegroundApplications success -------', data);
+ })
+ .catch((err) => {
+ console.log('--------- getForegroundApplications fail -------', err);
+ })
+ ```
+
+## appManager.killProcessWithAccount9+
+
+killProcessWithAccount(bundleName: string, accountId: number): Promise\
+
+切断account进程（Promise形式）。
+
+**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | bundleName | string | 是 | 应用包名。 |
+ | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
+
+**示例：**
+
+```ts
+var bundleName = 'bundleName';
+var accountId = 0;
+app.killProcessWithAccount(bundleName, accountId)
+ .then((data) => {
+ console.log('------------ killProcessWithAccount success ------------', data);
+ })
+ .catch((err) => {
+ console.log('------------ killProcessWithAccount fail ------------', err);
+ })
+```
+
+
+## appManager.killProcessWithAccount9+
+
+killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCallback\): void
+
+切断account进程（callback形式）。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
+**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | bundleName | string | 是 | 应用包名。 |
+ | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
+ | callback | AsyncCallback\ | 是 | 切断account进程的回调函数。 |
+
+**示例：**
+
+```ts
+var bundleName = 'bundleName';
+var accountId = 0;
+function killProcessWithAccountCallback(err, data) {
+ if (err) {
+ console.log('------------- killProcessWithAccountCallback fail, err: --------------', err);
+ } else {
+ console.log('------------- killProcessWithAccountCallback success, data: --------------', data);
+ }
+}
+app.killProcessWithAccount(bundleName, accountId, killProcessWithAccountCallback);
+```
+
+## appManager.killProcessesByBundleName9+
+
+killProcessesByBundleName(bundleName: string, callback: AsyncCallback\);
+
+通过包名终止进程。
+
+**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| bundleName | string | 否 | 表示包名。 |
+| callback | AsyncCallback\ | 否 | 表示指定的回调方法。 |
+
+**示例：**
+
+ ```ts
+ var bundleName = 'bundleName';
+ function killProcessesByBundleNameCallback(err, data) {
+ if (err) {
+ console.log('------------- killProcessesByBundleNameCallback fail, err: --------------', err);
+ } else {
+ console.log('------------- killProcessesByBundleNameCallback success, data: --------------', data);
+ }
+ }
+ app.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback);
+ ```
+
+## appManager.killProcessesByBundleName9+
+
+killProcessesByBundleName(bundleName: string): Promise\;
+
+通过包名终止进程。
+
+**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| bundleName | string | 否 | 表示包名。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------- | -------- |
+| Promise\ | 返回执行结果。 |
+
+**示例：**
+
+ ```ts
+var bundleName = 'bundleName';
+app.killProcessesByBundleName(bundleName)
+ .then((data) => {
+ console.log('------------ killProcessesByBundleName success ------------', data);
+ })
+ .catch((err) => {
+ console.log('------------ killProcessesByBundleName fail ------------', err);
+ })
+ ```
+
+## appManager.clearUpApplicationData9+
+
+clearUpApplicationData(bundleName: string, callback: AsyncCallback\);
+
+通过包名清除应用数据。
+
+**需要权限**：ohos.permission.CLEAN_APPLICATION_DATA
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| bundleName | string | 否 | 表示包名。 |
+| callback | AsyncCallback\ | 否 | 表示指定的回调方法。 |
+
+**示例：**
+
+ ```ts
+ var bundleName = 'bundleName';
+ function clearUpApplicationDataCallback(err, data) {
+ if (err) {
+ console.log('------------- clearUpApplicationDataCallback fail, err: --------------', err);
+ } else {
+ console.log('------------- clearUpApplicationDataCallback success, data: --------------', data);
+ }
+ }
+ app.clearUpApplicationData(bundleName, clearUpApplicationDataCallback);
+ ```
+
+## appManager.clearUpApplicationData9+
+
+clearUpApplicationData(bundleName: string): Promise\;
+
+通过包名清除应用数据。
+
+**需要权限**：ohos.permission.CLEAN_APPLICATION_DATA
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| bundleName | string | 否 | 表示包名。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------- | -------- |
+| Promise\ | 返回执行结果。 |
+
+**示例：**
+
+ ```ts
+ var bundleName = 'bundleName';
+ app.clearUpApplicationData(bundleName)
+ .then((data) => {
+ console.log('------------ clearUpApplicationData success ------------', data);
+ })
+ .catch((err) => {
+ console.log('------------ clearUpApplicationData fail ------------', err);
+ })
+ ```
+
+## ApplicationState9+
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
+| 名称 | 值 | 描述 |
+| -------------------- | --- | --------------------------------- |
+| STATE_CREATE | 1 | 当应用在创建中的时候处于的状态。 |
+| STATE_FOREGROUND | 2 | 当应用切换到前台的时候处于的状态。 |
+| STATE_ACTIVE | 3 | 当应用在获焦的时候处于的状态。 |
+| STATE_BACKGROUND | 4 | 当应用处于后台不可见时处于的状态。 |
+| STATE_DESTROY | 5 | 当应用在销毁的时候处于的状态。 |
+
+## ProcessState9+
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
+| 名称 | 值 | 描述 |
+| -------------------- | --- | --------------------------------- |
+| STATE_CREATE | 1 | 当进程在创建中的时候处于的状态。 |
+| STATE_FOREGROUND | 2 | 当进程切换到前台的时候处于的状态。 |
+| STATE_ACTIVE | 3 | 当进程在获焦的时候处于的状态。 |
+| STATE_BACKGROUND | 4 | 当进程处于后台不可见时处于的状态。 |
+| STATE_DESTROY | 5 | 当进程在销毁的时候处于的状态。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md
index e29f2190aa95098b63ad6699b916776802bbf9bc..318a1d4b690207df73c2181e36d38c4682e56795 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md
@@ -7,7 +7,7 @@ appRecovery模块提供了应用在故障状态下的恢复能力。
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。当前版本仅支持单进程中单Ability的应用恢复。
## 导入模块
-```
+```ts
import appRecovery from '@ohos.app.ability.appRecovery'
```
@@ -78,7 +78,7 @@ export default class MyAbilityStage extends AbilityStage {
restartApp(): void;
-重启当前App进程，可以配合[errorManager](js-apis-errorManager.md#errorobserver)相关接口使用。
+重启当前App进程，可以配合[errorManager](js-apis-app-ability-errorManager.md)相关接口使用。
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
@@ -99,7 +99,7 @@ var observer = {
saveAppState(): boolean;
-保存当前App状态，可以配合[errorManager](js-apis-errorManager.md#errorobserver)相关接口使用
+保存当前App状态，可以配合[errorManager](js-apis-app-ability-errorManager.md)相关接口使用
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
@@ -118,5 +118,4 @@ var observer = {
appRecovery.saveAppState();
}
}
-
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appmanager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appmanager.md
deleted file mode 100644
index 0d7f113e580df601682bf836a141ce668d24a844..0000000000000000000000000000000000000000
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appmanager.md
+++ /dev/null
@@ -1,1010 +0,0 @@
-# appManager
-
-appManager模块提供App管理的能力，包括查询当前是否处于稳定性测试场景、查询是否为ram受限设备、获取应用程序的内存大小、获取有关运行进程的信息等。
-
-> **说明：**
->
-> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-
-## 导入模块
-
-```js
-import app from '@ohos.app.ability.appManager';
-```
-
-## appManager.isRunningInStabilityTest
-
-static isRunningInStabilityTest(callback: AsyncCallback<boolean>): void
-
-查询当前是否处于稳定性测试场景。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**参数：**
-
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<boolean> | 否 | 返回当前是否处于稳定性测试场景。 |
-
-**示例：**
-
- ```js
- import app from '@ohos.app.ability.appManager';
- app.isRunningInStabilityTest((err, flag) => {
- console.log('startAbility result:' + JSON.stringify(err));
- })
- ```
-
-
-## appManager.isRunningInStabilityTest
-
-static isRunningInStabilityTest(): Promise<boolean>
-
-查询当前是否处于稳定性测试场景。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**返回值：**
-
- | 类型 | 说明 |
- | -------- | -------- |
- | Promise<boolean> | 返回当前是否处于稳定性测试场景。 |
-
-**示例：**
-
- ```js
- import app from '@ohos.app.ability.appManager';
- app.isRunningInStabilityTest().then((flag) => {
- console.log('success:' + JSON.stringify(flag));
- }).catch((error) => {
- console.log('failed:' + JSON.stringify(err));
- });
- ```
-
-
-## appManager.isRamConstrainedDevice
-
-isRamConstrainedDevice(): Promise\;
-
-查询是否为ram受限设备。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**返回值：**
-
- | 类型 | 说明 |
- | -------- | -------- |
- | Promise<boolean> | 是否为ram受限设备。 |
-
-**示例：**
-
- ```js
- app.isRamConstrainedDevice().then((data) => {
- console.log('success:' + JSON.stringify(data));
- }).catch((error) => {
- console.log('failed:' + JSON.stringify(err));
- });
- ```
-
-## appManager.isRamConstrainedDevice
-
-isRamConstrainedDevice(callback: AsyncCallback\): void;
-
-查询是否为ram受限设备。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**参数：**
-
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<boolean> | 否 | 返回当前是否是ram受限设备。 |
-
-**示例：**
-
- ```js
- app.isRamConstrainedDevice((err, data) => {
- console.log('startAbility result failed:' + JSON.stringify(err));
- console.log('startAbility result success:' + JSON.stringify(data));
- })
- ```
-
-## appManager.getAppMemorySize
-
-getAppMemorySize(): Promise\;
-
-获取应用程序的内存大小。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**返回值：**
-
- | 类型 | 说明 |
- | -------- | -------- |
- | Promise<number> | 应用程序内存大小。 |
-
-**示例：**
-
- ```js
- app.getAppMemorySize().then((data) => {
- console.log('success:' + JSON.stringify(data));
- }).catch((error) => {
- console.log('failed:' + error.code + ', ' + error.message);
- });
- ```
-
-## appManager.getAppMemorySize
-
-getAppMemorySize(callback: AsyncCallback\): void;
-
-获取应用程序的内存大小。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**参数：**
-
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<number> | 否 | 应用程序内存大小。 |
-
-**示例：**
-
- ```js
- app.getAppMemorySize((err, data) => {
- console.log('startAbility result failed :' + JSON.stringify(err));
- console.log('startAbility result success:' + JSON.stringify(data));
- })
- ```
-
-## appManager.getProcessRunningInformation
-
-getProcessRunningInformation(): Promise\>;
-
-获取有关运行进程的信息。
-
-**需要权限**：ohos.permission.GET_RUNNING_INFO
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------- | -------- |
-| Promise\> | 获取有关运行进程的信息。 |
-
-**示例：**
-
- ```js
- app.getProcessRunningInformation().then((data) => {
- console.log('success:' + JSON.stringify(data));
- }).catch((error) => {
- console.log('failed:' + JSON.stringify(error));
- });
- ```
-
-## appManager.getProcessRunningInformation
-
-getProcessRunningInformation(callback: AsyncCallback\>): void;
-
-获取有关运行进程的信息。
-
-**需要权限**：ohos.permission.GET_RUNNING_INFO
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| callback | AsyncCallback\> | 否 | 获取有关运行进程的信息。 |
-
-**示例：**
-
- ```js
- app.getProcessRunningInformation((err, data) => {
- console.log('startAbility result failed :' + JSON.stringify(error));
- console.log('startAbility result success:' + JSON.stringify(data));
- })
- ```
-
-## appManager.on
-
-on(type: "applicationState", observer: ApplicationStateObserver): number;
-
-注册全部应用程序状态观测器。
-
-**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| type | string | 是 | 调用接口类型 |
-| observer | [ApplicationStateObserver](#applicationstateobserver) | 否 | 返回观察者的数字代码。 |
-
-**示例：**
-
- ```js
- var applicationStateObserver = {
- onForegroundApplicationChanged(appStateData) {
- console.log('------------ onForegroundApplicationChanged -----------', appStateData);
- },
- onAbilityStateChanged(abilityStateData) {
- console.log('------------ onAbilityStateChanged -----------', abilityStateData);
- },
- onProcessCreated(processData) {
- console.log('------------ onProcessCreated -----------', processData);
- },
- onProcessDied(processData) {
- console.log('------------ onProcessDied -----------', processData);
- },
- onProcessStateChanged(processData) {
- console.log('------------ onProcessStateChanged -----------', processData);
- }
- }
- try {
- const observerCode = app.on(applicationStateObserver);
- console.log('-------- observerCode: ---------', observerCode);
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
-
- ```
-
-## appManager.on
-
-on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList: Array\): number;
-
-注册指定应用程序状态观测器。
-
-**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| type | string | 是 | 调用接口类型 |
-| observer | [ApplicationStateObserver](#applicationstateobserver) | 否 | 返回观察者的数字代码。 |
-| bundleNameList | Array | 否 | 表示需要注册监听的bundleName数组。最大值128。 |
-
-**示例：**
-
- ```js
- var applicationStateObserver = {
- onForegroundApplicationChanged(appStateData) {
- console.log('------------ onForegroundApplicationChanged -----------', appStateData);
- },
- onAbilityStateChanged(abilityStateData) {
- console.log('------------ onAbilityStateChanged -----------', abilityStateData);
- },
- onProcessCreated(processData) {
- console.log('------------ onProcessCreated -----------', processData);
- },
- onProcessDied(processData) {
- console.log('------------ onProcessDied -----------', processData);
- },
- onProcessStateChanged(processData) {
- console.log('------------ onProcessStateChanged -----------', processData);
- }
- }
- var bundleNameList = ['bundleName1', 'bundleName2'];
- try {
- const observerCode = app.on("applicationState", applicationStateObserver, bundleNameList);
- console.log('-------- observerCode: ---------', observerCode);
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
-
- ```
-## appManager.off
-
-off(type: "applicationState", observerId: number, callback: AsyncCallback\): void;
-
-取消注册应用程序状态观测器。
-
-**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| type | string | 是 | 调用接口类型 |
-| observerId | number | 否 | 表示观察者的编号代码。 |
-| callback | AsyncCallback\ | 否 | 表示指定的回调方法。 |
-
-**示例：**
-
- ```js
- var observerId = 100;
-
- function unregisterApplicationStateObserverCallback(err) {
- if (err) {
- console.log('------------ unregisterApplicationStateObserverCallback ------------', err);
- }
- }
- try {
- app.off(observerId, unregisterApplicationStateObserverCallback);
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
- ```
-
-## appManager.off
-
-off(type: "applicationState", observerId: number): Promise\;
-
-取消注册应用程序状态观测器。
-
-**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| type | string | 是 | 调用接口类型 |
-| observerId | number | 否 | 表示观察者的编号代码。 |
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------- | -------- |
-| Promise\ | 返回执行结果。 |
-
-**示例：**
-
- ```js
- var observerId = 100;
-
- try {
- app.off(observerId)
- .then((data) => {
- console.log('----------- unregisterApplicationStateObserver success ----------', data);
- })
- .catch((err) => {
- console.log('----------- unregisterApplicationStateObserver fail ----------', err);
- })
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
- ```
-
-## appManager.getForegroundApplications
-
-getForegroundApplications(callback: AsyncCallback\>): void;
-
-获取前台进程的应用程序。
-
-**需要权限**：ohos.permission.GET_RUNNING_INFO
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| callback | AsyncCallback\> | 否 | 表示应用的状态数据。 |
-
-**示例：**
-
- ```js
- function getForegroundApplicationsCallback(err, data) {
- if (err) {
- console.log('--------- getForegroundApplicationsCallback fail ---------', err.code + ': ' + err.message);
- } else {
- console.log('--------- getForegroundApplicationsCallback success ---------', data)
- }
- }
- app.getForegroundApplications(getForegroundApplicationsCallback);
- ```
-
-## appManager.getForegroundApplications
-
-getForegroundApplications(): Promise\>;
-
-获取前台进程的应用程序。
-
-**需要权限**：ohos.permission.GET_RUNNING_INFO
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------- | -------- |
-| Promise\> | 返回进程运行信息的数组。 |
-
-**示例：**
-
- ```js
- app.getForegroundApplications()
- .then((data) => {
- console.log('--------- getForegroundApplications success -------', data);
- })
- .catch((err) => {
- console.log('--------- getForegroundApplications fail -------', err.code + ': ' + err.message);
- })
- ```
-
-## appManager.killProcessWithAccount
-
-killProcessWithAccount(bundleName: string, accountId: number): Promise\
-
-切断account进程（Promise形式）。
-
-**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**: 此接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | bundleName | string | 是 | 应用包名。 |
- | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
-
-**示例：**
-
-```js
-var bundleName = 'bundleName';
-var accountId = 0;
-try {
- app.killProcessWithAccount(bundleName, accountId)
- .then((data) => {
- console.log('------------ killProcessWithAccount success ------------', data);
- })
- .catch((err) => {
- console.log('------------ killProcessWithAccount fail ------------', err);
- })
-} catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
-}
-```
-
-
-## appManager.killProcessWithAccount
-
-killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCallback\): void
-
-切断account进程（callback形式）。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**: 此接口为系统接口，三方应用不支持调用。
-
-**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES
-
-**参数：**
-
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | bundleName | string | 是 | 应用包名。 |
- | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
- | callback | AsyncCallback\ | 是 | 切断account进程的回调函数。 |
-
-**示例：**
-
-```js
-var bundleName = 'bundleName';
-var accountId = 0;
-function killProcessWithAccountCallback(err, data) {
- if (err) {
- console.log('------------- killProcessWithAccountCallback fail, err: --------------', err);
- } else {
- console.log('------------- killProcessWithAccountCallback success, data: --------------', data);
- }
-}
-try {
- app.killProcessWithAccount(bundleName, accountId, killProcessWithAccountCallback);
-} catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
-}
-```
-
-## appManager.killProcessesByBundleName
-
-killProcessesByBundleName(bundleName: string, callback: AsyncCallback\);
-
-通过包名终止进程。
-
-**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| bundleName | string | 否 | 表示包名。 |
-| callback | AsyncCallback\ | 否 | 表示指定的回调方法。 |
-
-**示例：**
-
- ```js
- var bundleName = 'bundleName';
- function killProcessesByBundleNameCallback(err, data) {
- if (err) {
- console.log('------------- killProcessesByBundleNameCallback fail, err: --------------', err);
- } else {
- console.log('------------- killProcessesByBundleNameCallback success, data: --------------', data);
- }
- }
- try {
- app.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback);
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
- ```
-
-## appManager.killProcessesByBundleName
-
-killProcessesByBundleName(bundleName: string): Promise\;
-
-通过包名终止进程。
-
-**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| bundleName | string | 否 | 表示包名。 |
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------- | -------- |
-| Promise\ | 返回执行结果。 |
-
-**示例：**
-
- ```js
-var bundleName = 'bundleName';
-try {
- app.killProcessesByBundleName(bundleName)
- .then((data) => {
- console.log('------------ killProcessesByBundleName success ------------', data);
- })
- .catch((err) => {
- console.log('------------ killProcessesByBundleName fail ------------', err);
- })
-} catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
-}
-
- ```
-
-## appManager.clearUpApplicationData
-
-clearUpApplicationData(bundleName: string, callback: AsyncCallback\);
-
-通过包名清除应用数据。
-
-**需要权限**：ohos.permission.CLEAN_APPLICATION_DATA
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| bundleName | string | 否 | 表示包名。 |
-| callback | AsyncCallback\ | 否 | 表示指定的回调方法。 |
-
-**示例：**
-
- ```js
- var bundleName = 'bundleName';
- function clearUpApplicationDataCallback(err, data) {
- if (err) {
- console.log('------------- clearUpApplicationDataCallback fail, err: --------------', err);
- } else {
- console.log('------------- clearUpApplicationDataCallback success, data: --------------', data);
- }
- }
- try {
- app.clearUpApplicationData(bundleName, clearUpApplicationDataCallback);
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
-
- ```
-
-## appManager.clearUpApplicationData
-
-clearUpApplicationData(bundleName: string): Promise\;
-
-通过包名清除应用数据。
-
-**需要权限**：ohos.permission.CLEAN_APPLICATION_DATA
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| bundleName | string | 否 | 表示包名。 |
-
-**返回值：**
-
-| 类型 | 说明 |
-| -------- | -------- |
-| Promise\ | 返回执行结果。 |
-
-**示例：**
-
- ```js
- var bundleName = 'bundleName';
- try {
- app.clearUpApplicationData(bundleName)
- .then((data) => {
- console.log('------------ clearUpApplicationData success ------------', data);
- })
- .catch((err) => {
- console.log('------------ clearUpApplicationData fail ------------', err);
- })
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
-
- ```
-
-## ApplicationStateObserver.onForegroundApplicationChanged
-
-onForegroundApplicationChanged(appStateData: AppStateData): void;
-
-将在前台或后台应用程序更改时调用。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| appStateData | [AppStateData](#appstatedata) | 否 | 状态更改的应用程序信息。 |
-
-**示例：**
-
-```js
- var applicationStateObserver = {
- onForegroundApplicationChanged(appStateData) {
- console.log('------------ onForegroundApplicationChanged -----------', appStateData);
- },
- onAbilityStateChanged(abilityStateData) {
- console.log('------------ onAbilityStateChanged -----------', abilityStateData);
- },
- onProcessCreated(processData) {
- console.log('------------ onProcessCreated -----------', processData);
- },
- onProcessDied(processData) {
- console.log('------------ onProcessDied -----------', processData);
- },
- onProcessStateChanged(processData) {
- console.log('------------ onProcessStateChanged -----------', processData);
- }
- }
- try {
- const observerCode = app.on("applicationState", applicationStateObserver);
- console.log('-------- observerCode: ---------', observerCode);
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
-
-```
-
-## ApplicationStateObserver.onAbilityStateChanged
-
-onAbilityStateChanged(abilityStateData: AbilityStateData): void;
-
-将在能力状态更改时调用。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| abilityStateData | [AbilityStateData](#abilitystatedata) | 否 | 状态更改的能力信息。 |
-
-**示例：**
-
-```js
- var applicationStateObserver = {
- onForegroundApplicationChanged(appStateData) {
- console.log('------------ onForegroundApplicationChanged -----------', appStateData);
- },
- onAbilityStateChanged(abilityStateData) {
- console.log('------------ onAbilityStateChanged -----------', abilityStateData);
- },
- onProcessCreated(processData) {
- console.log('------------ onProcessCreated -----------', processData);
- },
- onProcessDied(processData) {
- console.log('------------ onProcessDied -----------', processData);
- },
- onProcessStateChanged(processData) {
- console.log('------------ onProcessStateChanged -----------', processData);
- }
- }
- try {
- const observerCode = app.on("applicationState", applicationStateObserver);
- console.log('-------- observerCode: ---------', observerCode);
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
-```
-
-## ApplicationStateObserver.onProcessCreated
-
-onProcessCreated(processData: ProcessData): void;
-
-将在创建进程时调用。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| processData | [ProcessData](#processdata) | 否 | 进程信息。 |
-
-**示例：**
-
-```js
- var applicationStateObserver = {
- onForegroundApplicationChanged(appStateData) {
- console.log('------------ onForegroundApplicationChanged -----------', appStateData);
- },
- onAbilityStateChanged(abilityStateData) {
- console.log('------------ onAbilityStateChanged -----------', abilityStateData);
- },
- onProcessCreated(processData) {
- console.log('------------ onProcessCreated -----------', processData);
- },
- onProcessDied(processData) {
- console.log('------------ onProcessDied -----------', processData);
- },
- onProcessStateChanged(processData) {
- console.log('------------ onProcessStateChanged -----------', processData);
- }
- }
- try {
- const observerCode = app.on("applicationState", applicationStateObserver);
- console.log('-------- observerCode: ---------', observerCode);
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
-```
-
-## ApplicationStateObserver.onProcessDied
-
-onProcessDied(processData: ProcessData): void;
-
-将在进程终止时调用。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| processData | [ProcessData](#processdata) | 否 | 进程信息。 |
-
-**示例：**
-
-```js
- var applicationStateObserver = {
- onForegroundApplicationChanged(appStateData) {
- console.log('------------ onForegroundApplicationChanged -----------', appStateData);
- },
- onAbilityStateChanged(abilityStateData) {
- console.log('------------ onAbilityStateChanged -----------', abilityStateData);
- },
- onProcessCreated(processData) {
- console.log('------------ onProcessCreated -----------', processData);
- },
- onProcessDied(processData) {
- console.log('------------ onProcessDied -----------', processData);
- },
- onProcessStateChanged(processData) {
- console.log('------------ onProcessStateChanged -----------', processData);
- }
- }
- try {
- const observerCode = app.on("applicationState", applicationStateObserver);
- console.log('-------- observerCode: ---------', observerCode);
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
-```
-
-## ApplicationStateObserver.onProcessStateChanged
-
- onProcessStateChanged(processData: ProcessData): void;
-
-当进程状态更改时调用。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| processData | [ProcessData](#processdata) | 否 | 进程信息。 |
-
-**示例：**
-
-```js
- var applicationStateObserver = {
- onForegroundApplicationChanged(appStateData) {
- console.log('------------ onForegroundApplicationChanged -----------', appStateData);
- },
- onAbilityStateChanged(abilityStateData) {
- console.log('------------ onAbilityStateChanged -----------', abilityStateData);
- },
- onProcessCreated(processData) {
- console.log('------------ onProcessCreated -----------', processData);
- },
- onProcessDied(processData) {
- console.log('------------ onProcessDied -----------', processData);
- },
- onProcessStateChanged(processData) {
- console.log('------------ onProcessStateChanged -----------', processData);
- }
- }
- try {
- const observerCode = app.on("applicationState", applicationStateObserver);
- console.log('-------- observerCode: ---------', observerCode);
- } catch (paramError) {
- console.log('error: ' + paramError.code + ', ' + paramError.message);
- }
-```
-
-## AppStateData
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
-| ----------- | -------- |-------- | -------------------- | ---- | ------------------------------------------------------------ |
-| bundleName | 是 | 否 | string | 否 | 包名。 |
-| uid | 是 | 否 | number | 否 | 用户ID。 |
-| state | 是 | 否 | number | 否 | 应用状态。 |
-
-## AbilityStateData
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ----------------------- | ---------| ---- | ---- | ------------------------- |
-| pid | number | 是 | 否 | 进程ID。 |
-| bundleName | string | 是 | 否 | 应用包名。 |
-| abilityName | string | 是 | 否 | Ability名称。 |
-| uid | number | 是 | 否 | 用户ID。 |
-| state | number | 是 | 否 | Ability状态。 |
-| moduleName | string | 是 | 否 | Ability所属的HAP包的名称。 |
-| abilityType | string | 是 | 否 | 能力类型、页面或服务等。 |
-
-## ProcessData
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ----------------------- | ---------| ---- | ---- | ------------------------- |
-| pid | number | 是 | 否 | 进程ID。 |
-| bundleName | string | 是 | 否 | 应用包名。 |
-| uid | number | 是 | 否 | 用户ID。 |
-| isContinuousTas | boolean | 是 | 否 | 判断过程是否为连续任务。 |
-| isKeepAlive | boolean | 是 | 否 | 判断该过程是否保持活跃。 |
-
-## ProcessRunningInfo
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission
-
-| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
-| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
-| pid | 是 | 否 | number | 否 | 进程ID。 |
-| uid | 是 | 否 | number | 否 | 用户ID。 |
-| processName | 是 | 否 | string | 否 | 进程的名称。 |
-| bundleNames | 是 | 否 | Array\ | 否 | 进程中运行的bundleName数组。 |
-
-## ApplicationStateObserver
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**：该接口为系统接口，三方应用不支持调用。
-
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ----------------------- | ---------| ---- | ---- | ------------------------- |
-| [onForegroundApplicationChanged](#applicationstateobserveronforegroundapplicationchanged) | AsyncCallback\ | 是 | 否 | 应用前后台状态发生变化时执行的回调函数。 |
-| [onAbilityStateChanged](#applicationstateobserveronabilitystatechanged) | AsyncCallback\ | 是 | 否 | ability状态发生变化时执行的回调函数。 |
-| [onProcessCreated](#applicationstateobserveronprocesscreated) | AsyncCallback\ | 是 | 否 | 进程创建时执行的回调函数。 |
-| [onProcessDied](#applicationstateobserveronprocessdied) | AsyncCallback\ | 是 | 否 | 进程销毁时执行的回调函数。 |
-
-## ProcessRunningInformation
-
-进程的运行信息。
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
-
-| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
-| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
-| pid | 是 | 否 | number | 否 | 进程ID。 |
-| uid | 是 | 否 | number | 否 | 用户ID。 |
-| processName | 是 | 否 | string | 否 | 进程的名称。 |
-| bundleNames | 是 | 否 | Array\ | 否 | 进程中运行的bundleName数组。 |
-
-## ApplicationState
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**: 此接口为系统接口，三方应用不支持调用。
-
-| 名称 | 值 | 描述 |
-| -------------------- | --- | --------------------------------- |
-| STATE_CREATE | 1 | 当应用在创建中的时候处于的状态。 |
-| STATE_FOREGROUND | 2 | 当应用切换到前台的时候处于的状态。 |
-| STATE_ACTIVE | 3 | 当应用在获焦的时候处于的状态。 |
-| STATE_BACKGROUND | 4 | 当应用处于后台不可见时处于的状态。 |
-| STATE_DESTROY | 5 | 当应用在销毁的时候处于的状态。 |
-
-## ProcessState
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
-
-**系统API**: 此接口为系统接口，三方应用不支持调用。
-
-| 名称 | 值 | 描述 |
-| -------------------- | --- | --------------------------------- |
-| STATE_CREATE | 1 | 当进程在创建中的时候处于的状态。 |
-| STATE_FOREGROUND | 2 | 当进程切换到前台的时候处于的状态。 |
-| STATE_ACTIVE | 3 | 当进程在获焦的时候处于的状态。 |
-| STATE_BACKGROUND | 4 | 当进程处于后台不可见时处于的状态。 |
-| STATE_DESTROY | 5 | 当进程在销毁的时候处于的状态。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-common.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-common.md
new file mode 100644
index 0000000000000000000000000000000000000000..b8979b193d16e9415b6ac7656d7b40817f7fd388
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-common.md
@@ -0,0 +1,62 @@
+# Common
+
+Common模块将二级模块API组织在一起方便开发者进行导出。
+
+> **说明：**
+>
+> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块接口仅可在Stage模型下使用
+
+## 导入模块
+
+```ts
+import common from '@ohos.app.ability.common'
+```
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
+
+| 名称 | 读写属性 | 类型 | 必填 | 描述 |
+| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
+| UIAbilityContext | 只读 | [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md) | 否 | UIAbilityContext二级模块。 |
+| AbilityStageContext | 只读 | [AbilityStageContext](js-apis-inner-application-abilityStageContext.md) | 否 | AbilityStageContext二级模块。 |
+| ApplicationContext | 只读 | [ApplicationContext](js-apis-inner-application-applicationContext.md) | 否 | ApplicationContext二级模块。 |
+| BaseContext | 只读 | [BaseContext](js-apis-inner-application-baseContext.md) | 否 | BaseContext二级模块。 |
+| Context | 只读 | [Context](js-apis-inner-application-context.md) | 否 | Context二级模块。 |
+| ExtensionContext | 只读 | [ExtensionContext](js-apis-inner-application-extensionContext.md) | 否 | ExtensionContext二级模块。 |
+| FormExtensionContext | 只读 | [FormExtensionContext](js-apis-inner-application-formExtensionContext.md) | 否 | FormExtensionContext二级模块。 |
+| AreaMode | 只读 | [AreaMode](#areamode) | 否 | AreaMode枚举值。 |
+| EventHub | 只读 | [EventHub](js-apis-inner-application-eventHub.md) | 否 | EventHub二级模块。 |
+| PermissionRequestResult | 只读 | [PermissionRequestResult](js-apis-inner-application-permissionRequestResult.md) | 否 | PermissionRequestResult二级模块。 |
+| PacMap | 只读 | [PacMap](js-apis-inner-ability-dataAbilityHelper.md#PacMap) | 否 | PacMap二级模块。 |
+| AbilityResult | 只读 | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 否 | AbilityResult二级模块。 |
+| ConnectOptions | 只读 | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 否 | ConnectOptions二级模块。 |
+
+**示例：**
+```ts
+import common from '@ohos.app.ability.common'
+
+let uiAbilityContext: common.UIAbilityContext;
+let abilityStageContext: common.AbilityStageContext;
+let applicationContext: common.ApplicationContext;
+let baseContext: common.BaseContext;
+let context: common.Context;
+let extensionContext: common.ExtensionContext;
+let formExtensionContext: common.FormExtensionContext;
+let areaMode: common.AreaMode;
+let eventHub: common.EventHub;
+let permissionRequestResult: common.PermissionRequestResult;
+let pacMap: common.PacMap;
+let abilityResult: common.AbilityResult;
+let connectOptions: common.ConnectOptions;
+```
+
+## AreaMode
+
+访问的文件分区，每个文件分区有对应自己的内容。
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+| 变量 | 值 | 描述 |
+| --------------- | ---- | --------------- |
+| EL1 | 0 | 设备级加密区。 |
+| EL2 | 1 | 用户凭据加密区。默认为EL2。 |
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-configurationconstant.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-configurationConstant.md
similarity index 84%
rename from zh-cn/application-dev/reference/apis/js-apis-app-ability-configurationconstant.md
rename to zh-cn/application-dev/reference/apis/js-apis-app-ability-configurationConstant.md
index 227c900fe14216c14119c5ab9f9c3b19b7e8a931..9250525023954ee7d1d25255e5e9458cee30676c 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-configurationconstant.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-configurationConstant.md
@@ -8,8 +8,7 @@ ConfigurationConstant模块提供配置信息枚举值定义的能力。
## 导入模块
-
-```js
+```ts
import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant';
```
@@ -17,12 +16,6 @@ import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant';
使用时通过ConfigurationConstant.ColorMode获取。
-**示例：**
-
-```
-ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT
-```
-
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 值 | 说明 |
@@ -32,16 +25,10 @@ ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT
| COLOR_MODE_LIGHT | 1 | 浅色模式。 |
-## ConfigurationConstant.Direction
+## ConfigurationConstant.Direction9+
使用时通过ConfigurationConstant.Direction获取。
-**示例：**
-
-```
-ConfigurationConstant.Direction.DIRECTION_VERTICAL
-```
-
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 值 | 说明 |
@@ -51,16 +38,10 @@ ConfigurationConstant.Direction.DIRECTION_VERTICAL
| DIRECTION_HORIZONTAL | 1 | 水平方向。 |
-## ConfigurationConstant.ScreenDensity
+## ConfigurationConstant.ScreenDensity9+
使用时通过ConfigurationConstant.ScreenDensity获取。
-**示例：**
-
-```
-ConfigurationConstant.ScreenDensity.SCREEN_DENSITY_NOT_SET
-```
-
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 值 | 说明 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-contextConstant.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-contextConstant.md
new file mode 100644
index 0000000000000000000000000000000000000000..6cbae9bd87e3776d8bbdedfce6e050b8c4ff3616
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-contextConstant.md
@@ -0,0 +1,25 @@
+# ContextConstant
+
+ContextConstant模块提供数据加密等级定义的能力。
+
+> **说明：**
+>
+> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块接口仅可在Stage模型下使用。
+
+## 导入模块
+
+```ts
+import contextConstant from '@ohos.app.ability.contextConstant';
+```
+
+## ContextConstant.AreaMode
+
+使用时通过ContextConstant.AreaMode获取。
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.SystemCapability.Ability.AbilityRuntime.Core
+
+| 名称 | 值 | 说明 |
+| -------- | -------- | -------- |
+| EL1 | 0 | 设备级加密区。 |
+| EL2 | 1 | 用户凭据加密区。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-EnvironmentCallback.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-environmentCallback.md
old mode 100755
new mode 100644
similarity index 73%
rename from zh-cn/application-dev/reference/apis/js-apis-app-ability-EnvironmentCallback.md
rename to zh-cn/application-dev/reference/apis/js-apis-app-ability-environmentCallback.md
index b2cf2d5f88cceccbe6052d6d170981fea0f35089..607978f6ba30774aed87430bff710d896339e833
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-EnvironmentCallback.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-environmentCallback.md
@@ -10,7 +10,7 @@ EnvironmentCallback模块提供应用上下文ApplicationContext对系统环境
## 导入模块
-```js
+```ts
import EnvironmentCallback from "@ohos.app.ability.EnvironmentCallback";
```
@@ -27,13 +27,13 @@ onConfigurationUpdated(config: Configuration): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | config | [Configuration](js-apis-configuration.md) | 是 | 变化后的Configuration对象。 |
+ | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 变化后的Configuration对象。 |
**示例：**
- ```js
-import Ability from "@ohos.app.ability.Ability";
+ ```ts
+import Ability from "@ohos.application.Ability";
var callbackId;
@@ -49,18 +49,14 @@ export default class MyAbility extends Ability {
// 1.获取applicationContext
let applicationContext = globalThis.applicationContext;
// 2.通过applicationContext注册监听应用内生命周期
- callbackId = applicationContext.on("environment", EnvironmentCallback);
+ callbackId = applicationContext.registerEnvironmentCallback(EnvironmentCallback);
console.log("registerEnvironmentCallback number: " + JSON.stringify(callbackId));
}
onDestroy() {
let applicationContext = globalThis.applicationContext;
- try {
- applicationContext.off("environment", callbackId, (error, data) => {
- console.log("unregisterEnvironmentCallback success, err: " + JSON.stringify(error));
- });
- } catch (paramError) {
- console.log("error: " + paramError.code + ", " + paramError.message);
- }
+ applicationContext.unregisterEnvironmentCallback(callbackId, (error, data) => {
+ console.log("unregisterEnvironmentCallback success, err: " + JSON.stringify(error));
+ });
}
}
```
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-extensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-extensionAbility.md
new file mode 100644
index 0000000000000000000000000000000000000000..3dc4961effd5c1a0acf40b84bedaca3d1cdd92fb
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-extensionAbility.md
@@ -0,0 +1,30 @@
+# ExtensionAbility
+
+ExtensionAbility模块提供对ExtensionAbility生命周期、上下文环境等调用管理的能力，包括ExtensionAbility创建、销毁、转储客户端信息等。
+
+> **说明：**
+>
+> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块接口仅可在Stage模型下使用。
+
+## 导入模块
+
+```ts
+import ExtensionAbility from '@ohos.app.ability.ExtensionAbility';
+```
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**示例：**
+
+ ```ts
+ class MyExtensionAbility extends ExtensionAbility {
+ onConfigurationUpdated(config) {
+ console.log('onConfigurationUpdated, config:' + JSON.stringify(config));
+ }
+
+ onMemoryLevel(level) {
+ console.log('onMemoryLevel, level:' + JSON.stringify(level));
+ }
+ }
+ ```
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md
index 5d52a9484587e64c924ba436c83296bf3bdac1c2..aa3241d8f53a43136c6c232c48d9ab011601e0f5 100755
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md
@@ -8,7 +8,7 @@ missionManager模块提供系统任务管理能力，包括对系统任务执行
## 导入模块
-```
+```ts
import missionManager from '@ohos.app.ability.missionManager'
```
@@ -42,7 +42,7 @@ on(type:"mission", listener: MissionListener): number;
**示例：**
-```js
+```ts
var listener = {
onMissionCreated: function (mission) {console.log("--------onMissionCreated-------")},
onMissionDestroyed: function (mission) {console.log("--------onMissionDestroyed-------")},
@@ -81,7 +81,7 @@ off(type: "mission", listenerId: number, callback: AsyncCallback<void>): v
**示例：**
-```js
+```ts
var listener = {
onMissionCreated: function (mission) {console.log("--------onMissionCreated-------")},
onMissionDestroyed: function (mission) {console.log("--------onMissionDestroyed-------")},
@@ -129,7 +129,7 @@ off(type: "mission", listenerId: number): Promise<void>;
**示例：**
-```js
+```ts
var listener = {
onMissionCreated: function (mission) {console.log("--------onMissionCreated-------")},
onMissionDestroyed: function (mission) {console.log("--------onMissionDestroyed-------")},
@@ -173,7 +173,7 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<M
**示例：**
- ```js
+ ```ts
import missionManager from '@ohos.app.ability.missionManager'
try {
@@ -220,7 +220,7 @@ getMissionInfo(deviceId: string, missionId: number): Promise<MissionInfo>;
**示例：**
- ```js
+ ```ts
import missionManager from '@ohos.app.ability.missionManager'
try {
@@ -255,7 +255,7 @@ getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Arr
**示例：**
- ```js
+ ```ts
import missionManager from '@ohos.app.ability.missionManager'
try {
@@ -297,7 +297,7 @@ getMissionInfos(deviceId: string, numMax: number): Promise<Array<MissionIn
**示例：**
- ```js
+ ```ts
import missionManager from '@ohos.app.ability.missionManager'
try {
@@ -328,11 +328,11 @@ getMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback&
| -------- | -------- | -------- | -------- |
| deviceId | string | 是 | 设备ID，本机默认为空字符串。 |
| missionId | number | 是 | 任务ID。 |
- | callback | AsyncCallback<[MissionSnapshot](js-apis-application-MissionSnapshot.md)> | 是 | 执行结果回调函数，返回任务快照信息。 |
+ | callback | AsyncCallback<[MissionSnapshot](js-apis-inner-application-missionSnapshot.md)> | 是 | 执行结果回调函数，返回任务快照信息。 |
**示例：**
- ```js
+ ```ts
import missionManager from '@ohos.app.ability.missionManager'
try {
@@ -376,11 +376,11 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnaps
| 类型 | 说明 |
| -------- | -------- |
- | Promise<[MissionSnapshot](js-apis-application-MissionSnapshot.md)> | 任务快照信息。 |
+ | Promise<[MissionSnapshot](js-apis-inner-application-missionSnapshot.md)> | 任务快照信息。 |
**示例：**
- ```js
+ ```ts
import missionManager from '@ohos.app.ability.missionManager'
try {
@@ -418,11 +418,11 @@ getLowResolutionMissionSnapShot(deviceId: string, missionId: number, callback: A
| -------- | -------- | -------- | -------- |
| deviceId | string | 是 | 设备ID，本机默认为空字符串。 |
| missionId | number | 是 | 任务ID。 |
- | callback | AsyncCallback<[MissionSnapshot](js-apis-application-MissionSnapshot.md)> | 是 | 执行结果回调函数，返回任务快照信息。 |
+ | callback | AsyncCallback<[MissionSnapshot](js-apis-inner-application-missionSnapshot.md)> | 是 | 执行结果回调函数，返回任务快照信息。 |
**示例：**
- ```js
+ ```ts
import missionManager from '@ohos.app.ability.missionManager'
try {
@@ -466,11 +466,11 @@ getLowResolutionMissionSnapShot(deviceId: string, missionId: number): Promise\ {
@@ -801,7 +801,7 @@ clearAllMissions(): Promise<void>;
**示例：**
- ```js
+ ```ts
import missionManager from '@ohos.app.ability.missionManager'
missionManager.clearAllMissions().catch(function (err){
console.log(err);
@@ -830,7 +830,7 @@ moveMissionToFront(missionId: number, callback: AsyncCallback<void>): void
**示例：**
- ```js
+ ```ts
import missionManager from '@ohos.app.ability.missionManager'
try {
@@ -867,12 +867,12 @@ moveMissionToFront(missionId: number, options: StartOptions, callback: AsyncCall
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| missionId | number | 是 | 任务ID。 |
- | options | [StartOptions](js-apis-application-StartOptions.md) | 是 | 启动参数选项，用于指定任务切到前台时的窗口模式，设备ID等。 |
+ | options | [StartOptions](js-apis-app-ability-startOptions.md) | 是 | 启动参数选项，用于指定任务切到前台时的窗口模式，设备ID等。 |
| callback | AsyncCallback<void> | 是 | 执行结果回调函数。 |
**示例：**
- ```js
+ ```ts
import missionManager from '@ohos.app.ability.missionManager'
try {
@@ -909,7 +909,7 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise<void&g
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| missionId | number | 是 | 任务ID。 |
- | options | [StartOptions](js-apis-application-StartOptions.md) | 否 | 启动参数选项，用于指定任务切到前台时的窗口模式，设备ID等。 |
+ | options | [StartOptions](js-apis-app-ability-startOptions.md) | 否 | 启动参数选项，用于指定任务切到前台时的窗口模式，设备ID等。 |
**返回值：**
@@ -919,7 +919,7 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise<void&g
**示例：**
- ```js
+ ```ts
import missionManager from '@ohos.app.ability.missionManager'
try {
@@ -953,7 +953,7 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise<void&g
| runningState | number | 是 | 是 | 表示运行状态。 |
| lockedState | boolean | 是 | 是 | 表示锁定状态。 |
| timestamp | string | 是 | 是 | 表示任务的最近创建或更新时间。 |
-| want | [Want](js-apis-application-Want.md) | 是 | 是 | 表示任务的Want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 是 | 表示任务的Want信息。 |
| label | string | 是 | 是 | 表示任务的标签。 |
| iconPath | string | 是 | 是 | 表示任务的图标路径。 |
| continuable | boolean | 是 | 是 | 表示任务是否可以迁移。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md
index 39d2dc130a026f94d2b6ecc1131d28082dd0304e..296ecc929e889872750b9705611bfe7d754ccedd 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md
@@ -8,7 +8,7 @@ quickFixManager模块提供快速修复的能力，快速修复是OpenHarmony提
## 导入模块
-```
+```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
```
@@ -64,7 +64,7 @@ applyQuickFix(hapModuleQuickFixFiles: Array\, callback: AsyncCallback\): Promise\;
**示例：**
-```js
+```ts
import quickFixManager from '@ohos.app.ability.quickFixManager'
let hapModuleQuickFixFiles = ["/data/storage/el2/base/entry.hqf"]
@@ -143,7 +143,7 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\ **说明：**
>
-> 本模块首批接口从API version 9开始支持，从API version 9废弃，替换模块为[@ohos.app.ability.ServiceExtensionAbility](js-apis-app-ability-service-extension-ability.md)。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块首批接口从API version 9开始支持，从API version 9废弃，替换模块为[@ohos.app.ability.ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility.md)。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
## 导入模块
-```
-import ServiceExtension from '@ohos.application.ServiceExtensionAbility';
+```ts
+import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
```
## 权限
@@ -25,7 +25,7 @@ import ServiceExtension from '@ohos.application.ServiceExtensionAbility';
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
-| context | [ServiceExtensionContext](js-apis-service-extension-context.md) | 是 | 否 | ServiceExtension的上下文环境，继承自ExtensionContext。 |
+| context | [ServiceExtensionContext](js-apis-inner-application-serviceExtensionContext.md) | 是 | 否 | ServiceExtension的上下文环境，继承自ExtensionContext。 |
## ServiceExtensionAbility.onCreate
@@ -42,11 +42,11 @@ Extension生命周期回调，在创建时回调，执行初始化业务逻辑
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | want | [Want](js-apis-application-Want.md) | 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
+ | want | [Want](js-apis-app-ability-want.md) | 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
**示例：**
- ```js
+ ```ts
class ServiceExt extends ServiceExtension {
onCreate(want) {
console.log('onCreate, want:' + want.abilityName);
@@ -67,7 +67,7 @@ Extension生命周期回调，在销毁时回调，执行资源清理等操作
**示例：**
- ```js
+ ```ts
class ServiceExt extends ServiceExtension {
onDestroy() {
console.log('onDestroy');
@@ -90,12 +90,12 @@ Extension生命周期回调，如果是startAbility拉起的服务，会在onCre
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | want | [Want](js-apis-application-Want.md) | 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
+ | want | [Want](js-apis-app-ability-want.md) | 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
| startId | number | 是 | 返回拉起次数。首次拉起初始值返回1，多次之后自动递增。 |
**示例：**
- ```js
+ ```ts
class ServiceExt extends ServiceExtension {
onRequest(want, startId) {
console.log('onRequest, want:' + want.abilityName);
@@ -118,7 +118,7 @@ Extension生命周期回调，如果是connectAbility拉起的服务，会在onC
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | want | [Want](js-apis-application-Want.md)| 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
+ | want | [Want](js-apis-app-ability-want.md)| 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
**返回值：**
@@ -128,7 +128,7 @@ Extension生命周期回调，如果是connectAbility拉起的服务，会在onC
**示例：**
- ```js
+ ```ts
import rpc from '@ohos.rpc'
class StubTest extends rpc.RemoteObject{
constructor(des) {
@@ -160,11 +160,11 @@ Extension的生命周期，断开服务连接时回调。
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | want |[Want](js-apis-application-Want.md)| 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
+ | want |[Want](js-apis-app-ability-want.md)| 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
**示例：**
- ```js
+ ```ts
class ServiceExt extends ServiceExtension {
onDisconnect(want) {
console.log('onDisconnect, want:' + want.abilityName);
@@ -186,11 +186,11 @@ onReconnect(want: Want): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | want |[Want](js-apis-application-Want.md)| 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
+ | want |[Want](js-apis-app-ability-want.md)| 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
**示例：**
- ```js
+ ```ts
class ServiceExt extends ServiceExtension {
onReconnect(want) {
console.log('onReconnect, want:' + want.abilityName);
@@ -212,11 +212,11 @@ onConfigurationUpdated(config: Configuration): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | config | [Configuration](js-apis-configuration.md) | 是 | 表示需要更新的配置信息。 |
+ | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 表示需要更新的配置信息。 |
**示例：**
- ```js
+ ```ts
class ServiceExt extends ServiceExtension {
onConfigurationUpdated(config) {
console.log('onConfigurationUpdated, config:' + JSON.stringify(config));
@@ -242,7 +242,7 @@ dump(params: Array\): Array\;
**示例：**
- ```js
+ ```ts
class ServiceExt extends ServiceExtension {
dump(params) {
console.log('dump, params:' + JSON.stringify(params));
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-StartOptions.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md
similarity index 76%
rename from zh-cn/application-dev/reference/apis/js-apis-app-ability-StartOptions.md
rename to zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md
index d1ddac75debac599e2ae21a9ba368c0bea8faf40..3ab6381a3e2b12fb066a868592b55a8037f07fc2 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-StartOptions.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md
@@ -9,15 +9,16 @@ StartOptions模块对系统的基本通信组件进行查询和设置的能力
## 导入模块
-```
+```ts
import StartOptions from '@ohos.app.ability.StartOptions';
```
## 属性
+
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
-| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 |
+| 名称 | 可读 | 可写 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | -------- | -------- |
-| [windowMode](js-apis-app-ability-abilityConstant.md#abilityconstantwindowmode) | 是 | 否 | number | 否 | 窗口模式。 |
+| [windowMode](js-apis-window.md#windowMode7) | 是 | 否 | number | 否 | 窗口模式。 |
| displayId | 是 | 否 | number | 否 | 显示ID。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
new file mode 100644
index 0000000000000000000000000000000000000000..48fcf3e231a36873253bc5d46827a5262d71515c
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
@@ -0,0 +1,709 @@
+# Ability
+
+Ability模块提供对Ability生命周期、上下文环境等调用管理的能力，包括Ability创建、销毁、转储客户端信息等。
+
+该模块提供以下Ability相关的常用功能：
+
+- [Caller](#caller)：通用组件Caller通信客户端调用接口, 用来向通用组件服务端发送约定数据。
+- [Callee](#callee)：通用组件服务端注册和解除客户端caller通知送信的callback接口。
+
+> **说明：**
+>
+> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块接口仅可在Stage模型下使用。
+
+## 导入模块
+
+```ts
+import Ability from '@ohos.app.ability.UIAbility';
+```
+
+## 属性
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+| 名称 | 参数类型 | 可读 | 可写 | 说明 |
+| -------- | -------- | -------- | -------- | -------- |
+| context | [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md) | 是 | 否 | 上下文。 |
+| launchWant | [Want](js-apis-app-ability-want.md) | 是 | 否 | Ability启动时的参数。 |
+| lastRequestWant | [Want](js-apis-app-ability-want.md) | 是 | 否 | Ability最后请求时的参数。|
+| callee | [Callee](#callee) | 是 | 否 | 调用Stub（桩）服务对象。|
+
+## Ability.onCreate
+
+onCreate(want: Want, param: AbilityConstant.LaunchParam): void;
+
+Ability创建时回调，执行初始化业务逻辑操作。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | want | [Want](js-apis-app-ability-want.md) | 是 | 当前Ability的Want类型信息，包括ability名称、bundle名称等。 |
+ | param | AbilityConstant.LaunchParam | 是 | 创建 ability、上次异常退出的原因信息。 |
+
+**示例：**
+
+ ```ts
+ class myAbility extends Ability {
+ onCreate(want, param) {
+ console.log('onCreate, want:' + want.abilityName);
+ }
+ }
+ ```
+
+
+## Ability.onWindowStageCreate
+
+onWindowStageCreate(windowStage: window.WindowStage): void
+
+当WindowStage创建后调用。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | windowStage | window.WindowStage | 是 | WindowStage相关信息。 |
+
+**示例：**
+
+ ```ts
+ class myAbility extends Ability {
+ onWindowStageCreate(windowStage) {
+ console.log('onWindowStageCreate');
+ }
+ }
+ ```
+
+
+## Ability.onWindowStageDestroy
+
+onWindowStageDestroy(): void
+
+当WindowStage销毁后调用。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**示例：**
+
+ ```ts
+ class myAbility extends Ability {
+ onWindowStageDestroy() {
+ console.log('onWindowStageDestroy');
+ }
+ }
+ ```
+
+
+## Ability.onWindowStageRestore
+
+onWindowStageRestore(windowStage: window.WindowStage): void
+
+当迁移多实例ability时，恢复WindowStage后调用。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | windowStage | window.WindowStage | 是 | WindowStage相关信息。 |
+
+**示例：**
+
+ ```ts
+ class myAbility extends Ability {
+ onWindowStageRestore(windowStage) {
+ console.log('onWindowStageRestore');
+ }
+ }
+ ```
+
+
+## Ability.onDestroy
+
+onDestroy(): void;
+
+Ability生命周期回调，在销毁时回调，执行资源清理等操作。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**示例：**
+
+ ```ts
+ class myAbility extends Ability {
+ onDestroy() {
+ console.log('onDestroy');
+ }
+ }
+ ```
+
+
+## Ability.onForeground
+
+onForeground(): void;
+
+Ability生命周期回调，当应用从后台转到前台时触发。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**示例：**
+
+ ```ts
+ class myAbility extends Ability {
+ onForeground() {
+ console.log('onForeground');
+ }
+ }
+ ```
+
+
+## Ability.onBackground
+
+onBackground(): void;
+
+Ability生命周期回调，当应用从前台转到后台时触发。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**示例：**
+
+ ```ts
+ class myAbility extends Ability {
+ onBackground() {
+ console.log('onBackground');
+ }
+ }
+ ```
+
+
+## Ability.onContinue
+
+onContinue(wantParam : {[key: string]: any}): AbilityConstant.OnContinueResult;
+
+当ability迁移准备迁移时触发，保存数据。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | wantParam | {[key: string]: any} | 是 | want相关参数。 |
+
+**返回值：**
+
+ | 类型 | 说明 |
+ | -------- | -------- |
+ | AbilityConstant.OnContinueResult | 继续的结果。 |
+
+**示例：**
+
+ ```ts
+ import AbilityConstant from "@ohos.application.AbilityConstant"
+ class myAbility extends Ability {
+ onContinue(wantParams) {
+ console.log('onContinue');
+ wantParams["myData"] = "my1234567";
+ return AbilityConstant.OnContinueResult.AGREE;
+ }
+ }
+ ```
+
+
+## Ability.onNewWant
+
+onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void;
+
+当ability的启动模式设置为单例时回调会被调用。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | want | [Want](js-apis-application-want.md) | 是 | Want类型参数，如ability名称，包名等。 |
+ | launchParams | AbilityConstant.LaunchParam | 是 | Ability启动的原因、上次异常退出的原因信息。 |
+
+**示例：**
+
+ ```ts
+ class myAbility extends Ability {
+ onNewWant(want) {
+ console.log('onNewWant, want:' + want.abilityName);
+ }
+ }
+ ```
+
+## Ability.dump
+
+dump(params: Array\): Array\;
+
+转储客户端信息时调用。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | params | Array\ | 是 | 表示命令形式的参数。|
+
+**示例：**
+
+ ```ts
+ class myAbility extends Ability {
+ dump(params) {
+ console.log('dump, params:' + JSON.stringify(params));
+ return ["params"]
+ }
+ }
+ ```
+
+
+## Ability.onSaveState
+
+onSaveState(reason: AbilityConstant.StateType, wantParam : {[key: string]: any}): AbilityConstant.OnSaveResult;
+
+该API配合[appRecovery](js-apis-app-ability-appRecovery.md)使用。在应用故障时，如果使能了自动保存状态，框架将回调onSaveState保存Ability状态。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | reason | [AbilityConstant.StateType](js-apis-application-abilityConstant.md#abilityconstantstatetype) | 是 | 回调保存状态的原因。 |
+ | wantParam | {[key: string]: any} | 是 | want相关参数。 |
+
+**返回值：**
+
+ | 类型 | 说明 |
+ | -------- | -------- |
+ | AbilityConstant.OnSaveResult | 是否同意保存当前Ability的状态。 |
+
+**示例：**
+
+ ```ts
+import AbilityConstant from '@ohos.application.AbilityConstant'
+
+class myAbility extends Ability {
+ onSaveState(reason, wantParam) {
+ console.log('onSaveState');
+ wantParam["myData"] = "my1234567";
+ return AbilityConstant.OnSaveResult.RECOVERY_AGREE;
+ }
+}
+ ```
+
+
+
+## Caller
+
+通用组件Caller通信客户端调用接口, 用来向通用组件服务端发送约定数据。
+
+## Caller.call
+
+call(method: string, data: rpc.Sequenceable): Promise<void>;
+
+向通用组件服务端发送约定序列化数据。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | method | string | 是 | 约定的服务端注册事件字符串。 |
+ | data | rpc.Sequenceable | 是 | 由开发者实现的Sequenceable可序列化数据。 |
+
+**返回值：**
+
+ | 类型 | 说明 |
+ | -------- | -------- |
+ | Promise<void> | Promise形式返回应答。 |
+
+**错误码：**
+
+| 错误码ID | 错误信息 |
+| ------- | -------------------------------- |
+| 201 | The application does not have permission to call the interface. |
+| 401 | Invalid input parameter. |
+| 16200001 | Caller released. The caller has been released. |
+| 16200002 | Callee invalid. The callee does not exist. |
+| 16000050 | Internal Error. |
+
+**示例：**
+
+ ```ts
+ import Ability from '@ohos.app.ability.UIAbility';
+ class MyMessageAble{ // 自定义的Sequenceable数据结构
+ name:""
+ str:""
+ num: 1
+ constructor(name, str) {
+ this.name = name;
+ this.str = str;
+ }
+ marshalling(messageParcel) {
+ messageParcel.writeInt(this.num);
+ messageParcel.writeString(this.str);
+ console.log('MyMessageAble marshalling num[' + this.num + '] str[' + this.str + ']');
+ return true;
+ }
+ unmarshalling(messageParcel) {
+ this.num = messageParcel.readInt();
+ this.str = messageParcel.readString();
+ console.log('MyMessageAble unmarshalling num[' + this.num + '] str[' + this.str + ']');
+ return true;
+ }
+ };
+ var method = 'call_Function'; // 约定的通知消息字符串
+ var caller;
+ export default class MainAbility extends Ability {
+ onWindowStageCreate(windowStage) {
+ this.context.startAbilityByCall({
+ bundleName: "com.example.myservice",
+ abilityName: "MainAbility",
+ deviceId: ""
+ }).then((obj) => {
+ caller = obj;
+ let msg = new MyMessageAble("msg", "world"); // 参考Sequenceable数据定义
+ caller.call(method, msg)
+ .then(() => {
+ console.log('Caller call() called');
+ })
+ .catch((callErr) => {
+ console.log('Caller.call catch error, error.code: ' + JSON.stringify(callErr.code) +
+ ' error.message: ' + JSON.stringify(callErr.message));
+ });
+ }).catch((err) => {
+ console.log('Caller GetCaller error, error.code: ' + JSON.stringify(err.code) +
+ ' error.message: ' + JSON.stringify(err.message));
+ });
+ }
+ }
+ ```
+
+
+## Caller.callWithResult
+
+callWithResult(method: string, data: rpc.Sequenceable): Promise<rpc.MessageParcel>;
+
+向通用组件服务端发送约定序列化数据, 并将服务端返回的约定序列化数据带回。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | method | string | 是 | 约定的服务端注册事件字符串。 |
+ | data | rpc.Sequenceable | 是 | 由开发者实现的Sequenceable可序列化数据。 |
+
+**返回值：**
+
+ | 类型 | 说明 |
+ | -------- | -------- |
+ | Promise<rpc.MessageParcel> | Promise形式返回通用组件服务端应答数据。 |
+
+**错误码：**
+
+| 错误码ID | 错误信息 |
+| ------- | -------------------------------- |
+| 201 | The application does not have permission to call the interface. |
+| 401 | Invalid input parameter. |
+| 16200001 | Caller released. The caller has been released. |
+| 16200002 | Callee invalid. The callee does not exist. |
+| 16000050 | Internal Error. |
+
+**示例：**
+
+ ```ts
+ import Ability from '@ohos.app.ability.UIAbility';
+ class MyMessageAble{
+ name:""
+ str:""
+ num: 1
+ constructor(name, str) {
+ this.name = name;
+ this.str = str;
+ }
+ marshalling(messageParcel) {
+ messageParcel.writeInt(this.num);
+ messageParcel.writeString(this.str);
+ console.log('MyMessageAble marshalling num[' + this.num + '] str[' + this.str + ']');
+ return true;
+ }
+ unmarshalling(messageParcel) {
+ this.num = messageParcel.readInt();
+ this.str = messageParcel.readString();
+ console.log('MyMessageAble unmarshalling num[' + this.num + '] str[' + this.str + ']');
+ return true;
+ }
+ };
+ var method = 'call_Function';
+ var caller;
+ export default class MainAbility extends Ability {
+ onWindowStageCreate(windowStage) {
+ this.context.startAbilityByCall({
+ bundleName: "com.example.myservice",
+ abilityName: "MainAbility",
+ deviceId: ""
+ }).then((obj) => {
+ caller = obj;
+ let msg = new MyMessageAble(1, "world");
+ caller.callWithResult(method, msg)
+ .then((data) => {
+ console.log('Caller callWithResult() called');
+ let retmsg = new MyMessageAble(0, "");
+ data.readSequenceable(retmsg);
+ })
+ .catch((callErr) => {
+ console.log('Caller.callWithResult catch error, error.code: ' + JSON.stringify(callErr.code) +
+ ' error.message: ' + JSON.stringify(callErr.message));
+ });
+ }).catch((err) => {
+ console.log('Caller GetCaller error, error.code: ' + JSON.stringify(err.code) +
+ ' error.message: ' + JSON.stringify(err.message));
+ });
+ }
+ }
+ ```
+
+
+## Caller.release
+
+release(): void;
+
+主动释放通用组件服务端的通信接口。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**错误码：**
+
+| 错误码ID | 错误信息 |
+| ------- | -------------------------------- |
+| 401 | Invalid input parameter. |
+| 16200001 | Caller released. The caller has been released. |
+| 16200002 | Callee invalid. The callee does not exist. |
+| 16000050 | Internal Error. |
+
+**示例：**
+
+ ```ts
+ import Ability from '@ohos.app.ability.UIAbility';
+ var caller;
+ export default class MainAbility extends Ability {
+ onWindowStageCreate(windowStage) {
+ this.context.startAbilityByCall({
+ bundleName: "com.example.myservice",
+ abilityName: "MainAbility",
+ deviceId: ""
+ }).then((obj) => {
+ caller = obj;
+ try {
+ caller.release();
+ } catch (releaseErr) {
+ console.log('Caller.release catch error, error.code: ' + JSON.stringify(releaseErr.code) +
+ ' error.message: ' + JSON.stringify(releaseErr.message));
+ }
+ }).catch((err) => {
+ console.log('Caller GetCaller error, error.code: ' + JSON.stringify(err.code) +
+ ' error.message: ' + JSON.stringify(err.message));
+ });
+ }
+ }
+ ```
+
+
+## Caller.on
+
+ on(type: "release", callback: OnReleaseCallback): void;
+
+注册通用组件服务端Stub（桩）断开监听通知。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | type | string | 是 | 监听releaseCall事件，固定为'release'。 |
+ | callback | OnReleaseCallBack | 是 | 返回onRelease回调结果。 |
+
+**错误码：**
+
+| 错误码ID | 错误信息 |
+| ------- | -------------------------------- |
+| 401 | Invalid input parameter. |
+| 16200001 | Caller released. The caller has been released. |
+| 16000050 | Internal Error. |
+
+**示例：**
+
+ ```ts
+ import Ability from '@ohos.app.ability.UIAbility';
+ var caller;
+ export default class MainAbility extends Ability {
+ onWindowStageCreate(windowStage) {
+ this.context.startAbilityByCall({
+ bundleName: "com.example.myservice",
+ abilityName: "MainAbility",
+ deviceId: ""
+ }).then((obj) => {
+ caller = obj;
+ try {
+ caller.on("release", (str) => {
+ console.log(' Caller OnRelease CallBack is called ' + str);
+ });
+ } catch (error) {
+ console.log('Caller.on catch error, error.code: ' + JSON.stringify(error.code) +
+ ' error.message: ' + JSON.stringify(error.message));
+ }
+ }).catch((err) => {
+ console.log('Caller GetCaller error, error.code: ' + JSON.stringify(err.code) +
+ ' error.message: ' + JSON.stringify(err.message));
+ });
+ }
+ }
+ ```
+
+
+## Callee
+
+通用组件服务端注册和解除客户端caller通知送信的callback接口。
+
+## Callee.on
+
+on(method: string, callback: CalleeCallBack): void;
+
+通用组件服务端注册消息通知callback。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | method | string | 是 | 与客户端约定的通知消息字符串。 |
+ | callback | CalleeCallBack | 是 | 一个rpc.MessageParcel类型入参的js通知同步回调函数, 回调函数至少要返回一个空的rpc.Sequenceable数据对象, 其他视为函数执行错误。 |
+
+**错误码：**
+
+| 错误码ID | 错误信息 |
+| ------- | -------------------------------- |
+| 401 | Invalid input parameter. |
+| 16200004 | Method registered. The method has registered. |
+| 16000050 | Internal Error. |
+
+**示例：**
+
+ ```ts
+ import Ability from '@ohos.app.ability.UIAbility';
+ class MyMessageAble{
+ name:""
+ str:""
+ num: 1
+ constructor(name, str) {
+ this.name = name;
+ this.str = str;
+ }
+ marshalling(messageParcel) {
+ messageParcel.writeInt(this.num);
+ messageParcel.writeString(this.str);
+ console.log('MyMessageAble marshalling num[' + this.num + '] str[' + this.str + ']');
+ return true;
+ }
+ unmarshalling(messageParcel) {
+ this.num = messageParcel.readInt();
+ this.str = messageParcel.readString();
+ console.log('MyMessageAble unmarshalling num[' + this.num + '] str[' + this.str + ']');
+ return true;
+ }
+ };
+ var method = 'call_Function';
+ function funcCallBack(pdata) {
+ console.log('Callee funcCallBack is called ' + pdata);
+ let msg = new MyMessageAble("test", "");
+ pdata.readSequenceable(msg);
+ return new MyMessageAble("test1", "Callee test");
+ }
+ export default class MainAbility extends Ability {
+ onCreate(want, launchParam) {
+ console.log('Callee onCreate is called');
+ try {
+ this.callee.on(method, funcCallBack);
+ } catch (error) {
+ console.log('Callee.on catch error, error.code: ' + JSON.stringify(error.code) +
+ ' error.message: ' + JSON.stringify(error.message));
+ }
+ }
+ }
+ ```
+
+## Callee.off
+
+off(method: string): void;
+
+解除通用组件服务端注册消息通知callback。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | method | string | 是 | 已注册的通知事件字符串。 |
+
+**错误码：**
+
+| 错误码ID | 错误信息 |
+| ------- | -------------------------------- |
+| 401 | Invalid input parameter. |
+| 16200005 | Method not registered. The method has not registered. |
+| 16000050 | Internal Error. |
+
+
+**示例：**
+
+ ```ts
+ import Ability from '@ohos.app.ability.UIAbility';
+ var method = 'call_Function';
+ export default class MainAbility extends Ability {
+ onCreate(want, launchParam) {
+ console.log('Callee onCreate is called');
+ try {
+ this.callee.off(method);
+ } catch (error) {
+ console.log('Callee.off catch error, error.code: ' + JSON.stringify(error.code) +
+ ' error.message: ' + JSON.stringify(error.message));
+ }
+ }
+ }
+ ```
+
+## OnReleaseCallback
+
+(msg: string): void;
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+| 名称 | 参数类型 | 可读 | 可写 | 说明 |
+| -------- | -------- | -------- | -------- | -------- |
+| (msg: string) | function | 是 | 否 | 调用者注册的侦听器函数接口的原型。 |
+
+## CalleeCallback
+
+(indata: rpc.MessageParcel): rpc.Sequenceable;
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+| 名称 | 参数类型 | 可读 | 可写 | 说明 |
+| -------- | -------- | -------- | -------- | -------- |
+| (indata: rpc.MessageParcel) | rpc.Sequenceable | 是 | 否 | 被调用方注册的消息侦听器函数接口的原型。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md
new file mode 100644
index 0000000000000000000000000000000000000000..5883fa0f25a90da259077335f81f8eadbb212aa1
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md
@@ -0,0 +1,136 @@
+# Want
+
+Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为startAbility的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据, 如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当Ability A需要启动Ability B并传入一些数据时, 可使用Want作为载体将这些数据传递给Ability B。
+
+> **说明：**
+>
+> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+
+## 导入类
+
+```ts
+import Want from '@ohos.app.ability.Want';
+```
+
+## 属性
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
+
+| 名称 | 读写属性 | 类型 | 必填 | 描述 |
+| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
+| deviceId | 只读 | string | 否 | 表示运行指定Ability的设备ID。 |
+| bundleName | 只读 | string | 否 | 表示包描述。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 |
+| abilityName | 只读 | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 |
+| uri | 只读 | string | 否 | 表示Uri描述。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme, schemeSpecificPart, authority和path信息。 |
+| type | 只读 | string | 否 | 表示MIME type类型描述，打开文件的类型，主要用于文管打开文件。比如："text/xml" 、 "image/*"等，MIME定义参考：https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。 |
+| flags | 只读 | number | 否 | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-ability-wantConstant.md#wantConstant.Flags)。 |
+| action | 只读 | string | 否 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。 |
+| parameters | 只读 | {[key: string]: any} | 否 | 表示WantParams描述，由开发者自行决定传入的键值对。默认会携带以下key值：
ohos.aafwk.callerPid 表示拉起方的pid。
ohos.aafwk.param.callerToken 表示拉起方的token。
ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。 |
+| entities | 只读 | Array\ | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 |
+| moduleName | 只读 | string | 否 | 表示待启动的Ability所属的模块（module）。 |
+
+**示例：**
+
+- 基础用法
+
+ ```ts
+ var want = {
+ "deviceId": "", // deviceId为空表示本设备
+ "bundleName": "com.extreme.test",
+ "abilityName": "MainAbility",
+ "moduleName": "entry" // moduleName非必选
+ };
+ this.context.startAbility(want, (error) => {
+ // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
+ console.log("error.code = " + error.code)
+ })
+ ```
+
+- 通过自定字段传递数据, 以下为当前支持类型。
+
+ * 字符串（String）
+ ```ts
+ let want = {
+ bundleName: "com.example.demo",
+ abilityName: "com.example.demo.MainAbility",
+ parameters: {
+ keyForString: "str",
+ },
+ }
+ ```
+ * 数字（Number）
+ ```ts
+ let want = {
+ bundleName: "com.example.demo",
+ abilityName: "com.example.demo.MainAbility",
+ parameters: {
+ keyForInt: 100,
+ keyForDouble: 99.99,
+ },
+ }
+ ```
+ * 布尔（Boolean）
+ ```ts
+ let want = {
+ bundleName: "com.example.demo",
+ abilityName: "com.example.demo.MainAbility",
+ parameters: {
+ keyForBool: true,
+ },
+ }
+ ```
+ * 对象（Object）
+ ```ts
+ let want = {
+ bundleName: "com.example.demo",
+ abilityName: "com.example.demo.MainAbility",
+ parameters: {
+ keyForObject: {
+ keyForObjectString: "str",
+ keyForObjectInt: -200,
+ keyForObjectDouble: 35.5,
+ keyForObjectBool: false,
+ },
+ },
+ }
+ ```
+ * 数组（Array）
+ ```ts
+ let want = {
+ bundleName: "com.example.demo",
+ abilityName: "com.example.demo.MainAbility",
+ parameters: {
+ keyForArrayString: ["str1", "str2", "str3"],
+ keyForArrayInt: [100, 200, 300, 400],
+ keyForArrayDouble: [0.1, 0.2],
+ keyForArrayObject: [{obj1: "aaa"}, {obj2: 100}],
+ },
+ }
+ ```
+ * 文件描述符（FD）
+ ```ts
+ import fileio from '@ohos.fileio';
+ var fd;
+ try {
+ fd = fileio.openSync("/data/storage/el2/base/haps/pic.png");
+ } catch(e) {
+ console.log("openSync fail:" + JSON.stringify(e));
+ }
+ var want = {
+ "deviceId": "", // deviceId为空表示本设备
+ "bundleName": "com.extreme.test",
+ "abilityName": "MainAbility",
+ "moduleName": "entry", // moduleName非必选
+ "parameters": {
+ "keyFd":{"type":"FD", "value":fd}
+ }
+ };
+ this.context.startAbility(want, (error) => {
+ // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
+ console.log("error.code = " + error.code)
+ })
+ ```
+
+
+
+
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-formbindingdata.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-formbindingdata.md
index f6e4870156599246ca4c859aa9e69623a11d1798..f363af617eef010ab0061ec3c2e2d24f77ae3c22 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-form-formbindingdata.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-formbindingdata.md
@@ -8,7 +8,7 @@
## 导入模块
-```
+```ts
import formBindingData from '@ohos.app.form.formBindingData';
```
@@ -47,7 +47,7 @@ createFormBindingData(obj?: Object | string): FormBindingData
**示例：**
-```js
+```ts
import featureAbility from '@ohos.ability.featureAbility';
import fileio from '@ohos.fileio';
let context=featureAbility.getContext();
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-formextensionability.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-formextensionability.md
index a02593062faa0edc0bde3809ca91f2b172ad93c0..dbc8583a880bbee9b370b7e6f0617fb04d4e2f5d 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-form-formextensionability.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-formextensionability.md
@@ -9,7 +9,7 @@ FormExtensionAbility模块提供了卡片扩展相关接口。
## 导入模块
-```
+```ts
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
```
@@ -19,7 +19,7 @@ import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| ------- | ------------------------------------------------------- | ---- | ---- | --------------------------------------------------- |
-| context | [FormExtensionContext](js-apis-formextensioncontext.md) | 是 | 否 | FormExtensionAbility的上下文环境，继承自ExtensionContext。 |
+| context | [FormExtensionContext](js-apis-inner-application-formExtensionContext.md) | 是 | 否 | FormExtensionAbility的上下文环境，继承自ExtensionContext。 |
## onAddForm
@@ -33,7 +33,7 @@ onAddForm(want: Want): formBindingData.FormBindingData
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------------------------------- | ---- | ------------------------------------------------------------ |
-| want | [Want](js-apis-application-Want.md) | 是 | 当前ExtensionAbility相关的Want类型信息，包括卡片ID、卡片名称、卡片样式等。这些卡片信息必须作为持久数据进行管理，以便后续更新和删除卡片。 |
+| want | [Want](js-apis-application-want.md) | 是 | 当前ExtensionAbility相关的Want类型信息，包括卡片ID、卡片名称、卡片样式等。这些卡片信息必须作为持久数据进行管理，以便后续更新和删除卡片。 |
**返回值：**
@@ -43,7 +43,7 @@ onAddForm(want: Want): formBindingData.FormBindingData
**示例：**
-```js
+```ts
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
export default class MyFormExtensionAbility extends FormExtensionAbility {
onAddForm(want) {
@@ -74,7 +74,7 @@ onCastToNormalForm(formId: string): void
**示例：**
-```js
+```ts
export default class MyFormExtensionAbility extends FormExtensionAbility {
onCastToNormalForm(formId) {
console.log('FormExtensionAbility onCastToNormalForm, formId:' + formId);
@@ -86,7 +86,7 @@ export default class MyFormExtensionAbility extends FormExtensionAbility {
onUpdateForm(formId: string): void
-卡片提供方接收更新卡片的通知接口。获取最新数据后调用[FormExtensionContext](js-apis-formextensioncontext.md)的updateForm接口刷新卡片数据。
+卡片提供方接收更新卡片的通知接口。获取最新数据后调用[FormExtensionContext](js-apis-inner-application-formExtensionContext.md)的updateForm接口刷新卡片数据。
**系统能力**：SystemCapability.Ability.Form
@@ -98,7 +98,7 @@ onUpdateForm(formId: string): void
**示例：**
-```js
+```ts
import formBindingData from '@ohos.app.form.formBindingData'
export default class MyFormExtensionAbility extends FormExtensionAbility {
onUpdateForm(formId) {
@@ -128,7 +128,7 @@ onChangeFormVisibility(newStatus: { [key: string]: number }): void
**示例：**
-```js
+```ts
import formBindingData from '@ohos.app.form.formBindingData'
export default class MyFormExtensionAbility extends FormExtensionAbility {
onChangeFormVisibility(newStatus) {
@@ -163,7 +163,7 @@ onFormEvent(formId: string, message: string): void
**示例：**
-```js
+```ts
export default class MyFormExtension extends FormExtensionAbility {
onFormEvent(formId, message) {
console.log('FormExtensionAbility onFormEvent, formId:' + formId + ", message:" + message);
@@ -187,7 +187,7 @@ onRemoveForm(formId: string): void
**示例：**
-```js
+```ts
export default class MyFormExtensionAbility extends FormExtensionAbility {
onRemoveForm(formId) {
console.log('FormExtensionAbility onRemoveForm, formId:' + formId);
@@ -211,7 +211,7 @@ onConfigurationUpdate(config: Configuration): void;
**示例：**
-```js
+```ts
class MyFormExtensionAbility extends FormExtensionAbility {
onConfigurationUpdate(config) {
console.log('onConfigurationUpdate, config:' + JSON.stringify(config));
@@ -231,11 +231,11 @@ onAcquireFormState?(want: Want): formInfo.FormState;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-application-Want.md) | 否 | want表示获取卡片状态的描述。描述包括包名称、能力名称、模块名称、卡片名和卡片维度。 |
+| want | [Want](js-apis-application-want.md) | 否 | want表示获取卡片状态的描述。描述包括包名称、能力名称、模块名称、卡片名和卡片维度。 |
**示例：**
-```js
+```ts
import formInfo from '@ohos.app.form.formInfo';
class MyFormExtensionAbility extends FormExtensionAbility {
onAcquireFormState(want) {
@@ -269,7 +269,7 @@ onShareForm?(formId: string): { [key: string]: any }
**示例：**
-```js
+```ts
class MyFormExtensionAbility extends FormExtensionAbility {
onShareForm(formId) {
console.log('FormExtensionAbility onShareForm, formId:' + formId);
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-formhost.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-formhost.md
index a47a3dcfb98c1bc4996bf4df835509d1db2f212b..ad6cb2ceb1e118d09891c0925a12fd92fb925ab6 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-form-formhost.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-formhost.md
@@ -9,7 +9,7 @@ FormHost模块提供了卡片使用方相关接口的能力，包括对使用方
## 导入模块
-```
+```ts
import formHost from '@ohos.app.form.formHost';
```
@@ -40,7 +40,7 @@ deleteForm(formId: string, callback: AsyncCallback<void>): void
**示例：**
-```js
+```ts
try {
var formId = "12400633174999288";
formHost.deleteForm(formId, (error, data) => {
@@ -89,7 +89,7 @@ deleteForm(formId: string): Promise<void>
**参数：**
-```js
+```ts
try {
var formId = "12400633174999288";
formHost.deleteForm(formId).then(() => {
@@ -129,7 +129,7 @@ releaseForm(formId: string, callback: AsyncCallback<void>): void
**示例：**
-```js
+```ts
try {
var formId = "12400633174999288";
formHost.releaseForm(formId, (error, data) => {
@@ -170,7 +170,7 @@ releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback<
**示例：**
-```js
+```ts
try {
var formId = "12400633174999288";
formHost.releaseForm(formId, true, (error, data) => {
@@ -216,7 +216,7 @@ releaseForm(formId: string, isReleaseCache?: boolean): Promise<void>
**示例：**
-```js
+```ts
try {
var formId = "12400633174999288";
formHost.releaseForm(formId, true).then(() => {
@@ -256,7 +256,7 @@ requestForm(formId: string, callback: AsyncCallback<void>): void
**示例：**
-```js
+```ts
try {
var formId = "12400633174999288";
formHost.requestForm(formId, (error, data) => {
@@ -301,7 +301,7 @@ requestForm(formId: string): Promise<void>
**示例：**
-```js
+```ts
try {
var formId = "12400633174999288";
formHost.requestForm(formId).then(() => {
@@ -342,7 +342,7 @@ castTempForm(formId: string, callback: AsyncCallback<void>): void
**示例：**
-```js
+```ts
try {
var formId = "12400633174999288";
formHost.castTempForm(formId, (error, data) => {
@@ -387,7 +387,7 @@ castTempForm(formId: string): Promise<void>
**示例：**
-```js
+```ts
try {
var formId = "12400633174999288";
formHost.castTempForm(formId).then(() => {
@@ -426,7 +426,7 @@ notifyVisibleForms(formIds: Array<string>, callback: AsyncCallback<void
**示例：**
-```js
+```ts
try {
var formId = ["12400633174999288"];
formHost.notifyVisibleForms(formId, (error, data) => {
@@ -470,7 +470,7 @@ notifyVisibleForms(formIds: Array<string>): Promise<void>
**示例：**
-```js
+```ts
try {
var formId = ["12400633174999288"];
formHost.notifyVisibleForms(formId).then(() => {
@@ -509,7 +509,7 @@ notifyInvisibleForms(formIds: Array<string>, callback: AsyncCallback<vo
**示例：**
-```js
+```ts
try {
var formId = ["12400633174999288"];
formHost.notifyInvisibleForms(formId, (error, data) => {
@@ -553,7 +553,7 @@ notifyInvisibleForms(formIds: Array<string>): Promise<void>
**示例：**
-```js
+```ts
try {
var formId = ["12400633174999288"];
formHost.notifyInvisibleForms(formId).then(() => {
@@ -593,7 +593,7 @@ enableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void&
**示例：**
-```js
+```ts
try {
var formId = ["12400633174999288"];
formHost.enableFormsUpdate(formId, (error, data) => {
@@ -638,7 +638,7 @@ enableFormsUpdate(formIds: Array<string>): Promise<void>
**示例：**
-```js
+```ts
try {
var formId = ["12400633174999288"];
formHost.enableFormsUpdate(formId).then(() => {
@@ -678,7 +678,7 @@ disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void
**示例：**
-```js
+```ts
try {
var formId = ["12400633174999288"];
formHost.disableFormsUpdate(formId, (error, data) => {
@@ -723,7 +723,7 @@ disableFormsUpdate(formIds: Array<string>): Promise<void>
**示例：**
-```js
+```ts
try {
var formId = ["12400633174999288"];
formHost.disableFormsUpdate(formId).then(() => {
@@ -752,7 +752,7 @@ isSystemReady(callback: AsyncCallback<void>): void
**示例：**
-```js
+```ts
try {
var formId = "12400633174999288";
formHost.isSystemReady((error, data) => {
@@ -781,7 +781,7 @@ isSystemReady(): Promise<void>
**示例：**
-```js
+```ts
try {
var formId = "12400633174999288";
formHost.isSystemReady().then(() => {
@@ -808,11 +808,11 @@ getAllFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>):
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
-| callback | AsyncCallback<Array<[FormInfo](./js-apis-formInfo.md#forminfo-1)>> | 是 | 回调函数。当获取设备上所有应用提供的卡片信息成功，err为undefined，data为查询到的卡片信息；否则为错误对象。 |
+| callback | AsyncCallback<Array<[FormInfo](js-apis-app-form-forminfo.md)>> | 是 | 回调函数。当获取设备上所有应用提供的卡片信息成功，err为undefined，data为查询到的卡片信息；否则为错误对象。 |
**示例：**
-```js
+```ts
try {
formHost.getAllFormsInfo((error, data) => {
if (error) {
@@ -840,11 +840,11 @@ getAllFormsInfo(): Promise<Array<formInfo.FormInfo>>
| 类型 | 说明 |
| :------------ | :---------------------------------- |
-| Promise<Array<[FormInfo](./js-apis-formInfo.md#forminfo-1)>> | Promise对象，返回查询到的卡片信息。 |
+| Promise<Array<[FormInfo](js-apis-app-form-forminfo.md)>> | Promise对象，返回查询到的卡片信息。 |
**示例：**
-```js
+```ts
try {
formHost.getAllFormsInfo().then((data) => {
console.log('formHost getAllFormsInfo data:' + JSON.stringify(data));
@@ -871,7 +871,7 @@ getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.Fo
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
-| callback | AsyncCallback<Array<[FormInfo](./js-apis-formInfo.md#forminfo-1)>> | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功，err为undefined，data为查询到的卡片信息；否则为错误对象。 |
+| callback | AsyncCallback<Array<[FormInfo](js-apis-app-form-forminfo.md)>> | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功，err为undefined，data为查询到的卡片信息；否则为错误对象。 |
**错误码：**
@@ -882,7 +882,7 @@ getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.Fo
**示例：**
-```js
+```ts
try {
formHost.getFormsInfo("com.example.ohos.formjsdemo", (error, data) => {
if (error) {
@@ -912,7 +912,7 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<
| ------ | ------ | ---- | ------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| moduleName | string | 是 | 要查询的模块名称。 |
-| callback | AsyncCallback<Array<[FormInfo](./js-apis-formInfo.md#forminfo-1)>> | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功，err为undefined，data为查询到的卡片信息；否则为错误对象。 |
+| callback | AsyncCallback<Array<[FormInfo](js-apis-app-form-forminfo.md)>> | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功，err为undefined，data为查询到的卡片信息；否则为错误对象。 |
**错误码：**
@@ -923,7 +923,7 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<
**示例：**
-```js
+```ts
try {
formHost.getFormsInfo("com.example.ohos.formjsdemo", "entry", (error, data) => {
if (error) {
@@ -958,7 +958,7 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formI
| 类型 | 说明 |
| :------------ | :---------------------------------- |
-| Promise<Array<[FormInfo](./js-apis-formInfo.md#forminfo-1)>> | Promise对象，返回查询到的卡片信息。 |
+| Promise<Array<[FormInfo](js-apis-app-form-forminfo.md)>> | Promise对象，返回查询到的卡片信息。 |
**错误码：**
@@ -969,7 +969,7 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formI
**示例：**
-```js
+```ts
try {
formHost.getFormsInfo("com.example.ohos.formjsdemo", "entry").then((data) => {
console.log('formHost getFormsInfo, data:' + JSON.stringify(data));
@@ -1000,7 +1000,7 @@ deleteInvalidForms(formIds: Array<string>, callback: AsyncCallback<numb
**示例：**
-```js
+```ts
try {
var formIds = new Array("12400633174999288", "12400633174999289");
formHost.deleteInvalidForms(formIds, (error, data) => {
@@ -1039,7 +1039,7 @@ deleteInvalidForms(formIds: Array<string>): Promise<number>
**示例：**
-```js
+```ts
try {
var formIds = new Array("12400633174999288", "12400633174999289");
formHost.deleteInvalidForms(formIds).then((data) => {
@@ -1066,8 +1066,8 @@ acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo&g
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 查询卡片状态时携带的want信息。 |
-| callback | AsyncCallback<[FormStateInfo](js-apis-formInfo.md#formstateinfo)> | 是 | 回调函数。当获取卡片状态成功，err为undefined，data为获取到的卡片状态；否则为错误对象。 |
+| want | [Want](js-apis-application-want.md) | 是 | 查询卡片状态时携带的want信息。 |
+| callback | AsyncCallback<[FormStateInfo](js-apis-app-form-forminfo.md#formstateinfo)> | 是 | 回调函数。当获取卡片状态成功，err为undefined，data为获取到的卡片状态；否则为错误对象。 |
**错误码：**
@@ -1078,7 +1078,7 @@ acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo&g
**示例：**
-```js
+```ts
var want = {
"deviceId": "",
"bundleName": "ohos.samples.FormApplication",
@@ -1116,13 +1116,13 @@ acquireFormState(want: Want): Promise<formInfo.FormStateInfo>
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 查询卡片状态时携带的want信息。 |
+| want | [Want](js-apis-application-want.md) | 是 | 查询卡片状态时携带的want信息。 |
**返回值：**
| 类型 | 说明 |
| :------------ | :---------------------------------- |
-| Promise<[FormStateInfo](js-apis-formInfo.md#formstateinfo)> | Promise对象，返回卡片状态。 |
+| Promise<[FormStateInfo](js-apis-app-form-forminfo.md#formstateinfo)> | Promise对象，返回卡片状态。 |
**错误码：**
@@ -1133,7 +1133,7 @@ acquireFormState(want: Want): Promise<formInfo.FormStateInfo>
**示例：**
-```js
+```ts
var want = {
"deviceId": "",
"bundleName": "ohos.samples.FormApplication",
@@ -1172,7 +1172,7 @@ on(type: "formUninstall", callback: Callback<string>): void
**示例：**
-```js
+```ts
let callback = function(formId) {
console.log('formHost on formUninstall, formId:' + formId);
}
@@ -1196,7 +1196,7 @@ off(type: "formUninstall", callback?: Callback<string>): void
**示例：**
-```js
+```ts
let callback = function(formId) {
console.log('formHost on formUninstall, formId:' + formId);
}
@@ -1230,7 +1230,7 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: A
**示例：**
-```js
+```ts
var formIds = new Array("12400633174999288", "12400633174999289");
try {
formHost.notifyFormsVisible(formIds, true, (error, data) => {
@@ -1275,7 +1275,7 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise<
**示例：**
-```js
+```ts
var formIds = new Array("12400633174999288", "12400633174999289");
try {
formHost.notifyFormsVisible(formIds, true).then(() => {
@@ -1315,7 +1315,7 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, c
**示例：**
-```js
+```ts
var formIds = new Array("12400633174999288", "12400633174999289");
try {
formHost.notifyFormsEnableUpdate(formIds, true, (error, data) => {
@@ -1360,7 +1360,7 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean):
**示例：**
-```js
+```ts
var formIds = new Array("12400633174999288", "12400633174999289");
try {
formHost.notifyFormsEnableUpdate(formIds, true).then(() => {
@@ -1401,7 +1401,7 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>)
**示例：**
-```js
+```ts
var formId = "12400633174999288";
var deviceId = "EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2";
try {
@@ -1448,7 +1448,7 @@ shareForm(formId: string, deviceId: string): Promise<void>
**参数：**
-```js
+```ts
var formId = "12400633174999288";
var deviceId = "EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2";
try {
@@ -1477,7 +1477,7 @@ notifyFormsPrivacyProtected(formIds: Array, isProtected: boolean, callba
| formId | string | 是 | 卡片标识。 |
| deviceId | string | 是 | 远程设备标识。 |
-```js
+```ts
var formIds = new Array("12400633174999288", "12400633174999289");
try {
formHost.notifyFormsPrivacyProtected(formIds, true).then(() => {
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-forminfo.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-forminfo.md
index 863a94ca6996aede70322deb5e21ad25398fd8a8..e6b41c61cc7c44846687c122a67b851582972bfc 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-form-forminfo.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-forminfo.md
@@ -8,7 +8,7 @@ FormInfo模块提供对卡片的相关卡片信息和状态进行设置和查询
## 导入模块
-```
+```ts
import formInfo from '@ohos.app.form.formInfo';
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-formprovider.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-formprovider.md
index 6b07b85c77ccb627edad9ce6957b174e47671a64..5a1a7049193b5a0a916538794c5f7bccf4d829e2 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-app-form-formprovider.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-formprovider.md
@@ -7,7 +7,7 @@ FormProvider模块提供了卡片提供方相关接口的能力，开发者在
## 导入模块
-```
+```ts
import formProvider from '@ohos.app.form.formProvider';
```
@@ -37,7 +37,7 @@ setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback&l
**示例：**
-```js
+```ts
var formId = "12400633174999288";
try {
formProvider.setFormNextRefreshTime(formId, 5, (error, data) => {
@@ -85,7 +85,7 @@ setFormNextRefreshTime(formId: string, minute: number): Promise<void>
**示例：**
-```js
+```ts
var formId = "12400633174999288";
try {
formProvider.setFormNextRefreshTime(formId, 5).then(() => {
@@ -111,7 +111,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| formId | string | 是 | 请求更新的卡片标识。 |
-| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 |
+| formBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 |
| callback | AsyncCallback<void> | 是 | 回调函数。 |
**错误码：**
@@ -123,7 +123,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call
**示例：**
-```js
+```ts
import formBindingData from '@ohos.application.formBindingData';
var formId = "12400633174999288";
try {
@@ -153,7 +153,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| formId | string | 是 | 请求更新的卡片标识。 |
-| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 |
+| formBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 |
**返回值：**
@@ -170,7 +170,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
**示例：**
-```js
+```ts
import formBindingData from '@ohos.application.formBindingData';
var formId = "12400633174999288";
let obj = formBindingData.createFormBindingData({temperature:"22c", time:"22:00"});
@@ -197,7 +197,7 @@ getFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>): voi
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
-| callback | AsyncCallback<Array<[FormInfo](./js-apis-formInfo.md#forminfo-1)>> | 是 | 回调函数。返回查询到的卡片信息。 |
+| callback | AsyncCallback<Array<[FormInfo](js-apis-app-form-forminfo.md)>> | 是 | 回调函数。返回查询到的卡片信息。 |
**错误码：**
@@ -209,7 +209,7 @@ getFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>): voi
**示例：**
-```js
+```ts
try {
formProvider.getFormsInfo((error, data) => {
if (error) {
@@ -234,8 +234,8 @@ getFormsInfo(filter: formInfo.FormInfoFilter, callback: AsyncCallback<Array&l
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
-| filter | [formInfo.FormInfoFilter](./js-apis-formInfo.md#forminfofilter) | 是 | 卡片信息过滤器。 |
-| callback | AsyncCallback<Array<[FormInfo](./js-apis-formInfo.md#forminfo-1)>> | 是 | 回调函数。返回查询到符合条件的卡片信息。 |
+| filter | [formInfo.FormInfoFilter](js-apis-app-form-forminfo.md#forminfofilter) | 是 | 卡片信息过滤器。 |
+| callback | AsyncCallback<Array<[FormInfo](js-apis-app-form-forminfo.md)>> | 是 | 回调函数。返回查询到符合条件的卡片信息。 |
**错误码：**
@@ -246,7 +246,7 @@ getFormsInfo(filter: formInfo.FormInfoFilter, callback: AsyncCallback<Array&l
**示例：**
-```js
+```ts
import formInfo from '@ohos.application.formInfo';
const filter : formInfo.FormInfoFilter = {
// get info of forms belong to module entry.
@@ -277,13 +277,13 @@ getFormsInfo(filter?: formInfo.FormInfoFilter): Promise<Array<formInfo.For
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
-| filter | [formInfo.FormInfoFilter](./js-apis-formInfo.md) | 否 | 卡片信息过滤器。 |
+| filter | [formInfo.FormInfoFilter](js-apis-app-form-forminfo.md#forminfofilter) | 否 | 卡片信息过滤器。 |
**返回值：**
| 类型 | 说明 |
| :------------ | :---------------------------------- |
-| Promise<Array<[FormInfo](./js-apis-formInfo.md#forminfo-1)>> | Promise对象。返回查询到符合条件的卡片信息。 |
+| Promise<Array<[FormInfo](js-apis-app-form-forminfo.md)>> | Promise对象。返回查询到符合条件的卡片信息。 |
**错误码：**
@@ -294,7 +294,7 @@ getFormsInfo(filter?: formInfo.FormInfoFilter): Promise<Array<formInfo.For
**示例：**
-```js
+```ts
import formInfo from '@ohos.application.formInfo';
const filter : formInfo.FormInfoFilter = {
// get info of forms belong to module entry.
@@ -325,8 +325,8 @@ requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData,
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
-| want | [Want](js-apis-application-Want.md) | 是 | 发布请求。需包含以下字段。
abilityName: 目标卡片ability
parameters:
"ohos.extra.param.key.form_dimension"
"ohos.extra.param.key.form_name"
"ohos.extra.param.key.module_name" |
-| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是 | 创建卡片的数据。 |
+| want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。
abilityName: 目标卡片ability
parameters:
"ohos.extra.param.key.form_dimension"
"ohos.extra.param.key.form_name"
"ohos.extra.param.key.module_name" |
+| formBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 是 | 创建卡片的数据。 |
| callback | AsyncCallback<string> | 是 | 回调函数。返回卡片标识。 |
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。
@@ -336,7 +336,7 @@ requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData,
**示例：**
-```js
+```ts
import formBindingData from '@ohos.application.formBindingData';
var want = {
abilityName: "FormAbility",
@@ -374,7 +374,7 @@ requestPublishForm(want: Want, callback: AsyncCallback<string>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------- | ---- | ------------------------------------------------------------ |
-| want | [Want](js-apis-application-Want.md) | 是 | 发布请求。需包含以下字段。
abilityName: 目标卡片ability
parameters:
"ohos.extra.param.key.form_dimension"
"ohos.extra.param.key.form_name"
"ohos.extra.param.key.module_name" |
+| want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。
abilityName: 目标卡片ability
parameters:
"ohos.extra.param.key.form_dimension"
"ohos.extra.param.key.form_name"
"ohos.extra.param.key.module_name" |
| callback | AsyncCallback<string> | 是 | 回调函数。返回卡片标识。 |
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。
@@ -384,7 +384,7 @@ requestPublishForm(want: Want, callback: AsyncCallback<string>): void
**示例：**
-```js
+```ts
var want = {
abilityName: "FormAbility",
parameters: {
@@ -421,8 +421,8 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData
| 参数名 | 类型 | 必填 | 说明 |
| --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| want | [Want](js-apis-application-Want.md) | 是 | 发布请求。需包含以下字段。
abilityName: 目标卡片ability
parameters:
"ohos.extra.param.key.form_dimension"
"ohos.extra.param.key.form_name"
"ohos.extra.param.key.module_name" |
-| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 否 | 创建卡片的数据。 |
+| want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。
abilityName: 目标卡片ability
parameters:
"ohos.extra.param.key.form_dimension"
"ohos.extra.param.key.form_name"
"ohos.extra.param.key.module_name" |
+| formBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 否 | 创建卡片的数据。 |
**返回值：**
@@ -437,7 +437,7 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData
**示例：**
-```js
+```ts
var want = {
abilityName: "FormAbility",
parameters: {
@@ -475,7 +475,7 @@ isRequestPublishFormSupported(callback: AsyncCallback<boolean>): void
**示例：**
-```js
+```ts
try {
formProvider.isRequestPublishFormSupported((error, isSupported) => {
if (error) {
@@ -528,7 +528,7 @@ isRequestPublishFormSupported(): Promise<boolean>
**示例：**
-```js
+```ts
try {
formProvider.isRequestPublishFormSupported().then((isSupported) => {
if (isSupported) {
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-ability.md b/zh-cn/application-dev/reference/apis/js-apis-application-ability.md
index e704a1b8c31e0bae481cc5446e2dfd2c49d83129..1d741d09b918bdd6b4f690044642f0ffd7c641ca 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-ability.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-ability.md
@@ -14,7 +14,7 @@ Ability模块提供对Ability生命周期、上下文环境等调用管理的能
## 导入模块
-```
+```ts
import Ability from '@ohos.application.Ability';
```
@@ -22,11 +22,11 @@ import Ability from '@ohos.application.Ability';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.AbilityCore
-| 名称 | 类型 | 可读 | 可写 | 说明 |
+| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
-| context | [AbilityContext](js-apis-ability-context.md) | 是 | 否 | 上下文。 |
-| launchWant | [Want](js-apis-application-Want.md) | 是 | 否 | Ability启动时的参数。 |
-| lastRequestWant | [Want](js-apis-application-Want.md) | 是 | 否 | Ability最后请求时的参数。|
+| context | [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md) | 是 | 否 | 上下文。 |
+| launchWant | [Want](js-apis-app-ability-want.md) | 是 | 否 | Ability启动时的参数。 |
+| lastRequestWant | [Want](js-apis-app-ability-want.md) | 是 | 否 | Ability最后请求时的参数。|
| callee | [Callee](#callee) | 是 | 否 | 调用Stub（桩）服务对象。|
## Ability.onCreate
@@ -41,7 +41,7 @@ Ability创建时回调，执行初始化业务逻辑操作。
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | want | [Want](js-apis-application-Want.md) | 是 | 当前Ability的Want类型信息，包括ability名称、bundle名称等。 |
+ | want | [Want](js-apis-app-ability-want.md) | 是 | 当前Ability的Want类型信息，包括ability名称、bundle名称等。 |
| param | AbilityConstant.LaunchParam | 是 | 创建 ability、上次异常退出的原因信息。 |
**示例：**
@@ -227,7 +227,7 @@ onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | want | [Want](js-apis-application-Want.md) | 是 | Want类型参数，如ability名称，包名等。 |
+ | want | [Want](js-apis-application-want.md) | 是 | Want类型参数，如ability名称，包名等。 |
| launchParams | AbilityConstant.LaunchParam | 是 | Ability启动的原因、上次异常退出的原因信息。 |
**示例：**
@@ -240,31 +240,6 @@ onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void;
}
```
-
-## Ability.onConfigurationUpdated
-
-onConfigurationUpdated(config: Configuration): void;
-
-当系统配置更新时调用。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
-
-**参数：**
-
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | config | [Configuration](js-apis-configuration.md) | 是 | 表示需要更新的配置信息。 |
-
-**示例：**
-
- ```ts
- class myAbility extends Ability {
- onConfigurationUpdated(config) {
- console.log('onConfigurationUpdated, config:' + JSON.stringify(config));
- }
- }
- ```
-
## Ability.dump
dump(params: Array\): Array\;
@@ -290,30 +265,6 @@ dump(params: Array\): Array\;
}
```
-## Ability.onMemoryLevel
-
-onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
-
-当系统已决定调整内存时调用。例如，当该功能在后台运行时，没有足够的内存来运行尽可能多的后台进程时可以使用。
-
-**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
-
-**参数：**
-
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | level | [AbilityConstant.MemoryLevel](js-apis-application-abilityConstant.md#abilityconstantmemorylevel) | 是 | 回调返回内存微调级别，显示当前内存使用状态。|
-
-**示例：**
-
- ```ts
- class myAbility extends Ability {
- onMemoryLevel(level) {
- console.log('onMemoryLevel, level:' + JSON.stringify(level));
- }
- }
- ```
-
## Ability.onSaveState
@@ -338,7 +289,7 @@ onSaveState(reason: AbilityConstant.StateType, wantParam : {[key: string]: any})
**示例：**
- ```js
+ ```ts
import AbilityConstant from '@ohos.application.AbilityConstant'
class myAbility extends Ability {
@@ -679,9 +630,9 @@ on(method: string, callback: CalleeCallBack): void;
var method = 'call_Function';
function funcCallBack(pdata) {
console.log('Callee funcCallBack is called ' + pdata);
- let msg = new MyMessageAble(0, "");
+ let msg = new MyMessageAble("test", "");
pdata.readSequenceable(msg);
- return new MyMessageAble(10, "Callee test");
+ return new MyMessageAble("test1", "Callee test");
}
export default class MainAbility extends Ability {
onCreate(want, launchParam) {
@@ -743,7 +694,7 @@ off(method: string): void;
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
-| 名称 | 类型 | 可读 | 可写 | 说明 |
+| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| (msg: string) | function | 是 | 否 | 调用者注册的侦听器函数接口的原型。 |
@@ -753,6 +704,6 @@ off(method: string): void;
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
-| 名称 | 类型 | 可读 | 可写 | 说明 |
+| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
-| (indata: rpc.MessageParcel) | rpc.Sequenceable | 是 | 否 | 被调用方注册的消息侦听器函数接口的原型。 |
+| (indata: rpc.MessageParcel) | rpc.Sequenceable | 是 | 否 | 被调用方注册的消息侦听器函数接口的原型。 |
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md
index ea4b5d4a263390d6e3895548956d987b1b5e02b6..163a0b0495c058fa7f1dc2b72093433df006d609 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md
@@ -11,7 +11,7 @@ AbilityConstant提供启动参数的接口的能力，包括设置初次开始
## 导入模块
-```js
+```ts
import AbilityConstant from '@ohos.application.AbilityConstant';
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-abilityDelegatorRegistry.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md
similarity index 82%
rename from zh-cn/application-dev/reference/apis/js-apis-abilityDelegatorRegistry.md
rename to zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md
index 1f252068811dfc1a90dfc1b0a64d72e363fd057a..488b266d0cff1262aea623ce5d31870d02bebb99 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-abilityDelegatorRegistry.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md
@@ -1,74 +1,72 @@
-# AbilityDelegatorRegistry
-
-AbilityDelegatorRegistry模块提供用于存储已注册的AbilityDelegator和AbilityDelegatorArgs对象的全局寄存器的能力，包括获取应用程序的AbilityDelegator对象、获取单元测试参数AbilityDelegatorArgs对象。
-
-> **说明：**
->
-> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-
-## 导入模块
-
-```js
-import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
-```
-
-## AbilityLifecycleState
-
-Ability生命周期状态。
-
-**系统能力** ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
-
-| 名称 | 值 | 说明 |
-| ------------- | ---- | --------------------------- |
-| UNINITIALIZED | 0 | 表示无效状态。 |
-| CREATE | 1 | 表示Ability处于已创建状态。 |
-| FOREGROUND | 2 | 表示Ability处于前台状态。 |
-| BACKGROUND | 3 | 表示Ability处于后台状态。 |
-| DESTROY | 4 | 表示Ability处于已销毁状态。 |
-
-## AbilityDelegatorRegistry.getAbilityDelegator
-
-getAbilityDelegator(): AbilityDelegator
-
-获取应用程序的AbilityDelegator对象
-
-**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
-
-**返回值：**
-
-| 类型 | 说明 |
-| ------------------------------------------------------------ | ------------------------------------------------------------ |
-| [AbilityDelegator](js-apis-application-abilityDelegator.md#AbilityDelegator) | [AbilityDelegator](js-apis-application-abilityDelegator.md#AbilityDelegator)对象。可以用来调度测试框架相关功能。 |
-
-**示例：**
-
-```js
-var abilityDelegator;
-
-abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
-```
-
-
-
-## AbilityDelegatorRegistry.getArguments
-
-getArguments(): AbilityDelegatorArgs
-
-获取单元测试参数AbilityDelegatorArgs对象
-
-**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
-
-**返回值：**
-
-| 类型 | 说明 |
-| ------------------------------------------------------------ | ------------------------------------------------------------ |
-| [AbilityDelegatorArgs](js-apis-application-abilityDelegatorArgs.md#AbilityDelegatorArgs) | [AbilityDelegatorArgs](js-apis-application-abilityDelegatorArgs.md#AbilityDelegatorArgs)对象。可以用来获取测试参数。 |
-
-**示例：**
-
-```js
-var args = AbilityDelegatorRegistry.getArguments();
-console.info("getArguments bundleName:" + args.bundleName);
-console.info("getArguments testCaseNames:" + args.testCaseNames);
-console.info("getArguments testRunnerClassName:" + args.testRunnerClassName);
-```
+# AbilityDelegatorRegistry
+
+AbilityDelegatorRegistry模块提供用于存储已注册的AbilityDelegator和AbilityDelegatorArgs对象的全局寄存器的能力，包括获取应用程序的AbilityDelegator对象、获取单元测试参数AbilityDelegatorArgs对象。
+
+> **说明：**
+>
+> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+
+## 导入模块
+
+```ts
+import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
+```
+
+## AbilityLifecycleState
+
+Ability生命周期状态。
+
+**系统能力** ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+| 名称 | 值 | 说明 |
+| ------------- | ---- | --------------------------- |
+| UNINITIALIZED | 0 | 表示无效状态。 |
+| CREATE | 1 | 表示Ability处于已创建状态。 |
+| FOREGROUND | 2 | 表示Ability处于前台状态。 |
+| BACKGROUND | 3 | 表示Ability处于后台状态。 |
+| DESTROY | 4 | 表示Ability处于已销毁状态。 |
+
+## AbilityDelegatorRegistry.getAbilityDelegator
+
+getAbilityDelegator(): AbilityDelegator
+
+获取应用程序的AbilityDelegator对象
+
+**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+| 类型 | 说明 |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| [AbilityDelegator](js-apis-inner-application-abilityDelegator.md#AbilityDelegator) | [AbilityDelegator](js-apis-inner-application-abilityDelegator.md#AbilityDelegator)对象。可以用来调度测试框架相关功能。 |
+
+**示例：**
+
+```ts
+var abilityDelegator;
+
+abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+```
+
+## AbilityDelegatorRegistry.getArguments
+
+getArguments(): AbilityDelegatorArgs
+
+获取单元测试参数AbilityDelegatorArgs对象
+
+**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+| 类型 | 说明 |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| [AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md#AbilityDelegatorArgs) | [AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md#AbilityDelegatorArgs)对象。可以用来获取测试参数。 |
+
+**示例：**
+
+```ts
+var args = AbilityDelegatorRegistry.getArguments();
+console.info("getArguments bundleName:" + args.bundleName);
+console.info("getArguments testCaseNames:" + args.testCaseNames);
+console.info("getArguments testRunnerClassName:" + args.testRunnerClassName);
+```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md
index 08bad2d65f1b7e08ba19b551d01e04d2ccca2918..59fb80485ca99bb78d85658c9e33ba08c67fa2ee 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md
@@ -10,7 +10,7 @@ AbilityLifecycleCallback模块提供应用上下文ApplicationContext的生命
## 导入模块
-```js
+```ts
import AbilityLifecycleCallback from "@ohos.application.AbilityLifecycleCallback";
```
@@ -156,7 +156,7 @@ onAbilityContinue(ability: Ability): void;
**示例：**
-```js
+```ts
import AbilityStage from "@ohos.application.AbilityStage";
var lifecycleid;
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md
index 34595bc0138a11d854c8646fb8bdb058eb077908..0128d821ce6030d7d6bb4443298228d1918305ea 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md
@@ -4,12 +4,12 @@ AbilityManager模块提供对Ability相关信息和状态信息进行获取、
> **说明：**
>
-> 本模块首批接口从API version 8开始支持, 从API version 9废弃，替换模块为[@ohos.app.ability.abilityManager](js-apis-app-ability-abilityManager.md)。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口均为系统接口，三方应用不支持调用。
## 导入模块
-```js
+```ts
import AbilityManager from '@ohos.application.abilityManager'
```
@@ -41,14 +41,14 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\): void
**参数**：
-| 名称 | 类型 | 必填 | 说明 |
+| 名称 | 类型 | 必填 | 描述 |
| --------- | ---------------------------------------- | ---- | -------------- |
-| config | [Configuration](js-apis-configuration.md) | 是 | 新的配置项。 |
+| config | [Configuration](js-apis-application-configuration.md) | 是 | 新的配置项。 |
| callback | AsyncCallback\ | 是 | 被指定的回调方法。 |
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.application.abilityManager';
var config = {
@@ -72,9 +72,9 @@ updateConfiguration(config: Configuration): Promise\
**参数**：
-| 名称 | 类型 | 必填 | 说明 |
+| 名称 | 类型 | 必填 | 描述 |
| --------- | ---------------------------------------- | ---- | -------------- |
-| config | [Configuration](js-apis-configuration.md) | 是 | 新的配置项。 |
+| config | [Configuration](js-apis-application-configuration.md) | 是 | 新的配置项。 |
**返回值：**
@@ -84,7 +84,7 @@ updateConfiguration(config: Configuration): Promise\
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.application.abilityManager';
var config = {
@@ -110,13 +110,13 @@ getAbilityRunningInfos(callback: AsyncCallback\>): vo
**参数**：
-| 名称 | 类型 | 必填 | 说明 |
+| 名称 | 类型 | 必填 | 描述 |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\> | 是 | 被指定的回调方法。 |
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.application.abilityManager';
abilitymanager.getAbilityRunningInfos((err,data) => {
@@ -142,7 +142,7 @@ getAbilityRunningInfos(): Promise\>
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.application.abilityManager';
abilitymanager.getAbilityRunningInfos().then((data) => {
@@ -164,14 +164,14 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\> | 是 | 被指定的回调方法。 |
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.application.abilityManager';
var upperLimit = 0;
@@ -193,7 +193,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\): void;
**参数**：
-| 名称 | 类型 | 必填 | 说明 |
+| 名称 | 类型 | 必填 | 描述 |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\ | 是 | 被指定的回调方法。 |
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.application.abilityManager';
abilitymanager.getTopAbility((err,data) => {
@@ -257,7 +257,7 @@ getTopAbility(): Promise\;
**示例**：
-```js
+```ts
import abilitymanager from '@ohos.application.abilityManager';
abilitymanager.getTopAbility().then((data) => {
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilitystage.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityStage.md
similarity index 87%
rename from zh-cn/application-dev/reference/apis/js-apis-application-abilitystage.md
rename to zh-cn/application-dev/reference/apis/js-apis-application-abilityStage.md
index d82f8bf3bd992db094d6200894d349df1fa946b7..03ca4caf483575aecb18e6049892203b7710e0c4 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-abilitystage.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityStage.md
@@ -6,12 +6,12 @@ AbilityStage模块提供在HAP加载的时候，通知开发者，可以在此
> **说明：**
>
-> 本模块首批接口从API version 9 开始支持, 从API version 9废弃，替换模块为[@ohos.app.ability.AbilityStage](js-apis-app-ability-abilitystage.md)。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块首批接口从API version 9 开始支持, 从API version 9废弃，替换模块为[@ohos.app.ability.AbilityStage](js-apis-app-ability-abilityStage.md)。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
## 导入模块
-```js
+```ts
import AbilityStage from '@ohos.application.AbilityStage';
```
@@ -25,7 +25,7 @@ onCreate(): void
**示例：**
- ```js
+ ```ts
class MyAbilityStage extends AbilityStage {
onCreate() {
console.log("MyAbilityStage.onCreate is called")
@@ -46,7 +46,7 @@ onAcceptWant(want: Want): string;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | want | [Want](js-apis-application-Want.md) | 是 | Want类型参数，传入需要启动的ability的信息，如ability名称，包名等。 |
+ | want | [Want](js-apis-application-want.md) | 是 | Want类型参数，传入需要启动的ability的信息，如ability名称，包名等。 |
**返回值：**
@@ -56,7 +56,7 @@ onAcceptWant(want: Want): string;
**示例：**
- ```js
+ ```ts
class MyAbilityStage extends AbilityStage {
onAcceptWant(want) {
console.log("MyAbilityStage.onAcceptWant called");
@@ -78,11 +78,11 @@ onConfigurationUpdated(config: Configuration): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | config | [Configuration](js-apis-configuration.md) | 是 | 发生全局配置变更时触发回调，当前全局配置包括系统语言、深浅色模式。 |
+ | config | [Configuration](js-apis-application-configuration.md) | 是 | 发生全局配置变更时触发回调，当前全局配置包括系统语言、深浅色模式。 |
**示例：**
- ```js
+ ```ts
class MyAbilityStage extends AbilityStage {
onConfigurationUpdated(config) {
console.log('onConfigurationUpdated, language:' + config.language);
@@ -106,7 +106,7 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
**示例：**
- ```js
+ ```ts
class MyAbilityStage extends AbilityStage {
onMemoryLevel(level) {
console.log('onMemoryLevel, level:' + JSON.stringify(level));
@@ -124,4 +124,4 @@ context: AbilityStageContext;
| 属性名 | 类型 | 说明 |
| ----------- | --------------------------- | ------------------------------------------------------------ |
-| context | [AbilityStageContext](js-apis-abilitystagecontext.md) | 在启动能力阶段进行初始化时回调。 |
+| context | [AbilityStageContext](js-apis-inner-application-abilityStageContext.md) | 在启动能力阶段进行初始化时回调。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-AccessibilityExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-application-accessibilityExtensionAbility.md
similarity index 97%
rename from zh-cn/application-dev/reference/apis/js-apis-application-AccessibilityExtensionAbility.md
rename to zh-cn/application-dev/reference/apis/js-apis-application-accessibilityExtensionAbility.md
index ed1dd73836c31f85a2918e5bf1da6886d0618298..351276ea9f1e82b7d1a54c3f44635c14d23b94a4 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-AccessibilityExtensionAbility.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-accessibilityExtensionAbility.md
@@ -5,8 +5,6 @@
> **说明：**
>
>本模块首批接口从API version 9开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。
->
->本模块接口仅可在Stage模型下使用。
## 导入模块
@@ -20,7 +18,7 @@ import AccessibilityExtensionAbility from '@ohos.application.AccessibilityExtens
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------- | -------- | ---- | ---- | ------------------------- |
-| context | [AccessibilityExtensionContext](js-apis-accessibility-extension-context.md) | 是 | 否 | 表示辅助扩展能力上下文。 |
+| context | [AccessibilityExtensionContext](js-apis-inner-application-accessibilityExtensionContext.md) | 是 | 否 | 表示辅助扩展能力上下文。 |
## AccessibilityEvent
diff --git a/zh-cn/application-dev/reference/apis/js-apis-appmanager.md b/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md
similarity index 52%
rename from zh-cn/application-dev/reference/apis/js-apis-appmanager.md
rename to zh-cn/application-dev/reference/apis/js-apis-application-appManager.md
index 3292e7a8c4e4109f8d6e009829025ce8935e5779..5bb8c2a7075be12ed6a39ad52065324f8ad88ca3 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-appmanager.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md
@@ -4,15 +4,15 @@ appManager模块提供App管理的能力，包括查询当前是否处于稳定
> **说明：**
>
-> 本模块首批接口从API version 7 开始支持, 从API version 9废弃，替换模块为[@ohos.app.ability.appManager](js-apis-app-ability-appmanager.md)。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块首批接口从API version 8 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 导入模块
-```js
+```ts
import app from '@ohos.application.appManager';
```
-## appManager.isRunningInStabilityTest
+## appManager.isRunningInStabilityTest8+
static isRunningInStabilityTest(callback: AsyncCallback<boolean>): void
@@ -24,19 +24,19 @@ static isRunningInStabilityTest(callback: AsyncCallback<boolean>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<boolean> | 是 | 返回当前是否处于稳定性测试场景。 |
+ | callback | AsyncCallback<boolean> | 否 | 返回当前是否处于稳定性测试场景。 |
**示例：**
- ```js
+ ```ts
import app from '@ohos.application.appManager';
app.isRunningInStabilityTest((err, flag) => {
- console.log('startAbility result:' + err.code + ', ' + err.message);
+ console.log('startAbility result:' + JSON.stringify(err));
})
```
-## appManager.isRunningInStabilityTest
+## appManager.isRunningInStabilityTest8+
static isRunningInStabilityTest(): Promise<boolean>
@@ -52,8 +52,8 @@ static isRunningInStabilityTest(): Promise<boolean>
**示例：**
- ```js
- import app from '@ohos.app.ability.appManager';
+ ```ts
+ import app from '@ohos.application.appManager';
app.isRunningInStabilityTest().then((flag) => {
console.log('success:' + JSON.stringify(flag));
}).catch((error) => {
@@ -78,12 +78,12 @@ isRamConstrainedDevice(): Promise\;
**示例：**
- ```js
- app.isRamConstrainedDevice().then((data) => {
- console.log('success:' + JSON.stringify(data));
- }).catch((error) => {
- console.log('failed:' + JSON.stringify(error));
- });
+ ```ts
+ app.isRamConstrainedDevice().then((data) => {
+ console.log('success:' + JSON.stringify(data));
+ }).catch((error) => {
+ console.log('failed:' + JSON.stringify(error));
+ });
```
## appManager.isRamConstrainedDevice
@@ -98,15 +98,15 @@ isRamConstrainedDevice(callback: AsyncCallback\): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<boolean> | 是 | 返回当前是否是ram受限设备。 |
+ | callback | AsyncCallback<boolean> | 否 | 返回当前是否是ram受限设备。 |
**示例：**
- ```js
- app.isRamConstrainedDevice((err, data) => {
- console.log('startAbility result failed:' + JSON.stringify(err));
- console.log('startAbility result success:' + JSON.stringify(data));
- })
+ ```ts
+ app.isRamConstrainedDevice((err, data) => {
+ console.log('startAbility result failed:' + JSON.stringify(err));
+ console.log('startAbility result success:' + JSON.stringify(data));
+ })
```
## appManager.getAppMemorySize
@@ -125,12 +125,12 @@ getAppMemorySize(): Promise\;
**示例：**
- ```js
- app.getAppMemorySize().then((data) => {
- console.log('success:' + JSON.stringify(data));
- }).catch((error) => {
- console.log('failed:' + JSON.stringify(error));
- });
+ ```ts
+ app.getAppMemorySize().then((data) => {
+ console.log('success:' + JSON.stringify(data));
+ }).catch((error) => {
+ console.log('failed:' + JSON.stringify(error));
+ });
```
## appManager.getAppMemorySize
@@ -145,15 +145,15 @@ getAppMemorySize(callback: AsyncCallback\): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<number> | 是 | 应用程序内存大小。 |
+ | callback | AsyncCallback<number> | 否 | 应用程序内存大小。 |
**示例：**
- ```js
- app.getAppMemorySize((err, data) => {
- console.log('startAbility result failed :' + JSON.stringify(err));
- console.log('startAbility result success:' + JSON.stringify(data));
- })
+ ```ts
+ app.getAppMemorySize((err, data) => {
+ console.log('startAbility result failed :' + JSON.stringify(err));
+ console.log('startAbility result success:' + JSON.stringify(data));
+ })
```
## appManager.getProcessRunningInfos(deprecated)
@@ -175,12 +175,12 @@ getProcessRunningInfos(): Promise\>;
**示例：**
- ```js
- app.getProcessRunningInfos().then((data) => {
- console.log('success:' + JSON.stringify(data));
- }).catch((error) => {
- console.log('failed:' + JSON.stringify(error));
- });
+ ```ts
+ app.getProcessRunningInfos().then((data) => {
+ console.log('success:' + JSON.stringify(data));
+ }).catch((error) => {
+ console.log('failed:' + JSON.stringify(error));
+ });
```
## appManager.getProcessRunningInfos(deprecated)
@@ -199,15 +199,15 @@ getProcessRunningInfos(callback: AsyncCallback\>): vo
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| callback | AsyncCallback\> | 是 | 获取有关运行进程的信息。 |
+| callback | AsyncCallback\> | 否 | 获取有关运行进程的信息。 |
**示例：**
- ```js
- app.getProcessRunningInfos((err, data) => {
- console.log('startAbility result failed :' + JSON.stringify(err));
- console.log('startAbility result success:' + JSON.stringify(data));
- })
+ ```ts
+ app.getProcessRunningInfos((err, data) => {
+ console.log('startAbility result failed :' + JSON.stringify(err));
+ console.log('startAbility result success:' + JSON.stringify(data));
+ })
```
## appManager.getProcessRunningInformation9+
@@ -224,16 +224,16 @@ getProcessRunningInformation(): Promise\>;
| 类型 | 说明 |
| -------- | -------- |
-| Promise\> | 获取有关运行进程的信息。 |
+| Promise\> | 获取有关运行进程的信息。 |
**示例：**
- ```js
- app.getProcessRunningInformation().then((data) => {
- console.log('success:' + JSON.stringify(data));
- }).catch((error) => {
- console.log('failed:' + JSON.stringify(error));
- });
+ ```ts
+ app.getProcessRunningInformation().then((data) => {
+ console.log('success:' + JSON.stringify(data));
+ }).catch((error) => {
+ console.log('failed:' + JSON.stringify(error));
+ });
```
## appManager.getProcessRunningInformation9+
@@ -250,15 +250,15 @@ getProcessRunningInformation(callback: AsyncCallback\> | 是 | 获取有关运行进程的信息。 |
+| callback | AsyncCallback\> | 否 | 获取有关运行进程的信息。 |
**示例：**
- ```js
- app.getProcessRunningInformation((err, data) => {
- console.log('startAbility result failed :' + JSON.stringify(err));
- console.log('startAbility result success:' + JSON.stringify(data));
- })
+ ```ts
+ app.getProcessRunningInformation((err, data) => {
+ console.log('startAbility result failed :' + JSON.stringify(err));
+ console.log('startAbility result success:' + JSON.stringify(data));
+ })
```
## appManager.registerApplicationStateObserver8+
@@ -277,11 +277,11 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| observer | [ApplicationStateObserver](#applicationstateobserver) | 是 | 返回观察者的数字代码。 |
+| observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 否 | 返回观察者的数字代码。 |
**示例：**
- ```js
+ ```ts
var applicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log('------------ onForegroundApplicationChanged -----------', appStateData);
@@ -301,7 +301,6 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number;
}
const observerCode = app.registerApplicationStateObserver(applicationStateObserver);
console.log('-------- observerCode: ---------', observerCode);
-
```
## appManager.registerApplicationStateObserver9+
@@ -320,12 +319,12 @@ registerApplicationStateObserver(observer: ApplicationStateObserver, bundleNameL
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| observer | [ApplicationStateObserver](#applicationstateobserver) | 是 | 返回观察者的数字代码。 |
-| bundleNameList | Array\ | 是 | 表示需要注册监听的bundleName数组。最大值128。 |
+| observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 否 | 返回观察者的数字代码。 |
+| bundleNameList | Array | 否 | 表示需要注册监听的bundleName数组。最大值128。 |
**示例：**
- ```js
+ ```ts
var applicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log('------------ onForegroundApplicationChanged -----------', appStateData);
@@ -346,7 +345,6 @@ registerApplicationStateObserver(observer: ApplicationStateObserver, bundleNameL
var bundleNameList = ['bundleName1', 'bundleName2'];
const observerCode = app.registerApplicationStateObserver(applicationStateObserver, bundleNameList);
console.log('-------- observerCode: ---------', observerCode);
-
```
## appManager.unregisterApplicationStateObserver8+
@@ -364,20 +362,20 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| observerId | number | 是 | 表示观察者的编号代码。 |
-| callback | AsyncCallback\ | 是 | 表示指定的回调方法。 |
+| observerId | number | 否 | 表示观察者的编号代码。 |
+| callback | AsyncCallback\ | 否 | 表示指定的回调方法。 |
**示例：**
- ```js
- var observerId = 100;
+ ```ts
+ var observerId = 100;
- function unregisterApplicationStateObserverCallback(err) {
- if (err) {
- console.log('------------ unregisterApplicationStateObserverCallback ------------', err);
- }
+ function unregisterApplicationStateObserverCallback(err) {
+ if (err) {
+ console.log('------------ unregisterApplicationStateObserverCallback ------------', err);
}
- app.unregisterApplicationStateObserver(observerId, unregisterApplicationStateObserverCallback);
+ }
+ app.unregisterApplicationStateObserver(observerId, unregisterApplicationStateObserverCallback);
```
## appManager.unregisterApplicationStateObserver8+
@@ -396,7 +394,7 @@ unregisterApplicationStateObserver(observerId: number): Promise\;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| observerId | number | 是 | 表示观察者的编号代码。 |
+| observerId | number | 否 | 表示观察者的编号代码。 |
**返回值：**
@@ -406,16 +404,16 @@ unregisterApplicationStateObserver(observerId: number): Promise\;
**示例：**
- ```js
- var observerId = 100;
-
- app.unregisterApplicationStateObserver(observerId)
- .then((data) => {
- console.log('----------- unregisterApplicationStateObserver success ----------', data);
- })
- .catch((err) => {
- console.log('----------- unregisterApplicationStateObserver fail ----------', err);
- })
+ ```ts
+ var observerId = 100;
+
+ app.unregisterApplicationStateObserver(observerId)
+ .then((data) => {
+ console.log('----------- unregisterApplicationStateObserver success ----------', data);
+ })
+ .catch((err) => {
+ console.log('----------- unregisterApplicationStateObserver fail ----------', err);
+ })
```
## appManager.getForegroundApplications8+
@@ -434,19 +432,19 @@ getForegroundApplications(callback: AsyncCallback\>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| callback | AsyncCallback\> | 是 | 表示应用的状态数据。 |
+| callback | AsyncCallback\> | 否 | 表示应用的状态数据。 |
**示例：**
- ```js
- function getForegroundApplicationsCallback(err, data) {
- if (err) {
- console.log('--------- getForegroundApplicationsCallback fail ---------', err);
- } else {
- console.log('--------- getForegroundApplicationsCallback success ---------', data)
- }
+ ```ts
+ function getForegroundApplicationsCallback(err, data) {
+ if (err) {
+ console.log('--------- getForegroundApplicationsCallback fail ---------', err);
+ } else {
+ console.log('--------- getForegroundApplicationsCallback success ---------', data)
}
- app.getForegroundApplications(getForegroundApplicationsCallback);
+ }
+ app.getForegroundApplications(getForegroundApplicationsCallback);
```
## appManager.getForegroundApplications