Snapshot (Fastlane) — istota, generowanie zrzutów ekranu i konfiguracja w aplikacjach mobilnych

Czym jest Snapshot (Fastlane)?

Snapshot (Fastlane) to komponent ekosystemu Fastlane, który automatyzuje tworzenie zrzutów ekranu aplikacji dla App Store. Uruchamia testy UI na symulatorach iOS, wykonuje zrzuty ekranu w określonych stanach aplikacji i zapisuje je w strukturyzowanym katalogu z poprawnymi nazwami dla każdego języka i urządzenia.

Bez Snapshota programiści ręcznie uruchamiają symulator, otwierają każdy ekran, robią zrzut ekranu przez Cmd+S, przełączają język i powtarzają proces dla wszystkich kombinacji. Automatyzacja zrzutów ekranu to kluczowy element optymalizacji ASO, ponieważ App Store wymaga aktualnych zrzutów dla każdego nowego wydania, a ręczna aktualizacja 60+ zrzutów ekranu zajmuje godziny pracy.

Według App Store Connect Documentation (2025), aplikacje z zlokalizowanymi zrzutami ekranu uzyskują o 25% więcej konwersji w docelowych krajach. Snapshot pozwala zespołom aktualizować treść wizualną dla 32 języków podczas jednego uruchomienia, co jest szczególnie ważne dla kampanii marketingowych związanych z nowymi funkcjami aplikacji.

Używaj Snapshota w każdym projekcie publikowanym w App Store — to standardowe narzędzie dla zespołów dążących do automatyzacji procesu wydawniczego i poprawy ASO.

Jak Snapshot generuje zrzuty ekranu

Proces generowania zrzutów ekranu w Snapshot składa się z kilku etapów: przygotowanie testów UI, konfiguracja Snapfile, uruchomienie symulatorów i zbieranie wyników. Snapshot sekwencyjnie uruchamia każdy symulator dla określonych urządzeń i języków, wykonuje testy UI i robi zrzuty w punktach wywołania funkcji snapshot().

Po zakończeniu wszystkich testów Snapshot zbiera zrzuty ekranu do katalogu screenshots/[Language]/ z nazwami odpowiadającymi wymaganiom App Store. Każdy zrzut ekranu jest zapisywany w formacie PNG z rozdzielczością odpowiadającą docelowemu urządzeniu. Snapshot generuje również raport HTML do wizualnej weryfikacji wszystkich utworzonych zrzutów.

Konfiguracja testów UI dla Snapshota

Do pracy Snapshota należy dodać wywołania snapshot() w kodzie XCTest testów UI aplikacji. Funkcja wykonuje zrzut ekranu bieżącego stanu ekranu w momencie wywołania. Programista umieszcza snapshot() po każdej kluczowej akcji: otwarciu ekranu, wprowadzeniu danych, nawigacji po zakładkach lub wyświetleniu wyników.

Przykład struktury testu UI: test loguje się do aplikacji, wywołuje snapshot("01-LoginScreen") dla zrzutu ekranu logowania, następnie przechodzi do ekranu głównego i wywołuje snapshot("02-HomeScreen") dla zrzutu ekranu głównego. XCTest to framework Apple do testów jednostkowych i UI aplikacji iOS, zintegrowany bezpośrednio z Xcode.

// Test UI dla Snapshota
- (void)testScreenshots {
    XCUIApplication *app = [[XCUIApplication alloc] init];
    [app launch];
    
    snapshot(@"01-LoginScreen");
    
    [app.textFields[@"email"] tap];
    [app.textFields[@"email"] typeText:@"user@company.com"];
    [app.buttons[@"Login"] tap];
    
    snapshot(@"02-HomeScreen");
}

Praca z językami i urządzeniami

Snapshot automatycznie przełącza język symulatora dla każdego języka określonego w Snapfile. Aplikacja uruchamia się z odpowiednią lokalizacją, a testy UI są wykonywane w tym języku. Lokalizacja zrzutów ekranu to krytyczny czynnik ASO: użytkownicy w 75% przypadków preferują aplikacje z treścią w języku ojczystym, w tym zrzuty ekranu w App Store.

