Funkcje offline na platformach Apple

Aplikacje Firebase działają nawet wtedy, gdy aplikacja tymczasowo utraci połączenie z siecią. Dodatkowo Firebase udostępnia narzędzia do zachowywania danych lokalnie, zarządzania obecnością i obsługi opóźnień.

Trwałość na dysku

Aplikacje Firebase automatycznie obsługują tymczasowe przerwy w działaniu sieci. Dane w pamięci podręcznej są dostępne w trybie offline, a Firebase ponownie wysyła wszystkie zapisy, gdy połączenie z siecią zostanie przywrócone.

Gdy włączysz trwałość dysku, aplikacja zapisuje dane lokalnie na urządzeniu, dzięki czemu aplikacja może utrzymywać stan w trybie offline, nawet jeśli użytkownik lub system operacyjny ponownie uruchomi aplikację.

Trwałość dysku możesz włączyć za pomocą jednego wiersza kodu.

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

Database.database().isPersistenceEnabled = true

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

[FIRDatabase database].persistenceEnabled = YES;

Zachowanie trwałości

Po włączeniu trwałości wszystkie dane, które klient Firebase Realtime Databasezsynchronizowałby w trybie online, są przechowywane na dysku i są dostępne w trybie offline, nawet gdy użytkownik lub system operacyjny ponownie uruchomi aplikację. Oznacza to, że aplikacja działa tak samo jak w trybie online, korzystając z danych lokalnych przechowywanych w pamięci podręcznej. W przypadku lokalnych aktualizacji nadal będą wywoływane procedury obsługi wywołań.

Klient Firebase Realtime Database automatycznie przechowuje kolejkę wszystkich operacji zapisu wykonywanych, gdy aplikacja jest offline. Gdy trwałość jest włączona, kolejka jest również zapisywana na dysku, dzięki czemu wszystkie operacje zapisu są dostępne, gdy użytkownik lub system operacyjny ponownie uruchomi aplikację. Gdy aplikacja odzyska łączność, wszystkie operacje zostaną wysłane na serwer Firebase Realtime Database.

Jeśli Twoja aplikacja korzysta z usługi Uwierzytelnianie Firebase, klient Firebase Realtime Database przechowuje token uwierzytelniający użytkownika po ponownym uruchomieniu aplikacji. Jeśli token uwierzytelniania wygaśnie, gdy aplikacja jest offline, klient wstrzyma operacje zapisu do czasu ponownego uwierzytelnienia użytkownika. W przeciwnym razie operacje zapisu mogą się nie udać z powodu reguł zabezpieczeń.

Utrzymywanie aktualności danych

Firebase Realtime Database synchronizuje i przechowuje lokalną kopię danych dla aktywnych słuchaczy. Możesz też synchronizować określone lokalizacje.

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

let scoresRef = Database.database().reference(withPath: "scores")
scoresRef.keepSynced(true)

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w miejscu docelowym wycinka aplikacji.

FIRDatabaseReference *scoresRef = [[FIRDatabase database] referenceWithPath:@"scores"];
[scoresRef keepSynced:YES];

Klient Firebase Realtime Database automatycznie pobiera dane z tych lokalizacji i utrzymuje je w synchronizacji, nawet jeśli referencja nie ma aktywnych słuchaczy. Synchronizację możesz ponownie wyłączyć za pomocą tego wiersza kodu.

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

scoresRef.keepSynced(false)

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w miejscu docelowym wycinka aplikacji.

[scoresRef keepSynced:NO];

Domyślnie w pamięci podręcznej jest przechowywanych 10 MB wcześniej zsynchronizowanych danych. Powinna to być wystarczająca ilość miejsca w przypadku większości aplikacji. Jeśli rozmiar pamięci podręcznej przekroczy skonfigurowany rozmiar, Firebase Realtime Database usunie dane, które były używane najrzadziej. Dane, które są synchronizowane, nie są usuwane z pamięci podręcznej.

Wysyłanie zapytań do danych offline

Firebase Realtime Database przechowuje dane zwrócone z zapytania do użytku w trybie offline. W przypadku zapytań utworzonych w trybie offline funkcja Firebase Realtime Database nadal działa w przypadku wcześniej załadowanych danych. Jeśli żądane dane nie zostały załadowane, Firebase Realtime Database wczyta dane z lokalnej pamięci podręcznej. Gdy połączenie sieciowe będzie ponownie dostępne, dane wczytają się i będą odzwierciedlały zapytanie.

Na przykład ten kod wysyła zapytania dotyczące ostatnich 4 elementów w kolumnie Firebase Realtime Database wyników

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

