Habilita funciones sin conexión en Android

Comportamiento de la persistencia

Cuando habilitas la persistencia, los datos que sincroniza el cliente de Firebase Realtime Database mientras está en línea persisten en el disco y están disponibles sin conexión, incluso cuando el usuario o el sistema operativo reinician la app. Esto significa que la app funciona como lo haría en línea con los datos locales almacenados en la caché. Las devoluciones de llamada de los objetos de escucha continúan activándose para las actualizaciones locales.

El cliente de Firebase Realtime Database mantiene automáticamente una cola de todas las operaciones de escritura ejecutadas mientras la app está sin conexión. Cuando se habilita la persistencia, esta cola persiste en el disco, de manera que todas las escrituras están disponibles cuando el usuario o el sistema operativo reinician la app. Cuando se vuelve a conectar la app, todas las operaciones se envían al servidor de Firebase Realtime Database.

Si la app usa Firebase Authentication, el cliente de Firebase Realtime Database conserva el token de autenticación del usuario cuando se la reinicia. Si el token de autenticación vence mientras la app está sin conexión, el cliente pausa las operaciones de escritura hasta que la app vuelva a autenticar al usuario. De lo contrario, las operaciones de escritura podrían fallar debido a las reglas de seguridad.

Mantén los datos actualizados

Firebase Realtime Database sincroniza y almacena una copia local de los datos para los objetos de escucha activos. Además, puedes mantener ubicaciones específicas sincronizadas.

val scoresRef = Firebase.database.getReference("scores")
scoresRef.keepSynced(true)
OfflineActivity.kt

DatabaseReference scoresRef = FirebaseDatabase.getInstance().getReference("scores");
scoresRef.keepSynced(true);
OfflineActivity.java

El cliente de Firebase Realtime Database descarga automáticamente los datos a estas ubicaciones y las mantiene sincronizadas, incluso si la referencia no tiene objetos de escucha activos. Puedes volver a desactivar la sincronización con la siguiente línea de código.

scoresRef.keepSynced(false)
OfflineActivity.kt

scoresRef.keepSynced(false);
OfflineActivity.java

De forma predeterminada, se almacenan en caché 10 MB de datos antes sincronizados. Esto debería ser suficiente para la mayoría de las aplicaciones. Si la caché sobrepasa el tamaño configurado, Firebase Realtime Database borra de manera definitiva los datos que se usaron de forma menos reciente. Los datos que se mantienen sincronizados no se borran definitivamente de la memoria caché.

Consulta datos sin conexión

Firebase Realtime Database almacena los datos que se muestran con una consulta para usarlos sin conexión. En el caso de las consultas que se crean sin conexión, Firebase Realtime Database continúa trabajando con los datos cargados con anterioridad. Si no se cargaron los datos solicitados, Firebase Realtime Database carga datos de la caché local. Cuando la conectividad de red vuelva a estar disponible, se cargarán los datos conforme a la consulta.

Por ejemplo, este código consulta los últimos cuatro elementos de Firebase Realtime Database de puntuaciones

val scoresRef = Firebase.database.getReference("scores")
scoresRef.orderByValue().limitToLast(4).addChildEventListener(object : ChildEventListener {
    override fun onChildAdded(snapshot: DataSnapshot, previousChild: String?) {
        Log.d(TAG, "The ${snapshot.key} dinosaur's score is ${snapshot.value}")
    }

    // ...
})
OfflineActivity.kt

DatabaseReference scoresRef = FirebaseDatabase.getInstance().getReference("scores");
scoresRef.orderByValue().limitToLast(4).addChildEventListener(new ChildEventListener() {
    @Override
    public void onChildAdded(@NonNull DataSnapshot snapshot, String previousChild) {
        Log.d(TAG, "The " + snapshot.getKey() + " dinosaur's score is " + snapshot.getValue());
    }

    // ...
});
OfflineActivity.java

Supongamos que falla la conectividad, se desconecta el usuario y se reinicia la app. Mientras está sin conexión, la app consulta los últimos dos elementos de la misma ubicación. Esta consulta dará como resultado los dos últimos elementos correctamente, porque la app cargó los cuatro elementos en la consulta anterior.

scoresRef.orderByValue().limitToLast(2).addChildEventListener(object : ChildEventListener {
    override fun onChildAdded(snapshot: DataSnapshot, previousChild: String?) {
        Log.d(TAG, "The ${snapshot.key} dinosaur's score is ${snapshot.value}")
    }

    // ...
})
OfflineActivity.kt

scoresRef.orderByValue().limitToLast(2).addChildEventListener(new ChildEventListener() {
    @Override
    public void onChildAdded(@NonNull DataSnapshot snapshot, String previousChild) {
        Log.d(TAG, "The " + snapshot.getKey() + " dinosaur's score is " + snapshot.getValue());
    }

    // ...
});
OfflineActivity.java

