Области действия и время жизни компонентов

Область действия определяет, как долго Hilt хранит один экземпляр и где он используется совместно. Речь идёт о времени жизни, а не только о создании.

Без аннотации области действия Hilt создаёт новый экземпляр при каждом запросе. Это подходит для недорогих объектов без состояния.

Hilt предоставляет набор компонентов, соответствующих периодам жизни Android — от всего приложения до отдельного представления. Каждый компонент владеет собственными экземплярами.

SingletonComponent существует столько же, сколько и приложение. Связывания с @Singleton внутри него создаются один раз и используются всеми экранами.

ActivityComponent связан с одной Activity. Используйте @ActivityScoped, чтобы совместно использовать экземпляр в этой Activity и создавать его заново для новой Activity.

ViewModelComponent соответствует периоду жизни ViewModel. С помощью @ViewModelScoped зависимость используется совместно только внутри этой ViewModel.

Каждая аннотация области действия соответствует одному компоненту. @Singleton используется с SingletonComponent, @ActivityScoped — с ActivityComponent и так далее.

Компоненты вложены друг в друга: Activity находится внутри приложения, а Fragment — внутри Activity. Дочерний компонент может использовать всё, что предоставляют его родители.

Области действия расходуют память, поскольку экземпляр хранится до уничтожения его компонента. Задавайте область действия только для объектов, состояние которых действительно нужно использовать совместно.

Никогда не внедряйте объект с коротким периодом жизни, например Activity, в Singleton. Дольше живущий владелец будет удерживать его и вызовет утечку памяти. ⚠️

Сопоставляйте область действия с периодом жизни данных: конфигурация приложения — в Singleton, состояние экрана — в ViewModelScoped. Правильный выбор предотвращает утечки и лишние затраты.

Вы узнали, что области действия связывают период жизни экземпляра с компонентом — от Singleton до ViewModel, — поэтому зависимости существуют ровно столько, сколько нужно. 🎯