Flutter代码生成插件dino_generator的使用

在Flutter开发中，依赖注入是一种常见的设计模式，可以帮助我们更好地管理对象的创建和生命周期。dino_generator 是一个基于 Dart 的代码生成工具，用于简化依赖注入的实现。通过使用 dino_generator，我们可以自动生成依赖注入相关的代码，从而减少手动编写的工作量。

本文将详细介绍如何使用 dino_generator 插件，并提供一个完整的示例来展示其功能。

安装与配置

1. 添加依赖

首先，在项目的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  dino: ^x.x.x  # 替换为最新版本号

dev_dependencies:
  dino_generator: ^x.x.x  # 替换为最新版本号
  build_runner: ^2.1.x  # 构建工具

然后运行以下命令安装依赖：

flutter pub get

2. 配置代码生成

在项目根目录下创建或编辑 build.yaml 文件，指定需要生成代码的目标文件夹：

targets:
  $default:
    builders:
      dino_generator|dino_generator:
        options:
          output_dir: "lib/generated"

使用示例

接下来，我们将通过一个简单的例子展示如何使用 dino_generator 来管理依赖注入。

示例代码

以下是完整的代码示例，展示了如何定义服务类、生成依赖注入代码并使用它们。

1. 创建服务类

首先，定义我们需要注入的服务类：

// lib/main.dart
import 'package:dino/dino.dart';

part 'main.g.dart'; // 自动生成的代码会放在这里

// 定义一些基础依赖类
class DependencyA {}

class DependencyB {}

// 使用 @service 注解标记需要注入的服务
@service
class DependencyC {
  DependencyC(this.dependencyA, this.dependencyB);

  final DependencyA dependencyA;
  final DependencyB dependencyB;
}

// 定义一个抽象接口
abstract class TestService {
  void doSomething();
}

// 实现服务类，并使用 @Service 注解指定生命周期
@Service(ServiceLifetime.singleton)
class TestServiceImpl implements TestService {
  TestServiceImpl(
    this.dependencyA,
    this.dependencyB,
    this.dependencyC,
  );

  final DependencyA dependencyA;
  final DependencyB dependencyB;
  final DependencyC dependencyC;

  @override
  void doSomething() {
    print('doSomething');
  }
}

2. 注册服务并解析实例

在主函数中注册服务并解析实例：

// lib/main.dart (续)
void main(List<String> args) {
  // 创建服务集合
  final services = ServiceCollection();

  // 注册服务
  services.addDependencyC(ServiceLifetime.transient);
  services.addTestServiceImpl();

  // 获取解析器
  final resolver = services.build();

  // 解析并调用服务
  final testService = resolver.resolve<TestService>();
  testService.doSomething();
}

代码生成

运行以下命令生成依赖注入代码：

flutter pub run build_runner build

执行后，会在 lib/generated 文件夹中生成对应的代码文件（如 main.g.dart）。这些文件包含了所有服务的注册逻辑，无需手动维护。

运行结果

运行程序后，控制台将输出以下内容：

doSomething