Oda

Room kalıcılık kitaplığı, SQLite'ın tüm gücünden yararlanırken daha sağlam veritabanı erişimi sağlamak için SQLite üzerinde bir soyutlama katmanı sağlar.
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
9 Eylül 2026 2.8.5 - - -

Bağımlılıkları bildirme

Room'a bağımlılık eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposu sayfasını okuyun.

Room bağımlılıkları arasında Room taşıma işlemlerini test etme ve Room RxJava yer alır.

Uygulamanız veya modülünüz için build.gradle dosyasında ihtiyacınız olan yapıların bağımlılıklarını ekleyin:

Kotlin

dependencies {
    val room_version = "2.8.5"

    implementation("androidx.room:room-runtime:$room_version")

    // If this project uses any Kotlin source, use Kotlin Symbol Processing (KSP)
    // See Add the KSP plugin to your project
    ksp("androidx.room:room-compiler:$room_version")

    // If this project only uses Java source, use the Java annotationProcessor
    // No additional plugins are necessary
    annotationProcessor("androidx.room:room-compiler:$room_version")

    // optional - Kotlin Extensions and Coroutines support for Room
    implementation("androidx.room:room-ktx:$room_version")

    // optional - RxJava2 support for Room
    implementation("androidx.room:room-rxjava2:$room_version")

    // optional - RxJava3 support for Room
    implementation("androidx.room:room-rxjava3:$room_version")

    // optional - Guava support for Room, including Optional and ListenableFuture
    implementation("androidx.room:room-guava:$room_version")

    // optional - Test helpers
    testImplementation("androidx.room:room-testing:$room_version")

    // optional - Paging 3 Integration
    implementation("androidx.room:room-paging:$room_version")
}

Groovy

dependencies {
    def room_version = "2.8.5"

    implementation "androidx.room:room-runtime:$room_version"

    // If this project uses any Kotlin source, use Kotlin Symbol Processing (KSP)
    // See KSP Quickstart to add KSP to your build
    ksp "androidx.room:room-compiler:$room_version"

    // If this project only uses Java source, use the Java annotationProcessor
    // No additional plugins are necessary
    annotationProcessor "androidx.room:room-compiler:$room_version"

    // optional - RxJava2 support for Room
    implementation "androidx.room:room-rxjava2:$room_version"

    // optional - RxJava3 support for Room
    implementation "androidx.room:room-rxjava3:$room_version"

    // optional - Guava support for Room, including Optional and ListenableFuture
    implementation "androidx.room:room-guava:$room_version"

    // optional - Test helpers
    testImplementation "androidx.room:room-testing:$room_version"

    // optional - Paging 3 Integration
    implementation "androidx.room:room-paging:$room_version"
}

KAPT eklentisini kullanma hakkında bilgi için KAPT belgelerine bakın.

KSP eklentisini kullanma hakkında bilgi için KSP hızlı başlangıç belgelerine bakın.

Kotlin uzantılarını kullanma hakkında bilgi edinmek için ktx belgelerine bakın.

Bağımlılıklar hakkında daha fazla bilgi için Derleme Bağımlılıkları Ekleme başlıklı makaleyi inceleyin.

İsteğe bağlı olarak, Android dışı kitaplıklar (ör. yalnızca Java veya Kotlin Gradle modülleri) için Room ek açıklamalarını kullanmak üzere androidx.room:room-common'e bağımlı olabilirsiniz.

Derleyici Seçeneklerini Yapılandırma

Room'da aşağıdaki ek açıklama işleyici seçenekleri bulunur.

room.schemaLocation directory
Veritabanı şemalarının belirtilen dizindeki JSON dosyalarına aktarılmasını sağlar. Daha fazla bilgi için Oda Taşıma İşlemleri başlıklı makaleyi inceleyin.
room.incremental boolean
Gradle artımlı ek açıklama işleyicisini etkinleştirir. Varsayılan değer true'dir.
room.generateKotlin boolean
Java yerine Kotlin kaynak dosyaları oluşturun. KSP gerekir. 2.7.0 sürümünden itibaren varsayılan değer true'dir. Daha fazla bilgi için kullanıma sunulduğu 2.6.0 sürümü ile ilgili notlara bakın.

Room Gradle eklentisini kullanma

Room 2.6.0 ve sonraki sürümlerde, Room derleyicisinin seçeneklerini yapılandırmak için Room Gradle eklentisini kullanabilirsiniz. Eklenti, projeyi öyle yapılandırır ki oluşturulan şemalar (derleme görevlerinin çıktısı olan ve otomatik taşımalar için kullanılan şemalar), tekrarlanabilir ve önbelleğe alınabilir derlemelere sahip olacak şekilde doğru yapılandırılır.

Eklentiyi eklemek için üst düzey Gradle derleme dosyanızda eklentiyi ve sürümünü tanımlayın.

Modern

plugins {
    id 'androidx.room' version "$room_version" apply false
}

Kotlin

plugins {
    id("androidx.room") version "$room_version" apply false
}

Modül düzeyindeki Gradle derleme dosyasında eklentiyi uygulayın ve room uzantısını kullanın.

Modern

plugins {
    id 'androidx.room'
}

android {
    ...
    room {
        schemaDirectory "$projectDir/schemas"
    }
}

Kotlin

plugins {
    id("androidx.room")
}

android {
    ...
    room {
        schemaDirectory("$projectDir/schemas")
    }
}

Room Gradle eklentisini kullanırken schemaDirectory ayarlamanız gerekir. Bu işlem, Room derleyicisini ve çeşitli derleme görevleri ile arka uçlarını (javac, KAPT, KSP) şema dosyalarını varyant klasörlerine (ör. schemas/flavorOneDebug/com.package.MyDatabase/1.json) çıkaracak şekilde yapılandırır. Bu dosyalar, doğrulama ve otomatik taşıma işlemleri için kullanılmak üzere depoya eklenmelidir.

Bazı seçenekler, Room derleyicisi tarafından desteklense de Room Gradle eklentisinin tüm sürümlerinde yapılandırılamaz. Aşağıdaki tabloda her seçenek listelenmiş ve room uzantısını kullanarak bu seçeneği yapılandırma desteği ekleyen Room Gradle eklentisinin sürümü gösterilmiştir. Sürümünüz daha eskiyse veya bu seçenek henüz desteklenmiyorsa bunun yerine ek açıklama işleyici seçeneklerini kullanabilirsiniz.

Seçenek Şu sürümden itibaren:
room.schemaLocation (zorunlu) 2.6.0
room.incremental -
room.generateKotlin -

Ek açıklama işleyici seçeneklerini kullanma

Room Gradle eklentisini kullanmıyorsanız veya istediğiniz seçenek eklenti sürümünüz tarafından desteklenmiyorsa Derleme bağımlılıkları ekleme bölümünde açıklandığı gibi ek açıklama işleyicisi seçeneklerini kullanarak Room'u yapılandırabilirsiniz. Ek açıklama seçeneklerini nasıl belirteceğiniz, Room için KSP mi yoksa KAPT mi kullandığınıza bağlıdır.

Modern

// For KSP
ksp {
    arg("option_name", "option_value")
    // other otions...
}

// For javac and KAPT
android {
    ...
    defaultConfig {
        ...
        javaCompileOptions {
            annotationProcessorOptions {
                arguments += [
                    "option_name":"option_value",
                    // other options...
                    ]
            }
        }
    }
}

Kotlin

// For KSP
ksp {
    arg("option_name", "option_value")
    // other options...
}

// For javac and KAPT
android {
    ...
    defaultConfig {
        ...
        javaCompileOptions {
            annotationProcessorOptions {
                arguments += mapOf(
                    "option_name" to "option_value",
                    // other options...
                )
            }
        }
    }
}

room.schemaLocation, ilkel bir tür değil, dizin olduğundan bu seçeneği eklerken CommandLineArgumentsProvider kullanılması gerekir. Böylece Gradle, güncel kontrolleri yaparken bu dizini tanır. Oda veritabanınızı taşıma bölümünde, şema konumunu sağlayan CommandLineArgumentsProvider'nin eksiksiz bir uygulaması gösterilmektedir.

Geri bildirim

Geri bildirimleriniz Jetpack'i geliştirmemize yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir sorun için oy verebilirsiniz.

Yeni bir sorun oluşturma

Daha fazla bilgi için Issue Tracker belgelerine bakın.

Sürüm 2.8

Sürüm 2.8.5

9 Eylül 2026

androidx.room:room-*:2.8.5 yayınlandı. 2.8.5 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Room askıya alma sorguları ve geçersiz kılma izleyici işlemleri, veritabanı kapatıldıktan sonra çağrıldığında artık IllegalStateException hatası verecek. (Ic0166, b/543076356)

Sürüm 2.8.4

19 Kasım 2025

androidx.room:room-*:2.8.4 yayınlandı. 2.8.4 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • BundledSQLiteDriver gibi dahili bir havuzu olmayan bir SQLiteDriver kullanırken Room'un bağlantı havuzuna hazırlanmış bir ifade önbelleği eklendi. Bu, aynı SQL ifadesinin tekrar tekrar yürütülmesiyle performansı artırır. (5f43bc, b/319653917)
  • Şema doğrulamasındaki gerçek/beklenen hata mesajında bilgilerin eksik olmasına neden olan sorun düzeltildi. (8b23da, b/454531083)
  • Room'un Kotlin kod oluşturma işleminde tür değişkenleri içeren @Transaction DAO işlevlerinin eksik olmasıyla ilgili sorun düzeltildi. (a8365d, b/251316420)
  • SupportSQLiteDatabase API'leriyle aynı engelleme davranışını sürdüren iş parçacığı atlamalarından kaçınarak Room'un SupportSQLite sarmalayıcı performansını iyileştirin. (fc70e4)

Sürüm 2.8.3

22 Ekim 2025

androidx.room:room-*:2.8.3 yayınlandı. 2.8.3 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Room SQLite sarmalayıcısında, Cursor üzerinde iterasyon yaparken aşırı JNI çağrılarına ve önemli performans düşüşüne neden olan bir performans sorunu düzeltildi.

Sürüm 2.8.2

8 Ekim 2025

androidx.room:room-*:2.8.2 yayınlandı. 2.8.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Akış emisyonundan otomatik olarak kapatılan bir veritabanı yeniden açılırken oluşabilecek kilitlenme sorunu düzeltildi (b/446643789).

Sürüm 2.8.1

24 Eylül 2025

androidx.room:room-*:2.8.1 yayınlandı. 2.8.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Askıya alma lambda'sı içeren bir DAO işlevi işlenirken meydana gelen işlemci kilitlenmesi düzeltildi. (b/442220723).
  • Flows'un en son güncellemeyi almasını engelleyen bir yarışma durumu düzeltildi.

Sürüm 2.8.0

10 Eylül 2025

androidx.room:room-*:2.8.0 yayınlandı. 2.8.0 sürümü bu commit'leri içerir.

2.7.0 sürümünden sonra yapılan önemli değişiklikler:

  • Yapılandırılmış SQLiteDriver ile RoomDatabase'den SupportSQLiteDatabase sarmalayıcı almak için API'ler içeren yeni bir yapı androidx.room:room-sqlite-wrapper eklendi. Sarmalayıcıyı almak için yeni uzantı işlevi RoomDatabase.getSupportWrapper()'i kullanın. Bu, Room veritabanı bir SQLiteDriver ile yapılandırılmış olsa bile genellikle roomDatabase.openHelper.writableDatabase üzerinden elde edilen SupportSQLiteDatabase kullanımlarını sürdürmek için kullanılan bir uyumluluk yapısıdır. Bu sarmalayıcı, SQLiteDriver API'lerini kullanmak isteyen ancak SupportSQLite API'lerini yoğun bir şekilde kullanan ve BundledSQLiteDriver'dan yararlanmak isteyen kod tabanlarının aşamalı olarak taşınması için kullanışlıdır. Daha fazla bilgi için geçiş rehberine göz atın.
  • KMP hedefleri Watch OS ve Tv OS için destek eklendi.
  • Kitaplığın Android minSDK'sı API 21'den API 23'e güncellendi.

Sürüm 2.8.0-rc02

27 Ağustos 2025

androidx.room:room-*:2.8.0-rc02 yayınlandı. 2.8.0-rc02 sürümü bu kayıtları içerir.

API Değişiklikleri

Hata Düzeltmeleri

  • Önceden paketlenmiş bir veritabanı için taşıma yolu mevcut olsa bile yıkıcı bir taşıma işleminin gerçekleştirilmesine neden olan sorun düzeltildi (b/432634197).

Sürüm 2.8.0-rc01

13 Ağustos 2025

androidx.room:room-*:2.8.0-rc01 yayınlandı. 2.8.0-rc01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Eski @RequiresApi(21) ek açıklamaları kaldırılıyor (Ic4792, I9103b)

Hata Düzeltmeleri

  • Eşzamansız çoklu sorgu/yazma durumunda Room akışlarının en son sorgu sonucunu yayınlamamasına neden olan yarışma durumu düzeltildi. (Ic9a3c)

Sürüm 2.8.0-beta01

1 Ağustos 2025

androidx.room:room-*:2.8.0-beta01 yayınlandı. 2.8.0-beta01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Tablo ve görünüm adları artık yıkıcı taşımalar sırasında doğru şekilde çıkış karakteriyle gösteriliyor. (9e55f8, b/427095319)

Sürüm 2.8.0-alpha01

16 Temmuz 2025

androidx.room:room-*:2.8.0-alpha01 yayınlandı. 2.8.0-alpha01 sürümü bu commit'leri içerir.

Yeni özellikler

  • Yapılandırılmış bir SQLiteDriver ile RoomDatabase'nin SupportSQLiteDatabase sarmalayıcısını almak için API'ler içeren yeni bir androidx.room:room-sqlite-wrapper yapısı eklendi. Sarmalayıcıyı almak için yeni uzantı işlevi RoomDatabase.getSupportWrapper()'i kullanın. Bu, Room veritabanı bir SQLiteDriver ile yapılandırılmış olsa bile genellikle RoomDatabase.openHelper.writableDatabase üzerinden elde edilen SupportSQLiteDatabase kullanımlarını sürdürmek için kullanılan bir uyumluluk yapısıdır. Bu sarmalayıcı, SQLiteDriver kullanmak isteyen ancak SupportSQLite API'lerini yoğun bir şekilde kullanan ve BundledSQLiteDriver avantajlarından yararlanmak isteyen kod tabanlarının aşamalı olarak taşınması için kullanışlıdır. (Icf6ac)
  • Watch OS ve TV OS için KMP hedefleri eklendi (I228f6, b/394238801).

Hata Düzeltmeleri

  • Askıya alma işlemleri ve AndroidSQLiteDriver kullanılırken zaman zaman ortaya çıkabilen kilitlenme sorunu düzeltildi. (b/415006268)

Sürüm 2.7

Sürüm 2.7.2

18 Haziran 2025

