Launch screen в iOS — статический экран, который система показывает до первого кадра приложения. Если он остаётся надолго, поставьте визуально отличимый минимальный root view и отметку времени сразу после его появления. Когда root view не появился, ищите работу на main thread до первого кадра. Когда появился, но выглядит как splash, проблема уже в вашей логике bootstrap или навигации.

Не лечите зависание фиксированной задержкой и не ждите login API, Remote Config, аналитику и миграцию базы перед созданием окна. Первый экран должен строиться из локального состояния. Сеть продолжает запуск асинхронно, а интерфейс показывает ограниченное состояние: загрузка, offline, повтор или вход.

Сначала назовите экран, который действительно видит пользователь

Что видноВероятный участокБыстрая проверка
старый логотип до запуска кодакэш launch screen или неверный asset/storyboardудалить тестовую сборку, clean build и установить заново
статический экран, debugger не проходит launch callbacksранний crash/hang или системный запускdevice logs и breakpoint в launch callback
ваш похожий splash view появилсяbootstrap state machineизменить фон/label debug-сборки и логировать state
UI виден, но не реагируетmain thread занят после первого кадраInstruments thread-state trace
зависает только без сетисинхронное ожидание API/SDKnetwork link off и таймаут каждой зависимости

Apple TN3118 отдельно описывает случаи, когда iOS показывает устаревший launch screen или snapshot. Для чистого теста Apple предлагает очистить build, удалить приложение с устройства/Simulator и установить снова. Это полезно для диагностики внешнего вида, но не заменяет разбор зависшего кода.

Timeline запуска расставляет контрольные точки

Добавьте signpost или структурированные события без пользовательских данных: process start, launch callback begin/end, database open, root view installed, first frame, bootstrap completed. Все метки пишутся в monotonic time; календарное время пригодно для сопоставления с системным журналом, но длительность лучше считать монотонными часами.

T+000ms process_start
T+041ms didFinishLaunching_begin
T+087ms root_view_installed
T+116ms first_frame
T+130ms bootstrap_begin
T+890ms local_store_ready
T+1450ms remote_config_timeout_fallback
T+1462ms bootstrap_ready

Xcode Organizer показывает launch reports, а Instruments App Launch template собирает time profile и состояние потоков. Apple измеряет запуск до первого кадра и указывает, что занятый или заблокированный main thread не может отрисовать интерфейс. Ищите длинный участок в call stack, а не просто большой общий launch time.

Первый кадр не зависит от внешнего сервиса

Создайте root navigation и локальный screen state синхронно. Затем запускайте независимые операции параллельно и переводите интерфейс между состояниями. Доступ к UI остаётся на MainActor, но сетевой запрос, декодирование большого ответа и файловая подготовка не выполняются как тяжёлая синхронная работа главного потока.

enum BootstrapState {
    case loading
    case ready(Session)
    case signedOut
    case offline(cached: Session?)
    case failed(retryable: Bool)
}

// Окно и loading view уже установлены.
Task {
    let result = await bootstrap.runWithTimeout()
    await MainActor.run { model.state = result }
}
  • Сессия читается из локального защищённого хранилища до проверки сети, но сервер может позже её отозвать.
  • Remote Config имеет локальные defaults и ограниченный timeout.
  • Аналитика не блокирует навигацию и может отправить накопленное позже.
  • Обязательная миграция данных показывает собственный progress/error screen после первого кадра.
  • Необязательные SDK инициализируются лениво перед первым реальным использованием.

Миграция и deadlock проверяются отдельно

После обновления приложение может зависать на открытии базы: main thread ждёт lock, миграция обрабатывает слишком много строк или два компонента ожидают друг друга. Вынесите измеряемую подготовку из launch callback, не открывайте один store повторно из конкурирующих задач и предусмотрите восстановление после прерванной миграции. Если без готовой схемы экран невозможен, покажите локальный recovery UI и не маскируйте его launch screen.

Hang отличается от crash: процесс остаётся, но главный run loop не обслуживает события. Apple рекомендует анализировать main thread и main run loop средствами диагностики hangs. Снимок стека в момент зависания ценнее десятка логов «начали загрузку», потому что показывает фактическое ожидание.

Проверка проходит по разным типам запуска

  1. Удалить приложение и выполнить чистую установку — проверить launch screen и first launch.
  2. Force quit и открыть снова — получить warm launch без скрытой старой сцены.
  3. Запустить после перезагрузки и первого unlock устройства — проверить cold path.
  4. Отключить сеть и DNS, затем включить медленную сеть — увидеть timeout/fallback.
  5. Обновить предыдущую production-сборку на новую — проверить миграцию и сохранённую сессию.
  6. Повторить на старом поддерживаемом устройстве и текущей iOS.
  7. Снять App Launch trace для медленного сценария и сравнить time to first frame.

Критерий готовности формулируется наблюдаемо: первый интерактивный локальный экран появляется без сети, ни одна внешняя зависимость не держит main thread, а отказ bootstrap переводит приложение в retry/offline, а не в бесконечный splash.

Материалы для воспроизводимого отчёта

Сохраните модель устройства, версию iOS, тип запуска, версию приложения, длительности контрольных точек, обезличенный stack trace и условия сети. Если проблема появилась после обновления, приложите номер предыдущей сборки и состояние локальной базы. Видео полезно только вместе с timeline: по одному ролику нельзя понять, какой поток остановил первый кадр.

После исправления повторите весь набор запусков и просмотрите Organizer за следующие сборки. Локальный быстрый тест подтверждает код, а агрегированные launch reports показывают, исчезла ли проблема на реальных моделях устройств.

Проверенные источники