Kareli

Kareli

Kullanıcı Rehberi

API Referansı
androidx.sqlite.db
androidx.sqlite.db.framework

androidx.sqlite kitaplığı soyut arayüzler ve temel arayüzler içeriyor kitaplıklarınızı oluşturmak için kullanılabilecek uygulamalar hakkında bilgi edinin. SQLite

Ekip üyelerinize Aşağıdakileri içeren Oda kitaplığı SQLite üzerinden soyutlama katmanı ile daha güçlü veritabanı erişimi ve SQLite'ın tam gücünden yararlanıyor.

Son Güncelleme	Kararlı Sürüm	Yayın Adayı	Beta Sürümü	Alfa Sürümü
21 Ağustos 2024	2.4.0	-	-	2.5.0-alfa07

Bağımlılıkları bildirme

SQLite'a bağımlılık eklemek için belirler. Google'ın Maven deposunu okuyun konulu videomuzu izleyin.

build.gradle dosyasına ihtiyacınız olan yapıların bağımlılıklarını ekleyin. uygulamanız veya modülünüz:

Eski

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

Kotlin

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

Bağımlılıklar hakkında daha fazla bilgi edinmek için Derleme bağımlılıkları ekleme bölümüne bakın.

Geri bildirim

Geri bildiriminiz Jetpack'i iyileştirmemize yardımcı olacaktır. Yeni sorunlarla karşılaşırsanız veya fikir edinebilirsiniz. Daha fazla bilgi için lütfen mevcut sorunlar tıklayın. Oyunuzu mevcut bir soruna eklemek için yıldız düğmesini tıklayın.

Yeni sayı oluştur

Sorun İzleyici dokümanlarına bakın konulu videomuzu izleyin.

Sürüm 2.5

Sürüm 2.5.0-alpha07

21 Ağustos 2024

androidx.sqlite:sqlite-*:2.5.0-alpha07 yayınlandı. Sürüm 2.5.0-alpha07 bu kaydetmeleri içerir.

Yeni Özellikler

• JVM / Masaüstü hedeflerinde Linux ARM 64 için destek eklendi. (b/358045505)

Sürüm 2.5.0-alpha06

7 Ağustos 2024

androidx.sqlite:sqlite-*:2.5.0-alpha06 yayınlandı. Sürüm 2.5.0-alpha06 bu kaydetmeleri içerir.

Yeni Özellikler

• linuxArm64 Kotlin Çoklu Platform hedefi (I139d3, b/338268719) için destek ekleyin

Sürüm 2.5.0-alpha05

10 Temmuz 2024

androidx.sqlite:sqlite-*:2.5.0-alpha05 yayınlandı. Sürüm 2.5.0-alpha05 bu kaydetmeleri içerir.

API Değişiklikleri

• SQLiteKt adlı dosya SQLite ve BundledSQLiteKt adlı dosya BundledSQLite olarak yeniden adlandırıldı. (I8b501)

Sürüm 2.5.0-alpha04

12 Haziran 2024

androidx.sqlite:sqlite-*:2.5.0-alpha04 yayınlandı. Sürüm 2.5.0-alpha04 bu kaydetmeleri içerir.

API Değişiklikleri

• Veritabanı bağlantısı açılırken açık işaretleri iletmek için BundledSQLiteDriver uygulamasına open() aşırı yükleme API'si eklendi. Bir veritabanını salt okuma modunda açmak veya çok iş parçacığı modunda paketlenen SQLite'ın (b/340949940) derlendiği yerine, serileştirilmiş iş parçacığı güvenli modunu kullanmak için kullanışlıdır.

Hata Düzeltmeleri

• ARM32 yüklü Android cihazlarda eksik atom simgeleri nedeniyle UnsatisfiedLinkError ürününün atılmasına neden olan Paketli SQLite Sürücüsü'ndeki bağlantı sorunu düzeltildi. (b/341639198)
• Sürücülerde, sıfır uzunluktaki bir bayt dizisini bir sütuna bağlamanın, sütundan okuma yaparken boş değere yol açması sorunu düzeltildi.

Sürüm 2.5.0-alpha03

29 Mayıs 2024

androidx.sqlite:sqlite-*:2.5.0-alpha03 yayınlandı. Sürüm 2.5.0-alpha03 bu kaydetmeleri içerir.

Hata Düzeltmeleri

• BundledSQLiteDriver ile oluşturulan veritabanlarının C null sonlandırıcı karakterini içermesine neden olan sorunu düzeltin. (b/340822359)

Sürüm 2.5.0-alpha02

