接入原生壳生命周期事件

新增 app.lifecycle HostBridge 能力与 H5 订阅入口

Expo 壳通过 React Native AppState 注入真实前后台状态

Tauri 壳通过主窗口 focus 和 blur 注入真实激活状态

更新壳能力漂移检查、测试和架构文档

src/services/host-bridge/hostBridge.ts

@@ -1,5 +1,6 @@
 import type {
   AppearanceColorSchemeResult,
+  AppLifecycleEventPayload,
   FileExportImagePayload,
   FileExportImageResult,
   FileExportTextPayload,
@@ -17,6 +18,7 @@ import {
   normalizeHostBridgeBadgeCount,
   normalizeHostBridgeColorScheme,
   normalizeHostBridgeExternalUrl,
+  normalizeHostBridgeLifecycleState,
 } from '../../../packages/shared/src/contracts/hostBridge';
 import type {
   WechatMiniProgramPayParams,
@@ -25,6 +27,7 @@ import type {
 import {
   canUseNativeAppHostBridge,
   requestNativeAppHostBridge,
+  subscribeNativeAppHostBridgeEvent,
 } from './nativeAppHostBridge';
 
 const WECHAT_JS_SDK_URL = 'https://res.wx.qq.com/open/js/jweixin-1.6.0.js';
@@ -99,6 +102,8 @@ export type HostExternalUrlRequest = OpenExternalUrlPayload;
 
 export type HostAppearanceColorSchemeSnapshot = AppearanceColorSchemeResult;
 
+export type HostAppLifecycleSnapshot = AppLifecycleEventPayload;
+
 const HOST_RUNTIME_REFRESH_TIMEOUT_MS = 3000;
 
 let cachedNativeHostRuntime: HostBridgeRuntimeResult | null = null;
@@ -786,3 +791,27 @@ export async function getHostAppearanceColorScheme() {
     return false;
   }
 }
+
+export function subscribeHostAppLifecycle(
+  listener: (payload: HostAppLifecycleSnapshot) => void,
+) {
+  if (!canUseNativeHostCapability('app.lifecycle')) {
+    return () => undefined;
+  }
+
+  return subscribeNativeAppHostBridgeEvent<AppLifecycleEventPayload>(
+    'app.lifecycle',
+    (payload) => {
+      const state = normalizeHostBridgeLifecycleState(payload?.state);
+      listener({
+        state,
+        focused: typeof payload?.focused === 'boolean'
+          ? payload.focused
+          : state === 'active',
+        ...(typeof payload?.nativeState === 'string'
+          ? { nativeState: payload.nativeState }
+          : {}),
+      });
+    },
+  );
+}