파티션 기반 동기화 - Kotlin SDK

파티션 값

When you select Partition-Based Sync for your backend App configuration, your client implementation must include a partition value. 이는 파티션 기반 동기화 를 구성할 때 선택하는 파티션 키 필드 의 값입니다.

파티션 값에 따라 클라이언트 애플리케이션이 액세스할 수 있는 데이터가 결정됩니다.

동기화된 영역을 열 때 파티션 값을 제공해야 합니다.

파티션 기반 동기화 Realm 열기

파티션 기반 동기화 Realm을 열려면 사용자, 파티션, Realm 객체 스키마 설정하다 를 영역 () 에 전달합니다. 그런 다음 구성을 Realm .open() 에 전달하여 영역 의 인스턴스 를 엽니다.

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()
}

파티션 기반 동기화 Realm 구성

특정 구성 설정을 조정하려면 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()
}

동기화 세션에 대한 업로드 및 다운로드 진행률 확인

동기화 세션의 업로드 및 다운로드 진행 상황을 모니터링할 수 있습니다. 동기화 세션은 동기화된 Realm을 열 때 시작됩니다. 자세한 내용은 managed 동기화 세션을 참조하세요.

동기화 업로드 및 다운로드 진행 상황을 모니터 하려면 SyncSession.progressAsFlow()

이 메서드는 Flow of Progress 이벤트를 반환합니다. Progress 은(는) 전송 가능한 바이트의 총 수와 전송될 나머지 바이트를 제공합니다.

syncSession.progressAsFlow() 두 개의 인수를 사용합니다:

• UPLOAD 또는 DOWNLOAD 로 설정할 수 있는 방향 열거형입니다. 진행률 스트림이 업로드 또는 다운로드를 추적하도록 지정합니다.

• 둘 중 하나로 설정할 수 있는 ProgressMode 열거형입니다.

  • INDEFINITELY: 콜백이 등록 취소될 때까지 알림이 계속되도록 설정합니다.

  • CURRENT_CHANGES: 현재 전송 가능한 바이트만 동기화될 때까지 알림이 계속되도록 설정합니다.

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

파티션 기반 동기화에서 Flexible Sync로 마이그레이션

App Services Device Sync 모드를 파티션 기반 동기화에서 Flexible Sync로 마이그레이션할 수 있습니다. 마이그레이션은 애플리케이션 코드를 변경할 필요가 없는 자동 프로세스입니다. 자동 마이그레이션을 사용하려면 Realm Kotlin SDK 버전 1.9.0 이상이 필요합니다.

마이그레이션하면 기존 App Services 사용자 및 인증 구성을 유지할 수 있습니다. Flexible Sync는 더욱 다양한 권한 구성 옵션과 보다 세분화된 데이터 동기화를 제공합니다.

App Services App을 파티션 기반 동기화에서 Flexible Sync로 마이그레이션하는 방법에 대한 자세한 내용은 Device Sync 모드 마이그레이션을 참조하세요.