androidx.room:room-*:2.7.2 yayınlandı. 2.7.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Yerel kaynaklar KSP ile işlenirken ek açıklama değerlerinin yanlış okunmasına ve bazen şema dışa aktarma işlemlerinin eksik olmasına neden olan bir sorun düzeltildi. (b/416549580)
  • SQL'deki baştaki yorumların, ifadelerin okunmayan sorgularmış gibi yürütülmesine neden olan hata düzeltildi. (b/413061402)
  • Şema dizininin boş olması nedeniyle Room'un Gradle eklentisinin yapılandırılamaması sorunu düzeltildi. (b/417823384)
  • Bağlantı kurma işlemi çok uzun sürdüğünde artık SQLiteException hatası verilmeyecek, bunun yerine kitaplık tarafından bir günlük mesajı gönderilecek. Hata oluşturmak yerine günlük kaydı yapmak, iOS'in döngüleri askıya almasıyla ilgili sorunu çözer. Bu sorun, Room'un Kotlin eş yordamında bağlantı alınırken gerçekleşen zaman aşımını yanlış yorumlamasına neden olur. Bu nedenle, bir iOS uygulaması arka plana alındığında ve daha sonra bir veritabanı işleminin ortasında devam ettirildiğinde istisnanın oluşturulmasını engeller. (b/422448815)

Sürüm 2.7.1

23 Nisan 2025

androidx.room:room-*:2.7.1 yayınlandı. 2.7.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Sağlanan tür dönüştürücü doğrulaması sırasında oluşan IndexOutOfBoundsException hatasını düzeltin. (b/409804755).
  • SQLiteDriver, Oda ile yapılandırıldığında RoomDatabase.runInTransaction() desteklenir. (b/408364828).

Sürüm 2.7.0

9 Nisan 2025

androidx.room:room-*:2.7.0 yayınlandı. 2.7.0 sürümü bu commit'leri içerir.

2.6.0 sürümünden sonra yapılan önemli değişiklikler

  • Kotlin Multiplatform (KMP) desteği: Bu sürümde Room, Kotlin Multiplatform (KMP) kitaplığı olacak şekilde yeniden düzenlendi. Şu anda desteklenen platformlar Android, iOS, JVM (Masaüstü), yerel Mac ve yerel Linux'tur. Room KMP'yi kullanmaya başlama hakkında daha fazla bilgi için resmi Room KMP belgelerine bakın. KMP desteği kapsamında Room, SQLiteDriver ile de yapılandırılabilir. Mevcut bir uygulamayı sürücü API'lerine ve Room KMP'ye taşıma hakkında bilgi edinmek için taşıma belgelerini inceleyin.
  • İşleme KSP üzerinden yapılıyorsa KSP'de Kotlin Kodu Oluşturma varsayılan olarak ETKİNLEŞTİRİLMİŞTİR. Yalnızca KAPT veya Java projeleri için Room, Java kaynakları oluşturmaya devam eder.
  • Kotlin 2.0 ve KSP2: Room artık Kotlin 2.0 dilini hedefliyor ve projelerin Kotlin 2.0 ve eşdeğer veya daha yeni bir dil sürümüyle derlenmesini gerektiriyor. KSP2 desteği de eklendi ve Room'u Kotlin 2.0 veya sonraki sürümlerle kullanırken önerilir.

Sürüm 2.7.0-rc03

26 Mart 2025

androidx.room:room-*:2.7.0-rc03 yayınlandı. 2.7.0-rc03 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Engelleme DAO işlevleri (b/400584611) dahil olmak üzere Room engelleme API'lerinin yürütülmesi sırasında bir iş parçacığı kesintiye uğradığında artık InterruptedException hatası verilmez.
  • SQLException: Error code: 5, message: Timed out attempting to acquire a reader connection. ve benzer sorunları (b/380088809) hafifletmek için Room'un bağlantı havuzunu yeniden uygulayın.

Sürüm 2.7.0-rc02

12 Mart 2025

androidx.room:room-*:2.7.0-rc02 yayınlandı. 2.7.0-rc02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Otomatik taşıma işlemlerinin, FTS tablosundaki yeni bir sütunu yanlış işlemesi sorunu düzeltildi. (b/348227770, Ic53f3)
  • JVM dışı kaynaklar KSP aracılığıyla işlenirken NullPointerException nedeniyle oluşan oda derleyici kilitlenmesi düzeltildi. (b/396607230, I693c9)
  • Room'un, yazıcı bağlantısı kullanıldıktan sonra tabloları geçersiz kılmamasına neden olan sorun düzeltildi. (b/340606803, I73ef6)

Sürüm 2.7.0-rc01

26 Şubat 2025

androidx.room:room-*:2.7.0-rc01 yayınlandı. 2.7.0-rc01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Room'un ilk veritabanı bağlantısında busy_timeout değerini ayarlamaması nedeniyle SQLException: Error code: 5, message: database is locked sorunlarına yol açan bir sorun düzeltildi (I93208, b/380088809).
  • Room'un derleyicisinde, Kotlin 2.1.x ve KSP1'de yerel kaynak gruplarını (ör. iOS) işlerken KSP işlemcisinin kilitlenmesine neden olan bir sorun düzeltildi (I883b8, b/396607230).

Sürüm 2.7.0-beta01

12 Şubat 2025

androidx.room:room-*:2.7.0-beta01 yayınlandı. 2.7.0-beta01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • RoomDatabase.inTransaction(), kapalı bir veritabanını açmaması gerekirken açıyordu ve veritabanı kapalıysa hızlı bir şekilde "false" değerini döndürmesi gerekiyordu. Bu sorun düzeltildi (b/325432967).
  • Kotlin satır içi/değer sınıflarıyla DAO işlevleri işlenirken Room'un derleyicisinde oluşan kilitlenme (IllegalArgumentException: not a valid name) düzeltildi (b/388299754).
  • Oluşturulan veritabanı uygulamasının varsayılan kurucusu, Room'un yansıma kullanan varsayılan başlatma işlemi tarafından kullanıldığından kaldırılmaması için room-runtime öğesinin JVM yapısına Proguard kuralları ekleyin (b/392657750).

Sürüm 2.7.0-alpha13

29 Ocak 2025

androidx.room:room-*:2.7.0-alpha13 yayınlandı. 2.7.0-alpha13 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Room artık Kotlin 2.0 dilini hedefliyor ve projelerin Kotlin 2.0 ve eşdeğer veya daha yüksek dil sürümüyle de derlenmesini gerektiriyor. (I8efb0, b/315461431, b/384600605)

Hata Düzeltmeleri

  • Android'de yol yerine basit bir ad kullanıldığında ve veritabanı dosyasının çözümlenen yolu uygulamanın veri dizininde bulunmadığında Room KMP veritabanı oluşturucusunda ortaya çıkan sorun düzeltildi. (I83315, b/377830104)
  • Room Gradle eklentisinde, şema giriş ve çıkışlarının yapılandırılmasının Android projelerinde soruna neden olduğu bir sorun düzeltildi: property 'inputDirectory' is final and cannot be changed any further. (1dbb4c, b/376071291)
  • Room Gradle eklentisinde KSP2 desteği eklendi. Bu sayede, şema dizininin eklenti tarafından düzgün şekilde ayarlanmaması sorunu düzeltildi. (Iec3c4, b/379159770)

Harici Katkı

  • Yenilenecek ilk anahtar, listenin sonuna çok yakın olduğunda kullanıcı arayüzünde atlamalara neden olan Room sayfalama entegrasyonuyla ilgili sorun düzeltildi. Eva'ya teşekkürler. (I2abbe, b/389729367)

Sürüm 2.7.0-alpha12

11 Aralık 2024

androidx.room:room-*:2.7.0-alpha12 yayınlandı. 2.7.0-alpha12 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Room'un geçersiz kılma takibi için bellek içi tablo kullanıp kullanmayacağını yapılandırmak üzere deneysel API RoomDatabase.Builder.setInMemoryTrackingMode()'yı ekleyin. (I2a9b2, b/185414040)

Hata Düzeltmeleri

  • Yıkıcı taşıma işlemleri artık görünümleri bırakarak yeniden oluşturulmalarını sağlıyor. Böylece allowDestructiveMigrationForAllTables AÇIK (KMP varsayılanı) olduğundaki davranış, KAPALI olduğundaki mevcut davranışla uyumlu hale geliyor. (0a3e83, b/381518941)

Sürüm 2.7.0-alpha11

30 Ekim 2024

androidx.room:room-*:2.7.0-alpha11 yayınlandı. 2.7.0-alpha11 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Yeni eklenen convertRows() yöntem imzasını, oda sayfalama için RawRoomQuery alan bir askıya alma işlevi olacak şekilde yeniden ziyaret edin. (Ie57b5, b/369136627)

Hata Düzeltmeleri

  • Oda sayfalama özelliğinde, @Relation ile PagingSource birlikte kullanıldığında geçersiz kod oluşturulmasına neden olan sorun düzeltildi.

Sürüm 2.7.0-alpha10

16 Ekim 2024

androidx.room:room-*:2.7.0-alpha10 yayınlandı. 2.7.0-alpha10 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Android ve JVM dışı platformlarda ByteBuffer ile ilişkileri desteklemek için dahili ByteArrayWrapper sınıfı oluşturun. (I75543, b/367205685)
  • Bir sütunun veri türünün alınmasını etkinleştirmek için çeşitli SQLITE_DATA_* sonuç sabitleriyle birlikte SQLiteStatement.getColumnType() ekleyin. (I1985c, b/369636251)

Sürüm 2.7.0-alpha09

2 Ekim 2024

androidx.room:room-*:2.7.0-alpha09 yayınlandı. 2.7.0-alpha09 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Okuma bağlantısında yazma işlemi başlatılması nedeniyle Error code: 8, message: attempt to write a readonly database hatasına yol açan, room-paging öğesinin KMP uygulamasındaki bir sorun düzeltildi. (b/368380988)

Sürüm 2.7.0-alpha08

18 Eylül 2024

androidx.room:room-*:2.7.0-alpha08 yayınlandı. 2.7.0-alpha08 sürümü bu kayıtları içerir.

Yeni özellikler

  • room-paging yapıları, KMP ile uyumlu olacak şekilde taşındı. (Ib8756, b/339934824)
  • invalidationTrackerFlow() API'si, InvalidationTracker.createFlow() olarak birinci taraf API şeklinde ortaklaştırıldı ve artık KMP projelerindeki Android dışı kaynak gruplarında kullanılabilir. (I1fbfa, (I8fb29), b/329291639, b/329315924)

API Değişiklikleri

  • Room'da Cursor kelimesini kullanan tüm uyarılar ve hata mesajları kaldırıldı veya değiştirildi. Cursor, Room'un KMP sürümünde artık doğru bir genel terim olarak kabul edilmiyor. (Id8cd9, b/334087492)

Hata Düzeltmeleri

  • Room KMP'nin, JVM dışı platformlar için UUID kullanarak kod yayınlamaya çalışması sorunu düzeltildi. (b/362994709)
  • Room Gradle eklentisinde, Compose Multiplatform ile bir KMP projesinde kullanıldığında "Değişiklik için kilitlendikten sonra yapılandırma özellikleri değiştirilemez" gibi bir hataya neden olan sorun düzeltildi. (b/343408758)

Sürüm 2.7.0-alpha07

21 Ağustos 2024

androidx.room:room-*:2.7.0-alpha07 yayınlandı. Sürüm 2.7.0-alpha07, bu kayıtları içerir.

Yeni özellikler

  • Room Gradle eklentisi, dışa aktarılan şemaları artık Android enstrümantasyon testi kaynaklarına otomatik olarak ekleyecek. Böylece şemalar MigrationTestHelper tarafından kullanılabilecek.

Hata Düzeltmeleri

  • initialize işlevinde "actual" değiştiricisi eksik olan RoomDatabaseConstructor için oluşturulan "actual" ile ilgili bir sorun düzeltildi (bu işlev "expect" beyanında da geçersiz kılınmışsa). (359631627)
  • RoomDatabaseConstructor için oluşturulan "actual"ın, "expect" beyanının görünürlüğüyle eşleşmemesi sorunu düzeltildi. (358138953)

Sürüm 2.7.0-alpha06

7 Ağustos 2024

androidx.room:room-*:2.7.0-alpha06 yayınlandı. 2.7.0-alpha06 sürümü bu kayıtları içerir.

API Değişiklikleri

  • KMP projesinde RoomDatabase için örneklendirme ayarlarını değiştirin.

Kotlin 2.0 derleme modeli nedeniyle, instantiateImpl() adlı oluşturulacak bir işleve referans verme stratejisi artık geçerli değildir. instantiateImpl() stratejisinin yerini alan @ConstructedBy ve RoomDatabaseConstructor adlı iki yeni API kullanıma sunuldu. Yeni strateji şu şekildedir:

  1. RoomDatabaseConstructor uygulayan bir expect nesnesi tanımlayın.

      expect object MyDatabaseCtor : RoomDatabaseConstructor<MyDatabase>
    
  2. @ConstructedBy kullanarak nesneyi @Database beyanıyla bağlayın

      @Database(...)
      @ConstructedBy(MyDatabaseCtor::class) // NEW
      abstract class MyDatabase : RoomDatabase
    
  3. Fabrika bağımsız değişkeni iletmeden yeni bir veritabanı örneği oluşturma

      fun createNewDatabase(path: String) =
        Room.databaseBuilder<AppDatabase>(name = path)
          .setDriver(BundledSQLiteDriver())
          .setQueryCoroutineContext(Dispatchers.IO)
          .build()
    

b/316978491, b/338446862 ve b/342905180 düzeltmeleri

  • Ham SQL dizesini tutma ve bağımsız değişkenleri bir ifadeye bağlama işlevi açısından SupportSQLiteQuery ile benzer olan RoomRawQuery adlı yeni bir API eklenerek Room KMP'de @RawQuery desteği sunuldu. @RawQuery ek açıklamalı işlevler artık tek parametre olarak RoomRawQuery kabul edebilir. (Iea844, b/330586815)
  • setQueryCallback() kabul eden bir CoroutineContext aşırı yüklemesi ekleyin. (Id66ff, b/309996304)
  • linuxArm64 Kotlin Multiplatform hedefleri için destek eklendi (I139d3, b/338268719)

Hata Düzeltmeleri

  • Room'un Android dışı hedeflerde yanlışlıkla recursiveFetchArrayMap çağrısı oluşturmasına neden olan sorun düzeltildi. (710c36, b/352482325)
  • KMP projesinde Room'un bazen "Bağlantı denenirken zaman aşımına uğradı" istisnası oluşturmasına neden olan sorun düzeltildi. (fa72d0, b/347737870)
  • Otomatik taşıma işlemlerinde, diğer tablolar şemalarını yeni yabancı anahtarlara uyacak şekilde değiştirmeden önce yabancı anahtarları çok erken kontrol eden bir sorun düzeltildi. (7672c0, b/352085724)

Sürüm 2.7.0-alpha05

10 Temmuz 2024

androidx.room:room-*:2.7.0-alpha05 yayınlandı. 2.7.0-alpha05 sürümü bu kayıtları içerir.

API Değişiklikleri

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

Hata Düzeltmeleri

  • AndroidSQLiteDriver kullanılırken RoomDatabase işleminin kilitlenmesine veya bağlantı zaman aşımı hatası vermesine neden olan hata düzeltildi.

Sürüm 2.7.0-alpha04

12 Haziran 2024

androidx.room:room-*:2.7.0-alpha04 yayınlandı. 2.7.0-alpha04 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • DAO'da çoklu eşleme dönüş türü tanımlandığında Room'un ek açıklama işleyicisinin uyumsuz KMP kodu oluşturmasına neden olan sorun düzeltildi. (b/340983093)
  • @Database ek açıklamalı sınıfın paketi yoksa Room'un oluşturulan veritabanı uygulamasını bulamamasına neden olan sorun düzeltildi. (b/342097292)
  • Otomatik kapatma ve aynı anda çalışan birden çok kopya geçersiz kılma etkinleştirildiğinde, veritabanı boşta olduğu için otomatik olarak kapatıldığında bazen ConcurrentModificationException hatasına neden olan sorun düzeltildi.

