在HarmonyOS Next中为应用适配深浅主题模式，主要涉及资源定义和动态切换两个核心环节。

1. 定义主题资源

在resources目录下的base、dark等限定词子目录中，分别定义不同主题下的颜色、样式等资源。

例如，在resources/base/element/color.json中定义基础颜色：

{
  "color": [
    {
      "name": "background_color",
      "value": "#FFFFFF"
    }
  ]
}

在resources/dark/element/color.json中定义深色模式颜色：

{
  "color": [
    {
      "name": "background_color",
      "value": "#000000"
    }
  ]
}

2. 在UI中引用资源

在ArkUI组件中直接引用定义好的资源名，系统会根据当前主题自动匹配：

@Entry
@Component
struct Index {
  build() {
    Column() {
      Text('Hello')
        .fontSize(30)
        .fontColor($r('app.color.text_color'))
    }
    .width('100%')
    .height('100%')
    .backgroundColor($r('app.color.background_color'))
  }
}

3. 跟随系统主题

应用默认会跟随系统主题设置。如需显式控制，可在module.json5中配置：

{
  "module": {
    "abilities": [
      {
        "name": "EntryAbility",
        "theme": "system" // 可选值：system, light, dark
      }
    ]
  }
}

4. 应用内动态切换主题

通过UIAbilityContext或Window对象可以动态获取和设置主题：

import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';

export default class EntryAbility extends UIAbility {
  // 获取当前系统主题
  private getSystemTheme(): string {
    const windowClass = window.getLastWindow(this.context);
    return windowClass.getWindowMode().colorMode;
  }

  // 设置应用主题
  private setAppTheme(theme: string) {
    const windowClass = window.getLastWindow(this.context);
    windowClass.setWindowBackgroundColor(theme);
  }
}

5. 监听系统主题变化

注册主题变化监听器，在系统主题改变时更新界面：

import { common } from '@kit.AbilityKit';

// 在UIAbility中监听
onWindowStageCreate(windowStage: window.WindowStage) {
  windowStage.on('themeChange', (newTheme) => {
    // 处理主题变更逻辑
    this.updateTheme(newTheme);
  });
}

关键点

• 资源文件按主题分类存放，系统自动匹配
• 使用资源引用（$r）而非硬编码颜色值
• 配置module.json5控制主题行为
• 通过Window API实现动态切换
• 监听主题变化事件保持界面同步

这种设计确保了应用能无缝适配系统主题，同时支持应用内自定义主题切换，提供一致的用户体验。