Tryb offline w istniejącej aplikacji mobilnej — jak go dodać bez przepisywania całej aplikacji

Offline to nie jedna funkcja, tylko cztery poziomy o różnym koszcie: od czytelnej obsługi braku sieci, przez odczyt i zapis offline z kolejką, po pełną synchronizację. Jak dodać je do działającej aplikacji, co zmienić na backendzie i ile to kosztuje.

Zespół Mobilesoft· Engineering team· 19 listopada 2026· 7 min czytania

„Aplikacja nie działa w magazynie”, „w windzie wszystko znika”, „zamówienie wysłało się dwa razy”. Takie zgłoszenia zwykle oznaczają, że aplikacja zakłada stały dostęp do internetu — a użytkownicy go nie mają. Firma pyta wtedy o tryb offline i często słyszy, że trzeba przepisać aplikację od zera.

Czasem to prawda, ale zwykle nie. Offline to nie jedna funkcja, tylko kilka poziomów o bardzo różnym koszcie. W tym tekście opisujemy, jak dodać pracę bez sieci do aplikacji, która już działa, krok po kroku — zaczynając od zmian, które poprawiają doświadczenie użytkownika w kilka dni, a kończąc na pełnej synchronizacji.

Cztery poziomy trybu offline

Poziom Co widzi użytkownik bez sieci Złożoność 1. Łagodna obsługa braku sieci Czytelny komunikat zamiast pustego ekranu lub błędu, automatyczne ponowienie po powrocie połączenia Niska 2. Odczyt offline Ostatnio pobrane dane: lista zleceń, katalog produktów, historia Średnia 3. Zapis offline z kolejką Może tworzyć i edytować dane, które wyślą się po odzyskaniu połączenia Wysoka 4. Pełna synchronizacja Dane zmieniane jednocześnie na kilku urządzeniach i w panelu, z rozwiązywaniem konfliktów Bardzo wysoka

Większość aplikacji potrzebuje poziomu 1 i 2, część — poziomu 3 dla jednego czy dwóch kluczowych procesów. Poziom 4 jest uzasadniony w aplikacjach terenowych, takich jak aplikacje dla transportu i logistyki, gdzie praca bez zasięgu jest normą.

Zanim zdecydujesz, sprawdź w danych, gdzie i jak często użytkownicy tracą połączenie. Błędy sieci w raportach awarii, nieudane żądania w logach backendu i zgłoszenia od klientów zwykle wystarczą, żeby wskazać dwa–trzy ekrany, od których warto zacząć.

Poziom 1: aplikacja, która nie panikuje bez sieci

To najtańszy krok i często daje największą poprawę w ocenach. W starszych aplikacjach, które przejmujemy, brak sieci zwykle kończy się jednym z trzech scenariuszy: nieskończonym kręcącym się kółkiem, pustą listą bez wyjaśnienia albo awarią aplikacji.

Co obejmuje ten poziom:

  • wykrywanie stanu połączenia i komunikat „Brak połączenia” zamiast ogólnego błędu,
  • rozsądne limity czasu żądań — słaba sieć jest gorsza niż jej brak, bo żądanie wisi bez końca,
  • automatyczne ponowienie po powrocie połączenia, z opóźnieniem rosnącym przy kolejnych próbach,
  • blokada podwójnego wysłania formularza, gdy użytkownik stuka przycisk kilka razy.

Ten poziom nie wymaga zmian w architekturze. To zwykle kilka dni pracy, a przy okazji poprawia też odczuwalną szybkość aplikacji — o tym, co jeszcze na nią wpływa, piszemy w tekście o tym, dlaczego aplikacja działa wolno.

Poziom 2: odczyt offline

Tu pojawia się lokalne przechowywanie danych. Aplikacja zapisuje pobrane dane w bazie na urządzeniu i najpierw pokazuje je z niej, a w tle odświeża z serwera.

Platforma Typowe rozwiązania Android Room (SQLite) iOS SwiftData, Core Data, SQLite Flutter drift, sqflite React Native SQLite (np. op-sqlite), WatermelonDB Firebase Firestore ma wbudowaną pamięć offline na Androidzie i iOS

Najważniejsze decyzje na tym poziomie nie są techniczne, tylko produktowe:

  • Które dane trzymać lokalnie — nie cały katalog z 50 tys. produktów, tylko to, czego użytkownik potrzebuje w terenie.
  • Jak długo dane są ważne — cena sprzed tygodnia może wprowadzić klienta w błąd. Pokazuj datę ostatniej aktualizacji.
  • Co z danymi wrażliwymi — dane osobowe i medyczne w lokalnej bazie powinny być szyfrowane i usuwane przy wylogowaniu. Więcej o tym w artykule o bezpieczeństwie aplikacji mobilnej.

W istniejącej aplikacji kluczowe jest to, jak zorganizowano dostęp do danych. Jeśli ekrany wywołują API bezpośrednio, trzeba najpierw wprowadzić warstwę pośrednią (repozytorium), która decyduje, czy dane pochodzą z serwera, czy z bazy lokalnej. To refaktoryzacja, ale da się ją robić ekran po ekranie, bez przepisywania całości — podobnie jak przy innych zmianach opisanych w tekście o rozbudowie istniejącej aplikacji.

Poziom 3: zapis offline i kolejka operacji

Użytkownik wypełnia formularz, robi zdjęcie, zatwierdza zlecenie — bez sieci. Aplikacja zapisuje operację w lokalnej kolejce i wysyła ją, gdy połączenie wróci. Brzmi prosto, ale tu pojawia się większość trudnych błędów.