Dla każdego urządzenia Snapshot uruchamia osobny symulator z odpowiednią przekątną ekranu. Obsługiwane są wszystkie rozmiary wymagane przez App Store: iPhone 6.5 cala (iPhone 15 Pro Max), 5.5 cala (iPhone 8 Plus), 6.7 cala (iPhone 15 Plus) i iPad 12.9 cala. Symulator iOS to programowa emulacja urządzenia iOS wbudowana w Xcode do testowania aplikacji bez fizycznego urządzenia.

# Generowanie zrzutów ekranu dla wszystkich urządzeń i języków
fastlane snapshot

# Generowanie tylko dla określonych urządzeń
fastlane snapshot --devices "iPhone 15 Pro Max,iPhone 15"

# Czyszczenie przed generowaniem zrzutów ekranu
fastlane snapshot --reinstall_app --erase_simulator

Konfiguracja Snapshot przez Snapfile

Snapfile to plik konfiguracyjny Fastlane, który określa parametry generowania zrzutów ekranu: listę urządzeń, języki, czas oczekiwania i opcje uruchamiania. Snapfile jest przechowywany w katalogu fastlane i wersjonowany razem z projektem, co gwarantuje jednolitą konfigurację dla wszystkich członków zespołu.

# Snapfile — konfiguracja zrzutów ekranu
devices([
    "iPhone 15 Pro Max",
    "iPhone 15",
    "iPad Pro (12.9-inch)"
])

languages([
    "en-US",
    "ru",
    "de-DE"
])

scheme("MyAppUITests")
output_directory("./screenshots")
clear_previous_screenshots(true)
reinstall_app(true)
erase_simulator(true)

Parametr clear_previous_screenshots usuwa stare zrzuty ekranu przed rozpoczęciem generowania — zapobiega to gromadzeniu się nieaktualnych zrzutów w katalogu wyjściowym. reinstall_app ponownie instaluje aplikację na symulatorze przed każdym uruchomieniem, co gwarantuje czystą sesję bez wpływu poprzednich testów na nowe generowanie.

Parametr erase_simulator czyści zawartość symulatora przed rozpoczęciem testów — w tym pamięć podręczną, ustawienia i dane poprzednich sesji. Jest to szczególnie ważne dla testów sprawdzających onboardingu lub pierwsze uruchomienie aplikacji. Snapshot obsługuje również parametry ios_version do określenia wersji iOS na symulatorze oraz stop_after_first_error do zatrzymania generowania przy pierwszym błędzie testu UI.

Dla projektów z SwiftUI dostępny jest parametr use_simulator_for_language, który zarządza przełączaniem języka przez ustawienia symulatora zamiast zmiany regionu systemu. Snapshot obsługuje również launch_arguments do przekazywania dodatkowych argumentów przy uruchamianiu aplikacji — przydatne do testów z różnymi konfiguracjami backendu lub testami A/B.

Polecenia Snapshot do generowania zrzutów

Interfejs Snapshota zawiera podstawowe polecenia do uruchamiania generowania oraz rozszerzone flagi do precyzyjnej kontroli nad procesem. Główne polecenie fastlane snapshot uruchamia pełny cykl generowania zrzutów ekranu na podstawie konfiguracji z Snapfile.

Szybkie generowanie i filtrowanie

Polecenie fastlane snapshot --devices "iPhone 15" generuje zrzuty ekranu tylko dla określonych urządzeń, ignorując pozostałe z Snapfile. --languages "en-US,ru" filtruje języki do generowania. Kombinacja tych flag jest przydatna do szybkiego sprawdzania zrzutów ekranu na jednym urządzeniu i języku bez pełnego cyklu generowania, który może zajmować do 30 minut przy 5 urządzeniach i 10 językach.

# Szybkie generowanie dla jednego urządzenia
fastlane snapshot --devices "iPhone 15" --languages "en-US"

# Generowanie z ponowną instalacją aplikacji
fastlane snapshot --reinstall_app --erase_simulator

