Flutter for OpenHarmony：injector 轻量级依赖注入库（比 GetIt 更简单的选择） 深度解析与鸿蒙适配指南
欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net
前言
依赖注入（Dependency Injection, DI）是解耦架构的核心。
在 Flutter 社区，get_it 是当之无愧的霸主，但有时候我们想要一个更简单、没有 Service Locator 模式那种“全局单例”味道的库，或者需要一个支持模块化注入的方案。
injector 是一个非常轻量的 DI 库。它不使用代码生成，提供基于构建器（Builder）的依赖注册机制。
对于 OpenHarmony 开发者，使用 DI 库可以将鸿蒙特定的实现（如 OhosPermissionService）与通用业务逻辑解耦，实现一套代码，多端运行。
一、核心原理
injector 的工作原理非常纯粹：它维护了一个 Map，Key 是类型，Value 是构建该类型的工厂函数。
map
get()
Singleton
Factory
注册阶段
Injector 容器
检查缓存?
返回单例
创建新实例
业务代码
二、OpenHarmony 适配说明
injector 是 Pure Dart 库，100% 兼容 OpenHarmony。
它非常适合用来屏蔽鸿蒙与 Android/iOS 的 API 差异。
架构建议：
定义一个抽象类 PermissionService，然后在 Android 上注册 AndroidPermissionImpl，在鸿蒙上注册 OhosPermissionImpl。
三、基础用例
3.1 获取实例
injector 默认提供了一个全局单例 Injector.appInstance。
import'package:injector/injector.dart';classDatabase{voidopen()=>print('DB opened');}voidsetup(){final injector =Injector.appInstance;// 注册为单例 injector.registerSingleton<Database>(()=>Database());}voidmain(){setup();// 获取实例final db =Injector.appInstance.get<Database>(); db.open();}
3.2 依赖其他依赖
classApiService{}classUserRepository{finalApiService api;finalDatabase db;UserRepository(this.api,this.db);}voidsetupComplex(){final injector =Injector.appInstance; injector.registerSingleton<ApiService>(()=>ApiService());// 在注册回调中，使用 injector 获取其他依赖 injector.registerDependency<UserRepository>((){returnUserRepository( injector.get<ApiService>(), injector.get<Database>(),);});}
四、完整实战示例：鸿蒙多环境适配
这个示例展示了如何使用 injector 来根据当前运行环境（Mock环境 vs 鸿蒙真机环境）注入不同的服务实现。这在开发阶段非常有用，可以让你在没有真机的情况下开发业务逻辑。
import'package:injector/injector.dart';// 1. 定义抽象接口abstractclassDeviceInfoService{StringgetOSName();}// 2. 鸿蒙真机实现classOhosDeviceInfoServiceimplementsDeviceInfoService{@overrideStringgetOSName()=>'OpenHarmony 5.0';}// 3. 模拟环境实现classMockDeviceInfoServiceimplementsDeviceInfoService{@overrideStringgetOSName()=>'Mock OS';}// 4. DI 配置类classDependencyConfig{staticvoidconfigure({bool isMock =false}){final injector =Injector.appInstance;// 清理旧的（支持热重载） injector.clearAll();if(isMock){print('🔧 注入 Mock 服务'); injector.registerSingleton<DeviceInfoService>(()=>MockDeviceInfoService());}else{print('📱 注入真实鸿蒙服务'); injector.registerSingleton<DeviceInfoService>(()=>OhosDeviceInfoService());}}}// 5. 业务页面classHomePage{voidshowInfo(){// 业务代码只依赖抽象接口，不关心具体是谁final service =Injector.appInstance.get<DeviceInfoService>();print('当前系统: ${service.getOSName()}');}}voidmain(){// 场景 A: 单元测试或电脑运行DependencyConfig.configure(isMock:true);HomePage().showInfo();// 输出: Mock OSprint('--- 切换环境 ---');// 场景 B: 鸿蒙真机运行DependencyConfig.configure(isMock:false);HomePage().showInfo();// 输出: OpenHarmony 5.0}
五、总结
injector 虽然不如 get_it 功能繁多，但胜在简单直观。
对于中小型 OpenHarmony 项目，或者想要快速验证原型，injector 提供的“注册-获取”模式没有任何样板代码负担。
掌握 DI 思想，是写出可测试、可维护鸿蒙应用的第一步。
