# Aktualizacja aplikacji iOS: stopniowe wdrażanie w App Store > Aktualizacja aplikacji iOS: nowa wersja, nowy build, opis nowości, potem wydanie ręczne, automatyczne albo stopniowe przez 7 dni. Oryginalna strona: [Aktualizacja aplikacji iOS: stopniowe wdrażanie w App Store](https://devoria.fr/pl/blog/aktualizacja-aplikacji-ios-stopniowe-wdrazanie) Autor: [Mehdi Azizi](https://devoria.fr/pl/mehdi-azizi) Publikacja: 2026-11-04 Ostatnia aktualizacja treści: 2026-11-04 Ż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](https://developer.apple.com/help/app-store-connect/update-your-app/create-a-new-version) 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](https://devoria.fr/pl/blog/testflight-testowanie-aplikacji-iphone), 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](https://devoria.fr/pl/blog/app-store-connect-build-number-wersja). 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](https://devoria.fr/pl/blog/eas-submit-ios-publikacja-aplikacji-expo-app-store). ## Tekst „Co nowego”: czego wymaga Apple [Strona z informacjami o wersji](https://developer.apple.com/help/app-store-connect/reference/app-information/platform-version-information) 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](https://developer.apple.com/app-store/review/guidelines/#2.3.12) 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](https://developer.apple.com/app-store/ratings-and-reviews/), ż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: ```text 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: ```text 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: ```text [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](https://developer.apple.com/help/app-store-connect/manage-your-apps-availability/select-an-app-store-version-release-option) 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](https://developer.apple.com/help/app-store-connect/update-your-app/release-a-version-update-in-phases) 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](https://developer.apple.com/help/app-store-connect/reference/app-information/required-localizable-and-editable-properties). 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ę](https://developer.apple.com/help/app-review/after-submitting-for-review/request-expedited-review). 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](https://devoria.fr/pl/blog/czas-weryfikacji-app-store-ile-czekac). ## 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](https://devoria.fr/pl/blog/tekst-promocyjny-app-store-170-znakow) 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](https://docs.expo.dev/eas-update/introduction/) 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](https://docs.expo.dev/versions/latest/sdk/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](https://developer.apple.com/help/app-store-connect/monitor-ratings-and-reviews/reset-an-app-overview-rating) 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](https://devoria.fr/pl/kits/app-review) 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](https://devoria.fr/pl/expertise/publikacja-aplikacji-w-app-store). Jeśli przygotowujesz swoje pierwsze wydanie, [zrób darmową diagnozę](https://devoria.fr/pl/diagnostic): 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. ## Twój projekt [Review Kit](https://devoria.fr/pl/kits/app-review): Moja checklista do App Store Review, poprawione odrzucenia od Apple, checklista do Google Play i trzy skille Claude Code. 219 zł. [iOS & Android Kit](https://devoria.fr/pl/kits/ios): Stwórz swoją aplikację na iPhone'a i Androida z Claude Code: kod startowy moich aplikacji, droga aż do sklepów i wszystkie kity. 439 zł. [Diagnoza: co dzieli cię od twojej aplikacji na iPhone'a](https://devoria.fr/pl/diagnostic): 7 pytań, 60 sekund: wiesz, co naprawdę blokuje publikację twojej aplikacji na iPhone'a, masz plan w 4 krokach i kit dopasowany do ciebie.