# Generowanie z raportem HTML
fastlane snapshot --output_directory "./build/screenshots"

Flaga --output_directory zmienia katalog zapisywania wyników. Domyślnie Snapshot zapisuje zrzuty ekranu w fastlane/screenshots. Do integracji z Deliver należy wskazać katalog zgodny z oczekiwaną strukturą Deliverfile — umożliwia to przekazywanie zrzutów ekranu bezpośrednio do procesu publikacji bez ręcznego kopiowania plików między folderami.

Integracja Snapshot w pipeline CI/CD

Snapshot w CI/CD to automatyczne generowanie zrzutów ekranu przy każdym commicie wydaniowym. Snapshot jest uruchamiany przed etapem Deliver, aby zagwarantować, że zrzuty ekranu w App Store odpowiadają bieżącej wersji aplikacji i nie zawierają nieaktualnych elementów interfejsu z poprzednich wersji.

Do pracy Snapshota w CI wymagane jest Xcode z zainstalowanymi symulatorami iOS. W środowisku CI Snapshot korzysta z symulatorów z Xcode, które są wstępnie ładowane na runner. GitHub Actions udostępnia obrazy z preinstalowanym Xcode i symulatorami iOS do uruchamiania testów UI bez dodatkowej konfiguracji.

# Uruchamianie Snapshota w środowisku CI
fastlane snapshot --skip_open_summary \

      --output_directory "$CI_PROJECT_DIR/screenshots"

# Zapisywanie zrzutów ekranu jako artefaktów CI
cp -R "screenshots/" "$CI_PROJECT_DIR/artifacts/"

Parametr --skip_open_summary wyłącza otwieranie raportu HTML po generowaniu — w środowisku CI interfejs graficzny jest niedostępny. Wyniki generowania są zapisywane w katalogu, który jest przekazywany jako artefakt zadania CI, a następnie używany przez Deliver do przesłania do App Store wraz z wydaniem.

Aby przyspieszyć pipeline CI, używaj równoległego generowania zrzutów ekranu przez concurrent_simulators — parametr Snapfile, który uruchamia kilka symulatorów jednocześnie. Skraca to czas generowania zrzutów ekranu na 5 urządzeń i 10 języków z 40 minut do 15 minut przy użyciu 4 równoległych wątków.

Typowe błędy podczas pracy ze Snapshot

Podczas korzystania ze Snapshota programiści najczęściej spotykają się z błędami związanymi z niestabilnością testów UI, problemami symulatorów i nieprawidłową konfiguracją urządzeń. Diagnostyka błędów Snapshota rozpoczyna się od analizy raportu HTML, który zawiera zrzuty ekranu każdego kroku i informacje o nieudanych testach.

Błąd «Failed to build scheme MyAppUITests» występuje, gdy schemat testów UI nie jest skonfigurowany do budowania. Rozwiązanie: upewnij się, że w Xcode utworzono osobny Scheme dla testów UI i włączono opcję Shared dla dostępu z wiersza poleceń. Xcode Scheme to konfiguracja budowania, testowania i uruchamiania aplikacji, która określa zestaw celów i parametrów dla każdego działania.

Błąd «No simulators found matching...» wskazuje na brak symulatora z określonym typem urządzenia lub wersją iOS. Rozwiązanie: wykonaj xcrun simctl create, aby utworzyć symulator, lub wskaż istniejące urządzenie z listy xcrun simctl list. xcrun simctl to narzędzie wiersza poleceń Xcode do zarządzania symulatorami iOS: tworzenia, usuwania, uruchamiania i diagnostyki.

Przy błędzie «UI test failure» test UI nie przechodzi na jednym z języków lub urządzeń. Rozwiązanie: uruchom Snapshot z flagą --stop_after_first_error, aby zatrzymać się przy pierwszym błędzie, przeanalizuj zrzut ekranu w raporcie HTML i popraw test. Częstą przyczyną jest różna długość tekstu w różnych językach, przez którą elementy interfejsu nakładają się lub wychodzą poza granice ekranu.