Hilt

扩展 Dagger Hilt 的功能，以启用对 androidx 库中某些类的依赖项注入。

此表列出了 androidx.hilt 组中的所有构件。

构件 稳定版 候选版 Beta 版 Alpha 版
hilt-common 1.2.0 - - -
hilt-compiler 1.2.0 - - -
hilt-work 1.2.0 - - -
hilt-navigation 1.2.0 - - -
hilt-navigation-compose 1.2.0 - - -
hilt-navigation-fragment 1.2.0 - - -
此库上次更新于：2024 年 2 月 21 日

反馈

您的反馈有助于改进 Jetpack。如果您发现新问题或有关于改进此库的想法，请告诉我们。在创建新问题之前，请查看此库中 现有问题。您可以通过单击星形按钮对现有问题投票。

创建新问题

有关详细信息，请参阅 问题跟踪器文档。

Hilt 1.2 版

1.2.0 版

2024 年 2 月 21 日

androidx.hilt:hilt-*:1.2.0 已发布。 1.2.0 版包含以下提交内容。

自 1.1.0 版以来的重要更改

  • 将辅助注入支持添加到 hiltViewModel() 和 hiltNavGraphViewModels()。现在，这些函数会接受一个额外的回调，您可以在其中使用传递的辅助工厂来创建辅助注入的 ViewModel。

1.2.0-rc01 版

2024 年 2 月 7 日

androidx.hilt:hilt-*:1.2.0-rc01 已发布。 1.2.0-rc01 版包含以下提交内容。

1.2.0-beta01 版

2024 年 1 月 24 日

androidx.hilt:hilt-*:1.2.0-beta01 已发布。 版本 1.2.0-beta01 包含以下提交。

版本 1.2.0-alpha01

2023 年 12 月 13 日

androidx.hilt:hilt-*:1.2.0-alpha01 已发布。 版本 1.2.0-alpha01 包含以下提交。

API 更改

  • 添加重载的 hiltViewModel() 和 hiltNavGraphViewModels() 函数，用于辅助注入支持。 (Ieb98d)

Hilt 版本 1.1.0

版本 1.1.0

2023 年 11 月 1 日

androidx.hilt:hilt-*:1.1.0 已发布。 版本 1.1.0 包含以下提交。

自 1.0.0 以来主要更改

  • 向 androidx.hilt 添加 KSP 支持。
  • 在 hiltViewModel() 中接受 HasDefaultViewModelProviderFactory。
  • hiltViewModel() API 现在接受可选的键参数。

版本 1.1.0-rc01

2023 年 10 月 18 日

androidx.hilt:hilt-*:1.1.0-rc01 已发布。 版本 1.1.0-rc01 包含以下提交。

版本 1.1.0-beta01

androidx.hilt:hilt-common:1.1.0-beta01、androidx.hilt:hilt-compiler:1.1.0-beta01、androidx.hilt:hilt-work:1.1.0-beta01、androidx.hilt:hilt-navigation:1.1.0-beta01、androidx.hilt:hilt-navigation-compose:1.1.0-beta01 和 androidx.hilt:hilt-navigation-fragment:1.1.0-beta01 已发布。

版本 1.1.0-alpha01

2023 年 8 月 9 日

androidx.hilt:hilt-common:1.1.0-alpha01、androidx.hilt:hilt-compiler:1.1.0-alpha01 和 androidx.hilt:hilt-work:1.1.0-alpha01 已发布。 版本 1.1.0-alpha01 包含以下提交。

新功能

  • 向 androidx.hilt 添加 KSP 支持。 请注意，这是为了准备 Hilt 的 KSP 支持。 为了使用 androidx.hilt 的 KSP 版本，必须发布主 Hilt 支持。

Hilt-Navigation-Fragment 版本 1.1.0

版本 1.1.0-alpha02

2023 年 4 月 19 日

androidx.hilt:hilt-navigation-fragment:1.1.0-alpha02 已发布。 版本 1.1.0-alpha02 包含以下提交。

API 更改

