Staged Rollout — co to jest, jak działa stopniowe wydawanie

Czym jest Staged Rollout?

Staged Rollout — to funkcja Google Play Console do stopniowego rozpowszechniania aktualizacji aplikacji. Deweloper określa procent użytkowników, którzy otrzymają nową wersję, i stopniowo zwiększa zasięg, śledząc stabilność i metryki jakości. Pełne wydanie dla wszystkich użytkowników jest wykonywane dopiero po potwierdzeniu braku krytycznych problemów.

Mechanizm działa na poziomie sklepu z aplikacjami: Google Play automatycznie dystrybuuje aktualizację wśród wybranego procentu urządzeń. Użytkownicy nie widzą różnicy — dla nich jest to zwykła aktualizacja ze sklepu. Wewnątrz wybranego segmentu użytkownicy są wybierani losowo, co zapewnia reprezentatywną próbkę.

Historia pojawienia się funkcji

Google wprowadziło Staged Rollout w 2015 roku jako część Google Play Developer Console. Przed pojawieniem się tej funkcji deweloperzy publikowali aktualizacje natychmiast dla wszystkich użytkowników, co prowadziło do masowych awarii w przypadku błędów. Według danych Google I/O 2023, wprowadzenie stopniowych wydań zmniejszyło liczbę krytycznych incydentów w aplikacjach Android o 60%.

Kiedy stosować Staged Rollout

Stopniowe wydanie jest używane przy publikowaniu znaczących zmian: nowy wygląd, zmiana architektury, aktualizacja SDK, zmiana bazy danych lub migracja do nowej wersji API. Staged Rollout jest również zalecany do testów A/B metryk produkcyjnych przed pełnym wdrożeniem.

Jak działa Staged Rollout

Po przesłaniu APK lub App Bundle do Google Play Console deweloper wybiera Staged Rollout zamiast pełnego wydania. System proponuje określenie procentu użytkowników od 5% do 100% z krokiem 5%. Google Play automatycznie dystrybuuje aktualizację wśród zadanego procentu losowo wybranych użytkowników.

Algorytm dystrybucji

Google Play używa deterministycznego algorytmu opartego na identyfikatorze urządzenia i numerze wersji kodu. Gwarantuje to, że użytkownik, który otrzymał aktualizację na 10%, nie straci jej przy zwiększeniu procentu do 20%. Dystrybucja jest stabilna: użytkownik albo już otrzymał wersję, albo otrzyma ją przy następnym zwiększeniu zasięgu.

// build.gradle — wersjonowanie dla Staged Rollout
android {
    defaultConfig {
        versionCode 42
        versionName "2.4.0-staged"
    }
}

// Po potwierdzeniu stabilności — pełne wydanie
// versionCode pozostaje ten sam, versionName → "2.4.0"

Monitorowanie metryk w trakcie

Po uruchomieniu Staged Rollout należy śledzić kluczowe wskaźniki: liczbę ANR, częstotliwość awarii, ocenę i opinie użytkowników. Google Play Console udostępnia panel metryk w czasie rzeczywistym. W przypadku przekroczenia progów zaleca się natychmiastowe zatrzymanie wydania i wycofanie zmian.

Konfiguracja w Google Play Console

Konfiguracja Staged Rollout odbywa się w trzech krokach i nie wymaga zmian w kodzie aplikacji. Wystarczy przesłać kompilację do Google Play Console i wybrać opcję stopniowego wydania. Poniżej znajduje się instrukcja krok po kroku z konkretnymi sekcjami interfejsu.

• Przejść do Google Play Console → Release → Production
• Kliknąć Create new release i przesłać App Bundle
• Wybrać Staged rollout i określić procent użytkowników
• Potwierdzić wydanie i uruchomić stopniowe rozpowszechnianie
• Śledzić metryki w panelu Dashboard

Wybór procentu zasięgu

Na pierwszym etapie zaleca się wybór 5–10% użytkowników. To minimalna reprezentatywna próbka do wykrycia krytycznych błędów. W przypadku braku problemów procent zwiększa się do 25%, 50% i 100% w odstępach 24–48 godzin. Szybkie zwiększanie zasięgu jest uzasadnione tylko w przypadku nieznacznych zmian.

Ograniczenia Staged Rollout

Funkcja jest dostępna tylko dla wydań produkcyjnych w Google Play. Dla testów otwartych i zamkniętych ścieżek stosuje się oddzielne mechanizmy. Staged Rollout nie można stosować do poszczególnych krajów lub regionów — procent jest obliczany od całkowitej liczby odbiorców aplikacji. Do targetowania geograficznego używa się country-specific releases. Nie można również ustawić różnego procentu dla różnych kanałów dystrybucji — wszyscy użytkownicy są wybierani losowo niezależnie od źródła instalacji.

