Flutter for OpenHarmony 实战：Injectable — 自动化依赖注入大师

Flutter for OpenHarmony 实战：Injectable --- 自动化依赖注入大师

前言

在维护 Flutter for OpenHarmony 商业级项目时，由于功能重叠与模块解耦的需求，代码库中会充斥着大量的 Service（业务服务）、Repository（数据中心）及 Bloc/ViewModel。如果采用手动实例化这些类并逐层透传，代码会迅速演变成不可维护的"意大利面条"。

依赖注入 (Dependency Injection, DI) 是解决该问题的业界公认方案。而 Injectable 配合 GetIt，则是 Dart 生态中实现 DI 的皇冠。它能通过极其简洁的注解，在编译期自动生成复杂的注册代码。本文将带你探索如何利用 Injectable 构建一个灵活适配鸿蒙多运行环境的高级架构。

一、为什么 Injectable 是鸿蒙项目的必选项？

1.1 依赖管理的解耦

当 A 类依赖 B、B 依赖 C 时，手动初始化需要严格管理顺序。Injectable 会自动计算依赖图谱（Dependency Graph），确保组件按需且按序初始化。

1.2 平台抽象的"无感切换"

鸿蒙系统（OpenHarmony）与原生 Android/iOS 的底层能力（如 Preference、传感器）接口各异。通过 DI，我们可以在接口上编写代码，在运行时根据当前是否为鸿蒙平台注入具体的 Native 实现，从而实现"代码写一次，各处皆适配"。

二、配置环境 📦

在鸿蒙工程的 pubspec.yaml 中，我们需要配置基础库及生成器：

yaml 复制代码

dependencies:
  get_it: ^7.2.0
  injectable: ^2.3.2

dev_dependencies:
  injectable_generator: ^2.4.1 # 编译时代码生成器
  build_runner: ^2.4.0

💡 注意：由于 Injectable 依赖代码生成，每次新增注入类后记得运行 dart run build_runner build --delete-conflicting-outputs。

三、核心功能：3 个场景化进阶用法

3.1 定义简单的全局单例 (@singleton)

标注一个类为全局唯一实例，适合网络请求、日志中心等。

dart 复制代码

import 'package:injectable/injectable.dart';

@singleton
class OhosNetworkManager {
  // 💡 技巧：该类会被自动检测并注册进 GetIt 容器
  void connect() => print("🚀 鸿蒙专属网络通道已建立");
}

3.2 构造函数参数的智能推断

当你的 Service 依赖另一个被管理的类时，Injectable 会自动完成"组装"。

dart 复制代码

@injectable
class UserProfileRepository {
  final OhosNetworkManager _client;

  // 💡 技巧：构造函数参数会自动被 Injectable 寻找并注入
  UserProfileRepository(this._client);
}

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

针对鸿蒙系统的一些异步 API（如 Preferences.getInstance()），可以使用 @preResolve。

dart 复制代码

@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 接口。在"开发环境"下使用内存存储，在"鸿蒙真机环境"下自动注入鸿蒙持久化存储。

dart 复制代码

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 的苦役中解脱出来，更通过强大的环境隔离机制，为适配鸿蒙多元化的硬件生态提供了优雅的软件设计蓝图。

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

🌐 欢迎加入开源鸿蒙跨平台社区 ：开源鸿蒙跨平台开发者社区