Подготовка документации для ревью App Store
App Store Review Guidelines — не просто список правил, а рабочий инструмент ревьюера. Большинство отклонений происходит не из-за технических проблем в самом приложении, а из-за того, что ревьюер не понял что происходит на экране и почему это легитимно. Правильная документация — это объяснение для живого человека, который смотрит на незнакомое приложение первые пять минут.
Что включает полный пакет документации
App Review Information в App Store Connect — первое, что видит ревьюер. Здесь нужны:
- Тестовые учётные данные с реальным доступом к функциям. Если приложение требует верификацию номера телефона — нужен работающий номер, который получает SMS. Sandbox-аккаунты Apple для in-app purchases должны быть настроены и протестированы заранее.
- Notes for reviewer — раздел, который разработчики игнорируют чаще всего. Здесь нужно описать нетривиальные флоу: почему приложение запрашивает геолокацию в фоне, как активировать функцию, закрытую за пейволлом, как работает кастомная камера.
- Demo video — для приложений с CoreBluetooth, HealthKit, HomeKit или NFC, где ревьюер физически не может проверить функциональность без специфического железа, видео обязательно.
Privacy Nutrition Label в App Store Connect заполняется отдельно и должен точно отражать реальное поведение приложения и всех используемых SDK. Несоответствие между задекларированными данными и фактическим трафиком — причина отклонений по Privacy-гайдлайнам. Стоит аудировать каждый подключённый фреймворк: Firebase Analytics, Amplitude, AppsFlyer и другие собирают данные по умолчанию.
Age Rating рассчитывается через анкету — неправильно выставленный рейтинг приводит к отклонению, если контент приложения ему не соответствует.
Типичные провалы в документации
Самое частое — тестовый аккаунт не работает в момент ревью. Аккаунт истёк, токен устарел, бэкенд вернул ошибку. Ревьюер видит экран логина и не может двигаться дальше — отклонение по 2.1 (App Completeness).
Второе по частоте — приложение требует внешнюю железку (BLE-устройство, NFC-метку, специфический QR-код) и нет ни видео, ни объяснения. Ревьюер не обязан угадывать.
Третье — не задокументированы использование камеры или микрофона вне очевидного контекста. Если приложение — не мессенджер и не видеоредактор, а где-то в глубине есть запись аудио для аналитики — это нужно объяснить в Notes.
Как мы готовим документацию
Аудит приложения на соответствие текущим App Store Review Guidelines (они обновляются, последняя значимая версия — 6.0 с ужесточением требований к конфиденциальности). Проверка всех entitlements в Entitlements.plist и соответствие задекларированным capabilities в App Store Connect. Составление Notes for reviewer с описанием каждого нестандартного поведения.
Отдельно — проверка NSPrivacyAccessedAPITypes в PrivacyInfo.xcprivacy, который стал обязательным с iOS 17 для использования ряда системных API включая UserDefaults, FileTimestamp, SystemBootTime.
Срок подготовки документации — один-два рабочих дня.