Sincronización basada en particiones - SDK de Kotlin

Valor de partición

Cuando se selecciona Partition-Based Sync para la configuración de la aplicación de backend, la implementación del cliente debe incluir un valor de la partición. Este es el valor del campo clave de partición que se selecciona al configurar la Partition-Based Sync.

El valor de la partición determina a qué datos puede acceder la aplicación cliente.

Debes proporcionar un valor de partición cuando abres un reino sincronizado.

Abrir un reino de sincronización basado en particiones

Para abrir un dominio de sincronización basada en particiones, pase un usuario, una partición y un conjunto de esquemas de objetos de dominio a SyncConfiguration.Builder(). Luego, pase la configuración a Realm.open() para abrir una instancia del dominio:

val app = App.create(YOUR_APP_ID)
runBlocking {
    val user = app.login(Credentials.anonymous())
    val config =
        SyncConfiguration.Builder(user, PARTITION, setOf(/*realm object models here*/))
            // specify name so realm doesn't just use the "default.realm" file for this user
            .name(PARTITION)
            .build()
    val realm = Realm.open(config)
    Log.v("Successfully opened realm: ${realm.configuration.name}")
    realm.close()
}

Configurar un dominio de sincronización basado en particiones

Para ajustar configuraciones específicas, utilice las opciones proporcionadas por SyncConfiguration.Builder:

val app = App.create(YOUR_APP_ID)
runBlocking {
    val user = app.login(Credentials.anonymous())
    val config =
        SyncConfiguration.Builder(user, PARTITION, setOf(/*realm object models here*/))
            .maxNumberOfActiveVersions(10)
            .waitForInitialRemoteData()
            .name("realm name")
            .build()
    val realm = Realm.open(config)
    Log.v("Successfully opened realm: ${realm.configuration}")
    realm.close()
}

Consulta el progreso de carga y descarga para una sesión de sincronización

Puedes supervisar el progreso de carga y descarga de una sesión de sincronización. La sesión de sincronización se inicia al abrir un dominio sincronizado. Para obtener más información, consulta Administrar una sesión de sincronización.

Para supervisar el progreso de carga y descarga de Sync, llame a SyncSession.progressAsFlow()

Este método devuelve un flujo de eventos de progreso. Progress proporciona el número total de bytes transferibles y los bytes restantes a transferir.

syncSession.progressAsFlow() toma dos argumentos:

• Una enumeración de dirección que UPLOAD puede DOWNLOAD configurarse como o. Esto especifica que el flujo de progreso rastrea las cargas o descargas.

• Una enumeración ProgressMode que se puede configurar en:

  • INDEFINITELY:Establece que las notificaciones continúen hasta que se cancele el registro de la devolución de llamada.

  • CURRENT_CHANGES:Establece que las notificaciones continúen hasta que solo se sincronicen los bytes transferibles actualmente.

val stream = realm.syncSession.progressAsFlow(
    Direction.UPLOAD, ProgressMode.CURRENT_CHANGES
)
stream.collect { progress ->
    if (progress.transferableBytes == progress.transferredBytes) {
        Log.i("Upload complete")
    }
}

Migrar de la sincronización basada en particiones a la sincronización flexible

Puedes migrar tu App Services Device Sync Mode de Partition-Based Sync a Flexible Sync. La migración es un proceso automático que no requiere ningún cambio en el código de tu aplicación. La migración automática requiere la versión 1.9.0 o superior del SDK de Realm Kotlin.

La migración le permite conservar sus usuarios y configuración de autenticación de App Services. Flexible Sync ofrece opciones de configuración de permisos más versátiles y una sincronización de datos más granular.

Para obtener más información sobre cómo migrar su aplicación de App Services de sincronización basada en particiones a sincronización flexible, consulte Migrar modos de sincronización de dispositivos.