Рукоять

Рукоять

Руководство пользователя Пример кода Codelab

Справочник по API
androidx.hilt.lifecycle
androidx.hilt.navigation
androidx.hilt.navigation.compose
androidx.hilt.navigation.fragment
androidx.hilt.work

Расширьте функциональность Dagger Hilt , чтобы включить внедрение зависимостей определенных классов из библиотек androidx.

В этой таблице перечислены все артефакты группы androidx.hilt .

Артефакт	Стабильный выпуск	Кандидат на выпуск	Бета-версия	Альфа-релиз
рукоять-обычная	1.2.0	-	-	-
эфес-компилятор	1.2.0	-	-	-
работа рукояти	1.2.0	-	-	-
рукоятка-навигация	1.2.0	-	-	-
hilt-navigation-compose	1.2.0	-	-	-
рукоятка-навигация-фрагмент	1.2.0	-	-	-

Последнее обновление этой библиотеки: 21 февраля 2024 г.

Обратная связь

Ваши отзывы помогают сделать Jetpack лучше. Дайте нам знать, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.

Создать новую задачу

Дополнительную информацию см . в документации по системе отслеживания проблем .

Рукоять Версия 1.2

Версия 1.2.0

21 февраля 2024 г.

Выпущен androidx.hilt:hilt-*:1.2.0 . Версия 1.2.0 содержит эти коммиты.

Важные изменения с версии 1.1.0

• Добавьте поддержку вспомогательного внедрения в hiltViewModel() и hiltNavGraphViewModels() . Теперь эти функции принимают дополнительный обратный вызов, в котором вы можете использовать переданную вспомогательную фабрику для создания внедренной ViewModel с вспомогательной поддержкой.

Версия 1.2.0-rc01

7 февраля 2024 г.

Выпущен androidx.hilt:hilt-*:1.2.0-rc01 . Версия 1.2.0-rc01 содержит эти коммиты.

Версия 1.2.0-бета01

24 января 2024 г.

Выпущен androidx.hilt:hilt-*:1.2.0-beta01 . Версия 1.2.0-beta01 содержит эти коммиты.

Версия 1.2.0-альфа01

13 декабря 2023 г.

Выпущен androidx.hilt:hilt-*:1.2.0-alpha01 . Версия 1.2.0-alpha01 содержит эти коммиты.

Изменения API

• Добавьте перегруженные функции hiltViewModel() и hiltNavGraphViewModels() для поддержки вспомогательного внедрения. ( Ieb98d )

Рукоять Версия 1.1.0

Версия 1.1.0

1 ноября 2023 г.

Выпущен androidx.hilt:hilt-*:1.1.0 . Версия 1.1.0 содержит эти коммиты.

Основные изменения с версии 1.0.0

• Добавьте поддержку KSP в androidx.hilt .
• Примите HasDefaultViewModelProviderFactory в hiltViewModel() .
• API hiltViewModel() теперь принимает необязательный ключевой параметр.

Версия 1.1.0-rc01

18 октября 2023 г.

Выпущен androidx.hilt:hilt-*:1.1.0-rc01 . Версия 1.1.0-rc01 содержит эти коммиты.

Версия 1.1.0-бета01

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: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-альфа01

9 августа 2023 г.

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 содержит эти коммиты.

Новые возможности

• Добавьте поддержку KSP в androidx.hilt . Обратите внимание, что это подготовка к поддержке Hilt KSP. Чтобы использовать версию androidx.hilt KSP, необходимо выпустить основную поддержку Hilt.

Hilt-Navigation-Fragment версия 1.1.0

Версия 1.1.0-альфа02

19 апреля 2023 г.

androidx.hilt:hilt-navigation-fragment:1.1.0-alpha02 выпущен. Версия 1.1.0-alpha02 содержит эти коммиты.

Изменения API

• Примите HasDefaultViewModelProviderFactory в hiltViewModel() ( I10ab6 , b/249548618 , b/195190169 )

Исправления ошибок

• Исправлена ​​проблема, из-за которой hiltNavGraphViewModel() не внедряет SavedStateHandle . ( 3ef114 , б/272099838 )

Hilt-Навигация Версия 1.1.0

Версия 1.1.0-альфа02

19 апреля 2023 г.

