Injector 是一个轻量级且易于使用的 Dart 依赖注入库,专为简化 Flutter 应用程序中的依赖管理而设计。它提供了一个简洁、最小化的 API 来注册和解析依赖项,支持单例和瞬态实例。通过与 Flutter 项目的无缝集成,它增强了代码的模块化和可测试性。该库非常适合那些希望在不牺牲功能的前提下,寻找比更复杂 DI 解决方案更简单替代方案的开发者。
适合场景
Flutter 应用中的简单依赖管理
使用模拟依赖项进行测试
模块化应用架构
减少服务实例化中的样板代码
简化状态管理设置
在组件之间实现松耦合
主要特点
简洁直观的 API
对单例和瞬态绑定的支持
与 Flutter 的轻松集成
内置的构造函数注入支持
轻量级占用
全面的文档
适合对象
初学者到中级 Flutter 开发者
小型到中型应用
优先考虑简单性而非高级功能的项目
寻求快速依赖注入实现的团队
需要可测试且可维护代码的应用程序
使用建议
与功能齐全的 DI 库相比,高级功能有限
不太适合具有复杂依赖关系的超大规模应用程序
不支持基于树的作用域或分层依赖项解析
在复杂场景中可能需要手动管理生命周期
原始 README
以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。
Injector 💉
Injector is a simple dependency injection lib for Dart.
It does not replace a complex dependency injection framework like Dagger, but it provides the basics that most apps need.
Feature requests are welcomed!
Internally the injector is a singleton that stores instances and builders in a Map.
Use registerDependency<Type>() to register the dependency.
Never ever try to register or get dependencies without the generic type! Dart allows it, but we don't ;)
All instances are lazy loaded, meaning that at the time you request the dependency the instance is created.
Get your dependency using get<Type>().
Usage
A simple usage example:
// Register a dependency (Every time a new instance)
injector.registerDependency<Car>(() {
var engine = injector.get<Engine>();
var fuel = injector.get<Fuel>();
var driver = injector.get<Driver>();
return CarImpl(engine,fuel,driver);
});
// Register a singleton
injector.registerSingleton<Car>(() {
var engine = injector.get<Engine>();
var fuel = injector.get<Fuel>();
var driver = injector.get<Driver>();
return CarImpl(engine,fuel,driver);
});
// Use custom Factories by extending [Factory].
injector.register(CustomFactory(() => Engine()));
// Register your dependencies / singletons in the __main.dart__ file
Notice
If you have an issue with getting dependencies from the injector, check that imports of your dependencies classes are absolute.