Випуск оновлень мобільного застосунку: Major, Minor, Patch

Нещодавно до нас звернувся клієнт: після викатки minor-оновлення застосунок почав крашитися на пристроях з iOS 15 — виявилося, що нова фіча використовує API, доступний лише з iOS 16, а мінімалка залишилася 15. Підсумок — терміновий hotfix і втрата репутації. Такі ситуації виникають, коли стратегія версіонування не враховує зворотну сумісність. Ми допомагаємо вибудувати процес, де кожне оновлення — від patch до major — проходить перевірку на сумісність та staged rollout.

Семантика версій у мобільному контексті

Semver (Major.Minor.Patch) у мобільній розробці працює інакше, ніж у серверному софті. versionName — маркетинговий рядок для користувача. versionCode (Android) та CFBundleVersion (iOS) — монотонно зростаючі числа для сторів. Розсинхронізація між ними — джерело реальних проблем.

Patch (x.x.N): Хотфікс крашу, виправлення друкарської помилки, фікс неправильного перекладу. versionCode інкрементуємо, versionName змінюємо мінорно. Для iOS можна використовувати CFBundleVersionString без зміни CFBundleShortVersionString — але стори все одно вимагають рев'ю.

Minor (x.N.0): Нова фіча, зміна UI, додавання нового екрану. Без Breaking Changes. Користувач оновлюється — нічого не ламається.

Major (N.0.0): Зміна схеми локальної БД (Room migration, CoreData migration), зміна мінімальної версії ОС, рефакторинг зі зміною структури даних. Потрібна міграційна стратегія — дані користувачів мають коректно переноситися.

Порівняння типів оновлень

Як підготуватися до Major-релізу з міграцією даних?

Найболючіша частина — Major з міграцією. Room та CoreData надають механізми, але вимагають чіткого планування. Типова проблема: розробник додав поле в entity, збільшив version в @Database, але забув написати Migration об'єкт — Room викидає IllegalStateException: Room cannot verify the data integrity при запуску у користувачів з попередньою версією.

Для CoreData аналогічна помилка — змінити модель без lightweight migration або без явного mapping model. Застосунок крашиться при запуску на пристроях з існуючими даними, хоча на чистій установці працює нормально.

Стратегія для складних міграцій: fallback з fallbackToDestructiveMigrationFrom тільки якщо втрата даних прийнятна. У більшості випадків — написати явну Migration з SQL-скриптом. Тестувати міграцію на реальних даних з попередньої версії, не тільки на порожній БД. Наш досвід показує, що 80% проблем з major-релізами пов'язані саме з міграцією. Наприклад, один наш клієнт після впровадження міграційного тестування скоротив кількість крашів при оновленні на 40%.

Кроки підготовки Major-релізу

1. Аналіз змін схеми даних.
2. Написання SQL-скрипту міграції.
3. Тестування на попередній версії з реальним дампом БД.
4. Інкремент versionCode / CFBundleVersion.
5. Запуск staged rollout з моніторингом Crashlytics.

Чому staged rollout обов'язковий для оновлень?

Staged rollout — поступове поширення оновлення (наприклад, 5% → 10% → 20% → 100%). Це знижує ризик масових збоїв: якщо на перших 5% користувачів виявляється краш, ми відкочуємо реліз, не зачіпаючи решту. Staged rollout у 10 разів ефективніший за традиційний випуск — на кожен етап виділяємо 24 години моніторингу. Зв'яжіться з нами для налаштування стадійованого розгортання.

Android: Збірка AAB, підпис, завантаження в Play Console. Використовуємо staged rollout — починаємо з 5–10%, моніторимо Android Vitals (crash rate, ANR rate) 24 години, потім розширюємо. Для patch-оновлень rollout можна прискорити. Для Major — обов'язкова пауза на кожному етапі.

iOS: Збірка через Xcode Cloud або Fastlane з gym. Завантаження через Transporter або fastlane deliver. Використовуємо Phased Release (7 днів, по 1–2–5–10–20–50–100%) для minor та major оновлень. Для hotfix — можна запустити без Phased Release, але рев'ю все одно займе свій час.

Автоматизація через Fastlane: lane :release з increment_build_number, тестами, збіркою та завантаженням. CI/CD через GitHub Actions або Bitrise — кожен merge в main після проходження тестів готує збірку для TestFlight/Internal Testing. Ми гарантуємо, що кожен реліз проходить через цей пайплайн. Замовте аудит вашого релізного процесу — ми виявимо вузькі місця та запропонуємо покращення.

Етапи staged rollout

Що входить у нашу роботу по релізу?

Ми пропонуємо повний цикл випуску оновлень:

1. Розробка міграційної стратегії для Room/CoreData.
2. Налаштування CI/CD (Fastlane, GitHub Actions, Bitrise).
3. Підготовка release notes усіма мовами.
4. Перевірка backward compatibility з API бекенду.
5. Staged rollout з моніторингом Crashlytics.
6. Гарантія безшовного оновлення для користувачів.

