Sqlite

API リファレンス
androidx.sqlite.db
androidx.sqlite.db.framework

androidx.sqlite ライブラリには抽象的なインターフェースとともに基本的な実装が含まれており、これを使用して SQLite にアクセスする独自のライブラリを構築できます。

Room ライブラリの使用を検討することをおすすめします。このライブラリは SQLite に抽象化レイヤを提供することで、より強固なデータベースアクセスを実現し、SQLite の全機能を活用できるようにします。

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2022 年 6 月 1 日	2.2.0	-	-	2.3.0-alpha03

依存関係の宣言

SQLite への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    def sqlite_version = "2.2.0"

    // 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.2.0"

    // 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")
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 2.3.0

バージョン 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 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください。

API の変更

復元メカニズム中のデータ損失を許容するための API を SupportSQLite の設定に追加しました。（I1b830、b/215592732）
FrameworkSQLite* レベルでのマルチプロセスロックと使用のための API を追加し、マルチプロセスの最初のデータベース作成と移行を保護するようにしました。（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 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください。

以前のアルファ版からの変更はありません。

バージョン 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 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください。

2.0.1 以降の重要な変更

useNoBackupDirectory のサポート。これにより、SupportSQLiteOpenHelper 使用時に、バックアップなしのディレクトリにデータベースを作成することを示します。

バージョン 2.1.0-rc01

2020 年 1 月 8 日

androidx.sqlite:sqlite-*:2.1.0-rc01 がリリースされました。バージョン 2.1.0-rc01 に含まれる commit については、こちらをご覧ください。

このリリースは 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 に含まれる commit については、こちらをご覧ください。

バージョン 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 に含まれる commit については、こちらをご覧ください。

API の変更

バックアップがないディレクトリにファイルベースのデータベースを作成、配置する必要があることを示す、useNoBackupDirectory という新しいプロパティを SupportSQLiteOpenHelper.Configuration に追加しました。

バージョン 2.0.1

2019 年 3 月 13 日

androidx.sqlite アーティファクトグループのバージョン 2.0.1 がリリースされました。バグの修正は下記の 2 件です。

バグの修正

データベースが破損した場合、または初期化中に不正な移行が行われた場合に、FrameworkSQLiteOpenHelper が正常に復元できない問題を 2 件修正しました。（b/111504749、b/111519144）