应用的兼容性预写式日志记录功能

Android 9 引入了 SQLiteDatabase 的一种特殊模式，称为“兼容性 WAL（预写日志记录）”，它允许数据库使用 journal_mode=WAL，同时保留每个数据库最多创建一个连接的行为。

默认情况下，系统会为应用的数据库启用兼容性 WAL，除非应用已执行以下任一操作：

  1. 通过调用 SQLiteDatabase.enableWriteAheadLogging 或 disableWriteAheadLogging 选择启用或停用了预写日志记录
  2. 通过调用以下内容明确请求了 journal 模式：SQLiteDatabase.OpenParams.setJournalMode(String mode)

启用 WAL journal 模式可显著提升性能并减少写入量。例如，在 ext4 文件系统中，WAL 可将写入速度提高至原来的 4 倍。

兼容性 WAL 默认处于启用状态，且无需任何额外的实现操作。

停用兼容性 WAL

如需停用兼容性 WAL 模式，请覆盖 db_compatibility_wal_supported 配置资源。

例如：

<bool name="db_compatibility_wal_supported">false</bool>

如果对于某些配置而言，WAL journal 模式的性能与原有回滚 journal 模式相比没有提升，您可能想为这种配置停用兼容性 WAL。例如，在 F2FS 文件系统中，虽然 SQLite 支持原子写入且 DELETE journal 性能与 WAL 类似，但 WAL 可以将写入量提高 10% 到 15%。

验证

要验证兼容性 WAL 模式，请从 CtsDatabaseTestCases 模块运行 CTS 测试。CTS 测试将在启用兼容性 WAL 后验证预期行为。