Оновлення iOS-застосунку: поступовий випуск у App Store

Щоб випустити оновлення iOS, ти створюєш нову версію в App Store Connect із вищим номером. Прикріплюєш до неї новий build, пишеш текст «Що нового» і надсилаєш її в App Review. Кожна нова версія знову проходить перевірку Apple, навіть простий виправлювальний реліз. Перед надсиланням ти обираєш, як вона вийде після схвалення: вручну, одразу, не раніше певної дати або поступовим випуском протягом 7 днів.

Поступовий випуск стосується лише автоматичних оновлень: 1 % таких користувачів у перший день, усі на сьомий. Ти можеш поставити його на паузу загалом до 30 днів або завершити одразу. Цей гайд спирається на довідкові сторінки Apple, які я перечитав 3 листопада 2026 року.

Я випускаю оновлення своїх iOS-застосунків з Expo та EAS, серед них Solys, TradaZen і Nolera. Приклади нижче взяті з цих релізів.

Як випустити оновлення iOS: кроки по порядку

Довідка App Store Connect про нові версії описує такий шлях:

1. У розділі Apps обери свій застосунок і натисни кнопку + поруч із платформою.
2. Введи номер версії, вищий за попередній, і натисни Create.
3. Перевір метадані: дані опублікованої версії копіюються автоматично.
4. Надішли новий build зі збільшеним номером build.
5. Протестуй цей build у TestFlight, додай його до версії й надішли її в App Review.

Дві умови перед початком. Опублікована версія має бути в статусі Ready for Distribution. І тобі потрібна одна з ролей: Account Holder, Admin, App Manager або Marketing.

Відкотитися назад не можна. Apple пише про це на тій самій сторінці: якщо з версією проблема, повернутися до попередньої неможливо. Треба створити й надіслати нову версію.

Номер версії та номер build

Версія: це номер, який клієнти бачать на сторінці застосунку. Build ідентифікує кожне надсилання. Пара «версія + build» має бути унікальною: правила й пов'язані помилки описано в статті версія та номер build.

Моя домовленість, яка не є правилом Apple: остання цифра зростає для виправлення, з 1.4.0 до 1.4.1. Середня зростає для нової функції, з 1.4.1 до 1.5.0. А номер build тільки зростає, від версії до версії. В Expo версія живе в app.json, а EAS може збільшувати build при кожній production-збірці. Налаштування описано в статті як опублікувати застосунок Expo з EAS.

Текст «Що нового»: чого вимагає Apple

Сторінка з інформацією про версію описує поле What's New in This Version:

• Не більше 4 000 символів.
• Відсутнє для першої версії, обов'язкове для всіх наступних.
• Перекладається кожною мовою твоєї сторінки.

Правило 2.3.12 з App Review Guidelines додає вимогу: чітко описувати нові функції та зміни продукту. Для простих виправлень багів, безпеки чи продуктивності вистачить загального формулювання. Важливу зміну треба перелічити. Тож «Виправлення багів і покращення» не підходить для версії, яка змінює твою підписку або головний екран.

Apple також радить на своїй сторінці про відгуки згадувати в примітках виправлені проблеми, про які клієнти писали у відгуках.

Ось три шаблони, які можна адаптувати, по одному на тип версії.

Для виправлення:

Виправлення та стабільність.
- [Функція]: виправлено [те, що не працювало].
- [Екран] завантажується швидше.
Дякуємо всім, хто про це повідомив.

Для нової функції:

