Możliwości offline na platformach Apple

Aplikacje Firebase działają nawet wtedy, gdy Twoja aplikacja chwilowo traci połączenie sieciowe. Ponadto Firebase zapewnia narzędzia do lokalnego utrwalania danych, zarządzania obecnością i obsługi opóźnień.

Trwałość dysku

Aplikacje Firebase automatycznie obsługują tymczasowe przerwy w działaniu sieci. Dane z pamięci podręcznej są dostępne w trybie offline, a Firebase ponownie wysyła wszelkie zapisy po przywróceniu łączności sieciowej.

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

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

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
Database.database().isPersistenceEnabled = true

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
[FIRDatabase database].persistenceEnabled = YES;

Zachowanie trwałości

Włączając trwałość, wszelkie dane, które klient Bazy danych czasu rzeczywistego Firebase zsynchronizowałby w trybie online, pozostają na dysku i są dostępne w trybie offline, nawet po ponownym uruchomieniu aplikacji przez użytkownika lub system operacyjny. Oznacza to, że Twoja aplikacja działa tak, jak w trybie online, korzystając z lokalnych danych przechowywanych w pamięci podręcznej. Wywołania zwrotne odbiornika będą nadal uruchamiane w celu uzyskania lokalnych aktualizacji.

Klient bazy danych czasu rzeczywistego Firebase automatycznie tworzy kolejkę wszystkich operacji zapisu, które są wykonywane, gdy aplikacja jest offline. Po włączeniu trwałości ta kolejka jest również utrwalana na dysku, dzięki czemu wszystkie zapisy są dostępne, gdy użytkownik lub system operacyjny ponownie uruchomi aplikację. Gdy aplikacja odzyska łączność, wszystkie operacje są wysyłane do serwera Bazy danych czasu rzeczywistego Firebase.

Jeśli Twoja aplikacja korzysta z uwierzytelniania Firebase , klient Bazy danych czasu rzeczywistego Firebase zachowuje token uwierzytelniania użytkownika podczas ponownego uruchamiania aplikacji. Jeśli token uwierzytelniania wygaśnie, gdy aplikacja jest w trybie offline, klient wstrzymuje operacje zapisu do czasu ponownego uwierzytelnienia użytkownika przez aplikację. W przeciwnym razie operacje zapisu mogą zakończyć się niepowodzeniem ze względu na reguły zabezpieczeń.

Utrzymywanie aktualności danych

Baza danych czasu rzeczywistego Firebase synchronizuje i przechowuje lokalną kopię danych dla aktywnych słuchaczy. Ponadto możesz synchronizować określone lokalizacje.

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
let scoresRef = Database.database().reference(withPath: "scores")
scoresRef.keepSynced(true)

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie 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 odwołanie nie ma aktywnych słuchaczy. Możesz ponownie wyłączyć synchronizację za pomocą następującego wiersza kodu.

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
scoresRef.keepSynced(false)

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
[scoresRef keepSynced:NO];

Domyślnie buforowanych jest 10 MB wcześniej zsynchronizowanych danych. To powinno wystarczyć do większości zastosowań. Jeśli pamięć podręczna przekroczy skonfigurowany rozmiar, baza danych czasu rzeczywistego Firebase usuwa dane, które były ostatnio używane. Synchronizowane dane nie są usuwane z pamięci podręcznej.

Wyszukiwanie danych w trybie offline

Baza danych czasu rzeczywistego Firebase przechowuje dane zwrócone z zapytania do wykorzystania w trybie offline. W przypadku zapytań tworzonych w trybie offline baza danych czasu rzeczywistego Firebase nadal działa dla wcześniej załadowanych danych. Jeśli żądane dane nie zostały załadowane, baza danych czasu rzeczywistego Firebase ładuje dane z lokalnej pamięci podręcznej. Gdy połączenie sieciowe będzie ponownie dostępne, dane zostaną załadowane i będą odzwierciedlać zapytanie.