Sürüm 2.7.0-alpha03

29 Mayıs 2024

androidx.room:room-*:2.7.0-alpha03 yayınlandı. 2.7.0-alpha03 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Kotlin 2.0 ve KSP 2.0 ile ilgili çeşitli sorunlar düzeltildi. KSP 2 destekli Kotlin 2.0'ın henüz tamamlanmadığını ve ekibin yeni derleyicideki çeşitli API'ler ve davranış değişiklikleri üzerinde çalıştığını unutmayın. (b/314151707)

Sürüm 2.7.0-alpha02

14 Mayıs 2024

androidx.room:room-*:2.7.0-alpha02 yayınlandı. 2.7.0-alpha02 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • KSP ile ilgili çeşitli sorunlar düzeltildi.

Sürüm 2.7.0-alpha01

1 Mayıs 2024

androidx.room:room-*:2.7.0-alpha01 yayınlandı. 2.7.0-alpha01 sürümü bu commit'leri içerir.

Yeni özellikler

  • Kotlin Multiplatform (KMP) desteği: Bu sürümde Room, Kotlin Multiplatform (KMP) kitaplığı olacak şekilde yeniden düzenlendi. Hâlâ yapılması gereken bazı çalışmalar olsa da bu sürümde, işlevlerin çoğunun "ortaklaştırıldığı" (çoklu platform haline getirildiği) yeni bir Room sürümü sunuluyor. Şu anda desteklenen platformlar Android, iOS, JVM (Masaüstü), yerel Mac ve yerel Linux'tur. Yeni desteklenen platformlardaki eksik işlevler, yaklaşan Room sürümlerinde "özellik açısından eksiksiz" hale getirilecek.

Room KMP'yi kullanmaya başlama hakkında daha fazla bilgi için resmi Room KMP belgelerine bakın.

  • İşleme KSP üzerinden yapılıyorsa KSP'de Kotlin Kodu Oluşturma varsayılan olarak ETKİNLEŞTİRİLMİŞTİR. Yalnızca KAPT veya Java projeleri için Room, Java kaynakları oluşturmaya devam eder.

API Değişiklikleri

  • Oluşturulan RoomDatabase uygulamasını örneklendirirken yansıma kullanılmasını önlemek için Room tarafından oluşturulan bir işlevle kullanılması amaçlanan lambda parametresi alan bir Room.databaseBuilder() aşırı yüklemesi eklendi. Örnek kullanım:
Room.databaseBuilder<MyDatabase>(
    context = appContext,
    name = dbFilePath,
    factory =  { MyDatabase::class.instantiateImpl() }
)
  • Oluşturucuya, CoroutineContext ile bir oda yapılandırmak için kullanılan bir API eklendi: RoomDatabase.Builder.setQueryCoroutineContext. RoomDatabase, setQueryExecutor kullanan yürütücülerle veya Coroutine bağlamıyla yapılandırılabilir ancak ikisiyle birden yapılandırılamaz.
  • Room'u SQLite sürücüsüyle yapılandırmak için bir API eklendi: RoomDatabase.Builder.setDriver(). SQLite Driver API hakkında daha fazla bilgi için SQLite KMP belgelerine bakın.
  • Sürücü API'lerinden temel SQLiteConnection öğesine erişmek için API'ler eklendi: RoomDatabase.useReaderConnection ve RoomDatabase.useWriterConnection.
  • Oda ile ilgili çeşitli geri çağırmaların artık SupportSQLiteDatabase yerine SQLiteConnection alan aşırı yüklenmiş bir sürümü var. Bunlar, bir KMP projesine taşınırken geçersiz kılınmak üzere tasarlanmıştır. Android uygulamasındaki Room kullanımlarını ortak bir KMP modülüne taşıma hakkında daha fazla bilgi için geçiş rehberine bakın. Geri çağırmalar şunlardır:
    • Migration.migrate(SQLiteConnection)
    • AutoMigrationSpec.onPostMigrate(SQLiteConnection)
    • RoomDatabase.Callback.onCreate(SQLiteConnection)
    • RoomDatabase.Callback.onDestructiveMigration(SQLiteConnection)
    • RoomDatabase.Callback.onOpen(SQLiteConnection)
  • KTX yapısı androidx.room:room-ktx, tüm API'leriyle birlikte androidx.room:room-runtime ile birleştirildi. Yapı artık boş. Lütfen bu kitaplığı bağımlılık listenizden kaldırın.

Sürüm 2.6

Sürüm 2.6.1

29 Kasım 2023

androidx.room:room-*:2.6.1 yayınlandı. 2.6.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Oluşturulan kodda, EntityCursorConverter içindeki Double sütunlarının varsayılan değerinin 0.0 yerine 0 olarak ayarlanması sorunu çözüldü. Float türü belirtilmiş sütunlar için benzer bir uç durumla ilgili olası bir düzeltme de eklenmiştir. (Id75f5, b/304584179)
  • PagingSource yüklemelerinden kaynaklanan istisnalar artık Throwable içeren bir LoadResult.Error LoadStateUpdate olarak yayılacak. Bu hata durumu PagingDataAdapter.loadStateFlow(Views) veya LazyPagingItems.loadState(Compose) üzerinden görülebilir. Bu durumun, geçmişte yükleme hatalarının yüklemeyi tetikleyen dao yöntemi tarafından oluşturulan bir istisna olarak ortaya çıktığı davranışsal bir değişikliğe işaret ettiğini unutmayın. (I93887, b/302708983)

Sürüm 2.6.0

18 Ekim 2023

androidx.room:room-*:2.6.0 yayınlandı. 2.6.0 sürümü bu commit'leri içerir.

2.5.0 sürümünden sonra yapılan önemli değişiklikler

  • Kotlin kod oluşturma (veya "Kotlin CodeGen") özelliğini etkinleştirme seçeneği artık Room KSP'de kullanılabilir. (4297ec0). Room'da Kotlin CodeGen'i etkinleştirmek için KSP işlemci seçeneklerinize room.generateKotlin seçenek adını ekleyin. KSP için işlemci seçeneklerini nasıl ileteceğiniz hakkında daha fazla bilgi edinmek istiyorsanız KSP belgelerini inceleyin.

Not: Kotlin CodeGen'i kullanırken ek kısıtlamalar olduğunu unutmayın. Kotlin CodeGen'de DAO alıcıları veya DAO sorguları olarak soyut özelliklere izin verilmez. Bunun yerine, özellik değerinin sabit olduğu ve sabit bir depolanmış sonuca sahip olduğu şeklindeki yanlış algıyı önlemek için bunların işlev olarak yeniden yazılması beklenir. Eklenen bir diğer kısıtlama da Kotlin CodeGen için Room'da null değer alabilen koleksiyon dönüş türlerine artık izin verilmemesidir.

Uyarı: Kotlin CodeGen'i kullanırken projelerinizin null değer alabilme açısından daha katı olduğunu fark edebilirsiniz. Kotlin CodeGen'de tür bağımsız değişkenlerinin null değer alabilme özelliği önemlidir ancak Java'da bu özellik genellikle yok sayılır. Örneğin, `Flow<foo\>` dönüş türünüz olduğunu ve tablonun boş olduğunu varsayalım. Java CodeGen'de bu durum herhangi bir soruna neden olmaz ancak Kotlin CodeGen'de hata alırsınız. Bunu önlemek için null değerinin yayınlandığını varsayarak `Flow<foo?\>` kullanmanız gerekir. </foo?\></foo\>

  • Room Gradle eklentisi için yeni yapı, androidx.room kimliğiyle Room'a eklendi. Bu yapı, Gradle ek açıklama işleyici seçenekleri aracılığıyla şemaların giriş ve çıkışlarına sahip olmayla ilgili Room'daki mevcut çeşitli sorunları çözer. Daha fazla bilgi için Room 2.6.0-alpha02 sürüm notlarını inceleyin.
  • Room varlıklarındaki değer sınıfları artık KSP için destekleniyor. (4194095)
  • DAO işlevlerindeki iç içe yerleştirilmiş Map dönüş türleri artık Room'da destekleniyor. (I13f48, 203008711)

Sürüm 2.6.0-rc01

20 Eylül 2023

androidx.room:room-*:2.6.0-rc01 yayınlandı. 2.6.0-rc01 sürümü bu commit'leri içerir.

Sürüm 2.6.0-beta01

23 Ağustos 2023

androidx.room:room-*:2.6.0-beta01 yayınlandı. 2.6.0-beta01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Upsert sırasında 2067 SQLITE_CONSTRAINT_UNIQUE istisnası oluştuğunda upsert sırasında özel durum SQLite istisnası işleniyor. Upsert bir güncelleme gerçekleştirmelidir. (If2849, b/243039555)

Sürüm 2.6.0-alpha03

9 Ağustos 2023

androidx.room:room-*:2.6.0-alpha03 yayınlandı. 2.6.0-alpha03 sürümü bu taahhütleri içerir.

Yeni özellikler

  • DAO işlevlerindeki iç içe yerleştirilmiş Map dönüş türleri artık Room'da destekleniyor. (I13f48, 203008711)

