ИИ-разработка

До выхода складного iPhone: какие API iOS 27 менять первыми? (2026)

Победитель — немедленная миграция API iOS 27 по зависимостям: сначала UIScene, затем контекстные обращения к экрану, после этого — решения по доступному пространству и обработка изменения размеров окна. Ждать официального названия, диагонали или даты складного iPhone не следует: Apple уже описала публичные требования к изменяемым окнам, а внутренние поля вроде foldState и angleDegrees не являются основанием для кода.

Эта последовательность подходит разработчикам, поддерживающим старое UIKit-приложение или смешанную архитектуру UIKit и SwiftUI, если в проекте ещё есть AppDelegate-жизненный цикл, UIScreen.main, userInterfaceIdiom, interfaceOrientation либо фиксированные ширина и высота. Техническим руководителям она помогает отделить работу, которую можно включить в текущий релизный план, от аппаратных предположений, которые разумно проверять только после официальной документации.

Последняя проверка выполнена 20 августа 2026 года; требования к окнам, сценам и тестовой среде сверены с материалами Apple Developer и сессией WWDC26 278.

Граница изменений до официального анонса

Apple уже связывает работу iPhone-приложения с изменяемым размером окна в сценариях iPhone Mirroring и на iPad. В сессии WWDC26 о миграции к адаптивным окнам отдельно разбираются жизненный цикл сцен, геометрия окна и отказ от предположения, что приложение всегда занимает фиксированный экран.

Из этого следует важное ограничение: адаптация должна опираться на публичные контексты UIKit, а не на слухи о будущей аппаратной форме. Название складного устройства, его размеры, цена, дата выхода и предполагаемые поля внутренних состояний Apple не подтверждены как публичный API. Поэтому удаление заголовка с упоминанием конкретной модели не должно ломать план работ: переход на UIScene, устранение глобального экрана и расчёт по доступному пространству всё равно остаются необходимыми.

Перед изменением кода полезно создать базовый отчёт по проекту. В него входят:

  • точки входа application(_:didFinishLaunchingWithOptions:) и другие методы старого AppDelegate;
  • создание UIWindow и назначение rootViewController;
  • вызовы UIScreen.main, UIScreen.screens, nativeScale и scale;
  • ветвления по userInterfaceIdiom и interfaceOrientation;
  • константы вроде 375, 667, 768 и другие фиксированные размеры, если они участвуют в логике, а не только в тестовых данных;
  • обработка снимков экрана, миниатюр, кэшей, экспорта изображений и внешних дисплеев;
  • страницы, где после изменения ширины могут появиться обрезание, перекрытие или устаревшая отрисовка.

Значения размеров в этом перечне — не целевые конфигурации и не спецификации устройств, а поисковые маркеры в исходном коде. Их наличие нужно подтвердить анализом конкретного проекта, а не считать универсальной проблемой.

Основание приложения: миграция UIScene

Почему старое UIKit-приложение сначала переводится на UIScene

UIScene — не косметическая замена методов AppDelegate. Сцена задаёт контекст окна, его подключение, состояние активности и геометрию. Пока приложение продолжает считать процесс единственным владельцем интерфейса, последующие изменения размеров нельзя надёжно связать с конкретным окном.

Минимальная область миграции обычно включает:

  • конфигурацию подключения сцены;
  • создание окна в SceneDelegate;
  • передачу входящих URL и универсальных ссылок в активную сцену;
  • восстановление состояния интерфейса;
  • реакцию на переходы между активным, неактивным и фоновым состояниями;
  • удаление дублирующей инициализации окна из AppDelegate.

Документация Apple по UIWindowScene должна использоваться для проверки актуальных точек расширения, а не только для механического копирования шаблона. В смешанном проекте особенно важно решить, какой объект владеет состоянием навигации: SceneDelegate, координатор или отдельный слой состояния. Если одновременно сохранять старую и новую цепочку, запуск может пройти успешно, но восстановление после повторного подключения сцены станет непредсказуемым.

