减少 Realm 文件大小 — Swift SDK

避免固定交易

Realm 将读取事务生命周期与 Realm 实例的内存生命周期联系起来。避免“锁定的”旧 Realm 事务。使用自动刷新 Realm，把后台线程中 Realm API 的使用包装在显式自动释放池中。

线程

Realm 会在运行循环迭代开始时更新它访问的数据版本。虽然它可以让您获得一致的数据视图，但它会影响文件大小。

试想以下场景：

• 线程 A：从 Realm 读取一些数据，然后不让该线程参与处理长时间执行的操作。

• 线程B：在另一个线程上写入数据。

• 线程 A：读线程上的版本未更新。Realm 必须保存该数据的中间版本，因而文件大小会随着每次写入而增大。

要避免此问题，请在 Realm 上调用invalidate() 。这向 Realm 表明您不再需要到目前为止已读取的对象。这样 Realm 就无需跟踪这些对象的中间版本。下次访问时，Realm 将拥有最新版本的对象。

您还可以使用以下两种方法来压缩 Realm：

• 在配置中设置shouldCompactOnLaunch

• 使用writeCopy(toFile:encryptionKey:)

调度队列

使用 Grand Central Dispatch 访问 Realm 时 ，您可能会看到类似的文件增长。执行代码时，调度队列的自动释放池可能不会立即耗尽。在调度池释放 Realm 对象之前，Realm 无法重用数据的中间版本。从调度队列访问 Realm 时，请使用显式自动释放池。

异步压缩 Realm

使用 Swift async/await 语法异步打开 Realm 时，可以在后台压缩 Realm。

func testAsyncCompact() async {
    let config = Realm.Configuration(shouldCompactOnLaunch: { totalBytes, usedBytes in
        // 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 100MB in size and less than 50% 'used'
        let oneHundredMB = 100 * 1024 * 1024
        return (totalBytes > oneHundredMB) && (Double(usedBytes) / Double(totalBytes)) < 0.5
    })
    do {
        // Realm is compacted asynchronously on the first open if the
        // configuration block conditions were met.
        let realm = try await Realm(configuration: config)
    } catch {
        // handle error compacting or opening Realm
    }
}

从 Realm Swift SDK 10.15.0 和 10.16.0 版本开始，很多 Realm API 均支持 Swift“异步/等待”语法。项目必须符合以下要求：

如果您的应用会在 async/await 上下文中访问 Realm，请使用 @MainActor 来标记此代码，从而避免出现与线程相关的崩溃。

制作压缩副本

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

手动压缩的技巧

压缩 Realm 可能是一项代价高昂的操作，可能会阻塞用户界面线程。应用程序不应在每次打开 Realm 时都执行压缩操作。相反，应尝试优化压缩，使应用程序能够定期执行压缩操作，防止文件过大。如果您的应用程序在资源有限的环境下运行，您可能需要在文件达到特定大小或文件大小对性能产生负面影响时进行压缩。

这些建议可以帮助您优化应用程序的手动压缩：

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

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

在您的 shouldCompactOnLaunch 回调中，这些计算可能如下所示：

// Set a maxFileSize equal to 20MB in bytes
let maxFileSize = 20 * 1024 * 1024
// Check for the realm file size to be greater than the max file size,
// and the amount of bytes currently used to be less than 50% of the
// total realm file size
return (realmFileSizeInBytes > maxFileSize) && (Double(usedBytes) / Double(realmFileSizeInBytes)) < 0.5

测试各种条件，确定在应用程序中压缩 Realm 文件的频率，以实现平衡。