14 Mayıs 2024

androidx.sqlite:sqlite-*:2.5.0-alpha02, 2.5.0-alpha01 sürümünden bu yana önemli bir değişiklik yapılmadan yayınlandı . Sürüm 2.5.0-alpha02 bu kaydetmeleri içerir.

Sürüm 2.5.0-alpha01

1 Mayıs 2024

androidx.sqlite:sqlite-*:2.5.0-alpha01 yayınlandı. Sürüm 2.5.0-alpha01 bu kaydetmeleri içerir.

Yeni Özellikler

• Kotlin Çoklu Platform (KMP) Desteği: Room KMP'nin ilk sürümü olan Room 2.7.0-alpha01'in kullanıma sunulmasıyla birlikte, Room'da KMP olmasını sağlayan SQLite API'leri de güncellendi. andriodx.sqlite paketi, alt düzey SQLite API'lerini tanımlayan üç arayüz içeriyor: SQLiteDriver, SQLiteConnection ve SQLiteStatement. androidx.sqlite:sqlite-framework yapısı, Android ve iOS arayüzlerinin Yerel olarak uygulanmasını sunarken androidx.sqlite:sqlite-bundled, kaynaktan derlenen SQLite ("paketlenmiş SQLite") kullanan bir uygulama sunar. SQLite Driver API hakkında daha fazla bilgi edinmek için resmi SQLite KMP belgelerini inceleyin.

Sürüm 2.4

Sürüm 2.4.0

18 Ekim 2023

androidx.sqlite:sqlite:2.4.0, androidx.sqlite:sqlite-framework:2.4.0 ve androidx.sqlite:sqlite-ktx:2.4.0 serbest bırakıldı. 2.4.0 sürümü bu kaydetmeleri içerir.

2.3.0'dan bu yana önemli değişiklikler

• Çeşitli hata düzeltmeleri eklendi.

Sürüm 2.4.0-rc01

20 Eylül 2023

androidx.sqlite:sqlite:2.4.0-rc01, androidx.sqlite:sqlite-framework:2.4.0-rc01 ve androidx.sqlite:sqlite-ktx:2.4.0-rc01 serbest bırakıldı. Sürüm 2.4.0-rc01 bu kaydetmeleri içerir.

Sürüm 2.4.0-beta01

23 Ağustos 2023

androidx.sqlite:sqlite:2.4.0-beta01, androidx.sqlite:sqlite-framework:2.4.0-beta01 ve androidx.sqlite:sqlite-ktx:2.4.0-beta01 serbest bırakıldı. Sürüm 2.4.0-beta01 bu kaydetmeleri içerir.

Sürüm 2.4.0-alpha03

9 Ağustos 2023

androidx.sqlite:sqlite:2.4.0-alpha03, androidx.sqlite:sqlite-framework:2.4.0-alpha03 ve androidx.sqlite:sqlite-ktx:2.4.0-alpha03 serbest bırakıldı. 2.4.0-alpha03 sürümü bu kaydetmeleri içerir.

Sürüm 2.4.0-alpha02

21 Haziran 2023

androidx.sqlite:sqlite:2.4.0-alpha02, androidx.sqlite:sqlite-framework:2.4.0-alpha02 ve androidx.sqlite:sqlite-ktx:2.4.0-alpha02 hiçbir değişiklik yapılmadan serbest bırakıldı. 2.4.0-alpha02 sürümü bu kaydetmeleri içerir.

Sürüm 2.4.0-alpha01

22 Mart 2023

androidx.sqlite:sqlite:2.4.0-alpha01, androidx.sqlite:sqlite-framework:2.4.0-alpha01 ve androidx.sqlite:sqlite-ktx:2.4.0-alpha01 serbest bırakıldı. Sürüm 2.4.0-alpha01 bu kaydetmeleri içerir.

Hata Düzeltmeleri

• SupportSQLiteQueryBuilder içinde oluşabilecek bir NullPointerException düzeltildi. (5df8698)

Sürüm 2.3.1

Sürüm 2.3.1

22 Mart 2023

androidx.sqlite:sqlite:2.3.1, androidx.sqlite:sqlite-framework:2.3.1 ve androidx.sqlite:sqlite-ktx:2.3.1 serbest bırakıldı. Sürüm 2.3.1 bu kaydetmeleri içerir.

Hata Düzeltmeleri