API Değişiklikleri

  • Artık kullanımdan kaldırılan @MapInfo yerine @MapColumn adlı yeni bir tür ek açıklaması oluşturuldu. Bir @MapInfo ek açıklamasında sağlanan her sütun adı (keyColumnName, valueColumnName veya her ikisi) için yalnızca columnName içeren bir @MapColumn ek açıklaması bildirmeniz ve DAO işlevinin dönüş türünde referans verilen belirli tür bağımsız değişkeninde (Map'in anahtarı veya değeri) ek açıklamayı kullanmanız gerekir. Bunun nedeni, @MapColumn ek açıklamasının @MapInfo gibi işlevin kendisinde değil, doğrudan bir DAO işlevinin dönüş türündeki tür bağımsız değişkeninde kullanılmasıdır. Daha fazla bilgi için lütfen @MapColumn belgelerini inceleyin. (Ib0305, b/203008711)
  • Uyumluluk engellemeyi açıklamak için API dosyaları güncellendi (I8e87a, b/287516207)
  • Room Gradle eklentisi API'leri, her zaman varyant başına yapılandırma gerektirmeyecek şekilde güncellendi. Bu, eklentinin birden fazla dizin oluşturmadan tüm varyantlar için global bir konumu kabul edebileceği anlamına gelir. Bu sayede daha sorunsuz geçişler yapılabilir ancak aynı zamanda eklentinin avantajlarını (tekrarlanabilir ve önbelleğe alınabilir derlemeler) korurken varyantları veya derleme türü şemalarını manuel olarak yapılandıracak kadar esnektir. (I09d6f, b/278266663)

Hata Düzeltmeleri

  • QueryInterceptorStatement uygulamasındaki olası bellek sızıntısı güvenlik açığı düzeltildi. (I193d1)
  • QueryInterceptorDatabase execSQL() işlevindeki hatalı davranış düzeltildi. (Iefdc8)

Sürüm 2.6.0-alpha02

21 Haziran 2023

androidx.room:room-*:2.6.0-alpha02 yayınlandı. 2.6.0-alpha02 sürümü bu commit'leri içerir.

Room Gradle Eklentisi

Bu yeni sürüm, androidx.room kimlikli Room Gradle eklentisi için yeni bir yapı içerir. Bu yapı, Gradle ek açıklama işleyici seçenekleri aracılığıyla şemaların giriş ve çıkışlarına sahip olmayla ilgili olarak Room'da mevcut olan çeşitli sorunları çözer. Room Gradle eklentisi, projeyi otomatik taşıma işlemleri için kullanılan ve derleme görevlerinin çıktısı olan oluşturulmuş şemaların, tekrarlanabilir ve önbelleğe alınabilir derlemelere sahip olacak şekilde doğru yapılandırılmasını sağlar. Eklenti, temel şema konumunu yapılandırmak için bir DSL sunar:

room {
    schemaDirectory("$projectDir/schemas/")
}

Eklenti daha sonra Room derleyicisini ve çeşitli derleme görevlerini ve arka uçlarını (javac, KAPT, KSP) şema dosyalarını varyant klasörlerine (ör. schemas/flavorOneDebug/com.package.MyDatabase/1.json) çıkaracak şekilde yapılandırır. Her zamanki gibi bu dosyalar, doğrulama ve otomatik taşıma işlemleri için kullanılmak üzere depoya kaydedilir. Ek açıklama işleyici seçenekleri yerine eklentiyi kullanmaya geçtikten sonra mevcut şema dosyaları, eklenti tarafından oluşturulan varyant dizinlerine kopyalanmalıdır. Bu, manuel olarak yapılması gereken tek seferlik bir taşıma işlemidir. developers.android.com adresindeki şema belgeleri, geri bildirimler ele alındıktan ve eklenti kararlı sürüme ulaştıktan sonra güncellenecektir. Bu nedenle, lütfen deneyin.

API Değişiklikleri

  • RoomDatabase.QueryCallback, SAM dönüşüm kullanımlarına izin vermek için işlevsel bir arayüz olarak tanımlandı. (Iab8ea, b/281008549)

Hata Düzeltmeleri

  • Room kaynaklarının Java'dan Kotlin'e taşınmasının ardından Robolectric'te veritabanı örneklendirilirken ortaya çıkan sorun çözüldü. (Ic053c, b/274924903)

Sürüm 2.6.0-alpha01

22 Mart 2023

androidx.room:room-*:2.6.0-alpha01 yayınlandı. 2.6.0-alpha01 sürümü bu commit'leri içerir.

Yeni özellikler

  • KSP için Room'da değer sınıfları destekleniyor. Room artık varlıklarda değer sınıflarını destekleyebilir. (4194095)
  • Kotlin kod oluşturma (veya "Kotlin CodeGen") artık Room'da (4297ec0) etkinleştirilebilir. Room'da Kotlin CodeGen'i etkinleştirmek için KSP işlemci seçeneklerinize room.generateKotlin seçenek adını ekleyin. KSP için işlemci seçeneklerini nasıl ileteceğiniz hakkında daha fazla bilgi edinmek istiyorsanız KSP belgelerini inceleyin.

Not: Kotlin CodeGen'i kullanırken ek kısıtlamalar olduğunu unutmayın. Kotlin CodeGen'de DAO alıcıları veya DAO sorguları olarak soyut özelliklere izin verilmez. Bunun yerine, özellik değerinin sabit olduğu ve sabit bir depolanmış sonuca sahip olduğu şeklindeki yanlış algıyı önlemek için bunların işlev olarak yeniden yazılması beklenir. Eklenen bir diğer kısıtlama da Kotlin CodeGen için Room'da null değer alabilen koleksiyon dönüş türlerine artık izin verilmemesidir.

Uyarı: Kotlin CodeGen'i kullanırken projelerinizin null değer alabilme açısından daha katı olduğunu fark edebilirsiniz. Kotlin CodeGen'de tür bağımsız değişkenlerinin null değer alabilme özelliği önemlidir ancak Java'da bu özellik genellikle yok sayılır. Örneğin, `Flow<foo\>` dönüş türünüz olduğunu ve tablonun boş olduğunu varsayalım. Java CodeGen'de bu durum herhangi bir soruna neden olmaz ancak Kotlin CodeGen'de hata alırsınız. Bunu önlemek için null değerinin yayınlandığını varsayarak `Flow<foo?\>` kullanmanız gerekir. </foo?\></foo\>

API Değişiklikleri

  • DAO yöntemi dönüş türlerinde boş değer atanabilir koleksiyonların anlamsız kullanımına karşı koruma sağlar. (I777dc, b/253271782, b/259426907)
  • Geçersiz kılma izleyici değişikliklerini yayınlayan bir akış oluşturmak için API ekleyin. API, veritabanı değişikliklerine tepki vermesi gereken akışlar oluşturmak için kullanışlıdır. (I8c790, b/252899305)

Hata Düzeltmeleri

  • Kotlin kod oluşturmada DAO alıcıları veya DAO sorguları olarak soyut özelliklere izin verilmez. Bunun yerine, özellik değerinin sabit olduğu ve sabit bir depolanmış sonuca sahip olduğu şeklindeki yanlış algıyı önlemek için bu özellikler işlev olarak yeniden yazılmalıdır. (If6a13, b/127483380, b/257967987)

Sürüm 2.5.2

Sürüm 2.5.2

21 Haziran 2023

androidx.room:room-*:2.5.2 yayınlandı. 2.5.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • kotlinx-metadata-jvm ile ilgili bir uyumsuzluk sorunu düzeltildi. (386d5c)
  • Robolectric testinde kullanıldığında Room'un hata vermesine neden olan sorun düzeltildi. (f79bea, b/274924903)

Sürüm 2.5.1

Sürüm 2.5.1

22 Mart 2023

androidx.room:room-*:2.5.1 yayınlandı. 2.5.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Veritabanı zaten açıksa FrameworkSQLiteHelper içinde veritabanı ana dizinini kontrol etmekten kaçının. (5de86b8)
  • Veritabanının açık olup olmadığını kontrol ederken isOpenInternal kontrolü kullanın. (e91fb35)
  • Room sınıfının acquireTransactionThread() yöntemindeki yeniden giriş durumu artık daha iyi işleniyor. (219f98b). Askıya alma işlemi sırasında Room, işlem yürütücüden bir iş parçacığı kullanır, bu iş parçacığında bir etkinlik döngüsü başlatır ve askıya alma veritabanı işlemlerini bu iş parçacığına gönderir. Böylece tüm işlemler, işlem eş yordamında kapsüllenir. İşlem iş parçacığının, işlemi başlatan iş parçacığından farklı olması beklenir ancak bazı durumlarda aynıdır. Bu tür yeniden giriş durumlarını işlemek için withTransaction(), artık bir kontrol işine bağlı olmayacak şekilde yeniden düzenlendi. Bunun yerine, askıya alma işlemi bloğunu işlem iş parçacığındaki runBlocking içinden yürütecek.

Sürüm 2.5.0

Sürüm 2.5.0

22 Şubat 2023

androidx.room:room-paging-guava:2.5.0, androidx.room:room-paging-rxjava2:2.5.0 ve androidx.room:room-paging-rxjava3:2.5.0 yayınlandı. 2.5.0 sürümü bu commit'leri içerir.

Sürüm 2.5.0

11 Ocak 2023

androidx.room:room-*:2.5.0 yayınlandı. 2.5.0 sürümü bu commit'leri içerir.

2.4.0 sürümünden sonra yapılan önemli değişiklikler

  • room-runtime kaynağın tamamı Java'dan Kotlin'e dönüştürüldü. Kitaplığın Kotlin'e dönüştürülmesi nedeniyle, kodunuz Kotlin'de ise kaynak uyumsuzluğu sorunlarıyla karşılaşabileceğinizi unutmayın. Örneğin, kaynakla uyumlu olmayan bilinen bir değişiklik, InvalidationTracker sürümünde MutableSet yerine Set türünde bir parametreye sahip olmak için Observer içinde onInvalidate() değerini bildirmeniz gerektiğidir. Ayrıca, belirli alıcı yöntemleri, Kotlin dosyalarında özellik erişimi söz dizimini gerektiren özelliklere dönüştürüldü. Önemli uyumsuzluklar varsa lütfen hata bildiriminde bulunun.
  • Benzersizlik çakışması olmadığında bir varlık eklemeye veya çakışma olduğunda varlığı güncellemeye çalışan yeni bir kısayol ek açıklaması (@Upsert) eklendi. (I7aaab, b/241964353)
  • Room Paging'i desteklemek için yeni Room Paging yapıları (room-paging-rxjava2, room-paging-rxjava3 ve room-paging-guava) eklendi.
  • @MapInfo içinde anlam belirsizliğini gidermek için anahtar ve değer tabloları adları sağlayan API'ler eklendi (Icc4b5).

Sürüm 2.5.0-rc01

7 Aralık 2022

androidx.room:room-*:2.5.0-rc01 yayınlandı. 2.5.0-rc01 sürümü bu kayıtları içerir.

  • Bu sürüm, 2.5.0-beta02 ile aynı.

Sürüm 2.5.0-beta02

9 Kasım 2022

androidx.room:room-*:2.5.0-beta02 yayınlandı. 2.5.0-beta02 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Java'nın dizi davranışıyla eşleşmesi için sorgu bağımsız değişkenlerini sabit (Array<Any?>) yerine kontravaryant (Array<out Any?>) olarak alan çeşitli API'leri düzeltin. (b/253531073)

Sürüm 2.5.0-beta01

5 Ekim 2022

androidx.room:room-*:2.5.0-beta01 yayınlandı. 2.5.0-beta01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • @Upsert özelliğini destekleyen minimum sürümü API 16 olarak kısıtlayın. Bunun nedeni, eski API'lerde birincil anahtar kısıtlama çakışmasının tanımlanamamasıdır. (I5f67f, b/243039555)

Hata Düzeltmeleri

  • Gölge tabloların şema .json dosyalarına yanlış şekilde aktarılmasına ve dosyaların bozulmasına neden olan sorun düzeltildi. (I4f83b, b/246751839)

Sürüm 2.5.0-alpha03

24 Ağustos 2022

androidx.room:room-*:2.5.0-alpha03 yayınlandı. 2.5.0-alpha03 sürümü bu kayıtları içerir.

Yeni özellikler

  • Benzersizlik çakışması olmadığında bir varlık eklemeye veya çakışma olduğunda varlığı güncellemeye çalışan yeni bir kısayol ek açıklaması (@Upsert) eklendi. (I7aaab, b/241964353)

Hata Düzeltmeleri

  • Room artık otomatik taşıma yabancı anahtar kısıtlama kontrolü sırasında IllegalStateException yerine SQLiteConstraintException hatası verecek. (I328dd)
  • getOpenHelper, getQueryExecutor ve getTransactionExecutor için alıcı/özelliklerin Kotlin kaynağıyla uyumsuz bir değişikliğini düzeltin. (Iad0ac)

Sürüm 2.5.0-alpha02

1 Haziran 2022

androidx.room:room-*:2.5.0-alpha02 yayınlandı. 2.5.0-alpha02 sürümü şu commit'leri içerir:

Yeni özellikler

API Değişiklikleri

  • room-runtime uygulamasının tamamı Java'dan Kotlin'e dönüştürüldü. (If2069, b/206859668),(Ie4b55, b/206859668), (I697ee, b/206859668), (I96c25, b/206859668)

    Not: Kitaplığın Kotlin'e dönüştürülmesi nedeniyle kaynak uyumsuzluğu sorunlarıyla karşılaşabilirsiniz. Kodunuz Kotlin'de yazılmışsa ve Room'un eski sürümünü çağırıyorsa yeni sürümün bu durumları işlemesi gerekir. Örneğin, kaynakla uyumlu olmayan bilinen bir değişiklik, InvalidationTracker sürümünde MutableSet yerine Set türünde bir parametreye sahip olmak için Observer içinde onInvalidate() değerini bildirmeniz gerektiğidir.

  • @MapInfo içinde anlam belirsizliğini gidermek için anahtar ve değer tabloları adları sağlayan API'ler eklendi (Icc4b5).
  • Özellik alıcılarında @Ignore öğesine yeniden izin vermek için kaynak uyumluluğu sorununu düzeltin. (Ifc2fb)

Hata Düzeltmeleri

  • Yinelenen sütun çözünürlüğü sezgisel algoritması. Room artık çoklu eşleme sorgusundaki belirsiz sütunları çözmeye çalışacak. Bu sayede, aynı ada sahip tabloları içeren tablolarla JOIN işlemleri, bir sonuç veri nesnesiyle doğru şekilde eşlenebilir. (I4b444, b/201306012, b/212279118)

Sürüm 2.5.0-alpha01

23 Şubat 2022

androidx.room:room-*:2.5.0-alpha01 yayınlandı. 2.5.0-alpha01 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Kotlin kaynaklarında Room @IntDef kullanımının zorunlu kılınmamasıyla ilgili sorun düzeltildi. (I75f41, b/217951311)
  • Özellik alıcılarında @Query'e yeniden izin vermek için kaynak uyumluluğu sorunu düzeltildi. (I0a09b)
  • room-common, Java'dan Kotlin'e dönüştürüldü. (I69c48, b/206858235)

    Not: Kitaplık Kotlin'e dönüştürülürken bazı özellikler tamamlayıcı nesnelere taşındığı için kaynak uyumsuzluğu sorunlarıyla karşılaşabilirsiniz. Kodunuz Kotlin'de yazılmışsa ve Room'un eski sürümünü çağırıyorsa yeni sürüm, bu özelliklere erişirken ".Companion" son ekini gerektirir.

  • Room-migration, Java'dan Kotlin'e dönüştürüldü. (I2724b, b/206858622)
  • room-runtime klasöründeki paging ilgili dosya Java'dan Kotlin'e dönüştürüldü. (I82fc8, b/206859668)
  • Çok işlemli ilk veritabanı oluşturma ve taşıma işlemlerini korumak için FrameworkSQLite* düzeyinde çok işlemli kilit ve kullanım API'si eklendi. (Ied267, b/193182592)

Hata Düzeltmeleri

  • Kotlin kaynaklarında dahili özellikler için destek eklendi. Bu, Room'da küçük bir davranış değişikliğidir. Room, işlevleri alıcı/ayarlayıcı olarak özelliklerle eşleştirirken işlevlerin kaynak adını kullanır (önceden, dahili işlevler/özellikler için farklı olan işlevin JVM adını kullanıyordu). Alıcıları/ayarlayıcıları özel mülklerle eşleştirmek için özel @JvmName ek açıklamaları kullanıyorsanız lütfen güncellemeden sonra oluşturulan kodu tekrar kontrol edin (If6531, b/205289020).

Sürüm 2.4.3

Sürüm 2.4.3

27 Temmuz 2022

androidx.room:room-*:2.4.3 yayınlandı. 2.4.3 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Room'un Kotlin 1.7'deki askıya alma işlevlerini tanımamasına neden olan bir sorun düzeltildi (b/236612358).

Sürüm 2.4.2

Sürüm 2.4.2

23 Şubat 2022

androidx.room:room-*:2.4.2 yayınlandı. 2.4.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • -Xjvm-default=all veya eşdeğeriyle derleme nedeniyle varsayılan bir arayüz yöntemi oluşturan gövdeye sahip bir Dao @Transaction askıya alma işlevi için kod oluşturma sorunu düzeltildi. (Ia4ce5)
  • Room'un Array<ByteArray> dönüş türü sorgu yöntemi için kod oluşturduğu bir hata düzeltildi. (If086e, b/213789489)

Sürüm 2.4.1

Sürüm 2.4.1

12 Ocak 2022

androidx.room:room-*:2.4.1 yayınlandı. 2.4.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Kotlin kaynaklarında dahili özellikler için destek eklendi. Bu, Room'da küçük bir davranış değişikliğidir. Room, işlevleri alıcı/ayarlayıcı olarak özelliklerle eşleştirirken işlevlerin kaynak adını kullanır (önceden, dahili işlevler/özellikler için farklı olan işlevin JVM adını kullanıyordu). Alıcıları/ayarlayıcıları özel mülklerle eşleştirmek için özel @JvmName ek açıklamaları kullanıyorsanız lütfen güncellemeden sonra oluşturulan kodu tekrar kontrol edin (If6531, b/205289020).

Sürüm 2.4.0

Sürüm 2.4.0

15 Aralık 2021

androidx.room:room-*:2.4.0 yayınlandı. 2.4.0 sürümü bu commit'leri içerir.

2.3.0 sürümünden sonra yapılan önemli değişiklikler

  • Otomatik Taşımalar: Room artık şemalar dışa aktarıldığı sürece otomatik olarak taşıma işlemleri oluşturmak için bir API sunuyor. Room'un otomatik taşıma işlemi oluşturması gerektiğini bildirmek için yeni bir @Database#autoMigrations özelliği kullanılarak otomatik taşıma işleminin hangi sürümler arasında yapılacağı belirtilebilir. Room'un tablolar ve sütunların yeniden adlandırılması veya silinmesiyle ilgili ek bilgilere ihtiyacı olduğunda @AutoMigration ek açıklaması, bu tür girişleri içeren bir spesifikasyon sınıfı tanımlayabilir. Daha fazla bilgi için @AutoMigration belgelerine bakın.
  • Otomatik Taşıma İşlemlerinde Bağımlılık Ekleme: @ProvidedAutoMigrationSpec, çalışma zamanında RoomDatabase.Builder#addAutoMigrationSpec() aracılığıyla bir AutoMigrationSpec sağlanacağını bildiren yeni bir API'dir. Bu sayede, bağımlılık ekleme çerçevesi, karmaşık bağımlılıklara ihtiyaç duyduğunda bu tür spesifikasyonları sağlayabilir.
  • Otomatik Taşıma İşlemleri İçin Taşıma Testi Yardımcısı Desteği: Room'un MigrationTestHelper sınıfı, test edilen veritabanı sınıfını alan yeni bir kurucu API sağlayarak otomatik taşıma işlemlerini destekleyecek şekilde güncellendi. Bu sayede yardımcı, runMigrationsAndValidate sırasında otomatik taşıma işlemlerini aynı şekilde otomatik olarak ekleyebilir.
  • Room-Paging Desteği: androidx.room:room-paging yayınlandı. Bu sürüm, androidx.paging.PagingSource döndüren Room sorguları için yerel Paging 3.0 desteği sağlar.
  • İlişkisel Sorgu Yöntemleri: Room artık JOIN ifadeleri için yararlı olan çoklu eşleme dönüş türü @Dao yöntemlerini destekliyor. Desteklenen çoklu eşleme türleri Map, SparseArray, LongSparseArray ve Guava'nın ImmutableMap, ImmutableSetMultimap ve ImmutableListMultimap türleridir.

Sürüm 2.4.0-rc01

1 Aralık 2021

androidx.room:room-*:2.4.0-rc01 yayınlandı. 2.4.0-rc01 sürümü bu kayıtları içerir.

Yeni özellikler

  • Kotlin 1.6'yı desteklemek için Room'un KSP'ye olan bağımlılığını 1.6.0-1.0.1 olarak güncelleyin.

Sürüm 2.4.0-beta02

17 Kasım 2021

androidx.room:room-*:2.4.0-beta02 yayınlandı. 2.4.0-beta02 sürümü bu kayıtları içerir.

Yeni özellikler

  • @MapInfo'da SparseArray ve LongSparseArray için destek ekledik. (Ic91a2b/138910317)

Hata Düzeltmeleri

  • Türlerdeki null değer alabilme bilgilerini dikkate alan yeni bir TypeConverter analiz aracı ekledik. Bu bilgiler yalnızca KSP'de mevcut olduğundan varsayılan olarak yalnızca KSP'de etkindir. Herhangi bir soruna neden olursa ek açıklama işleyicisine room.useNullAwareTypeAnalysis=false değerini ileterek bu özelliği devre dışı bırakabilirsiniz. Bu durumda, bu işaret gelecekte kaldırılacağı için lütfen hata bildirin. Bu yeni TypeConverter analiz aracıyla, yalnızca boş olmayan TypeConverter'lar sağlamanız önerilir. Yeni analiz aracı, bunları boşluk kontrolüyle sarmalayabilir. KAPT veya Java'yı ek açıklama işleyicisi olarak kullanan kullanıcılar için bu durumun bir etkisi yoktur (KSP'nin aksine, türlerde null değer alabilme bilgisi yoktur). (Ia88f9, b/193437407)
  • Bir FTS varlığı, ICU simgeleştiricisini kullanacağını bildirdiğinde Room'un SQL hatasıyla derlenememesine neden olan hata düzeltildi. (I00db9, b/201753224)
  • Sürümler arasında yerleşik bir varlığa eklenen yeni sütunla ilgili otomatik taşıma işlemlerindeki sorun çözüldü. (I5fcb1b/193798291)
  • LEFT JOIN sorgularındaki ilişkisel sorgu yöntemi dönüş türleriyle ilgili bir sorunu çözdük. Bu değişikliklerle birlikte, bire çok eşlemenin mevcut olduğu durumlarda, bir anahtar için döndürülen koleksiyon, imleçte bulunamazsa geçersiz değer nesnesini içermez. Geçerli bir değer bulunamazsa anahtar, boş bir koleksiyonla eşlenir. (Id5552b/201946438)
  • SQLite anahtar kelimelerinin sütun adlarında kodlanamamasıyla ilgili otomatik taşıma sorunu çözüldü. (Idbed4b/197133152)

Sürüm 2.4.0-beta01

13 Ekim 2021

androidx.room:room-*:2.4.0-beta01 yayınlandı. 2.4.0-beta01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Aynı otomatik taşıma işlemindeki başka bir tabloda aynı ada sahip yeni bir sütun olduğunda otomatik taşıma işlemlerinin yeni sütun eklememesiyle ilgili sorun düzeltildi. (Ia5db5, b/200818663)
  • room-paging tarafından oluşturulan PagingSource uygulaması artık daha önce kullanılan Dispatchers.IO yerine RoomDatabase.Builder üzerinden iletilen queryExecutor değerini kullanır. Bu sayede geçersiz kılınabilir. (Iae259)

Sürüm 2.4.0-alpha05

29 Eylül 2021

androidx.room:room-*:2.4.0-alpha05 yayınlandı. 2.4.0-alpha05 sürümü bu kayıtları içerir.

Yeni özellikler

API Değişiklikleri

  • Geliştiricilerin yerleşik Enum ve UUID dönüştürücüleri devre dışı bırakmasına olanak tanımak için TypeConverters ek açıklamasına yeni bir özellik eklendi. Bu dönüştürücüler varsayılan olarak etkindir ancak belirli bir kapsam veya veritabanının tamamı için devre dışı bırakılabilir. Ayrıntılar için TypeConverters belgelerine bakın. (36ae9e, b/195413406)

  • @MapInfo ek açıklaması aracılığıyla DAO'lardaki Multimap dönüş türleri için POJO olmayan anahtarları/değerleri destekleme. (I4d704)

Eşlemenin anahtar veya değer sütunu tek bir sütundan oluştuğunda @MapInfo gerekir. Örneği inceleyin:

@MapInfo(valueColumn = "songCount")
@Query("""
       SELECT *, COUNT(mSongId) as songCount
       FROM Artist JOIN Song ON Artist.artistName = Song.artist
       GROUP BY artistName
       """)
fun getArtistAndSongCounts(): Map<Artist, Integer>
  • Paging3'ü Room ile kullanırken room-paging öğesini zorunlu bir yapı haline getirin. (Ieaffe)

Hata Düzeltmeleri

  • Sorgu, haritanın anahtarından bir sütunun ORDER BY ifadesini içerdiğinde çoklu eşleme sorgu sonuçlarının doğru şekilde sıralanmaması sorunu düzeltildi. (I6b887)

Harici Katkı

  • @Index'te dizin sırasını belirtmek için yeni API eklendi. Nikita Zhelonkin'e teşekkür ederiz. (I033fc)

Sürüm 2.4.0-alpha04

21 Temmuz 2021

androidx.room:room-*:2.4.0-alpha04 yayınlandı. 2.4.0-alpha04 sürümü bu kayıtları içerir.

Yeni özellikler

  • Room artık JOIN ifadeleri için kullanışlı olan çoklu eşleme dönüş türü @Dao yöntemlerini destekliyor. Desteklenen çoklu eşleme türleri Map ve Guava'nın ImmutableMap, ImmutableSetMultimap ve ImmutableListMultimap türleridir.

    Aşağıda, çoklu eşleme sorgularına örnekler verilmiştir:

    Bire Bir İlişki Haritası

    @Query("SELECT * FROM Song JOIN Artist ON Song.artistId = Artist.artistId")
    fun getSongAndArtist(): Map<Song, Artist>
    

    Bire Çok İlişki Haritası (Standart çoklu eşleme)

    @Query("SELECT * FROM Artist JOIN Album ON Artist.id = Album.artistId")
    fun getArtistAndAlbums(): Map<Artist, List<Album>>
    

    Çoklu eşleme sonucu, LiveData, Rx'in Observable veya eş yordamlar Flow gibi desteklenen eş zamansız dönüş türlerine de sarmalanabilir.

Oda çağrısı

  • androidx.room:room-paging yayınlandı. Bu sürüm, androidx.paging.PagingSource döndüren Room sorguları için yerel Paging 3.0 desteği sunuyor.

    @Dao
    interface UserDao {
      @Query("SELECT * FROM users ORDER BY id ASC")
      fun loadUsers(): PagingSource<Int, User>
    }
    
  • Bu yapı, Room tarafından oluşturulan androidx.paging.PagingSource uygulamasını Paging 3.0 API'leri üzerine oluşturulmuş bir uygulamayla değiştirir. Yeni PagingSource uygulaması, anahtarları farklı şekilde ayrıştırır. Bu nedenle, Room'un PagingSource'una manuel olarak sağlanan tüm anahtarların, Pager'ın oluşturucusu aracılığıyla iletilen initialKey de dahil olmak üzere bu davranış değişikliğini hesaba katması gerekir. Sayfalar Key ile yüklenmeye başlayacak ve ilk yüklenen öğe Key olacak. Bu, LoadParams.Refresh.Key öğesinin kullanıcının kaydırma konumu olarak değerlendirildiği ve öğelerin anahtardan önce ve sonra yüklendiği mevcut davranıştan farklıdır.

  • Bu yapı isteğe bağlıdır ve devre dışı bırakıldığında Room 2.3'te kullanıma sunulan Paging 3.0 için mevcut desteğe geri dönülür. Ancak bu yapı, gelecekteki sürümlerde Paging 3.0 ile Room kullananlar için zorunlu hale gelecektir. Özelliği etkinleştirmek için yeni Room-Paging yapısını sınıf yolunuza ekleyin. Gradle kullanıyorsanız build.gradle dosyanıza aşağıdaki snippet'i ekleyebilirsiniz:

    dependency {
      implementation("androidx.room:room-paging:2.4.0-alpha04")
    }
    

Hata Düzeltmeleri

  • Otomatik taşımalarda yabancı anahtar ihlallerinin işlenmesiyle ilgili bir sorun düzeltildi. (b/190113935)

Sürüm 2.4.0-alpha03

16 Haziran 2021

androidx.room:room-*:2.4.0-alpha03 yayınlandı. 2.4.0-alpha03 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Test edilen veritabanı sınıfını alan yeni bir kurucu API sağlayarak Room'un MigrationTestHelper sınıfını otomatik taşıma işlemlerini destekleyecek şekilde güncelleyin. Bu sayede yardımcı, runMigrationsAndValidate sırasında otomatik taşıma işlemlerini aynı şekilde otomatik olarak ekleyebilir.

Hata Düzeltmeleri

  • Room'un SQLite yerel kitaplığında, Apple'ın M1 çiplerini desteklemeyle ilgili bir sorun düzeltildi. (b/174695268

  • @Transaction işlevinin dönüş türü Flow olduğunda Room'un hata vermemesi sorunu düzeltildi (I56ddd, b/190075899).

  • Dizinlerle ilgili otomatik taşıma işlemlerindeki bir sorun düzeltildi. b/177673291

Bağımlılık Güncellemeleri

  • Room'un KSP desteği artık KSP 1.5.10-1.0.0-beta01'ye bağlıdır. (1ecb11, b/160322705)

Sürüm 2.4.0-alpha02

5 Mayıs 2021

androidx.room:room-*:2.4.0-alpha02 yayınlandı. 2.4.0-alpha02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • @ProvidedAutoMigrationSpec, çalışma zamanında RoomDatabase.Builder#addAutoMigrationSpec() aracılığıyla bir AutoMigrationSpec sağlanacağını bildiren yeni bir API'dir. Bu sayede, bağımlılık ekleme çerçevesi, karmaşık bağımlılıklara ihtiyaç duyduğunda bu tür spesifikasyonları sağlayabilir.

Hata Düzeltmeleri

  • @DatabaseView öğelerinin düzgün şekilde yeniden oluşturulmadığı otomatik taşıma işlemleriyle ilgili bir sorun düzeltildi.

Harici Katkı

  • Room'un JournalMode.TRUNCATE sürümünde, InvalidationTracker geri çağırma işlevinin bazen geçersiz şekilde, çok geç veya hiç çağrılmamasına neden olan sorun düzeltildi. Uli Bubenheimer | bubenheimer@users.noreply.github.com'e teşekkürler (b/154040286)

Sürüm 2.4.0-alpha01

21 Nisan 2021

androidx.room:room-*:2.4.0-alpha01 yayınlandı. 2.4.0-alpha01 sürümü bu taahhütleri içerir.

Yeni özellikler

  • Otomatik Taşımalar: Room artık şemalar dışa aktarıldığı sürece otomatik olarak taşıma işlemleri oluşturmak için bir API sunuyor. Room'un otomatik taşıma işlemi oluşturması gerektiğini bildirmek için yeni bir @Database#autoMigrations özelliği kullanılarak otomatik taşıma işleminin hangi sürümler arasında yapılacağı belirtilebilir. Room'un tablolar ve sütunların yeniden adlandırılması veya silinmesiyle ilgili ek bilgilere ihtiyacı olduğunda @AutoMigration ek açıklaması, bu tür girişleri içeren bir spesifikasyon sınıfı tanımlayabilir. Daha fazla bilgi için @AutoMigration belgelerini inceleyin.

Hata Düzeltmeleri

  • Ek parantez içeren defaultValue ifadelerinin Room'un şema doğrulaması tarafından yanlış doğrulanmasına neden olan sorun düzeltildi. b/182284899

Sürüm 2.3.0

Sürüm 2.3.0

21 Nisan 2021

androidx.room:room-*:2.3.0 yayınlandı. 2.3.0 sürümü bu commit'leri içerir.

2.2.0 sürümünden sonra yapılan önemli değişiklikler

  • Yerleşik Enum Desteği: Room, artık sağlanmadığı takdirde varsayılan olarak Enum'dan dizeye ve dizeden Enum'a tür dönüştürücü kullanır. Bir enum için tür dönüştürücü zaten varsa Room, varsayılan dönüştürücü yerine bu dönüştürücüyü kullanmaya öncelik verir.
  • Sorgu Geri Çağırma: Room artık sorgular yürütülmek üzereyken genel bir geri çağırma API'si olan RoomDatabase.QueryCallback'i sunuyor. Bu API, hata ayıklama derlemelerine giriş yapmak için yararlı olabilir. Geri çağırma, RoomDatabase.Builder#setQueryCallback() üzerinden ayarlanabilir.
  • Önceden Paketlenmiş İyileştirme: Room artık bir giriş akışından okunan önceden paketlenmiş bir veritabanını kullanarak veritabanı oluşturmak için API'lere sahiptir. Bu sayede, önceden paketlenmiş veritabanının gzip ile sıkıştırıldığı durumlar gibi senaryolar desteklenir.
  • Sağlanan Tür Dönüştürücüler: Room artık tür dönüştürücü örnekleri sağlamak için API'lere sahiptir. Böylece uygulama, başlatma işlemlerini kontrol edebilir. Room'a sağlanacak bir tür dönüştürücüyü işaretlemek için yeni @ProvidedTypeConverter ek açıklamasını kullanın.
  • RxJava3 desteği: Room artık RxJava3 türlerini destekliyor. RxJava2'ye benzer şekilde, dönüş türü Flowable, Single, Maybe ve Completable olan DAO yöntemleri tanımlayabilirsiniz. Ayrıca RxJava3'ü desteklemek için yeni bir yapı androidx.room:room-rxjava3 kullanılabilir.
  • Paging 3.0 desteği: Room artık dönüş türü androidx.paging.PagingSource olan @Query ek açıklamalı yöntemler için uygulama oluşturmayı destekleyecek.

Sürüm 2.3.0-rc01

24 Mart 2021

androidx.room:room-*:2.3.0-rc01 yayınlandı. 2.3.0-rc01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Room tarafından oluşturulan Coroutine Flow sorgularının askıya alınan bir withTransaction bloğunda kullanılmasını engelleyen sorun düzeltildi. (I797bf)

Sürüm 2.3.0-beta03

10 Mart 2021

androidx.room:room-*:2.3.0-beta03 yayınlandı. 2.3.0-beta03 sürümü bu taahhütleri içerir.

Yeni özellikler

Hata Düzeltmeleri

  • Ana iş parçacığında PagingSource oluşturulmasının ANR'yi tetiklemesine neden olan hata düzeltildi. (I42b74, b/181221318)
  • @ExperimentalRoomApi görünürlüğü, pakete özel yerine herkese açık olacak şekilde düzeltildi. (b/181356119)

Harici Katkı

  • Room'un, @SkipQueryVerification ile de ek açıklama eklenmiş bir @Query ek açıklamalı DAO yönteminde POJO dönüş türünü kabul etmesine izin verin. Room, sorgunun sonucunu @RawQuery ek açıklamalı DAO yöntemiyle aynı şekilde POJO dönüş türüne dönüştürmek için elinden geleni yapar. "Markus Riegel | hey@marcorei.com"a teşekkürler. (I45acb)

Sürüm 2.3.0-beta02

18 Şubat 2021

androidx.room:room-*:2.3.0-beta02 yayınlandı. 2.3.0-beta02 sürümü bu commit'leri içerir.

Yeni özellikler

  • Room artık Kotlin Sembol İşleme'yi (KSP) deneysel olarak destekliyor.

    KSP, ek açıklama işleyicileri Kotlin derleyicisinde yerel olarak çalıştırmak için KAPT'nin yerine kullanılır ve derleme sürelerini önemli ölçüde azaltır.

    Room'u KSP ile kullanmak için KSP Gradle eklentisini uygulayabilir ve derleme dosyanızdaki kapt yapılandırmasını ksp ile değiştirebilirsiniz. Örneğin, kapt 'androidx.room:room-compiler:2.3.0-beta02' yerine ksp 'androidx.room:room-compiler:2.3.0-beta02' kullanın. Daha fazla bilgi için KSP belgelerine bakın.

    KSP deneysel olduğundan üretim kodu için KAPT'nin kullanılmaya devam edilmesi önerilir. Derleme sürelerinin azaltılması yalnızca KAPT kullanan başka işlemci yoksa geçerlidir. Bilinen sorunlar için b/160322705 sayfasına bakın.

Sürüm 2.3.0-beta01

27 Ocak 2021

androidx.room:room-*:2.3.0-beta01 yayınlandı. 2.3.0-beta01 sürümü bu kayıtları içerir.

Yeni özellikler

  • Otomatik Kapatılabilir Veritabanları: Room artık belirli bir süre sonra erişilmeyen veritabanlarını kapatabilir. Bu, deneysel bir özelliktir ve RoomDatabase.Builder#setAutoCloseTimeout() çağrılarak etkinleştirilebilir. Bu özellik, birden fazla veritabanı içeren uygulamalar için kullanışlıdır.

Hata Düzeltmeleri

  • Farklı çakışma stratejilerine sahip birden fazla @Update veya @Delete yöntemi içeren Dao yöntemlerinin, stratejilerden yalnızca biriyle kod oluşturarak tanımlanan stratejiyi etkili bir şekilde yok saymasına neden olan sorun düzeltildi. (/I0b90d, b/176138543)

Sürüm 2.3.0-alpha04

16 Aralık 2020

androidx.room:room-*:2.3.0-alpha04 yayınlandı. 2.3.0-alpha04 sürümü bu kayıtları içerir.

Yeni özellikler

  • Room artık sorgular yürütülmek üzereyken genel bir geri çağırma API'si RoomDatabase.QueryCallback sunuyor. Bu API, hata ayıklama derlemelerine giriş yapmak için kullanılabilir. Geri çağırma, RoomDatabase.Builder#setQueryCallback() üzerinden ayarlanabilir. (Iaa513, b/174478034, b/74877608)
  • Room, artık sağlanmadığı takdirde varsayılan olarak Enum'dan dizeye ve dizeden Enum'a tür dönüştürücü kullanır. Bir enum için tür dönüştürücü zaten varsa Room, varsayılan dönüştürücü yerine bu dönüştürücüyü kullanmaya öncelik verir. (b/73132006)

Bilinen Sorun

  • Enum için okuma amaçlı tek yönlü bir tür dönüştürücü zaten varsa Room, yerleşik dize-Enum dönüştürücüyü yanlışlıkla kullanabilir. Bu durum istenmeyebilir. Bu bilinen bir sorundur ve iki yönlü dönüştürücü kullanılarak düzeltilebilir. Bkz. b/175707691

Hata Düzeltmeleri

  • Room'un, yeni JDK sürümlerinde artımlı ek açıklama işlemeyi yanlışlıkla devre dışı bırakmasına neden olan sorun düzeltildi. (b/171387388)
  • Birden fazla sınıf yükleyici kullanıldığında Room'un oluşturulan sınıfı bulmasıyla ilgili sorun düzeltildi. Düzeltme için teşekkürler "Serendipity | 892449346@qq.com"! (b/170141113)
  • Kotlin @Dao, JVM'de temel türleri olan bir temel sınıfa sahip olduğunda Room'un yanlış kod oluşturmasına neden olan sorun düzeltildi. (b/160258066)

Harici Katkı

  • WAL modu etkinse ve API 16 veya daha yüksekse oda artık varsayılan olarak beginTransactionNonExclusive kullanacak. "Ahmed I." adlı kullanıcıya teşekkürler. Khalil | ahmedibrahimkhali@gmail.com’! (b/126258791)

Sürüm 2.3.0-alpha03

14 Ekim 2020

androidx.room:room-*:2.3.0-alpha03 yayınlandı. 2.3.0-alpha03 sürümü bu kayıtları içerir.

Yeni özellikler

  • Room artık tür dönüştürücü örnekleri sağlayan API'lere sahip. Böylece uygulama, bunların başlatılmasını kontrol edebilir. Room'a sağlanacak bir tür dönüştürücüyü işaretlemek için yeni @ProvidedTypeConverter ek açıklamasını kullanın. "mzgreen yairobbe@gmail.com" adlı kullanıcıya teşekkürler. (Ie4fa5, b/121067210)

  • Room artık bir giriş akışından okunan önceden paketlenmiş bir veritabanını kullanarak veritabanı oluşturmak için API'lere sahiptir. Bu sayede, önceden paketlenmiş veritabanının gzip ile sıkıştırıldığı durumlar gibi senaryolar desteklenir. "Ahmed El-Helw ahmedre@gmail.com"a teşekkürler (3e6792, b/146911060)

API Değişiklikleri

  • @ForeignKey ek açıklamasına eksik hedef eklenerek @Entity ek açıklaması dışında kullanılması engellendi. (Iced1e)

  • RoomDatabase.java tablosundaki mCallbacks alanı artık gizli. (d576cb, b/76109329)

Hata Düzeltmeleri

  • TypeConverters'ın yalnızca sütunları/alanları dönüştürmek için kullanılabileceğini ve satırları dönüştürmek için kullanılamayacağını açıklığa kavuşturmak amacıyla TypeConverters dokümanları güncellendi. (I07c56, b/77307836)

  • Kotlin "temel öğeleri" içeren genel bir süper türe sahip DAO'daki derleyici hatasını düzeltmek için DaoProcessor'da güncelleme yapıldı. (Ice6bb, b/160258066)

  • İş parçacığı oluşturmayı netleştirmek için gözlemci ekleme/kaldırma yöntemleri dokümanları güncellendi (Ifd1d9, b/153948821)

  • Room'un, rowid sütununu beyan eden FTS tablolarını yanlış şekilde doğrulamasıyla ilgili sorun düzeltildi. (d62ebc, b/145858914)

Harici Katkılar

  • Türkçe ile ilgili büyük/küçük harf yerel ayar sorunlarını düzeltme (5746e3), b/68159494

  • Android Lollipop'ta sorun yaşamamak için RoomDatabase içindeki ConcurrentHashMap öğesini Collections.synchronizedMap() ile değiştirin (d1cfc7, b/162431855)

  • Önceden paketlenmiş bir veritabanı kopyalandığında onOpenPrepackagedDatabase geri çağırma işlevi ekleyin. (I1ba74, b/148934423)

Sürüm 2.3.0-alpha02

22 Temmuz 2020

androidx.room:room-*:2.3.0-alpha02 yayınlandı. 2.3.0-alpha02 sürümü bu kayıtları içerir.

Yeni özellikler

  • RxJava3 desteği: Room artık RxJava3 türlerini destekliyor. RxJava2'ye benzer şekilde, dönüş türü Flowable, Single, Maybe ve Completable olan DAO yöntemleri tanımlayabilirsiniz. Ayrıca RxJava3'ü desteklemek için yeni bir yapı androidx.room:room-rxjava3 kullanılabilir. (b/152427884)

API Değişiklikleri

  • Kotlin Object sınıfında @TypeConverter tanımlama artık destekleniyor. (b/151110764)
  • Room artımlı ek açıklama işleme seçeneği artık varsayılan olarak ETKİN. (b/112110217)

Sürüm 2.3.0-alpha01

10 Haziran 2020

androidx.room:room-*:2.3.0-alpha01 yayınlandı. 2.3.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

  • Paging 3.0 Desteği: Room artık dönüş türü androidx.paging.PagingSource olan @Query ek açıklamalı yöntemler için uygulama oluşturmayı destekleyecek.

    @Dao
    interface UserDao {
      @Query("SELECT * FROM users ORDER BY id ASC")
      fun pagingSource(): PagingSource<Int, User>
    }
    

API Değişiklikleri

  • @RewriteQueriesToDropUnusedColumns, Room'un bir sorgudaki "*" projeksiyonunu, sonuçtaki kullanılmayan sütunlar kaldırılacak şekilde yeniden yazmasını sağlayan yeni ve kullanışlı bir ek açıklamadır.
  • room.expandProjection işlemci seçeneği artık kullanılmıyor. Yıldız projeksiyonları içeren oda optimizasyonu sorgularının yerine @RewriteQueriesToDropUnusedColumns kullanın. @RewriteQueriesToDropUnusedColumns, @Embedded alanları içeren dönüş türleriyle ilgili olarak sunulan room.expandProjection sütun çakışması çözümünün yerini almaz.

Hata Düzeltmeleri

  • Room'un, artımlı ek açıklama işleyiciyi etkinleştirmek için kullanılan JDK sürümünü doğru şekilde algılamamasına neden olan hata düzeltildi. Blaz Solar'a (me@blaz.solar) teşekkürler (b/155215201)
  • Room, ANTLR kullanan diğer işlemcilerle sürüm çakışmalarını önlemek için artık ANTLR bağımlılığını ek açıklama işleyicisiyle yerleştiriyor. (b/150106190)

Sürüm 2.2.6

Sürüm 2.2.6

16 Aralık 2020

androidx.room:room-*:2.2.6 yayınlandı. 2.2.6 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Room'un, yeni JDK sürümlerinde artımlı ek açıklama işlemeyi yanlışlıkla devre dışı bırakmasına neden olan sorun düzeltildi. (b/171387388)

Sürüm 2.2.5

Sürüm 2.2.5

18 Mart 2020

androidx.room:room-*:2.2.5 yayınlandı. 2.2.5 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • MultiInstanceInvalidationService öğesini directBootAware yapın. "Mygod contact-git@mygod.be" (b/148240967) adlı kullanıcıya teşekkür ederiz.
  • Aynı anda çalışan birden çok kopya geçersiz kılma etkinleştirildiğinde ve veritabanında bir FTS varlığı bulunduğunda kilitlenmeye neden olan hata düzeltildi. (b/148969394)
  • Room ek açıklama işleyicisinde SQLite yerel kitaplıkları yüklenirken paralel derlemeler nedeniyle derleyicinin kilitlenmesine neden olan sorun düzeltildi. (b/146217083)

Sürüm 2.2.4

Sürüm 2.2.4

19 Şubat 2020

androidx.room:room-common:2.2.4, androidx.room:room-compiler:2.2.4, androidx.room:room-guava:2.2.4, androidx.room:room-ktx:2.2.4, androidx.room:room-migration:2.2.4, androidx.room:room-runtime:2.2.4, androidx.room:room-rxjava2:2.2.4 ve androidx.room:room-testing:2.2.4 yayınlandı. 2.2.4 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • İşlemlerin askıya alınmasıyla ilgili bir sorun düzeltildi. Bu sorunda, eş yordam işlem gerçekten başlamadan önce hızlı bir şekilde iptal edilirse işlemler kilitleniyordu. (b/148181325)
  • JDK 9 ile derleme yaparken @Generated'ın yanlış kullanılmasıyla ilgili sorun düzeltildi. (b/146538330)
  • Kotlin'deki bir DAO arayüzünde somut bir işlev olduğunda Room'un yanlış kod oluşturmasına neden olan sorun düzeltildi. (b/146825845)

Sürüm 2.2.3

Sürüm 2.2.3

18 Aralık 2019

androidx.room:room-*:2.2.3 yayınlandı. 2.2.3 sürümü bu commit'leri içerir.

Hata düzeltmeleri

  • Room'un, herhangi bir taşıma işleminden geçmemiş ve şemasında dizinler içeren eski bir karma değeri olan veritabanını doğrulayamamasına neden olan hata düzeltildi. (b/139306173)

Sürüm 2.2.2

Sürüm 2.2.2

20 Kasım 2019

androidx.room:room-*:2.2.2 yayınlandı. 2.2.2 sürümü bu commit'leri içerir.

Hata düzeltmeleri

  • 999'dan fazla satır içeren bire bir ilişkinin toplanmasının, Room'un boş ilgili öğeler döndürmesine neden olduğu hata düzeltildi. (b/143105450)

Sürüm 2.2.1

Sürüm 2.2.1

23 Ekim 2019

androidx.room:room-*:2.2.1 yayınlandı. 2.2.1 sürümü bu commit'leri içerir.

Hata düzeltmeleri

  • Derleyici seçeneği expandProjection açıkken Room'un CURSOR_MISMATCH hakkında yanlış uyarı vermesine neden olan bir hata düzeltildi. (b/140759491)
  • Derleme süresi boyunca sorguları doğrulamak için kullanılan eksik yerel kitaplığı işlemek üzere bir yeniden deneme mekanizması eklendi.

Sürüm 2.2.0

Sürüm 2.2.0

9 Ekim 2019

androidx.room:room-*:2.2.0 yayınlandı. 2.2.0 sürümü bu commit'leri içerir.

2.1.0 sürümünden sonra yapılan önemli değişiklikler

  • Önceden Paketlenmiş Veritabanı: RoomDatabase.Builder içinde, önceden doldurulmuş bir veritabanı dosyası verildiğinde RoomDatabase oluşturmak için iki yeni API kullanıma sunuldu. createFromAsset(), önceden doldurulmuş veritabanı dosyası APK'nın öğeler klasöründeyken, createFromFile() ise dosya rastgele bir konumdayken kullanılır. Bu API'lerin kullanımı, yıkıcı taşıma işlemlerinin davranışını değiştirir. Böylece, yedek taşıma işlemi sırasında Room, varsa önceden doldurulmuş veritabanını yeniden kopyalamaya çalışır. Aksi takdirde, yalnızca tüm tabloları bırakıp yeniden oluşturur. b/62185732
  • Şema Varsayılan Değerleri: @ColumnInfo artık bir sütunun varsayılan değerini belirtmek için kullanılabilecek yeni bir defaultValue özelliğine sahip. Varsayılan değerler, veritabanı şemasının bir parçasıdır ve belirtilmişse taşıma işlemleri sırasında doğrulanır. b/64088772
  • Çoka Çok İlişkiler: @Relation artık yeni bir ek açıklama @Junction alan yeni bir associateBy özelliğine sahip. Bu özellik, bir bağlantı tablosu (birleştirme tablosu olarak da bilinir) aracılığıyla karşılanması gereken bir ilişkiyi bildirmek için kullanılır. b/69201917
  • Bire Bir İlişkiler: @Relation ile ek açıklama eklenen POJO alanlarındaki List veya Set türünde olma kısıtlaması kaldırıldı. Böylece tek değerli ilişkiler temsil edilebilecek. b/62905145
  • Hedef Varlık: DAO ek açıklamaları @Insert, @Update ve @Delete artık DAO yönteminin üzerinde işlem yapması gereken hedef tabloyu belirtmeye olanak tanıyan yeni bir targetEntity özelliğine sahip. Bu sayede, DAO yöntemlerinin parametreleri, kısmi varlıklar olarak yorumlanacak rastgele POJO'lar olabilir. Uygulamada bu, kısmi ekleme, silme ve güncelleme işlemlerine olanak tanır. b/127549506
  • Coroutines Flow: @Query DAO yöntemleri artık Flow<T> dönüş türünde olabilir. Döndürülen akış, sorgudaki gözlem tabloları geçersiz kılınırsa yeni bir değer grubu yeniden yayınlar. Channel<T> dönüş türüyle bir DAO işlevi tanımlamak hataya neden olur. Room bunun yerine Flow kullanmanızı ve ardından Flow değerini Channel değerine dönüştürmek için komşu işlevleri kullanmanızı önerir. b/130428884
  • Gradle Artımlı Ek Açıklama İşleyicisi: Room artık bir Gradle yalıtım ek açıklama işleyicisidir ve artımlılık, işleyici seçeneği room.incremental aracılığıyla etkinleştirilebilir. Daha fazla bilgi için Room Derleyici Seçenekleri'ne bakın. Herhangi bir sorunla karşılaşırsanız lütfen buradan hata bildiriminde bulunun. Gelecekteki kararlı bir sürümde artımlılığı varsayılan olarak etkinleştirmeyi planlıyoruz. b/112110217
  • Projeksiyonları genişletme: Room'un, yıldız projeksiyonu içeren bir sorguyu yalnızca döndürülen türdeki POJO'da bulunan sütunları içerecek şekilde yeniden yazmasına neden olan yeni bir deneysel derleyici seçeneği room.expandProjection eklendi. Örneğin, yalnızca iki alanı olan SongIdAndTitle adlı bir POJO döndüren @Query("SELECT * FROM Song") içeren bir DAO yöntemi için. Ardından Room, sorguyu SELECT id, title FROM Song olarak yeniden yazar. Böylece, dönüş türünü karşılayacak minimum sütun grubu getirilir. Bu, sorgu, döndürülen POJO türündeki hiçbir alanla eşleşmeyen ek sütunlar döndürdüğünde gösterilen CURSOR_MISMATCH uyarısını ortadan kaldırır.

Sürüm 2.2.0-rc01

5 Eylül 2019

androidx.room:room:2.2.0-rc01 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Oda 2.2.0-beta01 sürümünden bu yana herkese açık değişiklik yapılmadı.

Sürüm 2.2.0-beta01

22 Ağustos 2019

androidx.room:room-*:2.2.0-beta01 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Hata düzeltmeleri

  • Coroutine Flow sorgusunun belirli bir süre sonra yeni değerleri yeniden yayınlamayı durdurmasına neden olan hata düzeltildi. (b/139175786)
  • Room'un, Room 1.0'dan beri taşınmamış bir veritabanını açarken eski şema karma kodunu kabul etmemesine ve geçersiz şema nedeniyle çalışma zamanı kilitlenmesine neden olan bir hata düzeltildi. (b/139306173)

Sürüm 2.2.0-alpha02

7 Ağustos 2019

androidx.room:room-*:2.2.0-alpha02 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

  • Coroutines Flow: @Query DAO yöntemleri artık Flow<T> dönüş türünde olabilir. Döndürülen akış, sorgudaki gözlem tabloları geçersiz kılınırsa yeni bir değer grubu yeniden yayınlar. Channel<T> dönüş türüyle bir DAO işlevi tanımlamak hataya neden olur. Room bunun yerine Flow kullanmanızı ve ardından Flow değerini Channel değerine dönüştürmek için komşu işlevleri kullanmanızı önerir. b/130428884
  • Projeksiyonları genişletme: Room'un, yıldız projeksiyonu içeren bir sorguyu yalnızca döndürülen türdeki POJO'da bulunan sütunları içerecek şekilde yeniden yazmasına neden olan yeni bir deneysel derleyici seçeneği room.expandProjection eklendi. Örneğin, yalnızca iki alanı olan SongIdAndTitle adlı bir POJO döndüren @Query("SELECT * FROM Song") içeren bir DAO yöntemi için. Ardından Room, sorguyu SELECT id, title FROM Song olarak yeniden yazar. Böylece, dönüş türünü karşılayacak minimum sütun grubu getirilir. Bu, sorgu, döndürülen POJO türündeki hiçbir alanla eşleşmeyen ek sütunlar döndürdüğünde gösterilen CURSOR_MISMATCH uyarısını ortadan kaldırır.
  • onDestructiveMigrate, Room bir veritabanını yıkıcı bir şekilde taşıdığında kullanılmak üzere RoomDatabase.Callback sınıfına eklenen yeni bir geri çağırma API'sidir. b/79962330

Hata Düzeltmeleri

  • Alan korumalıyken Room'un, alan ayarlayıcı olarak bir yöntem kullanarak yanlış kod oluşturmasına neden olan hata düzeltildi. b/136194628
  • Aynı anda çalışan birden çok kopya geçersiz kılma etkinleştirildiğinde ve geçersiz kılma hizmeti sonlandırıldığında InvalidationTracker'ın ikinci bir işlemde NPE hatası vermesine neden olan hata düzeltildi. b/137454915
  • Room'un, @RawQuery ile ek açıklama eklenmiş devralınan bir askıya alma işlevinin dönüş türünü doğru şekilde tanımlamamasına neden olan hata düzeltildi. b/137878827
  • İlişkili anahtar BLOB türünde olduğunda @Relation için oluşturulan kod, karşılaştırılabilir bir ByteBuffer kullanacak şekilde güncellendi. b/137881998
  • Room'un, @Insert, @Update ve @Delete'nin kısmi varlık parametreleri olarak kullanılan POJO'larda eksik ayarlayıcılarla ilgili hata vermesine neden olan bir hata düzeltildi. b/138664463
  • Varlık sınıfı belirli DAO yöntemlerinde kullanıldığında Room'un, @Entity aracılığıyla yoksayılan bir sütun için eksik alıcılar ve ayarlayıcılar hakkında şikayette bulunmasına neden olan hata düzeltildi. b/138238182
  • Room'un, adlandırılmış bağlama bağımsız değişkenlerini konumsal bağımsız değişkenlere doğru şekilde dönüştürmemesine ve yeniden kullanılan parametrelerle bir sorgu yürütürken çalışma zamanı istisnasına neden olan hata düzeltildi. b/137254857

Sürüm 2.2.0-alpha01

10 Temmuz 2019

Yeni özellikler

  • Önceden Paketlenmiş Veritabanı: RoomDatabase.Builder içinde, önceden doldurulmuş bir veritabanı dosyası verildiğinde RoomDatabase oluşturmak için iki yeni API kullanıma sunuldu. createFromAsset(), önceden doldurulmuş veritabanı dosyası APK'nın öğeler klasöründeyken, createFromFile() ise dosya rastgele bir konumdayken kullanılır. Bu API'lerin kullanımı, yıkıcı taşıma işlemlerinin davranışını değiştirir. Böylece, yedek taşıma işlemi sırasında Room, varsa önceden doldurulmuş veritabanını yeniden kopyalamaya çalışır. Aksi takdirde, yalnızca tüm tabloları bırakıp yeniden oluşturur. b/62185732
  • Şema Varsayılan Değerleri: @ColumnInfo artık bir sütunun varsayılan değerini belirtmek için kullanılabilecek yeni bir defaultValue özelliğine sahip. Varsayılan değerler, veritabanı şemasının bir parçasıdır ve belirtilmişse taşıma işlemleri sırasında doğrulanır. b/64088772

    Not: Veritabanı şemanızda ALTER TABLE x ADD COLUMN y INTEGER NOTNULL DEFAULT z aracılığıyla eklenenler gibi varsayılan değerler varsa ve aynı sütunlar için @ColumnInfo aracılığıyla varsayılan değerler tanımlamaya karar verirseniz hesaba katılmayan varsayılan değerleri doğrulamak için taşıma işlemi yapmanız gerekebilir. Daha fazla bilgi için Oda Taşıma İşlemleri başlıklı makaleyi inceleyin.

  • Çoka Çok İlişkiler: @Relation artık yeni bir ek açıklama @Junction alan yeni bir associateBy özelliğine sahip. Bu özellik, bir bağlantı tablosu (birleştirme tablosu olarak da bilinir) aracılığıyla karşılanması gereken bir ilişkiyi bildirmek için kullanılır. b/69201917
  • Bire Bir İlişkiler: @Relation ile ek açıklama eklenen POJO alanlarındaki List veya Set türünde olma kısıtlaması kaldırıldı. Böylece tek değerli ilişkiler temsil edilebilecek. b/62905145
  • Hedef Varlık: DAO ek açıklamaları @Insert, @Update ve @Delete artık DAO yönteminin üzerinde işlem yapması gereken hedef tabloyu belirtmeye olanak tanıyan yeni bir targetEntity özelliğine sahip. Bu sayede, DAO yöntemlerinin parametreleri, kısmi varlıklar olarak yorumlanacak rastgele POJO'lar olabilir. Uygulamada bu, kısmi ekleme, silme ve güncelleme işlemlerine olanak tanır. b/127549506
  • Gradle Artımlı Ek Açıklama İşleyicisi: Room artık bir Gradle yalıtım ek açıklama işleyicisidir ve artımlılık, işleyici seçeneği room.incremental aracılığıyla etkinleştirilebilir. Daha fazla bilgi için Room Derleyici Seçenekleri'ne bakın. Herhangi bir sorunla karşılaşırsanız lütfen buradan hata bildiriminde bulunun. Gelecekteki kararlı bir sürümde artımlılığı varsayılan olarak etkinleştirmeyi planlıyoruz. b/112110217

Hata Düzeltmeleri

  • Sorgunun Rx akışı sorgu tamamlanmadan önce silindiğinde Room artık EmptySetResultException öğesini genel hata işleyiciye yaymayacak. b/130257475
  • @RawQuery ile ek açıklama eklenmiş bir askıya alma DAO işlevinin dönüş türü olmadığında Room'un yanlış bir hata mesajı göstermesine neden olan hata düzeltildi. b/134303897
  • Room artık ham türlerle DAO bağdaştırıcıları oluşturmayacak. b/135747255

Sürüm 2.1.0

Sürüm 2.1.0

13 Haziran 2019

Room 2.1.0, 2.1.0-rc01 sürümüne kıyasla herhangi bir değişiklik olmadan yayınlandı. Sürümde yer alan commit'leri burada bulabilirsiniz.

2.0.0 sürümünden sonra yapılan önemli değişiklikler

  • FTS: Room artık FTS3 veya FTS4 tablosuyla eşlenen varlıkları destekliyor. @Entity ile ek açıklama eklenen sınıflara artık @Fts3 veya @Fts4 ile ek açıklama eklenerek tam metin arama tablosu eşlemesi olan bir sınıf tanımlanabilir. Daha fazla özelleştirme için FTS seçenekleri, ek açıklama yöntemleri aracılığıyla kullanılabilir.
  • Görünümler: Room artık @DatabaseView ek açıklamasını kullanarak bir sınıfı, görünüm olarak da bilinen depolanmış sorgu olarak tanımlamayı destekliyor.
  • Eş yordamlar: DAO yöntemleri artık askıya alma işlevleri olabilir. Bu işlevden yararlanmak için bağımlılıklarınıza room-ktx öğesini ekleyin. ktx yapısı, bir eş yordam içinde veritabanı işlemleri gerçekleştirmek için RoomDatabase.withTransaction uzantı işlevini de sağlar.
  • Auto Value: Room artık AutoValue ek açıklamalı sınıfların varlık ve POJO olarak tanımlanmasını destekliyor. @PrimaryKey, @ColumnInfo, @Embedded ve @Relation Room ek açıklamaları artık otomatik değer ek açıklamalı bir sınıfın soyut yöntemlerinde bildirilebilir. Room'un bu ek açıklamaları doğru şekilde anlayabilmesi için @CopyAnnotations ile birlikte kullanılması gerektiğini unutmayın.
  • Ek eş zamansız desteği: @Insert, @Delete veya @Update ile ek açıklama eklenmiş DAO yöntemleri ve INSERT, DELETE ya da UPDATE ifadeleri içeren @Query artık Rx dönüş türleri Completable, Single, Maybe ve Guava'nın dönüş türü ListenableFuture'yi destekliyor. Ayrıca askıya alma işlevleri de olabilir.
  • enableMultiInstanceInvalidation, aynı veritabanı dosyasını kullanan birden fazla RoomDatabase örneğinde geçersiz kılma işlemini etkinleştirmek için RoomDatabase.Builder sürümünde sunulan yeni bir API'dir.
  • fallbackToDestructiveMigrationOnDowngrade, sürüm düşürme işlemi gerçekleşirse veritabanını otomatik olarak yeniden oluşturmak için RoomDatabase.Builder sürümünde sunulan yeni bir API'dir.
  • ignoredColumns, @Entity ek açıklamasında bulunan ve yoksayılan alanları ada göre listelemek için kullanılabilen yeni bir API'dir.
  • Room artık veri sınıflarında Kotlin'in birincil kurucusunu doğru şekilde kullanarak özellikleri vars olarak tanımlama ihtiyacını ortadan kaldıracak.

Sürüm 2.1.0-rc01

29 Mayıs 2019

Hata Düzeltmeleri

  • Önceden ayarlanmış bir temp_store yapılandırması nedeniyle oluşabilecek bir Room başlatma hatası düzeltildi. b/132602198
  • SQLite 3.27.0 ve sonraki sürümleri kullanan kullanıcılar için çift tırnak kullanımı uyarısı düzeltildi. b/131712640
  • Birden fazla geçersiz kılma kontrolü paralel olarak gerçekleştiğinde InvalidationTracker'ın kilitlenmesine neden olan bir hata düzeltildi. b/133457594

Sürüm 2.1.0-beta01

7 Mayıs 2019

androidx.room 2.1.0-beta01, 2.1.0-alpha07 sürümünden herhangi bir değişiklik yapılmadan yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Sürüm 2.1.0-alpha07

25 Nisan 2019

API/Davranış Değişiklikleri

  • RoomDatabase.withTransaction uzantı işlevi, artık alıcı olarak CoroutineScope içeren bir işlev bloğu almayacak şekilde değiştirildi. Bu, işlem bloğundaki öğeleri eşzamanlı olarak çalıştırmak için gereken ek coroutineScope { } sarmalayıcısının atlanmasını önler.

Hata Düzeltmeleri

  • Room'un, Collection türünde bir parametre içeren Kotlin DAO işlevi için TypeConverter'ı eşleştirememesine neden olan hata düzeltildi. b/122066791

Sürüm 2.1.0-alpha06

22 Mart 2019

API/Davranış Değişiklikleri

  • Eşzamansız işlem sorguları artık Room'un veritabanı işlemlerini yürütmek için birden fazla iş parçacığı kullanmayacağı şekilde serileştirilir. İşlemler için kullanılacak yürütücünün yapılandırılmasına izin vermek amacıyla RoomDatabase.Builder.setTransactionExecutor(Executor) eklendi.
  • RoomDatabase.runInTransaction(Callable), denetlenen istisnaları artık RuntimeExceptions'a sarmayacak. b/128623748

Hata Düzeltmeleri

  • Hem içerik tablosu hem de harici içerik FTS tablosu için gözlemciler eklendiğinde geçersiz kılma izleyicisinin bir içerik tablosunu gözlemlemeyi durdurmasına neden olan hata düzeltildi. b/128508917
  • Room SQLite dil bilgisi, SQLite 3.24.0 ile eşleşecek şekilde güncellendi. b/110883668

Sürüm 2.1.0-alpha05

13 Mart 2019

Yeni özellikler

  • RoomDatabase.withTransaction uzantı işlevi, bir eş yordam içinde veritabanı işlemlerini güvenli bir şekilde gerçekleştirmenize olanak tanır. Eş yordam desteğiyle birlikte Room uzantıları işlevleri room-ktx yapısında kullanılabilir.
  • @Transaction ile ek açıklama eklenen soyut olmayan DAO yöntemleri artık askıya alma işlevleri olabilir. b/120241587

API/Davranış Değişiklikleri

  • room-coroutines yapısı, diğer androidx yapılarıyla aynı adlandırma kuralına uyularak room-ktx olarak yeniden adlandırıldı.
  • RoomDatabase içindeki beginTransaction, setTransactionSuccessful ve endTransaction, runInTransaction ve room-ktx uzantı işlevi withTransaction lehine kullanımdan kaldırıldı.

Hata Düzeltmeleri

  • Kullanılan simgeleştirici SIMPLE ise simgeleştirici bağımsız değişkenlerinin silinmesine neden olan bir hata düzeltildi. b/125427014
  • Room'un, türü dahili sınıf olan parametreleri içeren askıya alma işlevlerini doğru şekilde tanımlayamamasına neden olan hata düzeltildi. b/123767877
  • INSERT, UPDATE veya DELETE ifadeleri içeren ertelenmiş @Query DAO yönteminin, ana iş parçacığında sorguyu istekli bir şekilde hazırlamasına neden olan hata düzeltildi. b/123695593
  • Room'un belirli askıya alma işlevleri için yanlış kod oluşturmasına neden olan çeşitli hatalar düzeltildi. b/123466702 ve b/123457323
  • Kullanımdan kaldırılan yöntemlerin, oluşturulan kodda doğru şekilde engellenmemesine neden olan hata düzeltildi. b/117602586
  • androidx.sqlite'ın Room bağımlılığı, bozuk veritabanlarının doğru şekilde işlenmesiyle ilgili düzeltmeler içeren 1.0.2 sürümüne güncellendi. b/124476912

Bilinen Sorunlar

  • Room 2.1.0-alpha05, şu anda Maven Central'da (KT-27991) bulunmayan kotlinx-metadata-jvm yapısına bağlıdır. Bu bağımlılık, proje depolarınıza maven { url "https://kotlin.bintray.com/kotlinx/" } eklenerek çözülebilir.

Sürüm 2.1.0-alpha04

25 Ocak 2019

Yeni özellikler

  • INSERT, UPDATE veya DELETE ifadeleri içeren @Query ek açıklaması eklenmiş DAO yöntemleri artık Single, Mayble, Completable ve ListenableFuture eş zamansız türlerini döndürebilir. Ayrıca askıya alma işlevleri de olabilirler. b/120227284

API/Davranış Değişiklikleri

  • Room artık @Transaction ile ek açıklama eklenmiş soyut olmayan bir DAO yöntemi Single, Mayble, Completable, LiveData veya ListenableFuture gibi eşzamansız bir tür döndürürse hata verecek. İşlemler iş parçacığıyla sınırlı olduğundan, Room'un farklı iş parçacıklarında sorgu gerçekleştirebilecek bir işlevle ilgili işlem başlatması ve sonlandırması şu anda mümkün değildir. b/120109336
  • OnConflictStrategy.FAIL ve OnConflictStrategy.ROLLBACK, Android'in mevcut SQLite bağlamalarıyla beklendiği gibi çalışmadığı için @Deprecated. b/117266738

Hata Düzeltmeleri

  • DAO yöntemi bir askıya alma işleviyse Room'un, dönüş türünün TypeConverter'ını doğru şekilde kullanmaması sorunu düzeltildi. b/122988159
  • Room'un devralınan askıya alma işlevlerini yanlışlıkla askıya alınmayan işlevler olarak tanımlamasına neden olan bir hata düzeltildi. b/122902595
  • Bir @Embedded alanı üst sınıfta olduğunda ve birden fazla alt sınıfta kullanıldığında Room'un yanlış kod oluşturmasına neden olan hata düzeltildi. b/121099048
  • beginTransaction() ve endTransaction() arasında DAO askıya alma işlevleri çağrılırken veritabanının kilitlenmesine neden olan sorun düzeltildi. b/120854786

Sürüm 2.1.0-alpha03

4 Aralık 2018

API Değişiklikleri

  • @Fts3/@Fts4 içindeki FTS tokenizer artık Enum yerine String alır. Bu sayede Room, özel simgeleştiricileri kullanabilir. Yerleşik simgeleştiriciler, FtsOptions içinde dize sabitleri olarak tanımlanmaya devam ediyor. b/119234881

Yeni özellikler

  • Eş yordamlar: DAO yöntemleri artık askıya alma işlevleri olabilir. Room'da askıya alma işlevlerini desteklemek için yeni bir yapı (room-coroutines) yayınlandı. b/69474692
  • @Insert, @Delete veya @Update ile ek açıklama eklenmiş DAO yöntemleri artık dönüş türü olarak ListenableFuture'yi destekliyor. b/119418331

Hata Düzeltmeleri

  • Room'un, @Entity öğesinin ignoredColumns özelliğinde sütun içeren bir kurucu bulmaya çalışmasına neden olan hata düzeltildi. b/119830714
  • Room'un, oluşturulan uygulamalarında DAO yöntemi parametrelerini nihai olarak işaretlememesine neden olan hata düzeltildi. b/118015483
  • Room işlemcisinin, özel simgeler içeren bir sorguda hata bildirirken kilitlenmesine neden olan bir hata düzeltildi. b/119520136
  • Room'un, IN ifadesinin bağımsız değişkenleri olarak diğer çeşitli Collection uygulamalarını reddetmesine neden olan hata düzeltildi. b/119884035
  • Room'dan döndürülen LiveData'nın, sürekli gözlemlendiğinde çöp toplayıcı tarafından toplanmasına ve artık yeni veri yayınlamamasına neden olan bir hata düzeltildi. b/74477406
  • Kilit çakışmasını azaltmak için RoomDatabase adlı kullanıcının kilit kapatma işlemi güncellendi. b/117900450

Sürüm 2.1.0-alpha02

30 Ekim 2018

Yeni özellikler

  • @Relation içinde @DatabaseView referans verme desteği eklendi. b/117680932

Hata Düzeltmeleri

  • Room'un, bir Rx dönüş türüne abone olurken ve bu türü silerken ana iş parçacığında disk G/Ç işlemi gerçekleştirmesine neden olan hata düzeltildi. b/117201279
  • Room'un, Kotlin varlık sınıfındaki bir alan için uygun tür dönüştürücüyü bulamamasına neden olan hata düzeltildi. b/111404868
  • Room'un, bağımsız değişken içermeyen bir Kotlin varsayılan yöntemi içeren DAO arayüz uygulaması için yanlış kod oluşturmasına neden olan bir hata düzeltildi. b/117527454
  • Room SQLite dil bilgisi ayrıştırıcısı güncellendi ve uzun derleme sürelerine neden olan bir performans sorunu düzeltildi. b/117401230

Sürüm 2.1.0-alpha01

8 Ekim 2018

Yeni özellikler

  • FTS: Room artık FTS3 veya FTS4 eşleme tablosu içeren varlıkları destekliyor. @Entity ile ek açıklama eklenen sınıflara artık @Fts3 veya @Fts4 ile de ek açıklama eklenerek tam metin arama tablosu eşlemesi olan bir sınıf tanımlanabilir. Daha fazla özelleştirme için FTS seçenekleri, ek açıklama yöntemleri aracılığıyla kullanılabilir. b/62356416
  • Görünümler: Room artık @DatabaseView ek açıklamasını kullanarak bir sınıfı depolanmış sorgu (görünüm olarak da bilinir) olarak tanımlamayı destekliyor. b/67033276
  • Auto Value: Room artık AutoValue ek açıklamalı sınıfların varlık ve POJO olarak tanımlanmasını destekliyor. @PrimaryKey, @ColumnInfo, @Embedded ve @Relation Room ek açıklamaları artık otomatik değer ek açıklamalı bir sınıfın soyut yöntemlerinde tanımlanabilir. Room'un bu ek açıklamaları doğru şekilde anlayabilmesi için @CopyAnnotations ile birlikte kullanılması gerektiğini unutmayın. b/62408420
  • Ek Rx Dönüş Türleri Desteği: @Insert, @Delete veya @Update ile ek açıklama eklenmiş DAO yöntemleri artık Rx dönüş türleri Completable, Single<T> ve Maybe<T>'yi destekliyor. b/63317956
  • @Relation ile Değişmez Türler: Room, daha önce @Relation ek açıklamalı alanların ayarlanabilir olmasını gerektiriyordu ancak artık bunlar kurucu parametreleri olabilir.
  • enableMultiInstanceInvalidation: Aynı veritabanı dosyasını kullanan birden fazla RoomDatabase örneğinde geçersiz kılma işlemini etkinleştirmek için RoomDatabase.Builder içinde yeni bir API'dir. Bu aynı anda çalışan birden çok kopya geçersiz kılma mekanizması, birden fazla işlemde de çalışır. b/62334005
  • fallbackToDestructiveMigrationOnDowngrade: Sürüm düşürme işlemi gerçekleşirse veritabanını otomatik olarak yeniden oluşturmak için RoomDatabase.Builder içinde yeni bir API'dir. b/110416954
  • ignoredColumns: @Entity ek açıklamasında, yoksayılan alanları ada göre listelemek için kullanılabilecek yeni bir API'dir. Bir varlıktaki devralınan alanları yoksaymak için kullanışlıdır. b/63522075

API/Davranış Değişiklikleri

  • RoomDatabase içindeki mCallback ve mDatabase artık @Deprecated ve Room'un bir sonraki ana sürümünde kaldırılacak. b/76109329

Hata Düzeltmeleri

  • Room'un, başlatma sırasında bozuk bir veritabanından veya hatalı bir taşıma işleminden düzgün şekilde kurtarılamamasına neden olan iki sorun düzeltildi. b/111504749 ve b/111519144
  • Room artık veri sınıflarında Kotlin'in birincil kurucusunu doğru şekilde kullanacak ve alanları vars olarak tanımlama ihtiyacını ortadan kaldıracak. b/105769985

Sürüm 2.0.0

Sürüm 2.0.0

1 Ekim 2018

androidx.room 2.0.0, 2.0.0-rc01 sürümünden herhangi bir değişiklik yapılmadan yayınlandı.

Sürüm 2.0.0-rc01

20 Eylül 2018

androidx.room 2.0.0-rc01, 2.0.0-beta01 sürümünde herhangi bir değişiklik yapılmadan yayınlandı.

Sürüm 2.0.0-beta01

2 Temmuz 2018

API/Davranış Değişiklikleri

  • Sorguların nerede çalıştırılacağını özelleştirmek için RoomDatabase.Builder.setQueryExecutor() eklendi
  • RxJava2 Observable desteği eklendi
  • Oluşturulan DAO ve Veritabanı uygulamaları artık nihai hale geldi.

Hata Düzeltmeleri

  • "cannot find getter for field" hatasında sınıf/alan adını belirtme b/73334503
  • RoomOpenHelper'ın Room'un eski sürümleriyle geriye dönük uyumluluğu düzeltildi b/110197391

AndroidX Öncesi Bağımlılıklar

Room'un AndroidX öncesi sürümleri için şu bağımlılıkları ekleyin:

dependencies {
    def room_version = "1.1.1"

    implementation "android.arch.persistence.room:runtime:$room_version"
    annotationProcessor "android.arch.persistence.room:compiler:$room_version" // For Kotlin use kapt instead of annotationProcessor

    // optional - RxJava support for Room
    implementation "android.arch.persistence.room:rxjava2:$room_version"

    // optional - Guava support for Room, including Optional and ListenableFuture
    implementation "android.arch.persistence.room:guava:$room_version"

    // Test helpers
    testImplementation "android.arch.persistence.room:testing:$room_version"
}

Sürüm 1.1.1

Sürüm 1.1.1

19 Haziran 2018

1.1.1 numaralı oda, 1.1.1-rc1 numaralı odayla aynı.

Sürüm 1.1.1-rc1

16 Mayıs 2018 Taşıma işlemlerini kullanıyorsanız 1.1.0 yerine Room 1.1.1-rc1 kullanmanızı önemle tavsiye ederiz.

Room'un, taşıma sonrası başlatma işlemini düzgün şekilde gerçekleştirmemesine neden olan hata düzeltildi b/79362399.

Sürüm 1.1.0

Sürüm 1.1.0-beta3

19 Nisan 2018

Hata Düzeltmeleri

  • Kotlin POJO, Java'da tanımlanmış bir ilişki varlığına referans verdiğinde oluşan derleme hatası düzeltildi b/78199923

Sürüm 1.1.0-beta2

5 Nisan 2018

Hata Düzeltmeleri

  • Room Rx Single ve Maybe uygulamalarında, sorguyu zamanından önce geri dönüştürerek döndürülen Single veya Maybe örneklerine 1'den fazla gözlemci eklediğinizde sorunlara neden olan kritik bir hata düzeltildi. b/76031240

  • [RoomDatabase.clearAllTables][ref-clearAllTables], bir işlem içinde çağrılırsa veritabanını VACUUM. b/77235565

Sürüm 1.1.0-beta1

21 Mart 2018

API Değişiklikleri

  • API incelemesi geri bildirimine göre @RawQuery artık sorgu parametresi olarak String kabul etmiyor. [SupportSQLiteQuery][ref-SupportSQLiteQuery] kullanmanız gerekir. (Bağımsız değişken desteğiyle kolayca [SupportSQLiteQuery][ref-SupportSQLiteQuery] örneği oluşturmak için [SimpleSQLiteQuery][ref-SimpleSQLiteQuery] bölümüne bakın).
  • RoomDatabase.Builder'ın [fallbackToDestructiveMigrationFrom][ref-fallbackToDestructiveMigrationFrom] yöntemi artık vararg Integer yerine vararg int kabul ediyor.

Hata Düzeltmeleri

  • [RoomDatabase.clearAllTables][ref-clearAllTables] artık bir WAL kontrol noktası ayarlayarak ve veritabanını VACUUM ederek alanı işletim sistemine geri döndürmeye çalışır.
  • [@RawQuery][ref-RawQuery] artık observedEntities özelliği için herhangi bir Pojo'yu kabul ediyor. Bunun için Pojo'nun Embedded alanları veya Relation'leri aracılığıyla bir ya da daha fazla varlığa referans vermesi yeterli. b/74041772
  • Paging: Room'un DataSource uygulaması artık çoklu tablo bağımlılıklarını (ilişkiler ve birleştirmeler gibi) doğru şekilde işliyor. Daha önce bu tür sorgular yeni sonuçları tetikleyemiyor veya derlenemiyordu. b/74128314

Sürüm 1.1.0-alpha1

22 Ocak 2018

Yeni özellikler

  • RawQuery: Bu yeni API, @Dao yöntemlerinin SQL'i sorgu parametresi olarak almasına olanak tanır b/62103290, b/71458963
  • fallBackToDestructiveMigrationsFrom: RoomDatabase.Builder içindeki bu yeni API, yıkıcı taşıma işlemlerine hangi başlangıç şeması sürümlerinden izin verileceği konusunda daha ayrıntılı kontrol sağlar (fallbackToDestructiveMigration ile karşılaştırıldığında). b/64989640
  • Room artık yalnızca daha yeni Paging API'lerini (alfa-4+) destekliyor ve desteği sonlandırılan LivePagedListProvider için destek sunmuyor. Yeni Room alfa sürümünü kullanmak için sayfalama alpha-4 veya sonraki bir sürümü kullanmanız ve henüz yapmadıysanız LivePagedListProvider yerine LivePagedListBuilder kullanmanız gerekir.

Hata Düzeltmeleri

  • Kotlin Kapt türleri için daha iyi destek. b/69164099
  • Alanların sırası artık şemayı geçersiz kılmıyor. b/64290754