Dagger2是一個IOC框架，一般用于Android平臺，第一次接觸的朋友，一定會被搞得暈頭轉向。它延續了Java平臺Spring框架代碼碎片化，注解滿天飛的傳統。嘗試將各處代碼片段串聯起來，理清思緒，真不是件容易的事。更不用說還有各版本細微的差別。
與Spring不同的是，Spring是通過反射創建對象的，而Dagger2是[通過apt插件]在編譯期間生成代碼，這些生成的代碼負責依賴對象創建。

本文旨在以簡單通俗易懂的方式說明如何使用Dagger2，對其背后設計不做深入探討。人生苦短，碼農更甚，先知其然等有空時再知其所以然，不失為擼App的較好實踐。

正式開始前，先給像筆者這樣的小白定義幾個概念，方便下文理解：

• 依賴對象：比如bean，被其它類所需（依賴）的對象，需要以某種方式注入到目標對象中。
• 目標對象：依賴對象的需求方，注入者將依賴對象注入其中。
• 注入者/[依賴對象的]容器：維護依賴對象，將依賴對象注入到目標對象的工具類。

入門

首先，添加依賴庫。

    implementation "com.google.dagger:dagger:2.27"
    // kapt是服務于Kotlin的Annotation Processing Tool，用于編譯時處理注解
    kapt "com.google.dagger:dagger-compiler:2.27"

一般來說，IOC會根據規則在運行時自動幫我們生成依賴對象實例。Dagger2提供了兩種聲明依賴對象的方式：

• 構造函數有@Inject修飾。
• @Module修飾的類中所定義的有@Provides修飾的方法提供（可用于依賴對象是第三方庫中的對象）。

// 方式一（注意此處hen也要是依賴對象，否則將為null或者直接報錯）
class Egg @Inject constructor(private val hen: Hen)

// 方式二
@Module
class HenModule {
    @Singleton
    @Provides
    fun provideHen() = Hen()
}

大家注意@Singleton注解（javax.inject中定義），它表示該依賴對象的作用域或者說生命周期，Dagger2中可通過@Scope定義。@Singleton是Dagger2默認支持的scope，表示依賴對象是單例。需要注意的是，通常我們將單例保存在一個靜態域中，這樣的單例往往要等到虛擬機關閉時候，所占用的資源才釋放，但是，Dagger通過Singleton創建出來的單例并不保持在靜態域上，而是保留在同樣標注了@Singleton的Component實例中（依賴對象容器，接下來會講到）。其實對于任意scope，只要依賴對象和Component標注的是相同scope，那么該依賴對象在相應的Component中就是一個局部單例，僅會調用一次工廠類生成對象實例。一般來說我們只要使用默認的@Singleton即可，沒必要自定義，自定義Scope常用于業務或邏輯的劃分。
如果不想依賴對象與Component綁定，則可以使用@Reusable作用域。

上面說的Component是@Component注解修飾的接口，Dagger2會先尋找它，以此為入口得到所有依賴對象。該接口中可定義類似void inject(Target target)的方法。顯然，@Component注解的接口就是注入者，它將依賴對象和目標對象串聯了起來。

@Singleton
@Component(modules = [HenModule::class]) //依賴對象
interface MyAppComponent {
    fun inject(activity: MainActivity); //目標對象
}

最后我們就可以在目標對象中愉快地使用依賴對象了。

class MainActivity : AppCompatActivity() {
    @Inject
    lateinit var hen: Hen

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        DaggerMyAppComponent.builder().build().inject(this); // 關鍵
    }
}

改進

如上，對于Activity/Fragment來說，它們的實例化是系統完成的，因此若要將它們納入IOC容器管理，只能在它們使用之前的某個環節比如onCreate回調方法內手動加入。這產生了至少一個問題：這種方式破壞了依賴注入的核心準則——一個類不應該知道它是如何被注入的。為了解決這個問題，Dagger 2.10版本引入的dagger-android，它是一個專為Android設計的除了Dagger主模塊之外的全新模塊。

首先，新增兩個依賴庫。

    implementation "com.google.dagger:dagger-android:2.27"
    kapt "com.google.dagger:dagger-android-processor:2.27"

針對每個目標類編寫對應的子容器代碼：

@Subcomponent(modules = [HenModule::class])
interface MainActivitySubcomponent : AndroidInjector<MainActivity?> {
    @Subcomponent.Builder
    abstract class Builder : AndroidInjector.Factory<MainActivity?>
}

再針對每個目標類編寫對應的依賴對象代碼：

@Module(subcomponents = MainActivitySubcomponent::class)
abstract class MainActivityModule {
    @Binds
    @IntoMap
    @ActivityKey(MainActivity::class)
    abstract fun bindMainActivityInjectorFactory(builder: MainActivitySubcomponent.Builder?): AndroidInjector.Factory<out Activity?>?
}

修改之前的MyAppComponent代碼：

@Singleton
@Component(modules = [AndroidInjectionModule::class,MainActivityModule::class]) // 關鍵，引入AndroidInjectionModule
interface MyAppComponent {
    fun inject(app: MyApplication); //注入到Application
}

