Flutter for OpenHarmony 实战：使用 Injectable 构建依赖注入架构

3.3 异步服务的先行预解析 (Asynchronous Init)

针对鸿蒙系统的一些异步 API（如 Preferences.getInstance()），可以使用 @preResolve 确保服务完全初始化后再返回。

@module
abstract class OhosPlatformModule {
  @preResolve
  Future<SharedPreferences> get prefs => SharedPreferences.getInstance();
}

四、OpenHarmony 平台适配指南

在鸿蒙工程中，利用 DI 处理多端差异是核心竞争力：

4.1 环境隔离策略 (Environments) 🏗️

⚠️ 注意：鸿蒙有真机调试、模拟器运行以及特定的鸿蒙专项测试（ohos_test）等环境。

• ✅ 建议做法：利用 @Environment('ohos') 标签，为同一个接口定义多份实现。这样你可以给鸿蒙真机注入真实传感器实现，而给集成测试注入 Mock 实现。

4.2 避免循环依赖

• 💡 技巧：在构建鸿蒙复杂的 UI 组件树时，尽量通过接口依赖而非具体实现依赖。如果报错 Circular dependency，请检查是否在两个 Service 中互为对方的成员变量。

五、完整实战示例：构建鸿蒙多维环境适配架构

我们将实现一个高度解耦的架构：定义一个通用的 DataStorage 接口。在'开发环境'下使用内存存储，在'鸿蒙真机环境'下自动注入鸿蒙持久化存储。

import 'package:get_it/get_it.dart';
import 'package:injectable/injectable.dart';

final getIt = GetIt.instance;

// 1. 定义抽象接口，业务层仅依赖此处
abstract class OhosStorage {
  Future<void> save(String key, String value);
}

// 2. 核心：鸿蒙真机专属实现
@Environment('ohos_real')
@Injectable(as: OhosStorage)
class NativeOhosStorage implements OhosStorage {
  @override
  Future<void> save(String key, String value) async {
    print('【HarmonyOS Native】正在写入沙箱数据：$key = $value');
  }
}

// 3. 核心：开发环境（Mock）实现
@Environment('dev')
@Injectable(as: OhosStorage)
class MockStorage implements OhosStorage {
  @override
  Future<void> save(String key, String value) async {
    print('【Mock Debug】缓存已保存至内存：$key = $value');
  }
}

// 4. 自动生成的初始化配置入口（由 build_runner 生成）
@InjectableInit(
  initializerName: 'init', // 默认初始化函数名称
  preferRelativeImports: true,
  asExtension: true,
)
Future<void> configureDependencies(String env) => getIt.init(environment: env);

// 5. 应用侧启动演示
void main() async {
  // 💡 实战：在鸿蒙真机启动时传入 'ohos_real' 标识
  await configureDependencies('ohos_real');
  final storage = getIt<OhosStorage>();
  await storage.save('user_token', 'xyz_123');
  // 自动由于环境注入了 Native 实现
}

六、总结

Injectable 彻底重塑了我们管理 Flutter for OpenHarmony 代码结构的方式。它不但把开发者从手工写 registerSingleton 的苦役中解脱出来，更通过强大的环境隔离机制，为适配鸿蒙多元化的硬件生态提供了优雅的软件设计蓝图。

在追求高内聚、低耦合的鸿蒙应用开发旅途中，熟练掌握注入工具，是区分普通架构师与顶级工程专家的分水岭。