Na przykład ten kod wysyła zapytanie o ostatnie cztery elementy w bazie danych wyników w czasie rzeczywistym Firebase

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
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")")
}

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
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 zapytania o dwa ostatnie elementy z tej samej lokalizacji. To zapytanie pomyślnie zwróci dwa ostatnie elementy, ponieważ aplikacja załadowała wszystkie cztery elementy w powyższym zapytaniu.

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
scoresRef.queryOrderedByValue().queryLimited(toLast: 2).observe(.childAdded) { snapshot in
  print("The \(snapshot.key) dinosaur's score is \(snapshot.value ?? "null")")
}

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
[[[scoresRef queryOrderedByValue] queryLimitedToLast:2]
    observeEventType:FIRDataEventTypeChildAdded withBlock:^(FIRDataSnapshot *snapshot) {
      NSLog(@"The %@ dinosaur's score is %@", snapshot.key, snapshot.value);
    }];

W poprzednim przykładzie klient Bazy danych czasu rzeczywistego Firebase zgłasza zdarzenia „dodania elementu podrzędnego” dla dwóch dinozaurów o najwyższej punktacji, korzystając z utrwalonej pamięci podręcznej. Nie wywoła to jednak zdarzenia „wartość”, ponieważ aplikacja nigdy nie wykonała tego zapytania w trybie online.

Gdyby aplikacja zażądała ostatnich sześciu elementów w trybie offline, od razu otrzymałaby zdarzenia „dodania dziecka” dla czterech elementów zapisanych w pamięci podręcznej. Gdy urządzenie wraca do trybu online, klient bazy danych czasu rzeczywistego Firebase synchronizuje się z serwerem i pobiera ostatnie dwa zdarzenia „dodane dziecko” i „wartość” dla aplikacji.

Obsługa transakcji offline

Wszelkie transakcje wykonywane, gdy aplikacja jest w trybie offline, są umieszczane w kolejce. Gdy aplikacja odzyska łączność sieciową, transakcje są wysyłane do serwera bazy danych czasu rzeczywistego.

Zarządzanie obecnością

W aplikacjach czasu rzeczywistego często przydatne jest wykrywanie, kiedy klienci łączą się i rozłączają. Na przykład możesz chcieć oznaczyć użytkownika jako „offline”, gdy jego klient rozłączy się.

Klienci bazy danych Firebase udostępniają proste operacje podstawowe, których można użyć do zapisu w bazie danych, gdy klient rozłączy się z serwerami bazy danych Firebase. Aktualizacje te występują niezależnie od tego, czy klient rozłączy się bezproblemowo, czy nie, więc możesz polegać na nich w czyszczeniu danych, nawet jeśli połączenie zostanie zerwane lub klient ulegnie awarii. Wszystkie operacje zapisu, w tym ustawianie, aktualizowanie i usuwanie, można wykonać po rozłączeniu.

Oto prosty przykład zapisu danych po rozłączeniu przy użyciu prymitywu onDisconnect :

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
let presenceRef = Database.database().reference(withPath: "disconnectmessage");
// Write a string when this client loses connection
presenceRef.onDisconnectSetValue("I disconnected!")

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
FIRDatabaseReference *presenceRef = [[FIRDatabase database] referenceWithPath:@"disconnectmessage"];
// Write a string when this client loses connection
[presenceRef onDisconnectSetValue:@"I disconnected!"];

Jak działa onDisconnect

Po ustanowieniu operacji onDisconnect() operacja działa na serwerze bazy danych czasu rzeczywistego Firebase. Serwer sprawdza zabezpieczenia, aby upewnić się, że użytkownik może wykonać żądane zdarzenie zapisu, i informuje aplikację, jeśli jest nieprawidłowa. Następnie serwer monitoruje połączenie. Jeśli w dowolnym momencie połączenie przekroczy limit czasu lub zostanie aktywnie zamknięte przez klienta bazy danych czasu rzeczywistego, serwer sprawdza zabezpieczenia po raz drugi (aby upewnić się, że operacja jest nadal prawidłowa), a następnie wywołuje zdarzenie.

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

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
presenceRef.onDisconnectRemoveValue { error, reference in
  if let error = error {
    print("Could not establish onDisconnect event: \(error)")
  }
}

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
[presenceRef onDisconnectRemoveValueWithCompletionBlock:^(NSError *error, FIRDatabaseReference *reference) {
  if (error != nil) {
    NSLog(@"Could not establish onDisconnect event: %@", error);
  }
}];

