تحتوي مكتبة androidx.sqlite على واجهات مجرّدة بالإضافة إلى عمليات تنفيذ أساسية يمكن استخدامها لإنشاء مكتباتك الخاصة التي يمكنها الوصول إلى SQLite. يمكنك استخدام مكتبة Room التي توفّر طبقة تجريد فوق SQLite للسماح بالوصول إلى قاعدة البيانات بشكل أكثر فعالية مع الاستفادة من الإمكانات الكاملة لـ SQLite.
إعداد التبعيات
لإعداد SQLite في مشروع KMP، أضِف الاعتماديات الخاصة بالعناصر في ملف build.gradle.kts للوحدة:
[versions]
sqlite = "2.7.1"
[libraries]
# The SQLite Driver interfaces
androidx-sqlite = { module = "androidx.sqlite:sqlite", version.ref = "sqlite" }
# The bundled SQLite driver implementation
androidx-sqlite-bundled = { module = "androidx.sqlite:sqlite-bundled", version.ref = "sqlite" }
[plugins]
ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }
واجهات برمجة تطبيقات SQLite Driver
توفّر مجموعات مكتبات androidx.sqlite واجهات برمجة تطبيقات منخفضة المستوى للتواصل مع
مكتبة SQLite المضمّنة في المكتبة عند استخدام
androidx.sqlite:sqlite-bundled أو في النظام الأساسي المضيف، مثل Android أو iOS
عند استخدام androidx.sqlite:sqlite-framework. تتبع واجهات برمجة التطبيقات عن كثب الوظيفة الأساسية لواجهة برمجة تطبيقات SQLite C.
هناك ثلاث واجهات رئيسية:
-
SQLiteDriver: نقطة الدخول إلى SQLite، وتُستخدَم لفتح اتصالات قاعدة البيانات. -
SQLiteConnection: تمثّل العنصرsqlite3. -
SQLiteStatement: تمثّل العنصرsqlite3_stmt.
يعرض المثال التالي واجهات برمجة التطبيقات الأساسية:
fun main() { val databaseConnection = BundledSQLiteDriver().open("todos.db") databaseConnection.execSQL( "CREATE TABLE IF NOT EXISTS Todo (id INTEGER PRIMARY KEY, content TEXT)" ) databaseConnection.prepare( "INSERT OR IGNORE INTO Todo (id, content) VALUES (? ,?)" ).use { stmt -> stmt.bindInt(index = 1, value = 1) stmt.bindText(index = 2, value = "Try Room in the KMP project.") stmt.step() } databaseConnection.prepare("SELECT content FROM Todo").use { stmt -> while (stmt.step()) { println("Action item: ${stmt.getText(0)}") } } databaseConnection.close() }
على غرار واجهات SQLite C API، يتكوّن نمط الاستخدام الشائع من الخطوات التالية:
- افتح اتصال قاعدة بيانات باستخدام تنفيذ
SQLiteDriverالذي تم إنشاء مثيل له. - أعِدّ عبارة SQL باستخدام
SQLiteConnection.prepare. - نفِّذ
SQLiteStatementباتّباع الخطوات التالية:- اختياري: يمكنك ربط الوسيطات باستخدام دوال
bind*. - كرِّر العملية على مجموعة النتائج باستخدام الدالة
step. - اقرأ الأعمدة من مجموعة النتائج باستخدام دوال
get*.
- اختياري: يمكنك ربط الوسيطات باستخدام دوال
عمليات تنفيذ برامج التشغيل
يلخّص الجدول التالي عمليات تنفيذ برامج التشغيل المتاحة:
اسم الصف |
العناصر |
المنصات المتوافقة |
AndroidSQLiteDriver |
androidx.sqlite:sqlite-framework |
Android |
NativeSQLiteDriver |
androidx.sqlite:sqlite-framework |
iOS وMac وLinux |
BundledSQLiteDriver |
androidx.sqlite:sqlite-bundled |
Android وiOS وMac وLinux وJVM (أجهزة الكمبيوتر المكتبي) |
WebWorkerSQLiteDriver |
androidx.sqlite:sqlite-web |
JavaScript وWebAssembly (WasmJS) |
ننصح باستخدام طريقة التنفيذ BundledSQLiteDriver المتوفّرة في androidx.sqlite:sqlite-bundled. وتتضمّن مكتبة SQLite التي تم تجميعها من المصدر، ما يوفّر أحدث إصدار واتساقًا في جميع منصات KMP المتوافقة.
برنامج تشغيل SQLite وRoom
تُعدّ واجهات برمجة التطبيقات لبرامج التشغيل مفيدة للتفاعلات ذات المستوى المنخفض مع قاعدة بيانات SQLite. للحصول على مكتبة غنية بالميزات توفّر وصولاً أكثر فعالية إلى SQLite، ننصحك باستخدام Room.
يعتمد RoomDatabase على SQLiteDriver لإجراء عمليات قاعدة البيانات،
ويجب ضبط عملية التنفيذ باستخدام
RoomDatabase.Builder.setDriver. توفّر Room
RoomDatabase.useReaderConnection وRoomDatabase.useWriterConnection للوصول المباشر إلى اتصالات قاعدة البيانات المُدارة.
نقل البيانات إلى Kotlin Multiplatform
يجب نقل أي استخدام لمكوّنات واجهة برمجة التطبيقات SQLite API المنخفضة المستوى،
مثل واجهة SupportSQLiteDatabase، إلى مكوّنات SQLite Driver المكافئة.
Kotlin Multiplatform
إجراء معاملة باستخدام واجهة برمجة تطبيقات SQLiteConnection منخفضة المستوى
val connection: SQLiteConnection = BundledSQLiteDriver().open("todos.db") connection.execSQL("BEGIN IMMEDIATE TRANSACTION") try { // perform database operations in transaction. connection.execSQL("END TRANSACTION") } catch (t: Throwable) { connection.execSQL("ROLLBACK TRANSACTION") }
تنفيذ طلب بحث بدون نتيجة
val connection: SQLiteConnection = BundledSQLiteDriver().open("todos.db") connection.execSQL("ALTER TABLE ...")
تنفيذ طلب بحث يتضمّن نتيجة ولكن بدون وسيطات
val connection: SQLiteConnection = BundledSQLiteDriver().open("todos.db") connection.prepare("SELECT * FROM Pet").use { statement -> while (statement.step()) { // read columns. statement.getInt(0) statement.getText(1) } }
تنفيذ طلب بحث يتضمّن نتيجة ووسيطات
connection.prepare("SELECT * FROM Pet WHERE id = ?").use { statement -> statement.bindInt(1, id) if (statement.step()) { // row found, read columns. } else { // row not found. } }
على أجهزة Android فقط
إجراء معاملة باستخدام "SupportSQLiteDatabase"
val database: SupportSQLiteDatabase = ...
database.beginTransaction()
try {
// perform database operations in transaction
database.setTransactionSuccessful()
} finally {
database.endTransaction()
}
تنفيذ طلب بحث بدون نتيجة
val database: SupportSQLiteDatabase = ...
database.execSQL("ALTER TABLE ...")
تنفيذ طلب بحث يتضمّن نتيجة ولكن بدون وسيطات
val database: SupportSQLiteDatabase = ...
database.query("SELECT * FROM Pet").use { cursor ->
while (cursor.moveToNext()) {
// read columns
cursor.getInt(0)
cursor.getString(1)
}
}
تنفيذ طلب بحث يتضمّن نتيجة ووسيطات
database.query("SELECT * FROM Pet WHERE id = ?", id).use { cursor ->
if (cursor.moveToNext()) {
// row found, read columns
} else {
// row not found
}
}