• Taşıma sırasında bir şema değişikliğinden sonra SQL sorgularının geçersiz kılınmayacağı bir çerçeve sorunundan kaçının. FrameworkSupportSQLiteOpenHelper artık taşıma işlemi sırasında sorunun önüne geçmek için minimum SQL ifadesi önbelleğini ayarlayacak. (0ad2a8f)
• Önbellek dizininin SupportSQLiteLock için kullanılamamasına neden olan sorun düzeltildi. Bu nedenle boş bir dosyanın ayrıntılı bir şekilde işlenmesi gerekir. (9d177dc)
• attachedDbs ürününün ekli veritabanlarının tam listesini döndürmemesine neden olan sorun düzeltildi. (5f008e1)

Sürüm 2.3.0

Sürüm 2.3.0

11 Ocak 2023

androidx.sqlite:sqlite:2.3.0, androidx.sqlite:sqlite-framework:2.3.0 ve androidx.sqlite:sqlite-ktx:2.3.0 serbest bırakıldı. 2.3.0 sürümü bu kaydetmeleri içerir.

2.2.0'dan bu yana önemli değişiklikler

• androidx.sqlite kitaplık grubu kaynakları, Java'dan Kotlin'e dönüştürüldü. androidx.sqlite öğesinde bazı null değer ek açıklamaları eksik olduğundan, kaynaklarınız Kotlin'deyse ve kod yanlış null değeri çıkarıyorsa kaynak uyumsuzluğu hatalarıyla karşılaşabileceğinizi unutmayın. Ayrıca, belirli alıcı yöntemleri, Kotlin dosyalarında mülk erişimi söz dizimi gerektiren mülklere dönüştürüldü. Önemli uyumsuzluklar varsa lütfen hata bildiriminde bulunun. (b/240707042)
• Kurtarma mekanizması sırasında veri kaybına izin vermek için SupportSQLite's yapılandırmasına bir API ekleyin. (I1b830, b/215592732)
• Çok işlemli ilk veritabanı oluşturma ve taşıma işlemlerini korumak amacıyla FrameworkSQLite* düzeyinde çoklu işlem kilidi ve kullanım için API eklendi. (Ied267, b/193182592)

Sürüm 2.3.0-rc01

7 Aralık 2022

androidx.sqlite:sqlite:2.3.0-rc01, androidx.sqlite:sqlite-framework:2.3.0-rc01 ve androidx.sqlite:sqlite-ktx:2.3.0-rc01 serbest bırakıldı. Sürüm 2.3.0-rc01 bu kaydetmeleri içerir.

Hata Düzeltmeleri

• Boş değer atanabilir sütunlar için SupportSQLiteQueryBuilder içindeki NPE sorunu çözülür. (Ica8f5)

Sürüm 2.3.0-beta02

9 Kasım 2022

androidx.sqlite:sqlite:2.3.0-beta02, androidx.sqlite:sqlite-framework:2.3.0-beta02 ve androidx.sqlite:sqlite-ktx:2.3.0-beta02 serbest bırakıldı. Sürüm 2.3.0-beta02 bu kaydetmeleri içerir.

• Java'nın dizi davranışıyla eşleştirmek için değişkenden (Array<Any?>) sorgu bağımsız değişkenine (Array<out Any?>) sorgu bağımsız değişkeni alan çeşitli API'leri düzeltin. (b/253531073)

Sürüm 2.3.0-beta01

5 Ekim 2022

androidx.sqlite:sqlite:2.3.0-beta01, androidx.sqlite:sqlite-framework:2.3.0-beta01 ve androidx.sqlite:sqlite-ktx:2.3.0-beta01 serbest bırakıldı. Sürüm 2.3.0-beta01 bu kaydetmeleri içerir.

API Değişiklikleri

• android.sqlite kaynaklarının tümü Java'dan Kotlin'e dönüştürüldü. b/240707042
• Dönüşümde dikkat çeken bir değişiklik, aşağıdaki alıcı işlevlerinin mülk haline gelmesidir:
  • SupportSQLiteDatabase ürününde:
  • attachedDbs
  • isDatabaseIntegrityOk
  • isDbLockedByCurrentThread
  • isOpen
  • isReadOnly
  • isWriteAheadLoggingEnabled
  • maximumSize
  • pageSize
  • path
  • version
  • SupportSQLiteOpenHelper ürününde:
  • databaseName
  • readableDatabase
  • writableDatabase

ziyaret edin.

Not: Kitaplığın Kotlin'e dönüştürülmesi nedeniyle kaynak uyuşmazlığı sorunları yaşayabilirsiniz. Kodunuz Kotlin'deyse ve belirli API'leri kullanıyorsa bu yeni sürüme güncelleme yapmak için kodunuzda değişiklik yapmanız gerekebilir. Özellikle yukarıda bahsedilen alıcı işlevlerinden herhangi biriyle geçersiz kılma içeren uygulamalarınız varsa bunları işlev değil, mülk alıcıları olarak geçersiz kılmanız gerekir.

