Как автоматически проверять многоязычные скриншоты fastlane snapshot? Чек-лист 2026

Запуск fastlane завершился успешно, но в папке результатов нет части локализаций или несколько изображений выглядят одинаково.

Быстрое решение: проверяйте комплект по матрице «язык × устройство», затем отдельно подтверждайте содержимое файлов и их отображение в App Store Connect. Успешное выполнение fastlane snapshot означает, что задача завершилась, а не то, что все скриншоты готовы к публикации.

Независимым разработчикам — если вы готовите или обновляете изображения для локализованных страниц приложения и хотите сократить ручную работу.

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

Ответственным за релиз и автоматизацию — если вы добавляете сбор скриншотов в конвейер на Mac и должны обнаруживать частичные сбои до передачи материалов на публикацию.

01 Сначала определите, что считается принятым комплектом

Автоматическая проверка многоязычных скриншотов fastlane snapshot должна отвечать не на один вопрос «прошёл ли запуск», а на несколько разных: запрошены ли нужные языки, получен ли файл для ожидаемой комбинации, показывает ли он правильный интерфейс и подходит ли изображение для размещения на странице приложения.

Для начала зафиксируйте ожидаемый результат отдельно от параметров запуска. Составьте список локализаций, экранов, ориентаций и устройств, которые вы действительно собираетесь передать в магазин. Это контрольная матрица, а не обещание того, что генератор создаст именно такое количество файлов. Способ задать языки и устройства сверяйте с инструкцией fastlane по созданию скриншотов и описанием параметров snapshot.

Вариант проверки Что подтверждает Чего не подтверждает Когда использовать
Процесс завершился Команда или этап конвейера закончили выполнение Что получен полный комплект и кадры пригодны для магазина Для первичной диагностики запуска
Ожидаемые файлы найдены Результаты присутствуют для заданных языков и устройств Что язык, экран и содержание соответствуют ожиданиям Для автоматической проверки полноты
Изображения просмотрены Текст, состояние приложения и данные выглядят правильно Что материалы размещены в нужной локализации App Store Connect Перед передачей файлов на публикацию
Страница проверена после загрузки Материалы находятся в нужном разделе и отображаются ожидаемым образом Что приложение автоматически прошло проверку Apple При окончательной приёмке релизных материалов

fastlane snapshot завершился без ошибки, но скриншота нет. Что проверять? Сначала сопоставьте ожидаемые комбинации с файлами в выходной папке. Затем откройте журнал запуска: проверка только кода завершения не обнаруживает пропуск отдельного языка или устройства, если сценарий обработки ошибок позволяет продолжить работу. Не принимайте результат, пока не выясните, какая комбинация не создала файл и почему.

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

02 Для независимого разработчика: ограничьте область съёмки

Не начинайте с максимального списка устройств и экранов «на всякий случай». Определите, какие изображения нужны именно для текущей версии страницы приложения, и включайте в сбор только эти сценарии. Так вы не смешаете полезные результаты с временными кадрами для разработки.

Для каждой группы экранов запишите ожидаемые условия: локализацию, переход к нужному экрану, состояние данных и ориентацию. В проекте fastlane сверьте эти ожидания с настройками языков и устройств. Конкретные доступные параметры и их поведение проверяйте по справке по действию snapshot, особенно если конфигурация унаследована от старого проекта или изменялась несколькими участниками команды.

Полезно хранить ожидаемую матрицу рядом с тестом или сценарием, который открывает нужные экраны. Тогда изменение конфигурации не превращается в догадку: вы можете сопоставить настройку запуска с задачей теста и ожидаемыми файлами. Если приложение формирует контент с сервера, задайте воспроизводимые тестовые данные. Иначе скриншот может показать пустое состояние или сведения, не относящиеся к сценарию выпуска.

Разделите сбор и приёмку. На этапе сбора автоматизация должна открыть нужный экран и сохранить результат. На этапе приёмки вы должны установить, соответствует ли этот результат ожиданиям по языку, устройству и содержимому. Когда оба этапа смешаны в один индикатор «успех», ошибки в тестовом сценарии часто остаются незамеченными.

03 Для владельца локализации: подтвердите язык по интерфейсу

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

Как fastlane snapshot создаёт скриншоты приложения на разных языках? В конфигурации задаются необходимые языки и устройства, а сценарий приложения доводит его до экранов, предназначенных для съёмки. Конкретную структуру настройки и запусков сверяйте с руководством fastlane по скриншотам: не подменяйте проверку файла предположением, что нужный язык обязательно применился.

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

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

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

04 Для ответственного за устройства: сверяйте настройки с требованиями магазина

Настройки симулятора и требования App Store Connect решают разные задачи. Выбранный в fastlane симулятор — цель автоматизированного запуска. Сам по себе он не устанавливает, что получившееся изображение подходит для нужного места на странице приложения.

Сначала проверьте модель устройства и ориентацию, использованные при сборе. Затем сопоставьте готовые файлы с текущими условиями размещения скриншотов в App Store Connect. Используйте официальную справку Apple по спецификациям скриншотов: она служит источником актуальных требований к изображениям. Не переносите старый перечень размеров из заметки или прежней настройки проекта без повторной проверки.

Это важно, если список симуляторов давно не пересматривался или был скопирован из другого приложения. Скриншот может открываться и выглядеть аккуратно, но не соответствовать текущему целевому месту размещения. Если требования изменились, пересмотрите выбор цели съёмки или подготовку изображения, а не только подпись файла.

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

