Hilt

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

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

構件 穩定版 候選版 Beta 版 Alpha 釋出
Hilt 1.0.0 - - -
hilt-navigation-compose 1.0.0 - - 1.1.0-alpha01
本程式庫上次更新日期：2022 年 12 月 7 日

意見回饋

您的意見可協助我們改善 Jetpack。發現新的問題或想要提出關於改進這個程式庫的建議時，請告訴我們。建立新的問題之前，請先查看這個程式庫中的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

1.1 版

1.1.0-alpha01 版

2022 年 12 月 7 日

發布了 androidx.hilt:hilt-navigation:1.1.0-alpha01 和 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 日

自 1.0.0-beta01 起，androidx.hilt:hilt-navigation-compose:1.0.0-rc01 版本沒有任何變更。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)

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 程式庫 啟用 依存 注入 的特定 類別。