Hilt

擴充 Dagger Hilt 的功能，以便從 AndroidX 程式庫中 將特定 類別的 依附軟件 注入。

這個 資料表 會列出 androidx.hilt 群組 中 的所有 人工製品。

構件 穩定版 候選版 Beta 版 Alpha 版
hilt-common 1.2.0 - - 1.3.0-alpha01
hilt-compiler 1.2.0 - - 1.3.0-alpha01
hilt-work 1.2.0 - - 1.3.0-alpha01
hilt-navigation 1.2.0 - - 1.3.0-alpha01
hilt-navigation-compose 1.2.0 - - 1.3.0-alpha01
hilt-navigation-fragment 1.2.0 - - 1.3.0-alpha01
這個程式庫的上次更新日期：2025 年 5 月 7 日

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

Hilt 1.3 版

1.3.0-alpha01 版本

2025 年 5 月 7 日

發布 androidx.hilt:hilt-*:1.3.0-alpha01。1.3.0-alpha01 版包含這些修訂版本。

API 變更

  • 更新程式庫和註解處理工具，以指定 Kotlin 2.0 為目標，以便支援較新的 Kotlin 工具鍊，包括 KSP2。

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，或建立一個新的，以將範圍限制為 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)

組成 相容性

  • androidx.hilt:hilt-navigation-compose:1.0.0-alpha02 只與 1.0.0-beta07 以上的 Compose 版本相容。

依附元件 更新

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 或一個「route」字串，可用於將 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 和 導航 整合。如欲 查看 功能 清單 和 範例 請參閱 整合 說明文件。

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，以便 從 一個 Navigation NavBackStackEntry 擷取 @HiltViewModel 註記的 ViewModel。 當 hilt-navigation 暴露在 NavBackStackEntry 內作為引數的 HiltViewModelFactory 工廠方法，並回傳可和 ViewModelProvider 或其他擷取 API 的 ViewModel 的 ViewModelProvider.Facctory 時，hilt-navigation-fragment 構件可提供 hiltNavGraphViewModels Kotlin 擴充功能，如 Compose 的 viewModel() 函式：viewModel(HiltViewModelFactory(AmbientContext.current, backStackEntry))。(I00e67)

API 異動

  • 以 @HiltWorker 取代 @WorkerInject。 @HiltWorker 現在 是 類型 註解， 並且 需要 在 建構器中 使用 @AssistInject。 (Ic2f15)
  • 廢止對等 功能 現在 則由 @HiltViewModel 提供， 現 已成為 Hilt Android API 核心 的 一部分。 (I36a41)

修正 錯誤

  • 修正 Hilt 無法正確取得 AndroidX 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 註解的 巢狀 工作站 類別 的一個 問題。 (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 程式庫 啟用 依存 注入 的特定 類別。