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 的苦役中解脱出来，更通过强大的环境隔离机制，为适配鸿蒙多元化的硬件生态提供了优雅的软件设计蓝图。
在追求高内聚、低耦合的鸿蒙应用开发旅途中，熟练掌握注入工具，是区分普通架构师与顶级工程专家的分水岭。
🌐 欢迎加入开源鸿蒙跨平台社区 ：开源鸿蒙跨平台开发者社区