!7399 【元能力子系统】应用上下文WindowStage生命周期监听资料新增

Merge pull request !7399 from dy/master

zh-cn/application-dev/ability/context-userguide.md

@@ -105,11 +105,21 @@ export default class MyAbilityStage extends AbilityStage {
             onAbilityCreate(ability){
                 console.log("AbilityLifecycleCallback onAbilityCreate ability:" + JSON.stringify(ability));        
             },
-            onAbilityWindowStageCreate(ability){
-                console.log("AbilityLifecycleCallback onAbilityWindowStageCreate ability:" + JSON.stringify(ability));           
+            onWindowStageCreate(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageCreate ability:" + JSON.stringify(ability)); 
+                console.log("AbilityLifecycleCallback onWindowStageCreate windowStage:" + JSON.stringify(windowStage));           
             },
-            onAbilityWindowStageDestroy(ability){
-                console.log("AbilityLifecycleCallback onAbilityWindowStageDestroy ability:" + JSON.stringify(ability));
+            onWindowStageActive(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageActive ability:" + JSON.stringify(ability)); 
+                console.log("AbilityLifecycleCallback onWindowStageActive windowStage:" + JSON.stringify(windowStage));           
+            },
+            onWindowStageInactive(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageInactive ability:" + JSON.stringify(ability));
+                console.log("AbilityLifecycleCallback onWindowStageInactive windowStage:" + JSON.stringify(windowStage));  
+            },
+            onWindowStageDestroy(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageDestroy ability:" + JSON.stringify(ability));
+                console.log("AbilityLifecycleCallback onWindowStageDestroy windowStage:" + JSON.stringify(windowStage));  
             },
             onAbilityDestroy(ability){
                 console.log("AbilityLifecycleCallback onAbilityDestroy ability:" + JSON.stringify(ability));             

zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md

 # AbilityLifecycleCallback
 
-AbilityLifecycleCallback模块提供应用上下文ApplicationContext的生命周期监听方法的回调类的能力，包括onAbilityCreate、onAbilityWindowStageCreate、onAbilityWindowStageDestroy等方法。
+AbilityLifecycleCallback模块提供应用上下文ApplicationContext的生命周期监听方法的回调类的能力，包括onAbilityCreate、onWindowStageCreate、onWindowStageDestroy等方法。
 
 > **说明：**
 > 
@@ -30,9 +30,9 @@ onAbilityCreate(ability: Ability): void;
   | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | 
 
 
-## AbilityLifecycleCallback.onAbilityWindowStageCreate
+## AbilityLifecycleCallback.onWindowStageCreate
 
-onAbilityWindowStageCreate(ability: Ability): void;
+onWindowStageCreate(ability: Ability, windowStage: window.WindowStage): void;
 
 注册监听应用上下文的生命周期后，在windowStage创建时触发回调。
 
@@ -43,11 +43,44 @@ onAbilityWindowStageCreate(ability: Ability): void;
   | 参数名 | 类型 | 必填 | 说明 | 
   | -------- | -------- | -------- | -------- |
   | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |  
+  | windowStage | [WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |    
 
 
-## AbilityLifecycleCallback.onAbilityWindowStageDestroy
+## AbilityLifecycleCallback.onWindowStageActive
 
-onAbilityWindowStageDestroy(ability: Ability): void;
+onWindowStageActive(ability: Ability, windowStage: window.WindowStage): void;
+
+注册监听应用上下文的生命周期后，在windowStage获焦时触发回调。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+  | 参数名 | 类型 | 必填 | 说明 | 
+  | -------- | -------- | -------- | -------- |
+  | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |  
+  | windowStage | [WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |    
+
+
+## AbilityLifecycleCallback.onWindowStageInactive
+
+onWindowStageInactive(ability: Ability, windowStage: window.WindowStage): void;
+
+注册监听应用上下文的生命周期后，在windowStage失焦时触发回调。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+  | 参数名 | 类型 | 必填 | 说明 | 
+  | -------- | -------- | -------- | -------- |
+  | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |  
+  | windowStage | [WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |  
+
+
+## AbilityLifecycleCallback.onWindowStageDestroy
+
+onWindowStageDestroy(ability: Ability, windowStage: window.WindowStage): void;
 
 注册监听应用上下文的生命周期后，在windowStage销毁时触发回调。
 
@@ -58,6 +91,7 @@ onAbilityWindowStageDestroy(ability: Ability): void;
   | 参数名 | 类型 | 必填 | 说明 | 
   | -------- | -------- | -------- | -------- |
   | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 |  
+  | windowStage | [WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |  
 
 
 ## AbilityLifecycleCallback.onAbilityDestroy
@@ -132,12 +166,22 @@ onAbilityContinue(ability: Ability): void;
               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));
-              },
+            onWindowStageCreate(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageCreate ability:" + JSON.stringify(ability)); 
+                console.log("AbilityLifecycleCallback onWindowStageCreate windowStage:" + JSON.stringify(windowStage));           
+            },
+            onWindowStageActive(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageActive ability:" + JSON.stringify(ability)); 
+                console.log("AbilityLifecycleCallback onWindowStageActive windowStage:" + JSON.stringify(windowStage));           
+            },
+            onWindowStageInactive(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageInactive ability:" + JSON.stringify(ability));
+                console.log("AbilityLifecycleCallback onWindowStageInactive windowStage:" + JSON.stringify(windowStage));  
+            },
+            onWindowStageDestroy(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageDestroy ability:" + JSON.stringify(ability));
+                console.log("AbilityLifecycleCallback onWindowStageDestroy windowStage:" + JSON.stringify(windowStage));  
+            },
               onAbilityDestroy(ability){
                   console.log("AbilityLifecycleCallback onAbilityDestroy ability:" + JSON.stringify(ability));             
               },

zh-cn/application-dev/reference/apis/js-apis-application-applicationContext.md

@@ -50,11 +50,21 @@ export default class MyAbilityStage extends AbilityStage {
             onAbilityCreate(ability){
                 console.log("AbilityLifecycleCallback onAbilityCreate ability:" + JSON.stringify(ability));        
             },
-            onAbilityWindowStageCreate(ability){
-                console.log("AbilityLifecycleCallback onAbilityWindowStageCreate ability:" + JSON.stringify(ability));           
+            onWindowStageCreate(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageCreate ability:" + JSON.stringify(ability)); 
+                console.log("AbilityLifecycleCallback onWindowStageCreate windowStage:" + JSON.stringify(windowStage));           
             },
-            onAbilityWindowStageDestroy(ability){
-                console.log("AbilityLifecycleCallback onAbilityWindowStageDestroy ability:" + JSON.stringify(ability));
+            onWindowStageActive(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageActive ability:" + JSON.stringify(ability)); 
+                console.log("AbilityLifecycleCallback onWindowStageActive windowStage:" + JSON.stringify(windowStage));           
+            },
+            onWindowStageInactive(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageInactive ability:" + JSON.stringify(ability));
+                console.log("AbilityLifecycleCallback onWindowStageInactive windowStage:" + JSON.stringify(windowStage));  
+            },
+            onWindowStageDestroy(ability, windowStage){
+                console.log("AbilityLifecycleCallback onWindowStageDestroy ability:" + JSON.stringify(ability));
+                console.log("AbilityLifecycleCallback onWindowStageDestroy windowStage:" + JSON.stringify(windowStage));  
             },
             onAbilityDestroy(ability){
                 console.log("AbilityLifecycleCallback onAbilityDestroy ability:" + JSON.stringify(ability));             

zh-cn/application-dev/reference/apis/js-apis-appmanager.md

@@ -155,7 +155,10 @@ getAppMemorySize(callback: AsyncCallback\<number>): void;
             console.log('startAbility result success:' + JSON.stringify(data));
         })
   ```
-## appManager.getProcessRunningInfos<sup>8+</sup>
+## appManager.getProcessRunningInfos<sup>(deprecated)</sup>
+
+> **说明：**
+> 从 API Version 9 开始废弃，建议使用[appManager.getProcessRunningInformation<sup>9+</sup>](#appmanagergetprocessrunninginformation9)替代。
 
 getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;
 
@@ -181,7 +184,10 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;
         });
   ```
 
-## appManager.getProcessRunningInfos<sup>8+</sup>
+## appManager.getProcessRunningInfos<sup>(deprecated)</sup>
+
+> **说明：**
+> 从 API Version 9 开始废弃，建议使用[appManager.getProcessRunningInformation<sup>9+</sup>](#appmanagergetprocessrunninginformation9-1)替代。
 
 getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): void;
 
@@ -206,6 +212,57 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo
         })
   ```
 
+## appManager.getProcessRunningInformation<sup>9+</sup>
+
+getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>;
+
+获取有关运行进程的信息。
+
+**需要权限**：ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------- | -------- |
+| Promise\<Array\<ProcessRunningInformation>> | 获取有关运行进程的信息。 |
+
+**示例：**
+    
+  ```js
+        app.getProcessRunningInformation().then((data) => {
+            console.log('success:' + JSON.stringify(data));
+        }).catch((error) => {
+            console.log('failed:' + JSON.stringify(error));
+        });
+  ```
+
+## appManager.getProcessRunningInformation<sup>9+</sup>
+
+getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInformation>>): void;
+
+获取有关运行进程的信息。
+
+**需要权限**：ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| callback | AsyncCallback\<Array\<ProcessRunningInformation>> | 否 | 获取有关运行进程的信息。 |
+
+**示例：**
+    
+  ```js
+        app.getProcessRunningInformation((err, data) => {
+            console.log('startAbility result failed :' + JSON.stringify(err));
+            console.log('startAbility result success:' + JSON.stringify(data));
+        })
+  ```
+
 ## appManager.registerApplicationStateObserver<sup>8+</sup>
 
 registerApplicationStateObserver(observer: ApplicationStateObserver): number;

zh-cn/application-dev/reference/apis/js-apis-processrunninginfo.md

-# ProcessRunningInfo
+# ProcessRunningInfo<sup>(deprecated)</sup>
 
 ProcessRunningInfo模块提供对进程运行信息进行设置和查询的能力。
 
 > **说明：**
 > 
-> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块首批接口从API Version 9 开始废弃，建议使用[ProcessRunningInformation<sup>9+</sup>](js-apis-processrunninginformation.md)替代。
 
 ## 使用说明
 

zh-cn/application-dev/reference/apis/js-apis-processrunninginformation.md

+# ProcessRunningInformation<sup>9+</sup>
+
+ProcessRunningInformation模块提供对进程运行信息进行设置和查询的能力。
+
+> **说明：**
+> 
+> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+
+## 使用说明
+
+通过[appManager](js-apis-appmanager.md#appmanagergetprocessrunninginformation9)来获取。
+
+```js
+import appManager from '@ohos.application.appManager';
+appManager.getProcessRunningInformation((error,data) => { 
+    console.log("getProcessRunningInformation error: "  + error.code + " data: " + JSON.stringify(data));
+});
+```
+
+## 属性
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+| 名称 | 参数类型 | 可读 | 可写 | 说明 | 
+| -------- | -------- | -------- | -------- | -------- |
+| pid | number | 是 | 否 | 进程ID。 | 
+| uid | number | 是 | 否 | 用户ID。 | 
+| processName | string | 是 | 否 | 进程名称。 | 
+| bundleNames | Array&lt;string&gt; | 是 | 否 | 进程中所有运行的包名称。 | 

zh-cn/release-notes/api-change/v3.2-beta1/js-apidiff-ability.md

@@ -126,8 +126,10 @@ OpenHarmony 3.2 Beta1版本相较于OpenHarmony 3.1 Release版本，元能力子
 | ohos.application.AbilityLifecycleCallback | AbilityLifecycleCallback | onAbilityBackground(ability: Ability): void; | 新增 |
 | ohos.application.AbilityLifecycleCallback | AbilityLifecycleCallback | onAbilityForeground(ability: Ability): void; | 新增 |
 | ohos.application.AbilityLifecycleCallback | AbilityLifecycleCallback | onAbilityDestroy(ability: Ability): void; | 新增 |
-| ohos.application.AbilityLifecycleCallback | AbilityLifecycleCallback | onAbilityWindowStageDestroy(ability: Ability): void; | 新增 |
-| ohos.application.AbilityLifecycleCallback | AbilityLifecycleCallback | onAbilityWindowStageCreate(ability: Ability): void; | 新增 |
+| ohos.application.AbilityLifecycleCallback | AbilityLifecycleCallback | onWindowStageCreate(ability: Ability, windowStage: window.WindowStage): void; | 新增 |
+| ohos.application.AbilityLifecycleCallback | AbilityLifecycleCallback | onWindowStageActive(ability: Ability, windowStage: window.WindowStage): void; | 新增 |
+| ohos.application.AbilityLifecycleCallback | AbilityLifecycleCallback | onWindowStageInactive(ability: Ability, windowStage: window.WindowStage): void; | 新增 |
+| ohos.application.AbilityLifecycleCallback | AbilityLifecycleCallback | onWindowStageDestroy(ability: Ability, windowStage: window.WindowStage): void; | 新增 |
 | ohos.application.AbilityLifecycleCallback | AbilityLifecycleCallback | onAbilityCreate(ability: Ability): void; | 新增 |
 | ohos.application.abilityManager | abilityManager | function getTopAbility(): Promise\<ElementName>;<br>function getTopAbility(callback: AsyncCallback\<ElementName>): void; | 新增 |
 | ohos.application.abilityManager | abilityManager | function getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningInfo>>;<br>function getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<ExtensionRunningInfo>>): void; | 新增 |