此页面由 Cloud Translation API 翻译。

Sqlite

API 参考文档
androidx.sqlite.db
androidx.sqlite.db.framework

androidx.sqlite 库包含抽象接口和基本实现，可用于构建自己的库来访问 SQLite。

您可能想要考虑使用 Room 库，它在 SQLite 上提供了一个抽象层，让您能够在充分利用 SQLite 的强大功能的同时，获享更完善的数据库访问机制。

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
2025 年 6 月 18 日	2.5.2	-	-	-

声明依赖项

如需添加 SQLite 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 制品库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

dependencies {
    def sqlite_version = "2.5.2"

    // Java language implementation
    implementation "androidx.sqlite:sqlite:$sqlite_version"

    // Kotlin
    implementation "androidx.sqlite:sqlite-ktx:$sqlite_version"

    // Implementation of the AndroidX SQLite interfaces via the Android framework APIs.
    implementation "androidx.sqlite:sqlite-framework:$sqlite_version"
}

Kotlin

dependencies {
    val sqlite_version = "2.5.2"

    // Java language implementation
    implementation("androidx.sqlite:sqlite:$sqlite_version")

    // Kotlin
    implementation("androidx.sqlite:sqlite-ktx:$sqlite_version")

    // Implementation of the AndroidX SQLite interfaces via the Android framework APIs.
    implementation("androidx.sqlite:sqlite-framework:$sqlite_version")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

版本 2.5

Version 2.5.2

2025 年 6 月 18 日

发布了 androidx.sqlite:sqlite-*:2.5.2。版本 2.5.2 包含这些提交内容。

bug 修复

添加了缺少的 R8 / Proguard 规则，以防止 JNI / 外部函数被混淆处理。(b/421626199)
修复了以下 bug：SQL 中的前置注释会导致语句的执行方式与非读取查询相同。(b/413061402)

版本 2.5.1

2025 年 5 月 7 日

发布了 androidx.sqlite:sqlite-*:2.5.1。版本 2.5.1 包含这些提交内容。

API 变更

允许 androidx.sqlite:sqlite-bundled 通过名为 androidx.sqlite.driver.bundled.path 的系统属性从指定路径加载其原生组件。b/381282544

版本 2.5.0

2025 年 4 月 9 日

发布了 androidx.sqlite:sqlite-*:2.5.0。版本 2.5.0 包含这些提交内容。

自 2.4.0 以来的重要变更

Kotlin 多平台 (KMP) 支持：随着 Room KMP 版本 2.7.0 的发布，用于将 Room 作为 KMP 使用的 SQLite API 也已更新。软件包 andriodx.sqlite 包含三个用于定义低级 SQLite API 的接口：SQLiteDriver、SQLiteConnection 和 SQLiteStatement。工件 androidx.sqlite:sqlite-framework 提供适用于 Android 和 iOS 的原生接口实现，而 androidx.sqlite:sqlite-bundled 提供使用从源代码编译的 SQLite（也称为“捆绑的 SQLite”）的实现。如需详细了解 SQLite Driver API，请参阅官方 SQLite KMP 文档。

版本 2.5.0-rc03

2025 年 3 月 26 日

发布了 androidx.sqlite:sqlite-*:2.5.0-rc03。版本 2.5.0-rc03 包含这些提交内容。

bug 修复

还原了导致二进制文件中断且不兼容的更改，该更改错误地移除了 Room 等其他库使用的 SupportSQLiteCompat API (b/402796648)。

版本 2.5.0-rc02

2025 年 3 月 12 日

发布了 androidx.sqlite:sqlite-*:2.5.0-rc02，该版本与上个版本相比没有明显变化。版本 2.5.0-rc02 包含这些提交内容。

版本 2.5.0-rc01

2025 年 2 月 26 日

发布了 androidx.sqlite:sqlite-*:2.5.0-rc01。版本 2.5.0-rc01 包含这些提交内容。

bug 修复

修复了 JVM 的 androidx.sqlite 工件的 Gradle 元数据，该元数据会导致 JVM 项目解析 Android 变体并导致 NoClassDefFoundError: androidx/sqlite/SQLiteDriver（b/396148592 和 b/396184120）。

版本 2.5.0-beta01

2025 年 2 月 12 日

发布了 androidx.sqlite:sqlite-*:2.5.0-beta01，该版本与上个 Alpha 版相比没有明显变化。版本 2.5.0-beta01 包含这些提交内容。

版本 2.5.0-alpha13

2025 年 1 月 29 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha13。版本 2.5.0-alpha13 包含这些提交内容。

API 变更

移除了 androidx.sqlite.use，该函数现已在 stdlib 中替换为 Kotlin 的 AutoCloseable.use。（I470f0、b/315461431）
该库现在使用 Kotlin 2.0 进行编译，并且项目中至少需要 2.0 才能使用该库。（I8efb0、b/315461431、b/384600605）

bug 修复

将 BundledSQLiteDriver 的原生库加载移至延迟加载，并在打开第一个连接时加载，以避免在主线程中执行 IO 操作。（I78e92、b/363985585）

版本 2.5.0-alpha12

2024 年 12 月 11 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha12。版本 2.5.0-alpha12 包含这些提交内容。

版本 2.5.0-alpha11

2024 年 10 月 30 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha11。版本 2.5.0-alpha11 包含这些提交内容。

版本 2.5.0-alpha10

2024 年 10 月 16 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha10。版本 2.5.0-alpha10 包含这些提交内容。

API 变更

添加了 SQLiteStatement.getColumnType() 以及各种 SQLITE_DATA_* 结果常量，以便检索列的数据类型。（I1985c、b/369636251）

版本 2.5.0-alpha09

2024 年 10 月 2 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha09。版本 2.5.0-alpha09 包含这些提交内容。

版本 2.5.0-alpha08

2024 年 9 月 18 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha08。版本 2.5.0-alpha08 包含这些提交内容。

版本 2.5.0-alpha07

2024 年 8 月 21 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha07。版本 2.5.0-alpha07 包含这些提交内容。

新功能

在 JVM / 桌面平台目标中添加了对 Linux ARM 64 的支持。(b/358045505)

版本 2.5.0-alpha06

2024 年 8 月 7 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha06。版本 2.5.0-alpha06 包含这些提交内容。

新功能

添加了对 linuxArm64 Kotlin Multiplatform 目标的支持（I139d3、b/338268719）

版本 2.5.0-alpha05

2024 年 7 月 10 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha05。版本 2.5.0-alpha05 包含这些提交内容。

API 变更

将 SQLiteKt 重命名为 SQLite，将 BundledSQLiteKt 重命名为 BundledSQLite。(I8b501)

版本 2.5.0-alpha04

2024 年 6 月 12 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha04。版本 2.5.0-alpha04 包含这些提交内容。

API 变更

向 BundledSQLiteDriver 添加了 open() 重载 API，以便在打开数据库连接时传递打开标志。适用于以只读模式打开数据库或使用序列化线程安全模式（而不是捆绑的 SQLite 编译时使用的多线程模式）(b/340949940)。

bug 修复

修复了捆绑的 SQLite 驱动程序中的一个链接问题，该问题会导致由于搭载 ARM32 的 Android 设备中缺少原子符号而抛出 UnsatisfiedLinkError。(b/341639198)
修复了驱动程序中的一个问题，即将长度为零的字节数组绑定到列中会导致从该列读取时出现 null 值。

版本 2.5.0-alpha03

2024 年 5 月 29 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha03。版本 2.5.0-alpha03 包含这些提交内容。

bug 修复

修复了 BundledSQLiteDriver 存在的问题，即使用它创建的数据库会包含 C 语言 null 终止符字符。(b/340822359)

版本 2.5.0-alpha02

2024 年 5 月 14 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha02，该版本与 2.5.0-alpha01 相比没有重大变化。版本 2.5.0-alpha02 包含这些提交内容。

版本 2.5.0-alpha01

2024 年 5 月 1 日

发布了 androidx.sqlite:sqlite-*:2.5.0-alpha01。版本 2.5.0-alpha01 包含这些提交内容。

新功能

Kotlin 多平台 (KMP) 支持：随着 Room 2.7.0-alpha01（Room KMP 的第一个版本）的发布，用于将 Room 转换为 KMP 的 SQLite API 也已更新。软件包 andriodx.sqlite 包含三个用于定义低级 SQLite API 的接口：SQLiteDriver、SQLiteConnection 和 SQLiteStatement。工件 androidx.sqlite:sqlite-framework 提供 Android 和 iOS 原生接口的实现，而 androidx.sqlite:sqlite-bundled 提供使用从源代码编译的 SQLite 的实现（也称为“捆绑的 SQLite”）。如需详细了解 SQLite Driver API，请参阅官方 SQLite KMP 文档。

版本 2.4

版本 2.4.0

2023 年 10 月 18 日

发布了 androidx.sqlite:sqlite:2.4.0、androidx.sqlite:sqlite-framework:2.4.0 和 androidx.sqlite:sqlite-ktx:2.4.0。版本 2.4.0 中包含这些提交内容。

自 2.3.0 以来的重要变更

添加了各种 bug 修复。

版本 2.4.0-rc01

2023 年 9 月 20 日

发布了 androidx.sqlite:sqlite:2.4.0-rc01、androidx.sqlite:sqlite-framework:2.4.0-rc01 和 androidx.sqlite:sqlite-ktx:2.4.0-rc01。版本 2.4.0-rc01 中包含这些提交内容。

版本 2.4.0-beta01

2023 年 8 月 23 日

发布了 androidx.sqlite:sqlite:2.4.0-beta01、androidx.sqlite:sqlite-framework:2.4.0-beta01 和 androidx.sqlite:sqlite-ktx:2.4.0-beta01。版本 2.4.0-beta01 中包含这些提交内容。

版本 2.4.0-alpha03

2023 年 8 月 9 日

发布了 androidx.sqlite:sqlite:2.4.0-alpha03、androidx.sqlite:sqlite-framework:2.4.0-alpha03 和 androidx.sqlite:sqlite-ktx:2.4.0-alpha03。版本 2.4.0-alpha03 中包含这些提交内容。

版本 2.4.0-alpha02

2023 年 6 月 21 日

发布了 androidx.sqlite:sqlite:2.4.0-alpha02、androidx.sqlite:sqlite-framework:2.4.0-alpha02 和 androidx.sqlite:sqlite-ktx:2.4.0-alpha02，这些版本没有任何变化。版本 2.4.0-alpha02 中包含这些提交内容。

版本 2.4.0-alpha01

2023 年 3 月 22 日

发布了 androidx.sqlite:sqlite:2.4.0-alpha01、androidx.sqlite:sqlite-framework:2.4.0-alpha01 和 androidx.sqlite:sqlite-ktx:2.4.0-alpha01。版本 2.4.0-alpha01 中包含这些提交内容。

bug 修复

修复了 SupportSQLiteQueryBuilder 中可能发生的 NullPointerException。(5df8698)

版本 2.3.1

2023 年 3 月 22 日

发布了 androidx.sqlite:sqlite:2.3.1、androidx.sqlite:sqlite-framework:2.3.1 和 androidx.sqlite:sqlite-ktx:2.3.1。版本 2.3.1 中包含这些提交内容。

bug 修复

避免了以下框架问题：在迁移期间架构发生更改后，SQL 查询不会失效。FrameworkSupportSQLiteOpenHelper 现在会在迁移期间设置最小 SQL 语句缓存，以避免出现此问题。(0ad2a8f)
修复了缓存目录可能无法用于 SupportSQLiteLock 的问题，因此必须妥善处理 null 文件。(9d177dc)
修复了 attachedDbs 未返回已附加数据库的完整列表的问题。(5f008e1)

版本 2.3.0

2023 年 1 月 11 日

发布了 androidx.sqlite:sqlite:2.3.0、androidx.sqlite:sqlite-framework:2.3.0 和 androidx.sqlite:sqlite-ktx:2.3.0。版本 2.3.0 中包含这些提交内容。

自 2.2.0 以来的重要变更

库组 androidx.sqlite 源代码已从 Java 转换为 Kotlin。请注意，由于 androidx.sqlite 缺少一些可为 null 性注解，因此如果您的源代码使用 Kotlin 并且代码推断出的可为 null 性结果有误，您可能会遇到源代码不兼容错误。此外，某些 getter 方法已转换为需要在 Kotlin 文件中使用属性访问语法的属性。如果存在任何严重的不兼容问题，请提交 bug。(b/240707042)
在 SupportSQLite's 的配置中添加了一个 API，以允许在恢复机制运行期间丢失数据。（I1b830、b/215592732）
添加了用于多进程锁定的 API，支持在 FrameworkSQLite* 级别使用，以保护多进程首次数据库创建和迁移。（Ied267、b/193182592）

版本 2.3.0-rc01

2022 年 12 月 7 日

发布了 androidx.sqlite:sqlite:2.3.0-rc01、androidx.sqlite:sqlite-framework:2.3.0-rc01 和 androidx.sqlite:sqlite-ktx:2.3.0-rc01。版本 2.3.0-rc01 中包含这些提交内容。

bug 修复

解决了 SupportSQLiteQueryBuilder 中可为 null 的列出现的 NPE 问题。(Ica8f5)

版本 2.3.0-beta02

2022 年 11 月 9 日

发布了 androidx.sqlite:sqlite:2.3.0-beta02、androidx.sqlite:sqlite-framework:2.3.0-beta02 和 androidx.sqlite:sqlite-ktx:2.3.0-beta02。版本 2.3.0-beta02 中包含这些提交内容。

修复了将查询参数从不变 (Array<Any?>) 提取到逆变 (Array<out Any?>) 的各种 API，以匹配 Java 的数组行为。(b/253531073)

版本 2.3.0-beta01

2022 年 10 月 5 日

发布了 androidx.sqlite:sqlite:2.3.0-beta01、androidx.sqlite:sqlite-framework:2.3.0-beta01 和 androidx.sqlite:sqlite-ktx:2.3.0-beta01。版本 2.3.0-beta01 中包含这些提交内容。

API 变更

所有 android.sqlite 源代码都已从 Java 转换为 Kotlin。b/240707042
转换的一个显著变化是以下 getter 函数已变为属性：
- 在 SupportSQLiteDatabase 中：
- attachedDbs
- isDatabaseIntegrityOk
- isDbLockedByCurrentThread
- isOpen
- isReadOnly
- isWriteAheadLoggingEnabled
- maximumSize
- pageSize
- path
- version
- 在 SupportSQLiteOpenHelper 中：
- databaseName
- readableDatabase
- writableDatabase

版本 2.3.0-alpha05

2022 年 8 月 24 日

发布了 androidx.sqlite:sqlite:2.3.0-alpha05、androidx.sqlite:sqlite-framework:2.3.0-alpha05 和 androidx.sqlite:sqlite-ktx:2.3.0-alpha05。版本 2.3.0-alpha05 中包含这些提交内容。

API 变更

库组 androidx.sqlite 源代码已从 Java 转换为 Kotlin。请注意，由于 androidx.sqlite 缺少一些可为 null 性注解，因此如果您的源代码使用 Kotlin 并且代码推断出的可为 null 性结果有误，您可能会遇到源代码不兼容错误。如果存在任何严重的不兼容问题，请提交 bug。(b/240707042)

版本 2.3.0-alpha04

2022 年 8 月 10 日

发布了 androidx.sqlite:sqlite:2.3.0-alpha04、androidx.sqlite:sqlite-framework:2.3.0-alpha04 和 androidx.sqlite:sqlite-ktx:2.3.0-alpha04。版本 2.3.0-alpha04 中包含这些提交内容。

API 变更

更新了可为 null 性 (I29fbd)

版本 2.3.0-alpha03

2022 年 6 月 1 日

发布了 androidx.sqlite:sqlite:2.3.0-alpha03、androidx.sqlite:sqlite-framework:2.3.0-alpha03 和 androidx.sqlite:sqlite-ktx:2.3.0-alpha03。版本 2.3.0-alpha03 中包含这些提交内容。

API 变更

对 androidx.sqlite.ProcessLock 进行了限定。该 API 的作用域被限定为 androidx.sqlite 内的函数，不应用作通用多进程锁。(I1643f)

版本 2.3.0-alpha02

2022 年 4 月 6 日

发布了 androidx.sqlite:sqlite:2.3.0-alpha02、androidx.sqlite:sqlite-framework:2.3.0-alpha02 和 androidx.sqlite:sqlite-ktx:2.3.0-alpha02。版本 2.3.0-alpha02 中包含这些提交内容。

自 2.3.0-alpha01 以来无重大更改。

版本 2.3.0-alpha01

2022 年 2 月 23 日

发布了 androidx.sqlite:sqlite:2.3.0-alpha01、androidx.sqlite:sqlite-framework:2.3.0-alpha01 和 androidx.sqlite:sqlite-ktx:2.3.0-alpha01。版本 2.3.0-alpha01 中包含这些提交内容。

API 变更

在 SupportSQLite 的配置中添加了一个 API，以允许在恢复机制运行期间丢失数据。（I1b830、b/215592732）
添加了用于多进程锁定的 API，支持在 FrameworkSQLite* 级别使用，以保护多进程首次数据库创建和迁移。（Ied267、b/193182592）

版本 2.2.0

2021 年 12 月 15 日

发布了 androidx.sqlite:sqlite:2.2.0、androidx.sqlite:sqlite-framework:2.2.0 和 androidx.sqlite:sqlite-ktx:2.2.0。版本 2.2.0 中包含这些提交内容。

自 2.1.0 以来的重要变更

在 SupportSQLiteDatabase 中为 execPerConnectionSQL() 添加了默认方法。

版本 2.2.0-rc01

2021 年 12 月 1 日

发布了 androidx.sqlite:sqlite:2.2.0-rc01、androidx.sqlite:sqlite-framework:2.2.0-rc01 和 androidx.sqlite:sqlite-ktx:2.2.0-rc01。版本 2.2.0-rc01 中包含这些提交内容。

自 2.2.0-beta01 以来无重大更改。

版本 2.2.0-beta01

2021 年 10 月 13 日

发布了 androidx.sqlite:sqlite:2.2.0-beta01、androidx.sqlite:sqlite-framework:2.2.0-beta01 和 androidx.sqlite:sqlite-ktx:2.2.0-beta01。版本 2.2.0-beta01 中包含这些提交内容。

与之前的 Alpha 版本相比没有变化。

版本 2.2.0-alpha02

2021 年 7 月 21 日

发布了 androidx.sqlite:sqlite:2.2.0-alpha02、androidx.sqlite:sqlite-framework:2.2.0-alpha02 和 androidx.sqlite:sqlite-ktx:2.2.0-alpha02。版本 2.2.0-alpha02 中包含这些提交内容。

自 2.2.0-alpha01 以来无重大更改。发布此版本只是为了与 Room 2.4.0-alpha04 版本保持一致。

版本 2.2.0-alpha01

2021 年 6 月 16 日

发布了 androidx.sqlite:sqlite:2.2.0-alpha01、androidx.sqlite:sqlite-framework:2.2.0-alpha01 和 androidx.sqlite:sqlite-ktx:2.2.0-alpha01。版本 2.2.0-alpha01 中包含这些提交内容。

API 变更

在 SupportSQLiteDatabase 中添加了 execPerConnectionSQL() 的默认方法（I86326、b/172270145）

版本 2.1.0

2020 年 1 月 22 日

发布了 androidx.sqlite:sqlite:2.1.0、androidx.sqlite:sqlite-framework:2.1.0 和 androidx.sqlite:sqlite-ktx:2.1.0，这三个版本与 2.1.0-rc01 相比没有变化。版本 2.1.0 中包含这些提交内容。

自 2.0.1 以来的重要变更

支持 useNoBackupDirectory，您可以使用它来指示在使用 SupportSQLiteOpenHelper 时应在无备份目录中创建数据库。

版本 2.1.0-rc01

2020 年 1 月 8 日

发布了 androidx.sqlite:sqlite-*:2.1.0-rc01。版本 2.1.0-rc01 中包含这些提交内容。

此版本与 2.1.0-beta01 完全相同。

版本 2.1.0-beta01

2019 年 12 月 4 日

发布了 androidx.sqlite:sqlite:2.1.0-beta01、androidx.sqlite:sqlite-framework:2.1.0-beta01 和 androidx.sqlite:sqlite-ktx:2.1.0-beta01，这三个版本与 2.1.0-alpha01 相比没有变化。版本 2.1.0-beta01 中包含这些提交内容。

版本 2.1.0-alpha01

2019 年 11 月 7 日

发布了 androidx.sqlite:sqlite:2.1.0-alpha01、androidx.sqlite:sqlite-framework:2.1.0-alpha01 和 androidx.sqlite:sqlite-ktx:2.1.0-alpha01。版本 2.1.0-alpha01 中包含这些提交内容。

API 变更

向名为 useNoBackupDirectory 的 SupportSQLiteOpenHelper.Configuration 添加了一个新属性，以指示应创建一个基于文件的数据库，并且该数据库应位于无备份目录中。

版本 2.0.1

2019 年 3 月 13 日

发布了 androidx.sqlite 工件组的 2.0.1 版，该版本修复了两个 bug。

bug 修复

修复了 FrameworkSQLiteOpenHelper 无法从损坏的数据库正确恢复或在初始化期间出现错误迁移这两个问题。（b/111504749 和 b/111519144）