错误修复

  • 修复了 hiltNavGraphViewModel() 无法注入 SavedStateHandle 的问题。 (3ef114、b/272099838)

Hilt-Navigation 版本 1.1.0

版本 1.1.0-alpha02

2023 年 4 月 19 日

androidx.hilt:hilt-navigation:1.1.0-alpha02 已发布。 版本 1.1.0-alpha02 包含以下提交。

版本 1.1.0-alpha01

2022 年 12 月 7 日

androidx.hilt:hilt-navigation:1.1.0-alpha01 已发布。 版本 1.1.0-alpha01 包含以下提交。

Hilt-Navigation-Compose 版本 1.1.0

版本 1.1.0-alpha01

2022 年 12 月 7 日

androidx.hilt:hilt-navigation-compose:1.1.0-alpha01 已发布。 版本 1.1.0-alpha01 包含以下提交。

API 更改

  • hiltViewModel() API 现在接受可选的键参数。 这使您可以使用不同的键获取同一 ViewModel 类型的多个实例。 (I6ee47、b/245139957)

Hilt-Navigation-Compose 版本 1.0.0

版本 1.0.0

2022 年 1 月 26 日

androidx.hilt:hilt-navigation-compose:1.0.0 已发布。 版本 1.0.0 包含以下提交。

1.0.0 的主要功能

androidx.hilt:hilt-navigation-compose 工件提供 API，允许用户使用 :navigation-compose 从 Compose 应用程序中的导航回退栈条目获取带 @HiltViewModel 注释的 ViewModel。

函数 hiltViewModel() 返回现有的 ViewModel，或创建一个新的 ViewModel，该 ViewModel 范围为当前在 NavController 回退栈上的导航图。 该函数可以选择接受 NavBackStackEntry，以将 ViewModel 的范围限定为父回退栈条目。

版本 1.0.0-rc01

2021 年 12 月 15 日

androidx.hilt:hilt-navigation-compose:1.0.0-rc01 已发布，自 1.0.0-beta01 以来没有更改。 版本 1.0.0-rc01 包含以下提交。

版本 1.0.0-beta01

2021 年 11 月 17 日

androidx.hilt:hilt-navigation-compose:1.0.0-beta01 已发布。 版本 1.0.0-beta01 包含以下提交。

API 更改

  • 删除已弃用的 hiltNavGraphViewModel() 函数及其重载。 这些都已被 hiltViewModel() 替换。 (Iaf7d7)

版本 1.0.0-alpha03

2021 年 6 月 16 日

androidx.hilt:hilt-navigation-compose:1.0.0-alpha03 已发布。 版本 1.0.0-alpha03 包含以下提交。

API 更改

  • hiltViewModel() 方法现在与 Lifecycle-ViewModel-Compose 1.0.0-alpha07 中的 viewModel() API 更改保持一致，现在接受可选的 ViewModelStoreOwner 参数，而不是具有无参数版本和仅接受 NavBackStackEntry 的版本。 这使您可以继续使用 hiltViewModel() 访问由 LocalViewModelStoreOwner 提供的默认所有者，或使用 hiltViewModel(navBackStackEntry) 或其他 ViewModelStoreOwner 来指定任何特定所有者。 (I2628d)

版本 1.0.0-alpha02

2021 年 5 月 18 日

androidx.hilt:hilt-navigation-compose:1.0.0-alpha02 已发布。 版本 1.0.0-alpha02 包含以下提交。

API 更改

  • 将 hiltNavGraphViewModel() 重命名为 hiltViewModel()，并删除了 NavController 上的扩展，因为用户可以直接使用 navigation-compose API 从路由获取 NavBackStackEntry。 (I6ef57)

Compose 兼容性

  • androidx.hilt:hilt-navigation-compose:1.0.0-alpha02 仅与 Compose 版本 1.0.0-beta07 及更高版本兼容。

依赖项更新

版本 1.0.0-alpha01

2021 年 3 月 10 日

androidx.hilt:hilt-navigation-compose:1.0.0-alpha01 已发布。 版本 1.0.0-alpha01 包含以下提交。