let scoresRef = Database.database().reference(withPath: "scores")
scoresRef.queryOrderedByValue().queryLimited(toLast: 4).observe(.childAdded) { snapshot in
  print("The \(snapshot.key) dinosaur's score is \(snapshot.value ?? "null")")
}

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

FIRDatabaseReference *scoresRef = [[FIRDatabase database] referenceWithPath:@"scores"];
[[[scoresRef queryOrderedByValue] queryLimitedToLast:4]
    observeEventType:FIRDataEventTypeChildAdded withBlock:^(FIRDataSnapshot *snapshot) {
      NSLog(@"The %@ dinosaur's score is %@", snapshot.key, snapshot.value);
    }];

Załóżmy, że użytkownik traci połączenie, przechodzi w tryb offline i ponownie uruchamia aplikację. W trybie offline aplikacja wysyła zapytanie o 2 ostatnie elementy z tego samego miejsca. To zapytanie zwróci 2 ostatnie pozycje, ponieważ aplikacja wczytała wszystkie 4 pozycje z zapytania powyżej.

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

scoresRef.queryOrderedByValue().queryLimited(toLast: 2).observe(.childAdded) { snapshot in
  print("The \(snapshot.key) dinosaur's score is \(snapshot.value ?? "null")")
}

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

[[[scoresRef queryOrderedByValue] queryLimitedToLast:2]
    observeEventType:FIRDataEventTypeChildAdded withBlock:^(FIRDataSnapshot *snapshot) {
      NSLog(@"The %@ dinosaur's score is %@", snapshot.key, snapshot.value);
    }];

W poprzednim przykładzie klient Firebase Realtime Database zgłasza zdarzenia „dodane przez dziecko” w przypadku 2 najlepszych wyników w przypadku 2 dinozaurów, korzystając z stałej pamięci podręcznej. Nie spowoduje to jednak wywołania zdarzenia „value”, ponieważ aplikacja nigdy nie wykonała tego zapytania w trybie online.

Jeśli aplikacja poprosi o ostatnie 6 elementów w trybie offline, otrzyma od razu zdarzenia „dodanie dziecka” do tych 4 elementów w pamięci podręcznej. Gdy urządzenie znów będzie online, klient Firebase Realtime Database zsynchronizuje się z serwerem i pobierze 2 ostatnie zdarzenia „dodanie elementu podrzędnego” i „wartość” dla aplikacji.

Obsługa transakcji offline

Wszystkie transakcje przeprowadzane, gdy aplikacja jest offline, są umieszczane w kolejce. Gdy aplikacja ponownie nawiąże połączenie z internetem, transakcje zostaną wysłane do serwera Realtime Database.

Transakcje nie są zachowywane po ponownym uruchomieniu aplikacji

Nawet przy włączonej trwałości transakcje nie są zachowywane po ponownym uruchamianiu aplikacji. Dlatego nie możesz polegać na tym, że transakcje dokonane offline są zaangażowane w Firebase Realtime Database. Aby zapewnić użytkownikom jak najlepsze wrażenia, aplikacja powinna informować, że transakcja nie została jeszcze zapisana w Firebase Realtime Database, lub powinna samodzielnie zapamiętywać transakcje i wykonywać je ponownie po ponownym uruchomieniu aplikacji.

Firebase Realtime Database ma wiele funkcji do obsługi scenariuszy offline i połączeń z siecią. Pozostała część tego przewodnika dotyczy Twojej aplikacji niezależnie od tego, czy masz włączoną trwałość.

Zarządzanie obecnością

W aplikacjach działających w czasie rzeczywistym często przydaje się możliwość wykrywania, kiedy klienty łączą się i rozłączają. Możesz na przykład oznaczyć użytkownika jako „offline”, gdy jego klient się rozłączy.

Klienci bazy danych Firebase udostępniają proste prymitywy, których można używać do zapisywania danych w bazie danych, gdy klient rozłączy się z serwerami bazy danych Firebase. Te aktualizacje mają miejsce niezależnie od tego, czy klient odłączy się prawidłowo, czy nie. Dzięki temu możesz polegać na tym, że dane zostaną oczyszczone nawet wtedy, gdy połączenie zostanie utracone lub klient ulegnie awarii. Wszystkie operacje zapisu, w tym ustawianie, aktualizowanie i usuwanie, mogą być wykonywane po odłączeniu.

Oto prosty przykład zapisywania danych po rozłączeniu za pomocą prymitywu onDisconnect:

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

let presenceRef = Database.database().reference(withPath: "disconnectmessage");
// Write a string when this client loses connection
presenceRef.onDisconnectSetValue("I disconnected!")

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