Sürüm 2.3.0-alpha05

24 Ağustos 2022

androidx.sqlite:sqlite:2.3.0-alpha05, androidx.sqlite:sqlite-framework:2.3.0-alpha05 ve androidx.sqlite:sqlite-ktx:2.3.0-alpha05 serbest bırakıldı. 2.3.0-alpha05 sürümü bu kaydetmeleri içerir.

API Değişiklikleri

• androidx.sqlite kitaplık grubu kaynakları, Java'dan Kotlin'e dönüştürüldü. androidx.sqlite'ta bazı boş değer atanabilirlik ek açıklamaları eksik olduğundan, kaynaklarınız Kotlin'deyse ve kod yanlış null değeri çıkarıyorsa kaynak uyumsuzluğu hatalarıyla karşılaşabileceğinizi unutmayın. Önemli düzeyde uyumsuzluk varsa lütfen hata bildiriminde bulunun. (b/240707042)

Sürüm 2.3.0-alpha04

10 Ağustos 2022

androidx.sqlite:sqlite:2.3.0-alpha04, androidx.sqlite:sqlite-framework:2.3.0-alpha04 ve androidx.sqlite:sqlite-ktx:2.3.0-alpha04 serbest bırakıldı. 2.3.0-alpha04 sürümü bu kaydetmeleri içerir.

API Değişiklikleri

• Güncellenen geçersiz değer (I29fbd)

Sürüm 2.3.0-alpha03

1 Haziran 2022

androidx.sqlite:sqlite:2.3.0-alpha03, androidx.sqlite:sqlite-framework:2.3.0-alpha03 ve androidx.sqlite:sqlite-ktx:2.3.0-alpha03 serbest bırakıldı. 2.3.0-alpha03 sürümü bu kaydetmeleri içerir.

API Değişiklikleri

• androidx.sqlite.ProcessLock özelliğini kısıtlanmış hale getir. API'nin kapsamı geniştir ve androidx.sqlite içindeki işleviyle sınırlıdır. Bu API, genel amaçlı çok işlemli bir kilit olarak kullanılmamalıdır. (I1643f)

Sürüm 2.3.0-alpha02

6 Nisan 2022

androidx.sqlite:sqlite:2.3.0-alpha02, androidx.sqlite:sqlite-framework:2.3.0-alpha02 ve androidx.sqlite:sqlite-ktx:2.3.0-alpha02 serbest bırakıldı. 2.3.0-alpha02 sürümü bu kaydetmeleri içerir.

• 2.3.0-alpha01'den beri önemli bir değişiklik yok

Sürüm 2.3.0-alpha01

23 Şubat 2022

androidx.sqlite:sqlite:2.3.0-alpha01, androidx.sqlite:sqlite-framework:2.3.0-alpha01 ve androidx.sqlite:sqlite-ktx:2.3.0-alpha01 serbest bırakıldı. Sürüm 2.3.0-alpha01 bu kaydetmeleri içerir.

API Değişiklikleri

• Kurtarma mekanizması sırasında veri kaybına izin vermek için SupportSQLite yapılandırmasına bir API ekleyin. (I1b830, b/215592732)
• Çok işlemli ilk veritabanı oluşturma ve taşıma işlemlerini korumak amacıyla, FrameworkSQLite* düzeyinde çoklu işlem kilidi ve kullanım için API eklendi. (Ied267, b/193182592)

Sürüm 2.2.0

Sürüm 2.2.0

15 Aralık 2021

androidx.sqlite:sqlite:2.2.0, androidx.sqlite:sqlite-framework:2.2.0 ve androidx.sqlite:sqlite-ktx:2.2.0 serbest bırakıldı. 2.2.0 sürümü bu kaydetmeleri içerir.

2.1.0'dan bu yana önemli değişiklikler

SupportSQLiteDatabase bölgesinde execPerConnectionSQL() için varsayılan yöntem ekleyin.

Sürüm 2.2.0-rc01

1 Aralık 2021

androidx.sqlite:sqlite:2.2.0-rc01, androidx.sqlite:sqlite-framework:2.2.0-rc01 ve androidx.sqlite:sqlite-ktx:2.2.0-rc01 serbest bırakıldı. Sürüm 2.2.0-rc01 bu kaydetmeleri içerir.

2.2.0-beta01 sürümünden bu yana önemli bir değişiklik yapılmamıştır.