Выпущен androidx.hilt:hilt-navigation:1.1.0-alpha02 . Версия 1.1.0-alpha02 содержит эти коммиты.

Версия 1.1.0-альфа01

7 декабря 2022 г.

Выпущен androidx.hilt:hilt-navigation:1.1.0-alpha01 . Версия 1.1.0-alpha01 содержит эти коммиты.

Hilt-Navigation-Compose Версия 1.1.0

Версия 1.1.0-альфа01

7 декабря 2022 г.

Выпущен androidx.hilt:hilt-navigation-compose:1.1.0-alpha01 . Версия 1.1.0-alpha01 содержит эти коммиты.

Изменения API

• API hiltViewModel() теперь принимает необязательный ключевой параметр. Это позволяет вам получить несколько экземпляров одного и того же типа ViewModel используя разные ключи. ( I6ee47 , б / 245139957 )

Hilt-Navigation-Compose Версия 1.0.0

Версия 1.0.0

26 января 2022 г.

Выпущен androidx.hilt:hilt-navigation-compose:1.0.0 . Версия 1.0.0 содержит эти коммиты.

Основные особенности версии 1.0.0

Артефакт androidx.hilt:hilt-navigation-compose предоставляет API, которые позволяют пользователям получать аннотированную ViewModel @HiltViewModel из записи обратного стека навигации в приложении Compose с помощью :navigation-compose .

Функция hiltViewModel() возвращает существующую ViewModel или создает новую, привязанную к текущему навигационному графу, присутствующему в заднем стеке NavController . Функция может дополнительно использовать NavBackStackEntry , чтобы ограничить ViewModel родительской записью обратного стека.

Версия 1.0.0-rc01

15 декабря 2021 г.

androidx.hilt:hilt-navigation-compose:1.0.0-rc01 выпущен без изменений с 1.0.0-beta01 . Версия 1.0.0-rc01 содержит эти коммиты.

Версия 1.0.0-бета01

17 ноября 2021 г.

Выпущен androidx.hilt:hilt-navigation-compose:1.0.0-beta01 . Версия 1.0.0-beta01 содержит эти коммиты.

Изменения API

• Удалите устаревшую функцию hiltNavGraphViewModel() и ее перегрузки. Все они были заменены hiltViewModel() . ( Iaf7d7 )

Версия 1.0.0-альфа03

16 июня 2021 г.

Выпущен androidx.hilt:hilt-navigation-compose:1.0.0-alpha03 . Версия 1.0.0-alpha03 содержит эти коммиты.

Изменения API

• Метод hiltViewModel() теперь соответствует изменениям API viewModel() в Lifecycle-ViewModel-Compose 1.0.0-alpha07 и теперь принимает необязательный параметр ViewModelStoreOwner вместо версии без аргументов и версии, которая принимает только NavBackStackEntry . Это позволяет вам продолжать использовать hiltViewModel() для доступа к владельцу по умолчанию, предоставленному LocalViewModelStoreOwner , или использовать hiltViewModel(navBackStackEntry) или другой ViewModelStoreOwner для указания любого конкретного владельца. ( I2628d )

Версия 1.0.0-альфа02

18 мая 2021 г.

Выпущен androidx.hilt:hilt-navigation-compose:1.0.0-alpha02 . Версия 1.0.0-alpha02 содержит эти коммиты.

Изменения API

• hiltNavGraphViewModel() переименован в hiltViewModel() и удалено расширение NavController , поскольку пользователь может напрямую использовать API navigation-compose для получения NavBackStackEntry из маршрута. ( I6ef57 )

Совместимость с композицией

• androidx.hilt:hilt-navigation-compose:1.0.0-alpha02 совместим только с Compose версии 1.0.0-beta07 и выше.

Обновления зависимостей

• hilt-navigation-compose теперь зависит от Navigation 2.4.0-alpha01 .

Версия 1.0.0-альфа01

10 марта 2021 г.

androidx.hilt:hilt-navigation-compose:1.0.0-alpha01 выпущен. Версия 1.0.0-alpha01 содержит эти коммиты.

Новые возможности

