Screen Continuity: что это, API складки и адаптация интерфейса

Что такое Screen Continuity?

Screen Continuity — это механизм Android, который сохраняет состояние Activity при изменении физической конфигурации экрана на складных устройствах. Когда пользователь раскладывает или сворачивает телефон, система может перезапустить Activity с новыми размерами окна. Continuity предотвращает потерю введённых данных, прокрутки и текущего экрана.

В отличие от обычного поворота экрана, где Android просто пересоздаёт Activity с новой ориентацией, складные устройства вводят принципиально новые сценарии. Поза HALF_OPENED позволяет приложению работать на половинном экране, а FLAT — в полностью разложенном планшетном режиме. Без поддержки Screen Continuity каждое изменение позы сбрасывает интерфейс к начальному состоянию.

По данным Google I/O 2024, более 62% пользователей складных устройств сталкивались с приложениями, которые некорректно обрабатывают переключение между состояниями. Screen Continuity решает эту проблему на уровне API, предоставляя разработчику готовые инструменты для сохранения и восстановления UI.

Состояния складных устройств: позы экрана

Jetpack WindowManager определяет три базовые позы складного устройства через класс FoldingFeature. Каждая поза соответствует определённому физическому положению шарнира и требует особой обработки интерфейса.

HALF_OPENED — полусложенное состояние

Устройство находится под углом от 30 до 160 градусов. Экран разделён на две логические области. Приложение может отображать контент на верхней половине и элементы управления на нижней. Tabletop mode для видеозвонков и медиаплееров использует именно эту позу.

FLAT — полностью разложенное состояние

Устройство раскрыто на 180 градусов, образуя единый большой экран. Приложение переходит в планшетный режим с увеличенной рабочей областью. В этой позе рекомендуется показывать multi-pane layout с навигационной панелью и детальным контентом рядом.

TABLE_TOP — поза ноутбука

Устройство стоит на поверхности под углом около 120 градусов. Нижняя половина экрана служит сенсорной панелью или клавиатурой. Touchpad mode в этой позе позволяет эмулировать трекпад на нижней части экрана.

Как работает непрерывность экрана в Android?

Android обрабатывает изменение конфигурации складного устройства через механизм configuration changes. Когда пользователь раскладывает телефон, система фиксирует изменение размера окна и запускает стандартный цикл пересоздания Activity. Screen Continuity перехватывает этот процесс и сохраняет ключевые данные.

Основной метод для сохранения состояния — onRetainNonConfigurationInstance, который вызывается перед уничтожением Activity. Разработчик сохраняет в нём модель данных, позицию списка и текущий экран навигации. После пересоздания Activity получает эти данные через getLastNonConfigurationInstance и восстанавливает UI в точности до момента сворачивания.

Для Fragments механизм реализован через setRetainInstance(true), который предотвращает уничтожение фрагмента при изменении конфигурации. В Jetpack Compose используется rememberSaveable, автоматически сохраняющий состояние при изменении Window Metrics.

class MainActivity : AppCompatActivity() {
    private var currentScrollPosition: Int = 0

    override fun onRetainNonConfigurationInstance(): Any {
        return SavedState(scrollPosition = currentScrollPosition)
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val saved = lastNonConfigurationInstance as? SavedState
        saved?.let { currentScrollPosition = it.scrollPosition }
    }
}

API ScreenContinuity в Jetpack WindowManager

Jetpack WindowManager версии 1.1+ включает класс ScreenContinuityController, который предоставляет готовые механизмы для управления непрерывностью экрана. API автоматически обрабатывает смену позы и уведомляет приложение через callback-интерфейсы.

ScreenContinuityController

Центральный класс, регистрирующий слушателей изменения позы. registerContinuityListener принимает callback, который срабатывает при каждом переходе между состояниями складного устройства. Контроллер также предоставляет информацию о текущей позе через метод getCurrentFoldingFeature.

FoldingFeatureAdapter

