开源库

Hilt入门

2020-12-30  本文已影响0人  如沙雨下

Hilt 是什么

Hilt 是 Android 的依赖项注入库，可减少在项目中执行手动依赖项注入的样板代码。执行手动依赖项注入要求您手动构造每个类及其依赖项，并借助容器重复使用和管理依赖项。

Hilt 通过为项目中的每个 Android 类提供容器并自动管理其生命周期，提供了一种在应用中使用 DI（依赖项注入）的标准方法。Hilt 在热门 DI 库 Dagger 的基础上构建而成，因而能够受益于 Dagger 的编译时正确性、运行时性能、可伸缩性和 Android Studio 支持。

依赖注入是什么

一个类里面有一个变量，这个变量就是这个类的依赖。然后通过外部注入对这个变量进行赋值，这种就叫做依赖注入

工厂、Builder模式、带参数的构造函数这些都属于依赖注入

引入Hilt

首先，将 hilt-android-gradle-plugin 插件添加到项目的根级 build.gradle 文件中：

buildscript {
   ...
   dependencies {
   ...
   classpath 'com.google.dagger:hilt-android-gradle-plugin:2.28-alpha'
 }
}

然后，应用 Gradle 插件并在 app/build.gradle 文件中添加以下依赖项：

apply plugin: 'kotlin-kapt'
apply plugin: 'dagger.hilt.android.plugin'
android {
   ...
}

dependencies {
   implementation "com.google.dagger:hilt-android:2.28-alpha"
   kapt "com.google.dagger:hilt-android-compiler:2.28-alpha"
}

Hilt 使用 Java 8 功能。如需在项目中启用 Java 8，请将以下代码添加到 app/build.gradle 文件中：

android {
 ...
 compileOptions {
 sourceCompatibility JavaVersion.VERSION_1_8
 targetCompatibility JavaVersion.VERSION_1_8
 }
}

Hilt基本使用

接口注入

首先需要一个接口，和一个实现类

interface PayMethod {
    fun startPay()
}

class WxPay @Inject constructor() : PayMethod {
     override fun startPay() {
     println("WxPay start.")
   }
}

接着就需要新建一个 Module。用来实现接口的注入

@Module
@InstallIn(ApplicationComponent::class)
abstract class PayModule {
   @Binds
   abstract fun bindWxPay(wxPay: WxPay): PayMethod
}

注意：这个 Module 是抽象的。

使用如下：

 @Inject
 lateinit var wxPay: PayMethod

 fun payOrder() {
   wxPay.startPay()
   println("print address ${addressInfo.province}")
   wxPay.getPayResult()
 }

给相同类型注入不同的实例

还是上面的 PayMethod 接口，有两个不同的实现，如下：

class WxPay @Inject constructor() : PayMethod {
     override fun startPay() {
     println("WxPay start.")
}

 override fun getPayResult() {
     println("WxPay getPayResult.")
 }
}

class ZfbPay @Inject constructor() : PayMethod {

 override fun startPay() {
   println("ZfbPay start.")
 }

 override fun getPayResult() {
   println("ZfbPay getPayResult.")
 }
}

接着定义两个注解

@Qualifier
annotation class BindWxPay

@Qualifier
annotation class BindZfbPay

然后修改 Module ,在 module 中用来标记相应的依赖。

@Module
@InstallIn(ApplicationComponent::class)
abstract class PayModule {

   @BindWxPay
   @Binds
   abstract fun bindWxPay(wxPay: WxPay): PayMethod

   @BindZfbPay
   @Binds
   abstract fun bindZfbPay(zfbPay: ZfbPay): PayMethod
}

最后使用如下：

 @BindWxPay
 @Inject
 lateinit var wxPay: PayMethod

 @BindZfbPay
 @Inject
 lateinit var zfbPay: PayMethod

 fun payOrder() {
   wxPay.startPay()
   zfbPay.startPay()
   wxPay.getPayResult()
   zfbPay.getPayResult()
 }

Hilt还提供了2个预置Qualifier限定符@ActivityContext和@ApplicationContext ，可以直接作为@Provides方法或@Inject构造的参数使用。

