Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
“d611ad3aad1c11c6443530e3f2a79fea5c2c3d3d”上不存在“...api-diff/Beta5-to-v3.2-Release/js-apidiff-usb.md”
未验证 提交 ce06dbac 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!12229 【仅md格式规范】元能力接口文档修改 

Merge pull request !12229 from donglin/specification
上级 2ef5eafc ba1a731a
隐藏空白更改
内联 并排
Showing with 867 addition and 2218 deletion
zh-cn/application-dev/reference/apis/js-apis-ability-ability.md
浏览文件 @ ce06dbac
...@@ -15,15 +15,15 @@ import ability from '@ohos.ability.ability' ...@@ -15,15 +15,15 @@ import ability from '@ohos.ability.ability'
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 读写属性 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 描述 |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | | ----------- | -------------------- | ---- | ------------------------------------------------------------ |
| DataAbilityHelper | 只读 | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 否 | DataAbilityHelper二级模块。 | | DataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 否 | DataAbilityHelper二级模块。 |
| PacMap | 只读 | [PacMap](js-apis-inner-ability-dataAbilityHelper.md#PacMap) | 否 | PacMap二级模块。 | | PacMap | [PacMap](js-apis-inner-ability-dataAbilityHelper.md#PacMap) | 否 | PacMap二级模块。 |
| DataAbilityOperation | 只读 | [DataAbilityOperation](js-apis-inner-ability-dataAbilityOperation.md) | 否 | DataAbilityOperation二级模块。 | | DataAbilityOperation | [DataAbilityOperation](js-apis-inner-ability-dataAbilityOperation.md) | 否 | DataAbilityOperation二级模块。 |
| DataAbilityResult | 只读 | [DataAbilityResult](js-apis-inner-ability-dataAbilityResult.md) | 否 | DataAbilityResult二级模块。 | | DataAbilityResult | [DataAbilityResult](js-apis-inner-ability-dataAbilityResult.md) | 否 | DataAbilityResult二级模块。 |
| AbilityResult | 只读 | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 否 | AbilityResult二级模块。 | | AbilityResult | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 否 | AbilityResult二级模块。 |
| ConnectOptions | 只读 | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 否 | ConnectOptions二级模块。 | | ConnectOptions | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 否 | ConnectOptions二级模块。 |
| StartAbilityParameter | 只读 | [StartAbilityParameter](js-apis-inner-ability-startAbilityParameter.md) | 否 | StartAbilityParameter二级模块。 | | StartAbilityParameter | [StartAbilityParameter](js-apis-inner-ability-startAbilityParameter.md) | 否 | StartAbilityParameter二级模块。 |
**示例：** **示例：**
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-ability-context.md
浏览文件 @ ce06dbac
...@@ -28,7 +28,7 @@ class MainAbility extends Ability { ...@@ -28,7 +28,7 @@ class MainAbility extends Ability {
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| abilityInfo | AbilityInfo | 是 | 否 | Abilityinfo相关信息 | | abilityInfo | AbilityInfo | 是 | 否 | Abilityinfo相关信息 |
| currentHapModuleInfo | HapModuleInfo | 是 | 否 | 当前hap包的信息 | | currentHapModuleInfo | HapModuleInfo | 是 | 否 | 当前hap包的信息 |
...@@ -54,7 +54,7 @@ startAbility(want: Want, callback: AsyncCallback<void>): void; ...@@ -54,7 +54,7 @@ startAbility(want: Want, callback: AsyncCallback<void>): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -104,7 +104,7 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void& ...@@ -104,7 +104,7 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void&
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -162,7 +162,7 @@ startAbility(want: Want, options?: StartOptions): Promise<void>; ...@@ -162,7 +162,7 @@ startAbility(want: Want, options?: StartOptions): Promise<void>;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -214,7 +214,7 @@ startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): ...@@ -214,7 +214,7 @@ startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>):
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -265,7 +265,7 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback ...@@ -265,7 +265,7 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -326,7 +326,7 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityRes ...@@ -326,7 +326,7 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityRes
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -382,7 +382,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC ...@@ -382,7 +382,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -440,7 +440,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp ...@@ -440,7 +440,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -506,7 +506,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO ...@@ -506,7 +506,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -561,7 +561,7 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -561,7 +561,7 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -611,7 +611,7 @@ startServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -611,7 +611,7 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -665,7 +665,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -665,7 +665,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -719,7 +719,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -719,7 +719,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -770,7 +770,7 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -770,7 +770,7 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -820,7 +820,7 @@ stopServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -820,7 +820,7 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -874,7 +874,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -874,7 +874,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -928,7 +928,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -928,7 +928,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -977,7 +977,7 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void; ...@@ -977,7 +977,7 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -1014,7 +1014,7 @@ terminateSelf(): Promise&lt;void&gt;; ...@@ -1014,7 +1014,7 @@ terminateSelf(): Promise&lt;void&gt;;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -1050,7 +1050,7 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;voi ...@@ -1050,7 +1050,7 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;voi
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -1110,7 +1110,7 @@ terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;; ...@@ -1110,7 +1110,7 @@ terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -1173,7 +1173,7 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; ...@@ -1173,7 +1173,7 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -1231,7 +1231,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1231,7 +1231,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -1285,7 +1285,7 @@ disconnectServiceExtensionAbility(connection: number): Promise\<void>; ...@@ -1285,7 +1285,7 @@ disconnectServiceExtensionAbility(connection: number): Promise\<void>;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -1333,7 +1333,7 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<vo ...@@ -1333,7 +1333,7 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<vo
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -1471,7 +1471,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ...@@ -1471,7 +1471,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -1528,7 +1528,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ...@@ -1528,7 +1528,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
...@@ -1587,7 +1587,7 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ...@@ -1587,7 +1587,7 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
| 其他ID | 见[元能力子系统错误码](../errorcodes/errorcode-ability.md) | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md
浏览文件 @ ce06dbac
...@@ -22,7 +22,7 @@ getId(uri: string): number ...@@ -22,7 +22,7 @@ getId(uri: string): number
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | --------------------------- | | ---- | ------ | ---- | --------------------------- |
| uri | string | 是 | 指示要从中获取ID的uri对象。 | | uri | string | 是 | 指示要从中获取ID的uri对象。 |
...@@ -50,7 +50,7 @@ attachId(uri: string, id: number): string ...@@ -50,7 +50,7 @@ attachId(uri: string, id: number): string
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | --------------------------- | | ---- | ------ | ---- | --------------------------- |
| uri | string | 是 | 指示要从中获取ID的uri对象。 | | uri | string | 是 | 指示要从中获取ID的uri对象。 |
| id | number | 是 | 指示要附加的ID。 | | id | number | 是 | 指示要附加的ID。 |
...@@ -83,7 +83,7 @@ deleteId(uri: string): string ...@@ -83,7 +83,7 @@ deleteId(uri: string): string
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | --------------------------- | | ---- | ------ | ---- | --------------------------- |
| uri | string | 是 | 指示要从中删除ID的uri对象。 | | uri | string | 是 | 指示要从中删除ID的uri对象。 |
...@@ -111,7 +111,7 @@ updateId(uri: string, id: number): string ...@@ -111,7 +111,7 @@ updateId(uri: string, id: number): string
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------------- | | ---- | ------ | ---- | ------------------- |
| uri | string | 是 | 指示要更新的uri对象 | | uri | string | 是 | 指示要更新的uri对象 |
| id | number | 是 | 指示新ID | | id | number | 是 | 指示新ID |
......
zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md
浏览文件 @ ce06dbac
...@@ -392,11 +392,11 @@ connectAbility(request: Want, options:ConnectOptions): number ...@@ -392,11 +392,11 @@ connectAbility(request: Want, options:ConnectOptions): number
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 参数名 | 读写属性 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| ------------ | ---- | -------- | ---- | ------------------------- | | ------------ | -------- | ---- | ------------------------- |
| onConnect | 只读 | function | 是 | 连接成功时的回调函数。 | | onConnect | function | 是 | 连接成功时的回调函数。 |
| onDisconnect | 只读 | function | 是 | 连接失败时的回调函数。 | | onDisconnect | function | 是 | 连接失败时的回调函数。 |
| onFailed | 只读 | function | 是 | ConnectAbility调用失败时的回调函数。 | | onFailed | function | 是 | ConnectAbility调用失败时的回调函数。 |
**示例**： **示例**：
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-ability.md
浏览文件 @ ce06dbac
...@@ -13,9 +13,9 @@ Ability模块提供对Ability生命周期、上下文环境等调用管理的能 ...@@ -13,9 +13,9 @@ Ability模块提供对Ability生命周期、上下文环境等调用管理的能
import Ability from '@ohos.app.ability.Ability'; import Ability from '@ohos.app.ability.Ability';
``` ```
## Ability.onConfigurationUpdated ## Ability.onConfigurationUpdate
onConfigurationUpdated(config: Configuration): void; onConfigurationUpdate(config: Configuration): void;
当系统配置更新时调用。 当系统配置更新时调用。
...@@ -31,8 +31,8 @@ onConfigurationUpdated(config: Configuration): void; ...@@ -31,8 +31,8 @@ onConfigurationUpdated(config: Configuration): void;
```ts ```ts
class myAbility extends Ability { class myAbility extends Ability {
onConfigurationUpdated(config) { onConfigurationUpdate(config) {
console.log('onConfigurationUpdated, config:' + JSON.stringify(config)); console.log('onConfigurationUpdate, config:' + JSON.stringify(config));
} }
} }
``` ```
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
浏览文件 @ ce06dbac
...@@ -70,7 +70,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant'; ...@@ -70,7 +70,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 取值 | 说明 | | 名称 | 值 | 说明 |
| --- | --- | --- | | --- | --- | --- |
| WINDOW_MODE_UNDEFINED | 0 | 未定义窗口模式。 | | WINDOW_MODE_UNDEFINED | 0 | 未定义窗口模式。 |
| WINDOW_MODE_FULLSCREEN | 1 | 全屏模式。 | | WINDOW_MODE_FULLSCREEN | 1 | 全屏模式。 |
...@@ -84,7 +84,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant'; ...@@ -84,7 +84,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 取值 | 说明 | | 名称 | 值 | 说明 |
| --- | --- | --- | | --- | --- | --- |
| MEMORY_LEVEL_MODERATE | 0 | 内存占用适中。 | | MEMORY_LEVEL_MODERATE | 0 | 内存占用适中。 |
| MEMORY_LEVEL_LOW | 1 | 内存占用低。 | | MEMORY_LEVEL_LOW | 1 | 内存占用低。 |
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegator.md 已删除 100644 → 0
浏览文件 @ 2ef5eafc
# AbilityDelegator
AbilityDelegator提供添加用于监视指定ability的生命周期状态更改的AbilityMonitor对象的能力，包括对AbilityMonitor实例的添加、删除、等待ability到达OnCreate生命周期、设置等待时间等、获取指定ability的生命周期状态、获取当前应用顶部ability、启动指定ability等。
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 使用说明
通过AbilityDelegatorRegistry中getAbilityDelegator方法获取。
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'
var abilityDelegator;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
```
## AbilityDelegator
### addAbilityMonitor
addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): void
添加AbilityMonitor实例（callback形式）
**系统能力：**SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填说明 | 说明 |
| -------- | ------------------------------------------------------------ | -------- | ------------------------------------------------------------ |
| monitor | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor)实例 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback");
}
var monitor = {
abilityName: "abilityname",
onAbilityCreate: onAbilityCreateCallback
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor, (err : any) => {
console.info("addAbilityMonitor callback");
});
```
### addAbilityMonitor
addAbilityMonitor(monitor: AbilityMonitor): Promise\<void>
添加AbilityMonitor实例（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| monitor | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor)实例 |
**返回值：**
| 类型 | 说明 |
| -------------- | ------------------- |
| Promise\<void> | 以Promise形式返回。 |
**示例：**
```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback");
}
var monitor = {
abilityName: "abilityname",
onAbilityCreate: onAbilityCreateCallback
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor).then(() => {
console.info("addAbilityMonitor promise");
});
```
### removeAbilityMonitor
removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): void
删除已经添加的AbilityMonitor实例（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| monitor | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor)实例 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback");
}
var monitor = {
abilityName: "abilityname",
onAbilityCreate: onAbilityCreateCallback
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityMonitor(monitor, (err : any) => {
console.info("removeAbilityMonitor callback");
});
```
### removeAbilityMonitor
removeAbilityMonitor(monitor: AbilityMonitor): Promise\<void>
删除已经添加的AbilityMonitor实例（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 名称 | 类型 | 必填 | 说明 |
| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| monitor | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor)实例 |
**返回值：**
| 类型 | 说明 |
| -------------- | ------------------- |
| Promise\<void> | 以Promise形式返回。 |
- 示例
```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback");
}
var monitor = {
abilityName: "abilityname",
onAbilityCreate: onAbilityCreateCallback
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityMonitor(monitor).then(() => {
console.info("removeAbilityMonitor promise");
});
```
### waitAbilityMonitor
waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<Ability>): void
等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| monitor | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor)实例 |
| callback | AsyncCallback\<[Ability](js-apis-application-ability.md#Ability)> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback");
}
var monitor = {
abilityName: "abilityname",
onAbilityCreate: onAbilityCreateCallback
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor, (err : any, data : any) => {
console.info("waitAbilityMonitor callback");
});
```
### waitAbilityMonitor
waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCallback\<Ability>): void
设置等待时间，等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| monitor | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor)实例 |
| timeout | number | 是 | 最大等待时间，单位毫秒（ms） |
| callback | AsyncCallback\<[Ability](js-apis-application-ability.md#Ability)> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
var timeout = 100;
function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback");
}
var monitor = {
abilityName: "abilityname",
onAbilityCreate: onAbilityCreateCallback
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor, timeout, (err : any, data : any) => {
console.info("waitAbilityMonitor callback");
});
```
### waitAbilityMonitor
waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise\<Ability>
设置等待时间，等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| monitor | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-app-ability-abilityMonitor.md#AbilityMonitor)实例 |
| timeout | number | 否 | 最大等待时间，单位毫秒（ms） |
**返回值：**
| 类型 | 说明 |
| ----------------------------------------------------------- | -------------------------- |
| Promise\<[Ability](js-apis-application-ability.md#Ability)> | 以Promise形式返回Ability。 |
**示例：**
```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback");
}
var monitor = {
abilityName: "abilityname",
onAbilityCreate: onAbilityCreateCallback
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor).then((data : any) => {
console.info("waitAbilityMonitor promise");
});
```
### getAppContext
getAppContext(): Context
获取应用Context
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**返回值：**
| 类型 | 说明 |
| ------------------------------------- | ------------------------------------------- |
| [Context](js-apis-inner-application-context.md) | 应用[Context](js-apis-inner-application-context.md)。 |
**示例：**
```ts
var abilityDelegator;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
var context = abilityDelegator.getAppContext();
```
### getAbilityState<sup>9+</sup>
getAbilityState(ability: Ability): number
获取指定ability的生命周期状态
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------------------------- | ---- | --------------- |
| ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 指定Ability对象 |
**返回值：**
| 类型 | 说明 |
| ------ | ------------------------------------------------------------ |
| number | 指定ability的生命周期状态。状态枚举值使用[AbilityLifecycleState](js-apis-application-abilityDelegatorRegistry.md#AbilityLifecycleState)。 |
**示例：**
```ts
var abilityDelegator;
var ability;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
console.info("getCurrentTopAbility callback");
ability = data;
var state = abilityDelegator.getAbilityState(ability);
console.info("getAbilityState" + state);
});
```
### getCurrentTopAbility
getCurrentTopAbility(callback: AsyncCallback\<Ability>): void
获取当前应用顶部ability（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------ |
| callback | AsyncCallback\<[Ability](js-apis-application-ability.md#Ability)> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
var ability;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
console.info("getCurrentTopAbility callback");
ability = data;
});
```
### getCurrentTopAbility
getCurrentTopAbility(): Promise\<Ability>
获取当前应用顶部ability（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**返回值：**
| 类型 | 说明 |
| ----------------------------------------------------------- | -------------------------------------- |
| Promise\<[Ability](js-apis-application-ability.md#Ability)> | 以Promise形式返回当前应用顶部ability。 |
**示例：**
```ts
var abilityDelegator;
var ability;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility().then((data : any) => {
console.info("getCurrentTopAbility promise");
ability = data;
});
```
### startAbility
startAbility(want: Want, callback: AsyncCallback\<void>): void
启动指定ability（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------- | ---- | ------------------ |
| want | [Want](js-apis-app-ability-want.md) | 是 | 启动Ability参数 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
var want = {
bundleName: "bundleName",
abilityName: "abilityName"
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.startAbility(want, (err : any, data : any) => {
console.info("startAbility callback");
});
```
### startAbility
startAbility(want: Want): Promise\<void>
启动指定ability（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------------------------------- | ---- | --------------- |
| want | [Want](js-apis-app-ability-want.md) | 是 | 启动Ability参数 |
**返回值：**
| 类型 | 说明 |
| -------------- | ------------------- |
| Promise\<void> | 以Promise形式返回。 |
**示例：**
```ts
var abilityDelegator;
var want = {
bundleName: "bundleName",
abilityName: "abilityName"
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.startAbility(want).then((data: any) => {
console.info("startAbility promise");
});
```
### doAbilityForeground
doAbilityForeground(ability: Ability, callback: AsyncCallback\<boolean>): void
调度指定ability生命周期状态到Foreground状态（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------- | ---- | ------------------------------------------------------- |
| ability | Ability | 是 | 指定Ability对象 |
| callback | AsyncCallback\<boolean> | 是 | 表示指定的回调方法<br/>\- true：成功<br/>\- false：失败 |
**示例：**
```ts
var abilityDelegator;
var ability;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
console.info("getCurrentTopAbility callback");
ability = data;
abilityDelegator.doAbilityForeground(ability, (err : any, data : any) => {
console.info("doAbilityForeground callback");
});
});
```
### doAbilityForeground
doAbilityForeground(ability: Ability): Promise\<boolean>
调度指定ability生命周期状态到Foreground状态（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------- | ---- | --------------- |
| ability | Ability | 是 | 指定Ability对象 |
**返回值：**
| 类型 | 说明 |
| ----------------- | ------------------------------------------------------------ |
| Promise\<boolean> | 以Promise形式返回执行结果。<br/>\- true：成功<br/>\- false：失败 |
**示例：**
```ts
var abilityDelegator;
var ability;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
console.info("getCurrentTopAbility callback");
ability = data;
abilityDelegator.doAbilityForeground(ability).then((data : any) => {
console.info("doAbilityForeground promise");
});
});
```
### doAbilityBackground
doAbilityBackground(ability: Ability, callback: AsyncCallback\<boolean>): void
调度指定ability生命周期状态到Background状态（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------- | ---- | ------------------------------------------------------- |
| ability | Ability | 是 | 指定Ability对象 |
| callback | AsyncCallback\<boolean> | 是 | 表示指定的回调方法<br/>\- true：成功<br/>\- false：失败 |
**示例：**
```ts
var abilityDelegator;
var ability;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
console.info("getCurrentTopAbility callback");
ability = data;
abilityDelegator.doAbilityBackground(ability, (err : any, data : any) => {
console.info("doAbilityBackground callback");
});
});
```
### doAbilityBackground
doAbilityBackground(ability: Ability): Promise\<boolean>
调度指定ability生命周期状态到Background状态（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------- | ---- | --------------- |
| ability | Ability | 是 | 指定Ability对象 |
**返回值：**
| 类型 | 说明 |
| ----------------- | ------------------------------------------------------------ |
| Promise\<boolean> | 以Promise形式返回执行结果。<br/>\- true：成功<br/>\- false：失败 |
**示例：**
```ts
var abilityDelegator;
var ability;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
console.info("getCurrentTopAbility callback");
ability = data;
abilityDelegator.doAbilityBackground(ability).then((data : any) => {
console.info("doAbilityBackground promise");
});
});
```
### printSync
printSync(msg: string): void
打印日志信息到单元测试终端控制台
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------- |
| msg | string | 是 | 日志字符串 |
**示例：**
```ts
var abilityDelegator;
var msg = "msg";
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.printSync(msg);
```
### print
print(msg: string, callback: AsyncCallback\<void>): void
打印日志信息到单元测试终端控制台（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------------ |
| msg | string | 是 | 日志字符串 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
var msg = "msg";
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.print(msg, (err : any) => {
console.info("print callback");
});
```
### print
print(msg: string): Promise\<void>
打印日志信息到单元测试终端控制台（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------- |
| msg | string | 是 | 日志字符串 |
**返回值：**
| 类型 | 说明 |
| -------------- | ------------------- |
| Promise\<void> | 以Promise形式返回。 |
**示例：**
```ts
var abilityDelegator;
var msg = "msg";
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.print(msg).then(() => {
console.info("print promise");
});
```
### executeShellCommand
executeShellCommand(cmd: string, callback: AsyncCallback\<ShellCmdResult>): void
执行指定的shell命令（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------ |
| cmd | string | 是 | shell命令字符串 |
| callback | AsyncCallback\<[ShellCmdResult](js-apis-inner-application-shellCmdResult.md)> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
var cmd = "cmd";
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, (err : any, data : any) => {
console.info("executeShellCommand callback");
});
```
### executeShellCommand
executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\<ShellCmdResult>): void
指定超时时间，并执行指定的shell命令（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------------------------------------------------------ | ---- | ----------------------------- |
| cmd | string | 是 | shell命令字符串 |
| timeoutSecs | number | 是 | 设定命令超时时间，单位秒（s） |
| callback | AsyncCallback\<[ShellCmdResult](js-apis-inner-application-shellCmdResult.md)> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
var cmd = "cmd";
var timeout = 100;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, timeout, (err : any, data : any) => {
console.info("executeShellCommand callback");
});
```
### executeShellCommand
executeShellCommand(cmd: string, timeoutSecs?: number): Promise\<ShellCmdResult>
指定超时时间，并执行指定的shell命令（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ----------------------------- |
| cmd | string | 是 | shell命令字符串 |
| timeoutSecs | number | 否 | 设定命令超时时间，单位秒（s） |
**返回值：**
| 类型 | 说明 |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| Promise\<[ShellCmdResult](js-apis-inner-application-shellCmdResult.md)> | 以Promise形式返回Shell命令执行结果[ShellCmdResult](js-apis-inner-application-shellCmdResult.md)对象。 |
**示例：**
```ts
var abilityDelegator;
var cmd = "cmd";
var timeout = 100;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, timeout).then((data : any) => {
console.info("executeShellCommand promise");
});
```
### finishTest
finishTest(msg: string, code: number, callback: AsyncCallback\<void>): void
结束测试并打印日志信息到单元测试终端控制台（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------------ |
| msg | string | 是 | 日志字符串 |
| code | number | 是 | 日志码 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
var msg = "msg";
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.finishTest(msg, 0, (err : any) => {
console.info("finishTest callback");
});
```
### finishTest
finishTest(msg: string, code: number): Promise\<void>
结束测试并打印日志信息到单元测试终端控制台（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------- |
| msg | string | 是 | 日志字符串 |
| code | number | 是 | 日志码 |
**返回值：**
| 类型 | 说明 |
| -------------- | ------------------- |
| Promise\<void> | 以Promise形式返回。 |
**示例：**
```ts
var abilityDelegator;
var msg = "msg";
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.finishTest(msg, 0).then(() => {
console.info("finishTest promise");
});
```
### addAbilityStageMonitor
addAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<void>): void;
添加一个AbilityStageMonitor对象，用于监视指定abilityStage的生命周期状态更改。（callback形式）
**系统能力：**SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填说明 | 说明 |
| -------- | ------------------------------------------------------------ | -------- | ------------------------------------------------------------ |
| monitor | [AbilityStageMonitor](#abilitystagemonitor) | 是 | [AbilityStageMonitor](#abilitystagemonitor) 实例 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
var monitor = {
moduleName: "moduleName",
srcEntrance: "srcEntrance",
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitor(monitor, (err : any) => {
console.info("addAbilityStageMonitor callback");
});
```
### addAbilityStageMonitor
addAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>;
添加一个AbilityStageMonitor对象，用于监视指定abilityStage的生命周期状态更改。（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| monitor | [AbilityStageMonitor](#abilitystagemonitor) | 是 | [AbilityStageMonitor](#abilitystagemonitor) 实例 |
**返回值：**
| 类型 | 说明 |
| -------------- | ------------------- |
| Promise\<void> | 以Promise形式返回。 |
**示例：**
```ts
var abilityDelegator;
var monitor = {
moduleName: "moduleName",
srcEntrance: "srcEntrance",
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitor(monitor).then(() => {
console.info("addAbilityStageMonitor promise");
});
```
### removeAbilityStageMonitor
removeAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<void>): void;
从应用程序内存中删除指定的AbilityStageMonitor对象。（callback形式）
**系统能力：**SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填说明 | 说明 |
| -------- | ------------------------------------------------------------ | -------- | ------------------------------------------------------------ |
| monitor | [AbilityStageMonitor](#abilitystagemonitor) | 是 | [AbilityStageMonitor](#abilitystagemonitor) 实例 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法 |
**示例：**
```ts
var abilityDelegator;
var monitor = {
moduleName: "moduleName",
srcEntrance: "srcEntrance",
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitor(monitor, (err : any) => {
console.info("removeAbilityStageMonitor callback");
});
```
### removeAbilityStageMonitor
removeAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>;
从应用程序内存中删除指定的AbilityStageMonitor对象。（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| monitor | [AbilityStageMonitor](#abilitystagemonitor) | 是 | [AbilityStageMonitor](#abilitystagemonitor) 实例 |
**返回值：**
| 类型 | 说明 |
| -------------- | ------------------- |
| Promise\<void> | 以Promise形式返回。 |
**示例：**
```ts
var abilityDelegator;
var monitor = {
moduleName: "moduleName",
srcEntrance: "srcEntrance",
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitor(monitor).then(() => {
console.info("removeAbilityStageMonitor promise");
});
```
### waitAbilityStageMonitor
waitAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<AbilityStage>): void;
等待并返回与给定AbilityStageMonitor中设置的条件匹配的AbilityStage对象。（callback形式）
**系统能力：**SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填说明 | 说明 |
| -------- | ------------------------------------------------------------ | -------- | ------------------------------------------------------------ |
| monitor | [AbilityStageMonitor](#abilitystagemonitor) | 是 | [AbilityStageMonitor](#abilitystagemonitor) 实例 |
| callback | AsyncCallback\<AbilityStage> | 是 | 成功返回AbilityStage对象，失败返回空。 |
**示例：**
```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback");
}
var monitor = {
moduleName: "moduleName",
srcEntrance: "srcEntrance",
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor(monitor, (err : any, data : any) => {
console.info("waitAbilityStageMonitor callback");
});
```
### waitAbilityStageMonitor
waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout?: number): Promise\<AbilityStage>;
等待并返回与给定AbilityStageMonitor中设置的条件匹配的AbilityStage对象。（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| monitor | [AbilityStageMonitor](#abilitystagemonitor) | 是 | [AbilityStageMonitor](#abilitystagemonitor) 实例 |
| timeout | number | 否 | 超时最大等待时间，以毫秒为单位。 |
**返回值：**
| 类型 | 说明 |
| -------------- | ------------------- |
| Promise\<AbilityStage> | 成功返回AbilityStage对象，失败返回空。 |
**示例：**
```ts
var abilityDelegator;
function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback");
}
var monitor = {
moduleName: "moduleName",
srcEntrance: "srcEntrance",
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor(monitor).then((data : any) => {
console.info("waitAbilityStageMonitor promise");
});
```
### waitAbilityStageMonitor
waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout: number, callback: AsyncCallback\<AbilityStage>): void;
等待并返回与给定AbilityStageMonitor中设置的条件匹配的AbilityStage对象。（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| monitor | [AbilityStageMonitor](#abilitystagemonitor) | 是 | [AbilityStageMonitor](#abilitystagemonitor) 实例 |
| timeout | number | 否 | 超时最大等待时间，以毫秒为单位。 |
| callback | AsyncCallback\<AbilityStage> | 是 | 成功返回AbilityStage对象，失败返回空。 |
**示例：**
```ts
var abilityDelegator;
var timeout = 100;
function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback");
}
var monitor = {
moduleName: "moduleName",
srcEntrance: "srcEntrance",
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor(monitor, timeout, (err : any, data : any) => {
console.info("waitAbilityStageMonitor callback");
});
```
## AbilityStageMonitor
提供用于匹配满足指定条件的受监视的AbilityStage对象的方法。最近匹配的AbilityStage对象将保存在AbilityStageMonitor对象中。
系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------------------------------------------------ | -------- | ---- | ---- | ------------------------------------------------------------ |
| moduleName | string | 是 | 是 | 要监视的abilityStage的模块名。 |
| srcEntrance | string | 是 | 是 | 要监视的abilityStage的源路径。 |
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md
浏览文件 @ ce06dbac
...@@ -17,7 +17,7 @@ import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback ...@@ -17,7 +17,7 @@ import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback
## AbilityLifecycleCallback.onAbilityCreate ## AbilityLifecycleCallback.onAbilityCreate
onAbilityCreate(ability: Ability): void; onAbilityCreate(ability: UIAbility): void;
注册监听应用上下文的生命周期后，在ability创建时触发回调。 注册监听应用上下文的生命周期后，在ability创建时触发回调。
...@@ -27,12 +27,12 @@ onAbilityCreate(ability: Ability): void; ...@@ -27,12 +27,12 @@ onAbilityCreate(ability: Ability): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onWindowStageCreate ## AbilityLifecycleCallback.onWindowStageCreate
onWindowStageCreate(ability: Ability, windowStage: window.WindowStage): void; onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void;
注册监听应用上下文的生命周期后，在windowStage创建时触发回调。 注册监听应用上下文的生命周期后，在windowStage创建时触发回调。
...@@ -42,13 +42,13 @@ onWindowStageCreate(ability: Ability, windowStage: window.WindowStage): void; ...@@ -42,13 +42,13 @@ onWindowStageCreate(ability: Ability, windowStage: window.WindowStage): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |
## AbilityLifecycleCallback.onWindowStageActive ## AbilityLifecycleCallback.onWindowStageActive
onWindowStageActive(ability: Ability, windowStage: window.WindowStage): void; onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void;
注册监听应用上下文的生命周期后，在windowStage获焦时触发回调。 注册监听应用上下文的生命周期后，在windowStage获焦时触发回调。
...@@ -58,13 +58,13 @@ onWindowStageActive(ability: Ability, windowStage: window.WindowStage): void; ...@@ -58,13 +58,13 @@ onWindowStageActive(ability: Ability, windowStage: window.WindowStage): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |
## AbilityLifecycleCallback.onWindowStageInactive ## AbilityLifecycleCallback.onWindowStageInactive
onWindowStageInactive(ability: Ability, windowStage: window.WindowStage): void; onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void;
注册监听应用上下文的生命周期后，在windowStage失焦时触发回调。 注册监听应用上下文的生命周期后，在windowStage失焦时触发回调。
...@@ -74,13 +74,13 @@ onWindowStageInactive(ability: Ability, windowStage: window.WindowStage): void; ...@@ -74,13 +74,13 @@ onWindowStageInactive(ability: Ability, windowStage: window.WindowStage): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |
## AbilityLifecycleCallback.onWindowStageDestroy ## AbilityLifecycleCallback.onWindowStageDestroy
onWindowStageDestroy(ability: Ability, windowStage: window.WindowStage): void; onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void;
注册监听应用上下文的生命周期后，在windowStage销毁时触发回调。 注册监听应用上下文的生命周期后，在windowStage销毁时触发回调。
...@@ -90,13 +90,13 @@ onWindowStageDestroy(ability: Ability, windowStage: window.WindowStage): void; ...@@ -90,13 +90,13 @@ onWindowStageDestroy(ability: Ability, windowStage: window.WindowStage): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |
## AbilityLifecycleCallback.onAbilityDestroy ## AbilityLifecycleCallback.onAbilityDestroy
onAbilityDestroy(ability: Ability): void; onAbilityDestroy(ability: UIAbility): void;
注册监听应用上下文的生命周期后，在ability销毁时触发回调。 注册监听应用上下文的生命周期后，在ability销毁时触发回调。
...@@ -106,12 +106,12 @@ onAbilityDestroy(ability: Ability): void; ...@@ -106,12 +106,12 @@ onAbilityDestroy(ability: Ability): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onAbilityForeground ## AbilityLifecycleCallback.onAbilityForeground
onAbilityForeground(ability: Ability): void; onAbilityForeground(ability: UIAbility): void;
注册监听应用上下文的生命周期后，在ability的状态从后台转到前台时触发回调。 注册监听应用上下文的生命周期后，在ability的状态从后台转到前台时触发回调。
...@@ -121,12 +121,12 @@ onAbilityForeground(ability: Ability): void; ...@@ -121,12 +121,12 @@ onAbilityForeground(ability: Ability): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onAbilityBackground ## AbilityLifecycleCallback.onAbilityBackground
onAbilityBackground(ability: Ability): void; onAbilityBackground(ability: UIAbility): void;
注册监听应用上下文的生命周期后，在ability的状态从前台转到后台时触发回调。 注册监听应用上下文的生命周期后，在ability的状态从前台转到后台时触发回调。
...@@ -136,12 +136,12 @@ onAbilityBackground(ability: Ability): void; ...@@ -136,12 +136,12 @@ onAbilityBackground(ability: Ability): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onAbilityContinue ## AbilityLifecycleCallback.onAbilityContinue
onAbilityContinue(ability: Ability): void; onAbilityContinue(ability: UIAbility): void;
注册监听应用上下文的生命周期后，在ability迁移时触发回调。 注册监听应用上下文的生命周期后，在ability迁移时触发回调。
...@@ -151,15 +151,15 @@ onAbilityContinue(ability: Ability): void; ...@@ -151,15 +151,15 @@ onAbilityContinue(ability: Ability): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |
**示例：** **示例：**
```ts ```ts
import Ability from "@ohos.application.Ability"; import UIAbility from "@ohos.app.ability.UIAbility";
export default class MyAbility extends Ability { export default class MyAbility extends UIAbility {
onCreate() { onCreate() {
console.log("MyAbility onCreate") console.log("MyAbility onCreate")
let AbilityLifecycleCallback = { let AbilityLifecycleCallback = {
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
浏览文件 @ ce06dbac
...@@ -41,7 +41,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void ...@@ -41,7 +41,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
**参数**： **参数**：
| 名称 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项。 | | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项。 |
| callback | AsyncCallback\<void> | 是 | 被指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 被指定的回调方法。 |
...@@ -77,7 +77,7 @@ updateConfiguration(config: Configuration): Promise\<void> ...@@ -77,7 +77,7 @@ updateConfiguration(config: Configuration): Promise\<void>
**参数**： **参数**：
| 名称 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项。 | | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项。 |
...@@ -120,7 +120,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo ...@@ -120,7 +120,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
**参数**： **参数**：
| 名称 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 | | callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 |
...@@ -184,7 +184,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext ...@@ -184,7 +184,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext
**参数**： **参数**：
| 名称 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 | | upperLimit | number | 是 | 获取消息数量的最大限制。 |
| callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 | | callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 |
...@@ -218,7 +218,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn ...@@ -218,7 +218,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
**参数**： **参数**：
| 名称 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 | | upperLimit | number | 是 | 获取消息数量的最大限制。 |
...@@ -257,7 +257,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void; ...@@ -257,7 +257,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void;
**参数**： **参数**：
| 名称 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\<ElementName> | 是 | 被指定的回调方法。 | | callback | AsyncCallback\<ElementName> | 是 | 被指定的回调方法。 |
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityMonitor.md 已删除 100644 → 0
浏览文件 @ 2ef5eafc
# AbilityMonitor
AbilityMonitor模块提供匹配满足指定条件的受监视能力对象的方法的能力，最近匹配的ability对象将保存在AbilityMonitor对象中。
> **说明：**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 使用说明
通过abilityDelegator中的addAbilityMonitor来设置。
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'
var abilityDelegator;
function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback");
}
var monitor = {
abilityName: "abilityname",
onAbilityCreate: onAbilityCreateCallback
}
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
try {
abilityDelegator.addAbilityMonitor(monitor, (err : any) => {
console.info("addAbilityMonitor callback");
});
} catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) +
' error.message: ' + JSON.stringify(paramError.message));
}
```
## AbilityMonitor
Ability监听器
系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------------------------------------------------ | -------- | ---- | ---- | ------------------------------------------------------------ |
| abilityName | string | 是 | 是 | 当前AbilityMonitor绑定的ability名称 |
| moduleName? | string | 是 | 是 | 当前AbilityMonitor绑定的module名称 |
| onAbilityCreate?:(data: [Ability](js-apis-application-ability.md#Ability)) | function | 是 | 是 | ability被启动初始化时的回调函数<br/>不设置该属性则不能收到该生命周期回调 |
| onAbilityForeground?:(data: [Ability](js-apis-application-ability.md#Ability)) | function | 是 | 是 | ability状态变成前台时的回调函数<br/>不设置该属性则不能收到该生命周期回调 |
| onAbilityBackground?:(data: [Ability](js-apis-application-ability.md#Ability)) | function | 是 | 是 | ability状态变成后台时的回调函数<br/>不设置该属性则不能收到该生命周期回调 |
| onAbilityDestroy?:(data: [Ability](js-apis-application-ability.md#Ability)) | function | 是 | 是 | ability被销毁前的回调函数<br/>不设置该属性则不能收到该生命周期回调<br/> |
| onWindowStageCreate?:(data: [Ability](js-apis-application-ability.md#Ability)) | function | 是 | 是 | window stage被创建时的回调函数<br/>不设置该属性则不能收到该生命周期回调<br/> |
| onWindowStageRestore?:(data: [Ability](js-apis-application-ability.md#Ability)) | function | 是 | 是 | window stage被重载时的回调函数<br/>不设置该属性则不能收到该生命周期回调<br/> |
| onWindowStageDestroy?:(data: [Ability](js-apis-application-ability.md#Ability)) | function | 是 | 是 | window stage被销毁前的回调函数<br/>不设置该属性则不能收到该生命周期回调<br/> |
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md
浏览文件 @ ce06dbac
...@@ -9,7 +9,7 @@ AbilityStage类提供在HAP加载的时候，通知开发者，可以在此进 ...@@ -9,7 +9,7 @@ AbilityStage类提供在HAP加载的时候，通知开发者，可以在此进
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。 > 本模块接口仅可在Stage模型下使用。
## 导入类 ## 导入模块
```ts ```ts
import AbilityStage from '@ohos.app.ability.AbilityStage'; import AbilityStage from '@ohos.app.ability.AbilityStage';
...@@ -66,9 +66,9 @@ onAcceptWant(want: Want): string; ...@@ -66,9 +66,9 @@ onAcceptWant(want: Want): string;
``` ```
## AbilityStage.onConfigurationUpdated ## AbilityStage.onConfigurationUpdate
onConfigurationUpdated(config: Configuration): void; onConfigurationUpdate(newConfig: Configuration): void;
环境变化通知接口，发生全局配置变更时回调。 环境变化通知接口，发生全局配置变更时回调。
...@@ -78,14 +78,14 @@ onConfigurationUpdated(config: Configuration): void; ...@@ -78,14 +78,14 @@ onConfigurationUpdated(config: Configuration): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 发生全局配置变更时触发回调，当前全局配置包括系统语言、深浅色模式。 | | newConfig | [Configuration](js-apis-app-ability-configuration.md) | 是 | 发生全局配置变更时触发回调，当前全局配置包括系统语言、深浅色模式。 |
**示例：** **示例：**
```ts ```ts
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onConfigurationUpdated(config) { onConfigurationUpdate(config) {
console.log('onConfigurationUpdated, language:' + config.language); console.log('onConfigurationUpdate, language:' + config.language);
} }
} }
``` ```
...@@ -96,7 +96,7 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; ...@@ -96,7 +96,7 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
当系统已决定调整内存时调用。例如，当该功能在后台运行时，没有足够的内存来运行尽可能多的后台进程时可以使用。 当系统已决定调整内存时调用。例如，当该功能在后台运行时，没有足够的内存来运行尽可能多的后台进程时可以使用。
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md
浏览文件 @ ce06dbac
...@@ -9,7 +9,7 @@ appManager模块提供App管理的能力，包括查询当前是否处于稳定 ...@@ -9,7 +9,7 @@ appManager模块提供App管理的能力，包括查询当前是否处于稳定
## 导入模块 ## 导入模块
```ts ```ts
import app from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
``` ```
## appManager.isRunningInStabilityTest<sup>9+</sup> ## appManager.isRunningInStabilityTest<sup>9+</sup>
...@@ -24,7 +24,7 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -24,7 +24,7 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 否 | 返回当前是否处于稳定性测试场景。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 返回当前是否处于稳定性测试场景。 |
**示例：** **示例：**
...@@ -98,7 +98,7 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void; ...@@ -98,7 +98,7 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 否 | 返回当前是否是ram受限设备。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 返回当前是否是ram受限设备。 |
**示例：** **示例：**
...@@ -145,7 +145,7 @@ getAppMemorySize(callback: AsyncCallback\<number>): void; ...@@ -145,7 +145,7 @@ getAppMemorySize(callback: AsyncCallback\<number>): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;number&gt; | 否 | 应用程序内存大小。 | | callback | AsyncCallback&lt;number&gt; | 是 | 应用程序内存大小。 |
**示例：** **示例：**
...@@ -167,6 +167,8 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>; ...@@ -167,6 +167,8 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -195,6 +197,8 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo ...@@ -195,6 +197,8 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -220,6 +224,8 @@ getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>; ...@@ -220,6 +224,8 @@ getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>;
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -250,7 +256,7 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor ...@@ -250,7 +256,7 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 否 | 获取有关运行进程的信息。 | | callback | AsyncCallback\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 是 | 获取有关运行进程的信息。 |
**示例：** **示例：**
...@@ -261,9 +267,9 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor ...@@ -261,9 +267,9 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor
}) })
``` ```
## appManager.registerApplicationStateObserver<sup>9+</sup> ## appManager.on
registerApplicationStateObserver(observer: ApplicationStateObserver): number; on(type: "applicationState", observer: ApplicationStateObserver): number;
注册全部应用程序状态观测器。 注册全部应用程序状态观测器。
...@@ -277,11 +283,12 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number; ...@@ -277,11 +283,12 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 否 | 返回观察者的数字代码。 | | type | string | 是 | 调用接口类型 |
| observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | 是 | 返回观察者的数字代码。 |
**示例：** **示例：**
```ts ```js
var applicationStateObserver = { var applicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log('------------ onForegroundApplicationChanged -----------', appStateData); console.log('------------ onForegroundApplicationChanged -----------', appStateData);
...@@ -299,13 +306,18 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number; ...@@ -299,13 +306,18 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number;
console.log('------------ onProcessStateChanged -----------', processData); console.log('------------ onProcessStateChanged -----------', processData);
} }
} }
const observerCode = app.registerApplicationStateObserver(applicationStateObserver); try {
console.log('-------- observerCode: ---------', observerCode); const observerCode = app.on(applicationStateObserver);
console.log('-------- observerCode: ---------', observerCode);
} catch (paramError) {
console.log('error: ' + paramError.code + ', ' + paramError.message);
}
``` ```
## appManager.registerApplicationStateObserver<sup>9+</sup> ## appManager.on
registerApplicationStateObserver(observer: ApplicationStateObserver, bundleNameList: Array\<string>): number; on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList: Array\<string>): number;
注册指定应用程序状态观测器。 注册指定应用程序状态观测器。
...@@ -319,12 +331,13 @@ registerApplicationStateObserver(observer: ApplicationStateObserver, bundleNameL ...@@ -319,12 +331,13 @@ registerApplicationStateObserver(observer: ApplicationStateObserver, bundleNameL
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 否 | 返回观察者的数字代码。 | | type | string | 是 | 调用接口类型 |
| bundleNameList | Array<string> | 否 | 表示需要注册监听的bundleName数组。最大值128。 | | observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | 是 | 返回观察者的数字代码。 |
| bundleNameList | Array<string> | 是 | 表示需要注册监听的bundleName数组。最大值128。 |
**示例：** **示例：**
```ts ```js
var applicationStateObserver = { var applicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log('------------ onForegroundApplicationChanged -----------', appStateData); console.log('------------ onForegroundApplicationChanged -----------', appStateData);
...@@ -343,12 +356,17 @@ registerApplicationStateObserver(observer: ApplicationStateObserver, bundleNameL ...@@ -343,12 +356,17 @@ registerApplicationStateObserver(observer: ApplicationStateObserver, bundleNameL
} }
} }
var bundleNameList = ['bundleName1', 'bundleName2']; var bundleNameList = ['bundleName1', 'bundleName2'];
const observerCode = app.registerApplicationStateObserver(applicationStateObserver, bundleNameList); try {
console.log('-------- observerCode: ---------', observerCode); const observerCode = app.on("applicationState", applicationStateObserver, bundleNameList);
console.log('-------- observerCode: ---------', observerCode);
} catch (paramError) {
console.log('error: ' + paramError.code + ', ' + paramError.message);
}
``` ```
## appManager.unregisterApplicationStateObserver<sup>9+</sup> ## appManager.off
unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\<void>): void; off(type: "applicationState", observerId: number, callback: AsyncCallback\<void>): void;
取消注册应用程序状态观测器。 取消注册应用程序状态观测器。
...@@ -362,22 +380,100 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\ ...@@ -362,22 +380,100 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 |
| observerId | number | 是 | 表示观察者的编号代码。 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例：**
```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\<void>;
取消注册应用程序状态观测器。
**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：该接口为系统接口，三方应用不支持调用。
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 |
| observerId | number | 否 | 表示观察者的编号代码。 | | observerId | number | 否 | 表示观察者的编号代码。 |
| callback | AsyncCallback\<void> | 否 | 表示指定的回调方法。 |
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| Promise\<void> | 返回执行结果。 |
**示例：** **示例：**
```ts ```js
var observerId = 100; var observerId = 100;
function unregisterApplicationStateObserverCallback(err) {
if (err) { try {
console.log('------------ unregisterApplicationStateObserverCallback ------------', err); 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);
} }
}
app.unregisterApplicationStateObserver(observerId, unregisterApplicationStateObserverCallback);
``` ```
## appManager.unregisterApplicationStateObserver<sup>9+</sup> ## appManager.getForegroundApplications
getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
获取前台进程的应用程序。
**需要权限**：ohos.permission.GET_RUNNING_INFO
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：该接口为系统接口，三方应用不支持调用。
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<AppStateData>> | 是 | 表示应用的状态数据。 |
**示例：**
```js
function getForegroundApplicationsCallback(err, data) {
if (err) {
console.log('--------- getForegroundApplicationsCallback fail ---------', err.code + ': ' + err.message);
} else {
console.log('--------- getForegroundApplicationsCallback success ---------', data)
}
}
app.getForegroundApplications(getForegroundApplicationsCallback);
```
unregisterApplicationStateObserver(observerId: number): Promise\<void>; unregisterApplicationStateObserver(observerId: number): Promise\<void>;
...@@ -393,7 +489,7 @@ unregisterApplicationStateObserver(observerId: number): Promise\<void>; ...@@ -393,7 +489,7 @@ unregisterApplicationStateObserver(observerId: number): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| observerId | number | 否 | 表示观察者的编号代码。 | | observerId | number | 是 | 表示观察者的编号代码。 |
**返回值：** **返回值：**
...@@ -430,7 +526,7 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; ...@@ -430,7 +526,7 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<AppStateData>> | 否 | 表示应用的状态数据。 | | callback | AsyncCallback\<Array\<AppStateData>> | 是 | 表示应用的状态数据。 |
**示例：** **示例：**
...@@ -560,8 +656,8 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>); ...@@ -560,8 +656,8 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 否 | 表示包名。 | | bundleName | string | 是 | 表示包名。 |
| callback | AsyncCallback\<void> | 否 | 表示指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例：** **示例：**
...@@ -593,7 +689,7 @@ killProcessesByBundleName(bundleName: string): Promise\<void>; ...@@ -593,7 +689,7 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 否 | 表示包名。 | | bundleName | string | 是 | 表示包名。 |
**返回值：** **返回值：**
...@@ -630,8 +726,8 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>); ...@@ -630,8 +726,8 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 否 | 表示包名。 | | bundleName | string | 是 | 表示包名。 |
| callback | AsyncCallback\<void> | 否 | 表示指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例：** **示例：**
...@@ -663,7 +759,7 @@ clearUpApplicationData(bundleName: string): Promise\<void>; ...@@ -663,7 +759,7 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 否 | 表示包名。 | | bundleName | string | 是 | 表示包名。 |
**返回值：** **返回值：**
...@@ -690,7 +786,7 @@ clearUpApplicationData(bundleName: string): Promise\<void>; ...@@ -690,7 +786,7 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
| 名称 | 值 | 描述 | | 名称 | 值 | 说明 |
| -------------------- | --- | --------------------------------- | | -------------------- | --- | --------------------------------- |
| STATE_CREATE | 1 | 当应用在创建中的时候处于的状态。 | | STATE_CREATE | 1 | 当应用在创建中的时候处于的状态。 |
| STATE_FOREGROUND | 2 | 当应用切换到前台的时候处于的状态。 | | STATE_FOREGROUND | 2 | 当应用切换到前台的时候处于的状态。 |
...@@ -704,7 +800,7 @@ clearUpApplicationData(bundleName: string): Promise\<void>; ...@@ -704,7 +800,7 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
| 名称 | 值 | 描述 | | 名称 | 值 | 说明 |
| -------------------- | --- | --------------------------------- | | -------------------- | --- | --------------------------------- |
| STATE_CREATE | 1 | 当进程在创建中的时候处于的状态。 | | STATE_CREATE | 1 | 当进程在创建中的时候处于的状态。 |
| STATE_FOREGROUND | 2 | 当进程切换到前台的时候处于的状态。 | | STATE_FOREGROUND | 2 | 当进程切换到前台的时候处于的状态。 |
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md
浏览文件 @ ce06dbac
...@@ -21,10 +21,10 @@ import appRecovery from '@ohos.app.ability.appRecovery' ...@@ -21,10 +21,10 @@ import appRecovery from '@ohos.app.ability.appRecovery'
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------------------------- | ---- | ------------------------------------------------------------ | | ----------------------------- | ---- | ------------------------------------------------------------ |
| ALWAYS_RESTART | 0 | 总是重启应用。 | | ALWAYS_RESTART | 0 | 总是重启应用。 |
| CPP_CRASH_NO_RESTART | 1 | 发生CPP_CRASH时不重启应用。 | | CPP_CRASH_NO_RESTART | 0x0001 | 发生CPP_CRASH时不重启应用。 |
| JS_CRASH_NO_RESTART | 2 | 发生JS_CRASH时不重启应用。 | | JS_CRASH_NO_RESTART | 0x0002 | 发生JS_CRASH时不重启应用。 |
| APP_FREEZE_NO_RESTART | 4 | 发生APP_FREEZE时不重启应用。 | | APP_FREEZE_NO_RESTART | 0x0004 | 发生APP_FREEZE时不重启应用。 |
| NO_RESTART | 65535 | 总是不重启应用。 | | NO_RESTART | 0xFFFF | 总是不重启应用。 |
## appRecovery.SaveOccasionFlag ## appRecovery.SaveOccasionFlag
...@@ -34,8 +34,8 @@ import appRecovery from '@ohos.app.ability.appRecovery' ...@@ -34,8 +34,8 @@ import appRecovery from '@ohos.app.ability.appRecovery'
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------------------------- | ---- | ------------------------------------------------------------ | | ----------------------------- | ---- | ------------------------------------------------------------ |
| SAVE_WHEN_ERROR | 1 | 当发生应用故障时保存。 | | SAVE_WHEN_ERROR | 0x0001 | 当发生应用故障时保存。 |
| SAVE_WHEN_BACKGROUND | 2 | 当应用切入后台时保存。 | | SAVE_WHEN_BACKGROUND | 0x0002 | 当应用切入后台时保存。 |
## appRecovery.SaveModeFlag ## appRecovery.SaveModeFlag
...@@ -45,8 +45,8 @@ import appRecovery from '@ohos.app.ability.appRecovery' ...@@ -45,8 +45,8 @@ import appRecovery from '@ohos.app.ability.appRecovery'
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------------------------- | ---- | ------------------------------------------------------------ | | ----------------------------- | ---- | ------------------------------------------------------------ |
| SAVE_WITH_FILE | 1 | 每次状态保存都会写入到本地文件缓存。 | | SAVE_WITH_FILE | 0x0001 | 每次状态保存都会写入到本地文件缓存。 |
| SAVE_WITH_SHARED_MEMORY | 2 | 状态先保存在内存中，应用故障退出时写入到本地文件缓存。 | | SAVE_WITH_SHARED_MEMORY | 0x0002 | 状态先保存在内存中，应用故障退出时写入到本地文件缓存。 |
## appRecovery.enableAppRecovery ## appRecovery.enableAppRecovery
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-common.md
浏览文件 @ ce06dbac
...@@ -15,21 +15,21 @@ import common from '@ohos.app.ability.common' ...@@ -15,21 +15,21 @@ import common from '@ohos.app.ability.common'
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 读写属性 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | | ----------- | -------------------- | ---- | ------------------------------------------------------------ |
| UIAbilityContext | 只读 | [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md) | 否 | UIAbilityContext二级模块。 | | UIAbilityContext | [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md) | 否 | UIAbilityContext二级模块。 |
| AbilityStageContext | 只读 | [AbilityStageContext](js-apis-inner-application-abilityStageContext.md) | 否 | AbilityStageContext二级模块。 | | AbilityStageContext | [AbilityStageContext](js-apis-inner-application-abilityStageContext.md) | 否 | AbilityStageContext二级模块。 |
| ApplicationContext | 只读 | [ApplicationContext](js-apis-inner-application-applicationContext.md) | 否 | ApplicationContext二级模块。 | | ApplicationContext | [ApplicationContext](js-apis-inner-application-applicationContext.md) | 否 | ApplicationContext二级模块。 |
| BaseContext | 只读 | [BaseContext](js-apis-inner-application-baseContext.md) | 否 | BaseContext二级模块。 | | BaseContext | [BaseContext](js-apis-inner-application-baseContext.md) | 否 | BaseContext二级模块。 |
| Context | 只读 | [Context](js-apis-inner-application-context.md) | 否 | Context二级模块。 | | Context | [Context](js-apis-inner-application-context.md) | 否 | Context二级模块。 |
| ExtensionContext | 只读 | [ExtensionContext](js-apis-inner-application-extensionContext.md) | 否 | ExtensionContext二级模块。 | | ExtensionContext | [ExtensionContext](js-apis-inner-application-extensionContext.md) | 否 | ExtensionContext二级模块。 |
| FormExtensionContext | 只读 | [FormExtensionContext](js-apis-inner-application-formExtensionContext.md) | 否 | FormExtensionContext二级模块。 | | FormExtensionContext | [FormExtensionContext](js-apis-inner-application-formExtensionContext.md) | 否 | FormExtensionContext二级模块。 |
| AreaMode | 只读 | [AreaMode](#areamode) | 否 | AreaMode枚举值。 | | AreaMode | [AreaMode](#areamode) | 否 | AreaMode枚举值。 |
| EventHub | 只读 | [EventHub](js-apis-inner-application-eventHub.md) | 否 | EventHub二级模块。 | | EventHub | [EventHub](js-apis-inner-application-eventHub.md) | 否 | EventHub二级模块。 |
| PermissionRequestResult | 只读 | [PermissionRequestResult](js-apis-inner-application-permissionRequestResult.md) | 否 | PermissionRequestResult二级模块。 | | PermissionRequestResult | [PermissionRequestResult](js-apis-inner-application-permissionRequestResult.md) | 否 | PermissionRequestResult二级模块。 |
| PacMap | 只读 | [PacMap](js-apis-inner-ability-dataAbilityHelper.md#PacMap) | 否 | PacMap二级模块。 | | PacMap | [PacMap](js-apis-inner-ability-dataAbilityHelper.md#PacMap) | 否 | PacMap二级模块。 |
| AbilityResult | 只读 | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 否 | AbilityResult二级模块。 | | AbilityResult | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 否 | AbilityResult二级模块。 |
| ConnectOptions | 只读 | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 否 | ConnectOptions二级模块。 | | ConnectOptions | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 否 | ConnectOptions二级模块。 |
**示例：** **示例：**
```ts ```ts
...@@ -56,7 +56,7 @@ let connectOptions: common.ConnectOptions; ...@@ -56,7 +56,7 @@ let connectOptions: common.ConnectOptions;
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 变量 | 值 | 描述 | | 名称 | 值 | 说明 |
| --------------- | ---- | --------------- | | --------------- | ---- | --------------- |
| EL1 | 0 | 设备级加密区。 | | EL1 | 0 | 设备级加密区。 |
| EL2 | 1 | 用户凭据加密区。默认为EL2。 | | EL2 | 1 | 用户凭据加密区。默认为EL2。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md
浏览文件 @ ce06dbac
...@@ -6,12 +6,18 @@ ...@@ -6,12 +6,18 @@
> >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 导入模块
```ts
import Configuration from '@ohos.app.ability.Configuration'
```
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| language | string | 是 | 是 | 表示应用程序的当前语言。 | | language | string | 是 | 是 | 表示应用程序的当前语言。 |
| colorMode | [ColorMode](js-apis-app-ability-configurationconstant.md#configurationconstantcolormode) | 是 | 是 | 表示深浅色模式，取值范围：浅色模式（COLOR_MODE_LIGHT），深色模式（COLOR_MODE_DARK）。默认为浅色。 | | colorMode | [ColorMode](js-apis-app-ability-configurationConstant.md#configurationconstantcolormode) | 是 | 是 | 表示深浅色模式，取值范围：浅色模式（COLOR_MODE_LIGHT），深色模式（COLOR_MODE_DARK）。默认为浅色。 |
| direction | Direction | 是 | 否 | 表示屏幕方向，取值范围：水平方向（DIRECTION_HORIZONTAL），垂直方向（DIRECTION_VERTICAL）。 | | direction | Direction | 是 | 否 | 表示屏幕方向，取值范围：水平方向（DIRECTION_HORIZONTAL），垂直方向（DIRECTION_VERTICAL）。 |
| screenDensity | ScreenDensity | 是 | 否 | 表示屏幕分辨率，取值范围：SCREEN_DENSITY_SDPI（120）、SCREEN_DENSITY_MDPI（160）、SCREEN_DENSITY_LDPI（240）、SCREEN_DENSITY_XLDPI（320）、SCREEN_DENSITY_XXLDPI（480）、SCREEN_DENSITY_XXXLDPI（640）。 | | screenDensity | ScreenDensity | 是 | 否 | 表示屏幕分辨率，取值范围：SCREEN_DENSITY_SDPI（120）、SCREEN_DENSITY_MDPI（160）、SCREEN_DENSITY_LDPI（240）、SCREEN_DENSITY_XLDPI（320）、SCREEN_DENSITY_XXLDPI（480）、SCREEN_DENSITY_XXXLDPI（640）。 |
| displayId | number | 是 | 否 | 表示应用所在的物理屏幕Id。 | | displayId | number | 是 | 否 | 表示应用所在的物理屏幕Id。 |
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-contextConstant.md
浏览文件 @ ce06dbac
...@@ -17,7 +17,7 @@ import contextConstant from '@ohos.app.ability.contextConstant'; ...@@ -17,7 +17,7 @@ import contextConstant from '@ohos.app.ability.contextConstant';
使用时通过ContextConstant.AreaMode获取。 使用时通过ContextConstant.AreaMode获取。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| -------- | -------- | -------- | | -------- | -------- | -------- |
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-errorManager.md
浏览文件 @ ce06dbac
...@@ -24,7 +24,7 @@ on(type: "error", observer: ErrorObserver): number; ...@@ -24,7 +24,7 @@ on(type: "error", observer: ErrorObserver): number;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 | | type | string | 是 | 调用接口类型 |
| observer | [ErrorObserver](#errorobserver) | 否 | 返回观察者的数字代码。 | | observer | [ErrorObserver](./js-apis-inner-application-errorObserver.md) | 是 | 返回观察者的数字代码。 |
**示例：** **示例：**
...@@ -54,8 +54,8 @@ off(type: "error", observerId: number, callback: AsyncCallback\<void>): void; ...@@ -54,8 +54,8 @@ off(type: "error", observerId: number, callback: AsyncCallback\<void>): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 | | type | string | 是 | 调用接口类型 |
| observerId | number | 否 | 返回观察者的数字代码。 | | observerId | number | 是 | 返回观察者的数字代码。 |
| callback | AsyncCallback\<void> | 否 | 表示指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例：** **示例：**
...@@ -87,7 +87,7 @@ off(type: "error", observerId: number): Promise\<void>; ...@@ -87,7 +87,7 @@ off(type: "error", observerId: number): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 | | type | string | 是 | 调用接口类型 |
| observerId | number | 否 | 返回观察者的数字代码。 | | observerId | number | 是 | 返回观察者的数字代码。 |
**返回值：** **返回值：**
...@@ -112,28 +112,3 @@ try { ...@@ -112,28 +112,3 @@ try {
} }
``` ```
## ErrorObserver
onUnhandledException(errMsg: string): void;
将在js运行时引发用户未捕获的异常时调用。
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| errMsg | string | 否 | 有关异常的消息和错误堆栈跟踪。 |
**示例：**
```js
var observer = {
onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg)
}
}
errorManager.on(observer)
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md
浏览文件 @ ce06dbac
...@@ -20,11 +20,11 @@ hap级别的快速修复信息。 ...@@ -20,11 +20,11 @@ hap级别的快速修复信息。
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| ----------- | -------- |-------- | -------------------- | ---- | ------------------------------------------------------------ | | ----------- | -------------------- | ---- | ------------------------------------------------------------ |
| moduleName | 是 | 否 | string | 是 | hap包的名称。 | | moduleName | string | 是 | hap包的名称。 |
| originHapHash | 是 | 否 | string | 是 | 指示hap的哈希值。 | | originHapHash | string | 是 | 指示hap的哈希值。 |
| quickFixFilePath | 是 | 否 | string | 是 | 指示快速修复文件的安装路径。 | | quickFixFilePath | string | 是 | 指示快速修复文件的安装路径。 |
## ApplicationQuickFixInfo ## ApplicationQuickFixInfo
...@@ -34,14 +34,14 @@ hap级别的快速修复信息。 ...@@ -34,14 +34,14 @@ hap级别的快速修复信息。
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| ----------- | -------- |-------- | -------------------- | ---- | ------------------------------------------------------------ | | ----------- | -------------------- | ---- | ------------------------------------------------------------ |
| bundleName | 是 | 否 | string | 是 | 应用的包名。 | | bundleName | string | 是 | 应用的包名。 |
| bundleVersionCode | 是 | 否 | number | 是 | 应用的版本号。 | | bundleVersionCode | number | 是 | 应用的版本号。 |
| bundleVersionName | 是 | 否 | string | 是 | 应用版本号的文字描述。 | | bundleVersionName | string | 是 | 应用版本号的文字描述。 |
| quickFixVersionCode | 是 | 否 | number | 是 | 快速修复补丁包的版本号。 | | quickFixVersionCode | number | 是 | 快速修复补丁包的版本号。 |
| quickFixVersionName | 是 | 否 | string | 是 | 快速修复补丁包版本号的文字描述。 | | quickFixVersionName | string | 是 | 快速修复补丁包版本号的文字描述。 |
| hapModuleQuickFixInfo | 是 | 否 | Array\<[HapModuleQuickFixInfo](#hapmodulequickfixinfo)> | 是 | hap级别的快速修复信息。 | | hapModuleQuickFixInfo | Array\<[HapModuleQuickFixInfo](#hapmodulequickfixinfo)> | 是 | hap级别的快速修复信息。 |
## quickFixManager.applyQuickFix ## quickFixManager.applyQuickFix
...@@ -59,8 +59,8 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>, callback: AsyncCallback\<v ...@@ -59,8 +59,8 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>, callback: AsyncCallback\<v
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| hapModuleQuickFixFiles | Array\<string> | 否 | 快速修复补丁文件（补丁文件需包含有效的文件路径）。 | | hapModuleQuickFixFiles | Array\<string> | 是 | 快速修复补丁文件（补丁文件需包含有效的文件路径）。 |
| callback | AsyncCallback\<void> | 否 | 表示指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例：** **示例：**
...@@ -97,7 +97,7 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>): Promise\<void>; ...@@ -97,7 +97,7 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| hapModuleQuickFixFiles | Array\<string> | 否 | 快速修复补丁文件（补丁文件需包含有效的文件路径）。 | | hapModuleQuickFixFiles | Array\<string> | 是 | 快速修复补丁文件（补丁文件需包含有效的文件路径）。 |
**返回值：** **返回值：**
...@@ -138,8 +138,8 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\<Applicat ...@@ -138,8 +138,8 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\<Applicat
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 否 |应用的包名。 | | bundleName | string | 是 |应用的包名。 |
| callback | AsyncCallback\<[ApplicationQuickFixInfo](#applicationquickfixinfo)> | 否 | 应用的快速修复信息。 | | callback | AsyncCallback\<[ApplicationQuickFixInfo](#applicationquickfixinfo)> | 是 | 应用的快速修复信息。 |
**示例：** **示例：**
...@@ -176,7 +176,7 @@ getApplicationQuickFixInfo(bundleName: string): Promise\<ApplicationQuickFixInfo ...@@ -176,7 +176,7 @@ getApplicationQuickFixInfo(bundleName: string): Promise\<ApplicationQuickFixInfo
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 否 | 应用的包名。 | | bundleName | string | 是 | 应用的包名。 |
**返回值：** **返回值：**
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-serviceExtensionAbility.md
浏览文件 @ ce06dbac
...@@ -23,7 +23,7 @@ import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; ...@@ -23,7 +23,7 @@ import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| context | [ServiceExtensionContext](js-apis-inner-application-serviceExtensionContext.md) | 是 | 否 | ServiceExtension的上下文环境，继承自ExtensionContext。 | | context | [ServiceExtensionContext](js-apis-inner-application-serviceExtensionContext.md) | 是 | 否 | ServiceExtension的上下文环境，继承自ExtensionContext。 |
...@@ -198,9 +198,9 @@ onReconnect(want: Want): void; ...@@ -198,9 +198,9 @@ onReconnect(want: Want): void;
} }
``` ```
## ServiceExtensionAbility.onConfigurationUpdated ## ServiceExtensionAbility.onConfigurationUpdate
onConfigurationUpdated(config: Configuration): void; onConfigurationUpdate(config: Configuration): void;
当Extension更新配置信息时调用。 当Extension更新配置信息时调用。
...@@ -218,15 +218,15 @@ onConfigurationUpdated(config: Configuration): void; ...@@ -218,15 +218,15 @@ onConfigurationUpdated(config: Configuration): void;
```ts ```ts
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onConfigurationUpdated(config) { onConfigurationUpdate(config) {
console.log('onConfigurationUpdated, config:' + JSON.stringify(config)); console.log('onConfigurationUpdate, config:' + JSON.stringify(config));
} }
} }
``` ```
## ServiceExtensionAbility.dump ## ServiceExtensionAbility.onDump
dump(params: Array\<string>): Array\<string>; onDump(params: Array\<string>): Array\<string>;
转储客户端信息时调用。 转储客户端信息时调用。
...@@ -244,7 +244,7 @@ dump(params: Array\<string>): Array\<string>; ...@@ -244,7 +244,7 @@ dump(params: Array\<string>): Array\<string>;
```ts ```ts
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
dump(params) { onDump(params) {
console.log('dump, params:' + JSON.stringify(params)); console.log('dump, params:' + JSON.stringify(params));
return ["params"] return ["params"]
} }
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md
浏览文件 @ ce06dbac
...@@ -18,7 +18,7 @@ import StartOptions from '@ohos.app.ability.StartOptions'; ...@@ -18,7 +18,7 @@ import StartOptions from '@ohos.app.ability.StartOptions';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 参数类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| [windowMode](js-apis-application-abilityConstant.md#abilityconstantwindowmode) | 是 | 否 | number | 否 | 窗口模式。 | | [windowMode](js-apis-application-abilityConstant.md#abilityconstantwindowmode) | number | 否 | 窗口模式。 |
| displayId | 是 | 否 | number | 否 | 显示ID。 | | displayId | number | 否 | 显示ID。 |
zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
浏览文件 @ ce06dbac
...@@ -22,7 +22,7 @@ import Ability from '@ohos.app.ability.UIAbility'; ...@@ -22,7 +22,7 @@ import Ability from '@ohos.app.ability.UIAbility';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.AbilityCore **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.AbilityCore
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| context | [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md) | 是 | 否 | 上下文。 | | context | [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md) | 是 | 否 | 上下文。 |
| launchWant | [Want](js-apis-app-ability-want.md) | 是 | 否 | Ability启动时的参数。 | | launchWant | [Want](js-apis-app-ability-want.md) | 是 | 否 | Ability启动时的参数。 |
...@@ -240,9 +240,9 @@ onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void; ...@@ -240,9 +240,9 @@ onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void;
} }
``` ```
## Ability.dump ## Ability.onDump
dump(params: Array\<string>): Array\<string>; onDump(params: Array\<string>): Array\<string>;
转储客户端信息时调用。 转储客户端信息时调用。
...@@ -258,7 +258,7 @@ dump(params: Array\<string>): Array\<string>; ...@@ -258,7 +258,7 @@ dump(params: Array\<string>): Array\<string>;
```ts ```ts
class myAbility extends Ability { class myAbility extends Ability {
dump(params) { onDump(params) {
console.log('dump, params:' + JSON.stringify(params)); console.log('dump, params:' + JSON.stringify(params));
return ["params"] return ["params"]
} }
...@@ -332,11 +332,8 @@ call(method: string, data: rpc.Sequenceable): Promise&lt;void&gt;; ...@@ -332,11 +332,8 @@ call(method: string, data: rpc.Sequenceable): Promise&lt;void&gt;;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 201 | The application does not have permission to call the interface. | | 401 | If the input parameter is not valid parameter. |
| 401 | Invalid input parameter. | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
| 16200001 | Caller released. The caller has been released. |
| 16200002 | Callee invalid. The callee does not exist. |
| 16000050 | Internal Error. |
**示例：** **示例：**
...@@ -416,11 +413,8 @@ callWithResult(method: string, data: rpc.Sequenceable): Promise&lt;rpc.MessagePa ...@@ -416,11 +413,8 @@ callWithResult(method: string, data: rpc.Sequenceable): Promise&lt;rpc.MessagePa
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 201 | The application does not have permission to call the interface. | | 401 | If the input parameter is not valid parameter. |
| 401 | Invalid input parameter. | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
| 16200001 | Caller released. The caller has been released. |
| 16200002 | Callee invalid. The callee does not exist. |
| 16000050 | Internal Error. |
**示例：** **示例：**
...@@ -541,9 +535,8 @@ release(): void; ...@@ -541,9 +535,8 @@ release(): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | If the input parameter is not valid parameter. |
| 16200001 | Caller released. The caller has been released. | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
| 16000050 | Internal Error. |
**示例：** **示例：**
...@@ -581,7 +574,7 @@ release(): void; ...@@ -581,7 +574,7 @@ release(): void;
## Callee.on ## Callee.on
on(method: string, callback: CalleeCallBack): void; on(method: string, callback: CalleeCallback): void;
通用组件服务端注册消息通知callback。 通用组件服务端注册消息通知callback。
...@@ -592,15 +585,14 @@ on(method: string, callback: CalleeCallBack): void; ...@@ -592,15 +585,14 @@ on(method: string, callback: CalleeCallBack): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| method | string | 是 | 与客户端约定的通知消息字符串。 | | method | string | 是 | 与客户端约定的通知消息字符串。 |
| callback | CalleeCallBack | 是 | 一个rpc.MessageParcel类型入参的js通知同步回调函数,&nbsp;回调函数至少要返回一个空的rpc.Sequenceable数据对象,&nbsp;其他视为函数执行错误。 | | callback | CalleeCallback | 是 | 一个rpc.MessageParcel类型入参的js通知同步回调函数,&nbsp;回调函数至少要返回一个空的rpc.Sequenceable数据对象,&nbsp;其他视为函数执行错误。 |
**错误码：** **错误码：**
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | If the input parameter is not valid parameter. |
| 16200004 | Method registered. The method has registered. | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
| 16000050 | Internal Error. |
**示例：** **示例：**
...@@ -665,9 +657,8 @@ off(method: string): void; ...@@ -665,9 +657,8 @@ off(method: string): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | Invalid input parameter. | | 401 | If the input parameter is not valid parameter. |
| 16200005 | Method not registered. The method has not registered. | 其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
| 16000050 | Internal Error. |
**示例：** **示例：**
...@@ -694,9 +685,9 @@ off(method: string): void; ...@@ -694,9 +685,9 @@ off(method: string): void;
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 可读 | 可写 | 类型 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| (msg: string) | function | 是 | 否 | 调用者注册的侦听器函数接口的原型。 | | (msg: string) | 是 | 否 | function | 调用者注册的侦听器函数接口的原型。 |
## CalleeCallback ## CalleeCallback
...@@ -704,6 +695,6 @@ off(method: string): void; ...@@ -704,6 +695,6 @@ off(method: string): void;
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 可读 | 可写 | 类型 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| (indata: rpc.MessageParcel) | rpc.Sequenceable | 是 | 否 | 被调用方注册的消息侦听器函数接口的原型。 | | (indata: rpc.MessageParcel) | 是 | 否 | rpc.Sequenceable | 被调用方注册的消息侦听器函数接口的原型。 |
zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md
浏览文件 @ ce06dbac
...@@ -6,7 +6,7 @@ Want是对象间信息传递的载体, 可以用于应用组件间的信息传 ...@@ -6,7 +6,7 @@ Want是对象间信息传递的载体, 可以用于应用组件间的信息传
> >
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 导入类 ## 导入模块
```ts ```ts
import Want from '@ohos.app.ability.Want'; import Want from '@ohos.app.ability.Want';
...@@ -16,18 +16,18 @@ import Want from '@ohos.app.ability.Want'; ...@@ -16,18 +16,18 @@ import Want from '@ohos.app.ability.Want';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 读写属性 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | | ----------- | -------------------- | ---- | ------------------------------------------------------------ |
| deviceId | 只读 | string | 否 | 表示运行指定Ability的设备ID。 | | deviceId | string | 否 | 表示运行指定Ability的设备ID。 |
| bundleName | 只读 | string | 否 | 表示包描述。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 | | bundleName | string | 否 | 表示包描述。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 |
| abilityName | 只读 | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 | | abilityName | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 |
| uri | 只读 | string | 否 | 表示Uri描述。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme, schemeSpecificPart, authority和path信息。 | | 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。 | | 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)。 | | flags | number | 否 | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-ability-wantConstant.md#wantConstant.Flags)。 |
| action | 只读 | string | 否 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。 | | action | string | 否 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。 |
| parameters | 只读 | {[key: string]: any} | 否 | 表示WantParams描述，由开发者自行决定传入的键值对。默认会携带以下key值：<br>ohos.aafwk.callerPid 表示拉起方的pid。<br>ohos.aafwk.param.callerToken 表示拉起方的token。<br>ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。 | | parameters | {[key: string]: any} | 否 | 表示WantParams描述，由开发者自行决定传入的键值对。默认会携带以下key值：<br>ohos.aafwk.callerPid 表示拉起方的pid。<br>ohos.aafwk.param.callerToken 表示拉起方的token。<br>ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。 |
| entities | 只读 | Array\<string> | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 | | entities | Array\<string> | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 |
| moduleName | 只读 | string | 否 | 表示待启动的Ability所属的模块（module）。 | | moduleName | string | 否 | 表示待启动的Ability所属的模块（module）。 |
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md
浏览文件 @ ce06dbac
...@@ -22,10 +22,10 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void ...@@ -22,10 +22,10 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --- | ---- | -------------------------- | ---- | ----------------------- | | -------- | -------------------------- | ---- | ----------------------- |
| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 | | info | WantAgentInfo | 是 | WantAgent信息。 |
| callback | 是 | 否 | AsyncCallback\<WantAgent\> | 是 | 创建WantAgent的回调方法。 | | callback | AsyncCallback\<WantAgent\> | 是 | 创建WantAgent的回调方法。 |
**示例：** **示例：**
...@@ -83,9 +83,9 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\> ...@@ -83,9 +83,9 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\>
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | --- | ---- | ------------- | ---- | ------------- | | ---- | ------------- | ---- | ------------- |
| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 | | info | WantAgentInfo | 是 | WantAgent信息。 |
**返回值：** **返回值：**
...@@ -148,10 +148,10 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void ...@@ -148,10 +148,10 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --- | ---- | ----------------------- | ---- | --------------------------------- | | -------- | ----------------------- | ---- | --------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<string\> | 是 | 获取WantAgent实例的包名的回调方法。 | | callback | AsyncCallback\<string\> | 是 | 获取WantAgent实例的包名的回调方法。 |
**示例：** **示例：**
...@@ -224,9 +224,9 @@ getBundleName(agent: WantAgent): Promise\<string\> ...@@ -224,9 +224,9 @@ getBundleName(agent: WantAgent): Promise\<string\>
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | --- | ---- | --------- | ---- | ------------- | | ----- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -297,10 +297,10 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void ...@@ -297,10 +297,10 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --- | ---- | ----------------------- | ---- | ----------------------------------- | | -------- | ----------------------- | ---- | ----------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<number\> | 是 | 获取WantAgent实例的用户ID的回调方法。 | | callback | AsyncCallback\<number\> | 是 | 获取WantAgent实例的用户ID的回调方法。 |
**示例：** **示例：**
...@@ -373,9 +373,9 @@ getUid(agent: WantAgent): Promise\<number\> ...@@ -373,9 +373,9 @@ getUid(agent: WantAgent): Promise\<number\>
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | --- | ---- | --------- | ---- | ------------- | | ----- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -448,10 +448,10 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void ...@@ -448,10 +448,10 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --- | ---- | --------------------- | ---- | ------------------------------- | | -------- | --------------------- | ---- | ------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<Want\> | 是 | 获取WantAgent对象want的回调方法。 | | callback | AsyncCallback\<Want\> | 是 | 获取WantAgent对象want的回调方法。 |
**示例：** **示例：**
...@@ -526,9 +526,9 @@ getWant(agent: WantAgent): Promise\<Want\> ...@@ -526,9 +526,9 @@ getWant(agent: WantAgent): Promise\<Want\>
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | --- | ---- | --------- | ---- | ------------- | | ----- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -599,10 +599,10 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void ...@@ -599,10 +599,10 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --- | ---- | --------------------- | ---- | --------------------------- | | -------- | --------------------- | ---- | --------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<void\> | 是 | 取消WantAgent实例的回调方法。 | | callback | AsyncCallback\<void\> | 是 | 取消WantAgent实例的回调方法。 |
**示例：** **示例：**
...@@ -675,9 +675,9 @@ cancel(agent: WantAgent): Promise\<void\> ...@@ -675,9 +675,9 @@ cancel(agent: WantAgent): Promise\<void\>
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | --- | ---- | --------- | ---- | ------------- | | ----- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -740,7 +740,7 @@ try { ...@@ -740,7 +740,7 @@ try {
## WantAgent.trigger ## WantAgent.trigger
trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\<CompleteData\>): void trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback\<CompleteData\>): void
主动激发WantAgent实例（callback形式）。 主动激发WantAgent实例（callback形式）。
...@@ -748,11 +748,11 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\<Complet ...@@ -748,11 +748,11 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\<Complet
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | --- | ---- | ----------------------------- | ---- | ------------------------------- | | ----------- | ----------------------------- | ---- | ------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| triggerInfo | 是 | 否 | TriggerInfo | 是 | TriggerInfo对象。 | | triggerInfo | TriggerInfo | 是 | TriggerInfo对象。 |
| callback | 是 | 否 | AsyncCallback\<CompleteData\> | 是 | 主动激发WantAgent实例的回调方法。 | | callback | AsyncCallback\<CompleteData\> | 否 | 主动激发WantAgent实例的回调方法。 |
**示例：** **示例：**
...@@ -830,11 +830,11 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\ ...@@ -830,11 +830,11 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | --- | ---- | ------------------------ | ---- | --------------------------------------- | | ---------- | ------------------------ | ---- | --------------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| otherAgent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | otherAgent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<boolean\> | 是 | 判断两个WantAgent实例是否相等的回调方法。 | | callback | AsyncCallback\<boolean\> | 是 | 判断两个WantAgent实例是否相等的回调方法。 |
**示例：** **示例：**
...@@ -909,10 +909,10 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\> ...@@ -909,10 +909,10 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\>
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | --- | ---- | --------- | ---- | ------------- | | ---------- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| otherAgent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | otherAgent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -983,10 +983,10 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void; ...@@ -983,10 +983,10 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void;
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | --- | ---- | ------------------------ | ---- | --------------------------------------- | | ---------- | ------------------------ | ---- | --------------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<number> | 是 | 获取一个WantAgent的OperationType信息的回调方法。 | | callback | AsyncCallback\<number> | 是 | 获取一个WantAgent的OperationType信息的回调方法。 |
**示例：** **示例：**
...@@ -1048,9 +1048,9 @@ getOperationType(agent: WantAgent): Promise\<number>; ...@@ -1048,9 +1048,9 @@ getOperationType(agent: WantAgent): Promise\<number>;
**参数：** **参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | --- | ---- | --------- | ---- | ------------- | | ---------- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -1116,13 +1116,13 @@ try { ...@@ -1116,13 +1116,13 @@ try {
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| -------------- | --- | ---- | ------------------------------- | ---- | ---------------------- | | -------------- | ------------------------------- | ---- | ---------------------- |
| wants | 是 | 是 | Array\<Want\> | 是 | 将被执行的动作列表。 | | wants | Array\<Want\> | 是 | 将被执行的动作列表。 |
| operationType | 是 | 是 | wantAgent.OperationType | 是 | 动作类型。 | | operationType | wantAgent.OperationType | 是 | 动作类型。 |
| requestCode | 是 | 是 | number | 是 | 使用者定义的一个私有值。 | | requestCode | number | 是 | 使用者定义的一个私有值。 |
| wantAgentFlags | 是 | 是 | Array<wantAgent.WantAgentFlags> | 否 | 动作执行属性。 | | wantAgentFlags | Array<wantAgent.WantAgentFlags> | 否 | 动作执行属性。 |
| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 额外数据。 | | extraInfo | {[key: string]: any} | 否 | 额外数据。 |
...@@ -1132,16 +1132,16 @@ try { ...@@ -1132,16 +1132,16 @@ try {
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ------------------- | -------------- | ------------------------------------------------------------ | | ------------------- | -------------- | ------------------------------------------------------------ |
| ONE_TIME_FLAG | WantAgentFlags | WantAgent仅能使用一次。 | | ONE_TIME_FLAG | 0 | WantAgent仅能使用一次。 |
| NO_BUILD_FLAG | WantAgentFlags | 如果描述WantAgent对象不存在，则不创建它，直接返回null。 | | NO_BUILD_FLAG | 1 | 如果描述WantAgent对象不存在，则不创建它，直接返回null。 |
| CANCEL_PRESENT_FLAG | WantAgentFlags | 在生成一个新的WantAgent对象前取消已存在的一个WantAgent对象。 | | CANCEL_PRESENT_FLAG | 2 | 在生成一个新的WantAgent对象前取消已存在的一个WantAgent对象。 |
| UPDATE_PRESENT_FLAG | WantAgentFlags | 使用新的WantAgent的额外数据替换已存在的WantAgent中的额外数据。 | | UPDATE_PRESENT_FLAG | 3 | 使用新的WantAgent的额外数据替换已存在的WantAgent中的额外数据。 |
| CONSTANT_FLAG | WantAgentFlags | WantAgent是不可变的。 | | CONSTANT_FLAG | 4 | WantAgent是不可变的。 |
| REPLACE_ELEMENT | WantAgentFlags | 当前Want中的element属性可被WantAgent.trigger()中Want的element属性取代 | | REPLACE_ELEMENT | 5 | 当前Want中的element属性可被WantAgent.trigger()中Want的element属性取代 |
| REPLACE_ACTION | WantAgentFlags | 当前Want中的action属性可被WantAgent.trigger()中Want的action属性取代 | | REPLACE_ACTION | 6 | 当前Want中的action属性可被WantAgent.trigger()中Want的action属性取代 |
| REPLACE_URI | WantAgentFlags | 当前Want中的uri属性可被WantAgent.trigger()中Want的uri属性取代 | | REPLACE_URI | 7 | 当前Want中的uri属性可被WantAgent.trigger()中Want的uri属性取代 |
| REPLACE_ENTITIES | WantAgentFlags | 当前Want中的entities属性可被WantAgent.trigger()中Want的entities属性取代 | | REPLACE_ENTITIES | 8 | 当前Want中的entities属性可被WantAgent.trigger()中Want的entities属性取代 |
| REPLACE_BUNDLE | WantAgentFlags | 当前Want中的bundleName属性可被WantAgent.trigger()中Want的bundleName属性取代 | | REPLACE_BUNDLE | 9 | 当前Want中的bundleName属性可被WantAgent.trigger()中Want的bundleName属性取代 |
...@@ -1151,11 +1151,11 @@ try { ...@@ -1151,11 +1151,11 @@ try {
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------------- | ------------- | ------------------------- | | ----------------- | ------------- | ------------------------- |
| UNKNOWN_TYPE | OperationType | 不识别的类型。 | | UNKNOWN_TYPE | 0 | 不识别的类型。 |
| START_ABILITY | OperationType | 开启一个有页面的Ability。 | | START_ABILITY | 1 | 开启一个有页面的Ability。 |
| START_ABILITIES | OperationType | 开启多个有页面的Ability。 | | START_ABILITIES | 2 | 开启多个有页面的Ability。 |
| START_SERVICE | OperationType | 开启一个无页面的ability。 | | START_SERVICE | 3 | 开启一个无页面的ability。 |
| SEND_COMMON_EVENT | OperationType | 发送一个公共事件。 | | SEND_COMMON_EVENT | 4 | 发送一个公共事件。 |
...@@ -1163,13 +1163,13 @@ try { ...@@ -1163,13 +1163,13 @@ try {
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| -------------- | --- | ---- | ------------------------------ | ---- | ---------------------- | | -------------- | ------------------------------ | ---- | ---------------------- |
| info | 是 | 是 | WantAgent | 是 | 触发的wantAgent。 | | info | WantAgent | 是 | 触发的wantAgent。 |
| want | 是 | 是 | Want | 是 | 存在的被触发的want。 | | want | Want | 是 | 存在的被触发的want。 |
| finalCode | 是 | 是 | number | 是 | 触发wantAgent的请求代码。| | finalCode | number | 是 | 触发wantAgent的请求代码。|
| finalData | 是 | 是 | string | 否 | 公共事件收集的最终数据。 | | finalData | string | 否 | 公共事件收集的最终数据。 |
| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 额外数据。 | | extraInfo | {[key: string]: any} | 否 | 额外数据。 |
...@@ -1177,9 +1177,9 @@ try { ...@@ -1177,9 +1177,9 @@ try {
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| ---------- | --- | ---- | -------------------- | ---- | ----------- | | ---------- | -------------------- | ---- | ----------- |
| code | 是 | 是 | number | 是 | result code。 | | code | number | 是 | result code。 |
| want | 是 | 是 | Want | 否 | Want。 | | want | Want | 否 | Want。 |
| permission | 是 | 是 | string | 否 | 权限定义。 | | permission | string | 否 | 权限定义。 |
| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 额外数据。 | | extraInfo | {[key: string]: any} | 否 | 额外数据。 |
\ No newline at end of file \ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-ability-wantConstant.md
浏览文件 @ ce06dbac
...@@ -33,8 +33,8 @@ want操作的常数。 ...@@ -33,8 +33,8 @@ want操作的常数。
| ACTION_DISMISS_TIMER | ohos.want.action.dismissTimer | 指示启动页面功能以关闭计时器的操作。 | | ACTION_DISMISS_TIMER | ohos.want.action.dismissTimer | 指示启动页面功能以关闭计时器的操作。 |
| ACTION_SEND_SMS | ohos.want.action.sendSms | 指示启动发送sms的页面功能的操作。 | | ACTION_SEND_SMS | ohos.want.action.sendSms | 指示启动发送sms的页面功能的操作。 |
| ACTION_CHOOSE | ohos.want.action.choose | 指示启动页面功能以打开联系人或图片的操作。 | | ACTION_CHOOSE | ohos.want.action.choose | 指示启动页面功能以打开联系人或图片的操作。 |
| ACTION_IMAGE_CAPTURE<sup>8+</sup> | ohos.want.action.imageCapture | 指示启动页面拍照功能的操作。 | | ACTION_IMAGE_CAPTURE | ohos.want.action.imageCapture | 指示启动页面拍照功能的操作。 |
| ACTION_VIDEO_CAPTURE<sup>8+</sup> | ohos.want.action.videoCapture | 指示启动页面功能以拍摄视频的操作。 | | ACTION_VIDEO_CAPTURE | ohos.want.action.videoCapture | 指示启动页面功能以拍摄视频的操作。 |
| ACTION_SELECT | ohos.want.action.select | 指示显示应用程序选择对话框的操作。 | | ACTION_SELECT | ohos.want.action.select | 指示显示应用程序选择对话框的操作。 |
| ACTION_SEND_DATA | ohos.want.action.sendData | 指示发送单个数据记录的操作。 | | ACTION_SEND_DATA | ohos.want.action.sendData | 指示发送单个数据记录的操作。 |
| ACTION_SEND_MULTIPLE_DATA | ohos.want.action.sendMultipleData | 指示发送多个数据记录的操作。 | | ACTION_SEND_MULTIPLE_DATA | ohos.want.action.sendMultipleData | 指示发送多个数据记录的操作。 |
...@@ -43,17 +43,16 @@ want操作的常数。 ...@@ -43,17 +43,16 @@ want操作的常数。
| ACTION_EDIT_DATA | ohos.want.action.editData | 指示编辑数据的操作。 | | ACTION_EDIT_DATA | ohos.want.action.editData | 指示编辑数据的操作。 |
| INTENT_PARAMS_INTENT | ability.want.params.INTENT | 指示用行为选择器来展示选择的操作。 | | INTENT_PARAMS_INTENT | ability.want.params.INTENT | 指示用行为选择器来展示选择的操作。 |
| INTENT_PARAMS_TITLE | ability.want.params.TITLE | 指示与行为选择器一起使用时的字符序列对话框标题。 | | INTENT_PARAMS_TITLE | ability.want.params.TITLE | 指示与行为选择器一起使用时的字符序列对话框标题。 |
| ACTION_FILE_SELECT<sup>7+</sup> | ohos.action.fileSelect | 指示选择文件的操作。 | | ACTION_FILE_SELECT | ohos.action.fileSelect | 指示选择文件的操作。 |
| PARAMS_STREAM<sup>7+</sup> | ability.params.stream | 指示发送数据时与目标关联的数据流的URI | | PARAMS_STREAM | ability.params.stream | 指示发送数据时与目标关联的数据流的URI | |
| ACTION_APP_ACCOUNT_OAUTH <sup>8+</sup> | ohos.account.appAccount.action.oauth | 指示提供oauth服务的操作。 | | ACTION_APP_ACCOUNT_AUTH | account.appAccount.action.auth | 指示提供auth服务的操作。 |
| ACTION_APP_ACCOUNT_AUTH <sup>9+</sup> | account.appAccount.action.auth | 指示提供auth服务的操作。 | | ACTION_MARKET_DOWNLOAD | ohos.want.action.marketDownload | 表示从应用程序市场下载应用程序的的操作。<br>**系统API**：该接口为系统接口，三方应用不支持调用。 |
| ACTION_MARKET_DOWNLOAD <sup>9+</sup> | ohos.want.action.marketDownload | 表示从应用程序市场下载应用程序的的操作。<br>**系统API**：该接口为系统接口，三方应用不支持调用。 | | ACTION_MARKET_CROWDTEST | ohos.want.action.marketCrowdTest | 指示从应用程序市场众测应用程序的操作。<br>**系统API**：该接口为系统接口，三方应用不支持调用。 |
| ACTION_MARKET_CROWDTEST <sup>9+</sup> | ohos.want.action.marketCrowdTest | 指示从应用程序市场众测应用程序的操作。<br>**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_SANDBOX |ohos.dlp.params.sandbox | 指示沙盒标志的参数的操作。<br>**系统API**：该接口为系统接口，三方应用不支持调用。 |
| DLP_PARAMS_SANDBOX<sup>9+</sup> |ohos.dlp.params.sandbox | 指示沙盒标志的参数的操作。<br>**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_BUNDLE_NAME |ohos.dlp.params.bundleName |指示DLP包名称的参数的操作。 <br>**系统API**：该接口为系统接口，三方应用不支持调用。 |
| DLP_PARAMS_BUNDLE_NAME<sup>9+</sup> |ohos.dlp.params.bundleName |指示DLP包名称的参数的操作。 <br>**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_MODULE_NAME |ohos.dlp.params.moduleName |指示DLP模块名称的参数的操作。 <br>**系统API**：该接口为系统接口，三方应用不支持调用。 |
| DLP_PARAMS_MODULE_NAME<sup>9+</sup> |ohos.dlp.params.moduleName |指示DLP模块名称的参数的操作。 <br>**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_ABILITY_NAME |ohos.dlp.params.abilityName |指示DLP能力名称的参数的操作。 <br>**系统API**：该接口为系统接口，三方应用不支持调用。 |
| DLP_PARAMS_ABILITY_NAME<sup>9+</sup> |ohos.dlp.params.abilityName |指示DLP能力名称的参数的操作。 <br>**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_INDEX |ohos.dlp.params.index |指示DLP索引参数的操作。 <br>**系统API**：该接口为系统接口，三方应用不支持调用。 |
| DLP_PARAMS_INDEX<sup>9+</sup> |ohos.dlp.params.index |指示DLP索引参数的操作。 <br>**系统API**：该接口为系统接口，三方应用不支持调用。 |
## wantConstant.Entity ## wantConstant.Entity
......
zh-cn/application-dev/reference/apis/js-apis-app-form-formbindingdata.md
浏览文件 @ ce06dbac
...@@ -18,9 +18,9 @@ FormBindingData相关描述。 ...@@ -18,9 +18,9 @@ FormBindingData相关描述。
**系统能力**：SystemCapability.Ability.Form **系统能力**：SystemCapability.Ability.Form
| 名称 | 可读 | 可写 | 参数类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| data | 是 | 否 | Object | 是 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。| | data | Object | 是 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。|
## createFormBindingData ## createFormBindingData
...@@ -35,7 +35,7 @@ createFormBindingData(obj?: Object | string): FormBindingData ...@@ -35,7 +35,7 @@ createFormBindingData(obj?: Object | string): FormBindingData
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------- | ---- | ------------------------------------------------------------ | | ------ | -------------- | ---- | ------------------------------------------------------------ |
| obj | Object或string | 否 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。其中图片数据以"formImages"作为标识，内容为图片标识与图片文件描述符的键值对{"formImages": {"key1": fd1, "key2": fd2}} | | obj | Object\|string | 否 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。其中图片数据以"formImages"作为标识，内容为图片标识与图片文件描述符的键值对{"formImages": {"key1": fd1, "key2": fd2}} |
**返回值：** **返回值：**
......
zh-cn/application-dev/reference/apis/js-apis-app-form-formextensionability.md
浏览文件 @ ce06dbac
...@@ -17,7 +17,7 @@ import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility'; ...@@ -17,7 +17,7 @@ import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
**系统能力**：SystemCapability.Ability.Form **系统能力**：SystemCapability.Ability.Form
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ------- | ------------------------------------------------------- | ---- | ---- | --------------------------------------------------- | | ------- | ------------------------------------------------------- | ---- | ---- | --------------------------------------------------- |
| context | [FormExtensionContext](js-apis-inner-application-formExtensionContext.md) | 是 | 否 | FormExtensionAbility的上下文环境，继承自ExtensionContext。 | | context | [FormExtensionContext](js-apis-inner-application-formExtensionContext.md) | 是 | 否 | FormExtensionAbility的上下文环境，继承自ExtensionContext。 |
...@@ -197,7 +197,7 @@ export default class MyFormExtensionAbility extends FormExtensionAbility { ...@@ -197,7 +197,7 @@ export default class MyFormExtensionAbility extends FormExtensionAbility {
## onConfigurationUpdate ## onConfigurationUpdate
onConfigurationUpdate(config: Configuration): void; onConfigurationUpdate(newConfig: Configuration): void;
当系统配置更新时调用。 当系统配置更新时调用。
...@@ -207,7 +207,7 @@ onConfigurationUpdate(config: Configuration): void; ...@@ -207,7 +207,7 @@ onConfigurationUpdate(config: Configuration): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| config | [Configuration](js-apis-configuration.md) | 是 | 表示需要更新的配置信息。 | | newConfig | [Configuration](js-apis-configuration.md) | 是 | 表示需要更新的配置信息。 |
**示例：** **示例：**
...@@ -231,7 +231,7 @@ onAcquireFormState?(want: Want): formInfo.FormState; ...@@ -231,7 +231,7 @@ onAcquireFormState?(want: Want): formInfo.FormState;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 否 | want表示获取卡片状态的描述。描述包括包名称、能力名称、模块名称、卡片名和卡片维度。 | | want | [Want](js-apis-application-want.md) | 是 | want表示获取卡片状态的描述。描述包括包名称、能力名称、模块名称、卡片名和卡片维度。 |
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-app-form-formhost.md
浏览文件 @ ce06dbac
...@@ -32,11 +32,10 @@ deleteForm(formId: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -32,11 +32,10 @@ deleteForm(formId: string, callback: AsyncCallback&lt;void&gt;): void
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501001 | The ID of the form to be operated does not exist. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -81,11 +80,10 @@ deleteForm(formId: string): Promise&lt;void&gt; ...@@ -81,11 +80,10 @@ deleteForm(formId: string): Promise&lt;void&gt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501001 | The ID of the form to be operated does not exist. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**参数：** **参数：**
...@@ -121,11 +119,10 @@ releaseForm(formId: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -121,11 +119,10 @@ releaseForm(formId: string, callback: AsyncCallback&lt;void&gt;): void
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501001 | The ID of the form to be operated does not exist. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -162,11 +159,10 @@ releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback&lt; ...@@ -162,11 +159,10 @@ releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback&lt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501001 | The ID of the form to be operated does not exist. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -208,11 +204,10 @@ releaseForm(formId: string, isReleaseCache?: boolean): Promise&lt;void&gt; ...@@ -208,11 +204,10 @@ releaseForm(formId: string, isReleaseCache?: boolean): Promise&lt;void&gt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501001 | The ID of the form to be operated does not exist. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -248,11 +243,10 @@ requestForm(formId: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -248,11 +243,10 @@ requestForm(formId: string, callback: AsyncCallback&lt;void&gt;): void
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501001 | The ID of the form to be operated does not exist. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -293,11 +287,10 @@ requestForm(formId: string): Promise&lt;void&gt; ...@@ -293,11 +287,10 @@ requestForm(formId: string): Promise&lt;void&gt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501001 | The ID of the form to be operated does not exist. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -315,9 +308,9 @@ try { ...@@ -315,9 +308,9 @@ try {
``` ```
## castTempForm ## castToNormalForm
castTempForm(formId: string, callback: AsyncCallback&lt;void&gt;): void castToNormalForm(formId: string, callback: AsyncCallback&lt;void&gt;): void
将指定的临时卡片转换为普通卡片。使用callback异步回调。 将指定的临时卡片转换为普通卡片。使用callback异步回调。
...@@ -334,18 +327,17 @@ castTempForm(formId: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -334,18 +327,17 @@ castTempForm(formId: string, callback: AsyncCallback&lt;void&gt;): void
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501001 | The ID of the form to be operated does not exist. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
```ts ```ts
try { try {
var formId = "12400633174999288"; var formId = "12400633174999288";
formHost.castTempForm(formId, (error, data) => { formHost.castToNormalForm(formId, (error, data) => {
if (error) { if (error) {
console.log('formHost castTempForm, error:' + JSON.stringify(error)); console.log('formHost castTempForm, error:' + JSON.stringify(error));
} }
...@@ -355,9 +347,9 @@ try { ...@@ -355,9 +347,9 @@ try {
} }
``` ```
## castTempForm ## castToNormalForm
castTempForm(formId: string): Promise&lt;void&gt; castToNormalForm(formId: string): Promise&lt;void&gt;
将指定的临时卡片转换为普通卡片。使用Promise异步回调。 将指定的临时卡片转换为普通卡片。使用Promise异步回调。
...@@ -379,18 +371,17 @@ castTempForm(formId: string): Promise&lt;void&gt; ...@@ -379,18 +371,17 @@ castTempForm(formId: string): Promise&lt;void&gt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501001 | The ID of the form to be operated does not exist. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
```ts ```ts
try { try {
var formId = "12400633174999288"; var formId = "12400633174999288";
formHost.castTempForm(formId).then(() => { formHost.castToNormalForm(formId).then(() => {
console.log('formHost castTempForm success'); console.log('formHost castTempForm success');
}).catch((error) => { }).catch((error) => {
console.log('formHost castTempForm, error:' + JSON.stringify(error)); console.log('formHost castTempForm, error:' + JSON.stringify(error));
...@@ -419,10 +410,10 @@ notifyVisibleForms(formIds: Array&lt;string&gt;, callback: AsyncCallback&lt;void ...@@ -419,10 +410,10 @@ notifyVisibleForms(formIds: Array&lt;string&gt;, callback: AsyncCallback&lt;void
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -463,10 +454,10 @@ notifyVisibleForms(formIds: Array&lt;string&gt;): Promise&lt;void&gt; ...@@ -463,10 +454,10 @@ notifyVisibleForms(formIds: Array&lt;string&gt;): Promise&lt;void&gt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -502,10 +493,10 @@ notifyInvisibleForms(formIds: Array&lt;string&gt;, callback: AsyncCallback&lt;vo ...@@ -502,10 +493,10 @@ notifyInvisibleForms(formIds: Array&lt;string&gt;, callback: AsyncCallback&lt;vo
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -546,10 +537,10 @@ notifyInvisibleForms(formIds: Array&lt;string&gt;): Promise&lt;void&gt; ...@@ -546,10 +537,10 @@ notifyInvisibleForms(formIds: Array&lt;string&gt;): Promise&lt;void&gt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -585,11 +576,10 @@ enableFormsUpdate(formIds: Array&lt;string&gt;, callback: AsyncCallback&lt;void& ...@@ -585,11 +576,10 @@ enableFormsUpdate(formIds: Array&lt;string&gt;, callback: AsyncCallback&lt;void&
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -630,11 +620,10 @@ enableFormsUpdate(formIds: Array&lt;string&gt;): Promise&lt;void&gt; ...@@ -630,11 +620,10 @@ enableFormsUpdate(formIds: Array&lt;string&gt;): Promise&lt;void&gt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -670,11 +659,10 @@ disableFormsUpdate(formIds: Array&lt;string&gt;, callback: AsyncCallback&lt;void ...@@ -670,11 +659,10 @@ disableFormsUpdate(formIds: Array&lt;string&gt;, callback: AsyncCallback&lt;void
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -715,11 +703,10 @@ disableFormsUpdate(formIds: Array&lt;string&gt;): Promise&lt;void&gt; ...@@ -715,11 +703,10 @@ disableFormsUpdate(formIds: Array&lt;string&gt;): Promise&lt;void&gt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
| 16501003 | The form can not be operated by the current application. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -875,10 +862,10 @@ getFormsInfo(bundleName: string, callback: AsyncCallback&lt;Array&lt;formInfo.Fo ...@@ -875,10 +862,10 @@ getFormsInfo(bundleName: string, callback: AsyncCallback&lt;Array&lt;formInfo.Fo
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16500100 | Failed to obtain configuration information. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -916,10 +903,10 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback&lt; ...@@ -916,10 +903,10 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback&lt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16500100 | Failed to obtain configuration information. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -962,10 +949,10 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise&lt;Array&lt;formI ...@@ -962,10 +949,10 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise&lt;Array&lt;formI
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16500100 | Failed to obtain configuration information. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -1071,10 +1058,10 @@ acquireFormState(want: Want, callback: AsyncCallback&lt;formInfo.FormStateInfo&g ...@@ -1071,10 +1058,10 @@ acquireFormState(want: Want, callback: AsyncCallback&lt;formInfo.FormStateInfo&g
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -1126,10 +1113,10 @@ acquireFormState(want: Want): Promise&lt;formInfo.FormStateInfo&gt; ...@@ -1126,10 +1113,10 @@ acquireFormState(want: Want): Promise&lt;formInfo.FormStateInfo&gt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -1223,10 +1210,10 @@ notifyFormsVisible(formIds: Array&lt;string&gt;, isVisible: boolean, callback: A ...@@ -1223,10 +1210,10 @@ notifyFormsVisible(formIds: Array&lt;string&gt;, isVisible: boolean, callback: A
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501003 | The form can not be operated by the current application. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -1268,10 +1255,10 @@ notifyFormsVisible(formIds: Array&lt;string&gt;, isVisible: boolean): Promise&lt ...@@ -1268,10 +1255,10 @@ notifyFormsVisible(formIds: Array&lt;string&gt;, isVisible: boolean): Promise&lt
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501003 | The form can not be operated by the current application. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -1308,10 +1295,10 @@ notifyFormsEnableUpdate(formIds: Array&lt;string&gt;, isEnableUpdate: boolean, c ...@@ -1308,10 +1295,10 @@ notifyFormsEnableUpdate(formIds: Array&lt;string&gt;, isEnableUpdate: boolean, c
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501003 | The form can not be operated by the current application. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -1353,10 +1340,10 @@ notifyFormsEnableUpdate(formIds: Array&lt;string&gt;, isEnableUpdate: boolean): ...@@ -1353,10 +1340,10 @@ notifyFormsEnableUpdate(formIds: Array&lt;string&gt;, isEnableUpdate: boolean):
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501003 | The form can not be operated by the current application. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -1378,7 +1365,7 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback&lt;void&gt;) ...@@ -1378,7 +1365,7 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback&lt;void&gt;)
指定formId和远程设备Id进行卡片分享。使用callback异步回调。 指定formId和远程设备Id进行卡片分享。使用callback异步回调。
**需要权限**：ohos.permission.REQUIRE_FORM **需要权限**：ohos.permission.REQUIRE_FORM 和 ohos.permission.DISTRIBUTED_DATASYNC
**系统能力**：SystemCapability.Ability.Form **系统能力**：SystemCapability.Ability.Form
...@@ -1392,11 +1379,10 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback&lt;void&gt;) ...@@ -1392,11 +1379,10 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback&lt;void&gt;)
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16500100 | Failed to obtain configuration information. | | 401 | If the input parameter is not valid parameter. |
| 16501000 | A functional error occurred. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -1421,7 +1407,7 @@ shareForm(formId: string, deviceId: string): Promise&lt;void&gt; ...@@ -1421,7 +1407,7 @@ shareForm(formId: string, deviceId: string): Promise&lt;void&gt;
指定formId和远程设备Id进行卡片分享。使用Promise异步回调。 指定formId和远程设备Id进行卡片分享。使用Promise异步回调。
**需要权限**：ohos.permission.REQUIRE_FORM **需要权限**：ohos.permission.REQUIRE_FORM 和 ohos.permission.DISTRIBUTED_DATASYNC
**系统能力**：SystemCapability.Ability.Form **系统能力**：SystemCapability.Ability.Form
...@@ -1440,11 +1426,10 @@ shareForm(formId: string, deviceId: string): Promise&lt;void&gt; ...@@ -1440,11 +1426,10 @@ shareForm(formId: string, deviceId: string): Promise&lt;void&gt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16500100 | Failed to obtain configuration information. | | 401 | If the input parameter is not valid parameter. |
| 16501000 | A functional error occurred. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**参数：** **参数：**
...@@ -1464,7 +1449,7 @@ try { ...@@ -1464,7 +1449,7 @@ try {
## notifyFormsPrivacyProtected ## notifyFormsPrivacyProtected
notifyFormsPrivacyProtected(formIds: Array<string>, isProtected: boolean, callback: AsyncCallback<void>): void notifyFormsPrivacyProtected(formIds: Array\<string>, isProtected: boolean, callback: AsyncCallback\<void>): void
**需要权限**：ohos.permission.REQUIRE_FORM **需要权限**：ohos.permission.REQUIRE_FORM
......
zh-cn/application-dev/reference/apis/js-apis-app-form-forminfo.md
浏览文件 @ ce06dbac
...@@ -18,26 +18,26 @@ import formInfo from '@ohos.app.form.formInfo'; ...@@ -18,26 +18,26 @@ import formInfo from '@ohos.app.form.formInfo';
**系统能力**：SystemCapability.Ability.Form **系统能力**：SystemCapability.Ability.Form
| 名称 | 可读 | 可写 | 类型 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------ | | ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------ |
| bundleName | 是 | 否 | string | 卡片所属包的包名。 | | bundleName | string | 是 | 否 | 卡片所属包的包名。 |
| moduleName | 是 | 否 | string | 卡片所属模块的模块名。 | | moduleName | string | 是 | 否 | 卡片所属模块的模块名。 |
| abilityName | 是 | 否 | string | 卡片所属的Ability名称。 | | abilityName | string | 是 | 否 | 卡片所属的Ability名称。 |
| name | 是 | 否 | string | 卡片名称。 | | name | string | 是 | 否 | 卡片名称。 |
| description | 是 | 否 | string | 卡片描述。 | | description | string | 是 | 否 | 卡片描述。 |
| type | 是 | 否 | [FormType](#formtype) | 卡片类型。当前支持JS卡片。 | | type | [FormType](#formtype) | 是 | 否 | 卡片类型。当前支持JS卡片。 |
| jsComponentName | 是 | 否 | string | js卡片的组件名。 | | jsComponentName | string | 是 | 否 | js卡片的组件名。 |
| colorMode | 是 | 否 | [ColorMode](#colormode) | 卡片颜色模式。 | | colorMode | [ColorMode](#colormode) | 是 | 否 | 卡片颜色模式。 |
| isDefault | 是 | 否 | boolean | 卡片是否是默认卡片。 | | isDefault | boolean | 是 | 否 | 卡片是否是默认卡片。 |
| updateEnabled | 是 | 否 | boolean | 卡片是否使能更新。 | | updateEnabled | boolean | 是 | 否 | 卡片是否使能更新。 |
| formVisibleNotify | 是 | 否 | string | 卡片是否使能可见通知。 | | formVisibleNotify | string | 是 | 否 | 卡片是否使能可见通知。 |
| relatedBundleName | 是 | 否 | string | 卡片所属的相关联包名。 | | relatedBundleName | string | 是 | 否 | 卡片所属的相关联包名。 |
| scheduledUpdateTime | 是 | 否 | string | 卡片更新时间。 | | scheduledUpdateTime | string | 是 | 否 | 卡片更新时间。 |
| formConfigAbility | 是 | 否 | string | 卡片配置ability。指定长按卡片弹出的选择框内，编辑选项所对应的ability。 | | formConfigAbility | string | 是 | 否 | 卡片配置ability。指定长按卡片弹出的选择框内，编辑选项所对应的ability。 |
| updateDuration | 是 | 否 | string | 卡片更新周期。 | | updateDuration | string | 是 | 否 | 卡片更新周期。 |
| defaultDimension | 是 | 否 | number | 表示卡片规格 | | defaultDimension | number | 是 | 否 | 表示卡片规格 |
| supportDimensions | 是 | 否 | Array&lt;number&gt; | 卡片支持的规格。具体可选规格参考[FormDimension](#formdimension) | | supportDimensions | Array&lt;number&gt; | 是 | 否 | 卡片支持的规格。具体可选规格参考[FormDimension](#formdimension) |
| customizeData | 是 | 否 | {[key: string]: [value: string]} | 卡片用户数据。 | | customizeData | {[key: string]: [value: string]} | 是 | 否 | 卡片用户数据。 |
## FormType ## FormType
...@@ -68,10 +68,10 @@ import formInfo from '@ohos.app.form.formInfo'; ...@@ -68,10 +68,10 @@ import formInfo from '@ohos.app.form.formInfo';
**系统能力**：SystemCapability.Ability.Form **系统能力**：SystemCapability.Ability.Form
| 名称 | 可读 | 可写 | 类型 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------ | | ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------ |
| formState | 是 | 否 | [FormState](#formstate) | 卡片状态。 | | formState | [FormState](#formstate) | 是 | 否 | 卡片状态。 |
| want | 是 | 否 | Want | Want文本内容。 | | want | Want | 是 | 否 | Want文本内容。 |
## FormState ## FormState
...@@ -93,7 +93,7 @@ import formInfo from '@ohos.app.form.formInfo'; ...@@ -93,7 +93,7 @@ import formInfo from '@ohos.app.form.formInfo';
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------- | ---- | ------------ | | ----------- | ---- | ------------ |
| IDENTITY_KEY | "ohos.extra.param.key.form_identity" | 卡片标识。<br>**系统接口**: 此接口为系统接口。 | | IDENTITY_KEY | "ohos.extra.param.key.form_identity" | 卡片标识。 |
| DIMENSION_KEY | "ohos.extra.param.key.form_dimension" | 卡片规格样式。 | | DIMENSION_KEY | "ohos.extra.param.key.form_dimension" | 卡片规格样式。 |
| NAME_KEY | "ohos.extra.param.key.form_name" | 卡片名称。 | | NAME_KEY | "ohos.extra.param.key.form_name" | 卡片名称。 |
| MODULE_NAME_KEY | "ohos.extra.param.key.module_name" | 卡片所属模块名称。 | | MODULE_NAME_KEY | "ohos.extra.param.key.module_name" | 卡片所属模块名称。 |
...@@ -125,9 +125,9 @@ import formInfo from '@ohos.app.form.formInfo'; ...@@ -125,9 +125,9 @@ import formInfo from '@ohos.app.form.formInfo';
**系统能力**：SystemCapability.Ability.Form **系统能力**：SystemCapability.Ability.Form
| 名称 | 必选 | 说明 | | 名称 | 说明 |
| ----------- | ---- | ------------ | | ----------- | ------------ |
| moduleName | 否 | 仅保留moduleName与提供值相符的卡片信息。 | | moduleName | 仅保留moduleName与提供值相符的卡片信息。 |
## VisibilityType ## VisibilityType
...@@ -137,5 +137,5 @@ import formInfo from '@ohos.app.form.formInfo'; ...@@ -137,5 +137,5 @@ import formInfo from '@ohos.app.form.formInfo';
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------- | ---- | ------------ | | ----------- | ---- | ------------ |
| FORM_VISIBLE | 否 | 表示卡片为可见。 | | FORM_VISIBLE | 1 | 表示卡片为可见。 |
| FORM_INVISIBLE | 否 | 表示卡片为不可见。 | | FORM_INVISIBLE | 2 | 表示卡片为不可见。 |
\ No newline at end of file \ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-form-formprovider.md
浏览文件 @ ce06dbac
...@@ -27,13 +27,12 @@ setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback&l ...@@ -27,13 +27,12 @@ setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback&l
| minute | number | 是 | 指定多久之后更新，单位分钟，大于等于5。 | | minute | number | 是 | 指定多久之后更新，单位分钟，大于等于5。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。 **错误码：**
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16500100 | Failed to obtain configuration information. | | 401 | If the input parameter is not valid parameter. |
| 16501001 | The ID of the form to be operated does not exist. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 16501002 | The number of forms exceeds the upper bound. |
| 16501003 | The form can not be operated by the current application. |
**示例：** **示例：**
...@@ -75,13 +74,10 @@ setFormNextRefreshTime(formId: string, minute: number): Promise&lt;void&gt; ...@@ -75,13 +74,10 @@ setFormNextRefreshTime(formId: string, minute: number): Promise&lt;void&gt;
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16500100 | Failed to obtain configuration information. | | 401 | If the input parameter is not valid parameter. |
| 16501001 | The ID of the form to be operated does not exist. | 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 16501002 | The number of forms exceeds the upper bound. |
| 16501003 | The form can not be operated by the current application. |
**示例：** **示例：**
...@@ -111,15 +107,15 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call ...@@ -111,15 +107,15 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- | | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| formId | string | 是 | 请求更新的卡片标识。 | | formId | string | 是 | 请求更新的卡片标识。 |
| formBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 | | formBindingData.FormBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501001 | The ID of the form to be operated does not exist. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -153,7 +149,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr ...@@ -153,7 +149,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- | | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| formId | string | 是 | 请求更新的卡片标识。 | | formId | string | 是 | 请求更新的卡片标识。 |
| formBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 | | formBindingData.FormBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 |
**返回值：** **返回值：**
...@@ -163,10 +159,10 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr ...@@ -163,10 +159,10 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501001 | The ID of the form to be operated does not exist. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -201,10 +197,10 @@ getFormsInfo(callback: AsyncCallback&lt;Array&lt;formInfo.FormInfo&gt;&gt;): voi ...@@ -201,10 +197,10 @@ getFormsInfo(callback: AsyncCallback&lt;Array&lt;formInfo.FormInfo&gt;&gt;): voi
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16500100 | Failed to obtain configuration information. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -239,10 +235,10 @@ getFormsInfo(filter: formInfo.FormInfoFilter, callback: AsyncCallback&lt;Array&l ...@@ -239,10 +235,10 @@ getFormsInfo(filter: formInfo.FormInfoFilter, callback: AsyncCallback&lt;Array&l
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16500100 | Failed to obtain configuration information. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -287,10 +283,10 @@ getFormsInfo(filter?: formInfo.FormInfoFilter): Promise&lt;Array&lt;formInfo.For ...@@ -287,10 +283,10 @@ getFormsInfo(filter?: formInfo.FormInfoFilter): Promise&lt;Array&lt;formInfo.For
**错误码：** **错误码：**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16500100 | Failed to obtain configuration information. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -326,13 +322,15 @@ requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, ...@@ -326,13 +322,15 @@ requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData,
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- | | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" | | want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
| formBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 是 | 创建卡片的数据。 | | formBindingData.FormBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 是 | 创建卡片的数据。 |
| callback | AsyncCallback&lt;string&gt; | 是 | 回调函数。返回卡片标识。 | | callback | AsyncCallback&lt;string&gt; | 是 | 回调函数。返回卡片标识。 |
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。 **错误码：**
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -377,10 +375,12 @@ requestPublishForm(want: Want, callback: AsyncCallback&lt;string&gt;): void ...@@ -377,10 +375,12 @@ requestPublishForm(want: Want, callback: AsyncCallback&lt;string&gt;): void
| want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" | | want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
| callback | AsyncCallback&lt;string&gt; | 是 | 回调函数。返回卡片标识。 | | callback | AsyncCallback&lt;string&gt; | 是 | 回调函数。返回卡片标识。 |
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。 **错误码：**
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
...@@ -422,7 +422,7 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData ...@@ -422,7 +422,7 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" | | want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
| formBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 否 | 创建卡片的数据。 | | formBindingData.FormBindingData | [FormBindingData](js-apis-app-form-formbindingdata.md#formbindingdata) | 否 | 创建卡片的数据。 |
**返回值：** **返回值：**
...@@ -430,10 +430,12 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData ...@@ -430,10 +430,12 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData
| :------------ | :---------------------------------- | | :------------ | :---------------------------------- |
| Promise&lt;string&gt; | Promise对象。返回卡片标识。 | | Promise&lt;string&gt; | Promise对象。返回卡片标识。 |
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。 **错误码：**
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | -------- | | -------- | -------- |
| 16501000 | A functional error occurred. | | 401 | If the input parameter is not valid parameter. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-application-ability.md
浏览文件 @ ce06dbac
...@@ -22,7 +22,7 @@ import Ability from '@ohos.application.Ability'; ...@@ -22,7 +22,7 @@ import Ability from '@ohos.application.Ability';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.AbilityCore **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.AbilityCore
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| context | [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md) | 是 | 否 | 上下文。 | | context | [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md) | 是 | 否 | 上下文。 |
| launchWant | [Want](js-apis-app-ability-want.md) | 是 | 否 | Ability启动时的参数。 | | launchWant | [Want](js-apis-app-ability-want.md) | 是 | 否 | Ability启动时的参数。 |
...@@ -341,7 +341,7 @@ call(method: string, data: rpc.Sequenceable): Promise&lt;void&gt;; ...@@ -341,7 +341,7 @@ call(method: string, data: rpc.Sequenceable): Promise&lt;void&gt;;
**示例：** **示例：**
```ts ```ts
import Ability from '@ohos.app.ability.UIAbility'; import Ability from '@ohos.application.Ability';
class MyMessageAble{ // 自定义的Sequenceable数据结构 class MyMessageAble{ // 自定义的Sequenceable数据结构
name:"" name:""
str:"" str:""
...@@ -425,7 +425,7 @@ callWithResult(method: string, data: rpc.Sequenceable): Promise&lt;rpc.MessagePa ...@@ -425,7 +425,7 @@ callWithResult(method: string, data: rpc.Sequenceable): Promise&lt;rpc.MessagePa
**示例：** **示例：**
```ts ```ts
import Ability from '@ohos.app.ability.UIAbility'; import Ability from '@ohos.application.Ability';
class MyMessageAble{ class MyMessageAble{
name:"" name:""
str:"" str:""
...@@ -497,7 +497,7 @@ release(): void; ...@@ -497,7 +497,7 @@ release(): void;
**示例：** **示例：**
```ts ```ts
import Ability from '@ohos.app.ability.UIAbility'; import Ability from '@ohos.application.Ability';
var caller; var caller;
export default class MainAbility extends Ability { export default class MainAbility extends Ability {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
...@@ -521,10 +521,9 @@ release(): void; ...@@ -521,10 +521,9 @@ release(): void;
} }
``` ```
## Caller.onRelease
## Caller.on onRelease(callback: OnReleaseCallBack): void;
on(type: "release", callback: OnReleaseCallback): void;
注册通用组件服务端Stub（桩）断开监听通知。 注册通用组件服务端Stub（桩）断开监听通知。
...@@ -534,21 +533,12 @@ release(): void; ...@@ -534,21 +533,12 @@ release(): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | 是 | 监听releaseCall事件，固定为'release'。 |
| callback | OnReleaseCallBack | 是 | 返回onRelease回调结果。 | | callback | OnReleaseCallBack | 是 | 返回onRelease回调结果。 |
**错误码：**
| 错误码ID | 错误信息 |
| ------- | -------------------------------- |
| 401 | Invalid input parameter. |
| 16200001 | Caller released. The caller has been released. |
| 16000050 | Internal Error. |
**示例：** **示例：**
```ts ```ts
import Ability from '@ohos.app.ability.UIAbility'; import Ability from '@ohos.application.Ability';
var caller; var caller;
export default class MainAbility extends Ability { export default class MainAbility extends Ability {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
...@@ -559,7 +549,7 @@ release(): void; ...@@ -559,7 +549,7 @@ release(): void;
}).then((obj) => { }).then((obj) => {
caller = obj; caller = obj;
try { try {
caller.on("release", (str) => { caller.onRelease((str) => {
console.log(' Caller OnRelease CallBack is called ' + str); console.log(' Caller OnRelease CallBack is called ' + str);
}); });
} catch (error) { } catch (error) {
...@@ -605,7 +595,7 @@ on(method: string, callback: CalleeCallBack): void; ...@@ -605,7 +595,7 @@ on(method: string, callback: CalleeCallBack): void;
**示例：** **示例：**
```ts ```ts
import Ability from '@ohos.app.ability.UIAbility'; import Ability from '@ohos.application.Ability';
class MyMessageAble{ class MyMessageAble{
name:"" name:""
str:"" str:""
...@@ -673,7 +663,7 @@ off(method: string): void; ...@@ -673,7 +663,7 @@ off(method: string): void;
**示例：** **示例：**
```ts ```ts
import Ability from '@ohos.app.ability.UIAbility'; import Ability from '@ohos.application.Ability';
var method = 'call_Function'; var method = 'call_Function';
export default class MainAbility extends Ability { export default class MainAbility extends Ability {
onCreate(want, launchParam) { onCreate(want, launchParam) {
...@@ -687,23 +677,23 @@ off(method: string): void; ...@@ -687,23 +677,23 @@ off(method: string): void;
} }
} }
``` ```
## OnReleaseCallback ## OnReleaseCallBack
(msg: string): void; (msg: string): void;
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| (msg: string) | function | 是 | 否 | 调用者注册的侦听器函数接口的原型。 | | (msg: string) | function | 是 | 否 | 调用者注册的侦听器函数接口的原型。 |
## CalleeCallback ## CalleeCallBack
(indata: rpc.MessageParcel): rpc.Sequenceable; (indata: rpc.MessageParcel): rpc.Sequenceable;
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| (indata: rpc.MessageParcel) | rpc.Sequenceable | 是 | 否 | 被调用方注册的消息侦听器函数接口的原型。 | | (indata: rpc.MessageParcel) | rpc.Sequenceable | 是 | 否 | 被调用方注册的消息侦听器函数接口的原型。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md
浏览文件 @ ce06dbac
...@@ -70,7 +70,7 @@ import AbilityConstant from '@ohos.application.AbilityConstant'; ...@@ -70,7 +70,7 @@ import AbilityConstant from '@ohos.application.AbilityConstant';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 取值 | 说明 | | 名称 | 值 | 说明 |
| --- | --- | --- | | --- | --- | --- |
| WINDOW_MODE_UNDEFINED | 0 | 未定义窗口模式。 | | WINDOW_MODE_UNDEFINED | 0 | 未定义窗口模式。 |
| WINDOW_MODE_FULLSCREEN | 1 | 全屏模式。 | | WINDOW_MODE_FULLSCREEN | 1 | 全屏模式。 |
...@@ -84,7 +84,7 @@ import AbilityConstant from '@ohos.application.AbilityConstant'; ...@@ -84,7 +84,7 @@ import AbilityConstant from '@ohos.application.AbilityConstant';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 取值 | 说明 | | 名称 | 值 | 说明 |
| --- | --- | --- | | --- | --- | --- |
| MEMORY_LEVEL_MODERATE | 0 | 内存占用适中。 | | MEMORY_LEVEL_MODERATE | 0 | 内存占用适中。 |
| MEMORY_LEVEL_LOW | 1 | 内存占用低。 | | MEMORY_LEVEL_LOW | 1 | 内存占用低。 |
......
zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md
浏览文件 @ ce06dbac
...@@ -41,7 +41,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void ...@@ -41,7 +41,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
**参数**： **参数**：
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| config | [Configuration](js-apis-application-configuration.md) | 是 | 新的配置项。 | | config | [Configuration](js-apis-application-configuration.md) | 是 | 新的配置项。 |
| callback | AsyncCallback\<void> | 是 | 被指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 被指定的回调方法。 |
...@@ -72,7 +72,7 @@ updateConfiguration(config: Configuration): Promise\<void> ...@@ -72,7 +72,7 @@ updateConfiguration(config: Configuration): Promise\<void>
**参数**： **参数**：
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| config | [Configuration](js-apis-application-configuration.md) | 是 | 新的配置项。 | | config | [Configuration](js-apis-application-configuration.md) | 是 | 新的配置项。 |
...@@ -110,7 +110,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo ...@@ -110,7 +110,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
**参数**： **参数**：
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 | | callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 |
...@@ -164,7 +164,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext ...@@ -164,7 +164,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext
**参数**： **参数**：
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 | | upperLimit | number | 是 | 获取消息数量的最大限制。 |
| callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 | | callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 |
...@@ -193,7 +193,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn ...@@ -193,7 +193,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
**参数**： **参数**：
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 | | upperLimit | number | 是 | 获取消息数量的最大限制。 |
...@@ -227,7 +227,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void; ...@@ -227,7 +227,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void;
**参数**： **参数**：
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\<ElementName> | 是 | 被指定的回调方法。 | | callback | AsyncCallback\<ElementName> | 是 | 被指定的回调方法。 |
......
zh-cn/application-dev/reference/apis/js-apis-application-appManager.md
浏览文件 @ ce06dbac
...@@ -4,7 +4,7 @@ appManager模块提供App管理的能力，包括查询当前是否处于稳定 ...@@ -4,7 +4,7 @@ appManager模块提供App管理的能力，包括查询当前是否处于稳定
> **说明：** > **说明：**
> >
> 本模块首批接口从API version 8 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 7 开始支持，从API version 9废弃，替换模块为[@ohos.app.ability.appManager](js-apis-app-ability-appManager.md)。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
...@@ -24,7 +24,7 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -24,7 +24,7 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 否 | 返回当前是否处于稳定性测试场景。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 返回当前是否处于稳定性测试场景。 |
**示例：** **示例：**
...@@ -98,7 +98,7 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void; ...@@ -98,7 +98,7 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 否 | 返回当前是否是ram受限设备。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 返回当前是否是ram受限设备。 |
**示例：** **示例：**
...@@ -145,7 +145,7 @@ getAppMemorySize(callback: AsyncCallback\<number>): void; ...@@ -145,7 +145,7 @@ getAppMemorySize(callback: AsyncCallback\<number>): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;number&gt; | 否 | 应用程序内存大小。 | | callback | AsyncCallback&lt;number&gt; | 是 | 应用程序内存大小。 |
**示例：** **示例：**
...@@ -199,7 +199,7 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo ...@@ -199,7 +199,7 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<ProcessRunningInfo>> | 否 | 获取有关运行进程的信息。 | | callback | AsyncCallback\<Array\<ProcessRunningInfo>> | 是 | 获取有关运行进程的信息。 |
**示例：** **示例：**
...@@ -250,7 +250,7 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor ...@@ -250,7 +250,7 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 否 | 获取有关运行进程的信息。 | | callback | AsyncCallback\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 是 | 获取有关运行进程的信息。 |
**示例：** **示例：**
...@@ -277,7 +277,7 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number; ...@@ -277,7 +277,7 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 否 | 返回观察者的数字代码。 | | observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 是 | 返回观察者的数字代码。 |
**示例：** **示例：**
...@@ -319,8 +319,8 @@ registerApplicationStateObserver(observer: ApplicationStateObserver, bundleNameL ...@@ -319,8 +319,8 @@ registerApplicationStateObserver(observer: ApplicationStateObserver, bundleNameL
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 否 | 返回观察者的数字代码。 | | observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 是 | 返回观察者的数字代码。 |
| bundleNameList | Array<string> | 否 | 表示需要注册监听的bundleName数组。最大值128。 | | bundleNameList | Array<string> | 是 | 表示需要注册监听的bundleName数组。最大值128。 |
**示例：** **示例：**
...@@ -362,8 +362,8 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\ ...@@ -362,8 +362,8 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| observerId | number | 否 | 表示观察者的编号代码。 | | observerId | number | 是 | 表示观察者的编号代码。 |
| callback | AsyncCallback\<void> | 否 | 表示指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例：** **示例：**
...@@ -394,7 +394,7 @@ unregisterApplicationStateObserver(observerId: number): Promise\<void>; ...@@ -394,7 +394,7 @@ unregisterApplicationStateObserver(observerId: number): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| observerId | number | 否 | 表示观察者的编号代码。 | | observerId | number | 是 | 表示观察者的编号代码。 |
**返回值：** **返回值：**
...@@ -432,7 +432,7 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; ...@@ -432,7 +432,7 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<AppStateData>> | 否 | 表示应用的状态数据。 | | callback | AsyncCallback\<Array\<AppStateData>> | 是 | 表示应用的状态数据。 |
**示例：** **示例：**
...@@ -562,8 +562,8 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>); ...@@ -562,8 +562,8 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 否 | 表示包名。 | | bundleName | string | 是 | 表示包名。 |
| callback | AsyncCallback\<void> | 否 | 表示指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例：** **示例：**
...@@ -595,7 +595,7 @@ killProcessesByBundleName(bundleName: string): Promise\<void>; ...@@ -595,7 +595,7 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 否 | 表示包名。 | | bundleName | string | 是 | 表示包名。 |
**返回值：** **返回值：**
...@@ -632,8 +632,8 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>); ...@@ -632,8 +632,8 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 否 | 表示包名。 | | bundleName | string | 是 | 表示包名。 |
| callback | AsyncCallback\<void> | 否 | 表示指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例：** **示例：**
...@@ -665,7 +665,7 @@ clearUpApplicationData(bundleName: string): Promise\<void>; ...@@ -665,7 +665,7 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 否 | 表示包名。 | | bundleName | string | 是 | 表示包名。 |
**返回值：** **返回值：**
...@@ -686,213 +686,13 @@ clearUpApplicationData(bundleName: string): Promise\<void>; ...@@ -686,213 +686,13 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
}) })
``` ```
## ApplicationStateObserver.onForegroundApplicationChanged<sup>8+</sup>
onForegroundApplicationChanged(appStateData: AppStateData): void;
将在前台或后台应用程序更改时调用。
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：该接口为系统接口，三方应用不支持调用。
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| appStateData | [AppStateData](js-apis-inner-application-appStateData.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);
```
## ApplicationStateObserver.onAbilityStateChanged<sup>8+</sup>
onAbilityStateChanged(abilityStateData: AbilityStateData): void;
将在能力状态更改时调用。
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：该接口为系统接口，三方应用不支持调用。
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| abilityStateData | [AbilityStateData](js-apis-inner-application-abilityStateData.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);
```
## ApplicationStateObserver.onProcessCreated<sup>8+</sup>
onProcessCreated(processData: ProcessData): void;
将在创建进程时调用。
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：该接口为系统接口，三方应用不支持调用。
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| processData | [ProcessData](js-apis-inner-application-processData.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);
```
## ApplicationStateObserver.onProcessDied<sup>8+</sup>
onProcessDied(processData: ProcessData): void;
将在进程终止时调用。
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：该接口为系统接口，三方应用不支持调用。
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| processData | [ProcessData](js-apis-inner-application-processData.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);
```
## ApplicationStateObserver.onProcessStateChanged<sup>9+</sup>
onProcessStateChanged(processData: ProcessData): void;
当进程状态更改时调用。
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：该接口为系统接口，三方应用不支持调用。
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| processData | [ProcessData](js-apis-inner-application-processData.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);
```
## ApplicationState<sup>9+</sup> ## ApplicationState<sup>9+</sup>
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
| 名称 | 值 | 描述 | | 名称 | 值 | 说明 |
| -------------------- | --- | --------------------------------- | | -------------------- | --- | --------------------------------- |
| STATE_CREATE | 1 | 当应用在创建中的时候处于的状态。 | | STATE_CREATE | 1 | 当应用在创建中的时候处于的状态。 |
| STATE_FOREGROUND | 2 | 当应用切换到前台的时候处于的状态。 | | STATE_FOREGROUND | 2 | 当应用切换到前台的时候处于的状态。 |
...@@ -906,7 +706,7 @@ console.log('-------- observerCode: ---------', observerCode); ...@@ -906,7 +706,7 @@ console.log('-------- observerCode: ---------', observerCode);
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
| 名称 | 值 | 描述 | | 名称 | 值 | 说明 |
| -------------------- | --- | --------------------------------- | | -------------------- | --- | --------------------------------- |
| STATE_CREATE | 1 | 当进程在创建中的时候处于的状态。 | | STATE_CREATE | 1 | 当进程在创建中的时候处于的状态。 |
| STATE_FOREGROUND | 2 | 当进程切换到前台的时候处于的状态。 | | STATE_FOREGROUND | 2 | 当进程切换到前台的时候处于的状态。 |
......
zh-cn/application-dev/reference/apis/js-apis-application-configuration.md
浏览文件 @ ce06dbac
...@@ -2,9 +2,16 @@ ...@@ -2,9 +2,16 @@
定义环境变化信息。 定义环境变化信息。
**说明：** > **说明：**
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块从API version 9废弃，替换模块为[@ohos.application.Configuration (Configuration)](js-apis-app-ability-configuration.md) > 本模块从API version 9废弃，替换模块为[@ohos.application.Configuration (Configuration)](js-apis-app-ability-configuration.md)
## 导入模块
```ts
import Configuration from '@ohos.application.Configuration'
```
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
......
zh-cn/application-dev/reference/apis/js-apis-application-errorManager.md
浏览文件 @ ce06dbac
...@@ -23,7 +23,7 @@ registerErrorObserver(observer: ErrorObserver): number; ...@@ -23,7 +23,7 @@ registerErrorObserver(observer: ErrorObserver): number;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| observer | [ErrorObserver](js-apis-inner-application-errorObserver.md) | 否 | 返回观察者的数字代码。 | | observer | [ErrorObserver](js-apis-inner-application-errorObserver.md) | 是 | 返回观察者的数字代码。 |
**示例：** **示例：**
...@@ -48,8 +48,8 @@ unregisterErrorObserver(observerId: number, callback: AsyncCallback\<void>): vo ...@@ -48,8 +48,8 @@ unregisterErrorObserver(observerId: number, callback: AsyncCallback\<void>): vo
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| observerId | number | 否 | 返回观察者的数字代码。 | | observerId | number | 是 | 返回观察者的数字代码。 |
| callback | AsyncCallback\<void> | 否 | 表示指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例：** **示例：**
...@@ -77,7 +77,7 @@ unregisterErrorObserver(observerId: number): Promise\<void>; ...@@ -77,7 +77,7 @@ unregisterErrorObserver(observerId: number): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| observerId | number | 否 | 返回观察者的数字代码。 | | observerId | number | 是 | 返回观察者的数字代码。 |
**返回值：** **返回值：**
......
zh-cn/application-dev/reference/apis/js-apis-application-extensionAbility.md
浏览文件 @ ce06dbac
...@@ -15,17 +15,17 @@ import ExtensionAbility from '@ohos.application.ExtensionAbility'; ...@@ -15,17 +15,17 @@ import ExtensionAbility from '@ohos.application.ExtensionAbility';
## ExtensionAbility.onConfigurationUpdated ## ExtensionAbility.onConfigurationUpdated
onConfigurationUpdated(config: Configuration): void; onConfigurationUpdated(newConfig: Configuration): void;
当系统配置更新时调用。 当系统配置更新时调用。
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| config | [Configuration](js-apis-application-configuration.md) | 是 | 表示需要更新的配置信息。 | | newConfig | [Configuration](js-apis-application-configuration.md) | 是 | 表示需要更新的配置信息。 |
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-application-formBindingData.md
浏览文件 @ ce06dbac
...@@ -18,9 +18,9 @@ FormBindingData相关描述。 ...@@ -18,9 +18,9 @@ FormBindingData相关描述。
**系统能力**：SystemCapability.Ability.Form **系统能力**：SystemCapability.Ability.Form
| 名称 | 可读 | 可写 | 参数类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| data | 是 | 否 | Object | 是 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。| | data | Object | 是 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。|
## createFormBindingData ## createFormBindingData
...@@ -35,7 +35,7 @@ createFormBindingData(obj?: Object | string): FormBindingData ...@@ -35,7 +35,7 @@ createFormBindingData(obj?: Object | string): FormBindingData
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------- | ---- | ------------------------------------------------------------ | | ------ | -------------- | ---- | ------------------------------------------------------------ |
| obj | Object或string | 否 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。其中图片数据以"formImages"作为标识，内容为图片标识与图片文件描述符的键值对{"formImages": {"key1": fd1, "key2": fd2}} | | obj | Object\|string | 否 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。其中图片数据以"formImages"作为标识，内容为图片标识与图片文件描述符的键值对{"formImages": {"key1": fd1, "key2": fd2}} |
**返回值：** **返回值：**
...@@ -60,4 +60,4 @@ context.getOrCreateLocalDir((err,data)=>{ ...@@ -60,4 +60,4 @@ context.getOrCreateLocalDir((err,data)=>{
}; };
let formBindingDataObj = formBindingData.createFormBindingData(obj); let formBindingDataObj = formBindingData.createFormBindingData(obj);
}) })
``` ```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-application-formExtension.md
浏览文件 @ ce06dbac
...@@ -232,7 +232,7 @@ onAcquireFormState?(want: Want): formInfo.FormState; ...@@ -232,7 +232,7 @@ onAcquireFormState?(want: Want): formInfo.FormState;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 否 | want表示获取卡片状态的描述。描述包括包名称、能力名称、模块名称、卡片名和卡片维度。 | | want | [Want](js-apis-application-want.md) | 是 | want表示获取卡片状态的描述。描述包括包名称、能力名称、模块名称、卡片名和卡片维度。 |
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-application-formHost.md
浏览文件 @ ce06dbac
...@@ -1112,7 +1112,7 @@ formHost.shareForm(formId, deviceId).then(() => { ...@@ -1112,7 +1112,7 @@ formHost.shareForm(formId, deviceId).then(() => {
## notifyFormsPrivacyProtected<sup>9+</sup> ## notifyFormsPrivacyProtected<sup>9+</sup>
notifyFormsPrivacyProtected(formIds: Array<string>, isProtected: boolean, callback: AsyncCallback<void>): void notifyFormsPrivacyProtected(formIds: Array\<string>, isProtected: boolean, callback: AsyncCallback\<void>): void
**需要权限**：ohos.permission.REQUIRE_FORM **需要权限**：ohos.permission.REQUIRE_FORM
......
zh-cn/application-dev/reference/apis/js-apis-application-formInfo.md
浏览文件 @ ce06dbac
...@@ -19,26 +19,26 @@ import formInfo from '@ohos.application.formInfo'; ...@@ -19,26 +19,26 @@ import formInfo from '@ohos.application.formInfo';
**系统能力**：SystemCapability.Ability.Form **系统能力**：SystemCapability.Ability.Form
| 名称 | 可读 | 可写 | 类型 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------- |-------- | -------------------- | ------------------------------------------------------------ | | ----------- | -------- |-------- | -------------------- | ------------------------------------------------------------ |
| bundleName | 是 | 否 | string | 表示卡片所属包的包名。 | | bundleName | string | 是 | 否 | 表示卡片所属包的包名。 |
| moduleName | 是 | 否 | string | 表示卡片所属模块的模块名。 | | moduleName | string | 是 | 否 | 表示卡片所属模块的模块名。 |
| abilityName | 是 | 否 | string | 表示卡片所属的Ability名称。 | | abilityName | string | 是 | 否 | 表示卡片所属的Ability名称。 |
| name | 是 | 否 | string | 表示卡片名称。 | | name | string | 是 | 否 | 表示卡片名称。 |
| description | 是 | 否 | string | 表示卡片描述。 | | description | string | 是 | 否 | 表示卡片描述。 |
| type | 是 | 否 | [FormType](#formtype) | 表示卡片类型，当前支持JS卡片。 | | type | [FormType](#formtype) | 是 | 否 | 表示卡片类型，当前支持JS卡片。 |
| jsComponentName | 是 | 否 | string | 表示js卡片的组件名。 | | jsComponentName | string | 是 | 否 | 表示js卡片的组件名。 |
| colorMode | 是 | 否 | [ColorMode](#colormode) | 表示卡片颜色模式。 | | colorMode | [ColorMode](#colormode) | 是 | 否 | 表示卡片颜色模式。 |
| isDefault | 是 | 否 | boolean | 表示是否是默认卡片。 | | isDefault | boolean | 是 | 否 | 表示是否是默认卡片。 |
| updateEnabled | 是 | 否 | boolean | 表示卡片是否使能更新。 | | updateEnabled | boolean | 是 | 否 | 表示卡片是否使能更新。 |
| formVisibleNotify | 是 | 否 | string | 表示卡片是否使能可见通知。 | | formVisibleNotify | string | 是 | 否 | 表示卡片是否使能可见通知。 |
| relatedBundleName | 是 | 否 | string | 表示卡片所属的相关联包名。 | | relatedBundleName | string | 是 | 否 | 表示卡片所属的相关联包名。 |
| scheduledUpdateTime | 是 | 否 | string | 表示卡片更新时间。 | | scheduledUpdateTime | string | 是 | 否 | 表示卡片更新时间。 |
| formConfigAbility | 是 | 否 | string | 表示卡片配置ability。 | | formConfigAbility | string | 是 | 否 | 表示卡片配置ability。 |
| updateDuration | 是 | 否 | string | 表示卡片更新周期。 | | updateDuration | string | 是 | 否 | 表示卡片更新周期。 |
| defaultDimension | 是 | 否 | number | 表示卡片规格 | | defaultDimension | number | 是 | 否 | 表示卡片规格 |
| supportDimensions | 是 | 否 | Array&lt;number&gt; | 表示卡片支持的规格。 | | supportDimensions | Array&lt;number&gt; | 是 | 否 | 表示卡片支持的规格。 |
| customizeData | 是 | 否 | {[key: string]: [value: string]} | 表示卡片用户数据。 | | customizeData | {[key: string]: [value: string]} | 是 | 否 | 表示卡片用户数据。 |
## FormType ## FormType
...@@ -49,7 +49,7 @@ import formInfo from '@ohos.application.formInfo'; ...@@ -49,7 +49,7 @@ import formInfo from '@ohos.application.formInfo';
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------- | ---- | ------------ | | ----------- | ---- | ------------ |
| JS | 1 | 卡片类型为JS。 | | JS | 1 | 卡片类型为JS。 |
| eTS | 2 | 卡片类型为eTS。 | | eTS<sup>9+<sup> | 2 | 卡片类型为eTS。 |
## ColorMode ## ColorMode
...@@ -69,10 +69,10 @@ import formInfo from '@ohos.application.formInfo'; ...@@ -69,10 +69,10 @@ import formInfo from '@ohos.application.formInfo';
**系统能力**：SystemCapability.Ability.Form **系统能力**：SystemCapability.Ability.Form
| 名称 | 可读 | 可写 | 类型 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------- |-------- | -------------------- | ------------------------------------------------------------ | | ----------- | -------- |-------- | -------------------- | ------------------------------------------------------------ |
| formState | 是 | 否 | [FormState](#formstate) | 表示卡片状态。 | | formState | [FormState](#formstate) | 是 | 否 | 表示卡片状态。 |
| want | 是 | 否 | Want | Want文本内容。 | | want | Want | 是 | 否 | Want文本内容。 |
## FormState ## FormState
...@@ -105,7 +105,7 @@ import formInfo from '@ohos.application.formInfo'; ...@@ -105,7 +105,7 @@ import formInfo from '@ohos.application.formInfo';
| DEVICE_ID_KEY<sup>9+</sup> | "ohos.extra.param.key.device_id" | 设备标识。<br/>**系统接口**: 此接口为系统接口。 | | DEVICE_ID_KEY<sup>9+</sup> | "ohos.extra.param.key.device_id" | 设备标识。<br/>**系统接口**: 此接口为系统接口。 |
| BUNDLE_NAME_KEY<sup>9+</sup> | "ohos.extra.param.key.bundle_name" | 指示指定要获取的捆绑包名称的键。| | BUNDLE_NAME_KEY<sup>9+</sup> | "ohos.extra.param.key.bundle_name" | 指示指定要获取的捆绑包名称的键。|
## FormDimension ## FormDimension<sup>9+</sup>
定义卡片尺寸枚举。 定义卡片尺寸枚举。
...@@ -113,11 +113,11 @@ import formInfo from '@ohos.application.formInfo'; ...@@ -113,11 +113,11 @@ import formInfo from '@ohos.application.formInfo';
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------- | ---- | ------------ | | ----------- | ---- | ------------ |
| Dimension_1_2<sup>9+</sup> | 1 | 1 x 2 form。 | | Dimension_1_2 <sup>9+</sup> | 1 | 1 x 2 form。 |
| Dimension_2_2<sup>9+</sup> | 2 | 2 x 2 form。 | | Dimension_2_2 <sup>9+</sup> | 2 | 2 x 2 form。 |
| Dimension_2_4<sup>9+</sup> | 3 | 2 x 4 form。 | | Dimension_2_4 <sup>9+</sup> | 3 | 2 x 4 form。 |
| Dimension_4_4<sup>9+</sup> | 4 | 4 x 4 form。 | | Dimension_4_4 <sup>9+</sup> | 4 | 4 x 4 form。 |
| Dimension_2_1<sup>9+</sup> | 5 | 2 x 1 form。 | | Dimension_2_1 <sup>9+</sup> | 5 | 2 x 1 form。 |
## VisibilityType ## VisibilityType
...@@ -127,8 +127,8 @@ import formInfo from '@ohos.application.formInfo'; ...@@ -127,8 +127,8 @@ import formInfo from '@ohos.application.formInfo';
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------- | ---- | ------------ | | ----------- | ---- | ------------ |
| FORM_VISIBLE | 1 | 卡片状态为可见。 | | FORM_VISIBLE<sup>9+<sup> | 1 | 卡片状态为可见。 |
| FORM_INVISIBLE | 2 | 卡片状态为不可见。 | | FORM_INVISIBLE<sup>9+<sup> | 2 | 卡片状态为不可见。 |
## FormInfoFilter<sup>9+</sup> ## FormInfoFilter<sup>9+</sup>
...@@ -136,9 +136,9 @@ import formInfo from '@ohos.application.formInfo'; ...@@ -136,9 +136,9 @@ import formInfo from '@ohos.application.formInfo';
**系统能力**：SystemCapability.Ability.Form **系统能力**：SystemCapability.Ability.Form
| 名称 | 必选 | 说明 | | 名称 | 说明 |
| ----------- | ---- | ------------ | | ----------- | ------------ |
| moduleName<sup>9+</sup> | 否 | 仅保留moduleName与提供值相符的卡片信息。 | | moduleName<sup>9+</sup> | 仅保留moduleName与提供值相符的卡片信息。 |
## VisibilityType<sup>9+</sup> ## VisibilityType<sup>9+</sup>
...@@ -148,5 +148,5 @@ import formInfo from '@ohos.application.formInfo'; ...@@ -148,5 +148,5 @@ import formInfo from '@ohos.application.formInfo';
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------- | ---- | ------------ | | ----------- | ---- | ------------ |
| FORM_VISIBLE<sup>9+<sup> | 否 | 表示卡片为可见。 | | FORM_VISIBLE<sup>9+<sup> | 1 | 表示卡片为可见。 |
| FORM_INVISIBLE<sup>9+<sup> | 否 | 表示卡片为不可见。 | | FORM_INVISIBLE<sup>9+<sup> | 2 | 表示卡片为不可见。 |
\ No newline at end of file \ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-application-formProvider.md
浏览文件 @ ce06dbac
...@@ -84,7 +84,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call ...@@ -84,7 +84,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- | | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| formId | string | 是 | 请求更新的卡片标识。 | | formId | string | 是 | 请求更新的卡片标识。 |
| formBindingData | [FormBindingData](js-apis-application-formBindingData.md#formbindingdata) | 是 | 用于更新的数据。 | | formBindingData.FormBindingData | [FormBindingData](js-apis-application-formBindingData.md#formbindingdata) | 是 | 用于更新的数据。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
**示例：** **示例：**
...@@ -113,7 +113,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr ...@@ -113,7 +113,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- | | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| formId | string | 是 | 请求更新的卡片标识。 | | formId | string | 是 | 请求更新的卡片标识。 |
| formBindingData | [FormBindingData](js-apis-application-formBindingData.md#formbindingdata) | 是 | 用于更新的数据。 | | formBindingData.FormBindingData | [FormBindingData](js-apis-application-formBindingData.md#formbindingdat) | 是 | 用于更新的数据。 |
**返回值：** **返回值：**
...@@ -241,7 +241,7 @@ requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, ...@@ -241,7 +241,7 @@ requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData,
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- | | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" | | want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
| formBindingData | [FormBindingData](js-apis-application-formBindingData.md#formbindingdata) | 是 | 创建卡片的数据。 | | formBindingData.FormBindingData | [FormBindingData](js-apis-application-formBindingData.md#formbindingdata) | 是 | 创建卡片的数据。 |
| callback | AsyncCallback&lt;string&gt; | 是 | 回调函数。返回卡片标识。 | | callback | AsyncCallback&lt;string&gt; | 是 | 回调函数。返回卡片标识。 |
**示例：** **示例：**
...@@ -318,7 +318,7 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData ...@@ -318,7 +318,7 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" | | want | [Want](js-apis-application-want.md) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
| formBindingData | [FormBindingData](js-apis-application-formBindingData.md#formbindingdata) | 否 | 创建卡片的数据。 | | formBindingData.FormBindingData | [FormBindingData](js-apis-application-formBindingData.md#formbindingdata) | 否 | 创建卡片的数据。 |
**返回值：** **返回值：**
......
zh-cn/application-dev/reference/apis/js-apis-application-serviceExtensionAbility.md
浏览文件 @ ce06dbac
...@@ -23,7 +23,7 @@ import ServiceExtensionAbility from '@ohos.application.ServiceExtensionAbility'; ...@@ -23,7 +23,7 @@ import ServiceExtensionAbility from '@ohos.application.ServiceExtensionAbility';
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| context | [ServiceExtensionContext](js-apis-inner-application-serviceExtensionContext.md) | 是 | 否 | ServiceExtension的上下文环境，继承自ExtensionContext。 | | context | [ServiceExtensionContext](js-apis-inner-application-serviceExtensionContext.md) | 是 | 否 | ServiceExtension的上下文环境，继承自ExtensionContext。 |
......
zh-cn/application-dev/reference/apis/js-apis-application-startOptions.md
浏览文件 @ ce06dbac
...@@ -17,7 +17,7 @@ import StartOptions from '@ohos.application.StartOptions'; ...@@ -17,7 +17,7 @@ import StartOptions from '@ohos.application.StartOptions';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| [windowMode](js-apis-application-abilityConstant.md#abilityconstantwindowmode) | 是 | 否 | number | 否 | 窗口模式。 | | [windowMode](js-apis-application-abilityConstant.md#abilityconstantwindowmode) | number | 否 | 窗口模式。 |
| displayId | 是 | 否 | number | 否 | 显示ID。 | | displayId | number | 否 | 显示ID。 |
zh-cn/application-dev/reference/apis/js-apis-application-want.md
浏览文件 @ ce06dbac
...@@ -16,18 +16,18 @@ import Want from '@ohos.application.Want'; ...@@ -16,18 +16,18 @@ import Want from '@ohos.application.Want';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 读写属性 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | | ----------- | -------------------- | ---- | ------------------------------------------------------------ |
| deviceId | 只读 | string | 否 | 表示运行指定Ability的设备ID。 | | deviceId | string | 否 | 表示运行指定Ability的设备ID。 |
| bundleName | 只读 | string | 否 | 表示包描述。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 | | bundleName | string | 否 | 表示包描述。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 |
| abilityName | 只读 | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 | | abilityName | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 |
| uri | 只读 | string | 否 | 表示Uri描述。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme, schemeSpecificPart, authority和path信息。 | | 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。 | | 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)。 | | flags | number | 否 | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-ability-wantConstant.md#wantConstant.Flags)。 |
| action | 只读 | string | 否 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。 | | action | string | 否 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。 |
| parameters | 只读 | {[key: string]: any} | 否 | 表示WantParams描述，由开发者自行决定传入的键值对。默认会携带以下key值：<br>ohos.aafwk.callerPid 表示拉起方的pid。<br>ohos.aafwk.param.callerToken 表示拉起方的token。<br>ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。 | | parameters | {[key: string]: any} | 否 | 表示WantParams描述，由开发者自行决定传入的键值对。默认会携带以下key值：<br>ohos.aafwk.callerPid 表示拉起方的pid。<br>ohos.aafwk.param.callerToken 表示拉起方的token。<br>ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。 |
| entities | 只读 | Array\<string> | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 | | entities | Array\<string> | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 |
| moduleName<sup>9+</sup> | 只读 | string | 否 | 表示待启动的Ability所属的模块（module）。 | | moduleName<sup>9+</sup> | string | 否 | 表示待启动的Ability所属的模块（module）。 |
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-inner-ability-abilityResult.md
浏览文件 @ ce06dbac
...@@ -2,12 +2,16 @@ ...@@ -2,12 +2,16 @@
定义ability拉起、销毁之后返回的结果码和数据。 定义ability拉起、销毁之后返回的结果码和数据。
> **说明：**
>
> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 读写属性 | 类型 | 必填 | 描述 | | 名称 | 可读 | 可写 | 类型 | 必填 | 说明 |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | | ----------- | -------- |-------- | -------------------- | ---- | ------------------------------------------------------------ |
| resultCode | 只读 | number | 否 | 表示ability拉起、销毁之后返回的结果码。 | | resultCode | 是 | 否 | number | 否 | 表示ability拉起、销毁之后返回的结果码。 |
| want | 只读 | [Want](js-apis-application-want.md) | 否 | 表示ability销毁之后返回的数据。 | | want | 是 | 否 | [Want](./js-apis-app-ability-want.md) | 否 | 表示ability销毁之后返回的数据。 |
**示例：** **示例：**
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-inner-ability-connectOptions.md
浏览文件 @ ce06dbac
...@@ -4,11 +4,11 @@ ConnectOptions类型说明 ...@@ -4,11 +4,11 @@ ConnectOptions类型说明
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 参数名 | 可读|可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------------ | -- | -- | -------- | ---- | ------------------------- | | ------------ | -------- | ---- | ------------------------- |
| onConnect<sup>7+</sup> | 是|否 | function | 是 | 连接成功时的回调函数。 | | onConnect<sup>7+</sup> | function | 是 | 连接成功时的回调函数。 |
| onDisconnect<sup>7+</sup> | 是|否 | function | 是 | 连接失败时的回调函数。 | | onDisconnect<sup>7+</sup> | function | 是 | 连接失败时的回调函数。 |
| onFailed<sup>7+</sup> | 是|否 | function | 是 | ConnectAbility调用失败时的回调函数。 | | onFailed<sup>7+</sup> | function | 是 | ConnectAbility调用失败时的回调函数。 |
**返回值：** **返回值：**
......
zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityOperation.md
浏览文件 @ ce06dbac
...@@ -9,16 +9,16 @@ ...@@ -9,16 +9,16 @@
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
| 名称 | 类型 | 可读 | 可写 | 必填| 说明 | | 名称 | 类型 | 必填| 说明 |
| -------- | -------- | -------- | -------- | --------| -------- | | -------- | -------- | --------| -------- |
| uri | string | 是 | 否 | 是 | 指定待处理的DataAbility。例："dataability:///com.example.xxx.xxxx"。 | | uri | string | 是 | 指定待处理的DataAbility。例："dataability:///com.example.xxx.xxxx"。 |
| type | featureAbility.DataAbilityOperationType | 是 | 否 | 是 | 指示操作类型。 | | type | featureAbility.DataAbilityOperationType | 是 | 指示操作类型。 |
| valuesBucket? | rdb.ValuesBucket | 是 | 否 | 否 | 指示要设置的数据值。 | | valuesBucket? | rdb.ValuesBucket | 否 | 指示要设置的数据值。 |
| valueBackReferences? | rdb.ValuesBucket | 是 | 否 | 否 | 指示包含一组键值对的valuesBucket对象。 | | valueBackReferences? | rdb.ValuesBucket | 否 | 指示包含一组键值对的valuesBucket对象。 |
| predicates? | dataAbility.DataAbilityPredicates | 是 | 否 | 否 | 指示要设置的筛选条件。如果此参数为空，则所有数据记录。 | | predicates? | dataAbility.DataAbilityPredicates | 否 | 指示要设置的筛选条件。如果此参数为空，则所有数据记录。 |
| predicatesBackReferences? | Map\<number, number> | 是 | 否 | 否 | 指示用作谓词中筛选条件的反向引用。 | | predicatesBackReferences? | Map\<number, number> | 否 | 指示用作谓词中筛选条件的反向引用。 |
| interrupted? | boolean | 是 | 否 | 否 | 指定是否可以中断批处理操作。 | | interrupted? | boolean | 否 | 指定是否可以中断批处理操作。 |
| expectedCount? | number | 是 | 否 | 否 | 指示要更新或删除的预期行数。 | | expectedCount? | number | 否 | 指示要更新或删除的预期行数。 |
**示例：** **示例：**
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityResult.md
浏览文件 @ ce06dbac
...@@ -9,10 +9,10 @@ ...@@ -9,10 +9,10 @@
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
| 名称 | 类型 | 可读 | 可写 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| uri? | string | 是 | 否 | 否 | 指定待处理的DataAbility。例："dataability:///com.example.xxx.xxxx"。 | | uri? | string | 否 | 指定待处理的DataAbility。例："dataability:///com.example.xxx.xxxx"。 |
| count? | number | 是 | 否 | 否 | 指示受操作影响的行数。 | | count? | number | 否 | 指示受操作影响的行数。 |
**示例：** **示例：**
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-inner-ability-startAbilityParameter.md
浏览文件 @ ce06dbac
...@@ -9,10 +9,10 @@ ...@@ -9,10 +9,10 @@
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
| 名称 | 类型 | 可读| 可写 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| ------------------- | -------- | -------------------- | ---- | -------------------------------------- | | ------------------- | -------- | ---- | -------------------------------------- |
| want | [Want](js-apis-application-want.md)| 是 | 否 | 是 | 表示需要包含有关目标启动能力的信息。 | | want | [Want](js-apis-application-want.md)| 是 | 表示需要包含有关目标启动能力的信息。 |
| abilityStartSetting | {[key: string]: any} | 是 |否 | 否 | 表示能力的特殊属性，当开发者启动能力时，该属性可以作为调用中的输入参数传递。 | | abilityStartSetting | {[key: string]: any} | 否 | 表示能力的特殊属性，当开发者启动能力时，该属性可以作为调用中的输入参数传递。 |
**示例：** **示例：**
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-inner-ability-want.md
浏览文件 @ ce06dbac
...@@ -8,18 +8,18 @@ Want是对象间信息传递的载体, 可以用于应用组件间的信息传 ...@@ -8,18 +8,18 @@ Want是对象间信息传递的载体, 可以用于应用组件间的信息传
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 读写属性 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | | ----------- | -------------------- | ---- | ------------------------------------------------------------ |
| deviceId | 只读 | string | 否 | 表示运行指定Ability的设备ID。 | | deviceId | string | 否 | 表示运行指定Ability的设备ID。 |
| bundleName | 只读 | string | 否 | 表示包名。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 | | bundleName | string | 否 | 表示包名。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 |
| abilityName | 只读 | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 | | abilityName | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 |
| uri | 只读 | string | 否 | 表示Uri。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme, schemeSpecificPart, authority和path信息。 | | 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。 | | 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)。 | | flags | number | 否 | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-ability-wantConstant.md#wantConstant.Flags)。 |
| action | 只读 | string | 否 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。 | | action | string | 否 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。 |
| parameters | 只读 | {[key: string]: any} | 否 | 表示WantParams，由开发者自行决定传入的键值对。默认会携带以下key值：<br>ohos.aafwk.callerPid 表示拉起方的pid。<br>ohos.aafwk.param.callerToken 表示拉起方的token。<br>ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。 | | parameters | {[key: string]: any} | 否 | 表示WantParams，由开发者自行决定传入的键值对。默认会携带以下key值：<br>ohos.aafwk.callerPid 表示拉起方的pid。<br>ohos.aafwk.param.callerToken 表示拉起方的token。<br>ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。 |
| entities | 只读 | Array\<string> | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 | | entities | Array\<string> | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 |
| moduleName<sup>9+</sup> | 只读 | string | 否 | 表示待启动的Ability所属的模块（module）。 | | moduleName<sup>9+</sup> | string | 否 | 表示待启动的Ability所属的模块（module）。 |
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-inner-app-context.md
浏览文件 @ ce06dbac
...@@ -31,7 +31,7 @@ getOrCreateLocalDir(callback: AsyncCallback\<string>): void ...@@ -31,7 +31,7 @@ getOrCreateLocalDir(callback: AsyncCallback\<string>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------- | | -------- | ---------------------- | ---- | ------------- |
| callback | AsyncCallback\<string> | 是 | 返回应用程序的本地根目录。 | | callback | AsyncCallback\<string> | 是 | 返回应用程序的本地根目录。 |
...@@ -83,7 +83,7 @@ verifyPermission(permission: string, options: PermissionOptions, callback: Async ...@@ -83,7 +83,7 @@ verifyPermission(permission: string, options: PermissionOptions, callback: Async
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | --------------------------------------- | ---- | -------------------- | | ---------- | --------------------------------------- | ---- | -------------------- |
| permission | string | 是 | 指定权限的名称。 | | permission | string | 是 | 指定权限的名称。 |
| options | [PermissionOptions](#permissionoptions7) | 是 | 权限选项。 | | options | [PermissionOptions](#permissionoptions7) | 是 | 权限选项。 |
...@@ -114,7 +114,7 @@ verifyPermission(permission: string, callback: AsyncCallback\<number>): void ...@@ -114,7 +114,7 @@ verifyPermission(permission: string, callback: AsyncCallback\<number>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------- | ---- | -------------------- | | ---------- | ---------------------- | ---- | -------------------- |
| permission | string | 是 | 指定权限的名称。 | | permission | string | 是 | 指定权限的名称。 |
| callback | AsyncCallback\<number> | 是 | 返回权限验证结果，0有权限，-1无权限。 | | callback | AsyncCallback\<number> | 是 | 返回权限验证结果，0有权限，-1无权限。 |
...@@ -139,7 +139,7 @@ verifyPermission(permission: string, options?: PermissionOptions): Promise\<numb ...@@ -139,7 +139,7 @@ verifyPermission(permission: string, options?: PermissionOptions): Promise\<numb
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | --------------------------------------- | ---- | -------- | | ---------- | --------------------------------------- | ---- | -------- |
| permission | string | 是 | 指定权限的名称。 | | permission | string | 是 | 指定权限的名称。 |
| options | [PermissionOptions](#permissionoptions) | 否 | 权限选项。 | | options | [PermissionOptions](#permissionoptions) | 否 | 权限选项。 |
...@@ -173,7 +173,7 @@ requestPermissionsFromUser(permissions: Array\<string>, requestCode: number, res ...@@ -173,7 +173,7 @@ requestPermissionsFromUser(permissions: Array\<string>, requestCode: number, res
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------------- | ---------------------------------------- | ---- | ----------------------------------- | | -------------- | ---------------------------------------- | ---- | ----------------------------------- |
| permissions | Array\<string> | 是 | 指示要请求的权限列表。此参数不能为null。 | | permissions | Array\<string> | 是 | 指示要请求的权限列表。此参数不能为null。 |
| requestCode | number | 是 | 指示要传递给PermissionRequestResult的请求代码。 | | requestCode | number | 是 | 指示要传递给PermissionRequestResult的请求代码。 |
...@@ -208,7 +208,7 @@ requestPermissionsFromUser(permissions: Array\<string>, requestCode: number): Pr ...@@ -208,7 +208,7 @@ requestPermissionsFromUser(permissions: Array\<string>, requestCode: number): Pr
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------------- | ------------------- | ----- | -------------------------------------------- | | -------------- | ------------------- | ----- | -------------------------------------------- |
| permissions | Array\<string> | 是 | 指示要请求的权限列表。此参数不能为null。 | | permissions | Array\<string> | 是 | 指示要请求的权限列表。此参数不能为null。 |
| requestCode | number | 是 | 指示要传递给PermissionRequestResult的请求代码。 | | requestCode | number | 是 | 指示要传递给PermissionRequestResult的请求代码。 |
...@@ -248,7 +248,7 @@ getApplicationInfo(callback: AsyncCallback\<ApplicationInfo>): void ...@@ -248,7 +248,7 @@ getApplicationInfo(callback: AsyncCallback\<ApplicationInfo>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------- | ---- | ------------ | | -------- | ------------------------------- | ---- | ------------ |
| callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是 | 返回当前应用程序的信息。 | | callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是 | 返回当前应用程序的信息。 |
...@@ -300,7 +300,7 @@ getBundleName(callback: AsyncCallback\<string>): void ...@@ -300,7 +300,7 @@ getBundleName(callback: AsyncCallback\<string>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------------ | | -------- | ---------------------- | ---- | ------------------ |
| callback | AsyncCallback\<string> | 是 | 返回当前ability的捆绑包名称。 | | callback | AsyncCallback\<string> | 是 | 返回当前ability的捆绑包名称。 |
...@@ -350,7 +350,7 @@ getDisplayOrientation(callback: AsyncCallback\<bundle.DisplayOrientation>): void ...@@ -350,7 +350,7 @@ getDisplayOrientation(callback: AsyncCallback\<bundle.DisplayOrientation>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------ | | -------- | ------------------------------------------------------------ | ---- | ------------------ |
| callback | AsyncCallback\<[bundle.DisplayOrientation](js-apis-Bundle.md#displayorientation)> | 是 | 表示屏幕显示方向。 | | callback | AsyncCallback\<[bundle.DisplayOrientation](js-apis-Bundle.md#displayorientation)> | 是 | 表示屏幕显示方向。 |
...@@ -398,7 +398,7 @@ getExternalCacheDir(callback: AsyncCallback\<string>): void ...@@ -398,7 +398,7 @@ getExternalCacheDir(callback: AsyncCallback\<string>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------------ | | -------- | ---------------------- | ---- | ------------------ |
| callback | AsyncCallback\<string> | 是 | 返回应用程序的缓存目录的绝对路径。 | | callback | AsyncCallback\<string> | 是 | 返回应用程序的缓存目录的绝对路径。 |
...@@ -446,7 +446,7 @@ setDisplayOrientation(orientation: bundle.DisplayOrientation, callback: AsyncCal ...@@ -446,7 +446,7 @@ setDisplayOrientation(orientation: bundle.DisplayOrientation, callback: AsyncCal
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ---------------------------------------- | ---- | ------------ | | ----------- | ---------------------------------------- | ---- | ------------ |
| orientation | [bundle.DisplayOrientation](js-apis-Bundle.md#displayorientation) | 是 | 指示当前能力的新方向。。 | | orientation | [bundle.DisplayOrientation](js-apis-Bundle.md#displayorientation) | 是 | 指示当前能力的新方向。。 |
| callback | AsyncCallback\<void> | 是 | 表示屏幕显示方向。 | | callback | AsyncCallback\<void> | 是 | 表示屏幕显示方向。 |
...@@ -500,7 +500,7 @@ setShowOnLockScreen(show: boolean, callback: AsyncCallback\<void>): void ...@@ -500,7 +500,7 @@ setShowOnLockScreen(show: boolean, callback: AsyncCallback\<void>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ---------------------------------------- | | -------- | -------------------- | ---- | ---------------------------------------- |
| show | boolean | 是 | 指定是否在锁屏顶部显示此功能。值true表示在锁屏上显示，值false表示不显示。 | | show | boolean | 是 | 指定是否在锁屏顶部显示此功能。值true表示在锁屏上显示，值false表示不显示。 |
| callback | AsyncCallback\<void> | 是 | 返回回调结果。 | | callback | AsyncCallback\<void> | 是 | 返回回调结果。 |
...@@ -526,7 +526,7 @@ setShowOnLockScreen(show: boolean): Promise\<void>; ...@@ -526,7 +526,7 @@ setShowOnLockScreen(show: boolean): Promise\<void>;
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------- | ---- | ---------------------------------------- | | ---- | ------- | ---- | ---------------------------------------- |
| show | boolean | 是 | 指定是否在锁屏顶部显示此功能。值true表示在锁屏上显示，值false表示不显示。 | | show | boolean | 是 | 指定是否在锁屏顶部显示此功能。值true表示在锁屏上显示，值false表示不显示。 |
...@@ -557,7 +557,7 @@ setWakeUpScreen(wakeUp: boolean, callback: AsyncCallback\<void>): void ...@@ -557,7 +557,7 @@ setWakeUpScreen(wakeUp: boolean, callback: AsyncCallback\<void>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | --------------------------------- | | -------- | -------------------- | ---- | --------------------------------- |
| wakeUp | boolean | 是 | 指定是否唤醒屏幕。值true表示唤醒它，值false表示不唤醒它。 | | wakeUp | boolean | 是 | 指定是否唤醒屏幕。值true表示唤醒它，值false表示不唤醒它。 |
| callback | AsyncCallback\<void> | 是 | 返回回调结果。 | | callback | AsyncCallback\<void> | 是 | 返回回调结果。 |
...@@ -583,7 +583,7 @@ setWakeUpScreen(wakeUp: boolean): Promise\<void>; ...@@ -583,7 +583,7 @@ setWakeUpScreen(wakeUp: boolean): Promise\<void>;
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ------- | ---- | --------------------------------- | | ------ | ------- | ---- | --------------------------------- |
| wakeUp | boolean | 是 | 指定是否唤醒屏幕。值true表示唤醒它，值false表示不唤醒它。 | | wakeUp | boolean | 是 | 指定是否唤醒屏幕。值true表示唤醒它，值false表示不唤醒它。 |
...@@ -617,7 +617,7 @@ getProcessInfo(callback: AsyncCallback\<ProcessInfo>): void ...@@ -617,7 +617,7 @@ getProcessInfo(callback: AsyncCallback\<ProcessInfo>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ---------- | | -------- | --------------------------- | ---- | ---------- |
| callback | AsyncCallback\<[ProcessInfo](js-apis-inner-app-processInfo.md)> | 是 | 返回当前进程的信息。 | | callback | AsyncCallback\<[ProcessInfo](js-apis-inner-app-processInfo.md)> | 是 | 返回当前进程的信息。 |
...@@ -671,7 +671,7 @@ getElementName(callback: AsyncCallback\<ElementName>): void ...@@ -671,7 +671,7 @@ getElementName(callback: AsyncCallback\<ElementName>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | -------------------------------------- | | -------- | --------------------------- | ---- | -------------------------------------- |
| callback | AsyncCallback\<[ElementName](js-apis-bundle-ElementName.md)> | 是 | 返回当前ability的ohos.bundle.ElementName对象。 | | callback | AsyncCallback\<[ElementName](js-apis-bundle-ElementName.md)> | 是 | 返回当前ability的ohos.bundle.ElementName对象。 |
...@@ -723,7 +723,7 @@ getProcessName(callback: AsyncCallback\<string>): void ...@@ -723,7 +723,7 @@ getProcessName(callback: AsyncCallback\<string>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ---------- | | -------- | ---------------------- | ---- | ---------- |
| callback | AsyncCallback\<string> | 是 | 返回当前进程的名称。 | | callback | AsyncCallback\<string> | 是 | 返回当前进程的名称。 |
...@@ -775,7 +775,7 @@ getCallingBundle(callback: AsyncCallback\<string>): void ...@@ -775,7 +775,7 @@ getCallingBundle(callback: AsyncCallback\<string>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ---------------- | | -------- | ---------------------- | ---- | ---------------- |
| callback | AsyncCallback\<string> | 是 | 返回调用ability的包名称。 | | callback | AsyncCallback\<string> | 是 | 返回调用ability的包名称。 |
...@@ -825,7 +825,7 @@ getCacheDir(callback: AsyncCallback\<string>): void ...@@ -825,7 +825,7 @@ getCacheDir(callback: AsyncCallback\<string>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | --------------- | | -------- | ---------------------- | ---- | --------------- |
| callback | AsyncCallback\<string> | 是 | 返回该应用程序的内部存储目录。 | | callback | AsyncCallback\<string> | 是 | 返回该应用程序的内部存储目录。 |
...@@ -873,7 +873,7 @@ getFilesDir(callback: AsyncCallback\<string>): void ...@@ -873,7 +873,7 @@ getFilesDir(callback: AsyncCallback\<string>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------------- | | -------- | ---------------------- | ---- | ------------------- |
| callback | AsyncCallback\<string> | 是 | 返回内部存储器上此应用程序的文件目录。 | | callback | AsyncCallback\<string> | 是 | 返回内部存储器上此应用程序的文件目录。 |
...@@ -923,7 +923,7 @@ getOrCreateDistributedDir(callback: AsyncCallback\<string>): void ...@@ -923,7 +923,7 @@ getOrCreateDistributedDir(callback: AsyncCallback\<string>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ---------------------------------------- | | -------- | ---------------------- | ---- | ---------------------------------------- |
| callback | AsyncCallback\<string> | 是 | 回调函数，可以在回调函数中处理接口返回值，返回Ability或应用的分布式文件路径。如果分布式文件路径不存在，系统将创建一个路径并返回创建的路径。 | | callback | AsyncCallback\<string> | 是 | 回调函数，可以在回调函数中处理接口返回值，返回Ability或应用的分布式文件路径。如果分布式文件路径不存在，系统将创建一个路径并返回创建的路径。 |
...@@ -973,7 +973,7 @@ getAppType(callback: AsyncCallback\<string>): void ...@@ -973,7 +973,7 @@ getAppType(callback: AsyncCallback\<string>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | -------------------------------- | | -------- | ---------------------- | ---- | -------------------------------- |
| callback | AsyncCallback\<string> | 是 | 回调函数，可以在回调函数中处理接口返回值，返回此应用程序的类型。 | | callback | AsyncCallback\<string> | 是 | 回调函数，可以在回调函数中处理接口返回值，返回此应用程序的类型。 |
...@@ -1021,7 +1021,7 @@ getHapModuleInfo(callback: AsyncCallback\<HapModuleInfo>): void ...@@ -1021,7 +1021,7 @@ getHapModuleInfo(callback: AsyncCallback\<HapModuleInfo>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | --------------------------------------- | | -------- | ---------------------------------------- | ---- | --------------------------------------- |
| callback | AsyncCallback\<[HapModuleInfo](js-apis-bundle-HapModuleInfo.md)> | 是 | 回调函数，可以在回调函数中处理接口返回值，返回应用的ModuleInfo对象。 | | callback | AsyncCallback\<[HapModuleInfo](js-apis-bundle-HapModuleInfo.md)> | 是 | 回调函数，可以在回调函数中处理接口返回值，返回应用的ModuleInfo对象。 |
...@@ -1069,7 +1069,7 @@ getAppVersionInfo(callback: AsyncCallback\<AppVersionInfo>): void ...@@ -1069,7 +1069,7 @@ getAppVersionInfo(callback: AsyncCallback\<AppVersionInfo>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------------------ | | -------- | ---------------------------------------- | ---- | ------------------------------ |
| callback | AsyncCallback\<[AppVersionInfo](js-apis-inner-app-appVersionInfo.md)> | 是 | 回调函数，可以在回调函数中处理接口返回值，返回应用版本信息。 | | callback | AsyncCallback\<[AppVersionInfo](js-apis-inner-app-appVersionInfo.md)> | 是 | 回调函数，可以在回调函数中处理接口返回值，返回应用版本信息。 |
...@@ -1117,7 +1117,7 @@ getAbilityInfo(callback: AsyncCallback\<AbilityInfo>): void ...@@ -1117,7 +1117,7 @@ getAbilityInfo(callback: AsyncCallback\<AbilityInfo>): void
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | --------------------------------------- | | -------- | ---------------------------------------- | ---- | --------------------------------------- |
| callback | AsyncCallback\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是 | 回调函数，可以在回调函数中处理接口返回值，返回当前归属Ability详细信息。 | | callback | AsyncCallback\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是 | 回调函数，可以在回调函数中处理接口返回值，返回当前归属Ability详细信息。 |
...@@ -1186,7 +1186,7 @@ isUpdatingConfigurations(callback: AsyncCallback\<boolean>): void; ...@@ -1186,7 +1186,7 @@ isUpdatingConfigurations(callback: AsyncCallback\<boolean>): void;
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------- | ---- | ----------------------------- | | -------- | ----------------------- | ---- | ----------------------------- |
| callback | AsyncCallback\<boolean> | 是 | 如果该能力的配置正在更改，则为true，否则为false。 | | callback | AsyncCallback\<boolean> | 是 | 如果该能力的配置正在更改，则为true，否则为false。 |
...@@ -1234,7 +1234,7 @@ printDrawnCompleted(callback: AsyncCallback\<void>): void; ...@@ -1234,7 +1234,7 @@ printDrawnCompleted(callback: AsyncCallback\<void>): void;
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ----------- | | -------- | -------------------- | ---- | ----------- |
| callback | AsyncCallback\<void> | 是 | 表示被指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 表示被指定的回调方法。 |
...@@ -1277,7 +1277,7 @@ context.printDrawnCompleted().then((data) => { ...@@ -1277,7 +1277,7 @@ context.printDrawnCompleted().then((data) => {
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 读写属性 | 类型 | 必填 | 描述 | | 名称 | 读写属性 | 类型 | 必填 | 说明 |
| ---- | ---- | ------ | ---- | ----- | | ---- | ---- | ------ | ---- | ----- |
| pid | 只读 | number | 否 | 进程id。 | | pid | 只读 | number | 否 | 进程id。 |
| uid | 只读 | number | 否 | 用户id。 | | uid | 只读 | number | 否 | 用户id。 |
...@@ -1286,7 +1286,7 @@ context.printDrawnCompleted().then((data) => { ...@@ -1286,7 +1286,7 @@ context.printDrawnCompleted().then((data) => {
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 读写属性 | 类型 | 必填 | 描述 | | 名称 | 读写属性 | 类型 | 必填 | 说明 |
| ----------- | ---- | -------------- | ---- | ---------- | | ----------- | ---- | -------------- | ---- | ---------- |
| requestCode | 只读 | number | 是 | 用户传入的请求代码。 | | requestCode | 只读 | number | 是 | 用户传入的请求代码。 |
| permissions | 只读 | Array\<string> | 是 | 用户传入的权限。 | | permissions | 只读 | Array\<string> | 是 | 用户传入的权限。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-app-processInfo.md
浏览文件 @ ce06dbac
...@@ -4,7 +4,7 @@ ...@@ -4,7 +4,7 @@
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| pid | number | 是 | 否 | 进程ID。 | | pid | number | 是 | 否 | 进程ID。 |
| processName | string | 是 | 否 | 进程名称。 | | processName | string | 是 | 否 | 进程名称。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-accessibilityExtensionContext.md
浏览文件 @ ce06dbac
...@@ -30,7 +30,7 @@ class MainAbility extends AccessibilityExtensionAbility { ...@@ -30,7 +30,7 @@ class MainAbility extends AccessibilityExtensionAbility {
**系统能力**：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core **系统能力**：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core
| 名称 | 描述 | | 名称 | 说明 |
| -------- | ------- | | -------- | ------- |
| up | 表示向上查询。 | | up | 表示向上查询。 |
| down | 表示向上查询。 | | down | 表示向上查询。 |
...@@ -45,7 +45,7 @@ class MainAbility extends AccessibilityExtensionAbility { ...@@ -45,7 +45,7 @@ class MainAbility extends AccessibilityExtensionAbility {
**系统能力**：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core **系统能力**：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core
| 名称 | 描述 | | 名称 | 说明 |
| ------------- | ----------- | | ------------- | ----------- |
| accessibility | 表示无障碍的焦点类型。 | | accessibility | 表示无障碍的焦点类型。 |
| normal | 表示普通的焦点类型。 | | normal | 表示普通的焦点类型。 |
...@@ -69,7 +69,7 @@ class MainAbility extends AccessibilityExtensionAbility { ...@@ -69,7 +69,7 @@ class MainAbility extends AccessibilityExtensionAbility {
**系统能力**：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core **系统能力**：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core
| 名称 | 描述 | | 名称 | 说明 |
| ----------- | --------- | | ----------- | --------- |
| application | 表示应用窗口类型。 | | application | 表示应用窗口类型。 |
| system | 表示系统窗口类型。 | | system | 表示系统窗口类型。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-appStateData.md
浏览文件 @ ce06dbac
...@@ -6,11 +6,11 @@ ...@@ -6,11 +6,11 @@
**系统API**：该接口为系统接口，三方应用不支持调用。 **系统API**：该接口为系统接口，三方应用不支持调用。
| 名称 | 读写属性 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | | ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
| bundleName<sup>8+</sup> | 只读 | string | 否 | 包名。 | | bundleName<sup>8+</sup> | string | 否 | 包名。 |
| uid<sup>8+</sup> | 只读 | number | 否 | 用户ID。 | | uid<sup>8+</sup> | number | 否 | 用户ID。 |
| state<sup>8+</sup> | 只读 | number | 否 | 应用状态。 | | state<sup>8+</sup> | number | 否 | 应用状态。 |
**示例：** **示例：**
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-baseContext.md
浏览文件 @ ce06dbac
...@@ -8,7 +8,7 @@ BaseContext抽象类用于表示继承的子类Context是Stage模型还是FA模 ...@@ -8,7 +8,7 @@ BaseContext抽象类用于表示继承的子类Context是Stage模型还是FA模
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | ------ | ---- | ---- | ------- | | -------- | ------ | ---- | ---- | ------- |
| stageMode | boolean | 是 | 是 | 表示Stage模型还是FA模型。 | | stageMode | boolean | 是 | 是 | 表示Stage模型还是FA模型。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md
浏览文件 @ ce06dbac
...@@ -36,7 +36,7 @@ createBundleContext(bundleName: string): Context; ...@@ -36,7 +36,7 @@ createBundleContext(bundleName: string): Context;
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------- | | -------- | ---------------------- | ---- | ------------- |
| bundleName | string | 是 | 包名。 | | bundleName | string | 是 | 包名。 |
...@@ -62,7 +62,7 @@ createModuleContext(moduleName: string): Context; ...@@ -62,7 +62,7 @@ createModuleContext(moduleName: string): Context;
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------- | | -------- | ---------------------- | ---- | ------------- |
| moduleName | string | 是 | 模块名。 | | moduleName | string | 是 | 模块名。 |
...@@ -86,7 +86,7 @@ createModuleContext(bundleName: string, moduleName: string): Context; ...@@ -86,7 +86,7 @@ createModuleContext(bundleName: string, moduleName: string): Context;
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------- | | -------- | ---------------------- | ---- | ------------- |
| bundleName | string | 是 | 包名。 | | bundleName | string | 是 | 包名。 |
| moduleName | string | 是 | 模块名。 | | moduleName | string | 是 | 模块名。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-continueDeviceInfo.md
浏览文件 @ ce06dbac
...@@ -4,7 +4,7 @@ ...@@ -4,7 +4,7 @@
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission **系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | ------ | ---- | ---- | ------- | | -------- | ------ | ---- | ---- | ------- |
| srcDeviceId | string | 是 | 是 | 表示任务迁移源设备ID。 | | srcDeviceId | string | 是 | 是 | 表示任务迁移源设备ID。 |
| dstDeviceId | string | 是 | 是 | 表示任务迁移目标设备ID。 | | dstDeviceId | string | 是 | 是 | 表示任务迁移目标设备ID。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionContext.md
浏览文件 @ ce06dbac
...@@ -13,7 +13,7 @@ ExtensionContext模块提供访问特定Extension的资源的能力，对于拓 ...@@ -13,7 +13,7 @@ ExtensionContext模块提供访问特定Extension的资源的能力，对于拓
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| currentHapModuleInfo | [HapModuleInfo](js-apis-bundle-HapModuleInfo.md) | 是 | 否 | 所属Hap包的信息。<br>(详见SDK目录下的 `api\bundle\hapModuleInfo.d.ts`) | | currentHapModuleInfo | [HapModuleInfo](js-apis-bundle-HapModuleInfo.md) | 是 | 否 | 所属Hap包的信息。<br>(详见SDK目录下的 `api\bundle\hapModuleInfo.d.ts`) |
| config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 否 | 所属Module的配置信息。<br>(详见SDK目录下的 `api\@ohos.app.ability.Configuration.d.ts`) | | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 否 | 所属Module的配置信息。<br>(详见SDK目录下的 `api\@ohos.app.ability.Configuration.d.ts`) |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionRunningInfo.md
浏览文件 @ ce06dbac
...@@ -15,7 +15,7 @@ ExtensionRunningInfo模块提供对Extension运行的相关信息和类型进行 ...@@ -15,7 +15,7 @@ ExtensionRunningInfo模块提供对Extension运行的相关信息和类型进行
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| extension | ElementName | 是 | 否 | Extension匹配信息。 | | extension | ElementName | 是 | 否 | Extension匹配信息。 |
| pid | number | 是 | 否 | 进程ID。 | | pid | number | 是 | 否 | 进程ID。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-missionDeviceInfo.md
浏览文件 @ ce06dbac
...@@ -4,7 +4,7 @@ ...@@ -4,7 +4,7 @@
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission **系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | ------ | ---- | ---- | ------- | | -------- | ------ | ---- | ---- | ------- |
| deviceId | string | 是 | 是 | 表示设备ID。 | | deviceId | string | 是 | 是 | 表示设备ID。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-missionInfo.md
浏览文件 @ ce06dbac
...@@ -6,7 +6,7 @@ ...@@ -6,7 +6,7 @@
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| missionId | number | 是 | 是 | 表示任务ID。| | missionId | number | 是 | 是 | 表示任务ID。|
| runningState | number | 是 | 是 | 表示运行状态。 | | runningState | number | 是 | 是 | 表示运行状态。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-missionListener.md
浏览文件 @ ce06dbac
...@@ -4,15 +4,15 @@ ...@@ -4,15 +4,15 @@
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission
| 名称 | 读写属性 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 说明 |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | | ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
| onMissionCreated | 只读 | function | 否 | 表示当系统创建任务时回调执行。 | | onMissionCreated | function | 否 | 表示当系统创建任务时回调执行。 |
| onMissionDestroyed | 只读 | function | 否 | 表示当系统销毁任务时回调执行。 | | onMissionDestroyed | function | 否 | 表示当系统销毁任务时回调执行。 |
| onMissionSnapshotChanged | 只读 | function | 否 | 表示当系统更新任务缩略图时回调执行。 | | onMissionSnapshotChanged | function | 否 | 表示当系统更新任务缩略图时回调执行。 |
| onMissionMovedToFront | 只读 | function | 否 | 表示当系统将任务移动到前台时回调执行。 | | onMissionMovedToFront | function | 否 | 表示当系统将任务移动到前台时回调执行。 |
| onMissionLabelUpdated | 只读 | function | 否 | 表示当系统更新任务标签时回调执行。 | | onMissionLabelUpdated | function | 否 | 表示当系统更新任务标签时回调执行。 |
| onMissionIconUpdated | 只读 | function | 否 | 表示当系统更新任务图标时回调执行。 | | onMissionIconUpdated | function | 否 | 表示当系统更新任务图标时回调执行。 |
| onMissionClosed | 只读 | function | 否 | 表示当系统关闭任务时回调执行。 | | onMissionClosed | function | 否 | 表示当系统关闭任务时回调执行。 |
**示例：** **示例：**
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-missionParameter.md
浏览文件 @ ce06dbac
...@@ -4,7 +4,7 @@ ...@@ -4,7 +4,7 @@
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission **系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | ------- | ---- | ---- | ----------- | | ----------- | ------- | ---- | ---- | ----------- |
| deviceId | string | 是 | 是 | 表示设备ID。 | | deviceId | string | 是 | 是 | 表示设备ID。 |
| fixConflict | boolean | 是 | 是 | 表示是否存在版本冲突。 | | fixConflict | boolean | 是 | 是 | 表示是否存在版本冲突。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-missionSnapshot.md
浏览文件 @ ce06dbac
...@@ -9,7 +9,7 @@ MissionSnapshot模块提供设置与任务对应的任务快照的任务元素 ...@@ -9,7 +9,7 @@ MissionSnapshot模块提供设置与任务对应的任务快照的任务元素
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| ability | ElementName | 是 | 是 | 表示Ability任务元素名称。 | | ability | ElementName | 是 | 是 | 表示Ability任务元素名称。 |
| snapshot | [image.PixelMap](js-apis-image.md) | 是 | 是 | 表示任务快照。 | | snapshot | [image.PixelMap](js-apis-image.md) | 是 | 是 | 表示任务快照。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-permissionRequestResult.md
浏览文件 @ ce06dbac
...@@ -11,7 +11,7 @@ PermissionRequestResult模块提供了权限请求结果的能力。 ...@@ -11,7 +11,7 @@ PermissionRequestResult模块提供了权限请求结果的能力。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| permissions | Array&lt;string&gt; | 是 | 否 | 用户传入的权限。| | permissions | Array&lt;string&gt; | 是 | 否 | 用户传入的权限。|
| authResults | Array&lt;number&gt; | 是 | 否 | 相应请求权限的结果。0表示授权成功，非0表示失败。 | | authResults | Array&lt;number&gt; | 是 | 否 | 相应请求权限的结果。0表示授权成功，非0表示失败。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md
浏览文件 @ ce06dbac
...@@ -10,7 +10,7 @@ ...@@ -10,7 +10,7 @@
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| pid | number | 是 | 否 | 进程ID。 | | pid | number | 是 | 否 | 进程ID。 |
| uid | number | 是 | 否 | 用户ID。 | | uid | number | 是 | 否 | 用户ID。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInformation.md
浏览文件 @ ce06dbac
...@@ -21,7 +21,7 @@ appManager.getProcessRunningInformation((error,data) => { ...@@ -21,7 +21,7 @@ appManager.getProcessRunningInformation((error,data) => {
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| pid | number | 是 | 否 | 进程ID。 | | pid | number | 是 | 否 | 进程ID。 |
| uid | number | 是 | 否 | 用户ID。 | | uid | number | 是 | 否 | 用户ID。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md
浏览文件 @ ce06dbac
...@@ -13,7 +13,7 @@ UIAbilityContext模块提供允许访问特定Ability的资源的能力，包括 ...@@ -13,7 +13,7 @@ UIAbilityContext模块提供允许访问特定Ability的资源的能力，包括
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| abilityInfo | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是 | 否 | Abilityinfo相关信息 | | abilityInfo | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是 | 否 | Abilityinfo相关信息 |
| currentHapModuleInfo | [HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md) | 是 | 否 | 当前hap包的信息 | | currentHapModuleInfo | [HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md) | 是 | 否 | 当前hap包的信息 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-wantAgent-triggerInfo.md
浏览文件 @ ce06dbac
...@@ -4,12 +4,12 @@ ...@@ -4,12 +4,12 @@
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| ---------- | --- | ---- | -------------------- | ---- | ----------- | | ---------- | --- | ---- | -------------------- | ---- | ----------- |
| code | 是 | 是 | number | 是 | result code。 | | code | number | 是 | result code。 |
| want | 是 | 是 | Want | 否 | Want。 | | want | Want | 否 | Want。 |
| permission | 是 | 是 | string | 否 | 权限定义。 | | permission | string | 否 | 权限定义。 |
| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 额外数据。 | | extraInfo | {[key: string]: any} | 否 | 额外数据。 |
**示例：** **示例：**
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-inner-wantAgent-wantAgentInfo.md
浏览文件 @ ce06dbac
...@@ -4,13 +4,13 @@ ...@@ -4,13 +4,13 @@
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------------- | --- | ---- | ------------------------------- | ---- | ---------------------- | | -------------- | ------------------------------- | ---- | ---------------------- |
| wants | 是 | 是 | Array\<Want\> | 是 | 将被执行的动作列表。 | | wants | Array\<Want\> | 是 | 将被执行的动作列表。 |
| operationType | 是 | 是 | wantAgent.OperationType | 是 | 动作类型。 | | operationType | wantAgent.OperationType | 是 | 动作类型。 |
| requestCode | 是 | 是 | number | 是 | 使用者定义的一个私有值。 | | requestCode | number | 是 | 使用者定义的一个私有值。 |
| wantAgentFlags | 是 | 是 | Array<[wantAgent.WantAgentFlags](js-apis-wantAgent.md#WantAgentFlags)> | 否 | 动作执行属性。 | | wantAgentFlags | Array<[wantAgent.WantAgentFlags](js-apis-wantAgent.md#WantAgentFlags)> | 否 | 动作执行属性。 |
| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 额外数据。 | | extraInfo | {[key: string]: any} | 否 | 额外数据。 |
**示例：** **示例：**
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-wantAgent.md
浏览文件 @ ce06dbac
...@@ -22,10 +22,10 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void ...@@ -22,10 +22,10 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --- | ---- | -------------------------- | ---- | ----------------------- | | -------- | -------------------------- | ---- | ----------------------- |
| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 | | info | WantAgentInfo | 是 | WantAgent信息。 |
| callback | 是 | 否 | AsyncCallback\<WantAgent\> | 是 | 创建WantAgent的回调方法。 | | callback | AsyncCallback\<WantAgent\> | 是 | 创建WantAgent的回调方法。 |
**示例：** **示例：**
...@@ -79,9 +79,9 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\> ...@@ -79,9 +79,9 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\>
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | --- | ---- | ------------- | ---- | ------------- | | ---- | ------------- | ---- | ------------- |
| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 | | info | WantAgentInfo | 是 | WantAgent信息。 |
**返回值：** **返回值：**
...@@ -140,10 +140,10 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void ...@@ -140,10 +140,10 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --- | ---- | ----------------------- | ---- | --------------------------------- | | -------- | ----------------------- | ---- | --------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<string\> | 是 | 获取WantAgent实例的包名的回调方法。 | | callback | AsyncCallback\<string\> | 是 | 获取WantAgent实例的包名的回调方法。 |
**示例：** **示例：**
...@@ -212,9 +212,9 @@ getBundleName(agent: WantAgent): Promise\<string\> ...@@ -212,9 +212,9 @@ getBundleName(agent: WantAgent): Promise\<string\>
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | --- | ---- | --------- | ---- | ------------- | | ----- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -281,10 +281,10 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void ...@@ -281,10 +281,10 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --- | ---- | ----------------------- | ---- | ----------------------------------- | | -------- | ----------------------- | ---- | ----------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<number\> | 是 | 获取WantAgent实例的用户ID的回调方法。 | | callback | AsyncCallback\<number\> | 是 | 获取WantAgent实例的用户ID的回调方法。 |
**示例：** **示例：**
...@@ -353,9 +353,9 @@ getUid(agent: WantAgent): Promise\<number\> ...@@ -353,9 +353,9 @@ getUid(agent: WantAgent): Promise\<number\>
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | --- | ---- | --------- | ---- | ------------- | | ----- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -424,10 +424,10 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void ...@@ -424,10 +424,10 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --- | ---- | --------------------- | ---- | ------------------------------- | | -------- | --------------------- | ---- | ------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<Want\> | 是 | 获取WantAgent对象want的回调方法。 | | callback | AsyncCallback\<Want\> | 是 | 获取WantAgent对象want的回调方法。 |
**示例：** **示例：**
...@@ -498,9 +498,9 @@ getWant(agent: WantAgent): Promise\<Want\> ...@@ -498,9 +498,9 @@ getWant(agent: WantAgent): Promise\<Want\>
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | --- | ---- | --------- | ---- | ------------- | | ----- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -567,10 +567,10 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void ...@@ -567,10 +567,10 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --- | ---- | --------------------- | ---- | --------------------------- | | -------- | --------------------- | ---- | --------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<void\> | 是 | 取消WantAgent实例的回调方法。 | | callback | AsyncCallback\<void\> | 是 | 取消WantAgent实例的回调方法。 |
**示例：** **示例：**
...@@ -639,9 +639,9 @@ cancel(agent: WantAgent): Promise\<void\> ...@@ -639,9 +639,9 @@ cancel(agent: WantAgent): Promise\<void\>
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | --- | ---- | --------- | ---- | ------------- | | ----- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -708,11 +708,11 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\<Complet ...@@ -708,11 +708,11 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\<Complet
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | --- | ---- | ----------------------------- | ---- | ------------------------------- | | ----------- | ----------------------------- | ---- | ------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| triggerInfo | 是 | 否 | TriggerInfo | 是 | TriggerInfo对象。 | | triggerInfo | TriggerInfo | 是 | TriggerInfo对象。 |
| callback | 是 | 否 | AsyncCallback\<CompleteData\> | 是 | 主动激发WantAgent实例的回调方法。 | | callback | AsyncCallback\<CompleteData\> | 否 | 主动激发WantAgent实例的回调方法。 |
**示例：** **示例：**
...@@ -785,11 +785,11 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\ ...@@ -785,11 +785,11 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | --- | ---- | ------------------------ | ---- | --------------------------------------- | | ---------- | ------------------------ | ---- | --------------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| otherAgent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | otherAgent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<boolean\> | 是 | 判断两个WantAgent实例是否相等的回调方法。 | | callback | AsyncCallback\<boolean\> | 是 | 判断两个WantAgent实例是否相等的回调方法。 |
**示例：** **示例：**
...@@ -860,10 +860,10 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\> ...@@ -860,10 +860,10 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\>
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | --- | ---- | --------- | ---- | ------------- | | ---------- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| otherAgent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | otherAgent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -930,10 +930,10 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void; ...@@ -930,10 +930,10 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void;
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | --- | ---- | ------------------------ | ---- | --------------------------------------- | | ---------- | ------------------------ | ---- | --------------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<number> | 是 | 获取一个WantAgent的OperationType信息的回调方法。 | | callback | AsyncCallback\<number> | 是 | 获取一个WantAgent的OperationType信息的回调方法。 |
**示例：** **示例：**
...@@ -991,9 +991,9 @@ getOperationType(agent: WantAgent): Promise\<number>; ...@@ -991,9 +991,9 @@ getOperationType(agent: WantAgent): Promise\<number>;
**参数：** **参数：**
| 参数名 | 可读 | 可写 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | --- | ---- | --------- | ---- | ------------- | | ---------- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | | agent | WantAgent | 是 | WantAgent对象。 |
**返回值：** **返回值：**
...@@ -1053,13 +1053,13 @@ WantAgent.getOperationType(wantAgent).then((OperationType) => { ...@@ -1053,13 +1053,13 @@ WantAgent.getOperationType(wantAgent).then((OperationType) => {
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------------- | --- | ---- | ------------------------------- | ---- | ---------------------- | | -------------- | ------------------------------- | ---- | ---------------------- |
| wants | 是 | 是 | Array\<Want\> | 是 | 将被执行的动作列表。 | | wants | Array\<Want\> | 是 | 将被执行的动作列表。 |
| operationType | 是 | 是 | wantAgent.OperationType | 是 | 动作类型。 | | operationType | wantAgent.OperationType | 是 | 动作类型。 |
| requestCode | 是 | 是 | number | 是 | 使用者定义的一个私有值。 | | requestCode | number | 是 | 使用者定义的一个私有值。 |
| wantAgentFlags | 是 | 是 | Array<wantAgent.WantAgentFlags> | 否 | 动作执行属性。 | | wantAgentFlags | Array<wantAgent.WantAgentFlags> | 否 | 动作执行属性。 |
| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 额外数据。 | | extraInfo | {[key: string]: any} | 否 | 额外数据。 |
## WantAgentFlags ## WantAgentFlags
...@@ -1094,21 +1094,10 @@ WantAgent.getOperationType(wantAgent).then((OperationType) => { ...@@ -1094,21 +1094,10 @@ WantAgent.getOperationType(wantAgent).then((OperationType) => {
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------------- | --- | ---- | ------------------------------ | ---- | ---------------------- | | -------------- | ------------------------------ | ---- | ---------------------- |
| info | 是 | 是 | WantAgent | 是 | 触发的wantAgent。 | | info | WantAgent | 是 | 触发的wantAgent。 |
| want | 是 | 是 | Want | 是 | 存在的被触发的want。 | | want | Want | 是 | 存在的被触发的want。 |
| finalCode | 是 | 是 | number | 是 | 触发wantAgent的请求代码。| | finalCode | number | 是 | 触发wantAgent的请求代码。|
| finalData | 是 | 是 | string | 否 | 公共事件收集的最终数据。 | | finalData | string | 否 | 公共事件收集的最终数据。 |
| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 额外数据。 | | extraInfo | {[key: string]: any} | 否 | 额外数据。 |
## TriggerInfo
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 |
| ---------- | --- | ---- | -------------------- | ---- | ----------- |
| code | 是 | 是 | number | 是 | result code。 |
| want | 是 | 是 | Want | 否 | Want。 |
| permission | 是 | 是 | string | 否 | 权限定义。 |
| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 额外数据。 |
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或