Flutter for OpenHarmony：injector 轻量级依赖注入库（比 GetIt 更简单的选择） 深度解析与鸿蒙适配指南

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.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';

class Database {
  void open() => print('DB opened');
}

void setup() {
  final injector = Injector.appInstance;
  
  // 注册为单例
  injector.registerSingleton<Database>(() => Database());
}

void main() {
  setup();
  
  // 获取实例
  final db = Injector.appInstance.get<Database>();
  db.open();
}

3.2 依赖其他依赖

class ApiService {}

class UserRepository {
  final ApiService api;
  final Database db;
  
  UserRepository(this.api, this.db);
}

void setupComplex() {
  final injector = Injector.appInstance;

  injector.registerSingleton<ApiService>(() => ApiService());
  
  // 在注册回调中，使用 injector 获取其他依赖
  injector.registerDependency<UserRepository>(() {
    return UserRepository(
      injector.get<ApiService>(),
      injector.get<Database>(),
    );
  });
}

四、完整实战示例：鸿蒙多环境适配

这个示例展示了如何使用 injector 来根据当前运行环境（Mock环境 vs 鸿蒙真机环境）注入不同的服务实现。这在开发阶段非常有用，可以让你在没有真机的情况下开发业务逻辑。

import 'package:injector/injector.dart';

// 1. 定义抽象接口
abstract class DeviceInfoService {
  String getOSName();
}

// 2. 鸿蒙真机实现
class OhosDeviceInfoService implements DeviceInfoService {
  @override
  String getOSName() => 'OpenHarmony 5.0';
}

// 3. 模拟环境实现
class MockDeviceInfoService implements DeviceInfoService {
  @override
  String getOSName() => 'Mock OS';
}

// 4. DI 配置类
class DependencyConfig {
  static void configure({bool isMock = false}) {
    final injector = Injector.appInstance;
    
    // 清理旧的（支持热重载）
    injector.clearAll();

    if (isMock) {
      print('🔧 注入 Mock 服务');
      injector.registerSingleton<DeviceInfoService>(() => MockDeviceInfoService());
    } else {
      print('📱 注入真实鸿蒙服务');
      injector.registerSingleton<DeviceInfoService>(() => OhosDeviceInfoService());
    }
  }
}

// 5. 业务页面
class HomePage {
  void showInfo() {
    // 业务代码只依赖抽象接口，不关心具体是谁
    final service = Injector.appInstance.get<DeviceInfoService>();
    print('当前系统: ${service.getOSName()}');
  }
}

void main() {
  // 场景 A: 单元测试或电脑运行
  DependencyConfig.configure(isMock: true);
  HomePage().showInfo(); // 输出: Mock OS
  
  print('--- 切换环境 ---');

  // 场景 B: 鸿蒙真机运行
  DependencyConfig.configure(isMock: false);
  HomePage().showInfo(); // 输出: OpenHarmony 5.0
}

五、总结

injector 虽然不如 get_it 功能繁多，但胜在简单直观 。

对于中小型 OpenHarmony 项目，或者想要快速验证原型，injector 提供的"注册-获取"模式没有任何样板代码负担。

掌握 DI 思想，是写出可测试、可维护鸿蒙应用的第一步。