Flutter for OpenHarmony：flutter_simple_dependency_injection — 解耦应用架构的神器
欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net。
前言
随着鸿蒙工程复杂度的提升，由于“硬编码”依赖导致的架构臃肿会显著增加后期维护成本。flutter_simple_dependency_injection 提供了一种轻量级的 DI 方案，通过中立的“注入器”管理组件生命周期，实现各层级代码的深度解耦。
一、核心价值
1.1 基础概念
依赖注入的核心思想是：“不要自己去找桶，而是让别人把水送过来”。
实例化并持有
实例化并持有
请求实例
自动注入依赖
Injector 容器
ApiService
AuthRepository
鸿蒙 UI 页面
1.2 进阶概念
- Singleton (单例)：整个应用生命周期内只有一个实例，非常适合鸿蒙的数据库连接或全局配置。
- Factory (工厂)：每次获取时都创建一个新对象，适合每个页面独立的逻辑控制器（Controller）。
- Inject (手动注入)：在无法通过构造函数注入的地方（如：第三方组件内部），手动从容器取值。
二、核心 API / 组件详解
2.1 容器配置
在鸿蒙应用启动时（如 main.dart 之前），统一规划依赖地图。
import'package:flutter_simple_dependency_injection/injector.dart';voidsetupHarmonyInjections(){final injector =Injector.getInjector();// ✅ 推荐做法：注册全局单例 injector.map<HarmonyApiService>((i)=>HarmonyApiService(), isSingleton:true);// ✅ 注册需要自动装配的 Repository injector.map<AuthRepository>((i){// 💡 技巧：i.get<T>() 会自动寻找已注册的依赖returnAuthRepository(i.get<HarmonyApiService>());});}
2.2 实例获取
final authRepo =Injector.getInjector().get<AuthRepository>();
三、场景示例
3.1 场景一：模拟单元测试中的 Mock 注入
当我们想在预览模式或真机测试环境下替换真实的支付接口，而不用改动任何 UI 代码时。
import'package:flutter_simple_dependency_injection/injector.dart';// 接口定义abstractclassPayService{voidpay();}// ✅ 策略：根据是否在测试环境注入不同实现voidsetupPayDI(bool isTest){final injector =Injector.getInjector();if(isTest){ injector.map<PayService>((i)=>MockPayService());// 注入模拟器用的支付}else{ injector.map<PayService>((i)=>RealHarmonyPayService());// 注入真机支付}}
四、OpenHarmony 平台适配挑战
4.1 容器的跨 UI 容器共享
在鸿蒙的分屏（Multi-Window）或多个 Ability 渲染同一个 Flutter 视图时，确保 Injector 的单例对象能被正确管理。
✅ 适配策略建议：
- 统一初始化：在鸿蒙 HAP 的入口 Ability 中早期触发
setupInjections。 - 避免循环依赖：如果 A 依赖 B，B 也依赖 A，DI 容器会报错导致鸿蒙应用崩溃。请通过定义接口（抽象类）来打破环路。
// 💡 最佳实践：使用接口来降低适配耦合 injector.map<LoggerInterface>((i)=>HarmonyProductionLogger());
五、综合实战示例代码
这是一个完整的鸿蒙用户中心解耦示例：
import'package:flutter/material.dart';import'package:flutter_simple_dependency_injection/injector.dart';// 1. 服务定义classHarmonyUserService{StringgetWelcomeMsg()=>"欢迎回到鸿蒙生态系统！";}// 2. 注入配置voidconfigDI(){Injector.getInjector().map<HarmonyUserService>((i)=>HarmonyUserService());}// 3. UI 使用classHarmonyUserPageextendsStatelessWidget{HarmonyUserPage({super.key}){// 💡 重点：这里不需要 new UserService，而是从容器拿 _service =Injector.getInjector().get<HarmonyUserService>();} late finalHarmonyUserService _service;@overrideWidgetbuild(BuildContext context){returnScaffold( appBar:AppBar(title:constText('DI 解耦架构实战')), body:Center( child:Column( children:[constIcon(Icons.verified_user, size:80, color:Colors.blue),Text(_service.getWelcomeMsg(), style:constTextStyle(fontSize:18)),],),),);}}
六、总结
flutter_simple_dependency_injection 是构建高质量鸿蒙应用不可或缺的基石。通过将对象的生命周期与业务逻辑剥离，你的代码将变得异常“易于测试”且“易于更换”。
✅ 核心建议：
- 始终使用
final injector = Injector.getInjector()获取全局默认容器。 - 每一个 Service 对应的 UI 交互，都尝试通过 DI 传入，而不是在 UI 内部 new。