En el ejemplo anterior, el cliente de Firebase Realtime Database genera eventos de tipo "child added" para los dos dinosaurios con puntuaciones más altas, a partir de la memoria caché que persistió. Sin embargo, no generará un evento "value", ya que la app nunca ejecutó esa consulta mientras estaba en línea.

Si la aplicación solicitara los últimos seis elementos mientras está sin conexión, obtendría los eventos "child added" de inmediato para los cuatro elementos en caché. Cuando el dispositivo vuelva a estar en línea, el cliente de Firebase Realtime Database se sincronizará con el servidor y obtendrá los dos últimos eventos "child added" y el "value" para la app.

Administra transacciones sin conexión

Todas las transacciones que se ejecutan mientras la app está sin conexión se agregan a la cola. Cuando la app recupera la conectividad de red, las transacciones se envían al servidor de Realtime Database.

Cómo funciona onDisconnect

Cuando estableces una operación onDisconnect(), esta se aloja en el servidor Firebase Realtime Database. El servidor verifica la seguridad para comprobar que el usuario pueda ejecutar el evento de escritura solicitado y le informa a la app si no es válido. Después, el servidor supervisa la conexión. Si en algún momento se agota el tiempo de espera de la conexión o el cliente de Realtime Database la cierra, el servidor verifica la seguridad por segunda vez (para asegurarse de que la operación todavía sea válida) y después invoca el evento.

La app puede usar la devolución de llamada en la operación de escritura para asegurarse de que se haya adjuntado correctamente la operación onDisconnect:

presenceRef.onDisconnect().removeValue { error, reference ->
    error?.let {
        Log.d(TAG, "could not establish onDisconnect event: ${error.message}")
    }
}
OfflineActivity.kt

presenceRef.onDisconnect().removeValue(new DatabaseReference.CompletionListener() {
    @Override
    public void onComplete(DatabaseError error, @NonNull DatabaseReference reference) {
        if (error != null) {
            Log.d(TAG, "could not establish onDisconnect event:" + error.getMessage());
        }
    }
});
OfflineActivity.java

Los eventos onDisconnect también se pueden cancelar llamando a .cancel():

val onDisconnectRef = presenceRef.onDisconnect()
onDisconnectRef.setValue("I disconnected")
// ...
// some time later when we change our minds
// ...
onDisconnectRef.cancel()
OfflineActivity.kt

OnDisconnect onDisconnectRef = presenceRef.onDisconnect();
onDisconnectRef.setValue("I disconnected");
// ...
// some time later when we change our minds
// ...
onDisconnectRef.cancel();
OfflineActivity.java

Marcas de tiempo del servidor

Los servidores de Firebase Realtime Database proporcionan un mecanismo para insertar marcas de tiempo generadas en el servidor como datos. Esta función, combinada con onDisconnect, proporciona una manera simple y confiable de tomar nota de la hora a la que se desconectó el cliente de Realtime Database:

val userLastOnlineRef = Firebase.database.getReference("users/joe/lastOnline")
userLastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP)
OfflineActivity.kt

DatabaseReference userLastOnlineRef = FirebaseDatabase.getInstance().getReference("users/joe/lastOnline");
userLastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP);
OfflineActivity.java

Sesgo de reloj

Aunque firebase.database.ServerValue.TIMESTAMP es mucho más preciso y se prefiere para la mayoría de las operaciones de lectura o escritura, en ocasiones, puede ser útil hacer un cálculo aproximado del sesgo de reloj del cliente en relación con los servidores de Firebase Realtime Database. Puedes adjuntar una devolución de llamada a la ubicación /.info/serverTimeOffset para obtener el valor en milisegundos que los clientes de Firebase Realtime Database agregan a la hora local informada (época en milisegundos) para calcular de manera aproximada la hora del servidor. Ten en cuenta que la precisión de este ajuste horario puede verse afectada por la latencia de la red, por lo que es útil principalmente para descubrir discrepancias grandes en la hora del reloj (de más de 1 segundo).

val offsetRef = Firebase.database.getReference(".info/serverTimeOffset")
offsetRef.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(snapshot: DataSnapshot) {
        val offset = snapshot.getValue(Double::class.java) ?: 0.0
        val estimatedServerTimeMs = System.currentTimeMillis() + offset
    }

    override fun onCancelled(error: DatabaseError) {
        Log.w(TAG, "Listener was cancelled")
    }
})
OfflineActivity.kt

DatabaseReference offsetRef = FirebaseDatabase.getInstance().getReference(".info/serverTimeOffset");
offsetRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot snapshot) {
        double offset = snapshot.getValue(Double.class);
        double estimatedServerTimeMs = System.currentTimeMillis() + offset;
    }

    @Override
    public void onCancelled(@NonNull DatabaseError error) {
        Log.w(TAG, "Listener was cancelled");
    }
});
OfflineActivity.java