Apple platformlarındaki Çevrimdışı Özellikler

Firebase uygulamaları, uygulamanızın ağ bağlantısı geçici olarak kesilse bile çalışır. Ayrıca Firebase, verileri yerel olarak kalıcı hale getirme, varlığı yönetme ve gecikmeyi işleme araçları sağlar.

Disk Kalıcılığı

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

Disk kalıcılığını etkinleştirdiğinizde uygulamanız, verileri yerel olarak cihaza yazar. Böylece kullanıcı veya işletim sistemi uygulamayı yeniden başlatsa bile uygulamanız çevrimdışıyken durumu koruyabilir.

Yalnızca tek bir kod satırıyla disk kalıcılığını 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ılık Davranışı

Kalıcılık etkinleştirildiğinde Firebase Realtime Database istemcisinin çevrimiçiyken senkronize edeceği tüm veriler diske kaydedilir ve kullanıcı veya işletim sistemi uygulamayı yeniden başlatsa bile çevrimdışı olarak kullanılabilir. Bu sayede uygulamanız, önbellekte depolanan yerel verileri kullanarak çevrimiçindeymiş gibi çalışır. Dinleyici geri aramaları, yerel güncellemeler için tetiklenmeye devam eder.

Firebase Realtime Database istemcisi, uygulamanız çevrimdışıyken gerçekleştirilen tüm yazma işlemlerinin sırasını otomatik olarak tutar. Kalıcılık etkinleştirildiğinde bu sıra diske de kalıcı olarak kaydedilir. Böylece, kullanıcı veya işletim sistemi uygulamayı yeniden başlattığında tüm yazma işlemleriniz kullanılabilir. Uygulama bağlantıyı yeniden kazandığında tüm işlemler Firebase Realtime Database sunucusuna gönderilir.

Uygulamanız Firebase Authentication kullanıyorsa Firebase Realtime Database istemcisi, kullanıcının kimlik doğrulama jetonunu uygulama yeniden başlatıldığında da saklar. Uygulamanız çevrimdışıyken kimlik doğrulama jetonunun süresi dolarsa istemci, uygulamanız kullanıcıyı yeniden doğrulayana kadar yazma işlemlerini duraklatır. Aksi takdirde, güvenlik kuralları nedeniyle yazma işlemleri başarısız olabilir.

Verileri güncel tutma

Firebase Realtime Database, etkin dinleyicilerin verilerinin yerel bir kopyasını senkronize eder ve depolar. Ayrıca, belirli konumları senkronize edebilirsiniz.

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, bu konumlardaki verileri otomatik olarak indirir ve referansta etkin dinleyiciler olmasa bile senkronize tutar. Aşağıdaki kod satırıyla senkronizasyonu tekrar kapatabilirsiniz.

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, daha önce senkronize edilmiş 10 MB'lık veri önbelleğe alınır. Bu, çoğu uygulama için yeterli olmalıdır. Önbellek, yapılandırılmış boyutunu aşarsa Firebase Realtime Database, en son kullanılmamış verileri temizler. Senkronize edilen veriler önbellekten temizlenmez.

Verileri Çevrimdışı Sorgulama

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

Örneğin, bu kod, bir Firebase Realtime Database puan dizisindeki son dört öğeyi sorgular.

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ın kesildiğini, çevrimdışı kaldığını ve uygulamayı yeniden başlattığını varsayalım. Uygulama, hâlâ çevrimdışı durumdayken aynı konumdaki son iki öğeyi sorgular. Bu sorgu, yukarıdaki sorguda dört öğenin tamamı yüklendiği için son iki öğeyi başarıyla döndürür.

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

Önceki örnekte, Firebase Realtime Database istemcisi, kalıcı önbelleği kullanarak en yüksek puanı alan iki dinozor için "child added" etkinliklerini tetikler. Ancak uygulama, çevrimiçiyken bu sorguyu hiç yürütmediği için "değer" etkinliği oluşturmaz.

Uygulama, çevrimdışı durumdayken son altı öğeyi isterse önbelleğe alınan dört öğe için hemen "alt öğe eklendi" etkinliklerini alır. Cihaz tekrar internete bağlandığında Firebase Realtime Database istemcisi sunucuyla senkronize olur ve uygulama için son iki "child added" ve "value" etkinliklerini alır.

İşlemleri Çevrimdışı İşleme

Uygulama çevrimdışıyken gerçekleştirilen tüm işlemler sıraya alınır. Uygulama ağ bağlantısını yeniden sağladığında işlemler Realtime Database sunucusuna gönderilir.

İşlemler, uygulama yeniden başlatıldığında kalıcı olmaz.

Kalıcılık etkinleştirilmiş olsa bile işlemler, uygulama yeniden başlatıldığında kalıcı olmaz. Bu nedenle, çevrimdışı yapılan işlemlerin Firebase Realtime Database hesabınıza işlenmesini bekleyemezsiniz. En iyi kullanıcı deneyimini sunmak için uygulamanız, işlemlerin henüz Firebase Realtime Database kaydedilmediğini göstermeli veya uygulamanızın bunları manuel olarak hatırlayıp uygulama yeniden başlatıldıktan sonra tekrar yürütmesini sağlamalıdır.

