Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
437a6d82
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
437a6d82
编写于
1月 30, 2023
作者:
O
openharmony_ci
提交者:
Gitee
1月 30, 2023
浏览文件
操作
浏览文件
下载
差异文件
!13331 【挑单monthly】【元能力】abilityManager、appManager错误码
Merge pull request !13331 from donglin/monthly
上级
19d0e8d3
8e0f8d4a
变更
7
展开全部
显示空白变更内容
内联
并排
Showing
7 changed file
with
1122 addition
and
570 deletion
+1122
-570
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
...dev/reference/apis/js-apis-app-ability-abilityConstant.md
+126
-26
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md
...ence/apis/js-apis-app-ability-abilityDelegatorRegistry.md
+26
-9
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md
...ence/apis/js-apis-app-ability-abilityLifecycleCallback.md
+157
-65
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
...-dev/reference/apis/js-apis-app-ability-abilityManager.md
+174
-94
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md
...on-dev/reference/apis/js-apis-app-ability-abilityStage.md
+40
-32
zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md
...tion-dev/reference/apis/js-apis-app-ability-appManager.md
+560
-330
zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md
...ion-dev/reference/apis/js-apis-app-ability-appRecovery.md
+39
-14
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
浏览文件 @
437a6d82
# @ohos.app.ability.AbilityConstant (AbilityConstant)
# @ohos.app.ability.AbilityConstant (AbilityConstant)
AbilityConstant是启动参数的接口。
AbilityConstant提供Ability相关的枚举,包括设置初次启动原因、上次退出原因、迁移结果、窗口类型等。
AbilityConstant提供启动参数的接口的能力,包括设置初次开始原因的类型、上次退出原因的类型、继续结果的类型。
> **说明:**
> **说明:**
>
>
...
@@ -17,44 +15,74 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
...
@@ -17,44 +15,74 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
## 属性
## 属性
## AbilityConstant.LaunchParam
启动参数。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- | -------- |
| launchReason |
LaunchReason| 是 | 是 | 指示启动原因。 |
| launchReason |
[
LaunchReason
](
#abilityconstantlaunchreason
)
| 是 | 是 | 枚举类型,表示启动原因。 |
| lastExitReason |
LastExitReason | 是 | 是 | 表示最后退出原因。 |
| lastExitReason |
[
LastExitReason
](
#abilityconstantlastexitreason
)
| 是 | 是 | 枚举类型,表示最后退出原因。 |
## AbilityConstant.LaunchReason
## AbilityConstant.LaunchReason
初次开始原因的类型
。
Ability初次启动原因,该类型为枚举,可配合
[
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。 |
**示例:**
```
ts
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
MyAbility
extends
UIAbility
{
onCreate
(
want
,
launchParam
)
{
if
(
launchParam
.
launchReason
===
AbilityConstant
.
LaunchReason
.
START_ABILITY
)
{
console
.
log
(
"
The ability has been started by the way of startAbility.
"
);
}
}
}
```
## AbilityConstant.LastExitReason
## AbilityConstant.LastExitReason
上次退出原因的类型
。
Ability上次退出原因,该类型为枚举,可配合
[
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 | 正常
退出
。 |
**示例:**
```
ts
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
MyAbility
extends
UIAbility
{
onCreate
(
want
,
launchParam
)
{
if
(
launchParam
.
lastExitReason
===
AbilityConstant
.
LastExitReason
.
ABILITY_NOT_RESPONDING
)
{
console
.
log
(
"
The ability has exit last because the ability was not responding.
"
);
}
}
}
```
## AbilityConstant.OnContinueResult
## AbilityConstant.OnContinueResult
继续结果的类型
。
Ability迁移结果,该类型为枚举,可配合
[
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,9 +92,21 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
...
@@ -64,9 +92,21 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
| REJECT | 1 | 拒绝。 |
| REJECT | 1 | 拒绝。 |
| MISMATCH | 2 | 不匹配。|
| MISMATCH | 2 | 不匹配。|
**示例:**
```
ts
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
MyAbility
extends
UIAbility
{
onContinue
(
wantParam
)
{
return
AbilityConstant
.
OnConinueResult
.
AGREE
;
}
}
```
## AbilityConstant.WindowMode
## AbilityConstant.WindowMode
启动Ability时的窗口模式。
启动Ability时的窗口模式
,该类型为枚举,可配合startAbility使用指定启动Ability的窗口模式
。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
@@ -78,9 +118,28 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
...
@@ -78,9 +118,28 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
| WINDOW_MODE_SPLIT_SECONDARY | 101 | 分屏多窗口次要模式。 |
| WINDOW_MODE_SPLIT_SECONDARY | 101 | 分屏多窗口次要模式。 |
| WINDOW_MODE_FLOATING | 102 | 自由悬浮形式窗口模式。 |
| WINDOW_MODE_FLOATING | 102 | 自由悬浮形式窗口模式。 |
**示例:**
```
ts
let
want
=
{
bundleName
:
"
com.test.example
"
,
abilityName
:
"
MainAbility
"
};
let
option
=
{
windowMode
:
AbilityConstant
.
WindowMode
.
WINDOW_MODE_FULLSCREEN
};
// 确保从上下文获取到context
this
.
context
.
startAbility
(
want
,
option
).
then
(()
=
{
console
.
log
(
"
Succeed to start ability.
"
);
}).
catch
((
error
)
=>
{
console
.
log
(
"
Failed to start ability with error:
"
+
JSON
.
stringify
(
error
));
});
```
## 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,24 +149,50 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
...
@@ -90,24 +149,50 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
| MEMORY_LEVEL_LOW | 1 | 内存占用低。 |
| MEMORY_LEVEL_LOW | 1 | 内存占用低。 |
| MEMORY_LEVEL_CRITICAL | 2 | 内存占用高。 |
| MEMORY_LEVEL_CRITICAL | 2 | 内存占用高。 |
**示例:**
```
ts
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
MyAbility
extends
UIAbility
{
onMemoryLevel
(
level
)
{
if
(
level
===
AbilityConstant
.
MemoryLevel
.
MEMORY_LEVEL_CRITICAL
)
{
console
.
log
(
"
The memory of device is critical, please release some memory.
"
);
}
}
}
```
## 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 | 总是拒绝保存状态。|
**示例:**
```
ts
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
MyAbility
extends
UIAbility
{
onSaveState
(
reason
,
wantParam
)
{
return
AbilityConstant
.
OnSaveResult
.
ALL_AGREE
;
}
}
```
## 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
...
@@ -115,3 +200,18 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
...
@@ -115,3 +200,18 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
| ----------------------------- | ---- | ------------------------------------------------------------ |
| ----------------------------- | ---- | ------------------------------------------------------------ |
| CONTINUATION | 0 | 迁移保存状态。 |
| CONTINUATION | 0 | 迁移保存状态。 |
| APP_RECOVERY | 1 | 应用恢复保存状态。 |
| APP_RECOVERY | 1 | 应用恢复保存状态。 |
**示例:**
```
ts
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
MyAbility
extends
UIAbility
{
onSaveState
(
reason
,
wantParam
)
{
if
(
reason
===
AbilityConstant
.
StateType
.
CONTINUATION
)
{
console
.
log
(
"
Save the ability data when the ability continuation.
"
);
}
return
AbilityConstant
.
OnSaveResult
.
ALL_AGREE
;
}
}
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md
浏览文件 @
437a6d82
# @ohos.app.ability.abilityDelegatorRegistry (AbilityDelegatorRegistry)
# @ohos.app.ability.abilityDelegatorRegistry (AbilityDelegatorRegistry)
AbilityDelegatorRegistry
模块提供用于存储已注册的AbilityDelegator和AbilityDelegatorArgs对象的全局寄存器的能力,包括获取应用程序的AbilityDelegator对象、获取单元测试参数AbilityDelegatorArgs对象
。
AbilityDelegatorRegistry
是
[
测试框架
](
../../ability-deprecated/ability-delegator.md
)
模块,该模块用于获取
[
AbilityDelegator
](
js-apis-inner-application-abilityDelegator.md
)
和
[
AbilityDelegatorArgs
](
js-apis-inner-application-abilityDelegatorArgs.md
)
对象,其中
[
AbilityDelegator
](
js-apis-inner-application-abilityDelegator.md
)
对象提供添加用于监视指定ability的生命周期状态更改的AbilityMonitor对象的能力,
[
AbilityDelegatorArgs
](
js-apis-inner-application-abilityDelegatorArgs.md
)
对象提供获取当前测试参数的能力
。
> **说明:**
> **说明:**
>
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在测试框架中使用。
## 导入模块
## 导入模块
```
ts
```
ts
import
AbilityDelegatorRegistry
from
'
@ohos.app.ability.abilityDelegatorRegistry
'
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
| 名称 | 值 | 说明 |
| 名称 | 值 | 说明 |
| ------------- | ---- | --------------------------- |
| ------------- | ---- | --------------------------- |
| UNINITIALIZED | 0 | 表示
无效状态。
|
| UNINITIALIZED | 0 | 表示
Ability处于无效状态。
|
| CREATE | 1 | 表示Ability处于已创建状态。 |
| CREATE | 1 | 表示Ability处于已创建状态。 |
| FOREGROUND | 2 | 表示Ability处于前台状态。 |
| FOREGROUND | 2 | 表示Ability处于前台状态。 |
| BACKGROUND | 3 | 表示Ability处于后台状态。 |
| BACKGROUND | 3 | 表示Ability处于后台状态。 |
...
@@ -30,7 +31,7 @@ Ability生命周期状态。
...
@@ -30,7 +31,7 @@ Ability生命周期状态。
getAbilityDelegator(): AbilityDelegator
getAbilityDelegator(): AbilityDelegator
获取应用程序的
AbilityDelegator对象
获取应用程序的
[
AbilityDelegator
](
js-apis-inner-application-abilityDelegator.md
)
对象,该对象能够使用调度测试框架的相关功能。
**系统能力:**
SystemCapability.Ability.AbilityRuntime.Core
**系统能力:**
SystemCapability.Ability.AbilityRuntime.Core
...
@@ -43,15 +44,28 @@ getAbilityDelegator(): AbilityDelegator
...
@@ -43,15 +44,28 @@ getAbilityDelegator(): AbilityDelegator
**示例:**
**示例:**
```
ts
```
ts
var
abilityDelegator
;
import
AbilityDelegatorRegistry
from
'
@ohos.app.ability.abilityDelegatorRegistry
'
;
abilityDelegator
=
AbilityDelegatorRegistry
.
getAbilityDelegator
();
let
abilityDelegator
=
AbilityDelegatorRegistry
.
getAbilityDelegator
();
let
want
=
{
bundleName
:
"
com.ohos.example
"
,
abilityName
:
"
MainAbility
"
};
abilityDelegator
.
startAbility
(
want
,
(
err
)
=>
{
if
(
err
.
code
!==
0
)
{
console
.
log
(
"
Success start ability.
"
);
}
else
{
console
.
log
(
"
Failed start ability, error:
"
+
JSON
.
stringify
(
err
));
}
})
```
```
## AbilityDelegatorRegistry.getArguments
## AbilityDelegatorRegistry.getArguments
getArguments(): AbilityDelegatorArgs
getArguments(): AbilityDelegatorArgs
获取单元测试参数
AbilityDelegatorArgs对象
获取单元测试参数
[
AbilityDelegatorArgs
](
js-apis-inner-application-abilityDelegatorArgs.md
)
对象。
**系统能力:**
SystemCapability.Ability.AbilityRuntime.Core
**系统能力:**
SystemCapability.Ability.AbilityRuntime.Core
...
@@ -64,8 +78,11 @@ getArguments(): AbilityDelegatorArgs
...
@@ -64,8 +78,11 @@ getArguments(): AbilityDelegatorArgs
**示例:**
**示例:**
```
ts
```
ts
var
args
=
AbilityDelegatorRegistry
.
getArguments
();
import
AbilityDelegatorRegistry
from
'
@ohos.app.ability.abilityDelegatorRegistry
'
;
let
args
=
AbilityDelegatorRegistry
.
getArguments
();
console
.
info
(
"
getArguments bundleName:
"
+
args
.
bundleName
);
console
.
info
(
"
getArguments bundleName:
"
+
args
.
bundleName
);
console
.
info
(
"
getArguments parameters:
"
+
JSON
.
stringify
(
args
.
parameters
));
console
.
info
(
"
getArguments testCaseNames:
"
+
args
.
testCaseNames
);
console
.
info
(
"
getArguments testCaseNames:
"
+
args
.
testCaseNames
);
console
.
info
(
"
getArguments testRunnerClassName:
"
+
args
.
testRunnerClassName
);
console
.
info
(
"
getArguments testRunnerClassName:
"
+
args
.
testRunnerClassName
);
```
```
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md
浏览文件 @
437a6d82
# @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
)
方法。
> **说明:**
> **说明:**
>
>
...
@@ -27,8 +27,16 @@ onAbilityCreate(ability: UIAbility): void;
...
@@ -27,8 +27,16 @@ onAbilityCreate(ability: UIAbility): void;
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| ability |
[
UIAbility
](
js-apis-app
lication-ability.md#Ability
)
| 是 | 当前Ability对象 |
| ability |
[
UIAbility
](
js-apis-app
-ability-uiAbility.md
)
| 是 | 当前Ability对象 |
**示例:**
```
ts
let
abilityLifecycleCallback
=
{
onAbilityCreate
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityCreate.
"
);
}
};
```
## AbilityLifecycleCallback.onWindowStageCreate
## AbilityLifecycleCallback.onWindowStageCreate
...
@@ -42,9 +50,17 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void;
...
@@ -42,9 +50,17 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void;
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| ability |
[
UIAbility
](
js-apis-app
lication-ability.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对象 |
**示例:**
```
ts
let
abilityLifecycleCallback
=
{
onWindowStageCreate
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback onWindowStageCreate.
"
);
}
};
```
## AbilityLifecycleCallback.onWindowStageActive
## AbilityLifecycleCallback.onWindowStageActive
...
@@ -58,9 +74,17 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void;
...
@@ -58,9 +74,17 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void;
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| ability |
[
UIAbility
](
js-apis-app
lication-ability.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对象 |
**示例:**
```
ts
let
abilityLifecycleCallback
=
{
onWindowStageActive
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback onWindowStageActive.
"
);
}
};
```
## AbilityLifecycleCallback.onWindowStageInactive
## AbilityLifecycleCallback.onWindowStageInactive
...
@@ -74,9 +98,17 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void
...
@@ -74,9 +98,17 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| ability |
[
UIAbility
](
js-apis-app
lication-ability.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对象 |
**示例:**
```
ts
let
abilityLifecycleCallback
=
{
onWindowStageInactive
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback onWindowStageInactive.
"
);
}
};
```
## AbilityLifecycleCallback.onWindowStageDestroy
## AbilityLifecycleCallback.onWindowStageDestroy
...
@@ -90,9 +122,17 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void;
...
@@ -90,9 +122,17 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void;
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| ability |
[
UIAbility
](
js-apis-app
lication-ability.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对象 |
**示例:**
```
ts
let
abilityLifecycleCallback
=
{
onWindowStageDestroy
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback onWindowStageDestroy.
"
);
}
};
```
## AbilityLifecycleCallback.onAbilityDestroy
## AbilityLifecycleCallback.onAbilityDestroy
...
@@ -106,8 +146,16 @@ onAbilityDestroy(ability: UIAbility): void;
...
@@ -106,8 +146,16 @@ onAbilityDestroy(ability: UIAbility): void;
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| ability |
[
UIAbility
](
js-apis-app
lication-ability.md#Ability
)
| 是 | 当前Ability对象 |
| ability |
[
UIAbility
](
js-apis-app
-ability-uiAbility.md
)
| 是 | 当前Ability对象 |
**示例:**
```
ts
let
abilityLifecycleCallback
=
{
onAbilityDestroy
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityDestroy.
"
);
}
};
```
## AbilityLifecycleCallback.onAbilityForeground
## AbilityLifecycleCallback.onAbilityForeground
...
@@ -121,8 +169,16 @@ onAbilityForeground(ability: UIAbility): void;
...
@@ -121,8 +169,16 @@ onAbilityForeground(ability: UIAbility): void;
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| ability |
[
UIAbility
](
js-apis-app
lication-ability.md#Ability
)
| 是 | 当前Ability对象 |
| ability |
[
UIAbility
](
js-apis-app
-ability-uiAbility.md
)
| 是 | 当前Ability对象 |
**示例:**
```
ts
let
abilityLifecycleCallback
=
{
onAbilityForeground
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityForeground.
"
);
}
};
```
## AbilityLifecycleCallback.onAbilityBackground
## AbilityLifecycleCallback.onAbilityBackground
...
@@ -136,8 +192,16 @@ onAbilityBackground(ability: UIAbility): void;
...
@@ -136,8 +192,16 @@ onAbilityBackground(ability: UIAbility): void;
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| ability |
[
UIAbility
](
js-apis-app
lication-ability.md#Ability
)
| 是 | 当前Ability对象 |
| ability |
[
UIAbility
](
js-apis-app
-ability-uiAbility.md
)
| 是 | 当前Ability对象 |
**示例:**
```
ts
let
abilityLifecycleCallback
=
{
onAbilityBackground
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityBackground.
"
);
}
};
```
## AbilityLifecycleCallback.onAbilityContinue
## AbilityLifecycleCallback.onAbilityContinue
...
@@ -151,61 +215,89 @@ onAbilityContinue(ability: UIAbility): void;
...
@@ -151,61 +215,89 @@ onAbilityContinue(ability: UIAbility): void;
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| ability |
[
UIAbility
](
js-apis-app
lication-ability.md#Ability
)
| 是 | 当前Ability对象 |
| ability |
[
UIAbility
](
js-apis-app
-ability-uiAbility.md
)
| 是 | 当前Ability对象 |
**示例:**
**示例:**
```
ts
let
abilityLifecycleCallback
=
{
onAbilityContinue
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityContinue.
"
);
}
};
```
## AbilityLifecycleCallback使用
```
ts
**示例:**
import
UIAbility
from
"
@ohos.app.ability.UIAbility
"
;
export
default
class
MyAbility
extends
UIAbility
{
MyFirstAbility.ts
onCreate
()
{
```
ts
console
.
log
(
"
MyAbility onCreate
"
)
import
AbilityLifecycleCallback
from
"
@ohos.app.ability.AbilityLifecycleCallback
"
;
let
AbilityLifecycleCallback
=
{
import
AbilityStage
from
"
@ohos.app.ability.AbilityStage
"
;
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
// 声明ability生命周期回调,需配置所有回调后才可以在applicationContext注册
let
abilityLifecycleCallback
=
{
onAbilityCreate
(
ability
){
onAbilityCreate
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityCreate ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onAbilityCreate.
"
);
},
},
onWindowStageCreate
(
ability
,
windowStage
){
onWindowStageCreate
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback onWindowStageCreate ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onWindowStageCreate.
"
);
console
.
log
(
"
AbilityLifecycleCallback onWindowStageCreate windowStage:
"
+
JSON
.
stringify
(
windowStage
));
},
},
onWindowStageActive
(
ability
,
windowStage
){
onWindowStageActive
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback onWindowStageActive ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onWindowStageActive.
"
);
console
.
log
(
"
AbilityLifecycleCallback onWindowStageActive windowStage:
"
+
JSON
.
stringify
(
windowStage
));
},
},
onWindowStageInactive
(
ability
,
windowStage
){
onWindowStageInactive
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback onWindowStageInactive ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onWindowStageInactive.
"
);
console
.
log
(
"
AbilityLifecycleCallback onWindowStageInactive windowStage:
"
+
JSON
.
stringify
(
windowStage
));
},
},
onWindowStageDestroy
(
ability
,
windowStage
){
onWindowStageDestroy
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback onWindowStageDestroy ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onWindowStageDestroy.
"
);
console
.
log
(
"
AbilityLifecycleCallback onWindowStageDestroy windowStage:
"
+
JSON
.
stringify
(
windowStage
));
},
},
onAbilityDestroy
(
ability
){
onAbilityDestroy
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityDestroy ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onAbilityDestroy.
"
);
},
},
onAbilityForeground
(
ability
){
onAbilityForeground
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityForeground ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onAbilityForeground.
"
);
},
},
onAbilityBackground
(
ability
){
onAbilityBackground
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityBackground ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onAbilityBackground.
"
);
},
},
onAbilityContinue
(
ability
){
onAbilityContinue
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityContinue ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onAbilityContinue.
"
);
}
}
}
};
export
default
class
MyFirstAbility
extends
UIAbility
{
onCreate
()
{
console
.
log
(
"
MyAbilityStage onCreate
"
);
// 1.通过context属性获取applicationContext
// 1.通过context属性获取applicationContext
let
applicationContext
=
this
.
context
.
getApplicationContext
();
let
applicationContext
=
this
.
context
.
getApplicationContext
();
// 2.通过applicationContext注册监听应用内生命周期
// 2.通过applicationContext注册监听应用内生命周期
let
lifecycleid
=
applicationContext
.
on
(
"
abilityLifecycle
"
,
AbilityLifecycleCallback
);
try
{
console
.
log
(
"
registerAbilityLifecycleCallback number:
"
+
JSON
.
stringify
(
lifecycleid
));
globalThis
.
lifecycleId
=
applicationContext
.
on
(
"
abilityLifecycle
"
,
abilityLifecycleCallback
);
},
console
.
log
(
"
registerAbilityLifecycleCallback number:
"
+
JSON
.
stringify
(
lifecycleId
));
}
catch
(
paramError
)
{
console
.
log
(
"
error:
"
+
paramError
.
code
+
"
,
"
+
paramError
.
message
);
}
}
}
```
MySecondAbility.ts
```
ts
import
UIAbility
from
"
ohos.app.ability.UIAbility
"
;
export
default
class
MySecondAbility
extends
UIAbility
{
onDestroy
()
{
onDestroy
()
{
let
applicationContext
=
this
.
context
.
getApplicationContext
();
let
applicationContext
=
this
.
context
.
getApplicationContext
();
applicationContext
.
off
(
"
abilityLifecycle
"
,
lifecycleid
,
(
error
,
data
)
=>
{
// 3.通过applicationContext注销监听应用内生命周期
console
.
log
(
"
unregisterAbilityLifecycleCallback success, err:
"
+
JSON
.
stringify
(
error
));
applicationContext
.
off
(
"
abilityLifecycle
"
,
globalThis
.
lifecycleId
,
(
error
)
=>
{
});
if
(
error
.
code
!=
0
)
{
console
.
log
(
"
unregisterAbilityLifecycleCallback failed, error:
"
+
JSON
.
stringify
(
error
));
}
else
{
console
.
log
(
"
unregisterAbilityLifecycleCallback success.
"
);
}
}
});
}
}
```
}
\ No newline at end of file
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
浏览文件 @
437a6d82
# @ohos.app.ability.abilityManager (AbilityManager)
# @ohos.app.ability.abilityManager (AbilityManager)
AbilityManager模块提供
对Ability相关信息和状态信息进行获取、新增、修改等
能力。
AbilityManager模块提供
获取、新增、修改Ability相关信息和状态信息进行的
能力。
> **说明:**
> **说明:**
>
>
...
@@ -10,30 +10,30 @@ AbilityManager模块提供对Ability相关信息和状态信息进行获取、
...
@@ -10,30 +10,30 @@ AbilityManager模块提供对Ability相关信息和状态信息进行获取、
## 导入模块
## 导入模块
```
ts
```
ts
import
AbilityManager
from
'
@ohos.app.ability.abilityManager
'
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
**系统API**
: 此
接口为系统接口
,三方应用不支持调用。
**系统API**
: 此
枚举类型为系统接口内部定义
,三方应用不支持调用。
| 名称 | 值 | 说明 |
| 名称 | 值 | 说明 |
| -------- | -------- | -------- |
| -------- | -------- | -------- |
| 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, callback: AsyncCallback
\<
void>): void
通过
修改配置
来更新配置(callback形式)。
通过
传入修改的配置项
来更新配置(callback形式)。
**需要权限**
: ohos.permission.UPDATE_CONFIGURATION
**需要权限**
: ohos.permission.UPDATE_CONFIGURATION
...
@@ -43,25 +43,42 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
...
@@ -43,25 +43,42 @@ 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> | 是 | 以回调方式返回接口运行结果,可进行错误处理或其他自定义处理。 |
**错误码**
:
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考
[
errcode-ability
](
../errorcodes/errorcode-ability.md
)
。
**示例**
:
**示例**
:
```
ts
```
ts
import
ability
m
anager
from
'
@ohos.app.ability.abilityManager
'
;
import
ability
M
anager
from
'
@ohos.app.ability.abilityManager
'
;
var
config
=
{
const
config
=
{
language
:
'
chinese
'
language
:
'
Zh-Hans
'
,
// 简体中文
}
colorMode
:
COLOR_MODE_LIGHT
,
// 浅色模式
direction
:
DIRECTION_VERTICAL
,
// 垂直方向
screenDensity
:
SCREEN_DENSITY_SDPI
,
// 屏幕分辨率为"sdpi"
displayId
:
1
,
// 应用在Id为1的物理屏上显示
hasPointerDevice
:
true
,
// 指针类型设备已连接
};
try
{
try
{
abilitymanager
.
updateConfiguration
(
config
,
()
=>
{
abilityManager
.
updateConfiguration
(
config
,
(
err
)
=>
{
console
.
log
(
'
------------ updateConfiguration -----------
'
);
if
(
err
.
code
!==
0
)
{
console
.
log
(
"
updateConfiguration fail, err:
"
+
JSON
.
stringify
(
err
));
}
else
{
console
.
log
(
"
updateConfiguration success.
"
);
}
})
})
}
catch
(
paramError
)
{
}
catch
(
paramError
)
{
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
+
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
+
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
}
}
```
```
...
@@ -79,32 +96,45 @@ updateConfiguration(config: Configuration): Promise\<void>
...
@@ -79,32 +96,45 @@ updateConfiguration(config: Configuration): Promise\<void>
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| --------- | ---------------------------------------- | ---- | -------------- |
| config |
[
Configuration
](
js-apis-app-ability-configuration.md
)
| 是 | 新的配置项。 |
| config |
[
Configuration
](
js-apis-app-ability-configuration.md
)
| 是 | 新的配置项
,仅需配置需要更新的项
。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------------------------------- | ------- |
| ---------------------------------------- | ------- |
| Promise
\<
void> | 返回执行结果。 |
| Promise
\<
void> | 以Promise方式返回接口运行结果息,可进行错误处理或其他自定义处理。 |
**错误码**
:
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考
[
errcode-ability
](
../errorcodes/errorcode-ability.md
)
。
**示例**
:
**示例**
:
```
ts
```
ts
import
ability
m
anager
from
'
@ohos.app.ability.abilityManager
'
;
import
ability
M
anager
from
'
@ohos.app.ability.abilityManager
'
;
var
config
=
{
const
config
=
{
language
:
'
chinese
'
language
:
'
Zh-Hans
'
,
// 简体中文
}
colorMode
:
COLOR_MODE_LIGHT
,
// 浅色模式
direction
:
DIRECTION_VERTICAL
,
// 垂直方向
screenDensity
:
SCREEN_DENSITY_SDPI
,
// 屏幕分辨率为"sdpi"
displayId
:
1
,
// 应用在Id为1的物理屏上显示
hasPointerDevice
:
true
,
// 指针类型设备已连接
};
try
{
try
{
abilitym
anager
.
updateConfiguration
(
config
).
then
(()
=>
{
abilityM
anager
.
updateConfiguration
(
config
).
then
(()
=>
{
console
.
log
(
'
updateConfiguration success
'
);
console
.
log
(
'
updateConfiguration success.
'
);
}).
catch
((
err
)
=>
{
}).
catch
((
err
)
=>
{
console
.
log
(
'
updateConfiguration fail
'
);
console
.
log
(
'
updateConfiguration fail, err:
'
+
JSON
.
stringify
(
err
)
);
})
})
}
catch
(
paramError
)
{
}
catch
(
paramError
)
{
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
+
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
+
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
}
}
```
```
...
@@ -122,20 +152,32 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
...
@@ -122,20 +152,32 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback
\<
Array
\<
AbilityRunningInfo>> | 是 | 被指定的回调方法。 |
| callback | AsyncCallback
\<
Array
\<
[
AbilityRunningInfo
](
js-apis-inner-application-abilityRunningInfo.md
)
>> | 是 | 以回调方式返回接口运行结果及运行中的ability信息,可进行错误处理或其他自定义处理。 |
**错误码**
:
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考
[
errcode-ability
](
../errorcodes/errorcode-ability.md
)
。
**示例**
:
**示例**
:
```
ts
```
ts
import
ability
m
anager
from
'
@ohos.app.ability.abilityManager
'
;
import
ability
M
anager
from
'
@ohos.app.ability.abilityManager
'
;
try
{
try
{
abilitymanager
.
getAbilityRunningInfos
((
err
,
data
)
=>
{
abilityManager
.
getAbilityRunningInfos
((
err
,
data
)
=>
{
console
.
log
(
"
getAbilityRunningInfos err:
"
+
err
+
"
data:
"
+
JSON
.
stringify
(
data
));
if
(
err
.
code
!==
0
)
{
console
.
log
(
"
getAbilityRunningInfos fail, error:
"
+
JSON
.
stringify
(
err
));
}
else
{
console
.
log
(
"
getAbilityRunningInfos success, data:
"
+
JSON
.
stringify
(
data
));
}
});
});
}
catch
(
paramError
)
{
}
catch
(
paramError
)
{
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
+
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
+
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
}
}
```
```
...
@@ -153,22 +195,30 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
...
@@ -153,22 +195,30 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------------------------------- | ------- |
| ---------------------------------------- | ------- |
| Promise
\<
Array
\<
AbilityRunningInfo>> | 返回执行结果。 |
| Promise
\<
Array
\<
[
AbilityRunningInfo
](
js-apis-inner-application-abilityRunningInfo.md
)
>> | 以Promise方式返回接口运行结果及运行中的ability信息,可进行错误处理或其他自定义处理。 |
**错误码**
:
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考
[
errcode-ability
](
../errorcodes/errorcode-ability.md
)
。
**示例**
:
**示例**
:
```
ts
```
ts
import
ability
m
anager
from
'
@ohos.app.ability.abilityManager
'
;
import
ability
M
anager
from
'
@ohos.app.ability.abilityManager
'
;
try
{
try
{
abilitym
anager
.
getAbilityRunningInfos
().
then
((
data
)
=>
{
abilityM
anager
.
getAbilityRunningInfos
().
then
((
data
)
=>
{
console
.
log
(
"
getAbilityRunningInfos
data:
"
+
JSON
.
stringify
(
data
))
console
.
log
(
"
getAbilityRunningInfos success,
data:
"
+
JSON
.
stringify
(
data
))
}).
catch
((
err
)
=>
{
}).
catch
((
err
)
=>
{
console
.
log
(
"
getAbilityRunningInfos err:
"
+
err
)
console
.
log
(
"
getAbilityRunningInfos fail, err:
"
+
JSON
.
stringify
(
err
));
});
});
}
catch
(
paramError
)
{
}
catch
(
paramError
)
{
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
+
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
+
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
}
}
```
```
...
@@ -186,23 +236,35 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext
...
@@ -186,23 +236,35 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 |
| upperLimit | number | 是 | 获取消息数量的最大限制,最大为2
<sup>
31
</sup>
-1。 |
| callback | AsyncCallback
\<
Array
\<
AbilityRunningInfo>> | 是 | 被指定的回调方法。 |
| callback | AsyncCallback
\<
Array
\<
[
ExtensionRunningInfo
](
js-apis-inner-application-extensionRunningInfo.md
)
>> | 是 | 以回调方式返回接口运行结果及运行中的extension信息,可进行错误处理或其他自定义处理。 |
**错误码**
:
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考
[
errcode-ability
](
../errorcodes/errorcode-ability.md
)
。
**示例**
:
**示例**
:
```
ts
```
ts
import
ability
m
anager
from
'
@ohos.app.ability.abilityManager
'
;
import
ability
M
anager
from
'
@ohos.app.ability.abilityManager
'
;
var
upperLimit
=
0
;
let
upperLimit
=
1
0
;
try
{
try
{
abilitymanager
.
getExtensionRunningInfos
(
upperLimit
,
(
err
,
data
)
=>
{
abilityManager
.
getExtensionRunningInfos
(
upperLimit
,
(
err
,
data
)
=>
{
console
.
log
(
"
getExtensionRunningInfos err:
"
+
err
+
"
data:
"
+
JSON
.
stringify
(
data
));
if
(
err
.
code
!==
0
)
{
console
.
log
(
"
getExtensionRunningInfos fail, err:
"
+
JSON
.
stringify
(
err
));
}
else
{
console
.
log
(
"
getExtensionRunningInfos success, data:
"
+
JSON
.
stringify
(
data
));
}
});
});
}
catch
(
paramError
)
{
}
catch
(
paramError
)
{
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
+
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
+
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
}
}
```
```
...
@@ -220,30 +282,38 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
...
@@ -220,30 +282,38 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 |
| upperLimit | number | 是 | 获取消息数量的最大限制
,最大为2
<sup>
31
</sup>
-1
。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------------------------------- | ------- |
| ---------------------------------------- | ------- |
| Promise
\<
Array
\<
AbilityRunningInfo>> | 返回执行结果。 |
| Promise
\<
Array
\<
[
ExtensionRunningInfo
](
js-apis-inner-application-extensionRunningInfo.md
)
>> | 以Promise方式返回接口运行结果及运行中的extension信息,可进行错误处理或其他自定义处理。 |
**错误码**
:
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考
[
errcode-ability
](
../errorcodes/errorcode-ability.md
)
。
**示例**
:
**示例**
:
```
ts
```
ts
import
ability
m
anager
from
'
@ohos.app.ability.abilityManager
'
;
import
ability
M
anager
from
'
@ohos.app.ability.abilityManager
'
;
var
upperLimit
=
0
;
let
upperLimit
=
1
0
;
try
{
try
{
abilitym
anager
.
getExtensionRunningInfos
(
upperLimit
).
then
((
data
)
=>
{
abilityM
anager
.
getExtensionRunningInfos
(
upperLimit
).
then
((
data
)
=>
{
console
.
log
(
"
getAbilityRunningInfos
data:
"
+
JSON
.
stringify
(
data
));
console
.
log
(
"
getExtensionRunningInfos success,
data:
"
+
JSON
.
stringify
(
data
));
}).
catch
((
err
)
=>
{
}).
catch
((
err
)
=>
{
console
.
log
(
"
getAbilityRunningInfos err:
"
+
err
);
console
.
log
(
"
getExtensionRunningInfos fail, err:
"
+
JSON
.
stringify
(
err
)
);
})
})
}
catch
(
paramError
)
{
}
catch
(
paramError
)
{
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
+
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
+
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
}
}
```
```
...
@@ -259,21 +329,28 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void;
...
@@ -259,21 +329,28 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void;
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback
\<
ElementName> | 是 | 被指定的回调方法。 |
| callback | AsyncCallback
\<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
> | 是 | 以回调方式返回接口运行结果及应用名,可进行错误处理或其他自定义处理。 |
**错误码**
:
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考
[
errcode-ability
](
../errorcodes/errorcode-ability.md
)
。
**示例**
:
**示例**
:
```
ts
```
ts
import
abilitymanager
from
'
@ohos.app.ability.abilityManager
'
;
import
abilityManager
from
'
@ohos.app.ability.abilityManager
'
;
try
{
abilityManager
.
getTopAbility
((
err
,
data
)
=>
{
abilitymanager
.
getTopAbility
((
err
,
data
)
=>
{
if
(
err
.
code
!==
0
)
{
console
.
log
(
"
getTopAbility err:
"
+
err
+
"
data:
"
+
JSON
.
stringify
(
data
));
console
.
log
(
"
getTopAbility fail, err:
"
+
JSON
.
stringify
(
err
));
});
}
else
{
}
catch
(
paramError
)
{
console
.
log
(
"
getTopAbility success, data:
"
+
JSON
.
stringify
(
data
));
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
+
}
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
});
}
```
```
## getTopAbility
## getTopAbility
...
@@ -288,21 +365,24 @@ getTopAbility(): Promise\<ElementName>;
...
@@ -288,21 +365,24 @@ getTopAbility(): Promise\<ElementName>;
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------------------------------- | ------- |
| ---------------------------------------- | ------- |
| Promise
\<
ElementName>| 返回执行结果。 |
| Promise
\<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
>| 以Promise方式返回接口运行结果及应用名,可进行错误处理或其他自定义处理。 |
**错误码**
:
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考
[
errcode-ability
](
../errorcodes/errorcode-ability.md
)
。
**示例**
:
**示例**
:
```
ts
```
ts
import
ability
m
anager
from
'
@ohos.app.ability.abilityManager
'
;
import
ability
M
anager
from
'
@ohos.app.ability.abilityManager
'
;
try
{
abilityManager
.
getTopAbility
().
then
((
data
)
=>
{
abilitymanager
.
getTopAbility
().
then
((
data
)
=>
{
console
.
log
(
"
getTopAbility success, data:
"
+
JSON
.
stringify
(
data
));
console
.
log
(
"
getTopAbility data:
"
+
JSON
.
stringify
(
data
));
}).
catch
((
err
)
=>
{
}).
catch
((
err
)
=>
{
console
.
log
(
"
getTopAbility fail, err:
"
+
JSON
.
stringify
(
err
));
console
.
log
(
"
getTopAbility err:
"
+
err
);
})
})
}
catch
(
paramError
)
{
console
.
log
(
'
error.code:
'
+
JSON
.
stringify
(
paramError
.
code
)
+
'
error.message:
'
+
JSON
.
stringify
(
paramError
.
message
));
}
```
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md
浏览文件 @
437a6d82
# @ohos.app.ability.AbilityStage (AbilityStage)
# @ohos.app.ability.AbilityStage (AbilityStage)
AbilityStage是HAP
包
的运行时类。
AbilityStage是HAP的运行时类。
AbilityStage类提供在HAP加载的时候,通知开发者,可以在此进行该HAP的初始化(如资源预加载,线程创建等)能力。
AbilityStage类提供在HAP加载的时候,通知开发者,可以在此进行该HAP的初始化(如资源预加载,线程创建等)能力。
...
@@ -25,13 +25,15 @@ onCreate(): void
...
@@ -25,13 +25,15 @@ onCreate(): void
**示例:**
**示例:**
```
ts
```
ts
class
MyAbilityStage
extends
AbilityStage
{
import
AbilityStage
from
'
@ohos.app.ability.AbilityStage
'
;
class
MyAbilityStage
extends
AbilityStage
{
onCreate
()
{
onCreate
()
{
console
.
log
(
"
MyAbilityStage.onCreate is called
"
)
console
.
log
(
"
MyAbilityStage.onCreate is called
"
);
}
}
}
}
```
```
## AbilityStage.onAcceptWant
## AbilityStage.onAcceptWant
...
@@ -44,9 +46,9 @@ onAcceptWant(want: Want): string;
...
@@ -44,9 +46,9 @@ onAcceptWant(want: Want): string;
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | Want类型参数,传入需要启动的ability的信息,如Ability名称,Bundle名称等。 |
**返回值:**
**返回值:**
...
@@ -56,14 +58,16 @@ onAcceptWant(want: Want): string;
...
@@ -56,14 +58,16 @@ onAcceptWant(want: Want): string;
**示例:**
**示例:**
```
ts
```
ts
class
MyAbilityStage
extends
AbilityStage
{
import
AbilityStage
from
'
@ohos.app.ability.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
...
@@ -82,13 +86,15 @@ onConfigurationUpdate(newConfig: Configuration): void;
...
@@ -82,13 +86,15 @@ onConfigurationUpdate(newConfig: Configuration): void;
**示例:**
**示例:**
```
ts
```
ts
class
MyAbilityStage
extends
AbilityStage
{
import
AbilityStage
from
'
@ohos.app.ability.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
...
@@ -106,22 +112,24 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
...
@@ -106,22 +112,24 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
**示例:**
**示例:**
```
ts
```
ts
class
MyAbilityStage
extends
AbilityStage
{
import
AbilityStage
from
'
@ohos.app.ability.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;
指示
有关上下文的配置信息
。
指示
AbilityStage的上下文
。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
| 属性名 | 类型 | 说明 |
| 属性名 | 类型 | 说明 |
| ----------- | --------------------------- | ------------------------------------------------------------ |
| ----------- | --------------------------- | ------------------------------------------------------------ |
| context |
[
AbilityStageContext
](
js-apis-inner-application-abilityStageContext.md
)
| 在
启动能力阶段进行初始化时回调
。 |
| context |
[
AbilityStageContext
](
js-apis-inner-application-abilityStageContext.md
)
| 在
Ability启动阶段进行初始化时回调,获取到该Ability的context值
。 |
zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md
浏览文件 @
437a6d82
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md
浏览文件 @
437a6d82
...
@@ -8,13 +8,13 @@ appRecovery模块提供了应用在故障状态下的恢复能力。
...
@@ -8,13 +8,13 @@ appRecovery模块提供了应用在故障状态下的恢复能力。
## 导入模块
## 导入模块
```
ts
```
ts
import
appRecovery
from
'
@ohos.app.ability.appRecovery
'
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,16 +60,24 @@ enableAppRecovery(restart?: RestartFlag, saveOccasion?: SaveOccasionFlag, saveMo
...
@@ -60,16 +60,24 @@ enableAppRecovery(restart?: RestartFlag, saveOccasion?: SaveOccasionFlag, saveMo
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| restart |
[
RestartFlag
](
#apprecoveryrestartflag
)
| 否 | 发生对应故障时是否重启,默认为不重启。 |
| restart |
[
RestartFlag
](
#apprecoveryrestartflag
)
| 否 |
枚举类型,
发生对应故障时是否重启,默认为不重启。 |
| saveOccasion |
[
SaveOccasionFlag
](
#apprecoverysaveoccasionflag
)
| 否 | 状态保存时机,默认为故障时保存。 |
| saveOccasion |
[
SaveOccasionFlag
](
#apprecoverysaveoccasionflag
)
| 否 |
枚举类型,
状态保存时机,默认为故障时保存。 |
| saveMode |
[
SaveModeFlag
](
#apprecoverysavemodeflag
)
| 否 | 状态保存方式, 默认为文件缓存。 |
| saveMode |
[
SaveModeFlag
](
#apprecoverysavemodeflag
)
| 否 |
枚举类型,
状态保存方式, 默认为文件缓存。 |
**示例:**
**示例:**
```
ts
```
ts
export
default
class
MyAbilityStage
extends
AbilityStage
{
import
appRecovery
from
'
@ohos.app.ability.appRecovery
'
;
import
AbilityStage
from
'
@ohos.app.ability.AbilityStage
'
;
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
export
default
class
MyAbility
extends
UIAbility
{
onCreate
()
{
onCreate
()
{
appRecovery
.
enableAppRecovery
(
RestartFlag
::
ALWAYS_RESTART
,
SaveOccasionFlag
::
SAVE_WHEN_ERROR
,
SaveModeFlag
::
SAVE_WITH_FILE
);
appRecovery
.
enableAppRecovery
(
appRecovery
.
RestartFlag
::
ALWAYS_RESTART
,
appRecovery
.
SaveOccasionFlag
::
SAVE_WHEN_ERROR
,
appRecovery
.
SaveModeFlag
::
SAVE_WITH_FILE
);
}
}
}
}
```
```
...
@@ -86,13 +94,21 @@ restartApp(): void;
...
@@ -86,13 +94,21 @@ restartApp(): void;
**示例:**
**示例:**
```
ts
```
ts
var
observer
=
{
import
appRecovery
from
'
@ohos.app.ability.appRecovery
'
;
import
errorManager
from
'
@ohos.app.ability.errorManager
'
;
let
observer
=
{
onUnhandledException
(
errorMsg
)
{
onUnhandledException
(
errorMsg
)
{
console
.
log
(
'
onUnhandledException, errorMsg:
'
,
errorMsg
)
console
.
log
(
'
onUnhandledException, errorMsg:
'
,
errorMsg
)
appRecovery
.
restartApp
();
appRecovery
.
restartApp
();
}
}
}
}
;
try
{
errorManager
.
on
(
"
error
"
,
observer
);
}
catch
(
paramError
)
{
console
.
log
(
"
error:
"
+
paramError
.
code
+
"
,
"
+
paramError
.
message
);
}
```
```
## appRecovery.saveAppState
## appRecovery.saveAppState
...
@@ -107,15 +123,24 @@ saveAppState(): boolean;
...
@@ -107,15 +123,24 @@ saveAppState(): boolean;
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| -------- | -------- |
| boolean | 保存成功与否。 |
| boolean | 保存成功与否。
true:保存成功,false:保存失败。
|
**示例:**
**示例:**
```
ts
```
ts
var
observer
=
{
import
appRecovery
from
'
@ohos.app.ability.appRecovery
'
;
import
errorManager
from
'
@ohos.app.ability.errorManager
'
;
let
observer
=
{
onUnhandledException
(
errorMsg
)
{
onUnhandledException
(
errorMsg
)
{
console
.
log
(
'
onUnhandledException, errorMsg:
'
,
errorMsg
)
console
.
log
(
'
onUnhandledException, errorMsg:
'
,
errorMsg
)
appRecovery
.
saveAppState
();
appRecovery
.
saveAppState
();
}
}
};
try
{
errorManager
.
on
(
"
error
"
,
observer
);
}
catch
(
paramError
)
{
console
.
log
(
"
error:
"
+
paramError
.
code
+
"
,
"
+
paramError
.
message
);
}
}
```
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录