Aktualizacja aplikacji iOS: stopniowe wdrażanie w App Store

Żeby opublikować aktualizację aplikacji iOS, tworzysz w App Store Connect nową wersję z wyższym numerem. Dołączasz do niej nowy build, piszesz tekst „Co nowego”, a potem wysyłasz ją do App Review. Każda nowa wersja przechodzi ponownie przez recenzję Apple, nawet zwykła poprawka. Przed wysłaniem wybierasz, jak wyjdzie po akceptacji: ręcznie, od razu, nie wcześniej niż w wybranym dniu albo stopniowo przez 7 dni.

Stopniowe wdrażanie dotyczy tylko automatycznych aktualizacji: 1% tych użytkowników pierwszego dnia, wszyscy siódmego. Możesz je wstrzymać łącznie maksymalnie na 30 dni albo zakończyć od razu dla wszystkich. Ten poradnik opiera się na stronach pomocy Apple, sprawdzonych 3 listopada 2026.

Aktualizacje moich aplikacji iOS publikuję przez Expo i EAS, w tym Solys, TradaZen i Nolera. Przypadki opisane niżej pochodzą z tych wydań.

Publikacja aktualizacji iOS: kroki po kolei

Pomoc App Store Connect dotycząca nowych wersji podaje taką ścieżkę:

1. W Apps wybierz swoją aplikację, potem kliknij przycisk + obok platformy.
2. Wpisz numer wersji wyższy od poprzedniego i kliknij Create.
3. Przejrzyj metadane: te z wersji opublikowanej są kopiowane automatycznie.
4. Wyślij nowy build ze zwiększonym numerem builda.
5. Przetestuj ten build w TestFlight, dodaj go do wersji i wyślij ją do App Review.

Dwa warunki na start. Opublikowana wersja musi mieć status Ready for Distribution. I potrzebujesz jednej z tych ról: Account Holder, Admin, App Manager albo Marketing.

Nie da się cofnąć wersji. Apple pisze to na tej samej stronie: jeśli wersja sprawia problemy, nie możesz wrócić do poprzedniej. Musisz utworzyć i wysłać nową wersję.

Numer wersji i numer builda

Wersja to numer, który klienci widzą na twojej stronie w sklepie. Build identyfikuje każdą wysyłkę. Para wersja i build musi być unikalna: zasady i powiązane błędy znajdziesz w artykule wersja i numer builda.

Moja konwencja, która nie jest zasadą Apple: ostatnia cyfra rośnie przy poprawce, z 1.4.0 na 1.4.1. Środkowa rośnie przy nowej funkcji, z 1.4.1 na 1.5.0. Numer builda tylko rośnie, z wersji na wersję. W Expo wersja siedzi w app.json, a EAS może zwiększać build przy każdej kompilacji produkcyjnej. Konfigurację opisuję w artykule publikacja aplikacji Expo z EAS.

Tekst „Co nowego”: czego wymaga Apple

Strona z informacjami o wersji opisuje pole What's New in This Version:

• Maksymalnie 4000 znaków.
• Nie ma go w pierwszej wersji, jest obowiązkowe we wszystkich kolejnych.
• Można je przetłumaczyć na każdy język twojej strony w sklepie.

Zasada 2.3.12 z App Review Guidelines dodaje wymóg: jasno opisz nowe funkcje i zmiany w produkcie. Ogólna formułka wystarczy przy zwykłych poprawkach błędów, bezpieczeństwa czy wydajności. Ważną zmianę trzeba wymienić. „Poprawki błędów i ulepszenia” nie wystarczą więc przy wersji, która zmienia subskrypcję albo ekran główny.

Apple radzi też, na swojej stronie o ocenach i recenzjach, żeby w notatkach wspomnieć o naprawionych problemach, które klienci opisali w recenzjach.

Oto trzy szablony do dopasowania, po jednym na typ wersji.

Dla poprawki:

