Edge-to-edge на Android 15инсеты во View и Compose, когда отключить уже нельзя
С targetSdk 35 система сама растягивает окно под статус-бар и панель навигации. Показываем, как вернуть кнопкам и спискам их место и не сломать старые устройства.
- Раздел
- Android
- Стек
- KotlinWindowInsetsJetpack Composeandroidx.core
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 7 мин
- С targetSdk 35 на Android 15 окно приложения рисуется под системными панелями всегда.
- Атрибут windowOptOutEdgeToEdgeEnforcement при targetSdk 36 на Android 16 уже не работает.
- Во View отступы берутся из WindowInsetsCompat через ViewCompat.setOnApplyWindowInsetsListener.
- В Compose хватает Scaffold и Modifier.windowInsetsPadding с WindowInsets.safeDrawing.
- Вызвать enableEdgeToEdge() в onCreate для единого вида на старых Android
- Найти экраны, где контент уходит под статус-бар и навигацию
- Во View раздать отступы через setOnApplyWindowInsetsListener
- В Compose применить windowInsetsPadding или innerPadding из Scaffold
- Убрать windowOptOutEdgeToEdgeEnforcement из тем приложения
Что изменилось в Android 15#
Раньше растянуть приложение под системные панели было решением команды: кто-то включал прозрачный статус-бар ради красивой шапки, кто-то жил с цветной плашкой сверху и не думал об отступах. В Android 15 (API 35) это поменялось. В документации сказано прямо: как только приложение нацелено на SDK 35 и запущено на Android 15 или новее, окно занимает весь экран и рисуется под статус-баром, навигационной панелью и полосой заголовка окна.
Для команды это выглядит как внезапный баг после поднятия targetSdk: тулбар залез под часы, нижняя кнопка «Оплатить» спряталась за жестовой полоской, последний элемент списка нельзя нажать. Код при этом никто не трогал. Мы проверили на нескольких проектах: чаще всего страдают экраны, которые верстались на LinearLayout с фиксированной нижней кнопкой, и полноэкранные диалоги.
Временный выход был: атрибут темы android:windowOptOutEdgeToEdgeEnforcement со значением true возвращал старое поведение. Но для приложений с targetSdk 36 на устройствах с Android 16 этот атрибут объявлен устаревшим и отключён. Поэтому откладывать переход больше некуда: Google Play регулярно поднимает минимальный targetSdk для обновлений, и рано или поздно проект окажется в новых правилах.
Инсеты: какие бывают и что с ними делать#
Инсеты (window insets) сообщают, какие края окна перекрыты системным интерфейсом. Приложение само решает, как на них ответить: отступом, полем или сдвигом элемента. В библиотеке androidx.core все типы собраны в WindowInsetsCompat.Type. На практике хватает нескольких:
| Тип | Что описывает | Кому применять |
|---|---|---|
systemBars() | статус-бар, навигация, полоса заголовка | кнопки, FAB, тулбары, списки |
displayCutout() | вырез под камеру, в альбомной ориентации сбоку | контент у краёв экрана |
systemGestures() | зоны системных жестов назад и домой | карусели, свайпы, нижние шторки |
ime() | экранная клавиатура | поля ввода и кнопки отправки |
Главная мысль: фон может и должен уходить под панели, а интерактивные элементы нет. Шапка с картинкой красиво тянется до верхнего края, но кнопка «Назад» в ней получает отступ сверху. Список прокручивается под навигацию, но последний элемент можно докрутить до видимой зоны. Для этого у RecyclerView ставят нижний padding и android:clipToPadding="false", и в документации к Views этот приём приведён как основной.
Код для View: слушатель инсетов#
Первое, что стоит сделать, это вызвать enableEdgeToEdge() в onCreate. Расширение для ComponentActivity появилось в androidx.activity 1.8.0, в свежей документации рядом показан и вариант WindowCompat.enableEdgeToEdge(window) из androidx.core. Вызов делает панели прозрачными и на версиях до Android 15, так что приложение выглядит одинаково на всём парке устройств, а цвет системных иконок подстраивается под светлую и тёмную тему.
class CheckoutActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
enableEdgeToEdge()
super.onCreate(savedInstanceState)
val binding = ActivityCheckoutBinding.inflate(layoutInflater)
setContentView(binding.root)
// список: контент уходит под панели, но докручивается до видимой зоны
ViewCompat.setOnApplyWindowInsetsListener(binding.items) { v, insets ->
val bars = insets.getInsets(
WindowInsetsCompat.Type.systemBars() or WindowInsetsCompat.Type.displayCutout()
)
v.updatePadding(left = bars.left, top = bars.top, right = bars.right)
insets
}
// нижняя кнопка поднимается над навигацией и клавиатурой
ViewCompat.setOnApplyWindowInsetsListener(binding.payButton) { v, insets ->
val bottom = insets.getInsets(
WindowInsetsCompat.Type.systemBars() or WindowInsetsCompat.Type.ime()
).bottom
v.updateLayoutParams<ViewGroup.MarginLayoutParams> {
bottomMargin = bottom + resources.getDimensionPixelSize(R.dimen.space_m)
}
WindowInsetsCompat.CONSUMED
}
}
}Обратите внимание на возвращаемое значение. WindowInsetsCompat.CONSUMED останавливает передачу инсетов дальше по дереву. На Android 10 и ниже это ломает соседние ветки: братья по иерархии инсетов вообще не получают. Документация предлагает вызвать ViewGroupCompat.installCompatInsetsDispatch(root) из androidx.core 1.16 до того, как что-то поглощать. Если вы когда-то писали утилиту для поиска дочерних View по классу, она пригодится, чтобы быстро найти все Toolbar и нижние панели на экране и проверить, кто из них получает отступы.
Часть компонентов Material обрабатывает инсеты сама: BottomNavigationView, BottomAppBar, NavigationRailView. А вот AppBarLayout не обрабатывает, ему нужен android:fitsSystemWindows="true".
Compose: отступы как модификаторы#
В Compose задача решается короче. Scaffold из Material 3 по умолчанию учитывает системные инсеты и передаёт итоговые отступы в лямбду контента через innerPadding. Если экран собран без него, используйте модификаторы:
@Composable
fun FeedScreen(items: List<Post>) {
Box(Modifier.fillMaxSize().background(MaterialTheme.colorScheme.surface)) {
LazyColumn(
contentPadding = WindowInsets.safeDrawing.asPaddingValues(),
modifier = Modifier.fillMaxSize()
) {
items(items, key = { it.id }) { PostRow(it) }
}
FloatingActionButton(
onClick = { /* новый пост */ },
modifier = Modifier
.align(Alignment.BottomEnd)
.windowInsetsPadding(WindowInsets.safeDrawing)
.padding(16.dp)
) { Icon(Icons.Default.Add, contentDescription = "Новый пост") }
}
}WindowInsets.safeDrawing объединяет системные панели, вырез и клавиатуру, поэтому это самый безопасный вариант по умолчанию. Для списков отступ лучше отдавать через contentPadding, а не через padding контейнера: тогда элементы прокручиваются под панелями, а первый и последний остаются доступными. Ключи в items мы ставим по той же причине, что и в заметке про обновление RecyclerView через DiffUtil: стабильная идентичность элементов спасает от лишних перерисовок.
Как проверить экраны перед релизом#
Переход на edge-to-edge редко ломает логику, он ломает геометрию. Поэтому проверка сводится к обходу экранов в нескольких конфигурациях, и её удобно оформить чек-листом для QA:
- Жестовая навигация и классическая трёхкнопочная. Во втором режиме нижняя панель выше, и система по умолчанию кладёт под неё полупрозрачную подложку.
- Портрет и альбомная ориентация на устройстве с вырезом: в альбомной вырез оказывается сбоку и съедает часть контента слева или справа.
- Открытая клавиатура на всех формах: кнопка отправки должна оставаться над ней, а не под ней.
- Светлая и тёмная тема: иконки статус-бара должны оставаться читаемыми на вашей шапке.
- Крупный шрифт в системных настройках: увеличенный текст в тулбаре быстрее всего упирается в статус-бар.
Самые частые ошибки, которые мы находили при таком обходе, повторяются из проекта в проект. Отступ применён дважды: и родителем через fitsSystemWindows, и ребёнком через слушатель, в итоге сверху висит пустая полоса двойной высоты. Слушатель повешен на View, которая создаётся позже первой раздачи инсетов, и отступ не появляется до поворота экрана; здесь помогает ViewCompat.requestApplyInsets(view) после добавления в иерархию. Фиксированная высота тулбара в dp не учитывает отступ, и заголовок обрезается снизу.
Ещё одна тонкость касается картинок в шапке. Когда фон уходит под статус-бар, верхняя часть изображения закрыта часами и значками, поэтому важное (лицо, логотип, текст) лучше держать ниже. Прикинуть пропорции заранее помогает приём из заметки про размеры изображения без загрузки в память: зная ширину и высоту ресурса, проще выбрать scaleType и точку кадрирования.
Что изменилось к 2026 году#
- Edge-to-edge перестал быть настройкой: на Android 15 он включается от targetSdk 35, на Android 16 при targetSdk 36 отключить его атрибутом темы уже нельзя.
- Для обратной совместимости хватает одного вызова
enableEdgeToEdge(), ручная возня сsystemUiVisibilityи флагами окна больше не нужна. - В androidx.core появились
ProtectionLayoutиGradientProtectionдля полупрозрачной подложки под статус-баром, если контент под ним плохо читается. - Полноэкранные
DialogFragmentтоже нужно растягивать отдельно: документация советует вызыватьenableEdgeToEdgeдля окна диалога вonStart.
Отдельно проверьте медиаэкраны. Плеер, о котором мы писали в посте про переезд на media3, часто живёт в полноэкранном режиме, и его контролы должны получать отступы так же, как обычные кнопки. Остальные заметки по платформе собраны в разделе Android.
«Edge-to-edge больше не опция дизайна: это поведение системы, под которое подстраивается каждый экран.»
Главный вывод заметки