Sürüm 2.2.0-beta01

13 Ekim 2021

androidx.sqlite:sqlite:2.2.0-beta01, androidx.sqlite:sqlite-framework:2.2.0-beta01 ve androidx.sqlite:sqlite-ktx:2.2.0-beta01 serbest bırakıldı. Sürüm 2.2.0-beta01 bu kaydetmeleri içerir.

• Önceki alfa sürümde değişiklik yok.

Sürüm 2.2.0-alpha02

21 Temmuz 2021

androidx.sqlite:sqlite:2.2.0-alpha02, androidx.sqlite:sqlite-framework:2.2.0-alpha02 ve androidx.sqlite:sqlite-ktx:2.2.0-alpha02 serbest bırakıldı. 2.2.0-alpha02 sürümü bu kaydetmeleri içerir.

2.2.0-alpha01'den beri önemli bir değişiklik yok. Bu yayın, 2.4.0-alpha04 odasının iptaliyle uyumlu hale getirilmelidir.

Sürüm 2.2.0-alpha01

16 Haziran 2021

androidx.sqlite:sqlite:2.2.0-alpha01, androidx.sqlite:sqlite-framework:2.2.0-alpha01 ve androidx.sqlite:sqlite-ktx:2.2.0-alpha01 serbest bırakıldı. 2.2.0-alpha01 sürümü bu kaydetmeleri içerir.

API Değişiklikleri

• SupportSQLiteDatabase'de execPerConnectionSQL() için varsayılan yöntem ekleyin (I86326, b/172270145)

Sürüm 2.1.0

Not: Yeni androidx kitaplıklarının yeni sürümleri, api ve implementation bağımlılıklarını doğru şekilde yansıtıyor. Projeniz 2.1.0 sürümündeki bir implementation bağımlılığı üzerinden ortaya çıkan örtülü bir bağımlılığa dayanıyorsa build.gradle dosyanızda bu bağımlılığa açıkça bağımlı olmanız gerekir.

Sürüm 2.1.0

22 Ocak 2020

androidx.sqlite:sqlite:2.1.0, androidx.sqlite:sqlite-framework:2.1.0 ve androidx.sqlite:sqlite-ktx:2.1.0, 2.1.0-rc01 tarihinden bu yana hiçbir değişiklik yapılmadan yayınlandı. 2.1.0 sürümü bu kaydetmeleri içerir.

2.0.1'den bu yana önemli değişiklikler

• SupportSQLiteOpenHelper kullanılırken veritabanının yedek olmayan dizinde oluşturulması gerektiğini belirtmek için kullanılabilen useNoBackupDirectory desteği.

Sürüm 2.1.0-rc01

8 Ocak 2020

androidx.sqlite:sqlite-*:2.1.0-rc01 yayınlandı. Sürüm 2.1.0-rc01 bu kaydetmeleri içerir.

Bu sürüm, 2.1.0-beta01 ile aynı.

Sürüm 2.1.0-beta01

4 Aralık 2019

androidx.sqlite:sqlite:2.1.0-beta01, androidx.sqlite:sqlite-framework:2.1.0-beta01 ve androidx.sqlite:sqlite-ktx:2.1.0-beta01, 2.1.0-alpha01 tarihinden bu yana hiçbir değişiklik yapılmadan yayınlandı. Sürüm 2.1.0-beta01 bu kaydetmeleri içerir.

Sürüm 2.1.0-alpha01

7 Kasım 2019

androidx.sqlite:sqlite:2.1.0-alpha01, androidx.sqlite:sqlite-framework:2.1.0-alpha01 ve androidx.sqlite:sqlite-ktx:2.1.0-alpha01 serbest bırakıldı. 2.1.0-alpha01 sürümü bu kaydetmeleri içerir.

API değişiklikleri

• SupportSQLiteOpenHelper.Configuration öğesine, dosya tabanlı bir veritabanı oluşturulması ve yedek olmayan dizinden bulunması gerektiğini belirtmek için useNoBackupDirectory adlı yeni bir özellik eklendi.

Sürüm 2.0.1

Sürüm 2.0.1

13 Mart 2019

androidx.sqlite yapı grubunun 2.0.1 sürümü iki hata düzeltmesiyle yayınlandı.

Hata Düzeltmeleri

• FrameworkSQLiteOpenHelper ürününün bozuk bir veritabanından düzgün şekilde kurtarılamamasına veya başlatma sırasında hatalı bir taşıma işlemine neden olan iki sorun düzeltildi. (b/111504749 ve b/111519144)