Edge-to-edge на Android 15

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.
Как решаем
  1. Вызвать enableEdgeToEdge() в onCreate для единого вида на старых Android
  2. Найти экраны, где контент уходит под статус-бар и навигацию
  3. Во View раздать отступы через setOnApplyWindowInsetsListener
  4. В Compose применить windowInsetsPadding или innerPadding из Scaffold
  5. Убрать 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, так что приложение выглядит одинаково на всём парке устройств, а цвет системных иконок подстраивается под светлую и тёмную тему.

Kotlin
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. Если экран собран без него, используйте модификаторы:

Kotlin
@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:

  1. Жестовая навигация и классическая трёхкнопочная. Во втором режиме нижняя панель выше, и система по умолчанию кладёт под неё полупрозрачную подложку.
  2. Портрет и альбомная ориентация на устройстве с вырезом: в альбомной вырез оказывается сбоку и съедает часть контента слева или справа.
  3. Открытая клавиатура на всех формах: кнопка отправки должна оставаться над ней, а не под ней.
  4. Светлая и тёмная тема: иконки статус-бара должны оставаться читаемыми на вашей шапке.
  5. Крупный шрифт в системных настройках: увеличенный текст в тулбаре быстрее всего упирается в статус-бар.

Самые частые ошибки, которые мы находили при таком обходе, повторяются из проекта в проект. Отступ применён дважды: и родителем через 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.

API 35Android 15: edge-to-edge принудительно
API 36Android 16: отказаться уже нельзя
1.8.0androidx.activity с enableEdgeToEdge()

«Edge-to-edge больше не опция дизайна: это поведение системы, под которое подстраивается каждый экран.»

Главный вывод заметки

Вопросы и ответы

Вопросы и ответы

Можно ли просто отключить edge-to-edge и жить как раньше?
Временно да: атрибут темы windowOptOutEdgeToEdgeEnforcement работает при targetSdk 35. Но при targetSdk 36 на устройствах с Android 16 он отключён, а Google Play со временем требует поднимать targetSdk. Поэтому опт-аут годится только как пауза на время доработки экранов.
Зачем вызывать enableEdgeToEdge(), если Android 15 и так всё растягивает?
Чтобы приложение одинаково выглядело на Android 14 и ниже. Без вызова на старых версиях останутся цветные системные панели, а на новых прозрачные, и дизайн придётся проверять в двух вариантах. Вызов также настраивает цвет иконок под тему.
Что вернуть из слушателя инсетов: insets или CONSUMED?
Если дочерним View инсеты ещё нужны, верните исходный объект insets. CONSUMED останавливает передачу вниз по дереву. На Android 10 и ниже он к тому же скрывает инсеты от соседних веток, поэтому до поглощения вызовите ViewGroupCompat.installCompatInsetsDispatch.
Какие инсеты брать в Compose по умолчанию?
WindowInsets.safeDrawing: он учитывает системные панели, вырез экрана и клавиатуру. Для списков передавайте его через contentPadding, для отдельных кнопок через Modifier.windowInsetsPadding. Если экран построен на Scaffold, сначала используйте его innerPadding.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

Читайте также