Sqlite

الإعلان عن التبعيات

لإضافة تبعية على SQLite، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف العناصر الاعتمادية الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

dependencies {
    def sqlite_version = "2.4.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"
}

dependencies {
    val sqlite_version = "2.4.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. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية عن طريق النقر على زر النجمة.

إنشاء مشكلة جديدة

راجِع مستندات أداة تتبُّع المشاكل للحصول على مزيد من المعلومات.

الإصدار 2.5

الإصدار 2.5.0-alpha11

30 تشرين الأول (أكتوبر) 2024

تم إصدار androidx.sqlite:sqlite-*:2.5.0-alpha11. يتضمّن الإصدار 2.5.0-alpha11 عمليات الربط هذه.

الإصدار 2.5.0-alpha10

16 أكتوبر 2024

تم إصدار androidx.sqlite:sqlite-*:2.5.0-alpha10. يتضمّن الإصدار 2.5.0-alpha10 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

• أضِف SQLiteStatement.getColumnType() مع الثوابت المختلفة للنتائج SQLITE_DATA_* لتفعيل استرداد نوع البيانات لعمود معيّن. (I1985c، b/369636251)

الإصدار 2.5.0-alpha09

2 أكتوبر 2024

تم إصدار androidx.sqlite:sqlite-*:2.5.0-alpha09. تحتوي الإصدار 2.5.0-alpha09 على عمليات التنفيذ هذه.

الإصدار 2.5.0-alpha08

18 أيلول (سبتمبر) 2024

تم إصدار androidx.sqlite:sqlite-*:2.5.0-alpha08. يتضمّن الإصدار 2.5.0-alpha08 عمليات الربط هذه.

الإصدار 2.5.0-alpha07

21 آب (أغسطس) 2024

تم إصدار androidx.sqlite:sqlite-*:2.5.0-alpha07. يحتوي الإصدار 2.5.0-alpha07 على عمليات الربط هذه.

الميزات الجديدة

• إضافة دعم للإصدار ARM 64 من Linux في أهداف JVM / سطح المكتب (b/358045505)

الإصدار 2.5.0-alpha06

7 آب (أغسطس) 2024

تم إصدار androidx.sqlite:sqlite-*:2.5.0-alpha06. يتضمّن الإصدار 2.5.0-alpha06 عمليات الربط هذه.

الميزات الجديدة

• إتاحة استخدام linuxArm64 Kotlin Multiplatform target (I139d3، b/338268719)

الإصدار 2.5.0-alpha05

10 تموز (يوليو) 2024

تم طرح androidx.sqlite:sqlite-*:2.5.0-alpha05. يتضمّن الإصدار 2.5.0-alpha05 عمليات الربط هذه.

التغييرات في واجهة برمجة التطبيقات

• تمت إعادة تسمية SQLiteKt إلى SQLite وBundledSQLiteKt إلى BundledSQLite. (I8b501)

الإصدار 2.5.0-alpha04

12 يونيو 2024

تم إصدار androidx.sqlite:sqlite-*:2.5.0-alpha04. يتضمّن الإصدار 2.5.0-alpha04 هذه المراجعات.

التغييرات في واجهة برمجة التطبيقات

• تمت إضافة واجهة برمجة تطبيقات open() لتحميل الزائد إلى BundledSQLiteDriver لتمرير علامات الفتح عند فتح اتصال بقاعدة بيانات. يكون هذا الخيار مفيدًا لفتح قاعدة بيانات في وضع القراءة فقط أو استخدام الوضع الآمن لسلسلة المحادثات المتسلسلة بدلاً من وضع SQLite في وضع متعدد السلاسل (b/340949940).

إصلاح الأخطاء

• تم إصلاح مشكلة ربط في برنامج تشغيل SQLite المُدمَج الذي كان سيؤدي إلى ظهور UnsatisfiedLinkError بسبب عدم توفّر الرموز الذرية في أجهزة Android التي تعمل بمعالج ARM32. (b/341639198)
• تم إصلاح مشكلة في برامج التشغيل حيث يؤدي ربط صفيف بايت بطول صفيف صفر في عمود إلى ظهور قيمة فارغة عند القراءة منه.

الإصدار 2.5.0-alpha03

29 أيار (مايو) 2024

تم إصدار androidx.sqlite:sqlite-*:2.5.0-alpha03. يتضمّن الإصدار 2.5.0-alpha03 عمليات الربط هذه.

إصلاح الأخطاء

• تم إصلاح مشكلة في BundledSQLiteDriver حيث كانت قواعد البيانات التي تم إنشاؤها باستخدامها تحتوي على الحرف C غير القابل للإنهاء. (b/340822359)

الإصدار 2.5.0-alpha02

14 أيار (مايو) 2024

تم إصدار الإصدار androidx.sqlite:sqlite-*:2.5.0-alpha02 بدون أي تغييرات كبيرة منذ الإصدار 2.5.0-alpha01 . يتضمّن الإصدار 2.5.0-alpha02 عمليات الربط هذه.

الإصدار 2.5.0-alpha01

1 مايو 2024

تم إصدار androidx.sqlite:sqlite-*:2.5.0-alpha01. يحتوي الإصدار 2.5.0-alpha01 على عمليات الربط هذه.

الميزات الجديدة

• إتاحة التوافق مع الأنظمة الأساسية المتعددة المنصات (KMP) من Kotlin: مع إصدار الغرفة 2.7.0-alpha01، وهو الإصدار الأول من منصة KMP، تم أيضًا تحديث واجهات برمجة تطبيقات SQLite التي تتيح الغرفة لتكون KMP. تحتوي الحزمة andriodx.sqlite على ثلاث واجهات تحدّد واجهات برمجة تطبيقات SQLite ذات المستوى المنخفض: 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

18 تشرين الأول (أكتوبر) 2023

تم طرح الإصدارات 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

• تمّت إضافة إصلاحات أخطاء متنوّعة.

الإصدار 2.4.0-rc01

20 أيلول (سبتمبر) 2023

تم إصدار 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

23 آب (أغسطس) 2023

تم إصدار 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

9 آب (أغسطس) 2023

تم إصدار 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

‫21 حزيران (يونيو) 2023

تم طرح الإصدارات 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

22 آذار (مارس) 2023

تم إصدار 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 على هذه المراجعات.

إصلاح الأخطاء

• تم إصلاح NullPointerException يمكن أن يحدث في SupportSQLiteQueryBuilder. (5df8698)

الإصدار 2.3.1

الإصدار 2.3.1

22 آذار (مارس) 2023

تم إصدار androidx.sqlite:sqlite:2.3.1 وandroidx.sqlite:sqlite-framework:2.3.1 وandroidx.sqlite:sqlite-ktx:2.3.1. يحتوي الإصدار 2.3.1 على هذه الالتزامات.

إصلاح الأخطاء

• تجنَّب مشكلة في إطار العمل، حيث لا يتم إيقاف طلبات بحث SQL بعد تغيير المخطط أثناء عمليات نقل البيانات. سيضبط FrameworkSupportSQLiteOpenHelper الآن الحد الأدنى من ذاكرة التخزين المؤقت لعبارة SQL أثناء عمليات نقل البيانات لتجنُّب حدوث المشكلة. (0ad2a8f)
• تم إصلاح المشكلة المتمثلة في عدم توفُّر دليل ذاكرة التخزين المؤقت للاستخدام مع SupportSQLiteLock، وبالتالي يجب التعامل مع الملف الفارغ على نحو مناسب. (9d177dc)
• تم إصلاح مشكلة عدم عرض attachedDbs للقائمة الكاملة للقواعد البيانات المرفقة. (5f008e1)

الإصدار 2.3.0

الإصدار 2.3.0

11 كانون الثاني (يناير) 2023

تم إصدار 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، قد تواجه أخطاء عدم توافق المصدر إذا كانت مصادرك مكتوبة بلغة Kotlin وكان الرمز يستنتج قيمة قابلية القيمة للعدم غير الصحيحة. علاوة على ذلك، تم تحويل بعض طرق الحصول على البيانات إلى خصائص تتطلب بنية الوصول إلى الخصائص في ملفات Kotlin. يُرجى الإبلاغ عن الخطأ إذا كان هناك أي حالات عدم توافق كبيرة. (b/240707042)
• أضِف واجهة برمجة تطبيقات في إعدادات SupportSQLite's للسماح بفقدان البيانات أثناء آلية الاسترداد. (I1b830، b/215592732)
• تمت إضافة واجهة برمجة تطبيقات لقفل عمليات متعددة واستخدامها على مستوى FrameworkSQLite*، وذلك لحماية عمليات إنشاء قاعدة البيانات ونقل البيانات لأول مرة باستخدام عمليات متعددة. (Ied267، b/193182592)

الإصدار 2.3.0-rc01

7 كانون الأول (ديسمبر) 2022

تم إصدار 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 على هذه المراجعات.

إصلاح الأخطاء

• حلّ مشكلة NPE في SupportSQLiteQueryBuilder للأعمدة التي يمكن أن تحتوي على قيم فارغة (Ica8f5)

الإصدار 2.3.0-beta02

9 تشرين الثاني (نوفمبر) 2022

تم إصدار 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?>) لمطابقة سلوك صفيف Java. (b/253531073)

