From 023eb196769479bb4309b73602ced20ebfe69d61 Mon Sep 17 00:00:00 2001
From: zhengjiangliang <zhengjiangliang@huawei.com>
Date: Thu, 5 Jan 2023 15:24:15 +0800
Subject: [PATCH] modify window stage event type

Signed-off-by: zhengjiangliang <zhengjiangliang@huawei.com>
Change-Id: I9dbcc154923573a5b2c5cbc7d8cffdfb11dc8bc5
---
 .../reference/apis/js-apis-window.md          |  4 +-
 .../OpenHarmony_3.2.10.5/changelogs-window.md | 63 +++++++++++++++++++
 2 files changed, 65 insertions(+), 2 deletions(-)
 create mode 100644 zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.5/changelogs-window.md

diff --git a/zh-cn/application-dev/reference/apis/js-apis-window.md b/zh-cn/application-dev/reference/apis/js-apis-window.md
index a225e682fc..6fb39162ef 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-window.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-window.md
@@ -5868,10 +5868,10 @@ WindowStage生命周期。
 
 | 名称       | 值 | 说明       |
 | ---------- | ------ | ---------- |
-| FOREGROUND | 1      | 切到前台。 |
+| SHOWN      | 1      | 切到前台。 |
 | ACTIVE     | 2      | 获焦状态。 |
 | INACTIVE   | 3      | 失焦状态。 |
-| BACKGROUND | 4      | 切到后台。 |
+| HIDDEN     | 4      | 切到后台。 |
 
 ## WindowStage<sup>9+</sup>
 
diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.5/changelogs-window.md b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.5/changelogs-window.md
new file mode 100644
index 0000000000..697060fe9c
--- /dev/null
+++ b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.5/changelogs-window.md
@@ -0,0 +1,63 @@
+# 窗口子系统ChangeLog
+
+## cl.window.1 WindowStage生命周期监听类型名称变更
+
+WindowStage生命周期的监听类型枚举定义自3.2.10.5版本起进行了变更。
+
+**变更影响**
+
+3.2.10.5版本之前使用FOREGROUND/BACKGROUND类型开发的应用生命周期监听,在3.2.10.5版本之后失效。
+
+**关键接口/组件变更**
+
+##  WindowStageEventType<sup>9+</sup>
+
+变更前:
+
+| 名称       | 值   | 说明       |
+| ---------- | ---- | ---------- |
+| FOREGROUND | 1    | 切到前台。 |
+| BACKGROUND | 4    | 切到后台。 |
+
+变更后:
+| 名称   | 值   | 说明       |
+| ------ | ---- | ---------- |
+| SHOWN  | 1    | 切到前台。 |
+| HIDDEN | 4    | 切到后台。 |
+
+**适配指导**
+
+在注册生命周期监听回调时,将前后台事件类型改为SHOWN/HIDDEN:
+
+```
+import Ability from '@ohos.application.Ability';
+
+class myAbility extends Ability {
+    onWindowStageCreate(windowStage) {
+        console.log('onWindowStageCreate');
+        try {
+            windowStage.on('windowStageEvent', (stageEventType) => {
+                switch (stageEventType) {
+                    case window.WindowStageEventType.SHOWN:
+                        console.log("windowStage shown");
+                        break;
+                    case window.WindowStageEventType.ACTIVE:
+                        console.log("windowStage active");
+                        break;
+                    case window.WindowStageEventType.INACTIVE:
+                        console.log("windowStage inActive");
+                        break;
+                    case window.WindowStageEventType.HIDDEN:
+                        console.log("windowStage hidden");
+                        break;
+                    default:
+                        break;
+                }
+        	} )
+        } catch (exception) {
+            console.error('Failed to enable the listener for window stage event changes. Cause:' +
+                JSON.stringify(exception));
+        };
+    }
+};
+```
-- 
GitLab