diff --git a/en/application-dev/reference/apis/js-apis-application-ability.md b/en/application-dev/reference/apis/js-apis-application-ability.md
index 490bb6eb14a89e1345d3ef7a77370891254110e5..136ec10fb630431a12d0455ca5e941249265267e 100644
--- a/en/application-dev/reference/apis/js-apis-application-ability.md
+++ b/en/application-dev/reference/apis/js-apis-application-ability.md
@@ -1,12 +1,15 @@
# Ability
-> **NOTE**
+> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
> The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+
Manages the ability lifecycle and context.
+
## Modules to Import
+
```
import Ability from '@ohos.application.Ability';
```
@@ -197,12 +200,11 @@ Called to save data during the ability migration preparation process.
**Example**
```js
- import AbilityConstant from "@ohos.application.AbilityConstant"
class myAbility extends Ability {
onContinue(wantParams) {
console.log('onContinue');
wantParams["myData"] = "my1234567";
- return AbilityConstant.OnContinueResult.AGREE;
+ return true;
}
}
```
@@ -257,32 +259,6 @@ Called when the configuration of the environment where the ability is running is
}
```
-## Ability.dump
-
-dump(params: Array\): Array\;
-
-Called when the client information is dumped.
-
-**System capability**: SystemCapability.Ability.AbilityRuntime.AbilityCore
-
-**Parameters**
-
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | params | Array\ | Yes| Parameters in the form of a command.|
-
-**Example**
-
- ```js
- class myAbility extends Ability {
- dump(params) {
- console.log('dump, params:' + JSON.stringify(params));
- return ["params"]
- }
- }
- ```
-
-
## Caller
@@ -315,9 +291,6 @@ Sends sequenceable data to the target ability.
```js
import Ability from '@ohos.application.Ability';
class MyMessageAble{ // Custom sequenceable data structure
- name:""
- str:""
- num: 1
constructor(name, str) {
this.name = name;
this.str = str;
@@ -388,9 +361,6 @@ Sends sequenceable data to the target ability and obtains the sequenceable data
```js
import Ability from '@ohos.application.Ability';
class MyMessageAble{
- name:""
- str:""
- num: 1
constructor(name, str) {
this.name = name;
this.str = str;
@@ -539,9 +509,6 @@ Registers a caller notification callback, which is invoked when the target abili
```js
import Ability from '@ohos.application.Ability';
class MyMessageAble{
- name:""
- str:""
- num: 1
constructor(name, str) {
this.name = name;
this.str = str;
diff --git a/en/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md b/en/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md
new file mode 100644
index 0000000000000000000000000000000000000000..9ac9b6868ec31a1b7e9f8b164491a6fec2e61997
--- /dev/null
+++ b/en/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md
@@ -0,0 +1,153 @@
+# AbilityLifecycleCallback
+
+> **NOTE**
+> The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+
+
+A callback class that provides APIs, such as **onAbilityCreate**, **onAbilityWindowStageCreate**, and **onAbilityWindowStageDestroy**, to listen for the lifecycle of the application context.
+
+
+## AbilityLifecycleCallback.onAbilityCreate
+
+onAbilityCreate(ability: Ability): void;
+
+Called when an ability is created.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**Parameters**
+
+ | Name| Type| Mandatory| Description|
+ | -------- | -------- | -------- | -------- |
+ | ability | [Ability](js-apis-application-ability.md#Ability) | Yes| **Ability** object.|
+
+
+## AbilityLifecycleCallback.onAbilityWindowStageCreate
+
+onAbilityWindowStageCreate(ability: Ability): void;
+
+Called when the window stage of an ability is created.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**Parameters**
+
+ | Name| Type| Mandatory| Description|
+ | -------- | -------- | -------- | -------- |
+ | ability | [Ability](js-apis-application-ability.md#Ability) | Yes| **Ability** object.|
+
+
+## AbilityLifecycleCallback.onAbilityWindowStageDestroy
+
+onAbilityWindowStageDestroy(ability: Ability): void;
+
+Called when the window stage of an ability is destroyed.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**Parameters**
+
+ | Name| Type| Mandatory| Description|
+ | -------- | -------- | -------- | -------- |
+ | ability | [Ability](js-apis-application-ability.md#Ability) | Yes| **Ability** object.|
+
+
+## AbilityLifecycleCallback.onAbilityDestroy
+
+onAbilityDestroy(ability: Ability): void;
+
+Called when an ability is destroyed.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**Parameters**
+
+ | Name| Type| Mandatory| Description|
+ | -------- | -------- | -------- | -------- |
+ | ability | [Ability](js-apis-application-ability.md#Ability) | Yes| **Ability** object.|
+
+
+## AbilityLifecycleCallback.onAbilityForeground
+
+onAbilityForeground(ability: Ability): void;
+
+Called when an ability is switched from the background to the foreground.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**Parameters**
+
+ | Name| Type| Mandatory| Description|
+ | -------- | -------- | -------- | -------- |
+ | ability | [Ability](js-apis-application-ability.md#Ability) | Yes| **Ability** object.|
+
+
+## AbilityLifecycleCallback.onAbilityBackground
+
+onAbilityBackground(ability: Ability): void;
+
+Called when an ability is switched from the foreground to the background.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**Parameters**
+
+ | Name| Type| Mandatory| Description|
+ | -------- | -------- | -------- | -------- |
+ | ability | [Ability](js-apis-application-ability.md#Ability) | Yes| **Ability** object.|
+
+
+## AbilityLifecycleCallback.onAbilityContinue
+
+onAbilityContinue(ability: Ability): void;
+
+Called when an ability is continued on another device.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**Parameters**
+
+ | Name| Type| Mandatory| Description|
+ | -------- | -------- | -------- | -------- |
+ | ability | [Ability](js-apis-application-ability.md#Ability) | Yes| **Ability** object.|
+
+**Example**
+
+
+ ```js
+ import AbilityStage from "@ohos.application.AbilityStage";
+
+ export default class MyAbilityStage extends AbilityStage {
+ onCreate() {
+ console.log("MyAbilityStage onCreate")
+ let AbilityLifecycleCallback = {
+ onAbilityCreate(ability){
+ console.log("AbilityLifecycleCallback onAbilityCreate ability:" + JSON.stringify(ability));
+ },
+ onAbilityWindowStageCreate(ability){
+ console.log("AbilityLifecycleCallback onAbilityWindowStageCreate ability:" + JSON.stringify(ability));
+ },
+ onAbilityWindowStageDestroy(ability){
+ console.log("AbilityLifecycleCallback onAbilityWindowStageDestroy ability:" + JSON.stringify(ability));
+ },
+ onAbilityDestroy(ability){
+ console.log("AbilityLifecycleCallback onAbilityDestroy ability:" + JSON.stringify(ability));
+ },
+ onAbilityForeground(ability){
+ console.log("AbilityLifecycleCallback onAbilityForeground ability:" + JSON.stringify(ability));
+ },
+ onAbilityBackground(ability){
+ console.log("AbilityLifecycleCallback onAbilityBackground ability:" + JSON.stringify(ability));
+ },
+ onAbilityContinue(ability){
+ console.log("AbilityLifecycleCallback onAbilityContinue ability:" + JSON.stringify(ability));
+ }
+ }
+ // 1. Obtain applicationContext through the context attribute.
+ let applicationContext = this.context.getApplicationContext();
+ // 2. Use applicationContext to register a listener for the ability lifecycle in the application.
+ let lifecycleid = applicationContext.registerAbilityLifecycleCallback(AbilityLifecycleCallback);
+ console.log("registerAbilityLifecycleCallback number: " + JSON.stringify(lifecycleid));
+ }
+ }
+ ```
diff --git a/en/application-dev/reference/apis/js-apis-application-applicationContext.md b/en/application-dev/reference/apis/js-apis-application-applicationContext.md
new file mode 100644
index 0000000000000000000000000000000000000000..0dfc9de068ba3aef8c84594b18dcad2730034cf0
--- /dev/null
+++ b/en/application-dev/reference/apis/js-apis-application-applicationContext.md
@@ -0,0 +1,71 @@
+# ApplicationContext
+
+> **NOTE**
+> The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+
+
+Provides application-level context and APIs for registering and deregistering the ability lifecycle listener in an application.
+
+
+## How to Use
+
+Before calling any APIs in **ApplicationContext**, obtain an **ApplicationContext** instance through the **context** instance.
+
+```js
+let applicationContext = this.context.getApplicationContext();
+```
+
+
+## ApplicationContext.registerAbilityLifecycleCallback
+
+registerAbilityLifecycleCallback(callback: AbilityLifecycleCallback): **number**;
+
+Registers a listener to monitor the ability lifecycle of the application.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name | Type | Mandatory| Description |
+| ------------------------ | -------- | ---- | ------------------------------ |
+| [AbilityLifecycleCallback](js-apis-application-abilityLifecycleCallback.md) | callback | Yes | Callback used to return the ID of the registered listener.|
+
+**Return value**
+
+| Type | Description |
+| ------ | ------------------------------ |
+| number | ID of the registered listener. The ID is incremented by 1 each time the listener is registered. When the ID exceeds 2^63-1, **-1** is returned.|
+
+**Example**
+
+ ```js
+ let applicationContext = this.context.getApplicationContext();
+ console.log("stage applicationContext: " + JSON.stringify(applicationContext));
+ let lifecycleid = applicationContext.registerAbilityLifecycleCallback(AbilityLifecycleCallback);
+ console.log("registerAbilityLifecycleCallback number: " + JSON.stringify(lifecycleid));
+ ```
+
+## ApplicationContext.unregisterAbilityLifecycleCallback
+
+unregisterAbilityLifecycleCallback(callbackId: **number**, callback: AsyncCallback<**void**>): **void**;
+
+Deregisters the listener that monitors the ability lifecycle of the application.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name | Type | Mandatory| Description |
+| ------------- | -------- | ---- | -------------------------- |
+| callbackId | number | Yes | ID of the listener to deregister.|
+| AsyncCallback | callback | Yes | Callback used to return the result. |
+
+**Example**
+
+ ```js
+ let applicationContext = this.context.getApplicationContext();
+ console.log("stage applicationContext: " + JSON.stringify(applicationContext));
+ applicationContext.unregisterAbilityLifecycleCallback(lifecycleid, (error, data) => {
+ console.log("unregisterAbilityLifecycleCallback success, err: " + JSON.stringify(error));
+ });
+ ```