FIRDatabaseReference *presenceRef = [[FIRDatabase database] referenceWithPath:@"disconnectmessage"];
// Write a string when this client loses connection
[presenceRef onDisconnectSetValue:@"I disconnected!"];

Jak działa onDisconnect

Gdy utworzysz operację onDisconnect(), będzie ona działać na serwerze Firebase Realtime Database. Serwer sprawdza zabezpieczenia, aby upewnić się, że użytkownik może wykonać żądane zdarzenie zapisu, i informuje aplikację, jeśli jest ono nieprawidłowe. Następnie serwer monitoruje połączenie. Jeśli w jakimś momencie połączenie zostanie przerwane lub klient Realtime Database zamknie je aktywnie, serwer sprawdza zabezpieczenia po raz drugi (aby upewnić się, że operacja jest nadal ważna), a następnie wywołuje zdarzenie.

Aplikacja może użyć wywołania zwrotnego operacji zapisu, aby upewnić się, że onDisconnect został prawidłowo dołączony:

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

presenceRef.onDisconnectRemoveValue { error, reference in
  if let error = error {
    print("Could not establish onDisconnect event: \(error)")
  }
}

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w miejscu docelowym wycinka aplikacji.

[presenceRef onDisconnectRemoveValueWithCompletionBlock:^(NSError *error, FIRDatabaseReference *reference) {
  if (error != nil) {
    NSLog(@"Could not establish onDisconnect event: %@", error);
  }
}];

Wydarzenie onDisconnect można też anulować, dzwoniąc pod numer .cancel():

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

presenceRef.onDisconnectSetValue("I disconnected")
// some time later when we change our minds
presenceRef.cancelDisconnectOperations()

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w miejscu docelowym wycinka aplikacji.

[presenceRef onDisconnectSetValue:@"I disconnected"];
// some time later when we change our minds
[presenceRef cancelDisconnectOperations];

Wykrywanie stanu połączenia

W przypadku wielu funkcji związanych z obecnością przydatne jest, aby aplikacja wiedziała, kiedy jest online, a kiedy offline. Firebase Realtime Database udostępnia specjalną lokalizację pod adresem /.info/connected, która jest aktualizowana za każdym razem, gdy zmienia się stan połączenia klienta Firebase Realtime Database. Oto przykład:

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

let connectedRef = Database.database().reference(withPath: ".info/connected")
connectedRef.observe(.value, with: { snapshot in
  if snapshot.value as? Bool ?? false {
    print("Connected")
  } else {
    print("Not connected")
  }
})

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

FIRDatabaseReference *connectedRef = [[FIRDatabase database] referenceWithPath:@".info/connected"];
[connectedRef observeEventType:FIRDataEventTypeValue withBlock:^(FIRDataSnapshot *snapshot) {
  if([snapshot.value boolValue]) {
    NSLog(@"connected");
  } else {
    NSLog(@"not connected");
  }
}];

/.info/connected to wartość logiczna, która nie jest synchronizowana między klientami Realtime Database, ponieważ zależy od stanu klienta. Innymi słowy, jeśli jeden klient odczytuje wartość /.info/connected jako fałsz, nie ma gwarancji, że inny klient również odczyta wartość jako fałsz.

Czas obsługi

Sygnatury czasowe serwera

Serwery Firebase Realtime Database udostępniają mechanizm wstawiania sygnatur czasowych wygenerowanych na serwerze jako danych. Ta funkcja w połączeniu z funkcją onDisconnect umożliwia łatwe i niezawodne zapisywanie informacji o czasie odłączenia klienta Realtime Database:

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

let userLastOnlineRef = Database.database().reference(withPath: "users/morgan/lastOnline")
userLastOnlineRef.onDisconnectSetValue(ServerValue.timestamp())

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w miejscu docelowym wycinka aplikacji.

FIRDatabaseReference *userLastOnlineRef = [[FIRDatabase database] referenceWithPath:@"users/morgan/lastOnline"];
[userLastOnlineRef onDisconnectSetValue:[FIRServerValue timestamp]];

Zniekształcenie zegara

Funkcja firebase.database.ServerValue.TIMESTAMP jest znacznie dokładniejsza i preferowana w przypadku większości operacji odczytu/zapisu, ale czasami może być przydatna do oszacowania odchylenia zegara klienta względem serwerów Firebase Realtime Database. Do lokalizacji /.info/serverTimeOffset możesz dołączyć funkcję wywołania zwrotnego, aby uzyskać wartość w milisekundach, którą klienci Firebase Realtime Database dodają do lokalnego czasu zgłoszonego (czas epoki w milisekundach), aby oszacować czas serwera. Pamiętaj, że dokładność tego przesunięcia może być zależna od opóźnienia w sieci, dlatego jest przydatna głównie do wykrywania dużych (> 1 sekunda) rozbieżności w czasie zegara.

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