Firebase Realtime Database, çevrimdışı senaryolar ve ağ bağlantısıyla ilgili birçok özelliğe sahiptir. Bu kılavuzun geri kalanı, kalıcılığı etkinleştirip etkinleştirmediğinizden bağımsız olarak uygulamanız için geçerlidir.

Varlığı Yönetme

Gerçek zamanlı uygulamalarda, istemcilerin ne zaman bağlandığını ve bağlantısını kestiğini algılamak genellikle yararlıdır. Örneğin, istemcisinin bağlantısı kesilen bir kullanıcıyı "çevrimdışı" olarak işaretlemek isteyebilirsiniz.

Firebase Database istemcileri, bir istemci Firebase Database sunucularının bağlantısını kestiğinde veritabanına yazmak için kullanabileceğiniz basit temel öğeler sağlar. Bu güncellemeler, istemcinin bağlantısı düzgün bir şekilde kesilse de kesilmese de gerçekleşir. Bu nedenle, bağlantı düşse veya istemci kilitlense bile verileri temizlemek için bu güncellemelerden yararlanabilirsiniz. Ayar yapma, güncelleme ve kaldırma dahil olmak üzere tüm yazma işlemleri bağlantı kesildiğinde gerçekleştirilebilir.

onDisconnect temel öğesini kullanarak bağlantı kesildiğinde veri yazma ile ilgili basit bir örneği aşağıda bulabilirsiniz:

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!"];

onDisconnect'in işleyiş şekli

onDisconnect() işlemi oluşturduğunuzda işlem, Firebase Realtime Database sunucusunda yer alır. Sunucu, kullanıcının istenen yazma etkinliğini gerçekleştirebildiğinden emin olmak için güvenliği kontrol eder ve geçersizse uygulamanızı bilgilendirir. Sunucu daha sonra bağlantıyı izler. Bağlantının herhangi bir noktada zaman aşımına uğraması veya Realtime Database istemcisi tarafından etkin olarak kapatılması durumunda sunucu, işlemi ikinci kez kontrol eder (işlemin hâlâ geçerli olduğundan emin olmak için) ve ardından etkinliği çağırır.

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

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() numarası 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

Birçok varlık özelliği için uygulamanızın ne zaman çevrimiçi veya çevrimdışı olduğunu bilmesi yararlıdır. Firebase Realtime Database /.info/connected konumunda özel bir konum sağlar. Bu konum, Firebase Realtime Database istemcisinin bağlantı durumu her değiştiğinde güncellenir. 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, istemcinin durumuna bağlı olduğu için Realtime Database istemcileri arasında senkronize edilmeyen bir Boole değeridir. Diğer bir deyişle, bir istemci /.info/connected değerini yanlış olarak okursa ayrı bir istemcinin de yanlış olarak okuyacağı garanti edilmez.

İşleme Gecikmesi

Sunucu Zaman Damgaları

Firebase Realtime Database sunucuları, sunucuda oluşturulan zaman damgalarını veri olarak eklemek için bir mekanizma sağlar. Bu özellik, onDisconnect ile birlikte kullanıldığında Realtime Database istemcisinin bağlantısının kesildiği zamanı güvenilir bir şekilde not almanın kolay bir yolunu sunar:

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 Sapması

firebase.database.ServerValue.TIMESTAMP çok daha doğru olsa ve çoğu okuma/yazma işlemi için tercih edilse de Firebase Realtime Database sunucularına göre istemcinin saat sapmasını tahmin etmek bazen yararlı olabilir. Sunucu saatini tahmin etmek için /.info/serverTimeOffset konumuna bir geri çağırma ekleyerek Firebase Realtime Database istemcilerinin yerel olarak bildirilen saate (milisaniye cinsinden dönem zamanı) eklediği değeri milisaniye cinsinden elde edebilirsiniz. Bu farkın doğruluğunun ağ gecikmesinden etkilenebileceğini ve bu nedenle öncelikle saat zamanındaki büyük (> 1 saniye) tutarsızlıkları keşfetmek için yararlı olduğunu unutmayın.

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 Presence Uygulaması

Bağlantıyı kesme işlemlerini bağlantı durumu izleme ve sunucu zaman damgalarıyla birleştirerek kullanıcı varlığı sistemi oluşturabilirsiniz. Bu sistemde her kullanıcı, bir Realtime Database istemcisinin çevrimiçi olup olmadığını belirtmek için verileri bir veritabanı konumunda saklar. İstemciler, internete bağlandıklarında bu konumu doğru, bağlantılarını kestiklerinde ise zaman damgası olarak ayarlar. Bu zaman damgası, söz konusu kullanıcının en son ne zaman çevrimiçi olduğunu gösterir.

İstemcinin ağ bağlantısı her iki komut da sunucuya gönderilmeden önce kaybolursa yarış durumu oluşmasını önlemek için uygulamanızın, kullanıcı çevrimiçi olarak işaretlenmeden önce bağlantıyı kesme işlemlerini sıraya alması gerektiğini unutmayın.

Basit bir kullanıcı varlığı sistemi:

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