الإصدار 2.3.0-beta01

5 تشرين الأول (أكتوبر) 2022

تم إصدار 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 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

• تم تحويل جميع مصادر android.sqlite من Java إلى Kotlin. b/240707042
• من بين التغييرات البارزة في الإحالة الناجحة أنّ دوال التجبير التالية أصبحت سمات:
  • في SupportSQLiteDatabase:
  • attachedDbs
  • isDatabaseIntegrityOk
  • isDbLockedByCurrentThread
  • isOpen
  • isReadOnly
  • isWriteAheadLoggingEnabled
  • maximumSize
  • pageSize
  • path
  • version
  • في SupportSQLiteOpenHelper:
  • databaseName
  • readableDatabase
  • writableDatabase

الإصدار 2.3.0-alpha05

24 آب (أغسطس) 2022

تم إصدار 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 على هذه المراجعات.

التغييرات في واجهة برمجة التطبيقات

• تم تحويل مصادر مجموعة المكتبة androidx.sqlite من Java إلى لغة Kotlin. يُرجى العِلم أنّه بسبب عدم توفّر بعض التعليقات التوضيحية حول ما إذا كان الحقل nullable في حزمة androidx.sqlite، قد تواجه أخطاء عدم توافق مع المصدر إذا كانت مصادرك مكتوبة بلغة Kotlin وكان الرمز يستنتج قيمة nullable غير صحيحة. يُرجى الإبلاغ عن أي خطأ في حال حدوث أي عدم توافق كبير. (b/240707042)

