Apple platformlarındaki Çevrimdışı Özellikler

Uygulamanız ağı geçici olarak kaybetse bile Firebase uygulamaları çalışır bağlantı. Firebase, verilerin yerel olarak kalıcı hale getirilmesini sağlayan araçlar sunar. ve gecikmenin üstesinden gelebilirsiniz.

Disk Kalıcılığı

Firebase uygulamaları, geçici ağ kesintilerini otomatik olarak ele alır. Önbelleğe alınan veriler çevrimdışıyken kullanılabilir ve Firebase tüm yazma işlemlerini yeniden gönderir ağ bağlantısı geri geldiğinde.

Disk kalıcılığını etkinleştirdiğinizde, uygulamanız verileri yerel olarak Böylece kullanıcı, cihazı kullansa bile çevrimdışıyken bile uygulamanızın durumunu koruyabilir. veya işletim sistemi uygulamayı yeniden başlatır.

Disk kalıcılığını yalnızca bir satır kodla etkinleştirebilirsiniz.

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

Database.database().isPersistenceEnabled = true

Objective-C

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

[FIRDatabase database].persistenceEnabled = YES;

Kalıcı Davranış

Kalıcılığı etkinleştirdiğinizde, Firebase Realtime Database istemcisinin çevrimiçi olduğunda diskte kalır ve çevrimdışı kullanılabilir, Kullanıcı veya işletim sistemi uygulamayı yeniden başlatsa bile. Bu, uygulama, önbellekte depolanan yerel verileri kullanarak çevrimiçi olarak da çalışır. Yerel güncellemeler için dinleyici geri çağırmaları tetiklenmeye devam eder.

Firebase Realtime Database istemcisi, otomatik olarak tüm veri kümelerini uygulamanız çevrimdışıyken gerçekleştirilen yazma işlemleri. Kalıcılık etkinleştirildiğinde bu sıra, diskte de saklanır. Böylece tüm kullanıcı veya işletim sistemi tarafından kullanılabilir ve uygulamayı yeniden başlatır. Uygulama tekrar internete bağlandığında, işlemler Firebase Realtime Database sunucusuna gönderilir.

Uygulamanızda Firebase Authentication, Firebase Realtime Database istemcisi, kullanıcının kimlik doğrulama işlemini devam ettirir uygulama yeniden başlatmalarında ne kadar jeton kullanıldığını gösterir. Uygulamanız çevrimdışıyken kimlik doğrulama jetonunun süresi dolarsa istemci duraklar uygulamanız, kullanıcının kimliğini yeniden doğrulayana kadar yazma işlemleri, aksi halde yazma işlemleri güvenlik kuralları nedeniyle başarısız olabilir.

Verileri güncel tutma

Firebase Realtime Database, API'nin yerel bir kopyasını senkronize eder ve farklı veri türlerinden bahsettik. Ayrıca, belirli konumları senkronize edin.

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Objective-C

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Firebase Realtime Database istemcisi, verileri şurada otomatik olarak indirir: bu konumları senkronize eder ve referansta size yardımcı olur. Senkronizasyonu kapatabilirsiniz: sonraki kod satırını kullanın.

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

scoresRef.keepSynced(false)

Objective-C

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

[scoresRef keepSynced:NO];

Varsayılan olarak, önceden senkronize edilmiş 10 MB'lık veri ön belleğe alınır. Bu özellik, çoğu uygulama için yeterli olur. Önbellek, yapılandırılmış boyutuna sığmazsa Firebase Realtime Database, en az son kullanılan verileri tamamen siler. Senkronize edilen veriler önbellekten silinmez.

Çevrimdışı Verileri Sorgulama

