Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
8504fcf6
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
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看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
8504fcf6
编写于
12月 20, 2022
作者:
O
openharmony_ci
提交者:
Gitee
12月 20, 2022
浏览文件
操作
浏览文件
下载
差异文件
!12670 优化API参考描述
Merge pull request !12670 from zhongjianfei/mm001
上级
3fea485b
138c3f6c
变更
11
展开全部
隐藏空白更改
内联
并排
Showing
11 changed file
with
294 addition
and
299 deletion
+294
-299
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
...dev/reference/apis/js-apis-app-ability-abilityConstant.md
+10
-12
zh-cn/application-dev/reference/apis/js-apis-app-ability-common.md
...lication-dev/reference/apis/js-apis-app-ability-common.md
+15
-15
zh-cn/application-dev/reference/apis/js-apis-app-ability-contextConstant.md
...dev/reference/apis/js-apis-app-ability-contextConstant.md
+4
-4
zh-cn/application-dev/reference/apis/js-apis-app-ability-extensionAbility.md
...ev/reference/apis/js-apis-app-ability-extensionAbility.md
+3
-2
zh-cn/application-dev/reference/apis/js-apis-app-ability-serviceExtensionAbility.md
...rence/apis/js-apis-app-ability-serviceExtensionAbility.md
+28
-28
zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md
...on-dev/reference/apis/js-apis-app-ability-startOptions.md
+1
-1
zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
...ation-dev/reference/apis/js-apis-app-ability-uiAbility.md
+143
-145
zh-cn/application-dev/reference/apis/js-apis-app-form-formExtensionAbility.md
...v/reference/apis/js-apis-app-form-formExtensionAbility.md
+4
-4
zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md
...dev/reference/apis/js-apis-application-abilityConstant.md
+9
-11
zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md
...ence/apis/js-apis-application-abilityLifecycleCallback.md
+61
-61
zh-cn/application-dev/reference/apis/js-apis-application-abilityStage.md
...on-dev/reference/apis/js-apis-application-abilityStage.md
+16
-16
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
浏览文件 @
8504fcf6
# @ohos.app.ability.AbilityConstant (AbilityConstant)
AbilityConstant是启动参数的接口。
AbilityConstant提供启动参数的接口的能力,包括设置初次开始原因的类型、上次退出原因的类型、继续结果的类型。
AbilityConstant提供Ability相关的枚举,包括设置初次启动原因、上次退出原因、迁移结果、窗口类型等。
> **说明:**
>
...
...
@@ -19,14 +17,14 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| launchReason | LaunchReason| 是 | 是 | 指示启动原因。 |
| lastExitReason | LastExitReason | 是 | 是 | 表示最后退出原因。 |
| launchReason | LaunchReason| 是 | 是 | 指示启动原因。 |
| lastExitReason | LastExitReason | 是 | 是 | 表示最后退出原因。 |
## AbilityConstant.LaunchReason
初次
开始原因的类型
。
初次
启动原因
。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -41,7 +39,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
## AbilityConstant.LastExitReason
上次退出原因
的类型
。
上次退出原因。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -54,7 +52,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
## AbilityConstant.OnContinueResult
继续结果的类型
。
迁移结果
。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -80,7 +78,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
## AbilityConstant.MemoryLevel
内存级别
的类型
。
内存级别。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -92,7 +90,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
## AbilityConstant.OnSaveResult
保存应用数据的结果
类型
。
保存应用数据的结果。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -107,7 +105,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
## AbilityConstant.StateType
保存应用数据场景原因
类型
。
保存应用数据场景原因。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
zh-cn/application-dev/reference/apis/js-apis-app-ability-common.md
浏览文件 @
8504fcf6
...
...
@@ -15,21 +15,21 @@ import common from '@ohos.app.ability.common'
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 类型 |
必填 |
说明 |
| ----------- | -------------------- | ----
| ----
-------------------------------------------------------- |
| UIAbilityContext |
[
UIAbilityContext
](
js-apis-inner-application-uiAbilityContext.md
)
|
否 |
UIAbilityContext二级模块。 |
| AbilityStageContext |
[
AbilityStageContext
](
js-apis-inner-application-abilityStageContext.md
)
|
否 |
AbilityStageContext二级模块。 |
| ApplicationContext |
[
ApplicationContext
](
js-apis-inner-application-applicationContext.md
)
|
否 |
ApplicationContext二级模块。 |
| BaseContext |
[
BaseContext
](
js-apis-inner-application-baseContext.md
)
|
否 |
BaseContext二级模块。 |
| Context |
[
Context
](
js-apis-inner-application-context.md
)
|
否 |
Context二级模块。 |
| ExtensionContext |
[
ExtensionContext
](
js-apis-inner-application-extensionContext.md
)
|
否 |
ExtensionContext二级模块。 |
| FormExtensionContext |
[
FormExtensionContext
](
js-apis-inner-application-formExtensionContext.md
)
|
否 |
FormExtensionContext二级模块。 |
| AreaMode |
[
AreaMode
](
#areamode
)
|
否 |
AreaMode枚举值。 |
| EventHub |
[
EventHub
](
js-apis-inner-application-eventHub.md
)
|
否 |
EventHub二级模块。 |
| PermissionRequestResult |
[
PermissionRequestResult
](
js-apis-inner-application-permissionRequestResult.md
)
|
否 |
PermissionRequestResult二级模块。 |
| PacMap |
[
PacMap
](
js-apis-inner-ability-dataAbilityHelper.md#PacMap
)
|
否 |
PacMap二级模块。 |
| AbilityResult |
[
AbilityResult
](
js-apis-inner-ability-abilityResult.md
)
|
否 |
AbilityResult二级模块。 |
| ConnectOptions |
[
ConnectOptions
](
js-apis-inner-ability-connectOptions.md
)
|
否 |
ConnectOptions二级模块。 |
| 名称 | 类型 | 说明 |
| ----------- | -------------------- | ------------------------------------------------------------ |
| UIAbilityContext |
[
UIAbilityContext
](
js-apis-inner-application-uiAbilityContext.md
)
| UIAbilityContext二级模块。 |
| AbilityStageContext |
[
AbilityStageContext
](
js-apis-inner-application-abilityStageContext.md
)
| AbilityStageContext二级模块。 |
| ApplicationContext |
[
ApplicationContext
](
js-apis-inner-application-applicationContext.md
)
| ApplicationContext二级模块。 |
| BaseContext |
[
BaseContext
](
js-apis-inner-application-baseContext.md
)
| BaseContext二级模块。 |
| Context |
[
Context
](
js-apis-inner-application-context.md
)
| Context二级模块。 |
| ExtensionContext |
[
ExtensionContext
](
js-apis-inner-application-extensionContext.md
)
| ExtensionContext二级模块。 |
| FormExtensionContext |
[
FormExtensionContext
](
js-apis-inner-application-formExtensionContext.md
)
| FormExtensionContext二级模块。 |
| AreaMode |
[
AreaMode
](
#areamode
)
| AreaMode枚举值。 |
| EventHub |
[
EventHub
](
js-apis-inner-application-eventHub.md
)
| EventHub二级模块。 |
| PermissionRequestResult |
[
PermissionRequestResult
](
js-apis-inner-application-permissionRequestResult.md
)
| PermissionRequestResult二级模块。 |
| PacMap |
[
PacMap
](
js-apis-inner-ability-dataAbilityHelper.md#PacMap
)
| PacMap二级模块。 |
| AbilityResult |
[
AbilityResult
](
js-apis-inner-ability-abilityResult.md
)
| AbilityResult二级模块。 |
| ConnectOptions |
[
ConnectOptions
](
js-apis-inner-ability-connectOptions.md
)
| ConnectOptions二级模块。 |
**示例:**
```
ts
...
...
zh-cn/application-dev/reference/apis/js-apis-app-ability-contextConstant.md
浏览文件 @
8504fcf6
# @ohos.app.ability.contextConstant (ContextConstant)
ContextConstant
模块提供数据加密等级定义的能力
。
ContextConstant
提供Context相关的枚举,当前仅包含数据加密等级的枚举
。
> **说明:**
>
...
...
@@ -19,7 +19,7 @@ import contextConstant from '@ohos.app.ability.contextConstant';
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 值 | 说明 |
| 名称 | 值 | 说明 |
| -------- | -------- | -------- |
| EL1 | 0 | 设备级加密区
。 |
| EL2 | 1 | 用户
凭据加密区。 |
| EL1 | 0 | 设备级加密区
,设备开机后可访问的数据区。 |
| EL2 | 1 | 用户
级加密区,设备开机,首次输入密码后才能够访问的数据区。 |
zh-cn/application-dev/reference/apis/js-apis-app-ability-extensionAbility.md
浏览文件 @
8504fcf6
# @ohos.app.ability.ExtensionAbility (扩展能力基类)
ExtensionAbility
模块提供对ExtensionAbility生命周期、上下文环境等调用管理的能力,包括ExtensionAbility创建、销毁、转储客户端信息等
。
ExtensionAbility
是特定场景扩展能力的基类,提供系统配置更新回调和系统内存调整回调。
。
> **说明:**
>
...
...
@@ -16,7 +16,7 @@ import ExtensionAbility from '@ohos.app.ability.ExtensionAbility';
**系统能力**
:SystemCapability.Ability.AbilityRuntime.AbilityCore
**示例:**
```
ts
class
MyExtensionAbility
extends
ExtensionAbility
{
onConfigurationUpdated
(
config
)
{
...
...
@@ -28,3 +28,4 @@ import ExtensionAbility from '@ohos.app.ability.ExtensionAbility';
}
}
```
zh-cn/application-dev/reference/apis/js-apis-app-ability-serviceExtensionAbility.md
浏览文件 @
8504fcf6
# @ohos.app.ability.ServiceExtensionAbility (ServiceExtensionAbility)
ServiceExtensionAbility模块提供
ServiceExtension服务扩展相关接口的能力
。
ServiceExtensionAbility模块提供
后台服务相关扩展能力,提供后台服务创建、销毁、连接、断开等生命周期回调
。
> **说明:**
>
...
...
@@ -23,9 +23,9 @@ import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
**系统API**
: 此接口为系统接口,三方应用不支持调用。
| 名称 | 类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| context |
[
ServiceExtensionContext
](
js-apis-inner-application-serviceExtensionContext.md
)
| 是 | 否 | ServiceExtension的上下文环境,继承自ExtensionContext。 |
| context |
[
ServiceExtensionContext
](
js-apis-inner-application-serviceExtensionContext.md
)
| 是 | 否 | ServiceExtension的上下文环境,继承自ExtensionContext。 |
## ServiceExtensionAbility.onCreate
...
...
@@ -40,9 +40,9 @@ Extension生命周期回调,在创建时回调,执行初始化业务逻辑
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
**示例:**
...
...
@@ -88,10 +88,10 @@ Extension生命周期回调,如果是startAbility拉起的服务,会在onCre
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
| startId | number | 是 | 返回拉起次数。首次拉起初始值返回1,多次之后自动递增。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
| startId | number | 是 | 返回拉起次数。首次拉起初始值返回1,多次之后自动递增。 |
**示例:**
...
...
@@ -116,15 +116,15 @@ Extension生命周期回调,如果是connectAbility拉起的服务,会在onC
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| rpc.RemoteObject | 一个RemoteObject对象,用于和客户端进行通信。 |
| 类型 | 说明 |
| -------- | -------- |
| rpc.RemoteObject | 一个RemoteObject对象,用于和客户端进行通信。 |
**示例:**
...
...
@@ -158,9 +158,9 @@ Extension的生命周期,断开服务连接时回调。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
**示例:**
...
...
@@ -184,9 +184,9 @@ onReconnect(want: Want): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
**示例:**
...
...
@@ -210,9 +210,9 @@ onConfigurationUpdate(newConfig: Configuration): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| newConfig |
[
Configuration
](
js-apis-app-ability-configuration.md
)
| 是 | 表示需要更新的配置信息。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| newConfig |
[
Configuration
](
js-apis-app-ability-configuration.md
)
| 是 | 表示需要更新的配置信息。 |
**示例:**
...
...
@@ -236,9 +236,9 @@ onDump(params: Array\<string>): Array\<string>;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| params | Array
\<
string> | 是 | 表示命令形式的参数。|
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| params | Array
\<
string> | 是 | 表示命令形式的参数。|
**示例:**
...
...
zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md
浏览文件 @
8504fcf6
# @ohos.app.ability.StartOptions (StartOptions)
StartOptions
模块对系统的基本通信组件进行查询和设置的能力
。
StartOptions
可以作为
[
startAbility
](
js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability-1
)
的入参,用于指定目标Ability的窗口模式
。
> **说明:**
>
...
...
zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
浏览文件 @
8504fcf6
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-app-form-formExtensionAbility.md
浏览文件 @
8504fcf6
# @ohos.app.form.FormExtensionAbility (FormExtensionAbility)
FormExtensionAbility
模块提供了卡片扩展相关接口
。
FormExtensionAbility
为卡片扩展模块,提供卡片创建、销毁、刷新等生命周期回调
。
> **说明:**
>
...
...
@@ -17,9 +17,9 @@ import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
**系统能力**
:SystemCapability.Ability.Form
| 名称 | 类型
| 可读 | 可写 | 说明
|
| ------- | -------------------------------------------------------
| ---- | ---- |
--------------------------------------------------- |
| context |
[
FormExtensionContext
](
js-apis-inner-application-formExtensionContext.md
)
| 是 | 否 | FormExtensionAbility的上下文环境,继承自
ExtensionContext
。 |
| 名称 | 类型
| 可读 | 可写 | 说明
|
| ------- | -------------------------------------------------------
----- | ---- | ---- | ---------
--------------------------------------------------- |
| context |
[
FormExtensionContext
](
js-apis-inner-application-formExtensionContext.md
)
| 是 | 否 | FormExtensionAbility的上下文环境,继承自
[
ExtensionContext
](
js-apis-inner-application-extensionContext.md
)
。 |
## onAddForm
...
...
zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md
浏览文件 @
8504fcf6
# @ohos.application.AbilityConstant (AbilityConstant)
AbilityConstant是启动参数的接口。
AbilityConstant提供启动参数的接口的能力,包括设置初次开始原因的类型、上次退出原因的类型、继续结果的类型。
AbilityConstant提供Ability相关的枚举,包括设置初次启动原因、上次退出原因、迁移结果、窗口类型等。
> **说明:**
>
...
...
@@ -19,14 +17,14 @@ import AbilityConstant from '@ohos.application.AbilityConstant';
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| launchReason | LaunchReason| 是 | 是 | 指示启动原因。 |
| lastExitReason | LastExitReason | 是 | 是 | 表示最后退出原因。 |
| launchReason | LaunchReason| 是 | 是 | 指示启动原因。 |
| lastExitReason | LastExitReason | 是 | 是 | 表示最后退出原因。 |
## AbilityConstant.LaunchReason
初次
开始原因的类型
。
初次
启动原因
。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -41,7 +39,7 @@ import AbilityConstant from '@ohos.application.AbilityConstant';
## AbilityConstant.LastExitReason
上次退出原因
的类型
。
上次退出原因。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -54,7 +52,7 @@ import AbilityConstant from '@ohos.application.AbilityConstant';
## AbilityConstant.OnContinueResult
继续结果的类型
。
迁移结果
。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -92,7 +90,7 @@ import AbilityConstant from '@ohos.application.AbilityConstant';
## AbilityConstant.OnSaveResult
保存应用数据的结果
类型
。
保存应用数据的结果。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -107,7 +105,7 @@ import AbilityConstant from '@ohos.application.AbilityConstant';
## AbilityConstant.StateType
保存应用数据场景原因
类型
。
保存应用数据场景原因。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md
浏览文件 @
8504fcf6
# @ohos.application.AbilityLifecycleCallback (AbilityLifecycleCallback)
AbilityLifecycleCallback模块提供应用上下文ApplicationContext的生命周期监听方法的回调类的能力,包括onAbilityCreate、onWindowStageCreate、onWindowStageDestroy等方法。
AbilityLifecycleCallback模块提供应用上下文ApplicationContext的生命周期监听方法的回调类的能力,包括onAbilityCreate、onWindowStageCreate、onWindowStageDestroy等方法
,可以作为
[
registerAbilityLifecycleCallback
](
js-apis-inner-application-applicationContext.md#applicationcontextregisterabilitylifecyclecallback
)
的入参
。
> **说明:**
>
...
...
@@ -25,9 +25,9 @@ onAbilityCreate(ability: Ability): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onWindowStageCreate
...
...
@@ -40,10 +40,10 @@ onWindowStageCreate(ability: Ability, windowStage: window.WindowStage): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | 当前WindowStage对象 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | 当前WindowStage对象 |
## AbilityLifecycleCallback.onWindowStageActive
...
...
@@ -56,10 +56,10 @@ onWindowStageActive(ability: Ability, windowStage: window.WindowStage): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | 当前WindowStage对象 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | 当前WindowStage对象 |
## AbilityLifecycleCallback.onWindowStageInactive
...
...
@@ -72,10 +72,10 @@ onWindowStageInactive(ability: Ability, windowStage: window.WindowStage): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | 当前WindowStage对象 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | 当前WindowStage对象 |
## AbilityLifecycleCallback.onWindowStageDestroy
...
...
@@ -88,10 +88,10 @@ onWindowStageDestroy(ability: Ability, windowStage: window.WindowStage): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | 当前WindowStage对象 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | 当前WindowStage对象 |
## AbilityLifecycleCallback.onAbilityDestroy
...
...
@@ -104,9 +104,9 @@ onAbilityDestroy(ability: Ability): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onAbilityForeground
...
...
@@ -119,9 +119,9 @@ onAbilityForeground(ability: Ability): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onAbilityBackground
...
...
@@ -134,9 +134,9 @@ onAbilityBackground(ability: Ability): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
## AbilityLifecycleCallback.onAbilityContinue
...
...
@@ -149,64 +149,64 @@ onAbilityContinue(ability: Ability): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| ability |
[
Ability
](
js-apis-application-ability.md#Ability
)
| 是 | 当前Ability对象 |
**示例:**
```
ts
import
AbilityStage
from
"
@ohos.application.AbilityStage
"
;
var
lifecycle
i
d
;
var
lifecycle
I
d
;
export
default
class
MyAbilityStage
extends
AbilityStage
{
onCreate
()
{
console
.
log
(
"
MyAbilityStage onCreate
"
)
let
AbilityLifecycleCallback
=
{
onAbilityCreate
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityCreate ability:
"
+
JSON
.
stringify
(
ability
));
let
AbilityLifecycleCallback
=
{
onAbilityCreate
(
ability
)
{
console
.
log
(
"
onAbilityCreate ability:
"
+
JSON
.
stringify
(
ability
));
},
onWindowStageCreate
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback onWindowStageCreate ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onWindowStageCreate windowStage:
"
+
JSON
.
stringify
(
windowStage
));
onWindowStageCreate
(
ability
,
windowStage
)
{
console
.
log
(
"
onWindowStageCreate ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
onWindowStageCreate windowStage:
"
+
JSON
.
stringify
(
windowStage
));
},
onWindowStageActive
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback onWindowStageActive ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onWindowStageActive windowStage:
"
+
JSON
.
stringify
(
windowStage
));
onWindowStageActive
(
ability
,
windowStage
)
{
console
.
log
(
"
onWindowStageActive ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
onWindowStageActive windowStage:
"
+
JSON
.
stringify
(
windowStage
));
},
onWindowStageInactive
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback
onWindowStageInactive ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onWindowStageInactive windowStage:
"
+
JSON
.
stringify
(
windowStage
));
onWindowStageInactive
(
ability
,
windowStage
)
{
console
.
log
(
"
onWindowStageInactive ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
onWindowStageInactive windowStage:
"
+
JSON
.
stringify
(
windowStage
));
},
onWindowStageDestroy
(
ability
,
windowStage
){
console
.
log
(
"
AbilityLifecycleCallback
onWindowStageDestroy ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
AbilityLifecycleCallback onWindowStageDestroy windowStage:
"
+
JSON
.
stringify
(
windowStage
));
onWindowStageDestroy
(
ability
,
windowStage
)
{
console
.
log
(
"
onWindowStageDestroy ability:
"
+
JSON
.
stringify
(
ability
));
console
.
log
(
"
onWindowStageDestroy windowStage:
"
+
JSON
.
stringify
(
windowStage
));
},
onAbilityDestroy
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityDestroy ability:
"
+
JSON
.
stringify
(
ability
));
onAbilityDestroy
(
ability
)
{
console
.
log
(
"
onAbilityDestroy ability:
"
+
JSON
.
stringify
(
ability
));
},
onAbilityForeground
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityForeground ability:
"
+
JSON
.
stringify
(
ability
));
onAbilityForeground
(
ability
)
{
console
.
log
(
"
onAbilityForeground ability:
"
+
JSON
.
stringify
(
ability
));
},
onAbilityBackground
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback onAbilityBackground ability:
"
+
JSON
.
stringify
(
ability
));
onAbilityBackground
(
ability
)
{
console
.
log
(
"
onAbilityBackground ability:
"
+
JSON
.
stringify
(
ability
));
},
onAbilityContinue
(
ability
){
console
.
log
(
"
AbilityLifecycleCallback
onAbilityContinue ability:
"
+
JSON
.
stringify
(
ability
));
onAbilityContinue
(
ability
)
{
console
.
log
(
"
onAbilityContinue ability:
"
+
JSON
.
stringify
(
ability
));
}
}
// 1.通过context属性获取applicationContext
let
applicationContext
=
this
.
context
.
getApplicationContext
();
// 2.通过applicationContext注册监听应用内生命周期
lifecycle
i
d
=
applicationContext
.
registerAbilityLifecycleCallback
(
AbilityLifecycleCallback
);
console
.
log
(
"
registerAbilityLifecycleCallback number:
"
+
JSON
.
stringify
(
lifecycle
id
));
lifecycle
I
d
=
applicationContext
.
registerAbilityLifecycleCallback
(
AbilityLifecycleCallback
);
console
.
log
(
"
registerAbilityLifecycleCallback number:
"
+
JSON
.
stringify
(
lifecycle
Id
));
}
onDestroy
()
{
let
applicationContext
=
this
.
context
.
getApplicationContext
();
applicationContext
.
unregisterAbilityLifecycleCallback
(
lifecycle
i
d
,
(
error
,
data
)
=>
{
console
.
log
(
"
unregisterAbilityLifecycleCallback success, err:
"
+
JSON
.
stringify
(
error
));
applicationContext
.
unregisterAbilityLifecycleCallback
(
lifecycle
I
d
,
(
error
,
data
)
=>
{
console
.
log
(
"
unregisterAbilityLifecycleCallback success, err:
"
+
JSON
.
stringify
(
error
));
});
}
}
...
...
zh-cn/application-dev/reference/apis/js-apis-application-abilityStage.md
浏览文件 @
8504fcf6
...
...
@@ -44,15 +44,15 @@ onAcceptWant(want: Want): string;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-want.md
)
| 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-want.md
)
| 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| string | 用户返回一个ability标识,如果之前启动过标识的ability,不创建新的实例并拉回栈顶,否则创建新的实例并启动。 |
| 类型 | 说明 |
| -------- | -------- |
| string | 用户返回一个ability标识,如果之前启动过标识的ability,不创建新的实例并拉回栈顶,否则创建新的实例并启动。 |
**示例:**
...
...
@@ -76,9 +76,9 @@ onConfigurationUpdated(config: Configuration): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| config |
[
Configuration
](
js-apis-application-configuration.md
)
| 是 | 发生全局配置变更时触发回调,当前全局配置包括系统语言、深浅色模式。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| config |
[
Configuration
](
js-apis-application-configuration.md
)
| 是 | 发生全局配置变更时触发回调,当前全局配置包括系统语言、深浅色模式。 |
**示例:**
...
...
@@ -100,9 +100,9 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| level |
[
AbilityConstant.MemoryLevel
](
js-apis-application-abilityConstant.md#abilityconstantmemorylevel
)
| 是 | 回调返回内存微调级别,显示当前内存使用状态。|
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| level |
[
AbilityConstant.MemoryLevel
](
js-apis-application-abilityConstant.md#abilityconstantmemorylevel
)
| 是 | 回调返回内存微调级别,显示当前内存使用状态。|
**示例:**
...
...
@@ -118,10 +118,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
context: AbilityStageContext;
指示有关上下文的配置信息
。
AbilityStage的上下文对象
。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
| 属性名
| 类型 | 说明
|
| -------
---- | --------------------------- | ----------------------------------
-------------------------- |
| context
|
[
AbilityStageContext
](
js-apis-inner-application-abilityStageContext.md
)
| 在启动能力阶段进行初始化时回调
。 |
| 属性名
| 类型 | 说明
|
| -------
| ------------------------------------------------------------ |
-------------------------- |
| context
|
[
AbilityStageContext
](
js-apis-inner-application-abilityStageContext.md
)
| AbilityStage的上下文对象
。 |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录