Poprawki i stabilność.
- [Funkcja]: naprawiliśmy [to, co nie działało].
- [Ekran] ładuje się szybciej.
Dziękujemy wszystkim, którzy to zgłosili.

Dla nowej funkcji:

Nowość: [funkcja w pięciu słowach].
[Co możesz teraz zrobić, w jednym zdaniu.]
Gdzie ją znaleźć: [zakładka] > [przycisk].

Także w tej wersji:
- [Widoczne ulepszenie].
- Poprawki błędów.

Dla zmienionej ścieżki:

[Ekran lub ścieżka] się zmienia.
- Co się dla ciebie zmienia: [konkretny efekt].
- Co zostaje: [dane, ustawienia, zakup].
Pytanie? [Ustawienia] > [Pomoc].

Ostatnia linia szablonu poprawki ma sens tylko wtedy, gdy ktoś naprawdę zgłosił problem. Nigdy nie wpisuj nowości, której nie ma w buildzie: zasada 2.3 wymaga metadanych zgodnych z aplikacją.

Wydanie ręczne, automatyczne albo w wybranym dniu

Pomoc dotycząca opcji wydania proponuje trzy:

Opcja	Po akceptacji Apple
Ręczne	Status Pending Developer Release, publikujesz, kiedy chcesz
Automatyczne	Wersja wychodzi zaraz po akceptacji
Automatyczne, nie wcześniej niż...	Czeka do wybranego dnia, potem wychodzi sama

Przy wydaniu ręcznym otwierasz wersję ze statusem Pending Developer Release, klikasz Release This Version i potwierdzasz. Apple uprzedza, że pojawienie się w App Store może potrwać do 24 godzin. Komunikat na stronie wersji oferuje Cancel This Release, żeby anulować. Jeśli wersja czeka ponad 30 dni, Apple wysyła ci przypomnienie mailem.

Wydanie ręczne służy do wyboru momentu, na przykład żeby opublikować w dniu ogłoszenia. Solys 2.0.0, z nową wersją rocznej subskrypcji, poszło do recenzji pod koniec września 2026 z wydaniem ręcznym.

Przy rutynowej wersji zostawiam wydanie automatyczne. Nolera 1.0.2, zaakceptowana 12 października 2026, pojawiła się w App Store niecałą minutę po mailu od Apple, według publicznego API wyszukiwania iTunes. To jedna obserwacja: licz z zapasem.

Stopniowe wdrażanie przez 7 dni

Pomoc Apple o stopniowym wdrażaniu podaje dokładny harmonogram:

Dzień	Odsetek użytkowników
1	1%
2	2%
3	5%
4	10%
5	20%
6	50%
7	100%

Aktualizacja trafia do losowej próbki użytkowników, którzy mają włączone automatyczne aktualizacje, na zgodnych urządzeniach. Nie dostają informacji, że są w tej grupie.

Stopniowe wdrażanie spowalnia tylko automatyczne aktualizacje. Apple zaznacza, że każdy może pobrać nową wersję z App Store w dowolnym momencie. Ktoś, kto instaluje twoją aplikację albo stuknie Update na jej stronie, może ją więc mieć już pierwszego dnia. To nie jest test na 1% użytkowników: to hamulec dla pozostałych.

Żeby je włączyć, otwórz wersję, zjedź do sekcji Phased Release for Automatic Updates, zaznacz „Release update over a 7-day period using phased release” i zapisz. Potrzebna jest rola Account Holder, Admin albo App Manager. Opcja jest dostępna aż do statusu Pending Developer Release: możesz ją włączyć jeszcze po akceptacji Apple, dopóki wersja czeka na twoje ręczne wydanie.

Po zatwierdzeniu wersji jej status Ready for Distribution ma dopisek „Phased Release”. Po 7 dniach Admin i App Manager aplikacji dostają powiadomienie.

Pauza, wznowienie i wydanie dla wszystkich

