HarmonyOS 实战：一次性搞定全局初始化，从启动到多模块协同的完整方案

摘要

在鸿蒙（HarmonyOS）应用开发里，经常会遇到一种需求：一启动应用，就需要完成一些全局性的准备工作，比如加载配置文件、建立数据库连接、初始化日志系统、注册全局事件监听等。如果每个模块自己单独做一遍，不仅浪费性能，还容易出现状态不一致的问题。所以，如何设计一个全局初始化机制，让它在应用启动时只执行一次，并在后续各个模块中生效，就变得非常关键。

引言

不论是在移动端 App 还是 IoT 设备的鸿蒙应用中，"初始化"几乎是项目启动时的第一件事。常见的场景包括：

启动时读取配置（比如服务器地址、功能开关等）。
初始化第三方 SDK（地图、推送、埋点等）。
连接数据库或准备本地存储结构。
注册全局事件监听，比如网络状态变化。

如果我们没有一个全局统一的初始化点，这些工作就可能被分散到不同的 Ability、组件、模块里，后期维护非常麻烦。

下面我会先带你实现一个基础版的全局初始化 Demo，然后再结合几个实际场景给出扩展实现。

全局初始化的基本实现

思路

在鸿蒙 ArkTS / JS 环境中，我们有几种方式来做全局初始化：

静态初始化块 创建一个工具类，在类加载时自动执行一次初始化逻辑。 应用入口 Ability 在应用入口的 onCreate 方法中做全局初始化，确保在其他组件执行前运行。 模块化初始化管理器 使用单例模式集中管理初始化步骤，方便后续维护。

代码示例（静态初始化块 + 入口 Ability）

ts 复制代码

// GlobalInitializer.ets
export class GlobalInitializer {
  static {
    console.info('[GlobalInitializer] 全局初始化开始');
    GlobalInitializer.loadConfig();
    GlobalInitializer.initLogger();
    console.info('[GlobalInitializer] 全局初始化完成');
  }

  private static loadConfig() {
    console.info('[GlobalInitializer] 加载配置文件...');
    // 模拟加载配置
    globalThis.appConfig = { apiUrl: 'https://api.example.com', debug: true };
  }

  private static initLogger() {
    console.info('[GlobalInitializer] 日志系统已初始化');
    globalThis.logger = {
      log: (msg: string) => console.info(`[LOG] ${msg}`),
      error: (msg: string) => console.error(`[ERROR] ${msg}`)
    };
  }
}

ts 复制代码

// EntryAbility.ets
import Ability from '@ohos.app.ability.UIAbility';
import { GlobalInitializer } from '../common/GlobalInitializer';

export default class EntryAbility extends Ability {
  onCreate(want, launchParam) {
    console.info('[EntryAbility] 应用启动');
    // 引用 GlobalInitializer 确保静态块执行
    console.info('API地址:', globalThis.appConfig.apiUrl);
    globalThis.logger.log('应用初始化完成，可以开始业务逻辑');
  }
}

运行效果 ：当应用启动时，GlobalInitializer 会在类加载阶段自动执行静态块，完成配置加载和日志系统初始化。EntryAbility 在启动时就能直接使用全局配置和日志方法。

实际应用场景

场景一：全局配置管理

很多应用会依赖配置文件（本地或远程拉取），在应用启动时就要加载好。

ts 复制代码

// ConfigManager.ets
export class ConfigManager {
  static config: Record<string, any> = {};

  static async init() {
    console.info('[ConfigManager] 开始加载配置...');
    // 模拟异步加载（比如从本地文件或网络获取）
    ConfigManager.config = {
      apiBaseUrl: 'https://api.example.com',
      theme: 'dark',
      featureFlags: { newUI: true }
    };
    console.info('[ConfigManager] 配置加载完成');
  }

  static get(key: string) {
    return ConfigManager.config[key];
  }
}

ts 复制代码

// EntryAbility.ets
import { ConfigManager } from '../common/ConfigManager';

export default class EntryAbility extends Ability {
  async onCreate() {
    await ConfigManager.init();
    console.info('当前主题:', ConfigManager.get('theme'));
  }
}

分析：这种方式适合配置量较多、需要异步加载的情况，避免在静态块中卡住主线程。

场景二：数据库初始化

应用可能需要在启动时就准备好数据库结构，避免后续模块第一次访问时才建表导致延迟。

ts 复制代码

// DatabaseManager.ets
export class DatabaseManager {
  static async init() {
    console.info('[DatabaseManager] 初始化数据库...');
    // 模拟数据库连接
    globalThis.db = {
      query: (sql: string) => console.info(`[DB Query] ${sql}`)
    };
    console.info('[DatabaseManager] 数据库已准备好');
  }
}

ts 复制代码

// EntryAbility.ets
import { DatabaseManager } from '../common/DatabaseManager';

export default class EntryAbility extends Ability {
  async onCreate() {
    await DatabaseManager.init();
    globalThis.db.query('SELECT * FROM users');
  }
}

场景三：全局事件监听

比如监听网络状态变化，或者全局键盘事件。

ts 复制代码

// EventManager.ets
import connection from '@ohos.net.connection';

export class EventManager {
  static init() {
    console.info('[EventManager] 注册网络状态监听...');
    connection.on('netAvailable', () => {
      console.info('网络已连接');
    });
    connection.on('netUnavailable', () => {
      console.info('网络断开');
    });
  }
}

ts 复制代码

// EntryAbility.ets
import { EventManager } from '../common/EventManager';

export default class EntryAbility extends Ability {
  onCreate() {
    EventManager.init();
  }
}

QA 环节

Q1：静态初始化和在 onCreate 中初始化有什么区别？ A：静态初始化在类加载时执行，一般是应用首次引用这个类时触发；onCreate 初始化是在 Ability 生命周期开始时执行。静态初始化更适合全局单例、工具类等一次性准备的工作，onCreate 则适合依赖运行环境的初始化（比如需要 Context）。

Q2：全局初始化是不是一定要放在 Application / EntryAbility？ A：不一定，但建议这样做，因为 EntryAbility 是应用生命周期的起点，集中在这里更方便维护和排查问题。

Q3：能不能让多个模块的初始化按顺序执行？ A：可以，可以做一个 InitializerManager，按顺序调用多个模块的 init 方法，这样就能统一控制初始化流程。

总结

在鸿蒙开发中，全局初始化是一件非常重要的事，它直接关系到应用的启动性能和后续稳定性。我们可以用静态初始化块来做一些简单的一次性准备，也可以在 onCreate 里集中处理依赖运行环境的初始化逻辑。结合实际项目需求，合理拆分配置、数据库、事件监听等模块，并统一由一个入口触发初始化，是比较推荐的做法。

这样不仅能提高代码的可维护性，也能避免重复初始化带来的性能浪费。