Строки: patch — 1–2 дні, minor — 3–5 днів, major — 1–3 тижні з урахуванням міграційного тестування. Вартість розраховується індивідуально.

Досвід нашої команди — 10+ років у мобільній розробці, понад 50 релізів щорічно. Отримайте консультацію щодо вашого релізного процесу — оцінимо ваш проект та запропонуємо оптимальне рішення.

Публікація застосунків в App Store та Google Play: ASO, Fastlane, рев'ю

Супроводжуємо публікацію мобільних застосунків від першого сабміту до поетапного викату. Часто стикаємося з ситуацією, коли готовий продукт повертають на доопрацювання через бюрократичні вимоги платформ, а не технічні помилки. За статистикою Apple, близько 40% перших сабмітів відхиляються — і частину причин легко усунути заздалегідь. Google Play автоматизований сильніше, але там теж бувають сюрпризи: застосунок може бути опублікований і знятий через кілька днів, коли авторев'юер дообнаружує невідповідність політикам. Наш досвід — понад 50 успішних публікацій для iOS та Android, і ми гарантуємо, що після нашої підготовки застосунок відповідає всім актуальним вимогам платформ.

Чому App Store відхиляє застосунки?

Apple Review зазвичай займає 24–48 годин (середній час за статистикою Apple — близько 90% застосунків розглядаються за добу). Expedited review — реальна опція через App Store Connect при критичних багах, але не для першого сабміту.

Часті причини відхилення, які з'їдають час:

• Guideline 2.1 — App Completeness. Тест-акаунт не працює, демо-дані не завантажуються, частина екранів показує пустий state без пояснень. Рев'юер бачить зламаний застосунок. Рішення просте: заповнений тест-акаунт з реалістичними даними, Notes for Reviewer з покроковою інструкцією.
• Guideline 4.3 — Spam. Застосунок схожий на інший ваш застосунок або надто простий (обгортка над веб-сайтом). Якщо у вас кілька схожих застосунків для різних країн — потрібне серйозне обґрунтування відмінностей.
• Guideline 5.1.1 — Data Collection and Storage. Немає Privacy Policy, або в Privacy Manifest (PrivacyInfo.xcprivacy) не задекларовані required reason APIs (UserDefaults, FileTimestamp, DiskSpace, ActiveKeyboards). Apple почала відхиляти без нього ще на етапі попереднього завантаження.
• Guideline 3.1.1 — Business — Payments. Зовнішні посилання на оплату там, де має бути IAP (StoreKit 2). Після рішення Epic vs Apple у США Apple дозволила посилання на зовнішній сайт для Reader Apps, але правила складні та залежать від категорії.

Окремий момент — App Privacy Labels. Потрібно чесно задекларувати, що збирається, навіщо, і linked to user or not. Помилки тут не блокують публікацію одразу, але Apple може запитати виправлення постфактум.

Як уникнути відхилення за 5.1.1? Інструкція

1. Перевірте, чи включені в проекті наступні API: UserDefaults, FileTimestamp, DiskSpace, ActiveKeyboards, System Boot Time.
2. Якщо так — додайте PrivacyInfo.xcprivacy із зазначенням reasons. Шаблон можна взяти з документації Apple.
3. Ми зазвичай прописуємо файл на етапі налаштування проекту, а не перед сабмітом — це економить день-два на виправленнях.

Які сюрпризи ховає Google Play?

Google Play більш автоматизований, первинне рев'ю часто займає кілька годин. Але є нюанси.

• Target SDK level — Google регулярно підвищує вимоги. Нові застосунки повинні таргетувати поточний API (наприклад, станом на сьогодні це Android 14). Якщо не оновити — застосунок стане недоступним для нових користувачів.
• 64-bit requirement — всі застосунки з нативними бібліотеками повинні мати 64-bit версії. Flutter за замовчуванням збирає обидва варіанти, React Native з деякими нативними модулями — ні. Перевіряйте заздалегідь.
• Data Safety Form — аналог Apple Privacy Labels, заповнюється в Play Console. Google не перевіряє автоматично при кожному релізі, але може запросити аудит.
• Play Integrity API — заміна SafetyNet, deprecated. Для застосунків, яким важлива цілісність пристрою (банки, платіжні застосунки, ігри з анти-чит). Вимагає сервера для верифікації токена.

Що робити, якщо застосунок зняли з публікації на третій день?

Таке трапляється, коли авторев'юер дообнаружує порушення політики. Перевірте, чи відповідає застосунок поточним вимогам щодо реклами, збору даних та контенту. Якщо порушення незначне, можна подати апеляцію через Play Console. У нашій практиці близько 80% таких випадків вирішуються уточненням метаданих або виправленням помилки в конфігурації.