Na co trzeba zwrócić uwagę:

  • Idempotencja. Jeśli żądanie dotarło do serwera, ale odpowiedź się zgubiła, aplikacja wyśle je ponownie. Bez unikalnego klucza operacji, który backend rozpoznaje jako duplikat, powstaną dwa zamówienia. To najczęstsza przyczyna zgłoszeń „wysłało się dwa razy”.
  • Kolejność. Edycja zamówienia nie może dotrzeć przed jego utworzeniem. Kolejka musi zachowywać kolejność operacji zależnych od siebie.
  • Czas zdarzenia. Zapisuj moment wykonania czynności na urządzeniu, a nie moment wysłania — inaczej podpis klienta z godziny 9:00 trafi do systemu jako złożony o 15:00.
  • Błędy po stronie serwera. Co, jeśli operacja zapisana offline zostanie odrzucona, bo w międzyczasie zmieniła się cena albo zlecenie zostało anulowane? Użytkownik musi się o tym dowiedzieć i wiedzieć, co zrobić.
  • Wysyłanie w tle. Na Androidzie służy do tego WorkManager. Na iOS system sam decyduje, kiedy i czy uruchomi zadanie w tle (BGTaskScheduler), więc nie można zakładać, że dane wyślą się, zanim użytkownik ponownie otworzy aplikację.
  • Duże pliki. Zdjęcia i dokumenty wysyłaj osobno, z możliwością wznowienia, a nie w jednym żądaniu z resztą danych.

Poziom 4: synchronizacja i konflikty

Gdy te same dane mogą być zmieniane w kilku miejscach jednocześnie — przez dwóch pracowników offline albo przez pracownika i biuro — potrzebna jest strategia rozwiązywania konfliktów:

Strategia Jak działa Kiedy wystarcza Wygrywa serwer Zmiana z urządzenia jest odrzucana, jeśli rekord zmienił się w międzyczasie Dane zarządzane głównie z biura Wygrywa ostatni zapis Obowiązuje zmiana z najpóźniejszym znacznikiem czasu Proste dane, rzadkie konflikty Scalanie na poziomie pól Zmiany różnych pól tego samego rekordu są łączone Formularze edytowane przez kilka osób Decyzja użytkownika Aplikacja pokazuje obie wersje Dane, w których pomyłka kosztuje

Na tym poziomie warto rozważyć gotowe silniki synchronizacji zamiast pisania własnego. Przy wyborze patrz jednak na stabilność dostawcy: MongoDB wycofało Atlas Device Sync (synchronizację dla bazy Realm) — usługa została wyłączona 30 września 2025 r., a aplikacje oparte na niej musiały pilnie migrować. O tym, jak takie decyzje dostawców wpływają na aplikacje, piszemy w artykule o wycofanych SDK i API.

Co musi się zmienić na backendzie

Offline to nie tylko praca po stronie aplikacji. Od poziomu 2 wzwyż backend zwykle wymaga zmian:

  • pobieranie zmian od określonego momentu zamiast pełnej listy przy każdym odświeżeniu,
  • znaczniki wersji lub daty modyfikacji w rekordach, żeby wykrywać konflikty,
  • „miękkie” usuwanie — aplikacja musi się dowiedzieć, że rekord został usunięty, więc nie może on po prostu zniknąć z bazy,
  • obsługa kluczy idempotencji dla operacji z kolejki.

Te zmiany trzeba wprowadzać tak, żeby nie zepsuć starszych wersji aplikacji, które z nich nie korzystają — zasady opisaliśmy w tekście o zmianach w API a starych wersjach aplikacji.

Jak testować tryb offline

Testy w biurze z dobrym Wi-Fi nie wykryją problemów z offline. Potrzebne są:

  • scenariusze z utratą połączenia w trakcie operacji, a nie tylko przed nią,
  • symulacja słabej sieci — Network Link Conditioner na iOS, ograniczanie przepustowości w emulatorze Androida,
  • testy synchronizacji — dwa urządzenia zmieniające ten sam rekord offline,
  • test w prawdziwych warunkach — hala, piwnica, trasa poza miastem, jeśli tam pracują użytkownicy.

Ile to kosztuje

Poziom Orientacyjny nakład Przy stawce 180 zł netto/h 1. Łagodna obsługa braku sieci 16–40 h ok. 2,9–7,2 tys. zł 2. Odczyt offline dla kluczowych ekranów 40–120 h ok. 7,2–21,6 tys. zł 3. Zapis offline dla 1–2 procesów 80–200 h ok. 14,4–36 tys. zł 4. Pełna synchronizacja z konfliktami od 200 h od ok. 36 tys. zł

Kwoty obejmują pracę po stronie aplikacji i backendu i rosną, jeśli architektura aplikacji wymaga najpierw refaktoryzacji warstwy danych. Stawka i zakres są orientacyjne — rzeczywisty koszt zależy od liczby ekranów i stanu kodu.

Podsumowanie

Trybu offline nie trzeba wprowadzać w całości ani od razu. Zacznij od poziomu 1 — czytelnej obsługi braku sieci, który kosztuje kilka dni i usuwa większość frustracji. Potem dodaj odczyt offline dla ekranów, których użytkownicy potrzebują w terenie, a zapis z kolejką tylko tam, gdzie praca bez sieci jest codziennością. Pełną synchronizację zostaw na sytuacje, w których naprawdę jest potrzebna.

Dodajemy tryb offline do istniejących aplikacji w ramach utrzymania aplikacji mobilnych, a zmiany po stronie serwera realizujemy w ramach usługi backend i API. Jeśli chcesz wiedzieć, w jakim stanie jest Twoja aplikacja i od czego zacząć, zamów bezpłatną analizę aplikacji albo skontaktuj się z nami.