sincronização baseada em partição - Kotlin SDK

Valor da partição

Quando você seleciona sincronização baseada em partição para a configuração do aplicativo de backend, a implementação do cliente deve incluir um valor da partição}. Esse é o valor do campo da chave da partição que você seleciona ao configurar a sincronização baseada em partição.

O valor da partição determina quais dados o aplicativo cliente pode acessar.

Você deve fornecer um valor da partição quando abrir um Realm sincronizado.

Abra um Realm de sincronização baseado em partição

Para abrir um Realm de sincronização baseada em partição , passe um usuário, uma partição e um conjunto de esquemas de Objeto de Realm para SyncConfiguration.Builder(). Em seguida, passe a configuração para Realm.open() para abrir uma instância do Realm:

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 um sincronização baseada em partição Realm

Para ajustar definições de configuração específicas, use as opções fornecidas 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()
}

Verificar o progresso do upload e download de uma sessão de sincronização

Você pode monitorar o progresso do upload e download de uma sessão de sincronização. A sessão de sincronização começa quando você abre um Realm sincronizado. Para obter mais informações, consulte Gerenciar uma sessão de sincronização.

Para monitorar o progresso do upload e download da sincronização, chame SyncSession.progressAsFlow()

Este método retorna um fluxo de eventos de progresso . Progress fornece o número total de bytes transferíveis e os bytes restantes a serem transferidos.

syncSession.progressAsFlow() recebe dois argumentos:

• Um enum de direção que pode ser definido como UPLOAD ou DOWNLOAD. Especifica que o fluxo de progresso rastreia uploads ou downloads.

• Um enum ProgressMode que pode ser definido como:

  • INDEFINITELY: define as notificações para continuar até que a chamada de resposta seja cancelada.

  • CURRENT_CHANGES: define as notificações para continuar até que somente os bytes atualmente transferíveis sejam sincronizados.

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

Migrar da sincronização baseada em partição para a Flexible Sync

Você pode migrar seu Realm Mobile Sync do App Services da sincronização baseada em partição para a Flexible Sync. A migração é um processo automático que não exige alterações no código do aplicativo. A migração automática requer o Realm Kotlin SDK versão 1.9.0 ou mais recente.

A migração permite que você mantenha os usuários existentes do App Services e a configuração de autenticação. O Flexible Sync fornece opções de configuração de permissões mais versáteis e sincronização de dados mais granular.

Para obter mais informações sobre como migrar seu aplicativo do App Services App da Partition-Based Sync para o Flexible Sync, consulte Migrar modos de Device Sync .