Flutter依赖注入插件angel3_container_generator的使用

Angel3 Container Generator 是一个用于 Angel3 的替代容器，它使用 reflectable 包来代替 dart:mirrors 进行反射。然而，与 dart:mirrors 相比，reflectable 提供的反射能力更为有限。

使用

以下是使用 Angel3 Container Generator 的步骤：

1. 标注类：使用 @contained 注解标记要包含的类。
2. 运行构建器：运行 dart run build_runner build <你的类目录>。
3. 创建 build.xml 文件（可选）：

   targets:
     $default:
       builders:
         reflectable:
           generate_for:
           - bin/**_controller.dart
           options:
             formatted: true
   

已知限制

• 由于 reflectable 的原因，不支持 analyser 6.x。
• 不支持对函数/闭包进行反射。
• 不支持对私有声明进行反射。
• 不支持对泛型类型进行反射。

完整示例

以下是一个完整的示例，展示了如何使用 angel3_container_generator 插件。

import 'dart:async';

import 'package:angel3_container/angel3_container.dart';
import 'package:angel3_container_generator/angel3_container_generator.dart';

Future<void> main() async {
  // 创建一个容器实例。
  Container container = Container(GeneratedReflector());

  // 注册一个单例。
  container.registerSingleton<Engine>(Engine(40));

  // 您也可以省略类型注解，在这种情况下将使用对象的实际运行时类型。
  // 如果您正在注入抽象类，请优先使用类型注解。
  //
  // container.registerSingleton(Engine(40));

  // 注册一个工厂方法，用于创建卡车。
  container.registerFactory<Truck>((container) {
    return _TruckImpl(container.make<Engine>());
  });

  // 使用 `make` 方法创建实例。
  var truck = container.make<Truck>();

  // 您还可以异步解析注入。
  container.registerFactory<Future<int>>((_) async => 24);
  print(await container.makeAsync<int>());

  // 异步解析也适用于普通对象。
  await container.makeAsync<Truck>().then((t) => t.drive());

  // 注册一个命名的单例。
  container.registerNamedSingleton('the_truck', truck);

  // 应该打印：'Vroom! 我的引擎有40马力。'
  truck.drive();

  // 应该打印相同的内容。
  container.findByName<Truck>('the_truck').drive();

  // 我们可以创建一个具有自己工厂方法的子容器。
  var childContainer = container.createChild();

  childContainer.registerFactory<Truck>((container) {
    return _TruckImpl(Engine(5666));
  });

  // 创建一个拥有5666马力的卡车。
  childContainer.make<Truck>().drive();

  // 然而，调用 `make<Engine>` 将返回我们之前创建的单例引擎。
  print(childContainer.make<Engine>().horsePower);
}

// 抽象类
abstract class Truck {
  void drive();
}

// 发动机类
class Engine {
  final int horsePower;

  Engine(this.horsePower);
}

// 卡车实现类
class _TruckImpl implements Truck {
  final Engine engine;

  _TruckImpl(this.engine);

  [@override](/user/override)
  void drive() {
    print('Vroom! 我的引擎有${engine.horsePower}马力。');
  }
}