Predictive back вместо onBackPressedкак переписать жест назад до перехода на targetSdk 36
С targetSdk 36 Android 16 перестаёт вызывать onBackPressed и доставлять KEYCODE_BACK. Разбираем, чем заменить старый перехват во View и Compose и как мигрировать большое приложение по частям.
- Раздел
- Android
- Стек
- Kotlinandroidx.activity 1.6+Jetpack Compose
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 10 мин
- При targetSdk 36 на Android 16 onBackPressed не вызывается, а KEYCODE_BACK не доставляется.
- Перехват назад переносится в OnBackPressedCallback из androidx.activity 1.6.0+.
- Колбэк включается и выключается по состоянию UI, а не проверяет условие внутри обработчика.
- В Compose есть BackHandler и PredictiveBackHandler с прогрессом жеста.
- Флаг enableOnBackInvokedCallback="false" даёт отсрочку, его можно ставить на отдельные activity.
- Обновить androidx.activity до 1.6.0 или новее
- Найти все onBackPressed и KEYCODE_BACK в коде
- Заменить их колбэками, привязанными к состоянию UI
- В Compose перейти на BackHandler или PredictiveBackHandler
- Включать predictive back по activity и проверить экраны на Android 16
Жест «назад» в Android долго работал по простой схеме: пользователь отпустил палец, система вызвала onBackPressed(), приложение решило, что делать. Predictive back ломает эту схему. Система должна заранее знать, перехватит ли приложение жест, иначе она не сможет показать превью экрана, куда пользователь вернётся. Поэтому старые перехваты через onBackPressed() и KeyEvent.KEYCODE_BACK перестают работать, а не просто устаревают.
Ниже разбираем, что именно меняется по версиям, как переписать обработку «назад» во View и в Compose и где команды чаще всего ошибаются. Если в команде нет человека, который возьмётся за это в ближайший спринт, можно заказать разработку мобильного приложения Android у подрядчика вместе с обновлением targetSdk.
Что такое predictive back и почему onBackPressed больше не вызывается#
Predictive back (предиктивный жест «назад») показывает анимированное превью цели во время свайпа: рабочий стол, предыдущую activity или другое приложение. Пользователь может передумать и вернуть палец, и тогда ничего не произойдёт. Чтобы такое превью было возможно, решение «кто обработает назад» принимается до начала жеста, а не после его завершения.
Старый onBackPressed() устроен наоборот: он вызывается в момент, когда жест уже закончен, и внутри него приложение может сделать что угодно, от закрытия экрана до показа диалога. Система не знает заранее, чем это закончится, и не может нарисовать честное превью. Отсюда новая модель: приложение регистрирует колбэк и включает или выключает его по состоянию UI. Включён колбэк, значит приложение перехватывает жест. Выключен, значит назад обрабатывает система и показывает свою анимацию.
В официальном руководстве по поддержке predictive back это сформулировано прямо: перехват событий назад через KEYCODE_BACK больше не поддерживается, а onBackPressed у Activity и Dialog нужно заменить на новые API.
Что изменилось в Android 13–16#
Старый перехват ломается в Android 16 при targetSdk 36; до этого переход был добровольным. Он растянулся на четыре версии, и поведение зависит одновременно от версии системы на устройстве и от targetSdk приложения:
| Версия | Что происходит | Что нужно от приложения |
|---|---|---|
| Android 13 (API 33) | Activity.onBackPressed() объявлен устаревшим, появился OnBackInvokedCallback | опт-ин флагом в манифесте, анимация только в настройках разработчика |
| Android 14 (API 34) | доступны собственные анимации внутри приложения | тот же опт-ин, тест через настройки разработчика |
| Android 15 (API 35) | системные анимации back-to-home, cross-task и cross-activity показываются без настроек разработчика | работают для приложений, которые включили predictive back |
| Android 16 (API 36) | при targetSdk 36 predictive back включён по умолчанию, onBackPressed не вызывается, KEYCODE_BACK не доставляется | миграция или временный опт-аут флагом false |
Ключевая строка последняя. В списке изменений Android 16 сказано: для приложений с targetSdk 36 на устройствах с Android 16 системные анимации включены по умолчанию, onBackPressed не вызывается и KeyEvent.KEYCODE_BACK больше не доставляется. Если приложение перехватывало назад старым способом, после поднятия targetSdk жест просто закроет экран, минуя вашу логику. Сохранённый черновик формы, диалог «Выйти без сохранения?», закрытие нижней шторки перестают срабатывать молча, без ошибок в логах.
Как перейти с onBackPressed на OnBackPressedCallback#
Для приложений на AndroidX основной путь один: OnBackPressedDispatcher и OnBackPressedCallback из androidx.activity версии 1.6.0 или новее. Колбэк обратно совместим и работает на всех версиях, а на Android 13+ сам регистрирует платформенный OnBackInvokedCallback. Типичная старая реализация выглядела так:
// было: решение принимается после жеста
override fun onBackPressed() {
if (binding.filters.isVisible) {
binding.filters.isVisible = false
} else {
super.onBackPressed()
}
}Условие внутри обработчика и есть проблема: система узнаёт о нём слишком поздно. В новой версии условие превращается в состояние колбэка:
class CatalogActivity : AppCompatActivity() {
private val closeFilters = object : OnBackPressedCallback(false) {
override fun handleOnBackPressed() {
viewModel.hideFilters()
}
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(binding.root)
onBackPressedDispatcher.addCallback(this, closeFilters)
lifecycleScope.launch {
repeatOnLifecycle(Lifecycle.State.STARTED) {
viewModel.filtersVisible.collect { visible ->
binding.filters.isVisible = visible
// колбэк включён ровно тогда, когда есть что закрывать
closeFilters.isEnabled = visible
}
}
}
}
}Здесь три важных детали:
- колбэк создаётся выключенным (
false) и включается только при открытой панели фильтров; - его состояние привязано к
StateFlow, а не вычисляется внутри обработчика; - передача
thisкакLifecycleOwnerснимает колбэк автоматически, когда activity уничтожается, так что утечек и «зависших» перехватов не будет.
Фрагменты и Navigation Component уже работают через тот же диспетчер: им достаточно обновить androidx.activity до 1.6.0+. Во фрагменте колбэк, который регистрируется в onViewCreated(), привязывают к viewLifecycleOwner, а не к самому фрагменту: иначе после возврата из бэкстека view создаётся заново и в диспетчере оказываются два одинаковых колбэка.
Без AndroidX: платформенный OnBackInvokedCallback
Если activity наследуется напрямую от android.app.Activity или вы пишете библиотеку без зависимостей, на Android 13+ доступен платформенный API. Колбэк регистрируется в onBackInvokedDispatcher окна и снимается вручную, когда перехват больше не нужен:
private val closePanel = OnBackInvokedCallback { hidePanel() }
private fun showPanel() {
panel.isVisible = true
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
onBackInvokedDispatcher.registerOnBackInvokedCallback(
OnBackInvokedDispatcher.PRIORITY_DEFAULT, closePanel
)
}
}
private fun hidePanel() {
panel.isVisible = false
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
onBackInvokedDispatcher.unregisterOnBackInvokedCallback(closePanel)
}
}На Android 12 и ниже этот код не работает, и для старых версий придётся держать отдельную ветку. Кроме того, при флаге enableOnBackInvokedCallback="false" система платформенный колбэк игнорирует. Поэтому для обычного приложения AndroidX-вариант проще и надёжнее, а платформенный оставьте для случаев, где без него не обойтись.
Ловушка: бесконечный цикл и super.onBackPressed()
Частая ошибка при механической замене: в handleOnBackPressed() вызывают onBackPressedDispatcher.onBackPressed(), чтобы «пропустить назад дальше». Диспетчер снова находит тот же включённый колбэк, и получается рекурсия. Правильный порядок такой: сначала isEnabled = false, затем повторный вызов диспетчера. А лучше вообще не дёргать диспетчер руками, а держать колбэк выключенным, когда перехват не нужен.
Как обработать жест назад в Jetpack Compose#
В Compose роль колбэка играют две функции из androidx.activity:activity-compose. BackHandler просто перехватывает жест, PredictiveBackHandler (с версии 1.8.0) ещё и отдаёт прогресс свайпа, чтобы анимировать экран вслед за пальцем:
@Composable
fun EditorScreen(state: EditorState, onDiscard: () -> Unit) {
var showConfirm by remember { mutableStateOf(false) }
var dragProgress by remember { mutableFloatStateOf(0f) }
// перехватываем, только если есть несохранённые правки
PredictiveBackHandler(enabled = state.hasUnsavedChanges) { progress ->
try {
progress.collect { event -> dragProgress = event.progress }
showConfirm = true
} catch (e: CancellationException) {
// пользователь передумал и вернул палец
} finally {
dragProgress = 0f
}
}
Editor(
state = state,
modifier = Modifier.graphicsLayer {
scaleX = 1f - dragProgress * 0.05f
scaleY = 1f - dragProgress * 0.05f
}
)
if (showConfirm) {
DiscardDialog(onConfirm = onDiscard, onDismiss = { showConfirm = false })
}
}Флаг enabled выполняет ту же работу, что isEnabled у колбэка во View: пока правок нет, обработчик выключен и системная анимация проигрывается как обычно. Обработчики в Compose проверяются от внутреннего к внешнему, поэтому локальный BackHandler экрана срабатывает раньше, чем NavHost. Если нужно только закрыть шторку или сбросить поиск, достаточно BackHandler: прогресс жеста там не нужен.
Где нельзя перехватывать назад#
Любой включённый колбэк с обычным приоритетом отключает системную анимацию: система видит, что приложение забрало жест, и превью не рисует. Отсюда правило из документации: колбэки «назад» существуют для UI-логики (диалог, анимация, закрытие панели), а не для бизнес-логики и аналитики.
- Аналитика ухода с экрана. Во View смотрите
isFinishingвonDestroy()activity илиisRemovingу фрагмента, в Compose логируйте вonCleared()уViewModelэкрана. - Выход из приложения с корневого экрана. На Android 16+ есть
OnBackInvokedCallbackс приоритетомPRIORITY_SYSTEM_NAVIGATION_OBSERVER: он наблюдает за жестом, не поглощая его, и анимация back-to-home сохраняется. - «Нажмите ещё раз, чтобы выйти». Этот паттерн конфликтует с predictive back по смыслу: пользователь уже видит превью рабочего стола. Если он всё же нужен, держите колбэк включённым только на корневом экране и только до первого нажатия.
- WebView. Колбэк включается, когда
canGoBack()вернулtrue, и обновляется после каждой загрузки страницы, а не проверяется внутри обработчика.
Как мигрировать большое приложение по шагам#
В проекте с десятками activity переписать всё за раз трудно, поэтому документация разрешает включать predictive back по частям. Флаг android:enableOnBackInvokedCallback можно ставить не только в <application>, но и в отдельной <activity>:
<application
android:enableOnBackInvokedCallback="false">
<!-- уже переведена на OnBackPressedCallback -->
<activity
android:name=".MainActivity"
android:enableOnBackInvokedCallback="true" />
<!-- ещё на старом onBackPressed -->
<activity
android:name=".LegacyCheckoutActivity"
android:enableOnBackInvokedCallback="false" />
</application>Значение false отключает системные анимации и заставляет систему игнорировать платформенный OnBackInvokedCallback, но OnBackPressedCallback из AndroidX продолжает работать при любом значении флага. Поэтому порядок такой:
- Обновить androidx.activity до 1.6.0+ (для
PredictiveBackHandlerнужна activity-compose 1.8.0+). - Найти поиском все
onBackPressed,KEYCODE_BACKиDialog.onBackPressedв коде и сторонних модулях. - Переписать каждое место на колбэк с состоянием, начиная с экранов с формами и оплатой.
- Включать флаг по activity по мере готовности, остальные временно держать с
false. - После поднятия targetSdk до 36 пройти все экраны жестом и кнопкой на Android 16.
Опт-аут через false в Android 16 описан как временный. Мы не советуем на нём задерживаться: в документации отдельно предупреждают, что без миграции поведение «назад» может неожиданно измениться в будущих версиях Android. Похожая история уже была с edge-to-edge, который мы разбирали в посте про инсеты на Android 15: там опт-аут при targetSdk 36 просто перестал работать.
Как проверить predictive back перед релизом#
На Android 15 и новее анимации видны сразу, на Android 13 и 14 их включают в «Параметрах разработчика» пунктом «Predictive back animations». Проверка сводится к нескольким сценариям:
- Свайп назад и отмена на середине: экран должен вернуться в исходное состояние, анимация в Compose сброситься.
- Открытая шторка, поиск, диалог: первый жест закрывает их, второй уходит назад.
- Корневой экран: проигрывается анимация back-to-home, а не мгновенное закрытие.
- Трёхкнопочная навигация: кнопка «назад» проходит через те же колбэки, что и жест.
- Поворот экрана при открытой панели: состояние колбэка восстанавливается из
ViewModel, а не теряется.
Ошибки здесь обычно не падают, а тихо меняют поведение, поэтому стоит закрепить сценарии в UI-тестах. Прогоните и существующие тесты с pressBack() уже на targetSdk 36: они быстро покажут экраны, где назад раньше держался на старом перехвате. Если параллельно вы обновляете плеер, учтите и полноэкранный режим из поста про переезд на media3: выход из него тоже должен быть колбэком, а не переопределённым onBackPressed. Остальные рецепты по платформе собраны в разделе Android.
«Решение о жесте назад теперь принимается до свайпа: колбэк включён, значит жест перехватывает приложение, выключен, значит назад обрабатывает система.»
Главный вывод заметки