Порядок перехода

Сначала нужно перенести создание окна и корневого контроллера в сцену, затем проверить холодный запуск, возврат из фона и повторное подключение. После этого переносятся URL, user activity и state restoration. Только когда эти сценарии работают на актуальном SDK, имеет смысл менять расчёты размеров: иначе ошибки жизненного цикла будут ошибочно выглядеть как проблемы адаптивной вёрстки.

Пример минимальной схемы для UIKit должен оставаться контекстным:

func scene(
    _ scene: UIScene,
    willConnectTo session: UISceneSession,
    options connectionOptions: UIScene.ConnectionOptions
) {
    guard let windowScene = scene as? UIWindowScene else { return }

    let window = UIWindow(windowScene: windowScene)
    window.rootViewController = makeRootViewController()
    self.window = window
    window.makeKeyAndVisible()
}

Этот код не решает адаптацию сам по себе. Его задача — дать интерфейсу связанный с конкретной сценой UIWindowScene, от которого дальше можно получать геометрию и события.

Контекст вместо глобального экрана

Почему UIScreen.main больше нельзя использовать как универсальный источник

UIScreen.main описывает главный экран процесса, но не обязательно тот контекст, в котором сейчас находится конкретное окно. При зеркалировании, работе с несколькими сценами, iPad-режимами и внешними дисплеями такой глобальный источник может привести к неверному масштабу или к расчёту по области, отличной от видимой пользователю.

Apple отдельно документирует ограничения и назначение UIScreen. Практический вывод для миграции API iOS 27 состоит не в том, чтобы заменить каждый вызов одной новой строкой, а в том, чтобы разделить три разных вопроса.

Что требуется узнать Предпочтительный источник Что проверить после замены
К какому экрану относится окно window.windowScene?.screen Используется ли именно текущее окно, а не глобальный экран
Какой масштаб интерфейса ожидает компонент traitCollection и свойства текущего контекста Не смешан ли масштаб UI с масштабом рендеринга
Сколько места доступно для раскладки view.bounds, bounds контейнера или геометрия окна Не берётся ли размер всего экрана вместо области приложения
Как вычислить координаты между пространствами Координатное пространство сцены и окна Совпадает ли система координат после перехода или трансформации

Информация о дисплее нужна, например, для выбора формата изображения или проверки внешнего вывода. Для размещения кнопок она обычно не нужна: компонент должен смотреть на собственные bounds и ограничения контейнера. Для коэффициента масштаба следует читать trait-контекст, а не выводить плотность из физической ширины экрана.

Скрытые места, которые ломаются после замены

Поверхностная правка контроллеров не закрывает весь риск. Поиск нужно продолжить в сервисах и утилитах:

  • ключах кэша, где размер экрана используется как идентификатор;
  • генерации скриншотов и превью;
  • выборе разрешения для изображений;
  • расчёте canvas для графики;
  • логике внешнего дисплея;
  • тестовых помощниках, которые создают фиктивный экран;
  • коде, вычисляющем размер всплывающих окон и меню.

Если изображение создаётся для конкретного UIView, его размер должен исходить из bounds этого представления. Если операция относится к сцене, сначала необходимо получить активную UIWindowScene, а затем уже использовать её экран или координатное пространство. Документация Apple о координатном пространстве UIWindowScene полезна для проверки преобразований, особенно когда окно меняет положение или отображается не в исходном контексте.

Решения по доступному пространству

От устройства к пространству

userInterfaceIdiom отвечает на вопрос о семействе устройства, но не сообщает, сколько места фактически получил конкретный контейнер. После появления изменяемого окна телефонный интерфейс может оказаться достаточно широким для двух колонок, а планшетное окно — слишком узким для прежней плотности контента. Поэтому условие «если это phone, показывать один столбец» становится архитектурной ловушкой.

