Hilt-Android Jetpack推荐的依赖注入库【译】

2020-07-29 本文已影响0人秦军锐士

1_gqsETASsCZHY2m0XyEYTMQ.png

依赖注入（DI）是一种广泛用于编程的技术，非常适合Android开发，在Android开发中，将依赖项提供给类而不是自己创建依赖项。通过遵循DI原则，您将为良好的应用程序体系结构，更高的代码可重用性和易于测试奠定基础。您是否曾经尝试过在应用程序中进行手动依赖项注入？即使使用当今许多现有的依赖项注入库，由于您的项目越来越大，它仍需要大量样板代码，因为您必须手动构造每个类及其依赖项，并创建容器以重用和管理依赖项。

通过遵循DI原则，您将为良好的应用程序架构，更高的代码可重用性和易于测试奠定基础。

通过为项目中的每个Android类提供容器并为您自动管理其生命周期，新的Hilt库定义了一种在应用程序中执行DI 的标准方法。Hilt目前处于Alpha状态，请在您的应用中进行尝试，并使用此链接向我们提供反馈。

Hilt基于流行的DI库Dagger构建，因此可以从Dagger提供的编译时间正确性，运行时性能，可伸缩性和Android Studio支持 中受益。因此，Dagger在Google Play商店的前10k顶级应用中占74％。但是，由于生成了编译时代码，因此预期编译时间会增加。

由于许多Android框架类是由操作系统本身实例化的，因此在Android应用中使用Dagger时会有一个关联的样板。与Dagger不同，Hilt与Jetpack库和Android框架类集成在一起，并删除了大部分样板，使您可以专注于定义和注入绑定的重要部分，而不必担心管理所有Dagger设置和接线。它会自动生成并提供：

用于将Android框架类与Dagger 集成的组件，否则需要手工创建。
Hilt自动生成的组件的范围注释。
预定义的绑定和限定符。

最重要的是，由于Dagger和Hilt可以共存，因此可以根据需要迁移应用程序。

行动中

只是为了向您展示Hilt的易用性，让我们在典型的Android应用中执行一些快速的DI。让我们希尔特注入一个AnalyticsAdapter到我们MainActivity。

首先，使用注释您的应用程序类@HiltAndroidApp以触发Hilt的代码生成，从而在您的应用程序中启用Hilt ：

@HiltAndroidApp
class MyApplication : Application() { ... }

其次，告诉Hilt如何AnalyticsAdapter通过为其构造函数添加注释来提供实例@Inject：

class AnalyticsAdapter @Inject constructor() { ... }

第三，注入一个实例的AnalyticsAdapter进入MainActivity，在与所述活性使剑柄@AndroidEntryPoint注释和使用该执行字段注入@Inject注释：

@AndroidEntryPoint
class MainActivity : AppCompatActivity() {
  @Inject lateinit var analytics: AnalyticsAdapter
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // analytics instance has been populated by Hilt
    // and it's ready to be used
  }
}

有关更多信息，您可以在下面的备忘单部分中轻松查看新注释的功能。

随附Jetpack支持！

您可以在开箱即用的情况下使用喜爱的Jetpack库。在此版本中，我们为ViewModel和WorkManager提供直接注入支持。

例如，注入一个Architecture Components ViewModel LoginViewModel为LoginActivity：注释LoginViewModel用@ViewModelInject，并在活动或如你所期望的片段使用它：

class LoginViewModel @ViewModelInject constructor(
  private val analyticsAdapter: AnalyticsAdapter
): ViewModel { ... }
@AndroidEntryPoint
class LoginActivity : AppCompatActivity() {
  private val loginViewModel: LoginViewModel by viewModels()
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // loginViewModel is ready to be used
  }
}

在文档中了解有关Jetpack支持的更多信息。

开始使用Hilt

如果您对Hilt感兴趣，并想了解更多有关此的信息，请按照以下偏好的方式学习一些资源：

Hilt入门

借助本指南，了解如何在您的Android应用中添加Hilt 。

文献资料

如果您不熟悉DI或Dagger，请查看我们的指南，将Hilt添加到Android应用中。另外，如果您已经了解Dagger，我们还将提供有关dagger.dev的文档。

如果您只是对新的注解以及Hilt的功能感到好奇，请在下面的部分中查看该备忘单。

对于Dagger用户

如果您已经在应用程序中使用了Dagger或dagger.android，请查看此迁移指南或下面提到的代码实验室，以帮助您切换到Hilt。由于Dagger和Hilt可以共存，因此您可以逐步迁移应用程序。

代码实验室

为了逐步学习Hilt，我们刚刚发布了两个代码实验室：

样例代码

您想查看在现有应用中如何使用Hilt吗？在Google I / O 2020应用程序和dev-hiltAndroid 体系结构示例Github存储库的分支中检查其用法。

反馈

Hilt目前处于Alpha状态，请在您的应用中进行尝试，并使用此链接向我们提供反馈。

备忘单

这种小抄可以让你很快看到什么不同的希尔特和匕首注释做，如何使用它们。

原文链接：https://medium.com/androiddevelopers/dependency-injection-on-android-with-hilt-67b6031e62d