Realm Kotlin SDK/io.realm.kotlin/Realm/writeCopyTo

写复制 到

摘要 乐趣 writeCopyTo(targetConfiguration ：配置)

将 Realm 的压缩副本写入targetConfiguration定义的给定目标。 生成的文件可用于多种目的：

  • 本地 Realm 的备份。

  • 备份已同步域，但必须首先上传所有本地更改。

  • 将本地 Realm 转换为基于分区的 Realm。

  • 将同步（基于分区或灵活）Realm 转换为本地 Realm。

可以独立于当前 Realm 为目标 Realm 配置加密。

目标文件不能是已经存在的文件。

参数

目标 配置

配置，它使用Configuration.path定义要创建的备份类型以及将备份写入的位置。

抛出异常

如果targetConfiguration启用了 Flexible Sync，而正在复制的 Realm 未启用。

如果此 Realm 是同步 Realm，并且并非所有客户端更改都集成在服务器中。