• Pauza: łącznie do 30 dni, w dowolnej liczbie razy. Pauza na 10 dni zostawia 20 dni na kolejne.
• Wznowienie: wdrażanie rusza od dnia, w którym je zatrzymałeś.
• Wydanie dla wszystkich: przycisk Release to All Users, w prawym górnym rogu wersji, wysyła aktualizację na wszystkie urządzenia z automatycznymi aktualizacjami.
• Wycofanie ze sprzedaży: zatrzymuje wdrażanie na dobre, także gdy wygaśnie twoje członkostwo w programie deweloperskim. Jeśli aplikacja wróci do sprzedaży, wersja będzie od razu dostępna dla wszystkich.

Po wydaniu dla wszystkich nie da się już nic ustawić, jak podaje tabela edytowalnych właściwości.

Nolera 1.0.2 wyszła bez stopniowego wdrażania. Tak bym go używał w ciągu tygodnia:

Co widzisz	Co robisz	Co się dzieje
Crashe albo niepokojące recenzje	Pauza	Automatyczne aktualizacje się zatrzymują
Poprawka jest gotowa	Nowa wersja	Znów idzie do recenzji, z własnym wdrażaniem
Nic niepokojącego po 3 czy 4 dniach	Release to All Users	Wszyscy ją dostają
Czekasz na odpowiedź Apple	Pauza, łącznie 30 dni	Wznowienie od dnia, w którym przerwałeś

W czasie pauzy ręczne pobrania trwają dalej. Zaznacz stopniowe wdrażanie przy każdej wersji, która dotyka płatności albo pierwszego uruchomienia: tam błąd kosztuje najwięcej, a cofnąć się nie da.

Gdy poprawka jest pilna: przyspieszona recenzja

Apple pozwala poprosić o przyspieszoną recenzję. Jest zarezerwowana na prawdziwe nagłe sytuacje: krytyczny błąd do naprawy albo wydanie związane z wydarzeniem.

1. Najpierw wyślij wersję. Opisz błąd w polu Notes dla recenzenta.
2. Wypełnij formularz prośby o przyspieszoną recenzję, potem wybierz aplikację i platformę.
3. Apple przyspiesza recenzję w miarę możliwości. Nic nie jest gwarantowane.

Przy wydarzeniu podaj w notatkach jego datę i swój związek z nim. Zwykłe terminy znajdziesz w artykule czas weryfikacji w App Store.

Co wraca do recenzji, a co nie

Zmiana	Czego potrzebujesz
Kod natywny, uprawnienia, wersja SDK	Nowy build, nowa wersja, pełna recenzja
Zrzuty, opis, słowa kluczowe, nowości	Nowa wersja, recenzowane razem z nią
Tekst promocyjny	Nic: zmienia się bez nowego zgłoszenia
Pauza, wznowienie, wydanie dla wszystkich	Nic: to ustawienia wydania
Nagłówek strony w iOS 27	Osobno w Asset Library albo razem z wersją
Poprawka JavaScript w Expo	Możliwa aktualizacja zdalna

Tekst promocyjny zmienia się bez nowego zgłoszenia, według strony z informacjami o wersji. W Expo aktualizacja zdalna zmienia JavaScript, teksty i obrazy bez przechodzenia przez App Store. Dokumentacja Expo stawia dwa ograniczenia: kod natywny, uprawnienia i wersja SDK wymagają nowego pliku binarnego, a aktualizacje muszą być zgodne z zasadami App Store.

Mój przypadek: zdalna poprawka, której recenzent nigdy nie zobaczył

We wrześniu 2026 build Nolery czekał na recenzję. Naprawiłem błąd na ekranie skanowania i opublikowałem tę poprawkę jako aktualizację zdalną w trakcie czekania. Build i tak został odrzucony, właśnie przez ten już naprawiony błąd.

Wyjaśnienie jest w dokumentacji expo-updates: domyślnie aplikacja pobiera aktualizację przy uruchomieniu i stosuje ją przy następnym. Recenzent instaluje aplikację, uruchamia ją raz i testuje kod wbudowany w build. Ta sama zasada dotyczy twoich nowych użytkowników: ich pierwsza sesja działa na kodzie z builda.