ASO — App Store Optimization: що реально приносить завантаження

ASO впливає на органічний трафік — це реальні завантаження без рекламного бюджету. У 95% випадків після нашої підготовки перша публікація проходить без відхилень модерації, але навіть без цього правильна оптимізація дає приріст конверсії.

Ключові фактори ранжування:

Використовуйте SKStoreReviewRequest.requestReview() (iOS) та ReviewManager.requestReview() (Android) після позитивної події, не при першому запуску.

Порівняння підходів до рев'ю

Fastlane — автоматизація публікації

Ручна публікація — сертифікати, provisioning profiles, збірка, завантаження — займає годину і легко помилитися. Fastlane автоматизує весь пайплайн, скорочуючи час у 10 разів порівняно з ручним процесом. Замість 40 хвилин рутини — 4 хвилини автоматичної збірки та завантаження.

Ключові lanes:

• match — керування сертифікатами через зашифрований Git-репозиторій. Вся команда використовує одні сертифікати.
• gym (build) — fastlane gym --scheme "AppName" --configuration Release --export_method app-store.
• deliver (upload to App Store) — завантажує бінарник, метадані, скріншоти (через fastlane snapshot).
• supply — аналог для Google Play, підтримує all tracks з rollout параметром.

Типовый Fastfile:

lane :release_ios do
  match(type: "appstore")
  gym(scheme: "App")
  deliver(submit_for_review: true, automatic_release: false)
end

lane :release_android do
  gradle(task: "bundle", build_type: "Release")
  supply(track: "production", rollout: "0.1")
end

Інтеграція з CI/CD (GitHub Actions, Bitrise) — стандартний стек. Код підписується автоматично при мержі в main.

Чек-лист перед публікацією

• Вказані всі дозволи в маніфесті (Android) або Info.plist (iOS) з поясненнями
• Privacy Manifest (iOS) містить всі required reason APIs
• Data Safety Form (Android) заповнена коректно
• Тест-акаунт активний і має реалістичні дані
• Немає зовнішніх посилань на оплату всередині IAP-продуктів
• Скріншоти відповідають актуальній версії інтерфейсу
• Версія білду інкрементована
• Код підписаний правильним сертифікатом (Distribution, не Development)
• 64-bit збірка присутня
• Відсутні згадки конкурентів у метаданих

Поетапний викат та rollback

Google Play підтримує поступове розгортання: rollout: "0.05" — 5% користувачів отримують оновлення спочатку. Моніторимо Crashlytics, crash-free rate, ANR rate. Якщо показники погіршилися — зупиняємо rollout без відкликання релізу. App Store використовує Phased Release (7-денний викат). Для гнучкого управління — feature flags через Firebase Remote Config або LaunchDarkly.

Що входить в роботу з публікації

Ми готуємо повний комплект для виходу в стори:

• Створення та налаштування акаунтів розробника (Apple Developer Program, Google Play Console) з корпоративними доступними.
• Підготовка метаданих: назва, опис, ключові слова, категорія, віковий рейтинг.
• Налаштування Privacy Policy та App Privacy Labels / Data Safety Form.
• Генерація сертифікатів, provisioning profiles (через match або вручну).
• Збірка та підпис бінарника з правильною конфігурацією (Code Signing, ProGuard/R8 shrink).
• Завантаження бінарника та метаданих через Fastlane або вручну.
• Проходження рев'ю: аналіз тікетів, апеляції при необхідності.
• Налаштування поетапного викату та моніторинг метрик після релізу.
• Навчання команди роботі з TestFlight / Firebase App Distribution.

Ми не пишемо код застосунку, не займаємося маркетингом (крім ASO-рекомендацій), не реєструємо торгові марки. Наша зона — технічна підготовка до публікації та супровід до першого релізу.

Терміни та вартість

Підготовка першого релізу: налаштування акаунтів, сертифікатів, метаданих, скріншотів, Privacy Policy — від 3 до 5 робочих днів за наявності всіх матеріалів. Налаштування Fastlane + CI/CD — від 2 до 3 днів. Рев'ю App Store — від 1 до 3 днів. Разом від готового застосунку до публікації — від 1 до 2 тижнів.

Вартість розраховується індивідуально: залежить від складності інтеграцій, кількості сторів та необхідності термінового рев'ю. Зв'яжіться з нами для оцінки вашого проекту — проаналізуємо готовність до публікації за один день.

У нас 7+ років досвіду в мобільній розробці, понад 50 успішно опублікованих застосунків для iOS та Android. Знаємо всі підводні камені App Store Review Guidelines (розділи 4.2, 5.1) та політик Google Play. Використовуємо Fastlane, CI/CD, автоматичні перевірки метаданих — щоб ви не витрачали час на рутину. Замовте консультацію — розкажемо, як скоротити цикл публікації вдвічі.