ArkTS 鸿蒙沉浸式状态栏全局适配(透明 / 渐变 / 变色 + 安全区避让)

{  "module": {    "name": "entry",    "type": "entry",    "description": "$string:module_desc",    "mainElement": "EntryAbility",    "deviceTypes": ["phone", "tablet"],    "deliveryWithInstall": true,    "installationFree": false,    "uiSyntax": "arkts",    "properties": {      "ohos.application.isFullScreen": "true"    },    "abilities": [      {        "name": "EntryAbility",        "srcEntry": "./ets/entryability/EntryAbility.ets",        "startWindowIcon": "$media:startIcon",        "startWindowBackground": "$color:start_window_background",        "exported": true,        "skills": [          {            "entities": ["entity.system.home"],            "actions": ["action.system.home"]          }        ]      }    ]  }}

import { window } from '@kit.ArkUI';import { display } from '@kit.ArkUI';export class StatusBarUtil {  /**   * 设置沉浸式状态栏   * @param isImmersive 是否开启沉浸   * @param isLightText 是否白色文字   */  static async setStatusBar(isImmersive: boolean, isLightText: boolean = true) {    try {      const win = await window.getLastWindow(getContext());      // 是否延伸布局到状态栏      win.setWindowLayoutFullScreen(isImmersive);      // 修改状态栏文字颜色      win.setSystemBarProperties({        statusBarContentColor: isLightText ? '#FFFFFF' : '#000000'      });    } catch (e) {      console.error("状态栏设置异常：", JSON.stringify(e));    }  }  // 获取真实状态栏高度  static getStatusBarHeight(): number {    const info = display.getDefaultDisplaySync();    if (info.density >= 3) {      return 36;    }    return 24;  }  // 恢复系统默认状态栏  static async resetStatusBar() {    await this.setStatusBar(false, false);  }}

import { StatusBarUtil } from './utils/StatusBarUtil';@Entry@Componentstruct Index {  @State barHeight: number = StatusBarUtil.getStatusBarHeight();  aboutToAppear() {    // 开启沉浸式 + 白色字体    StatusBarUtil.setStatusBar(true, true);  }  build() {    Column() {      // 自定义渐变导航栏（自动避让状态栏）      Column() {        Text("沉浸式渐变导航栏")          .fontSize(18)          .fontWeight(FontWeight.Bold)          .color(Color.White)      }      .width('100%')      .padding({ top: this.barHeight, bottom: 12 })      .linearGradient({        direction: GradientDirection.Bottom,        colors: [['#FF2563EB', 0.0], ['#FF3B82F6', 1.0]]      })      // 主体内容      Column({ justifyContent: FlexAlign.Center }) {        Text("✅ 已开启全局沉浸式状态栏")          .fontSize(16)          .marginTop(20)        Text("✅ 动态高度适配，无遮挡、无黑屏")          .fontSize(14)          .color("#666666")          .marginTop(10)      }      .layoutWeight(1)      .width('100%')      .backgroundColor("#f5f7fa")    }.width('100%').height('100%')  }}

import { StatusBarUtil } from './utils/StatusBarUtil';@Componentexport struct NormalPage {  aboutToAppear() {    // 当前页面禁用沉浸式    StatusBarUtil.resetStatusBar();  }  build() {    Column({ justifyContent: FlexAlign.Center }) {      Text("当前页面：关闭沉浸式状态栏")        .fontSize(17)        .fontColor("#333333")      Text("适合表单、设置、登录类页面")        .fontSize(13)        .color("#999999")        .marginTop(10)    }    .width('100%')    .height('100%')  }}