الإصدار 2.3.0-alpha04

10 آب (أغسطس) 2022

تم إصدار 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 على هذه المراجعات.

التغييرات في واجهة برمجة التطبيقات

• تم تعديل سمة السماح بالقيمة الخالية (I29fbd)

الإصدار 2.3.0-alpha03

1 حزيران (يونيو) 2022

تم إصدار 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 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

• اجعل "androidx.sqlite.ProcessLock" محظورًا. يتم تحديد نطاق واجهة برمجة التطبيقات وتقتصر على وظيفتها ضمن androidx.sqlite، ويجب عدم استخدامها كقفل متعدد العمليات للأغراض العامة. (I1643f)

الإصدار 2.3.0-alpha02

6 نيسان (أبريل) 2022

تم إصدار 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

23 شباط (فبراير) 2022

تم طرح الإصدارات 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 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

• أضِف واجهة برمجة تطبيقات في إعدادات SupportSQLite للسماح بفقدان البيانات أثناء آلية الاسترداد. (I1b830، b/215592732)
• تمت إضافة واجهة برمجة تطبيقات لقفل عمليات متعددة واستخدامها على مستوى FrameworkSQLite*، لحماية عمليات إنشاء قاعدة البيانات لأول مرة وعمليات نقل البيانات باستخدام عمليات متعددة. (Ied267، b/193182592)

الإصدار 2.2.0

الإصدار 2.2.0

15 كانون الأول (ديسمبر) 2021

تم إصدار 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

أضِف طريقة تلقائية إلى execPerConnectionSQL() في SupportSQLiteDatabase.

الإصدار 2.2.0-rc01

1 كانون الأول (ديسمبر) 2021

تم إصدار 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

13 تشرين الأول (أكتوبر) 2021

تم إصدار 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 على هذه المراجعات.

• ما مِن تغييرات مقارنةً بالإصدار التجريبي السابق.

الإصدار 2.2.0-alpha02

21 تموز (يوليو) 2021

تم إصدار 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

16 حزيران (يونيو) 2021

تم طرح الإصدارات 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 على هذه المراجعات.

التغييرات في واجهة برمجة التطبيقات

• إضافة طريقة تلقائية لـ execPerConnectionSQL() في SupportSQLiteDatabase (I86326، b/172270145)

الإصدار 2.1.0

الإصدار 2.1.0

22 كانون الثاني (يناير) 2020

تم طرح الإصدارات 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

8 كانون الثاني (يناير) 2020

تم طرح androidx.sqlite:sqlite-*:2.1.0-rc01. يحتوي الإصدار 2.1.0-rc01 على هذه المراجعات.

هذا الإصدار مطابق لـ 2.1.0-beta01.

الإصدار 2.1.0-beta01

4 كانون الأول (ديسمبر) 2019

تم طرح الإصدارات 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

7 تشرين الثاني (نوفمبر) 2019

تم إصدار 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 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

• تمت إضافة خاصيّة جديدة إلى SupportSQLiteOpenHelper.Configuration باسم useNoBackupDirectory للإشارة إلى أنّه يجب إنشاء قاعدة بيانات مستندة إلى ملف وتحديد موقعها من الدليل الذي لا يتضمّن نُسخة احتياطية.

الإصدار 2.0.1

الإصدار 2.0.1

13 آذار (مارس) 2019

تم إصدار الإصدار 2.0.1 من مجموعة عناصر androidx.sqlite مع إصلاح خطأَين.

إصلاح الأخطاء

• تم حلّ مشكلتَين تعذّر فيهما على تطبيق FrameworkSQLiteOpenHelper استرداد البيانات بشكلٍ صحيح من قاعدة بيانات متعطّلة أو عملية نقل بيانات غير صحيحة أثناء الإعداد. (b/111504749 وb/111519144)