减小 Realm 文件大小 - Kotlin SDK

Realm 配置文件

您可以通过为配置的 compactOnLaunch函数设置回调，将 Realm 配置为在每次打开Realm文件时压缩域文件。 当您调用compactOnLaunch 进行配置时，如果文件大于 trigger50MB 且域文件中有50 % 或更多空间未使用，则将 DEFAULT_COMPACT_ON_LAUNCH_CALLBACK 。您可以根据应用程序的需求，在调用compactOnLaunch时指定自定义压实设置。 以下代码示例展示了如何执行此操作：

// Set a max file size equal to 100MB in bytes
val maxFileSize = 100 * 1024 * 1024
val config = RealmConfiguration.Builder(setOf(King::class))
    .compactOnLaunch{ totalBytes, usedBytes ->
        // totalBytes refers to the size of the file on disk in bytes (data + free space)
        // usedBytes refers to the number of bytes used by data in the file
        // Compact if the file is over the max file size and less than 50% 'used'
        (totalBytes > maxFileSize) && ((usedBytes / totalBytes) < 0.5)
    }
    .build()
val realm: Realm = Realm.open(config)

Realm.compactRealm 方法

或者，您可以通过调用compactRealm方法来压缩 Realm 文件，而无需打开它：

val config = RealmConfiguration.create(schema = setOf(Item::class))
var compacted = Realm.compactRealm(config)

如果操作成功， compactRealm方法将返回 true，否则返回 false。

制作压缩副本

您可以使用 Realm.writeCopyTo 方法将 Realm 的压缩（和可选 加密 ）副本保存到另一个文件位置。目标文件不能已存在。

手动压缩 Realm 的技巧

手动压缩 Realm 可能是一项资源密集型操作。 应用程序不应在每次打开 Realm 时都进行压缩。 相反，应尝试优化压缩操作，以便应用程序经常执行压缩操作，防止文件过大。 如果应用程序在资源有限的环境中运行，则可能需要在文件大小达到一定大小或文件大小对性能产生负面影响时进行压缩。

这些建议可以帮助您开始优化应用程序的压实：

• 将最大文件大小设置为平均 Realm 状态大小的倍数。如果平均 Realm 状态大小为 10MB，您可以将最大文件大小设置为 20MB 或 40MB，具体取决于预期的使用情况和设备限制。

• 首先，超过 50% 的 Realm 文件大小不再使用时，即可压缩 Realm。将当前已使用的字节数除以总文件大小，确定当前使用的空间百分比。然后，检查该值是否小于 50%。也就是说，超过 50% 的 Realm 文件大小是未使用的空间。这正是压缩的好时机。经过试验后，您可能会发现最适合您的应用程序的百分比并不相同。