Kotlin怎样使用Android的Dagger2

作者：Antonio Leiva

时间：Apr 11, 2017

原文链接：https://antonioleiva.com/dagger-android-kotlin/

 

 

在Android上，创建去耦以及容易测试代码的几乎每位迟早都要诉诸Dagger。

 

虽然，在Kotlin中设置Dagger有一些不同，但是大多数都十分简单，仅需要几个步骤。今天我就在这里讲解。

 

同时要意识到，由于Kotlin的能力，还有其他方法可以解决注入问题，甚至在Kotlin中还有一些专门的库来解决。

 

但是Dagger仍然是有效的选择，即使不是最最通用的，也是其中之一。

 

 

提示：

 

在这篇文章中，我不会解释怎样使用Dagger 2，这是已知的。如果你有任何问题，可以阅读我之前写过一些关于依赖注入的文章。

 

用Dagger 2配置项目

 

如果在你的项目中，你已经配置了Kotlin插件，你需要做的就是配置kapt。

 

如果你已经使用过Dagger，你大概知道apt.kapt是Kotlin的一个版本，它为Dagger创建了需要的自生成类。

 

为了配置它，你需要将下面内容加入build.gradle：

kapt {
    generateStubs = true
}

 

你能够将其加入在依赖节之前。如果愿意，你能够使用新的实验性插件，它已经相当稳定了：

 

apply plugin: 'kotlin-kapt'

 

 

现在，你就需要加入Dagger编译器的依赖关系（是使用kapt而不是包括在apk中）和实际的库：

kapt 'com.google.dagger:dagger-compiler:2.5'
compile 'com.google.dagger:dagger:2.5'

 

这样一切就绪，可以开始使用Dagger。

 

主模块的实现

 

 

你可能知道，对于主图形，你需要一个Module和一个Component。

 

在这个简单的例子中，应用模块仅返回应用自己的实例。

 

 

为了这样做，我们将用@Module注解创建一个类，通过构造函数接收应用实例，将其保存到属性中，用@Provides@Singleton注解的方法返回它。

@Module class AppModule(val app: App) {
    @Provides @Singleton fun provideApp() = app
}

 

你可以看到，即使对于这样简单的类，其代码也要比用Java简单得多。

 

接着我们要实现Component，它需要加载一个模块数组，并且说明谁能够手动注入它：

@Singleton
@Component(modules = arrayOf(AppModule::class))
interface AppComponent {
    fun inject(app: App)
}

 

再就只创建一个App类，它将负责生成图片：

class App : Application() {

    val component: AppComponent by lazy {
        DaggerAppComponent
                .builder()
                .appModule(AppModule(this))
                .build()
    }

    override fun onCreate() {
        super.onCreate()
        component.inject(this)
    }
}

 

这里看到的有趣的事是，由于lazy声明，我们能够在属性的定义中指定图形的值，因此就获得了对该属性的只读访问权。

 

 

在component.inject (this)完成前，代码定义的属性不会被执行，所以到那时，this已经存在了，就可以安全地创建了。

 

每个模块实现的范围

 

 

模块的范围仅允许图部分在其它的对象生命周期中生存。

 

 

用这种方法，例如，我们可以在Activity的生存中创建子图。

 

 

 

我们会用依据需要创自己的建模块：

 

@Module
class HomeModule(val activity: HomeActivity) {
}

 

 

Subcomponent非常类似前面所述方法，表明它会注入HomeActivity：

 

@Singleton
@Subcomponent(modules = arrayOf(HomeModule::class))
interface HomeComponent {
    fun inject(activity: HomeActivity)
}

 

 

AppComponent的plus方法，表示这个组件能够加入到子组件的类型：

interface AppComponent {
    ...
    fun plus(homeModule: HomeModule): HomeComponent
}

 

现在，你就只需要在HomeActivity中声明子组件：

val component by lazy { app.component.plus(HomeModule(this)) }

 

你可在setContentView之后注入它：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    component.inject(this)
}

 

如果你想知道app是从哪里来的，它是一个像这样扩展属性：

val Activity.app: App
    get() = application as App

 

如果您有自己的自定义application，这只是一种避免每次访问它的简单方法。

 

结论

 

在Kotlin中，使用Dagger 2也很容易。你再无有理由在Kotlin中去实现一个很大的解耦架构了。

 

如果你要学习更多的这些并且用Kotlin创建自己的Android APP，就看看免费的指南，学习怎样建立你的第一个项目，或是直接购买这本书，学习怎样从头开始创建一个完整的APP。