Od tamtej pory każda zmiana ekranu startowego, paywalla albo głównej funkcji idzie w nowym buildzie. Aktualizacja zdalna służy tylko osobom, które już mają aplikację.

Wyzerowanie oceny razem z wersją

Każda nowa wersja oferuje opcję Reset rating when this version is released. Według pomocy Apple o zerowaniu oceny działa we wszystkich krajach, zachowuje pisemne recenzje i nie da się jej cofnąć po wydaniu. Apple radzi korzystać z niej oszczędnie, bo strona z małą liczbą ocen może zniechęcać.

Checklista przed wysłaniem aktualizacji

• Numer wersji jest wyższy, build jest zwiększony.
• Build jest przetestowany w TestFlight, na małym iPhonie i na iPadzie, jeśli aplikacja na nim działa.
• Nowości są napisane w każdym języku, a ważne zmiany są wymienione.
• Zrzuty pokazują aktualny interfejs, jeśli się zmienił.
• Notatki dla recenzenta mówią, co się zmieniło i gdzie to znaleźć.
• Opcja wydania jest wybrana: ręczna, jeśli musisz trzymać się daty.
• Stopniowe wdrażanie jest zaznaczone, jeśli wersja dotyka płatności albo pierwszego uruchomienia.
• Wiesz, czy ewentualna poprawka może pójść zdalnie, czy będzie wymagała builda.

Przejść recenzję przy każdej aktualizacji

Każda aktualizacja wraca do App Review, a odrzucenie blokuje twoją poprawkę. Review Kit zbiera moją checklistę przed wysyłką, moje naprawione odrzucenia i dwa skille Claude Code, które przeglądają twój projekt i stronę w sklepie, a potem przygotowują odpowiedź, jeśli Apple odrzuci. Pełna ścieżka jest na stronie publikacja aplikacji w App Store.

Jeśli przygotowujesz swoje pierwsze wydanie, zrób darmową diagnozę: ustawi kroki w kolejności i wyśle ci moją checklistę przeciw odrzuceniom Apple.

Najczęściej zadawane pytania

Ile trwa stopniowe wdrażanie w App Store?

Siedem dni: 1% użytkowników z automatycznymi aktualizacjami pierwszego dnia, potem 2, 5, 10, 20 i 50%, a siódmego dnia 100%. Możesz je wstrzymać łącznie do 30 dni albo zakończyć w dowolnym momencie przyciskiem Release to All Users.

Czy aktualizacja aplikacji iOS znów przechodzi recenzję Apple?

Tak. Każda nowa wersja, z buildem i metadanymi, przechodzi przez App Review. Tekst promocyjny i ustawienia wydania zmieniasz bez nowego zgłoszenia.

Czy można wrócić do starszej wersji aplikacji w App Store?

Nie. Trzeba utworzyć nową wersję z poprawką i wysłać ją do recenzji. Dlatego stopniowe wdrażanie i jego pauza są przydatne.

Czy nowi użytkownicy dostają aktualizację w trakcie stopniowego wdrażania?

Tak, jeśli pobierają aplikację z App Store. Stopniowe wdrażanie reguluje tylko automatyczne aktualizacje: każdy może pobrać nową wersję w dowolnym momencie.

Czy można włączyć stopniowe wdrażanie po akceptacji Apple?

Tak, dopóki wersja ma status Pending Developer Release, czyli jest ustawiona na wydanie ręczne i jeszcze nieopublikowana. Gdy wersja już wyjdzie, na tę wersję jest za późno.

Co wpisać w notatkach do wersji przy aktualizacji?

Nowe funkcje i ważne zmiany, jasno wymienione: tak mówi zasada 2.3.12. Przy zwykłej poprawce błędów, bezpieczeństwa czy wydajności wystarczy ogólna formułka. Pole mieści 4000 znaków i tłumaczy się je na każdy język.