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/SDK | network 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_readyXcode 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. Снимок стека в момент зависания ценнее десятка логов «начали загрузку», потому что показывает фактическое ожидание.
Проверка проходит по разным типам запуска
- Удалить приложение и выполнить чистую установку — проверить launch screen и first launch.
- Force quit и открыть снова — получить warm launch без скрытой старой сцены.
- Запустить после перезагрузки и первого unlock устройства — проверить cold path.
- Отключить сеть и DNS, затем включить медленную сеть — увидеть timeout/fallback.
- Обновить предыдущую production-сборку на новую — проверить миграцию и сохранённую сессию.
- Повторить на старом поддерживаемом устройстве и текущей iOS.
- Снять App Launch trace для медленного сценария и сравнить time to first frame.
Критерий готовности формулируется наблюдаемо: первый интерактивный локальный экран появляется без сети, ни одна внешняя зависимость не держит main thread, а отказ bootstrap переводит приложение в retry/offline, а не в бесконечный splash.
Материалы для воспроизводимого отчёта
Сохраните модель устройства, версию iOS, тип запуска, версию приложения, длительности контрольных точек, обезличенный stack trace и условия сети. Если проблема появилась после обновления, приложите номер предыдущей сборки и состояние локальной базы. Видео полезно только вместе с timeline: по одному ролику нельзя понять, какой поток остановил первый кадр.
После исправления повторите весь набор запусков и просмотрите Organizer за следующие сборки. Локальный быстрый тест подтверждает код, а агрегированные launch reports показывают, исчезла ли проблема на реальных моделях устройств.