Для раскладки следует определить собственные пороги компонента и связать их с доступным пространством:

  • одна колонка при недостаточной ширине;
  • две колонки при ширине, позволяющей сохранить минимальные размеры обеих областей;
  • компактное меню вместо постоянной боковой панели;
  • перенос вторичных действий в toolbar, если контейнер не выдерживает прежнюю плотность.

Порог должен описывать требования интерфейса, а не предполагаемый размер будущего устройства. Если карточке нужен минимум места для заголовка, изображения и действия, измерять нужно контейнер карточки, а не экран.

Ориентация также должна быть отделена от раскладки. Камере, датчикам движения и полноэкранному видео действительно может понадобиться направление устройства. Но решение о двух колонках, отступах и количестве элементов в строке лучше принимать по размеру контейнера, size class и текущей геометрии. Это особенно важно для UIKit: traitCollection следует передавать компонентам как часть контекста, а не превращать в глобальную переменную.

Согласование UIKit и SwiftUI

В гибридном приложении UIKit и SwiftUI могут принять разные решения, если один слой смотрит на interfaceOrientation, а другой — на horizontalSizeClass. На границе компонентов нужно выбрать единый смысл: например, «доступна широкая раскладка» или «в контейнере достаточно места для вторичной панели».

UIKit-контроллер может передавать SwiftUI размер и состояние доступного пространства через наблюдаемую модель, а SwiftUI-компонент не должен повторно угадывать тип устройства. В обратную сторону контейнер UIKit должен учитывать фактический размер UIHostingController, а не размер экрана. Такая договорённость уменьшает число конфликтов, когда список уже перестроился, а панель навигации всё ещё считает окно компактным.

Непрерывное изменение окна

Почему iPhone Mirroring меняет требования к вёрстке

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

Нужно проверить:

  • constraints, зависящие от ширины;
  • UICollectionViewLayout и размеры ячеек;
  • рисунки, рассчитываемые один раз при загрузке;
  • кэш миниатюр, где ширина не входит в ключ;
  • медиаплеер и aspect ratio;
  • popover, menu и sheets, привязанные к старому anchor;
  • текст, который меняет число строк после сужения.

Регистрацию изменений traits, обработку геометрии сцены и обновление контейнеров следует строить вокруг конкретного окна. При этом не следует запускать тяжёлую перегенерацию данных на каждое промежуточное изменение. Геометрию можно обновлять сразу, а дорогие операции — объединять, отменять при следующем изменении или выполнять после завершения интерактивного изменения, если это не ухудшает визуальный результат.

Сценарии проверки

Для каждой критичной страницы создаётся матрица состояний:

  • узкое окно;
  • широкое окно;
  • окно, близкое к квадратному;
  • непрерывное изменение ширины;
  • возврат к исходному размеру;
  • повторное открытие после фонового состояния.

Проверка считается содержательной только тогда, когда сравниваются не одни скриншоты, но и поведение состояния: сохраняется ли выбранная вкладка, не появляется ли повторный запрос, обновляется ли кэш, не остаётся ли popover за пределами контейнера. Для iPhone Mirroring изменение окна нужно рассматривать как обычный жизненный цикл геометрии, а не как редкий тестовый эффект.

Device Hub и релизная проверка

Как проверить изменяемое окно в Xcode 27 Device Hub

В Xcode 27 Device Hub следует начать с нескольких профилей окна, различающихся соотношением ширины и высоты, а затем выполнить ручное перетаскивание границы, если выбранный тестовый сценарий это поддерживает. Примечания к выпуску Xcode 27 нужно сверить с установленной beta или RC-версией: возможности среды и поведение SDK могут изменяться до финального релиза.

Последовательность теста:

  • собрать приложение последним доступным SDK без предупреждений, связанных с жизненным циклом;
  • открыть стартовый экран и зафиксировать исходное состояние;
  • изменить ширину до компактной области и проверить переносы, навигацию и кнопки;
  • увеличить окно до широкой области и проверить появление дополнительных колонок;
  • пройти промежуточные размеры, наблюдая за зависшими constraints и старым кэшем;
  • открыть popover, меню, клавиатуру и медиаконтент во время изменения геометрии;
  • повторить сценарий после фонового перехода и восстановления сцены;
  • сохранить логи и скриншоты с названием конфигурации окна.