Не считайте, что любой снимок из iOS Simulator автоматически годится для всех разделов страницы продукта. Сначала определите, для какой локализации и какого места предназначен файл. Затем проверьте, соответствует ли изображение требуемым условиям именно там. Это избавляет от ситуации, когда автоматизация технически сработала, а материалы приходится переделывать при загрузке.

05 Для сопровождающего автоматизацию: ловите частичный сбой

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

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

Автоматическая задача завершилась, но ожидаемой группы файлов нет. Это успех? Нет, если эта группа входит в контрольную матрицу. Найдите соответствующий запуск в журнале и выясните, был ли пропущен сценарий, не выполнился ли переход к экрану или возникла ошибка симулятора. До повторного прогона отметьте комплект как неполный.

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

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

06 Для проверяющего материалов: подтвердите, что кадр показывает приложение

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

Отдельно проверьте сами файлы: открываются ли они, не повреждены ли, соответствует ли формат вашему процессу и не мешает ли прозрачность ожидаемому отображению. Такой осмотр не заменяет проверку требований магазина. Apple отдельно описывает, как загружать и управлять предварительными просмотрами и скриншотами и какие материалы допустимы согласно правилам проверки скриншотов.

Можно ли сразу использовать снимок из iOS Simulator на странице приложения? Только после проверки самого файла и его соответствия требованиям конкретного раздела App Store Connect. То, что изображение создано симулятором, не подтверждает правильность локализации, допустимость содержимого или принятие материала при проверке. Разделяйте автоматическую съёмку, приёмку файла и решение Apple по приложению.

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

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

07 Для выпускающего: проверьте результат после загрузки

Локальный комплект — лишь часть процесса. После загрузки откройте App Store Connect и проверьте, в какой локализации и в каком месте отображается каждый материал. Сверьте порядок, устройство и выбранную версию страницы приложения с тем, что вы собирались отправить. Процесс загрузки и управления материалами описан в справке Apple по скриншотам и предварительным просмотрам.

Сохраните связь между локальными файлами и материалами в системе публикации: однозначную идентификацию файлов, выбранную локализацию, состояние загрузки и результат визуальной проверки. Затем просмотрите страницу в интерфейсе App Store Connect. Наличие исходника на Mac не доказывает, что файл загрузился, оказался в нужном разделе или отображается в правильном порядке.

Не приравнивайте отображение загруженных скриншотов к одобрению приложения. Требования Apple к содержанию снимков экрана рассматриваются отдельно от факта, что автоматизированная задача создала файлы. Фиксируйте результат проверки страницы отдельно от результатов fastlane и отдельно от статуса проверки приложения. Это позволит понять, на каком этапе возникла проблема, если после передачи материалов потребуется исправление.

Если вы заметили неправильную локализацию или порядок после загрузки, не исправляйте только локальную папку и не считайте задачу закрытой. Убедитесь, что в App Store Connect выбраны именно нужные материалы, а затем повторно проверьте страницу. Иначе локальный комплект может быть верным, а пользовательская карточка — всё ещё показывать старую версию или снимки другой локализации.

08 Чек-лист приёмки перед передачей материалов

Пройдите пункты последовательно. Если пункт не подтверждён, оставьте комплект на доработке.

  • [ ] Целевые локализации, экраны и устройства определены до запуска.
  • [ ] Настройки fastlane snapshot соответствуют контрольной матрице.
  • [ ] Для каждой ожидаемой комбинации найден свой результат, а не только похожий файл.
  • [ ] Журнал проверен на пропущенные сценарии и ошибки, после которых процесс продолжил работу.
  • [ ] Изображения открыты и проверены визуально, включая возврат к основному языку и обрезанный текст.
  • [ ] На кадрах видны нужные экраны и реальные состояния приложения.
  • [ ] Файлы сопоставлены с актуальными условиями размещения в App Store Connect.
  • [ ] После загрузки материалы проверены в нужной локализации и в правильном порядке.
  • [ ] Результат съёмки, результат загрузки и статус проверки приложения зафиксированы раздельно.

09 Выбирайте среду по характеру работы

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

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

Если для задачи нужен полный доступ к macOS, но покупать отдельный компьютер нецелесообразно, изучите условия аренды Mac у CALMVPS и сопоставьте их с частотой сборок и требованиями команды. Для редких запусков уже доступного локального Mac может быть достаточно. Для постоянной тяжёлой нагрузки или работы с физическими подключениями удалённая среда подходит не всегда — это нужно оценить заранее.

Локальная машина не зависит от удалённого канала, но её нужно приобрести, обслуживать и выделить под сборки. Удалённая среда позволяет не покупать отдельный Mac, однако требует надёжного подключения, аккуратного хранения результатов и проверки доступа. Если отсутствие постоянного Mac мешает запускать Xcode и iOS Simulator, изучите вариант удалённой среды CALMVPS и оцените его на реальном сценарии съёмки до включения в релизный процесс.

Окончательное решение принимайте по самому узкому месту вашего процесса. Если проблему создают локализация и тестовый сценарий, аренда машины её не исправит. Если же подходящей среды macOS нет, а сборку и съёмку приходится повторять на доступном нерегулярно оборудовании, удалённый Mac может дать команде постоянно доступное место для выполнения задач. В любом случае принимайте результат только после проверки языков, файлов, содержимого и страницы в App Store Connect.