新功能

  • :hilt-navigation-compose 工件提供 API，允许用户使用 :navigation-compose 从 Compose 应用程序中的导航回退栈条目获取带 @HiltViewModel 注释的 ViewModel。 函数 hiltNavGraphViewModel() 可以接受 NavBackStackEntry 或“路由”字符串，该字符串可用于将 ViewModel 的范围限定为当前回退栈条目或堆栈中的父条目。 (Ia9234)

Hilt 版本 1.1

版本 1.1.0-beta01

2023 年 10 月 4 日

androidx.hilt:hilt-*:1.1.0-beta01 已发布。 版本 1.1.0-beta01 包含以下提交。

androidx.hilt:hilt-*:1.1.0-beta01 已发布，自 1.1.0-alpha* 以来没有更改。

Hilt 版本 1.0.0

版本 1.0.0

2021 年 5 月 5 日

androidx.hilt:hilt-*:1.0.0 已发布。 版本 1.0.0 包含以下提交。

1.0.0 的主要功能

androidx.hilt 工件提供扩展，用于将 Hilt 与其他各种 AndroidX 库集成，例如 WorkManager 和 Navigation。 若要查看功能和示例列表，请查看 集成文档。

版本 1.0.0-beta01

2021 年 3 月 10 日

androidx.hilt:hilt-*:1.0.0-beta01 已发布。 版本 1.0.0-beta01 包含以下提交。

API 更改

  • 从 AndroidX Hilt 工件中删除 @Deprecated 类型，特别是 @androidx.hilt.ViewModelInject 和 @androidx.hilt.Assisted。 请注意，@ViewModelInject 已被 @HiltViewModel 替换。 (I626fe)

版本 1.0.0-alpha03

2021 年 1 月 27 日

androidx.hilt:hilt-*:1.0.0-alpha03 已发布。 版本 1.0.0-alpha03 包含以下提交。

新功能

  • 提供 API，用于从导航 NavBackStackEntry 获取带 @HiltViewModel 注释的 ViewModel。 工件 hilt-navigation-fragment 提供 hiltNavGraphViewModels Kotlin 扩展，而 hilt-navigation 公开 HiltViewModelFactory 工厂方法，该方法接受 NavBackStackEntry 作为参数，并返回可与 ViewModelProvider 或其他 ViewModel 获取 API（如 Compose 的 viewModel() 函数）一起使用的 ViewModelProvider.Facctory：viewModel(HiltViewModelFactory(AmbientContext.current, backStackEntry))。 (I00e67)

API 更改

  • 用 @HiltWorker 替换 @WorkerInject。 @HiltWorker 现在是类型注释，需要在构造函数中使用 @AssistedInject。 (Ic2f15)
  • 弃用 @ViewModelInject。 现在，核心 Hilt Android API 提供了等效的功能 @HiltViewModel。 (I36a41)

错误修复

  • 修复了 AndroidX Hilt 扩展模块无法被 Hilt 正确拾取，导致 Worker 无法创建的问题。 (I3181c、b/159540434)
  • 将 AndroidX Hilt 扩展迁移到 SingletonComponent，消除使用 ApplicationCompoonent 的弃用警告。 (I9c916, b/175849092)

版本 1.0.0-alpha02

2020 年 7 月 22 日

androidx.hilt:hilt-*:1.0.0-alpha02 已发布。 版本 1.0.0-alpha02 包含这些提交。

错误修复

  • 修复了从 @AndroidEntryPoint 注解的类请求非 Hilt 注入的 ViewModel 时出现重复保存状态键的问题。 (b/158737069)
  • 修复了 HiltWorkerFactory 中的一个问题，该问题导致它无法正确初始化使用 @WorkerInject 注解的嵌套 Worker 类。 (b/160524718)

版本 1.0.0-alpha01

2020 年 6 月 10 日

androidx.hilt:hilt-*:1.0.0-alpha01 已发布。 版本 1.0.0-alpha01 包含这些提交。

androidx.hilt 包和库扩展了 Dagger Hilt 的功能，以启用对 androidx 库中某些类的依赖注入。