let offsetRef = Database.database().reference(withPath: ".info/serverTimeOffset")
offsetRef.observe(.value, with: { snapshot in
  if let offset = snapshot.value as? TimeInterval {
    print("Estimated server time in milliseconds: \(Date().timeIntervalSince1970 * 1000 + offset)")
  }
})

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

FIRDatabaseReference *offsetRef = [[FIRDatabase database] referenceWithPath:@".info/serverTimeOffset"];
[offsetRef observeEventType:FIRDataEventTypeValue withBlock:^(FIRDataSnapshot *snapshot) {
  NSTimeInterval offset = [(NSNumber *)snapshot.value doubleValue];
  NSTimeInterval estimatedServerTimeMs = [[NSDate date] timeIntervalSince1970] * 1000.0 + offset;
  NSLog(@"Estimated server time: %0.3f", estimatedServerTimeMs);
}];

Przykładowa aplikacja do obsługi stanu obecności

Łącząc operacje rozłączania z monitorowaniem stanu połączenia i datą i godzinę serwera, możesz tworzyć systemy obecności użytkowników. W tym systemie każdy użytkownik przechowuje dane w lokalizacji bazy danych, aby wskazać, czy klient Realtime Database jest online. Klienci ustawiają tę lokalizację na „Prawda” (true) po połączeniu z internetem i dodają sygnaturę czasową po rozłączeniu. Ta sygnatura czasowa wskazuje, kiedy dany użytkownik był ostatnio online.

Pamiętaj, że aplikacja powinna kolejkować operacje odłączania, zanim użytkownik zostanie oznaczony jako online. Pozwoli to uniknąć wyścigów w przypadku utraty połączenia sieciowego klienta przed wysłaniem obu poleceń na serwer.

Oto prosty system wykrywania obecności użytkownika:

Swift

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

// since I can connect from multiple devices, we store each connection instance separately
// any time that connectionsRef's value is null (i.e. has no children) I am offline
let myConnectionsRef = Database.database().reference(withPath: "users/morgan/connections")

// stores the timestamp of my last disconnect (the last time I was seen online)
let lastOnlineRef = Database.database().reference(withPath: "users/morgan/lastOnline")

let connectedRef = Database.database().reference(withPath: ".info/connected")

connectedRef.observe(.value, with: { snapshot in
  // only handle connection established (or I've reconnected after a loss of connection)
  guard snapshot.value as? Bool ?? false else { return }

  // add this device to my connections list
  let con = myConnectionsRef.childByAutoId()

  // when this device disconnects, remove it.
  con.onDisconnectRemoveValue()

  // The onDisconnect() call is before the call to set() itself. This is to avoid a race condition
  // where you set the user's presence to true and the client disconnects before the
  // onDisconnect() operation takes effect, leaving a ghost user.

  // this value could contain info about the device or a timestamp instead of just true
  con.setValue(true)

  // when I disconnect, update the last time I was seen online
  lastOnlineRef.onDisconnectSetValue(ServerValue.timestamp())
})

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip.

// since I can connect from multiple devices, we store each connection instance separately
// any time that connectionsRef's value is null (i.e. has no children) I am offline
FIRDatabaseReference *myConnectionsRef = [[FIRDatabase database] referenceWithPath:@"users/morgan/connections"];

// stores the timestamp of my last disconnect (the last time I was seen online)
FIRDatabaseReference *lastOnlineRef = [[FIRDatabase database] referenceWithPath:@"users/morgan/lastOnline"];

FIRDatabaseReference *connectedRef = [[FIRDatabase database] referenceWithPath:@".info/connected"];
[connectedRef observeEventType:FIRDataEventTypeValue withBlock:^(FIRDataSnapshot *snapshot) {
  if([snapshot.value boolValue]) {
    // connection established (or I've reconnected after a loss of connection)

    // add this device to my connections list
    FIRDatabaseReference *con = [myConnectionsRef childByAutoId];

    // when this device disconnects, remove it
    [con onDisconnectRemoveValue];

    // The onDisconnect() call is before the call to set() itself. This is to avoid a race condition
    // where you set the user's presence to true and the client disconnects before the
    // onDisconnect() operation takes effect, leaving a ghost user.

    // this value could contain info about the device or a timestamp instead of just true
    [con setValue:@YES];


    // when I disconnect, update the last time I was seen online
    [lastOnlineRef onDisconnectSetValue:[FIRServerValue timestamp]];
  }
}];