Previews удобны для быстрых итераций компонента, однако они не заменяют проверку сцены, восстановления состояния, iPhone Mirroring и аппаратно зависимых функций. После Device Hub необходимо проверить приложение на реальном iPhone и iPad в тех сценариях, где важны камера, сенсоры, производительность декодирования или внешние устройства.

Приёмка миграции

Для команды, которая планирует осенний релиз, изменения лучше разделить на независимые коммиты. Миграция жизненного цикла должна откатываться отдельно от изменения семантики раскладки, а динамическая инвалидизация — отдельно от тестовых профилей. Это позволяет вернуть стабильную ветку, если новая геометрия выявит регрессию в навигации или state restoration.

Итоговая проверка может выглядеть так:

  • [ ] Окно создаётся и восстанавливается через UIScene, без двойной инициализации из AppDelegate.
  • [ ] URL, user activity и восстановление состояния доставляются в нужную сцену.
  • [ ] Все вызовы UIScreen.main классифицированы: экран, масштаб или доступное пространство.
  • [ ] Размер раскладки берётся из текущего view или контейнера, а не из глобального экрана.
  • [ ] Ветки по userInterfaceIdiom заменены решениями по фактическому пространству там, где это относится к UI.
  • [ ] interfaceOrientation оставлен только для функций, которым действительно нужно направление устройства.
  • [ ] UIKit и SwiftUI используют одинаковую семантику компактного и широкого состояния.
  • [ ] Коллекции, constraints, кэши, медиаконтент и popover обновляются при изменении геометрии.
  • [ ] Узкие, широкие, почти квадратные и промежуточные состояния проверены в Device Hub.
  • [ ] iPhone Mirroring и iPad проверены отдельно на реальном сценарии запуска.
  • [ ] Миграцию можно откатить без отмены уже проверенного кода сцены.
  • [ ] В коде нет вызовов или предположений о foldState, angleDegrees и других неподтверждённых полях.

Эта последовательность даёт команде проверяемое доказательство готовности: не обещание поддержки неизвестного устройства, а работа приложения в тех изменяемых окнах, которые уже описаны Apple. После официального анонса складного iPhone потребуется добавить тестовые формы и размеры из документации, но переписывать архитектуру, основанную на доступном пространстве, не придётся.

Текущая среда и вариант с Mac

Если команда выполняет все проверки на одном общем Mac, у текущего подхода есть несколько реальных недостатков: beta-версия Xcode может конфликтовать со стабильным SDK, параллельная проверка iPhone Mirroring и iPad блокирует рабочую машину, а откат к прежнему проекту требует ручного восстановления окружения. При редких релизных окнах добавляются простои на установку SDK и риск смешать артефакты разных веток.

Для короткой миграции с независимым окружением аренда Mac через KuzCloud может быть рациональнее покупки отдельного компьютера: тестовую среду можно выделить под Xcode 27, сохранить стабильную рабочую машину нетронутой и после завершения аппаратной проверки не оплачивать простаивающее оборудование. Если проект постоянно выполняет тяжёлые сборки, требует физических интерфейсов или используется годами без смены toolchain, собственный Mac обычно предсказуемее. Для временного периода до осеннего релиза стоит сначала свериться с помощью KuzCloud по работе с удалённой средой, а затем выбрать срок, соответствующий фактическому циклу тестирования; доступ к терминальным инструментам можно уточнить через консоль KuzCloud.

Подготовьте приложение к новым сценариям интерфейса с KuzCloud

Арендуйте удалённый Mac в KuzCloud для сборки, отладки и проверки приложений на UIKit и SwiftUI.

Тестируйте разные размеры окон и динамическое изменение интерфейса в облачной среде без покупки отдельного устройства.