0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

深入探讨 Hilt的工作原理

谷歌开发者 来源:Android开发者 作者:Android 2021-10-19 15:11 次阅读
所涉主题

  • 多种 Hilt 注解协同工作并生成代码的方式。
  • 当 Hilt 配合 Gradle 使用,Hilt Gradle 插件如何在幕后工作以改善整体体验。

多种 Hilt 注解协同工作并生成代码的方式

Hilt 使用注解处理器生成代码。对注解的处理发生在编译器将源文件转换为 Java 字节码期间。顾名思义,注解处理器作用于源文件中的注解。注解处理器通常会检查注解,并根据注解类型来执行不同的任务,例如代码检查或生成新文件。 在 Hilt 中,三个最重要的注解就是:@AndroidEntryPoint@InstallIn 以及 @HiltAndroidApp
  • @AndroidEntryPoint
    https://dagger.dev/api/latest/dagger/hilt/android/AndroidEntryPoint.html

  • @InstallIn
    https://dagger.dev/api/latest/dagger/hilt/InstallIn.html

  • @HiltAndroidApp
    https://dagger.dev/api/latest/dagger/hilt/android/HiltAndroidApp.html

@AndroidEntryPoint

AndroidEntryPoint 在您的 Android 类中启用字段注入,例如 Activity、Fragment、View 以及 Service。

  • AndroidEntryPoint
    https://dagger.dev/api/latest/dagger/hilt/android/AndroidEntryPoint.html