Application需要繼承HasActivityInjector，實現inject方法，返回DispatchingAndroidInjector對象。

class MyApplication : Application(), HasActivityInjector {
    // 由dagger.android自動注入
    @Inject
    lateinit var dispatchingAndroidInjector: DispatchingAndroidInjector<Activity>

    override fun androidInjector() = dispatchingAndroidInjector

    override fun onCreate() {
        super.onCreate()
        DaggerMyAppComponent.builder().build().inject(this)
    }
}

創建一個BaseActivity，在super.onCreate之前調用AndroidInjection.inject(this)，這樣之后的Activity就只需要繼承它，就可以使用各自的依賴對象了。

open class BaseActivity: AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        AndroidInjection.inject(this)
        super.onCreate(savedInstanceState)
    }
}

class MainActivity : BaseActivity() {
    @Inject
    lateinit var hen: Hen

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        //DaggerMyAppComponent.builder().build().inject(this); // 不需要了
    }
}

可見，為了解決前述問題，引入了更多的代碼，復雜度也提高了，這是否有必要，值得商榷。好在Dagger2提供了@ContributesAndroidInjector注解解決了這個問題。

再改進

1. 刪除前述的MainActivitySubcomponent和MainActivityModule；
2. 創建基于BaseActivity類型的容器（非必須）：

@Subcomponent
interface ActivityComponet: AndroidInjector<BaseActivity>{
    @Subcomponent.Builder
    abstract class Builder: AndroidInjector.Builder<BaseActivity>()
}

3. 創建ActivityModule，管理所有Activity。注意@ContributesAndroidInjector注解的使用。

@Module(subcomponents = [ActivityComponet::class])
abstract class ActivityModule{
    @ContributesAndroidInjector
    abstract fun mainActivityInjector(): MainActivity
}

4. 修改之前的MyAppComponent代碼：

@Singleton
@Component(modules = [AndroidInjectionModule::class,ActivityModule::class]) // MainActivityModule改為ActivityModule
interface MyAppComponent {
    fun inject(app: MyApplication);
}

大功告成！我們再也不需要重復地創建XXXActivityModule和XXXActivitySubcomponent類了。
參看Dagger & Android

后記拾遺

@BindsInstance：編譯后會在Component的Builder類中生成修飾的方法里面的參數對應的成員變量，so該變量對應的對象可在與該Component相關的Module中通過@Inject注入，可看作是該Component范圍內的全局單例，類似于上述的@Scope的作用。

Dagger 2.22 起引入了 @Component.Factory, 可以取代@Component.Builder的使用，Factory在許多場景的上的使用相對于Builder會更簡單。

Dagger 2.23新增了一個HasAndroidInjector接口，用于替代HasActivityInjector, HasServiceInjector, HasBroadcastReceiverInjector, HasSupportFragmentInjector四個接口，讓Application中的代碼更簡潔，目前還是beta版。一般如果我們只需要HasActivityInjector的話那也無所謂了。參看Reducing Boilerplate with the new HasAndroidInjector in Dagger 2.23

了解一下javax.inject，這個是 Java EE 6 規范 JSR 330 -- Dependency Injection for Java 中的東西， Spring、Guice兼容該規范。

Assisted Injection：似乎是Guice引入的一個概念？——
Sometimes a class gets some of its constructor parameters from the Injector and others from the caller. 對于這種情況，我們常封裝一個工廠類，該類內部提供了注入類型的實例化，對外暴露一個生產方法，該方法只接收需要外部傳入的參數。如果覺得手寫這種工廠類太過麻煩或工作量太大，那么可以使用AssistedInject自動生成。參看AssistedInject，Assisted Injection for JSR 330

拋棄dagger-android：雖然最終改進之后，代碼變得清晰很多，但內在邏輯反而更加復雜了。這種[理解門檻較高的]復雜度就像一顆定時炸彈，讓人夜不能寐。當我使用到ViewModel之后發現，也可以不引入dagger-android，而是將所有依賴注入到ViewModel中，再由ViewModel暴露給系統組件。然而由于框架所限，其實不然——ViewModel是由Android框架本身維護的，當然框架也給我們留了一個自定義provider viewmodel的口子，就是ViewModelProvider.Factory——這又是一項頗費腦力的工程，參看How to Inject ViewModel using Dagger 2。這步完成以后，我們再將ViewModelProvider.Factory實例注入到Application中，變為一個全局工廠對象，Activity/Fragment直接拿來用即可，再也不需要與依賴注入有任何瓜葛，自然也不需要dagger-android了。也有大神跟我想到一塊，參看當Dagger2撞上ViewModel

參考資料

Dagger2從入門到放棄再到恍然大悟
Dagger2 @Component 和@SubComponent 區別解惑
學習Dagger2筆記
dagger.android(Dagger2中的AndroidInjector)使用解析
Dagger2 中的 Binds、IntoSet、IntoMap
dagger android 學習（一）：dagger基礎使用
Dagger2在Android平臺上的新魔法（作者了解了dagger-android背后的原理后棄用）