• Артефакт :hilt-navigation-compose предоставляет API, которые позволяют пользователям получать аннотированную ViewModel @HiltViewModel из записи обратного стека навигации в приложении Compose с помощью :navigation-compose . Функция hiltNavGraphViewModel() может принимать либо NavBackStackEntry , либо строку маршрута, которую можно использовать для определения области действия ViewModel либо для текущей записи заднего стека, либо для родительской записи в стеке. ( Ia9234 )

Рукоять Версия 1.1

Версия 1.1.0-бета01

4 октября 2023 г.

Выпущен androidx.hilt:hilt-*:1.1.0-beta01 . Версия 1.1.0-beta01 содержит эти коммиты.

androidx.hilt:hilt-*:1.1.0-beta01 выпущен без изменений с версии 1.1.0-alpha* .

Рукоять Версия 1.0.0

Версия 1.0.0

5 мая 2021 г.

Выпущен androidx.hilt:hilt-*:1.0.0 . Версия 1.0.0 содержит эти коммиты.

Основные особенности версии 1.0.0

Артефакты androidx.hilt предлагают расширения для интеграции Hilt с различными другими библиотеками AndroidX, такими как WorkManager и Navigation. Чтобы увидеть список функций и примеры, ознакомьтесь с документацией по интеграции .

Версия 1.0.0-бета01

10 марта 2021 г.

Выпущен androidx.hilt:hilt-*:1.0.0-beta01 . Версия 1.0.0-beta01 содержит эти коммиты.

Изменения API

• Удалите типы @Deprecated из артефактов AndroidX Hilt, в частности @androidx.hilt.ViewModelInject и @androidx.hilt.Assisted . Обратите внимание, что @ViewModelInject был заменен на @HiltViewModel . ( I626fe )

Версия 1.0.0-альфа03

27 января 2021 г.

Выпущен androidx.hilt:hilt-*:1.0.0-alpha03 . Версия 1.0.0-alpha03 содержит эти коммиты.

Новые возможности

• Предоставьте API для получения аннотированной ViewModel @HiltViewModel из Navigation NavBackStackEntry . Артефакт hilt-navigation-fragment предлагает расширение Kotlin hiltNavGraphViewModels в то время как hilt-navigation предоставляет фабричный метод HiltViewModelFactory , который принимает NavBackStackEntry в качестве аргумента и возвращает ViewModelProvider.Facctory , который можно использовать с ViewModelProvider или другими API-интерфейсами получения модели представления, такими как Compose Функция viewModel() : viewModel(HiltViewModelFactory(AmbientContext.current, backStackEntry)) . ( I00e67 )

Изменения API

• Замените @WorkerInject на @HiltWorker . @HiltWorker теперь является аннотацией типа и требует использования @AssistedInject в конструкторе. ( Ic2f15 )
• Устаревший @ViewModelInject . Эквивалентную функциональность теперь предлагает @HiltViewModel , который теперь является частью основных API-интерфейсов Hilt Android. ( I36a41 )

Исправления ошибок

• Исправлена ​​проблема, из-за которой модули расширения AndroidX Hilt не корректно подбирались Hilt, из-за чего рабочие процессы были недоступны для создания. ( I3181c , б / 159540434 )
• Перенесите расширения AndroidX Hilt в SingletonComponent , удалив устаревшее предупреждение об использовании ApplicationCompoonent . ( I9c916 , б / 175849092 )

Версия 1.0.0-альфа02

22 июля 2020 г.

Выпущен androidx.hilt:hilt-*:1.0.0-alpha02 . Версия 1.0.0-alpha02 содержит эти коммиты.

Исправления ошибок

• Исправлена ​​проблема с дублированием сохраненных ключей состояния, когда ViewModel, не внедренная в Hilt, была запрошена из аннотированного класса @AndroidEntryPoint . ( б / 158737069 )
• Исправлена ​​проблема в HiltWorkerFactory , из-за которой неправильно инициализировались вложенные классы Worker, аннотированные @WorkerInject . ( б / 160524718 )

Версия 1.0.0-альфа01

10 июня 2020 г.

Выпущен androidx.hilt:hilt-*:1.0.0-alpha01 . Версия 1.0.0-alpha01 содержит эти коммиты.

Пакет и библиотеки androidx.hilt расширяют функциональность Dagger Hilt , позволяя внедрять зависимости определенных классов из библиотек androidx.