在 Android 应用开发中,手动进行依赖项的管理,可能会出现很多问题,尤其是多人合作的项目,这些问题会变得越来越棘手,最终导致整个项目陷入泥潭。为了避免这些问题,我们推荐使用 Dagger2 框架,它只需要前期做一些工作量,之后即使项目规模变大,项目复杂度提高,也可以很灵活的管理依赖,避免泛滥成灾的坏味道代码。
官方简介:
A fast dependency injector for Java and Android.
Dagger is a compile-time framework for dependency injection. It uses no reflection or runtime bytecode generation, does all its analysis at compile-time, and generates plain Java source code.
Dagger is actively maintained by the same team that works on Guava. Snapshot releases are auto-deployed to Sonatype's central Maven repository on every clean build with the versionHEAD-SNAPSHOT
. The current version builds upon previous work done at Square.
简单翻译:
一个 Java 和 Android 上的快速依赖注入器。
Dagger2 是依赖注入的编译时框架。它不使用反射或运行时字节码生成,而是在编译时进行所有分析,并生成原生的 Java 源代码。
Dagger2 由 Guava 团队积极维护。快照发布会自动部署到 Sonatype 的中央 Maven 库中,每次使用HEAD-SNAPSHOT
版本号进行干净的构建。当前版本建立在 Square 的 Dagger 之上。
概述
Java 中有很多优秀的依赖注入框架,比如 Guice、Spring Framework 等等,它们简单易用、社区活跃、生态丰富,有大量可供参考的开源项目,但它们都是基于反射的解决方案,对 Android 来说,有许多开发上和性能问题上的困扰。
Dagger2 的目标正是为了解决这些困扰。它可以让依赖随 Activity 朝生暮死,也可以让依赖与 Application 同舟共济,这在内存资源极为珍贵的 Android 系统中尤其重要。同时,所有的代码在编译时生成,可以避免反射带来的性能损耗,以及运行时才能发现的异常,进而提升开发体验。
入门 Dagger2 只需要关注 @Inject
和 @Component
。前者主要注解在构造函数和字段上,后者则注解在接口(或抽象类)上。注解构造函数可以生成实例,注解字段可以注入实例,而注解接口则可以自动完成依赖注入。
当你熟悉 Dagger2 后,我们推荐使用 Dagger2 for Android 扩展库,它提供标准的 Android 组件抽象类,以及依赖注入的工具类,使用它们可以消除裹脚布代码,让开发人员专注于业务逻辑。
最后,当你完全熟悉 Dagger2 的细节,你可以考虑使用 Hilt 框架,它是在 Dagger2 的基础上构建,提供一整套 Android 中依赖注入的标准解决方案。
目录
- 一、入门 - @Inject
- 二、入门 - @Component
- 三、进阶 - @Provides
- 四、进阶 - @Singleton
- 五、扩展 - @Scope
- 六、扩展 - @Named & @Qualifier
- 七、高级 - @Module
- 八、未完待续
准备
讨论本系列内容,需要准备基本的 Android 开发环境:
- JDK 1.8+
- Android Studio 4.0+
- Android SDK 19+
创建新的项目,打开 app 模块中的 build.gradle
文件,声明 Dagger2 依赖:
dependencies {
// other dependencies
implementation 'com.google.dagger:dagger:2.28'
annotationProcessor 'com.google.dagger:dagger-compiler:2.28'
}
了解更多细节,请参考:Dagger2 For Gradle 文档。
点击右上角的 Sync Now,自动下载 Dagger2 框架:
Dagger2 框架Dagger2 所依赖的 JSR330 依赖注入标准框架:
JSR330 框架说明
本系列聚焦 Dagger2 中的主要注解,结合 API 描述,由浅入深,了解它们的用法和功能,再通过实际的应用场景,解释为什么要用它们。同时也从开发者角度,展示解决问题的思路,希望可以帮助大家完全掌握 Dagger2 框架。
如果你的时间紧张,想要快速入门,建议参阅以下资料:
网友评论