Firebase Realtime Database, bir sorgudan döndürülen verileri kullanım amacıyla depolar çevrimdışıyken de kullanılabilir. Çevrimdışıyken oluşturulan sorgular için Firebase Realtime Database, önceden yüklenmiş veriler için çalışmaya devam eder. İstenen veriler yüklenmediyse Firebase Realtime Database yüklenir. yerel önbellekteki verileri içerebilir. Ağ bağlantısı tekrar kullanılabilir olduğunda, veriler yüklenir ve sorguyu yansıtır.

Örneğin, bu kod her Firebase Gerçek Zamanlı Puan Veritabanında dört öğe

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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);
    }];

Kullanıcının bağlantısını kestiğini, çevrimdışı olduğunu ve uygulamayı yeniden başlattığını varsayın. Çevrimdışıyken uygulama, sayfadaki son iki öğeyi sorgular aynı konum. Bu sorgu son iki öğeyi başarıyla döndürecek çünkü uygulama yukarıdaki sorgudaki dört öğenin tümünü yüklemişti.

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Objective-C

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Yukarıdaki örnekte, Firebase Realtime Database müşterisi "çocuk eklendi" en yüksek puanı alan iki dinozor için etkinlikler. kalıcı önbellek. Ancak bu, bir 'value' (değer) yaratmaz daha fazla bilgi sağlar. o sorguyu hiçbir zaman yürütmemiş olabilir.

Uygulama çevrimdışıyken son altı öğeyi istese bile "çocuk eklendi" için etkinlikleri anında sunar. cihaz tekrar çevrimiçi olduğunda, Firebase Realtime Database istemcisi sunucuyla iletişim kurar ve son iki 'alt öğeyi' ekler ve "value" ekleyebilirsiniz.

İşlemleri Çevrimdışı Olarak Yönetme

Uygulama çevrimdışıyken yapılan tüm işlemler sıraya alınır. Uygulama ağ bağlantısını yeniden sağladığında işlemler şuraya gönderilir: emin olmaktır.

İşlemler, uygulama yeniden başlatıldığında devam etmiyor

Kalıcılık etkin olsa bile işlemler yeniden başlatmasını sağlar. Bu nedenle, çevrimdışı yapılan işlemlere güvenemezsiniz Firebase Realtime Database'inize bağlıyız. En iyi deneyimi sunmak için kullanıcı deneyimi için bir işlemde veya Firebase Realtime Database'inize kaydedilmiş ancak Uygulama bunları manuel olarak hatırlar ve bir uygulamadan sonra tekrar yürütür yeniden başlat.

Firebase Realtime Database, çevrimdışı işlemler için birçok özelliğe sahiptir. senaryoları ve ağ bağlantısını içerir. Bu kılavuzun geri kalanı, uygulamanızda Kalıcılık özelliği etkin olsun ya da olmasın.

Varlığı Yönetme

Gerçek zamanlı uygulamalarda, istemcilerin ne zaman meşgul olduklarını veya bağlantıyı kesebilirsiniz. Örneğin, eğitime Bir kullanıcıyı "çevrimdışı" olarak işaretlemek istiyorsanız bağlantısı kesildiğinde.

Firebase Veritabanı istemcileri, veri kümelerini oluşturmak için kullanabileceğiniz basit İstemci Firebase Veritabanı ile bağlantısı kesildiğinde veri tabanına yazma sunucular. Bu güncellemeler, istemcinin bağlantısının kesilip kesilmediğinden bağımsız olarak, Böylece, bağlantınız kesilse bile verileri temizleme konusunda onlara güvenebilirsiniz. sorun olabilir. Şunlar dahil tüm yazma işlemleri: Güncelleme ve kaldırma işlemleri, bağlantı kesildikten sonra gerçekleştirilebilir.

Bağlantı kesildikten sonra onDisconnect temel öğesi:

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Objective-C

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

OnBağlantıyı Kesmenin İşleyiş Şekli