Zdarzenie onDisconnect można również anulować, wywołując funkcję .cancel() :

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
presenceRef.onDisconnectSetValue("I disconnected")
// some time later when we change our minds
presenceRef.cancelDisconnectOperations()

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie 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ą przydatna jest informacja, czy aplikacja jest w trybie online, czy offline. Baza danych czasu rzeczywistego Firebase zapewnia specjalną lokalizację w /.info/connected , która jest aktualizowana za każdym razem, gdy zmienia się stan połączenia klienta Bazy danych czasu rzeczywistego Firebase. Oto przykład:

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
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")
  }
})

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
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 bazy danych czasu rzeczywistego, ponieważ wartość zależy od stanu klienta. Innymi słowy, jeśli jeden klient odczyta /.info/connected jako fałsz, nie ma gwarancji, że inny klient również odczyta fałsz.

Obsługa opóźnienia

Znaczniki czasu serwera

Serwery bazy danych czasu rzeczywistego Firebase zapewniają mechanizm wstawiania znaczników czasu generowanych na serwerze jako dane. Ta funkcja, w połączeniu z onDisconnect , zapewnia łatwy sposób niezawodnego zanotowania czasu, w którym klient bazy danych czasu rzeczywistego rozłączył się:

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
let userLastOnlineRef = Database.database().reference(withPath: "users/morgan/lastOnline")
userLastOnlineRef.onDisconnectSetValue(ServerValue.timestamp())

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
FIRDatabaseReference *userLastOnlineRef = [[FIRDatabase database] referenceWithPath:@"users/morgan/lastOnline"];
[userLastOnlineRef onDisconnectSetValue:[FIRServerValue timestamp]];

Przekrzywienie zegara

Podczas gdy firebase.database.ServerValue.TIMESTAMP jest znacznie dokładniejszy i preferowany w przypadku większości operacji odczytu/zapisu, czasami może być przydatny do oszacowania przesunięcia zegara klienta w odniesieniu do serwerów bazy danych czasu rzeczywistego Firebase. Możesz dołączyć wywołanie zwrotne do lokalizacji /.info/serverTimeOffset , aby uzyskać wartość w milisekundach, którą klienci Bazy danych czasu rzeczywistego Firebase dodają do lokalnego zgłaszanego czasu (czas epoki w milisekundach) w celu oszacowania czasu serwera. Należy zauważyć, że na dokładność tego przesunięcia może mieć wpływ opóźnienie sieci, dlatego jest ono przydatne przede wszystkim do wykrywania dużych (> 1 sekundy) rozbieżności w czasie zegara.

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
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)")
  }
})

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
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 sprawdzania obecności

Łącząc operacje rozłączania z monitorowaniem stanu połączenia i znacznikami czasu serwera, można zbudować system obecności użytkowników. W tym systemie każdy użytkownik przechowuje dane w lokalizacji bazy danych, aby wskazać, czy klient bazy danych czasu rzeczywistego jest online. Klienci ustawiają tę lokalizację na true, gdy przechodzą do trybu online, i znacznik czasu, gdy się rozłączają. Ten znacznik czasu wskazuje ostatni raz, kiedy dany użytkownik był online.

Pamiętaj, że Twoja aplikacja powinna umieszczać w kolejce operacje rozłączenia, zanim użytkownik zostanie oznaczony jako online, aby uniknąć warunków wyścigu w przypadku utraty połączenia sieciowego klienta, zanim oba polecenia będą mogły zostać wysłane do serwera.

Oto prosty system obecności użytkownika:

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
// 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 let connected = snapshot.value as? Bool, connected 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())
})

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
// 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]];
  }
}];