Dagger2 | 前言

在 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 version HEAD-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 框架。

如果你的时间紧张，想要快速入门，建议参阅以下资料：

• GitHub - google/dagger: A fast dependency injector for Android and Java.
• Dagger 官网
• Dagger 基础知识 | Android 开发者 | Android Developers (google.cn)