Нове: [функція, п'ятьма словами].
[Що ти тепер можеш зробити, одним реченням.]
Де знайти: [вкладка] > [кнопка].

Також у цій версії:
- [Помітне покращення].
- Виправлення багів.

Для зміненого сценарію:

[Екран або сценарій] змінюється.
- Що зміниться для тебе: [конкретний ефект].
- Що залишається: [дані, налаштування, покупка].
Є питання? [Налаштування] > [Допомога].

Останній рядок шаблону для виправлення доречний, лише якщо хтось справді повідомив про проблему. Ніколи не пиши про новинку, якої немає в build: правило 2.3 вимагає, щоб метадані відповідали застосунку.

Ручний, автоматичний випуск або випуск у певну дату

Довідка про варіанти випуску пропонує три:

Варіант	Після схвалення Apple
Ручний	Статус Pending Developer Release, публікуєш, коли захочеш
Автоматичний	Версія виходить одразу після схвалення
Автоматичний, не раніше ...	Вона чекає обраної дати, потім виходить сама

При ручному випуску ти відкриваєш версію в статусі Pending Developer Release, натискаєш Release This Version і підтверджуєш. Apple попереджає, що її появи в App Store можна чекати до 24 годин. Повідомлення на сторінці версії пропонує Cancel This Release, щоб скасувати. Якщо версія чекає понад 30 днів, Apple надсилає тобі нагадування електронною поштою.

Ручний випуск потрібен, щоб обрати момент, наприклад щоб опублікувати в день анонсу. Solys 2.0.0, де була нова версія річної підписки, пішла на перевірку наприкінці вересня 2026 року з ручним випуском.

Для звичайної версії я залишаю автоматичний випуск. Nolera 1.0.2, схвалена 12 жовтня 2026 року, з'явилася в App Store менш ніж за хвилину після листа від Apple, згідно з публічним пошуковим API iTunes. Це лише одне спостереження: закладай час із запасом.

Поступовий випуск протягом 7 днів

Довідка Apple про поступовий випуск дає точний графік:

День	Частка користувачів
1	1 %
2	2 %
3	5 %
4	10 %
5	20 %
6	50 %
7	100 %

Оновлення надходить випадковій вибірці користувачів, які ввімкнули автоматичні оновлення, на сумісних пристроях. Їх не повідомляють, що вони потрапили до вибірки.

Поступовий випуск стримує лише автоматичні оновлення. Apple уточнює, що будь-хто може завантажити нову версію з App Store будь-коли. Тож людина, яка встановлює твій застосунок або натискає Update на його сторінці, може отримати її вже в перший день. Це не тест на 1 % користувачів: це гальмо для решти.

Щоб увімкнути його, відкрий версію, прокрути до розділу Phased Release for Automatic Updates, постав позначку «Release update over a 7-day period using phased release» і збережи. Потрібна роль Account Holder, Admin або App Manager. Опція доступна аж до статусу Pending Developer Release: ти ще можеш увімкнути її після схвалення Apple, поки версія чекає на твій ручний випуск.

Після схвалення версії її статус Ready for Distribution має позначку «Phased Release». Наприкінці 7 днів Admin і App Manager застосунку отримують сповіщення.

Пауза, відновлення та випуск для всіх

• Пауза: загалом до 30 днів, скільки завгодно разів. Пауза на 10 днів залишає 20 днів для наступних.
• Відновлення: випуск продовжується з того дня, на якому ти його зупинив.
• Випуск для всіх: кнопка Release to All Users угорі праворуч на сторінці версії надсилає оновлення на всі пристрої з автоматичними оновленнями.
• Зняття з продажу: остаточно зупиняє випуск, зокрема якщо закінчується твоє членство в програмі розробників. Якщо застосунок повертається в продаж, версія стає доступною для всіх одразу.

Після випуску для всіх більше нічого не налаштуєш, уточнює таблиця властивостей, які можна змінювати.

Nolera 1.0.2 вийшла без поступового випуску. Ось як я користувався б ним протягом тижня:

Що ти бачиш	Що ти робиш	Що відбувається
Збої або тривожні відгуки	Пауза	Автоматичні оновлення зупиняються
Виправлення готове	Нова версія	Вона знову проходить перевірку, зі своїм випуском
Нічого незвичного через 3 або 4 дні	Release to All Users	Усі її отримують
Ти чекаєш відповіді від Apple	Пауза, загалом 30 днів	Відновлення з того дня, де ти зупинився

Під час паузи ручні завантаження тривають. Вмикай поступовий випуск для кожної версії, що зачіпає оплату або перший запуск: саме там дефект коштує найдорожче, а відкотитися ти не зможеш.

Коли виправлення термінове: прискорена перевірка

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

1. Спочатку надішли свою версію. Опиши баг у полі Notes для рецензента.
2. Заповни форму запиту на прискорену перевірку, потім обери застосунок і платформу.
3. Apple прискорює перевірку залежно від своїх можливостей. Нічого не гарантовано.

Для події вкажи в примітках її дату й свій зв'язок із нею. Звичайні терміни описано в статті скільки триває перевірка App Store.

Що знову проходить review, а що ні

Зміна	Що потрібно
Нативний код, дозволи, версія SDK	Новий build, нова версія, повна перевірка
Скриншоти, опис, ключові слова, «Що нового»	Нова версія, перевірка разом із нею
Рекламний текст	Нічого: змінюється без нового надсилання
Пауза, відновлення, випуск для всіх	Нічого: це налаштування випуску
Заголовок сторінки iOS 27	Окремо в Asset Library або разом із версією
Виправлення JavaScript, з Expo	Можливе віддалене оновлення

Рекламний текст змінюється без нового надсилання, згідно зі сторінкою інформації про версію. З Expo віддалене оновлення змінює JavaScript, тексти й зображення без App Store. Документація Expo встановлює два обмеження: нативний код, дозволи й версія SDK потребують нового бінарника, а оновлення мають дотримуватися правил App Store.

Мій випадок: віддалене виправлення, якого рецензент так і не побачив

У вересні 2026 року build Nolera чекав перевірки. Я виправив дефект екрана сканування й опублікував це виправлення як віддалене оновлення, поки build чекав. Build усе одно відхилили через цей уже виправлений дефект.

Пояснення є в документації expo-updates: за замовчуванням застосунок завантажує оновлення під час запуску й застосовує його під час наступного. Рецензент встановлює застосунок, запускає його один раз і тестує код, вбудований у build. Те саме правило діє для твоїх нових користувачів: їхня перша сесія працює на коді з build.

Відтоді будь-яка зміна головного екрана, paywall або основної функції йде в новому build. Віддалене оновлення служить лише тим, у кого застосунок уже є.

Скинути рейтинг разом із версією

Кожна нова версія пропонує опцію Reset rating when this version is released. Згідно з довідкою Apple про скидання, вона діє для всіх країн, зберігає письмові відгуки й не скасовується після випуску. Apple радить користуватися нею обережно, бо сторінка з малою кількістю оцінок може відштовхувати.

Чекліст перед надсиланням оновлення

• Номер версії вищий, build збільшено.
• Build протестовано в TestFlight, на маленькому iPhone та на iPad, якщо твій застосунок там працює.
• «Що нового» написано кожною мовою, важливі зміни перелічено.
• Скриншоти показують актуальний інтерфейс, якщо він змінився.
• Примітки для рецензента пояснюють, що змінилося і де це знайти.
• Варіант випуску обрано: ручний, якщо треба втримати дату.
• Поступовий випуск увімкнено, якщо версія зачіпає оплату або перший запуск.
• Ти знаєш, чи можливе виправлення піде віддалено, чи потребуватиме build.

Проходити перевірку з кожним оновленням

Кожне оновлення знову проходить App Review, і відмова блокує твоє виправлення. Review Kit містить мій чекліст перед надсиланням, мої виправлені відмови та два skills для Claude Code, які перевіряють твій проєкт і сторінку застосунку, а потім готують відповідь, якщо Apple відмовить. Повний шлях описано на сторінці як опублікувати застосунок в App Store.

Якщо готуєш свій перший реліз, пройди безкоштовну діагностику: вона розставить кроки по порядку й надішле тобі мій чекліст проти відмов Apple.

Поширені запитання

Скільки триває поступовий випуск в App Store?

Сім днів: 1 % користувачів з автоматичними оновленнями в перший день, потім 2, 5, 10, 20 і 50 %, і 100 % на сьомий. Ти можеш поставити його на паузу загалом до 30 днів або завершити будь-коли через Release to All Users.

Чи проходить оновлення iOS-застосунку перевірку Apple?

Так. Кожна нова версія з її build і метаданими проходить App Review. А рекламний текст і налаштування випуску змінюються без нового надсилання.

Чи можна повернутися до старої версії застосунку в App Store?

Ні. Треба створити нову версію з виправленням і надіслати її на перевірку. Саме тому поступовий випуск і його пауза такі корисні.

Чи отримують нові користувачі оновлення під час поступового випуску?

Так, якщо завантажують застосунок з App Store. Поступовий випуск регулює лише автоматичні оновлення: будь-хто може завантажити нову версію будь-коли.

Чи можна ввімкнути поступовий випуск після схвалення Apple?

Так, поки версія в статусі Pending Developer Release, тобто з ручним випуском і ще не опублікована. Після виходу версії для неї вже запізно.

Що писати в примітках до оновлення?

Нові функції та важливі зміни, чітко перелічені: це правило 2.3.12. Для простого виправлення багів, безпеки чи продуктивності вистачить загального формулювання. Поле вміщує 4 000 символів і перекладається кожною мовою.