Zalety stopniowego wydania

Staged Rollout zmniejsza ryzyko publikacji, umożliwiając wykrycie problemów na małej próbce użytkowników. W przeciwieństwie do testów na ścieżkach wewnętrznych, ruch produkcyjny ujawnia rzeczywiste scenariusze użycia, których nie można odtworzyć w środowisku QA. Według analizy Google Play Console (2024), 70% krytycznych błędów jest wykrywanych właśnie na etapie stopniowego wydania.

Wpływ na doświadczenie użytkownika

W przypadku wystąpienia problemów tylko niewielka część użytkowników spotyka się z błędami. Pozostali nadal pracują na stabilnej wersji. To utrzymuje ocenę aplikacji i zapobiega masowym negatywnym opiniom. Google Play również uwzględnia stabilność wydań przy rankingu w wyszukiwarce.

Integracja z CI/CD

Staged Rollout jest obsługiwany przez Google Play Developer API, co umożliwia automatyzację stopniowych wydań przez pipeline CI/CD. Narzędzia takie jak Gradle Play Publisher i Fastlane udostępniają gotowe polecenia do konfiguracji procentu zasięgu i monitorowania statusu wydania przez skrypty kompilacji.

Kryteria przejścia między etapami

Przed zwiększeniem procentu zasięgu sprawdź trzy kluczowe kryteria: częstotliwość awarii poniżej 0.5%, liczba ANR nie przekracza baseline wersji produkcyjnej, ocena aplikacji nie spadła o więcej niż 0.2 gwiazdki. Jeśli przynajmniej jedno kryterium jest naruszone — zatrzymaj Staged Rollout, przeanalizuj przyczyny i opublikuj poprawioną kompilację od minimalnego procentu.

Wycofanie i cofnięcie zmian

Wycofanie — to powrót do poprzedniej stabilnej wersji aplikacji w Google Play. Jeśli w trakcie Staged Rollout wykryto krytyczny błąd, deweloper może zatrzymać dystrybucję i przywrócić wszystkich użytkowników do poprzedniej wersji. Operacja jest wykonywana w Google Play Console bez publikowania nowej kompilacji.

Jak wykonać wycofanie

Aby wycofać, należy przejść do sekcji Release → Production i wybrać opcję Rollback to previous release. Google Play automatycznie zatrzymuje dystrybucję bieżącej wersji i przywraca użytkownikom poprzednią stabilną wersję. Wszyscy nowi użytkownicy, którzy trafili do segmentu, również przełączają się na starą wersję przy następnej aktualizacji ze sklepu.

Kiedy wycofanie jest niemożliwe

Jeśli poprzednia wersja została usunięta z Google Play lub jej termin ważności wygasł, wycofanie jest niedostępne. Zaleca się zawsze zachowywać co najmniej jedną stabilną wersję w sekcji Production. Wersję z wygasłym terminem ważności można tymczasowo przywrócić przez pomoc techniczną Google Play Console.

Automatyczne wycofanie według metryk

Google Play Console umożliwia skonfigurowanie automatycznego wycofania po przekroczeniu progowych wartości częstotliwości awarii lub ANR. W sekcji Release → Production ustaw wyzwalacze: jeśli częstotliwość awarii przekracza 1%, Google Play automatycznie zatrzymuje Staged Rollout i przywraca poprzednią wersję. To zmniejsza czas reakcji na incydent do kilku minut bez udziału dewelopera. Do konfiguracji wyzwalaczy wymagane jest konto z rolą edytora lub administratora.

Staged Rollout a pełne wydanie

Wybór między Staged Rollout a pełnym wydaniem zależy od rodzaju zmian i poziomu ryzyka. Pełne wydanie jest uzasadnione w przypadku drobnych poprawek i aktualizacji zależności bez zmiany logiki. Stopniowe wydanie jest obowiązkowe dla głównych aktualizacji, zmiany architektury i zmian dotyczących bezpieczeństwa lub danych użytkowników.

Zalecenia wyboru

W przypadku aktualizacji dotyczących ponad 20% kodu wymagany jest Staged Rollout. Zmiany UI i UX również wymagają stopniowego wdrożenia w celu oceny reakcji użytkowników. Pełne wydanie jest dopuszczalne dla poprawek tekstu, aktualizacji SDK bez zmiany API i łat bezpieczeństwa z niskim ryzykiem regresji. W razie wątpliwości zawsze wybieraj stopniowe wydanie — koszt wycofania jest znacznie niższy niż potencjalne szkody wynikające z masowej awarii wersji produkcyjnej.