Bir onDisconnect() işlemi oluşturduğunuzda, Firebase Realtime Database sunucusunda çalışıyor. Sunucu, güvenliği Kullanıcının istenen yazma etkinliğini gerçekleştirebildiğinden emin olur ve geçersizse uygulamanızı. Ardından sunucu, bağlantıyı izler. Herhangi bir noktada bağlantı zaman aşımına uğrarsa veya Realtime Database istemcisi tarafından aktif olarak kapatılmışsa sunucu, ikinci kez (işlemin hâlâ geçerli olduğundan emin olmak için) etkinliği tıklayın.

Uygulamanız, yazma işleminde geri çağırmayı kullanabilir onDisconnect öğesinin doğru şekilde eklendiğinden emin olmak için:

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Objective-C

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

onDisconnect etkinliği, .cancel() aranarak da iptal edilebilir:

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Objective-C

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Bağlantı Durumunu Algılama

Evde olmayla ilgili çoğu özellik açısından uygulamanıza faydalıdır. çevrimiçi mi yoksa çevrimdışı mı olduğunu bilmektir. Firebase Gerçek Zamanlı Veritabanı /.info/connected adresinde özel bir konum sağlar. Firebase Realtime Database istemcisinin bağlantı durumu her seferinde güncellenir anlamına gelir. Bir örnek verelim:

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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, bağımsız bir boole değeridir senkronize edildiğinden, ve istemcinin durumuna bağlıdır. Başka bir deyişle, /.info/connected yanlış olarak okuyor, bu hayır farklı bir istemcinin false (yanlış) değerini okuyacağını garanti eder.

İşleme Gecikmesi

Sunucu Zaman Damgaları

Firebase Realtime Database sunucuları, veri eklemek için bir mekanizma sağlar sunucuda veri olarak oluşturulan zaman damgalarıdır. Bu özellik, onDisconnect, verilerinizi güvenilir bir şekilde not etmenin kolay bir yolunu sunuyor. bir Realtime Database istemcisinin bağlantısının kesildiği saat:

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Objective-C

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Saat Sapma

firebase.database.ServerValue.TIMESTAMP ise çok daha avantajlı çoğu okuma/yazma işlemi için doğru ve tercih edilir. bazen müşterinin saat sapmasını tahmin etmek, Firebase Realtime Database'in sunucuları için geçerlidir. Siz /.info/serverTimeOffset konumuna geri arama ekleyebilir Firebase Realtime Database istemcilerinin değerini milisaniye cinsinden elde etmek için tahmin etmek için yerel olarak bildirilen zamana (milisaniye cinsinden dönem zamanı) ekleyin anlamına gelir. Bu ofsetin doğruluğunun ağ gecikmesidir, bu nedenle öncelikli olarak keşif sürecinde büyük (> 1 saniye) tutarsızlıklar.

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

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);
}];

Örnek Varlık Uygulaması

Bağlantı kesme işlemlerini bağlantı durumu izlemeyle birleştirerek kullanıcı varlığı sistemi oluşturabilirsiniz. Bu sistemde, Her kullanıcı bir veri tabanında depolanan verileri veritabanının yerinde depolayıp depolamadığını Realtime Database istemcisi internete bağlandı. Müşteriler bu konumu şu durumlarda doğru olarak ayarlar: internete giriyorlarsa ve bağlantıları kesildiğinde de bir zaman damgası gösteriyor. Bu zaman damgası belirtilen kullanıcının en son ne zaman çevrimiçi olduğunu gösterir.

Uygulamanızın, bağlantı kesme işlemlerini bir kullanıcı tarafından bağlanmadan önce sıraya koyması gerektiğini unutmayın. hiçbir yarış koşulu belirlememesi için, müşterinin ürünü veya hizmeti Her iki komut da sunucuya gönderilmeden önce ağ bağlantısı kesilir.

Basit bir kullanıcı varlığı sistemi aşağıda verilmiştir:

Swift

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

// 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

Not: Bu Firebase ürünü, App Clip hedefinde kullanılamaz.

// 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]];
  }
}];