如下示例所示,通过向 PlayActivity 添加 AndroidEntryPoint 注解,即可轻松将 MusicPlayer 注入到我们的 Activity 中。
@AndroidEntryPointclass PlayActivity : AppCompatActivity() {
  @Inject lateinit var player: MusicPlayer
  // ...}

如果您使用 Gradle,您可能熟悉上文所述的简化语法。但这并不是真实的语法,而是 Hilt Gradle 插件为您提供的语法糖。接下来我们将探讨更多关于 Gradle 插件的内容,在此之前,我们先来看看这个例子在没有语法糖的情况下应该是什么样子的。
@AndroidEntryPoint(AppCompatActivity::class)class PlayActivity : Hilt_PlayActivity() {
  @Inject lateinit var player: MusicPlayer
  // ...}

现在,我们看到原始基类 AppCompatActivityAndroidEntryPoint 注解的真实入参。PlayActivity 实际上继承了生成的类 Hilt_PlayActivity,该类由 Hilt 注解处理器生成,并包含所有执行注入操作需要的逻辑。针对上述内容生成的基类,其代码简化示例如下:

@Generated("dagger.hilt.AndroidEntryPointProcessor")class Hilt_PlayActivity : AppCompatActivity {
  override fun onCreate() {    inject()    super.onCreate()  }
  private fun inject() {    EntryPoints.get(this, PlayActivity_Injector::class).inject(this as PlayActivity);  }}
  • AppCompatActivity
    https://developer.android.google.cn/reference/androidx/appcompat/app/AppCompatActivity

在示例中,生成的类继承自 AppCompatActivity。然而,通常情况下生成的类会继承传入 AndroidEntryPoint 注解的类。这使得注入操作可以在任何您需要的基类中执行。

生成类的主要目的是处理注入操作。为了避免字段在注入之前被意外访问,有必要尽可能早地执行注入操作。因此,对于 Activity,注入操作在 onCreate 中被执行。

在 inject 方法中,我们首先需要一个注入器的实例——PlayActivity_Injector。在 Hilt 中,对于 Activity,注入器是一个入口点,我们可以使用 EntryPoints 工具类获得一个注入器的实例。

您可能想到了,PlayActivity_Injector 也是由 Hilt 注解处理器生成的。格式如下:

@Generated("dagger.hilt.AndroidEntryPointProcessor")@EntryPoint@InstallIn(ActivityComponent::class)interface PlayActivity_Injector {
  fun inject(activity: PlayActivity)
}

生成的注入器是一个被装载到 ActivityComponent 的 Hilt 入口点。它仅包含一个让我们注入 PlayActivity 实例的方法。如果您曾在 Android 应用中使用过 Dagger (不通过 Hilt),您可能会熟悉这些直接在组件上编写的注入方法。

@InstallIn

InstallIn 用于表明模块或者入口点应该被装载到哪个组件中。在如下示例中,我们将 MusicDataBaseModule 装载到 SingletonComponent 中:
@Module@InstallIn(SingletonComponent::class)object MusicDatabaseModule {  // ...}

  • InstallIn
    https://dagger.dev/api/latest/dagger/hilt/InstallIn.html

  • SingletonComponent
    https://dagger.dev/api/latest/dagger/hilt/components/SingletonComponent.html

通过 InstallIn,应用中任何传递依赖项内都可以提供模块和入口点。然而,部分情况下我们需要收集所有由InstallIn 注解提供的内容以获取每个组件的完整模块和入口点。 Hilt 在特定的包下生成了元数据注解,以便更轻松地收集和发现这些由 InstallIn 注解所提供的内容。生成的注解格式如下:
package hilt_metadata
@Generated("dagger.hilt.InstallInProcessor")@Metadata(my.database.MusicDatabaseModule::class)classMusicDatabaseModule_Metadata{}

通过将元数据放进特定的包下,Hilt 注解处理器可以轻松地在您应用中所有的传递依赖项中找到生成的元数据。至此,我们可以使用元数据注解中所包含的信息来找到由 InstallIn 注解所提供内容的自身引用。在本示例中指的是 MusicDatabaseModule

HiltAndroidApp

最后,HiltAndroidApp 注解可以让您的 Android Application 类启用注入。此处,您可以将其视为与 AndroidEntryPoint 注解完全相同。第一步,开发者仅需在 Application 类上添加 @HiltAndroidApp 注解。
@HiltAndroidAppclass MusicApp : Application {
  @Inject lateinit var store: MusicStore
}

  • HiltAndroidApp
    https://dagger.dev/api/latest/dagger/hilt/android/HiltAndroidApp.html

然而,HiltAndroidApp 还有另外一个重要的作用——生成 Dagger 组件。

当 Hilt 注解处理器遇到 @HiltAndroidApp 注解时,会在包装类中生成一些列组件,该包装类与 Application 类同名,前缀为 HiltComponents_。如果您之前使用过 Dagger,这些组件就是添加了 @Component@Subcomponent 注解的类,而在 Dagger 中通常需要您手动编写。

a1b92714-30aa-11ec-82a8-dac502259ad0.png

为了生成这些组件,Hilt 在上述元数据包中查找所有被添加 @InstallIn 注解的类。添加了 @InstallIn 注解的模块被放置在相应组件声明的模块列表中。添加了 @InstallIn 注解的入口点被放置在声明相应组件的父类型的位置。

从这里开始,Dagger 处理器接管并根据 @Component@Subcomponent 注解生成组件的具体实现。如果您曾使用过 Dagger (不通过 Hilt),那么大概率您已经直接处理了这些类。但是,Hilt 对开发者隐藏了这种复杂操作。

这是一篇关于 Hilt 的文章,我们就不详细介绍 Dagger 生成的代码了。如果您有兴趣,详情请查阅:

  • Ron Shapiro 和 David Baker 的演讲:

    https://www.youtube.com/watch?v=wCvXe2LsN5o

  • Dagger codegen 101 的备忘单:

    https://medium.com/androiddevelopers/dagger-code-generation-cheat-sheets-6b4fa2da4e7a

Hilt Gradle 插件

现在您已经了解了 Hilt 中代码生成的工作原理,接下来让我们看看 Hilt Gradle 插件。Hilt Gradle 插件执行很多有用的任务,包括字节码改写和类路径聚合
  • Hilt Gradle 插件

    https://dagger.dev/hilt/gradle-setup#hilt-gradle-plugin

字节码改写

顾名思义,字节码改写就是改写字节码的过程。与注解处理只能生成新代码不同,字节码改写可以修改现有代码。如果谨慎使用,这将是非常强大的功能。

为了说明我们为何在 Hilt 中使用字节码改写,让我们回到 @AndroidEntryPoint

@AndroidEntryPoint(AppCompatActivity::class)class PlayActivity : Hilt_PlayActivity {
  override fun onCreate(…) {    val welcome = findViewById(R.id.welcome)  }
}
虽然继承 Hilt_PlayActivity 基类在实践中有效,但它可能会导致 IDE 报错。由于生成的类在您成功编译代码后才存在,因此您经常会在 IDE 中看到红色波浪线。此外,您将无法享有诸如方法重载这种自动补全的能力,并且您将无法访问基类中的方法。 失去这些功能不仅会降低您的编码速度,而且这些红色波浪线也会极大程度地分散您的注意力。 Hilt Android 插件通过在您的类上添加 AndroidEntryPoint 注解来启动字节码改写。启用 Hilt Android 插件后,您只需要在类上添加 @AndroidEntryPoint 注解,同时您可以使其继承普通的基类。
@AndroidEntryPointclass PlayActivity : AppCompatActivity { // <-- 无需引用生成的基类
  override fun onCreate() {    val welcome = findViewById(R.id.welcome)  }}

由于此语法无需引用生成的基类,所以不会引起 IDE 报错。在字节码改写期间,Hilt Gradle 插件会将您的基类替换为 Hilt_PlayActivity。由于此过程直接操作字节码,对开发者是不可见的。

然而,字节码改写仍有一些缺点:

  • 该插件必须修改底层字节码,而不是源代码,这容易出错。

  • 因为在改写操作时字节码已经被编译,所以问题通常出现在运行时而不是编译时。

  • 改写操作使调试变得复杂,因为当出现问题时,源文件可能并不代表当前正在执行的字节码。


由于这些原因,Hilt 尝试尽可能减少依赖字节码改写。

类路径聚合

最后,让我们看看 Hilt Gradle 插件的另一个有用功能: 类路径聚合。要了解什么是类路径聚合,以及为什么需要它,让我们看另一个示例。

在本示例中 :app 依赖一个独立的 Gradle 模块 :database:app:database 都提供了被 InstallIn 注解的模块。

如您所见,Hilt 会在特定的 hilt_metadata 包下生成元数据,在生成组件时,会用它们查找所有被添加 @InstallIn 注解的模块。

不使用类路径聚合的处理对于单层依赖关系仍然可以正常工作,现在让我们看看当添加另一个 Gradle 模块 :cache 作为 :database 的依赖项时会发生什么。

:cache 被编译时,虽然它会生成元数据,但在编译 :app 时该元数据无法使用,因为它是一个传递依赖项。因此,Hilt 无法知晓 CacheModule,它会意外地从生成的组件中排除。 当然,您可以使用 api 而不是 implementation 声明 :cache 的依赖关系,从而在技术层面解决这个问题,但不推荐这样做。使用 api 不仅会让增量构建变得更糟糕,还把维护工作也变成一场噩梦。 这就是 Hilt Gradle 插件发挥作用的地方。

即使使用 implementation,Hilt Gradle 插件也可以自动从 :app 的传递依赖项中聚合所有的类。

此外,与直接使用 api 相比,Hilt Gradle 插件还具有许多优点。

首先,对比在整个应用中手动使用 api 依赖关系,类路径聚合更不容易出错并且不需要维护。您可以像往常一样简单地使用 implementation,其余的将由 Hilt Gradle 插件处理。

其次,Hilt Gradle 插件仅在应用级别聚合类,因此与使用 api 不同,项目中库的编译不受影响。

最后,类路径聚合为您的依赖项提供了更好的封装,因为不可能在源文件中意外引用这些类,并且它们不会出现在代码补全提示中。

总结

本文我们揭示了各种 Hilt 注解协同工作以生成代码的方式。 我们还关注了 Hilt Gradle 插件,并了解它是如何在幕后使用字节码改写和类路径聚合,让 Hilt 的使用变得更安全、更轻松。
编辑:jq
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 处理器
    +关注

    关注

    68

    文章

    19388

    浏览量

    230561
  • API
    API
    +关注

    关注

    2

    文章

    1508

    浏览量

    62229
  • 代码
    +关注

    关注

    30

    文章

    4813

    浏览量

    68838

原文标题:Hilt 工作原理 | MAD Skills

文章出处:【微信号:Google_Developers,微信公众号:谷歌开发者】欢迎添加关注!文章转载请注明出处。

收藏 人收藏

    评论

    相关推荐

    深入探讨Linux系统中的动态链接库机制

    异常或崩溃。为深入理解动态链接机制及其工作原理,我重温了《程序员的自我修养》,并通过实践演示与反汇编分析,了解了动态链接的过程。 本文将深入探讨Linux系统中的动态链接库机制,这其中包括但不限于全局符号介入(Global Sy
    的头像 发表于 12-18 10:06 167次阅读
    <b class='flag-5'>深入探讨</b>Linux系统中的动态链接库机制

    光耦合器的工作原理

    光耦合器 ,也被称为光隔离器,几十年来一直是电子学的重要组件,为信号隔离提供了关键功能。它们广泛应用于各个行业,包括工业自动化和消费电子产品中,确保系统不同部分之间的电气隔离,这对安全性和性能至关重要。本文将深入探讨光耦合器的结构、工作原理及其应用。
    的头像 发表于 09-04 17:44 501次阅读
    光耦合器的<b class='flag-5'>工作原理</b>

    深入剖析测速传感器:工作原理、种类及应用领域

    的速度信息,为各种应用场景提供了关键数据支持。本文将深入探讨测速传感器的工作原理、种类及其在各领域的应用。 测速传感器的工 作原理 测速传感器的工作原理多种多样,但核心目标都是将物体的速度信息转化为可测量的电信号
    的头像 发表于 08-15 18:20 1191次阅读

    深入探讨Linux的进程调度器

    ,以及其运行的顺序。这篇文章将详细探讨Linux进程调度器的工作原理、主要算法、调度策略以及其在实际操作中的应用。
    的头像 发表于 08-13 13:36 971次阅读
    <b class='flag-5'>深入探讨</b>Linux的进程调度器

    旋转式编码器的工作原理和特点

    旋转式编码器,作为现代工业自动化系统中不可或缺的一部分,其工作原理和特点对于理解其应用及优化系统性能具有重要意义。本文将详细阐述旋转式编码器的工作原理,并深入探讨其特点,旨在为读者提供全面、
    的头像 发表于 05-29 16:01 1358次阅读

    压电换能器的工作原理、特点及应用

    压电换能器,作为一种能够实现电能与机械能之间相互转换的器件,其独特的工作原理和广泛的应用特点使其在多个领域发挥着重要作用。本文将详细阐述压电换能器的工作原理,并深入探讨其应用特点,以期为相关领域的研究和应用提供参考。
    的头像 发表于 05-24 16:17 2579次阅读

    触摸传感器的工作原理、应用及类型

    中的不可或缺性。本文将深入探讨触摸传感器的工作原理、应用以及主要类型,以期为读者提供全面而深入的理解。
    的头像 发表于 05-24 15:20 2506次阅读

    计数器的结构和工作原理

    计数器,作为一种基础的电子设备,广泛应用于数字电路、计算机系统以及工业自动化等多个领域。它通过对输入信号进行计数和状态转换,实现对事件发生次数的统计和显示。本文将深入探讨计数器的定义、结构、工作原理以及其在各领域的应用,旨在为读者提供全面且
    的头像 发表于 05-23 15:34 5226次阅读

    达林顿晶体管的工作原理与主要特性

    在电子工程中,晶体管是一种广泛应用的半导体器件,它能够控制电流的流动。在众多晶体管类型中,达林顿晶体管(Darlington Transistor)以其独特的工作原理和显著的特性而备受瞩目。本文将深入探讨达林顿晶体管的工作原理
    的头像 发表于 05-22 16:49 1500次阅读

    隔离器的工作原理和作用

    在现代电子和电气系统中,隔离器是一种至关重要的设备,其在信号传输、电源隔离、电磁干扰抑制等方面发挥着不可替代的作用。本文将深入探讨隔离器的工作原理和作用,以期为读者提供全面的理解和应用指导。
    的头像 发表于 05-22 16:45 4280次阅读

    压敏电阻的定义、作用及工作原理

    在电子电路的世界里,各种电子元器件扮演着各自独特的角色,它们共同构成了电子设备的复杂网络。其中,压敏电阻作为一种特殊的电子元器件,在电路中发挥着至关重要的作用。本文将深入探讨压敏电阻的定义、作用以及工作原理,以期为读者提供全面而深入
    的头像 发表于 05-22 15:12 3119次阅读

    PCS储能变流器的工作原理

    随着全球能源结构的转型与可再生能源的快速发展,储能技术成为了解决能源供需不平衡、提高能源利用效率的关键技术之一。在储能系统中,储能变流器(PCS,Power Conversion System)作为关键设备,其重要性不容忽视。本文将对PCS储能变流器的定义、工作原理以及其在储能系统中的作用进行
    的头像 发表于 05-20 16:07 4875次阅读

    光伏储能逆变器的工作原理及其特点

    光伏储能逆变器是可再生能源领域中的关键设备,其工作原理和应用范围在推动绿色能源发展中起着至关重要的作用。本文旨在深入探讨光伏储能逆变器的工作原理及其在不同领域的应用。
    的头像 发表于 05-20 14:45 1277次阅读

    激光打标机工作原理介绍

    激光打标机,作为现代标识技术的杰出代表,其工作原理的高效与精确性使得它在众多行业中占据了举足轻重的地位。今天,我们将深入探讨激光打标机的工作原理及其背后的科技魅力。激光打标机的工作原理
    的头像 发表于 03-08 19:45 1551次阅读
    激光打标机<b class='flag-5'>工作原理</b>介绍

    理想二极管工作原理与应用领域的解析

    然实际的二极管会受到一些非理想因素的影响,但理想二极管模型在电子电路设计和应用中仍然具有广泛的应用。本文将深入探讨理想二极管的工作原理和一些典型的应用领域。
    的头像 发表于 03-05 15:32 7975次阅读
    理想二极管<b class='flag-5'>工作原理</b>与应用领域的解析