class AnalyticsAdapter @Inject constructor(

   @ActivityContext private val context: Context,

   private val service: AnalyticsService

) { ... }

第三方组件注入

Hilt 支持最常见的 Android 类 Application、Activity、Fragment、View、Service、BroadcastReceiver 等等，但是您可能需要在Hilt 不支持的类中执行依赖注入，在这种情况下可以使用 @EntryPoint 注解进行创建，Hilt 会提供相应的依赖。

Hilt 中的组件(Compenent)、生命周期、作用域

使用 @Module 注解的类，需要使用 @Installin 注解来指定 module 的范围。

例如 @InstallIn(ApplicationComponent::class) 注解的 Module 就会绑定到 Application 的生命周期上。

Hilt 提供了以下组件来绑定依赖与对应 Android 类的活动范围

Hilt 组件 对应 Android 类活动的范围
ApplicationComponent Application
ActivityRetainedComponent ViewModel
ActivityComponent Activity
FragmentComponent Fragment
ViewComponent View
ViewWithFragmentComponent View annotated with @WithFragmentBindings
ServiceComponent Service

Hilt 没有为 broadcast receivers 提供组件，因为 Hilt 直接进从 ApplicationComponent 中注入 broadcast receivers。

Hilt 会根据相应的 Android 类生命周期自动创建和销毁组件的实例，对应关系如下：

Hilt 提供的组件 创建对应的生命周期 结束对应的生命周期 作用域
ApplicationComponent Application#onCreate() Application#onDestroy() @Singleton
ActivityRetainedComponent Activity#onCreate() Activity#onDestroy() @ActivityRetainedScope
ActivityComponent Activity#onCreate() Activity#onDestroy() @ActivityScoped
FragmentComponent Fragment#onAttach() Fragment#onDestroy() @FragmentScoped
ViewComponent View#super() View destroyed @ViewScoped
ViewWithFragmentComponent View#super() View destroyed @ViewScoped
ServiceComponent Service#onCreate() View destroyed @ViewScoped

在@InstallIn模块中确定绑定范围时，绑定上的范围必须与component的范围匹配。例如，@InstallIn(ActivityComponent.class)模块内的绑定只能用限制范围@ActivityScoped。

例如我们需要在App中共享OkHttp的配置：

@Module
@InstallIn(ApplicationComponent::class)
class NetworkModule {

   @Singleton
   @Provides
   fun provideOkHttpClient(): OkHttpClient {
   return OkHttpClient.Builder()
       .connectTimeout(20, TimeUnit.SECONDS)
       .readTimeout(20, TimeUnit.SECONDS)
       .writeTimeout(20, TimeUnit.SECONDS)
       .build()
   }
}

默认情况下，Hilt 中的所有绑定都未限定作用域。这意味着，每当应用请求绑定时，Hilt 都会创建所需类型的一个新实例

ViewModel

图 1. Android 应用的应用图表模型

各个类之间的依赖关系可以表示为图表，其中每个类都连接到其所依赖的类。所有类及其依赖关系的表示法便构成了应用图表。在图 1 中，您可以看到应用图表的抽象呈现。当 A 类 (ViewModel) 依赖于 B 类 (Repository) 时，有一条从 A 指向 B 的直线表示该依赖关系。

依赖项注入有助于建立这些链接并使您可以更换实现以进行测试。例如，在测试依赖于代码库的 ViewModel 时，您可以通过伪造或模拟传递 Repository 的不同实现，以测试不同的情形。

对于ViewModel这种常用Jetpack组件，Hilt专门为其提供了一种独立的依赖注入方式

dependencies {
   ...
   implementation 'androidx.hilt:hilt-lifecycle-viewmodel:1.0.0-alpha02'
   kapt 'androidx.hilt:hilt-compiler:1.0.0-alpha02'
}


class MyViewModel @ViewModelInject constructor(private val repository: Repository) : ViewModel() {

   fun doWork() {
       repository.doRepositoryWork()
   }
}

参考资料：https://developer.android.google.cn/training/dependency-injection/hilt-android

上一篇下一篇

猜你喜欢

热点阅读