Підготовка документації для перегляду App Store
App Store Review Guidelines — це не просто список правил, а робочий інструмент рецензента. Більшість відхилень відбуваються не через технічні проблеми в самій програмі, а тому, що рецензент не розумів, що відбувається на екрані та чому це законно. Належна документація — це пояснення для живої людини, яка бачить невідому програму вперше.
Що входить до повного пакету документації
App Review Information в App Store Connect — це перше, що бачить рецензент. Тут потрібні:
- Тестові облікові дані з реальним доступом до функцій. Якщо програма вимагає перевірки номера телефону — потрібен робочий номер, який отримує SMS. Облікові записи Sandbox Apple для in-app-покупок мають бути налаштовані та протестовані наперед.
- Notes for reviewer — розділ, який розробники найчастіше ігнорують. Тут потрібно описати нетривіальні потоки: чому програма запитує геолокацію в фоні, як активувати функцію за paywall, як працює користувацька камера.
- 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.
Термін підготовки документації: один-два робочих дні.