Kotlin怎样使用Android的Dagger2

作者:Antonio Leiva

时间:Apr 11, 2017

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

Kotlin怎样使用Android的Dagger2

在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。

相关推荐