自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数HarmonyOS鸿蒙开发工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则几千的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年HarmonyOS鸿蒙开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上HarmonyOS鸿蒙开发知识点,真正体系化!
由于文件比较大,这里只是将部分目录大纲截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新
如果你觉得这些内容对你有帮助,可以添加VX:vip204888 (备注鸿蒙获取)
一个人可以走的很快,但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎扫码加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
1. 从 Dagger 的本质说起
一言以蔽之, Dagger 的本质就是一棵 Component Tree (组件树)。
1.1 Component :依赖注入容器
component 是 Dagger 中的核心概念,我们通过 @Component
注解定义并生成代码。component 作为依赖注入容器,身兼工厂、仓库、物流三种角色于一身。Dagger 中的很多重要注解也是服务于它的这三个身份:
@Module
和@Provides
为 comopnent 安装了生产依赖对象所需的”工厂”;@Singleton
等作用域注解将依赖以单例形式存储在 component 这个“仓库”中,被更多地方共享;@Inject
为 component 提供送货上门的“物流”的能力,标记被注入的目标的字段,将依赖注入其中。
以下是使用 Dagger 定义的 ApplicationComponent
,为它为 App 注入所需的 userRepo
成员。
1.2 Tree:对应用层级关系的反映
一个应用往往都有层级结构。例如一个 Android 项目中从上到下有 Application -> Activity -> Fragment
等多层,每层可访问对象的生命周期长度不同:
UserRepository
:服务整个Application
LoginViewModel
:只在LoginActivity
范围可见。
当我们使用 Dagger 来管理这些依赖对象时,需要有相对应的 component 提供不同“保鲜期”的仓库。
此外,由于依赖对象之间有依赖关系。例如 LoginViewModel
需要使用 UserRepository
,因此对应 component 也产生了继承关系,LoginActivityComponent
依赖 ApplicationComponent
的实例来构建自己的实例,component 之间形成父子关系,进而构成一棵组件树。
2. 使用 @Subcomponent 构建组件树
Dagger 使用 @Subcomponent
定义子组件进而形成组件树。
2.1 定义子组件
在组件的定义上,@Subcomponent
和 @Component
没有区别,需要以此声明组件依赖的 module(非必须),注入的目标,以及创建子组件所需要的工厂。此外还需要一个自定义作用域注解 @ActivityScope
,它是 @Scope
的派生类,表明当前子组件的生命周期。
2.2 建立组件父子关系
子组件不能直接关联父组件,需要借助 Module 安装到父组件。
如上,通过 SubcomponentsModule
子组件 LoginActivityComponent
被安装到父组件 ApplicationComponent
中,同时父组件中声明了子组件的工厂,意味着父组件可以创建子组件。
2.3 使用子组件注入
因为组件之间有继承关系,子组件或需要依赖父组件构建自己的示例。因此,我们不能凭空构建子组件,需要通过父组件来构建,建立内在依赖关系
如上,在合适的时机,LoginActivity
通过父组件提供的工厂创建子组件,完成对自身的注入。
2.4 Boilerplate 问题
前面的介绍可以感受到,@Subcomponent
构建组件树过程中带来了比较多的模板代码:
- 子组件中提供
Subcomponent.Factory
- 父组件中需要声明子组件的工厂
- 合适的时机通过父组件创建子组件完成注入。
随着项目中的 activity 、fragment 等越来越多,上述类似的代码会反复出现,影响大家使用 Dagger 的积极性。为了解决这个问题 dagger.android 和 Hilt 相继问世。
3. Dagger.android:代码生成组件树
dagger.android 是 Dagger 针对 Android 项目推出的子项目,核心思想是通过代码生成 subcomponent,降低 Andorid 项目中的模板代码。dagger.android 是独立于 Dagger 的库,工程中需要单独依赖:
//raw dagger2
implementation 'com.google.dagger:dagger:2.x'
kapt 'com.google.dagger:dagger-compiler:2.x'
//dagger.android
implementation 'com.google.dagger:dagger-android:2.x'
implementation 'com.google.dagger:dagger-android-support:2.x'
kapt 'com.google.dagger:dagger-android-processor:2.x'
我们看一下引入 dagger.android 后的效果:
关键变化是新增了 @ContributesAndroidInjector
注解,它标记了一个返回值为 LoginActivity
的方法,其含义是编译期生成 LoginActivity
对应的子组件。因此我们无需再显示地通过 @Subcomponent
和 @Subcomponent.Factory
声明子组件了,SubcomponentsModule
中也无需添加 subcomponents
依赖。
3.1 @ContributesAndroidInjector 生成子组件
看一下 @ContributesAndroidInjector
生成的完整代码:
可以看到我们少写的代码,这里都生成了。LoginActivitySubcomponent
是子组件, SubcomponentsModule_ContributesLoginActivity
是用来安装子组件的 module。
3.2 DispatchingAndroidInjector 提供组件映射
特别值得一提的是代码中有一个 bindAndroidInjectorFactory
方法并携带了 @IntoMap
, @ClassKey
等若干注解,它们可以编译期 Dagger 构建依赖链条的过程中,向 DispatchingAndroidInjector
类填充一个 map,即其 injectorFactories
成员:
透过 map 的泛型定义不难推测,它是 Android class 与其对应子组件的工程的映射表,具体到前面 LoginActivity
的例子中,会填入 LoginActivity.class to LoginActivitySubcomponent.Factory
到 map 中
我们在 App 中声明 androidInjector
成员,并通过 Dagger 注入 DispatchingAndroidInjector
实例。App 通过 HasAndroidInjector
接口对外宣称自己持有一个 androidInjector
,可以为各个 Activity 提供注入。
如上,在 LoginActivity
中,我们不再需要通过父组件的工厂创建子组件,调用一个 AndroidInjection.inject
静态方法即可完成注入。静态方法内部会向上寻找 HasAndroidInjector
,然后通过映射表创建注入所需的子组件。
当然享受便利的同时,也要付出义务,LoginActivity
也需要实现 HasAndroidInjector
,并声明 androidInjector
,向下为它的 fragment 们提供注入。
3.3 dagger.android 的问题
dagger.andriid 主要做了下面两件事,帮我们减少了模板代码 :
- 通过 @ContributesAndroidInjector 生成 subcomponent 及其 factory,省去了我们显示地定义子组件,父组件也不需要再声明 Subcomponent.Factory
- 让 Android 各层级对象持有 AndroidInjector,通过静态方法完成对低层级对象的注入,省去了显示地创建子组件完成注入
dagger.android 虽然做出上述改善,但是代价是引入了一些新的模板代码 :
- 需要配置 @ContributesAndroidInjector
- Android 组件需要实现 HasAndroidInjector 接口,并注入 AndroidInjector 成员
- 需要手动调用 AndroidInjection.inject
4. Hilt:预定义组件树
dagger.android 没有存在模板代码,所以诞生了 Hilt,后者的思想是通过 “预定义” 的方式彻底消灭模板代码。
plugins {
id 'kotlin-kapt'
id 'com.google.dagger.hilt.android'
}
dependencies {
implementation "com.google.dagger:hilt-android:2.x"
kapt "com.google.dagger:hilt-compiler:2.x"
}
4.1 预定义 Component
相对于 dagger.android 帮我们生成 LoginActivitySubComponent
, Hilt 中索性不允许自定义的 subcomponent,提供了预定义的 ActivityComponent
作为所有 activity 共享的提供注入的组件。而 LoginActivityModule
等原本安装到 LoginActivitySubComponent
的依赖,通过 @installIn
注解安装到 ActivityComponent
中。
ActivityComponent
是个 interface,编译期生成实现类 ActivityC
:
modules 中可以看到各 activity 依赖的 XXXActivityModule
都被 instllIn
中 ActivityC
中,ActivityC
可以为所有 activity 提供注入。
FragmentCBuilderModule
和 ViewCBuilderModule
用来安装 Hilt 另外两个预定义组件 FragmentComponent
和 ViewComponent
,Hilt 为 Android 中的关键概念都提供了对应的预定义组件,且将它们建立树行关系。
4.2 预定义 Inject
dagger.android 通过提供静态方法注入降低了 inject 的成本。而在 Hilt 中,inject 的成本趋近于零,只需要在 activity 等 Android 组件添加 @AndroidEntryPoint
注解,其他什么都不用做。
前面看到 ActivityC
实现了 XXXActivity_GeneratedInjector
接口,这些接口就是 @AndroidEntryPoint
的产物
LoginActivity_GeneratedInjector
提供了面向 LoginActivity
的 inject()
方法,并通过 @EntryPoint
安装到 ActivityComponent
中,这样编译后 ActivityC
就具备了 injectLoginActivity
的能力。
@EntryPoint 是 Hilt 的重要注解,因为我们没法在 Hilt 的预定义 Component 中添加 inject 方法,所以当我们希望 Hilt 为自定义类提供注入时,可以自定义 inject 接口,通过
@EntryPoint
安装到 Hilt 的预定义组件中。@AndroidEntryPoint
只不过是针对 Android 类提前生成了@EntryPoint
代码。
那么 LoginActivity
是什么时候调用 ActivityC
的 injectLoginActivity
完成自身注入的呢?Hilt 会为 LoginActivity
生成一个 activity 的派生类,它在合适的时间点调用 inject()
,内部会调用 ActivityC#injectLoginActivity
而 Hilt 通过 Transform + ASM,让编译后 LoginActivity
继承了 Hilt_LoginActivity
,这样就可以在不写任何代码的情况下,让 LoginActivity
基于 Hilt 的 ActivityC
完成注入,即所谓的 “预定义 inject”。
4.3 预定义 @Scope
Dagger 在 Android 中使用时,往往需要需要自定义作用域注解表明不同 Android 类的生命周期。Hilt 伴随着预定义组件,也提供了与之对应的预定义作用域注解
例如,添加了 @ActivityScoped
注解,表示 provides
的对象在 ActivityComponent
范围内以单例存在。
Hilt 为所有的关键的 Android 类都提供了预定义组件和相对应的预定义作用域注解,所以也可以说 Hilt 对整棵组件树进行了预定义:
5. 渐进式迁移
通过前面介绍,我们能感受到 Hilt 对 Dagger 的 Boilerplate 问题进行了比较彻底的改进,建议大家尽快升级到 Hilt。从组件树的视角来理解 Dagger 与 Hilt 的区别,可以帮助我们完成渐进式的升级。
最安全的升级过程就是从沿着组件树的树干,按照 Application -> Activity -> Fragment -> ...
的顺序,将 Dagger 的自定义组件合并到 Hilt 的预定义组件,最终实现依赖注入完全托管到 Hilt 树。
142.webp?x-oss-process=image/format,png)
5. 渐进式迁移
通过前面介绍,我们能感受到 Hilt 对 Dagger 的 Boilerplate 问题进行了比较彻底的改进,建议大家尽快升级到 Hilt。从组件树的视角来理解 Dagger 与 Hilt 的区别,可以帮助我们完成渐进式的升级。
最安全的升级过程就是从沿着组件树的树干,按照 Application -> Activity -> Fragment -> ...
的顺序,将 Dagger 的自定义组件合并到 Hilt 的预定义组件,最终实现依赖注入完全托管到 Hilt 树。