Зачем в Jetpack Compose нужны аннотации @Stable и @Immutable?

Аннотации @Stable и @Immutable в Jetpack Compose

• применяются для оптимизации перерисовки пользовательского интерфейса
• С помощью @Stable указывается, что объект изменяется только через предсказуемые и гарантированные механизмы
• композер понимает, что при стабильных входных данных повторно перерисовывать соответствующие участки UI не требуется
• Аннотация @Immutable обозначает объект как полностью неизменяемый — все его поля должны быть final/val
• благодаря этому компоновщик может безопасно кэшировать значения и пропускать ненужные recomposition
• В результате повышается производительность и сокращается количество избыточных перерисовок
• Их рекомендуется применять к пользовательским типам данных и моделям состояния

Таким образом, аннотации сообщают композеру о мутабельности объектов, помогая эффективно минимизировать recomposition и ускорять работу UI.

Подробный ответ

Основной ответ

В Jetpack Compose аннотации @Stable и @Immutable служат для оптимизации перерисовки UI. Они помогают системе определить, какие данные изменились, а какие сохранили прежнее состояние, что напрямую отражается на производительности.

Аннотация @Immutable применяется к классам и объектам, состояние которых не изменяется после создания. Если ссылка на такой объект осталась прежней, его содержимое также гарантированно не изменилось, поэтому Compose может пропустить ненужные recomposition.

Аннотация @Stable обозначает объект со стабильным поведением: его изменения явно сообщаются через observable/State, либо объект не изменяется, либо обновляется контролируемым образом. Ссылка при этом может оставаться прежней, тогда как внутреннее состояние меняется посредством стабильных механизмов.

Ключевые моменты

• @Immutable — гарантирует полную неизменность всех публичных полей и позволяет оптимизировать проверку изменений без обращения к equals.
• @Stable — сообщает Compose о стабильности объекта, благодаря чему значения можно безопасно кэшировать без глубокого сравнения; при этом внутренние обновления через State допускаются.
• Применение этих аннотаций позволяет сократить число лишних recomposition и уменьшить нагрузку на CPU и GPU, особенно при работе со сложными или часто обновляемыми интерфейсами.

Практический контекст

В Jetpack Compose 1.4+ данные аннотации широко применяются в стандартных библиотеках и рекомендуются для пользовательских моделей данных. Например, для data class, содержащих только val-поля, подходит @Immutable, а для классов с observable-состоянием — @Stable. Это способствует более высокой производительности больших списков и динамического UI.