Утилитный класс для преобразования данных FoldingFeature в понятные приложению состояния. FoldingFeatureAdapter нормализует координаты шарнира и определяет, является ли текущая поза HALF_OPENED, FLAT или TABLE_TOP. Это избавляет разработчика от ручного расчёта углов и пороговых значений.

Интеграция с Jetpack Compose

Для Compose-приложений WindowManager предоставляет WindowSizeClass и модификаторы, учитывающие складку. Компонент BoxWithConstraints адаптируется к изменению размеров экрана в реальном времени без пересоздания Activity. Compose автоматически триггерит рекомпозицию при изменении WindowMetrics.

val windowManager = WindowManager(context)
val controller = windowManager.screenContinuityController

controller.registerContinuityListener { feature: FoldingFeature ->
    when (feature.state) {
        FoldingFeature.State.HALF_OPENED -> enterTabletopMode()
        FoldingFeature.State.FLAT -> expandToTablet()
    }
}

Пример реализации на Kotlin

Рассмотрим полный пример Activity с поддержкой Screen Continuity. MainActivity обрабатывает три сценария: сворачивание, разворачивание и полусложенное состояние. Данные сохраняются через onRetainNonConfigurationInstance и восстанавливаются при пересоздании.

class ContinuityActivity : AppCompatActivity() {
    private lateinit var binding: ActivityContinuityBinding
    private var itemList = mutableListOf<String>()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityContinuityBinding.inflate(layoutInflater)
        setContentView(binding.root)

        val savedState = lastNonConfigurationInstance as? ContinuityState
        if (savedState != null) {
            itemList.addAll(savedState.items)
            restoreUi(savedState)
        }
        setupWindowManager()
    }

    private fun setupWindowManager() {
        val controller = WindowManager(this).screenContinuityController
        controller.registerContinuityListener { feature ->
            updateLayoutForFeature(feature)
        }
    }

    private fun updateLayoutForFeature(feature: FoldingFeature) {
        when (feature.state) {
            FoldingFeature.State.HALF_OPENED -> binding.root.enableTabletopMode()
            FoldingFeature.State.FLAT -> binding.root.enableTabletMode()
            FoldingFeature.State.TABLE_TOP -> binding.root.enableTouchpadMode()
        }
    }

    override fun onRetainNonConfigurationInstance(): Any {
        return ContinuityState(itemList.toList(), binding.listView.firstVisiblePosition)
    }
}

data class ContinuityState(
    val items: List<String>,
    val scrollPosition: Int
)

Ключевой элемент — класс ContinuityState, хранящий список элементов и позицию прокрутки. Activity сохраняет его перед пересозданием и восстанавливает сразу после вызова onCreate. WindowManager контроллер подписывается на изменения позы и переключает макет между режимами.

Тестирование непрерывности на эмуляторе и устройстве

Android Studio предоставляет эмулятор складного устройства с поддержкой всех трёх поз. Для тестирования Screen Continuity достаточно создать виртуальное устройство с типом Pixel Fold или Samsung Galaxy Z Fold и переключать позу через панель управления эмулятора.

Настройка эмулятора

Создайте AVD с категорией Foldable и выберите разрешение 7.6-дюймового экрана. В extended controls эмулятора откройте вкладку Folding Postures и переключайтесь между позами. Каждое переключение триггерит configuration change, который должен корректно обрабатываться приложением.

Физическое устройство

На реальном устройстве (Galaxy Z Fold 5, Pixel Fold) тестирование выполняется физическим раскладыванием. Samsung DeX и Multi-Window режимы также активируют continuity. Для отладки используйте ADB-команду adb shell dumpsys window policy, отображающую текущее состояние складки.

Типичные проблемы

Основные ошибки — потеря состояния RecyclerView, сброс текста в текстовых полях и закрытие диалоговых окон. ViewModel решает эти проблемы, сохраняя данные в памяти независимо от жизненного цикла Activity. Также важно аннотировать Activity в манифесте параметром android:configChanges, если приложение обрабатывает изменения вручную.

<!-- AndroidManifest.xml -->
@android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation"