Skip to content

D
Docs

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

通知 161
Star 293
Fork 28
D
Docs
提交 473bc686 编写于 作者: D donglin
浏览文件
操作

doc optimize 

Signed-off-by: Ndonglin <donglin9@huawei.com>
Change-Id: I29a634d8b0b31ede41d853660f31c84dbd9bc5ef
上级 28f2d6d5
隐藏空白更改
内联 并排
Showing with 353 addition and 380 deletion
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
浏览文件 @ 473bc686
...@@ -19,40 +19,40 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant'; ...@@ -19,40 +19,40 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| launchReason | LaunchReason| 是 | 是 | 指示启动原因。 | | launchReason | [LaunchReason](#abilityconstantlaunchreason)| 是 | 是 | 枚举类型，表示启动原因。 |
| lastExitReason | LastExitReason | 是 | 是 | 表示最后退出原因。 | | lastExitReason | [LastExitReason](#abilityconstantlastexitreason) | 是 | 是 | 枚举类型，表示最后退出原因。 |
## AbilityConstant.LaunchReason ## AbilityConstant.LaunchReason
初次启动原因。 初次启动原因，该类型为枚举，可配合[Ability](js-apis-app-ability-uiAbility.md)的[onCreate(want, launchParam)](js-apis-app-ability-uiAbility.md#uiabilityoncreate)方法根据launchParam.launchReason的不同类型执行相应操作。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------------------------- | ---- | ------------------------------------------------------------ | | ----------------------------- | ---- | ------------------------------------------------------------ |
| UNKNOWN | 0 | 未知的状态。 | | UNKNOWN | 0 | 未知原因。 |
| START_ABILITY | 1 | 启动能力。 | | START_ABILITY | 1 | 通过[startAbility](js-apis-ability-context.md#abilitycontextstartability)接口启动ability。 |
| CALL | 2 | 呼叫。 | | CALL | 2 | 通过[startAbilityByCall](js-apis-ability-context.md#abilitycontextstartabilitybycall)接口启动ability。 |
| CONTINUATION | 3 | 继续。 | | CONTINUATION | 3 | 跨端设备迁移启动ability。 |
| APP_RECOVERY | 4 | 状态恢复。 | | APP_RECOVERY | 4 | 设置应用恢复后，应用故障时自动恢复启动ability。 |
## AbilityConstant.LastExitReason ## AbilityConstant.LastExitReason
上次退出原因。 上次退出原因，该类型为枚举，可配合[Ability](js-apis-app-ability-uiAbility.md)的[onCreate(want, launchParam)](js-apis-app-ability-uiAbility.md#uiabilityoncreate)方法根据launchParam.lastExitReason的不同类型执行相应操作。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------------------------- | ---- | ------------------------------------------------------------ | | ----------------------------- | ---- | ------------------------------------------------------------ |
| UNKNOWN | 0 | 未知的状态。 | | UNKNOWN | 0 | 未知原因。 |
| ABILITY_NOT_RESPONDING | 1 | 能力没有反应 | | ABILITY_NOT_RESPONDING | 1 | ability未响应。 |
| NORMAL | 2 | 正常的状态。 | | NORMAL | 2 | 正常退出。 |
## AbilityConstant.OnContinueResult ## AbilityConstant.OnContinueResult
迁移结果。 迁移结果，该类型为枚举，可配合[Ability](js-apis-app-ability-uiAbility.md)的[onContinue(wantParam)](js-apis-app-ability-uiAbility.md#uiabilityoncontinue)方法进完成相应的返回。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -64,7 +64,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant'; ...@@ -64,7 +64,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
## AbilityConstant.WindowMode ## AbilityConstant.WindowMode
启动Ability时的窗口模式。 启动Ability时的窗口模式，该类型为枚举，可配合startAbility使用指定启动Ability的窗口模式。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -78,7 +78,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant'; ...@@ -78,7 +78,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
## AbilityConstant.MemoryLevel ## AbilityConstant.MemoryLevel
内存级别。 内存级别，该类型为枚举，可配合[Ability](js-apis-app-ability-ability.md)的[onMemoryLevel(level)](js-apis-app-ability-ability.md#abilityonmemorylevel)方法根据level执行不同内存级别的相应操作。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -90,22 +90,22 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant'; ...@@ -90,22 +90,22 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
## AbilityConstant.OnSaveResult ## AbilityConstant.OnSaveResult
保存应用数据的结果。 保存应用数据的结果，该类型为枚举，可配合[Ability](js-apis-app-ability-uiAbility.md)的[onSaveState(reason, wantParam)](js-apis-app-ability-uiAbility.md#uiabilityonsavestate)方法完成相应的返回。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------------------------- | ---- | ------------------------------------------------------------ | | ----------------------------- | ---- | ------------------------------------------------------------ |
| ALL_AGREE | 0 | 同意保存状态。 | | ALL_AGREE | 0 | 总是同意保存状态。 |
| CONTINUATION_REJECT | 1 | 拒绝迁移保存状态。 | | CONTINUATION_REJECT | 1 | 拒绝迁移保存状态。 |
| CONTINUATION_MISMATCH | 2 | 迁移不匹配。| | CONTINUATION_MISMATCH | 2 | 迁移不匹配。|
| RECOVERY_AGREE | 3 | 同意恢复保存状态。 | | RECOVERY_AGREE | 3 | 同意恢复保存状态。 |
| RECOVERY_REJECT | 4 | 拒绝恢复保存状态。| | RECOVERY_REJECT | 4 | 拒绝恢复保存状态。|
| ALL_REJECT | 5 | 拒绝保存状态。| | ALL_REJECT | 5 | 总是拒绝保存状态。|
## AbilityConstant.StateType ## AbilityConstant.StateType
保存应用数据场景原因。 保存应用数据场景原因，该类型为枚举，可配合[Ability](js-apis-app-ability-uiAbility.md)的[onSaveState(reason, wantParam)](js-apis-app-ability-uiAbility.md#uiabilityonsavestate)方法根据reason的不同类型执行相应操作。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md
浏览文件 @ 473bc686
# @ohos.app.ability.abilityDelegatorRegistry (AbilityDelegatorRegistry) # @ohos.app.ability.abilityDelegatorRegistry (AbilityDelegatorRegistry)
AbilityDelegatorRegistry模块提供用于存储已注册的AbilityDelegator和AbilityDelegatorArgs对象的全局寄存器的能力，包括获取应用程序的AbilityDelegator对象、获取单元测试参数AbilityDelegatorArgs对象。 AbilityDelegatorRegistry模块提供用于存储已注册的[AbilityDelegator](js-apis-inner-application-abilityDelegator.md)和[AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md)对象的全局寄存器的能力，包括获取应用程序的[AbilityDelegator](js-apis-inner-application-abilityDelegator.md)对象、获取单元测试参数[AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md)对象。
> **说明：** > **说明：**
> >
...@@ -14,7 +14,7 @@ import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry ...@@ -14,7 +14,7 @@ import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry
## AbilityLifecycleState ## AbilityLifecycleState
Ability生命周期状态。 Ability生命周期状态，该类型为枚举，可配合[AbilityDelegator](js-apis-inner-application-abilityDelegator.md)的[getAbilityState(ability)](js-apis-inner-application-abilityDelegator.md#getabilitystate9)方法返回不同ability生命周期。
**系统能力** ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力** ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -28,9 +28,9 @@ Ability生命周期状态。 ...@@ -28,9 +28,9 @@ Ability生命周期状态。
## AbilityDelegatorRegistry.getAbilityDelegator ## AbilityDelegatorRegistry.getAbilityDelegator
getAbilityDelegator(): AbilityDelegator getAbilityDelegator(): [AbilityDelegator](js-apis-inner-application-abilityDelegator.md)
获取应用程序的AbilityDelegator对象 获取应用程序的[AbilityDelegator](js-apis-inner-application-abilityDelegator.md)对象。
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力：** SystemCapability.Ability.AbilityRuntime.Core
...@@ -45,13 +45,21 @@ getAbilityDelegator(): AbilityDelegator ...@@ -45,13 +45,21 @@ getAbilityDelegator(): AbilityDelegator
```ts ```ts
var abilityDelegator; var abilityDelegator;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
let want = {
bundleName: "com.ohos.example",
abilityName: "MainAbility"
}
abilityDelegator.startAbility(want, (err, data)=>{
console.log("startAbility callback err: " + JSON.stringify(err) + " data: " + JSON.stringify(data));
})
``` ```
## AbilityDelegatorRegistry.getArguments ## AbilityDelegatorRegistry.getArguments
getArguments(): AbilityDelegatorArgs getArguments(): [AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md)
获取单元测试参数AbilityDelegatorArgs对象 获取单元测试参数[AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md)对象。
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力：** SystemCapability.Ability.AbilityRuntime.Core
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md
浏览文件 @ 473bc686
# @ohos.app.ability.abilityLifecycleCallback (AbilityLifecycleCallback) # @ohos.app.ability.abilityLifecycleCallback (AbilityLifecycleCallback)
AbilityLifecycleCallback模块提供应用上下文ApplicationContext的生命周期监听方法的回调类的能力，包括onAbilityCreate、onWindowStageCreate、onWindowStageDestroy等方法。 AbilityLifecycleCallback模块提供应用上下文[ApplicationContext](js-apis-inner-application-applicationContext.md)的生命周期监听方法的回调类的能力，包括[onAbilityCreate](#abilitylifecyclecallbackonabilitycreate)、[onWindowStageCreate](#abilitylifecyclecallbackonwindowstagecreate)、[onWindowStageActive](#abilitylifecyclecallbackonwindowstageactive)、[onWindowStageInactive](#abilitylifecyclecallbackonwindowstageinactive)、[onWindowStageDestroy](#abilitylifecyclecallbackonwindowstagedestroy)、[onAbilityDestroy](#abilitylifecyclecallbackonabilitydestroy)、[onAbilityForeground](#abilitylifecyclecallbackonabilityforeground)、[onAbilityBackground](#abilitylifecyclecallbackonabilitybackground)、[onAbilityContinue](#abilitylifecyclecallbackonabilitycontinue)方法。
> **说明：** > **说明：**
> >
...@@ -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: UIAbility): void; onAbilityCreate(ability: [UIAbility](js-apis-app-ability-uiAbility.md)): void;
注册监听应用上下文的生命周期后，在ability创建时触发回调。 注册监听应用上下文的生命周期后，在ability创建时触发回调。
...@@ -27,12 +27,12 @@ onAbilityCreate(ability: UIAbility): void; ...@@ -27,12 +27,12 @@ onAbilityCreate(ability: UIAbility): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onWindowStageCreate ## AbilityLifecycleCallback.onWindowStageCreate
onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void; onWindowStageCreate(ability: [UIAbility](js-apis-app-ability-uiAbility.md), windowStage: [window.WindowStage](js-apis-window.md#windowstage9)): void;
注册监听应用上下文的生命周期后，在windowStage创建时触发回调。 注册监听应用上下文的生命周期后，在windowStage创建时触发回调。
...@@ -42,13 +42,13 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -42,13 +42,13 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前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: UIAbility, windowStage: window.WindowStage): void; onWindowStageActive(ability: [UIAbility](js-apis-app-ability-uiAbility.md), windowStage: [window.WindowStage](js-apis-window.md#windowstage9)): void;
注册监听应用上下文的生命周期后，在windowStage获焦时触发回调。 注册监听应用上下文的生命周期后，在windowStage获焦时触发回调。
...@@ -58,13 +58,13 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -58,13 +58,13 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前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: UIAbility, windowStage: window.WindowStage): void; onWindowStageInactive(ability: [UIAbility](js-apis-app-ability-uiAbility.md), windowStage: [window.WindowStage](js-apis-window.md#windowstage9)): void;
注册监听应用上下文的生命周期后，在windowStage失焦时触发回调。 注册监听应用上下文的生命周期后，在windowStage失焦时触发回调。
...@@ -74,13 +74,13 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void ...@@ -74,13 +74,13 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前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: UIAbility, windowStage: window.WindowStage): void; onWindowStageDestroy(ability: [UIAbility](js-apis-app-ability-uiAbility.md), windowStage: [window.WindowStage](js-apis-window.md#windowstage9)): void;
注册监听应用上下文的生命周期后，在windowStage销毁时触发回调。 注册监听应用上下文的生命周期后，在windowStage销毁时触发回调。
...@@ -90,13 +90,13 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -90,13 +90,13 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前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: UIAbility): void; onAbilityDestroy(ability: [UIAbility](js-apis-app-ability-uiAbility.md)): void;
注册监听应用上下文的生命周期后，在ability销毁时触发回调。 注册监听应用上下文的生命周期后，在ability销毁时触发回调。
...@@ -106,12 +106,12 @@ onAbilityDestroy(ability: UIAbility): void; ...@@ -106,12 +106,12 @@ onAbilityDestroy(ability: UIAbility): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onAbilityForeground ## AbilityLifecycleCallback.onAbilityForeground
onAbilityForeground(ability: UIAbility): void; onAbilityForeground(ability: [UIAbility](js-apis-app-ability-uiAbility.md)): void;
注册监听应用上下文的生命周期后，在ability的状态从后台转到前台时触发回调。 注册监听应用上下文的生命周期后，在ability的状态从后台转到前台时触发回调。
...@@ -121,12 +121,12 @@ onAbilityForeground(ability: UIAbility): void; ...@@ -121,12 +121,12 @@ onAbilityForeground(ability: UIAbility): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onAbilityBackground ## AbilityLifecycleCallback.onAbilityBackground
onAbilityBackground(ability: UIAbility): void; onAbilityBackground(ability: [UIAbility](js-apis-app-ability-uiAbility.md)): void;
注册监听应用上下文的生命周期后，在ability的状态从前台转到后台时触发回调。 注册监听应用上下文的生命周期后，在ability的状态从前台转到后台时触发回调。
...@@ -136,12 +136,12 @@ onAbilityBackground(ability: UIAbility): void; ...@@ -136,12 +136,12 @@ onAbilityBackground(ability: UIAbility): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onAbilityContinue ## AbilityLifecycleCallback.onAbilityContinue
onAbilityContinue(ability: UIAbility): void; onAbilityContinue(ability: [UIAbility](js-apis-app-ability-uiAbility.md)): void;
注册监听应用上下文的生命周期后，在ability迁移时触发回调。 注册监听应用上下文的生命周期后，在ability迁移时触发回调。
...@@ -151,61 +151,63 @@ onAbilityContinue(ability: UIAbility): void; ...@@ -151,61 +151,63 @@ onAbilityContinue(ability: UIAbility): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md#Ability) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
**示例：** **示例：**
```ts
import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback";
```ts // 声明ability生命周期回调
import UIAbility from "@ohos.app.ability.UIAbility"; let abilityLifecycleCallback = {
onAbilityCreate(ability){
export default class MyAbility extends UIAbility { console.log("AbilityLifecycleCallback onAbilityCreate ability:" + JSON.stringify(ability));
onCreate() { },
console.log("MyAbility onCreate") onWindowStageCreate(ability, windowStage){
let AbilityLifecycleCallback = { console.log("AbilityLifecycleCallback onWindowStageCreate ability:" + JSON.stringify(ability));
onAbilityCreate(ability){ console.log("AbilityLifecycleCallback onWindowStageCreate windowStage:" + JSON.stringify(windowStage));
console.log("AbilityLifecycleCallback onAbilityCreate ability:" + JSON.stringify(ability)); },
}, onWindowStageActive(ability, windowStage){
onWindowStageCreate(ability, windowStage){ console.log("AbilityLifecycleCallback onWindowStageActive ability:" + JSON.stringify(ability));
console.log("AbilityLifecycleCallback onWindowStageCreate ability:" + JSON.stringify(ability)); console.log("AbilityLifecycleCallback onWindowStageActive windowStage:" + JSON.stringify(windowStage));
console.log("AbilityLifecycleCallback onWindowStageCreate windowStage:" + JSON.stringify(windowStage)); },
}, onWindowStageInactive(ability, windowStage){
onWindowStageActive(ability, windowStage){ console.log("AbilityLifecycleCallback onWindowStageInactive ability:" + JSON.stringify(ability));
console.log("AbilityLifecycleCallback onWindowStageActive ability:" + JSON.stringify(ability)); console.log("AbilityLifecycleCallback onWindowStageInactive windowStage:" + JSON.stringify(windowStage));
console.log("AbilityLifecycleCallback onWindowStageActive windowStage:" + JSON.stringify(windowStage)); },
}, onWindowStageDestroy(ability, windowStage){
onWindowStageInactive(ability, windowStage){ console.log("AbilityLifecycleCallback onWindowStageDestroy ability:" + JSON.stringify(ability));
console.log("AbilityLifecycleCallback onWindowStageInactive ability:" + JSON.stringify(ability)); console.log("AbilityLifecycleCallback onWindowStageDestroy windowStage:" + JSON.stringify(windowStage));
console.log("AbilityLifecycleCallback onWindowStageInactive windowStage:" + JSON.stringify(windowStage)); },
}, onAbilityDestroy(ability){
onWindowStageDestroy(ability, windowStage){ console.log("AbilityLifecycleCallback onAbilityDestroy ability:" + JSON.stringify(ability));
console.log("AbilityLifecycleCallback onWindowStageDestroy ability:" + JSON.stringify(ability)); },
console.log("AbilityLifecycleCallback onWindowStageDestroy windowStage:" + JSON.stringify(windowStage)); onAbilityForeground(ability){
}, console.log("AbilityLifecycleCallback onAbilityForeground ability:" + JSON.stringify(ability));
onAbilityDestroy(ability){ },
console.log("AbilityLifecycleCallback onAbilityDestroy ability:" + JSON.stringify(ability)); onAbilityBackground(ability){
}, console.log("AbilityLifecycleCallback onAbilityBackground ability:" + JSON.stringify(ability));
onAbilityForeground(ability){ },
console.log("AbilityLifecycleCallback onAbilityForeground ability:" + JSON.stringify(ability)); onAbilityContinue(ability){
}, console.log("AbilityLifecycleCallback onAbilityContinue ability:" + JSON.stringify(ability));
onAbilityBackground(ability){ }
console.log("AbilityLifecycleCallback onAbilityBackground ability:" + JSON.stringify(ability)); }
},
onAbilityContinue(ability){ export default class MyAbility extends UIAbility {
console.log("AbilityLifecycleCallback onAbilityContinue ability:" + JSON.stringify(ability)); onCreate() {
} console.log("MyAbility onCreate")
} // 1.通过context属性获取applicationContext
// 1.通过context属性获取applicationContext let applicationContext = this.context.getApplicationContext();
let applicationContext = this.context.getApplicationContext(); // 2.通过applicationContext注册监听应用内生命周期
// 2.通过applicationContext注册监听应用内生命周期 globalThis.lifecycleid = applicationContext.on("abilityLifecycle", abilityLifecycleCallback);
let lifecycleid = applicationContext.on("abilityLifecycle", AbilityLifecycleCallback); console.log("registerAbilityLifecycleCallback number: " + JSON.stringify(lifecycleid));
console.log("registerAbilityLifecycleCallback number: " + JSON.stringify(lifecycleid)); },
}, onDestroy() {
onDestroy() { let applicationContext = this.context.getApplicationContext();
let applicationContext = this.context.getApplicationContext(); // 3.通过applicationContext注销监听应用内生命周期
applicationContext.off("abilityLifecycle", lifecycleid, (error, data) => { applicationContext.off("abilityLifecycle", globalThis.lifecycleid, (error, data) => {
console.log("unregisterAbilityLifecycleCallback success, err: " + JSON.stringify(error)); console.log("unregisterAbilityLifecycleCallback success, err: " + JSON.stringify(error));
}); });
}
} }
``` }
\ No newline at end of file ```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
浏览文件 @ 473bc686
...@@ -15,7 +15,7 @@ import abilityManager from '@ohos.app.ability.abilityManager' ...@@ -15,7 +15,7 @@ import abilityManager from '@ohos.app.ability.abilityManager'
## AbilityState ## AbilityState
Ability的状态信息。 Ability的状态，该类型为枚举，可配合[AbilityRunningInfo](js-apis-inner-application-abilityRunningInfo.md)返回Abiltiy的状态。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -23,15 +23,15 @@ Ability的状态信息。 ...@@ -23,15 +23,15 @@ Ability的状态信息。
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| -------- | -------- | -------- | | -------- | -------- | -------- |
| INITIAL | 0 | 表示ability为initial状态。| | INITIAL | 0 | 表示ability为初始化状态。|
| FOREGROUND | 9 | 表示ability为foreground状态。 | | FOREGROUND | 9 | 表示ability为前台状态。 |
| BACKGROUND | 10 | 表示ability为background状态。 | | BACKGROUND | 10 | 表示ability为后台状态。 |
| FOREGROUNDING | 11 | 表示ability为foregrounding状态。 | | FOREGROUNDING | 11 | 表示ability为前台调度中状态。 |
| BACKGROUNDING | 12 | 表示ability为backgrounding状态。 | | BACKGROUNDING | 12 | 表示ability为后台调度中状态。 |
## updateConfiguration ## updateConfiguration
updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void updateConfiguration(config: [Configuration](js-apis-app-ability-configuration.md), callback: AsyncCallback\<void>): void
通过修改配置来更新配置（callback形式）。 通过修改配置来更新配置（callback形式）。
...@@ -43,14 +43,19 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void ...@@ -43,14 +43,19 @@ 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> | 是 | 被指定的回调方法。 |
**示例**： **示例**：
```ts ```ts
var config = { var config = {
language: 'chinese' language: 'chinese',
colorMode: COLOR_MODE_LIGHT,
direction: DIRECTION_VERTICAL,
screenDensity: SCREEN_DENSITY_SDPI,
displayId: 1,
hasPointerDevice: true,
} }
try { try {
...@@ -65,7 +70,7 @@ try { ...@@ -65,7 +70,7 @@ try {
## updateConfiguration ## updateConfiguration
updateConfiguration(config: Configuration): Promise\<void> updateConfiguration(config: [Configuration](js-apis-app-ability-configuration.md)): Promise\<void>
通过修改配置来更新配置（Promise形式）。 通过修改配置来更新配置（Promise形式）。
...@@ -77,7 +82,7 @@ updateConfiguration(config: Configuration): Promise\<void> ...@@ -77,7 +82,7 @@ updateConfiguration(config: Configuration): Promise\<void>
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项。 | | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项，仅需配置需要更新的项。 |
**返回值：** **返回值：**
...@@ -89,7 +94,12 @@ updateConfiguration(config: Configuration): Promise\<void> ...@@ -89,7 +94,12 @@ updateConfiguration(config: Configuration): Promise\<void>
```ts ```ts
var config = { var config = {
language: 'chinese' language: 'chinese',
colorMode: COLOR_MODE_LIGHT,
direction: DIRECTION_VERTICAL,
screenDensity: SCREEN_DENSITY_SDPI,
displayId: 1,
hasPointerDevice: true,
} }
try { try {
...@@ -106,7 +116,7 @@ try { ...@@ -106,7 +116,7 @@ try {
## getAbilityRunningInfos ## getAbilityRunningInfos
getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): void getAbilityRunningInfos(callback: AsyncCallback\<Array\<[AbilityRunningInfo](js-apis-inner-application-abilityRunningInfo.md)>>): void
获取Ability运行相关信息（callback形式）。 获取Ability运行相关信息（callback形式）。
...@@ -118,7 +128,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo ...@@ -118,7 +128,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 | | callback | AsyncCallback\<Array\<[AbilityRunningInfo](js-apis-inner-application-abilityRunningInfo.md)>> | 是 | 被指定的回调方法，返回运行中的ability信息。 |
**示例**： **示例**：
...@@ -135,7 +145,7 @@ try { ...@@ -135,7 +145,7 @@ try {
## getAbilityRunningInfos ## getAbilityRunningInfos
getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>> getAbilityRunningInfos(): Promise\<Array\<[AbilityRunningInfo](js-apis-inner-application-abilityRunningInfo.md)>>
获取Ability运行相关信息（Promise形式）。 获取Ability运行相关信息（Promise形式）。
...@@ -147,7 +157,7 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>> ...@@ -147,7 +157,7 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------------------- | ------- | | ---------------------------------------- | ------- |
| Promise\<Array\<AbilityRunningInfo>> | 返回执行结果。 | | Promise\<Array\<[AbilityRunningInfo](js-apis-inner-application-abilityRunningInfo.md)>> | 返回运行中的ability信息。 |
**示例**： **示例**：
...@@ -166,7 +176,7 @@ try { ...@@ -166,7 +176,7 @@ try {
## getExtensionRunningInfos ## getExtensionRunningInfos
getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<ExtensionRunningInfo>>): void getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<[ExtensionRunningInfo](js-apis-inner-application-extensionRunningInfo.md)>>): void
获取关于运行扩展能力的信息（callback形式）。 获取关于运行扩展能力的信息（callback形式）。
...@@ -179,7 +189,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext ...@@ -179,7 +189,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 | | upperLimit | number | 是 | 获取消息数量的最大限制。 |
| callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 | | callback | AsyncCallback\<Array\<[ExtensionRunningInfo](js-apis-inner-application-extensionRunningInfo.md)>> | 是 | 被指定的回调方法，返回运行中的extension信息。 |
**示例**： **示例**：
...@@ -198,7 +208,7 @@ try { ...@@ -198,7 +208,7 @@ try {
## getExtensionRunningInfos ## getExtensionRunningInfos
getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningInfo>> getExtensionRunningInfos(upperLimit: number): Promise\<Array\<[ExtensionRunningInfo](js-apis-inner-application-extensionRunningInfo.md)>>
获取关于运行扩展能力的信息（Promise形式）。 获取关于运行扩展能力的信息（Promise形式）。
...@@ -216,7 +226,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn ...@@ -216,7 +226,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------------------- | ------- | | ---------------------------------------- | ------- |
| Promise\<Array\<AbilityRunningInfo>> | 返回执行结果。 | | Promise\<Array\<[ExtensionRunningInfo](js-apis-inner-application-extensionRunningInfo.md)>> | 返回运行中的extension信息。 |
**示例**： **示例**：
...@@ -225,9 +235,9 @@ var upperLimit = 0; ...@@ -225,9 +235,9 @@ var upperLimit = 0;
try { try {
abilityManager.getExtensionRunningInfos(upperLimit).then((data) => { abilityManager.getExtensionRunningInfos(upperLimit).then((data) => {
console.log("getAbilityRunningInfos data: " + JSON.stringify(data)); console.log("getExtensionRunningInfos data: " + JSON.stringify(data));
}).catch((err) => { }).catch((err) => {
console.log("getAbilityRunningInfos err: " + err); console.log("getExtensionRunningInfos err: " + err);
}) })
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) + console.log('error.code: ' + JSON.stringify(paramError.code) +
...@@ -237,7 +247,7 @@ try { ...@@ -237,7 +247,7 @@ try {
## getTopAbility<sup>9+</sup> ## getTopAbility<sup>9+</sup>
getTopAbility(callback: AsyncCallback\<ElementName>): void; getTopAbility(callback: AsyncCallback\<[ElementName](js-apis-bundleManager-elementName.md)>): void;
获取窗口焦点的ability接口（callback形式）。 获取窗口焦点的ability接口（callback形式）。
...@@ -247,7 +257,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void; ...@@ -247,7 +257,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\<ElementName> | 是 | 被指定的回调方法。 | | callback | AsyncCallback\<[ElementName](js-apis-bundleManager-elementName.md)> | 是 | 被指定的回调方法，返回目前获焦窗口的应用名。 |
**示例**： **示例**：
...@@ -259,7 +269,7 @@ abilityManager.getTopAbility((err,data) => { ...@@ -259,7 +269,7 @@ abilityManager.getTopAbility((err,data) => {
## getTopAbility ## getTopAbility
getTopAbility(): Promise\<ElementName>; getTopAbility(): Promise\<[ElementName](js-apis-bundleManager-elementName.md)>;
获取窗口焦点的ability接口（Promise形式）。 获取窗口焦点的ability接口（Promise形式）。
...@@ -269,7 +279,7 @@ getTopAbility(): Promise\<ElementName>; ...@@ -269,7 +279,7 @@ getTopAbility(): Promise\<ElementName>;
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------------------- | ------- | | ---------------------------------------- | ------- |
| Promise\<ElementName>| 返回执行结果。 | | Promise\<[ElementName](js-apis-bundleManager-elementName.md)>| 返回目前获焦窗口的应用名。 |
**示例**： **示例**：
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md
浏览文件 @ 473bc686
...@@ -25,18 +25,18 @@ onCreate(): void ...@@ -25,18 +25,18 @@ onCreate(): void
**示例：** **示例：**
```ts ```ts
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onCreate() { onCreate() {
console.log("MyAbilityStage.onCreate is called") console.log("MyAbilityStage.onCreate is called")
} }
} }
``` ```
## AbilityStage.onAcceptWant ## AbilityStage.onAcceptWant
onAcceptWant(want: Want): string; onAcceptWant(want: [Want](js-apis-app-ability-want.md)): string;
启动一个specified ability时触发的事件。 启动一个specified ability时触发的事件。
...@@ -56,19 +56,19 @@ onAcceptWant(want: Want): string; ...@@ -56,19 +56,19 @@ onAcceptWant(want: Want): string;
**示例：** **示例：**
```ts ```ts
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onAcceptWant(want) { onAcceptWant(want) {
console.log("MyAbilityStage.onAcceptWant called"); console.log("MyAbilityStage.onAcceptWant called");
return "com.example.test"; return "com.example.test";
} }
} }
``` ```
## AbilityStage.onConfigurationUpdate ## AbilityStage.onConfigurationUpdate
onConfigurationUpdate(newConfig: Configuration): void; onConfigurationUpdate(newConfig: [Configuration](js-apis-app-ability-configuration.md)): void;
环境变化通知接口，发生全局配置变更时回调。 环境变化通知接口，发生全局配置变更时回调。
...@@ -82,17 +82,17 @@ onConfigurationUpdate(newConfig: Configuration): void; ...@@ -82,17 +82,17 @@ onConfigurationUpdate(newConfig: Configuration): void;
**示例：** **示例：**
```ts ```ts
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onConfigurationUpdate(config) { onConfigurationUpdate(config) {
console.log('onConfigurationUpdate, language:' + config.language); console.log('onConfigurationUpdate, language:' + config.language);
} }
} }
``` ```
## AbilityStage.onMemoryLevel ## AbilityStage.onMemoryLevel
onMemoryLevel(level: AbilityConstant.MemoryLevel): void; onMemoryLevel(level: [AbilityConstant.MemoryLevel](js-apis-app-ability-abilityConstant.md#abilityconstantmemorylevel)): void;
当系统已决定调整内存时调用。例如，当该功能在后台运行时，没有足够的内存来运行尽可能多的后台进程时可以使用。 当系统已决定调整内存时调用。例如，当该功能在后台运行时，没有足够的内存来运行尽可能多的后台进程时可以使用。
...@@ -106,17 +106,17 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; ...@@ -106,17 +106,17 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
**示例：** **示例：**
```ts ```ts
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onMemoryLevel(level) { onMemoryLevel(level) {
console.log('onMemoryLevel, level:' + JSON.stringify(level)); console.log('onMemoryLevel, level:' + JSON.stringify(level));
} }
} }
``` ```
## AbilityStage.context ## AbilityStage.context
context: AbilityStageContext; context: [AbilityStageContext](js-apis-inner-application-abilityStageContext.md);
指示有关上下文的配置信息。 指示有关上下文的配置信息。
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md
浏览文件 @ 473bc686
...@@ -24,16 +24,16 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -24,16 +24,16 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 返回当前是否处于稳定性测试场景。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 返回当前是否处于稳定性测试场景。true: 处于稳定性测试场景，false：处于非稳定性测试场景。 |
**示例：** **示例：**
```ts ```ts
appManager.isRunningInStabilityTest((err, flag) => { appManager.isRunningInStabilityTest((err, flag) => {
console.log('error:' + JSON.stringify(err)); console.log('error:' + JSON.stringify(err));
console.log('The result of isRunningInStabilityTest is:' + JSON.stringify(flag)); console.log('The result of isRunningInStabilityTest is:' + JSON.stringify(flag));
}) })
``` ```
## appManager.isRunningInStabilityTest ## appManager.isRunningInStabilityTest
...@@ -48,17 +48,17 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt; ...@@ -48,17 +48,17 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt;
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | 返回当前是否处于稳定性测试场景。 | | Promise&lt;boolean&gt; | 返回当前是否处于稳定性测试场景。true: 处于稳定性测试场景，false：处于非稳定性测试场景。 |
**示例：** **示例：**
```ts ```ts
appManager.isRunningInStabilityTest().then((flag) => { appManager.isRunningInStabilityTest().then((flag) => {
console.log('The result of isRunningInStabilityTest is:' + JSON.stringify(flag)); console.log('The result of isRunningInStabilityTest is:' + JSON.stringify(flag));
}).catch((error) => { }).catch((error) => {
console.log('error:' + JSON.stringify(error)); console.log('error:' + JSON.stringify(error));
}); });
``` ```
## appManager.isRamConstrainedDevice ## appManager.isRamConstrainedDevice
...@@ -73,17 +73,17 @@ isRamConstrainedDevice(): Promise\<boolean>; ...@@ -73,17 +73,17 @@ isRamConstrainedDevice(): Promise\<boolean>;
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | 是否为ram受限设备。 | | Promise&lt;boolean&gt; | 是否为ram受限设备。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。 |
**示例：** **示例：**
```ts ```ts
appManager.isRamConstrainedDevice().then((data) => { appManager.isRamConstrainedDevice().then((data) => {
console.log('The result of isRamConstrainedDevice is:' + JSON.stringify(data)); console.log('The result of isRamConstrainedDevice is:' + JSON.stringify(data));
}).catch((error) => { }).catch((error) => {
console.log('error:' + JSON.stringify(error)); console.log('error:' + JSON.stringify(error));
}); });
``` ```
## appManager.isRamConstrainedDevice ## appManager.isRamConstrainedDevice
...@@ -97,16 +97,16 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void; ...@@ -97,16 +97,16 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 返回当前是否是ram受限设备。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 返回当前是否是ram受限设备。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。 |
**示例：** **示例：**
```ts ```ts
appManager.isRamConstrainedDevice((err, data) => { appManager.isRamConstrainedDevice((err, data) => {
console.log('error:' + JSON.stringify(err)); console.log('error:' + JSON.stringify(err));
console.log('The result of isRamConstrainedDevice is:' + JSON.stringify(data)); console.log('The result of isRamConstrainedDevice is:' + JSON.stringify(data));
}) })
``` ```
## appManager.getAppMemorySize ## appManager.getAppMemorySize
...@@ -124,13 +124,13 @@ getAppMemorySize(): Promise\<number>; ...@@ -124,13 +124,13 @@ getAppMemorySize(): Promise\<number>;
**示例：** **示例：**
```ts ```ts
appManager.getAppMemorySize().then((data) => { appManager.getAppMemorySize().then((data) => {
console.log('The size of app memory is:' + JSON.stringify(data)); console.log('The size of app memory is:' + JSON.stringify(data));
}).catch((error) => { }).catch((error) => {
console.log('error:' + JSON.stringify(error)); console.log('error:' + JSON.stringify(error));
}); });
``` ```
## appManager.getAppMemorySize ## appManager.getAppMemorySize
...@@ -148,16 +148,16 @@ getAppMemorySize(callback: AsyncCallback\<number>): void; ...@@ -148,16 +148,16 @@ getAppMemorySize(callback: AsyncCallback\<number>): void;
**示例：** **示例：**
```ts ```ts
appManager.getAppMemorySize((err, data) => { appManager.getAppMemorySize((err, data) => {
console.log('error:' + JSON.stringify(err)); console.log('error:' + JSON.stringify(err));
console.log('The size of app memory is:' + JSON.stringify(data)); console.log('The size of app memory is:' + JSON.stringify(data));
}) })
``` ```
## appManager.getProcessRunningInformation<sup>9+</sup> ## appManager.getProcessRunningInformation<sup>9+</sup>
getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>; getProcessRunningInformation(): Promise\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>>;
获取有关运行进程的信息。 获取有关运行进程的信息。
...@@ -175,17 +175,17 @@ getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>; ...@@ -175,17 +175,17 @@ getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>;
**示例：** **示例：**
```ts ```ts
appManager.getProcessRunningInformation().then((data) => { appManager.getProcessRunningInformation().then((data) => {
console.log('The process running infomation is:' + JSON.stringify(data)); console.log('The process running information is:' + JSON.stringify(data));
}).catch((error) => { }).catch((error) => {
console.log('error:' + JSON.stringify(error)); console.log('error:' + JSON.stringify(error));
}); });
``` ```
## appManager.getProcessRunningInformation<sup>9+</sup> ## appManager.getProcessRunningInformation<sup>9+</sup>
getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInformation>>): void; getProcessRunningInformation(callback: AsyncCallback\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>>): void;
获取有关运行进程的信息。 获取有关运行进程的信息。
...@@ -203,16 +203,16 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor ...@@ -203,16 +203,16 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor
**示例：** **示例：**
```ts ```ts
appManager.getProcessRunningInformation((err, data) => { appManager.getProcessRunningInformation((err, data) => {
console.log('error :' + JSON.stringify(err)); console.log('error :' + JSON.stringify(err));
console.log('The process running information is:' + JSON.stringify(data)); console.log('The process running information is:' + JSON.stringify(data));
}) })
``` ```
## appManager.on ## appManager.on
on(type: "applicationState", observer: ApplicationStateObserver): number; on(type: "applicationState", observer: [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md)): number;
注册全部应用程序状态观测器。 注册全部应用程序状态观测器。
...@@ -226,13 +226,13 @@ on(type: "applicationState", observer: ApplicationStateObserver): number; ...@@ -226,13 +226,13 @@ on(type: "applicationState", observer: ApplicationStateObserver): number;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 | | type | string | 是 | 调用接口类型，固定填"applicationState"字符串。 |
| observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | 是 | 返回观察者的数字代码。 | | observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | 是 | 返回观测器的数字代码ID。 |
**示例：** **示例：**
```js ```js
var applicationStateObserver = { var applicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log('------------ onForegroundApplicationChanged -----------', appStateData); console.log('------------ onForegroundApplicationChanged -----------', appStateData);
}, },
...@@ -248,19 +248,18 @@ on(type: "applicationState", observer: ApplicationStateObserver): number; ...@@ -248,19 +248,18 @@ on(type: "applicationState", observer: ApplicationStateObserver): number;
onProcessStateChanged(processData) { onProcessStateChanged(processData) {
console.log('------------ onProcessStateChanged -----------', processData); console.log('------------ onProcessStateChanged -----------', processData);
} }
} }
try { try {
const observerCode = appManager.on(applicationStateObserver); const observerCode = appManager.on(applicationStateObserver);
console.log('-------- observerCode: ---------', observerCode); console.log('-------- observerCode: ---------', observerCode);
} catch (paramError) { } catch (paramError) {
console.log('error: ' + paramError.code + ', ' + paramError.message); console.log('error: ' + paramError.code + ', ' + paramError.message);
} }
```
```
## appManager.on ## appManager.on
on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList: Array\<string>): number; on(type: "applicationState", observer: [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md), bundleNameList: Array\<string>): number;
注册指定应用程序状态观测器。 注册指定应用程序状态观测器。
...@@ -274,8 +273,8 @@ on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList: ...@@ -274,8 +273,8 @@ on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList:
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 | | type | string | 是 | 调用接口类型，固定填"applicationState"字符串。 |
| observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | 是 | 返回观察者的数字代码。 | | observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | 是 | 返回观测器的数字代码ID。 |
| bundleNameList | Array<string> | 是 | 表示需要注册监听的bundleName数组。最大值128。 | | bundleNameList | Array<string> | 是 | 表示需要注册监听的bundleName数组。最大值128。 |
**示例：** **示例：**
...@@ -323,26 +322,26 @@ off(type: "applicationState", observerId: number, callback: AsyncCallback\<void ...@@ -323,26 +322,26 @@ off(type: "applicationState", observerId: number, callback: AsyncCallback\<void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 | | type | string | 是 | 调用接口类型，固定填"applicationState"字符串。 |
| observerId | number | 是 | 表示观察者的编号代码。 | | observerId | number | 是 | 表示观测器的编号代码。 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 | | callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例：** **示例：**
```js ```ts
var observerId = 100; var observerId = 100;
function unregisterApplicationStateObserverCallback(err) { function unregisterApplicationStateObserverCallback(err) {
if (err) { if (err) {
console.log('------------ unregisterApplicationStateObserverCallback ------------', err); console.log('------------ unregisterApplicationStateObserverCallback ------------', err);
}
}
try {
appManager.off(observerId, unregisterApplicationStateObserverCallback);
} catch (paramError) {
console.log('error: ' + paramError.code + ', ' + paramError.message);
} }
``` }
try {
appManager.off(observerId, unregisterApplicationStateObserverCallback);
} catch (paramError) {
console.log('error: ' + paramError.code + ', ' + paramError.message);
}
```
## appManager.off ## appManager.off
...@@ -360,8 +359,8 @@ off(type: "applicationState", observerId: number): Promise\<void>; ...@@ -360,8 +359,8 @@ off(type: "applicationState", observerId: number): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 | | type | string | 是 | 调用接口类型，固定填"applicationState"字符串。 |
| observerId | number | 是 | 表示观察者的编号代码。 | | observerId | number | 是 | 表示观测器的编号代码。 |
**返回值：** **返回值：**
...@@ -371,25 +370,23 @@ off(type: "applicationState", observerId: number): Promise\<void>; ...@@ -371,25 +370,23 @@ off(type: "applicationState", observerId: number): Promise\<void>;
**示例：** **示例：**
```js ```ts
var observerId = 100; var observerId = 100;
try { try {
appManager.off(observerId) appManager.off(observerId).then((data) => {
.then((data) => { console.log('----------- unregisterApplicationStateObserver success ----------', data);
console.log('----------- unregisterApplicationStateObserver success ----------', data); }).catch((err) => {
}) console.log('----------- unregisterApplicationStateObserver fail ----------', err);
.catch((err) => { })
console.log('----------- unregisterApplicationStateObserver fail ----------', err); } catch (paramError) {
}) console.log('error: ' + paramError.code + ', ' + paramError.message);
} catch (paramError) { }
console.log('error: ' + paramError.code + ', ' + paramError.message); ```
}
```
## appManager.getForegroundApplications ## appManager.getForegroundApplications
getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; getForegroundApplications(callback: AsyncCallback\<Array\<[AppStateData](js-apis-inner-application-appStateData.md)>>): void;
获取前台进程的应用程序。 获取前台进程的应用程序。
...@@ -403,67 +400,28 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; ...@@ -403,67 +400,28 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<AppStateData>> | 是 | 表示应用的状态数据。 | | callback | AsyncCallback\<Array\<[AppStateData](js-apis-inner-application-appStateData.md)>> | 是 | 表示应用的状态数据。 |
**示例：** **示例：**
```js ```ts
function getForegroundApplicationsCallback(err, data) { function getForegroundApplicationsCallback(err, data) {
if (err) { if (err) {
console.log('--------- getForegroundApplicationsCallback fail ---------', err.code + ': ' + err.message); console.log('--------- getForegroundApplicationsCallback fail ---------', err.code + ': ' + err.message);
} else { } else {
console.log('--------- getForegroundApplicationsCallback success ---------', data) console.log('--------- getForegroundApplicationsCallback success ---------', data)
} }
} }
try { try {
appManager.getForegroundApplications(getForegroundApplicationsCallback); appManager.getForegroundApplications(getForegroundApplicationsCallback);
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message);
}
```
unregisterApplicationStateObserver(observerId: number): Promise\<void>;
取消注册应用程序状态观测器。
**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：该接口为系统接口，三方应用不支持调用。
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| observerId | number | 是 | 表示观察者的编号代码。 |
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| Promise\<void> | 返回执行结果。 |
**示例：**
```ts
var observerId = 100;
try {
appManager.unregisterApplicationStateObserver(observerId)
.then((data) => {
console.log('----------- unregisterApplicationStateObserver success ----------', data);
})
.catch((err) => {
console.log('----------- unregisterApplicationStateObserver fail ----------', err);
})
} catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log("error: " + paramError.code + ", " + paramError.message);
} }
``` ```
## appManager.getForegroundApplications ## appManager.getForegroundApplications
getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; getForegroundApplications(callback: AsyncCallback\<Array\<[AppStateData](js-apis-inner-application-appStateData.md)>>): void;
获取前台进程的应用程序。 获取前台进程的应用程序。
...@@ -477,28 +435,28 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; ...@@ -477,28 +435,28 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<AppStateData>> | 是 | 表示应用的状态数据。 | | callback | AsyncCallback\<Array\<[AppStateData](js-apis-inner-application-appStateData.md)>> | 是 | 表示应用的状态数据。 |
**示例：** **示例：**
```ts ```ts
function getForegroundApplicationsCallback(err, data) { function getForegroundApplicationsCallback(err, data) {
if (err) { if (err) {
console.log('--------- getForegroundApplicationsCallback fail ---------', err); console.log('--------- getForegroundApplicationsCallback fail ---------', err);
} else { } else {
console.log('--------- getForegroundApplicationsCallback success ---------', data) console.log('--------- getForegroundApplicationsCallback success ---------', data)
} }
} }
try { try {
appManager.getForegroundApplications(getForegroundApplicationsCallback); appManager.getForegroundApplications(getForegroundApplicationsCallback);
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log("error: " + paramError.code + ", " + paramError.message);
} }
``` ```
## appManager.getForegroundApplications ## appManager.getForegroundApplications
getForegroundApplications(): Promise\<Array\<AppStateData>>; getForegroundApplications(): Promise\<Array\<[AppStateData](js-apis-inner-application-appStateData.md)>>;
获取前台进程的应用程序。 获取前台进程的应用程序。
...@@ -512,19 +470,17 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>; ...@@ -512,19 +470,17 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>;
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise\<Array\<ProcessRunningInfo>> | 返回进程运行信息的数组。 | | Promise\<Array\<[AppStateData](js-apis-inner-application-appStateData.md)>> | 返回前台进程应用程序的数组。 |
**示例：** **示例：**
```ts ```ts
appManager.getForegroundApplications() appManager.getForegroundApplications().then((data) => {
.then((data) => { console.log('--------- getForegroundApplications success -------', data);
console.log('--------- getForegroundApplications success -------', data); }).catch((err) => {
}) console.log('--------- getForegroundApplications fail -------', err);
.catch((err) => { })
console.log('--------- getForegroundApplications fail -------', err); ```
})
```
## appManager.killProcessWithAccount ## appManager.killProcessWithAccount
...@@ -551,15 +507,13 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\> ...@@ -551,15 +507,13 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\>
var bundleName = 'bundleName'; var bundleName = 'bundleName';
var accountId = 0; var accountId = 0;
try { try {
appManager.killProcessWithAccount(bundleName, accountId) appManager.killProcessWithAccount(bundleName, accountId).then((data) => {
.then((data) => { console.log('------------ killProcessWithAccount success ------------', data);
console.log('------------ killProcessWithAccount success ------------', data); }).catch((err) => {
}) console.log('------------ killProcessWithAccount fail ------------', err);
.catch((err) => { })
console.log('------------ killProcessWithAccount fail ------------', err);
})
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log("error: " + paramError.code + ", " + paramError.message);
} }
``` ```
...@@ -590,11 +544,11 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal ...@@ -590,11 +544,11 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal
var bundleName = 'bundleName'; var bundleName = 'bundleName';
var accountId = 0; var accountId = 0;
function killProcessWithAccountCallback(err, data) { function killProcessWithAccountCallback(err, data) {
if (err) { if (err) {
console.log('------------- killProcessWithAccountCallback fail, err: --------------', err); console.log('------------- killProcessWithAccountCallback fail, err: --------------', err);
} else { } else {
console.log('------------- killProcessWithAccountCallback success, data: --------------', data); console.log('------------- killProcessWithAccountCallback success, data: --------------', data);
} }
} }
appManager.killProcessWithAccount(bundleName, accountId, killProcessWithAccountCallback); appManager.killProcessWithAccount(bundleName, accountId, killProcessWithAccountCallback);
``` ```
...@@ -620,21 +574,21 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>); ...@@ -620,21 +574,21 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
**示例：** **示例：**
```ts ```ts
var bundleName = 'bundleName'; var bundleName = 'bundleName';
function killProcessesByBundleNameCallback(err, data) { function killProcessesByBundleNameCallback(err, data) {
if (err) { if (err) {
console.log('------------- killProcessesByBundleNameCallback fail, err: --------------', err); console.log('------------- killProcessesByBundleNameCallback fail, err: --------------', err);
} else { } else {
console.log('------------- killProcessesByBundleNameCallback success, data: --------------', data); console.log('------------- killProcessesByBundleNameCallback success, data: --------------', data);
} }
} }
try { try {
appManager.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback); appManager.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback);
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log("error: " + paramError.code + ", " + paramError.message);
} }
``` ```
## appManager.killProcessesByBundleName ## appManager.killProcessesByBundleName
...@@ -652,7 +606,7 @@ killProcessesByBundleName(bundleName: string): Promise\<void>; ...@@ -652,7 +606,7 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 表示包名。 | | bundleName | string | 是 | 表示应用包名。 |
**返回值：** **返回值：**
...@@ -662,20 +616,18 @@ killProcessesByBundleName(bundleName: string): Promise\<void>; ...@@ -662,20 +616,18 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
**示例：** **示例：**
```ts ```ts
var bundleName = 'bundleName'; var bundleName = 'bundleName';
try { try {
appManager.killProcessesByBundleName(bundleName) appManager.killProcessesByBundleName(bundleName).then((data) => {
.then((data) => { console.log('------------ killProcessesByBundleName success ------------', data);
console.log('------------ killProcessesByBundleName success ------------', data); }).catch((err) => {
}) console.log('------------ killProcessesByBundleName fail ------------', err);
.catch((err) => {
console.log('------------ killProcessesByBundleName fail ------------', err);
}) })
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log("error: " + paramError.code + ", " + paramError.message);
} }
``` ```
## appManager.clearUpApplicationData ## appManager.clearUpApplicationData
...@@ -698,21 +650,21 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>); ...@@ -698,21 +650,21 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
**示例：** **示例：**
```ts ```ts
var bundleName = 'bundleName'; var bundleName = 'bundleName';
function clearUpApplicationDataCallback(err, data) { function clearUpApplicationDataCallback(err, data) {
if (err) { if (err) {
console.log('------------- clearUpApplicationDataCallback fail, err: --------------', err); console.log('------------- clearUpApplicationDataCallback fail, err: --------------', err);
} else { } else {
console.log('------------- clearUpApplicationDataCallback success, data: --------------', data); console.log('------------- clearUpApplicationDataCallback success, data: --------------', data);
} }
} }
try { try {
appManager.clearUpApplicationData(bundleName, clearUpApplicationDataCallback); appManager.clearUpApplicationData(bundleName, clearUpApplicationDataCallback);
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log("error: " + paramError.code + ", " + paramError.message);
} }
``` ```
## appManager.clearUpApplicationData ## appManager.clearUpApplicationData
...@@ -740,23 +692,23 @@ clearUpApplicationData(bundleName: string): Promise\<void>; ...@@ -740,23 +692,23 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
**示例：** **示例：**
```ts ```ts
var bundleName = 'bundleName'; var bundleName = 'bundleName';
try { try {
appManager.clearUpApplicationData(bundleName) appManager.clearUpApplicationData(bundleName).then((data) => {
.then((data) => {
console.log('------------ clearUpApplicationData success ------------', data); console.log('------------ clearUpApplicationData success ------------', data);
}) }).catch((err) => {
.catch((err) => {
console.log('------------ clearUpApplicationData fail ------------', err); console.log('------------ clearUpApplicationData fail ------------', err);
}) })
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log("error: " + paramError.code + ", " + paramError.message);
} }
``` ```
## ApplicationState ## ApplicationState
应用状态，该类型为枚举，可配合[AbilityStateData](js-apis-inner-application-appStateData.md)返回相应的应用状态。
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
...@@ -771,6 +723,8 @@ clearUpApplicationData(bundleName: string): Promise\<void>; ...@@ -771,6 +723,8 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
## ProcessState ## ProcessState
进程状态，该类型为枚举，可配合[ProcessData](js-apis-inner-application-processData.md)返回相应的进程状态。
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md
浏览文件 @ 473bc686
...@@ -14,7 +14,7 @@ import appRecovery from '@ohos.app.ability.appRecovery' ...@@ -14,7 +14,7 @@ import appRecovery from '@ohos.app.ability.appRecovery'
## appRecovery.RestartFlag ## appRecovery.RestartFlag
[enableAppRecovery](#apprecoveryenableapprecovery)接口重启选项参数。 应用重启标志，[enableAppRecovery](#apprecoveryenableapprecovery)接口重启选项参数，该类型为枚举。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -28,7 +28,7 @@ import appRecovery from '@ohos.app.ability.appRecovery' ...@@ -28,7 +28,7 @@ import appRecovery from '@ohos.app.ability.appRecovery'
## appRecovery.SaveOccasionFlag ## appRecovery.SaveOccasionFlag
[enableAppRecovery](#apprecoveryenableapprecovery)接口状态保存时机选项参数。 保存条件标志，[enableAppRecovery](#apprecoveryenableapprecovery)接口状态保存时的选项参数，该类型为枚举。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -39,7 +39,7 @@ import appRecovery from '@ohos.app.ability.appRecovery' ...@@ -39,7 +39,7 @@ import appRecovery from '@ohos.app.ability.appRecovery'
## appRecovery.SaveModeFlag ## appRecovery.SaveModeFlag
[enableAppRecovery](#apprecoveryenableapprecovery)接口状态保存方式的参数。 状态保存标志，[enableAppRecovery](#apprecoveryenableapprecovery)接口状态保存方式的参数，该类型为枚举。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -50,7 +50,7 @@ import appRecovery from '@ohos.app.ability.appRecovery' ...@@ -50,7 +50,7 @@ import appRecovery from '@ohos.app.ability.appRecovery'
## appRecovery.enableAppRecovery ## appRecovery.enableAppRecovery
enableAppRecovery(restart?: RestartFlag, saveOccasion?: SaveOccasionFlag, saveMode?: SaveModeFlag) : void; enableAppRecovery(restart?: [RestartFlag](#apprecoveryrestartflag), saveOccasion?: [SaveOccasionFlag](#apprecoverysaveoccasionflag), saveMode?: [SaveModeFlag](#apprecoverysavemodeflag)) : void;
使能应用恢复功能，参数按顺序填入。 使能应用恢复功能，参数按顺序填入。
...@@ -60,9 +60,9 @@ enableAppRecovery(restart?: RestartFlag, saveOccasion?: SaveOccasionFlag, saveMo ...@@ -60,9 +60,9 @@ enableAppRecovery(restart?: RestartFlag, saveOccasion?: SaveOccasionFlag, saveMo
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| restart | [RestartFlag](#apprecoveryrestartflag) | 否 | 发生对应故障时是否重启，默认为不重启。 | | restart | [RestartFlag](#apprecoveryrestartflag) | 否 | 枚举类型，发生对应故障时是否重启，默认为不重启。 |
| saveOccasion | [SaveOccasionFlag](#apprecoverysaveoccasionflag) | 否 | 状态保存时机，默认为故障时保存。 | | saveOccasion | [SaveOccasionFlag](#apprecoverysaveoccasionflag) | 否 | 枚举类型，状态保存时机，默认为故障时保存。 |
| saveMode | [SaveModeFlag](#apprecoverysavemodeflag) | 否 | 状态保存方式， 默认为文件缓存。 | | saveMode | [SaveModeFlag](#apprecoverysavemodeflag) | 否 | 枚举类型，状态保存方式， 默认为文件缓存。 |
**示例：** **示例：**
...@@ -94,7 +94,6 @@ var observer = { ...@@ -94,7 +94,6 @@ var observer = {
appRecovery.restartApp(); appRecovery.restartApp();
} }
} }
``` ```
## appRecovery.saveAppState ## appRecovery.saveAppState
...@@ -109,7 +108,7 @@ saveAppState(): boolean; ...@@ -109,7 +108,7 @@ saveAppState(): boolean;
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| boolean | 保存成功与否。 | | boolean | 保存成功与否。true：保存成功，false：保存失败。 |
**示例：** **示例：**
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或