कमरा

रूम परसिस्टेंस लाइब्रेरी, SQLite के ऊपर एक ऐब्स्ट्रैक्शन लेयर उपलब्ध कराती है. इससे SQLite की पूरी क्षमता का इस्तेमाल करते हुए, डेटाबेस को ज़्यादा बेहतर तरीके से ऐक्सेस किया जा सकता है.
नया अपडेट स्टेबल वर्शन रिलीज़ कैंडिडेट बीटा रिलीज़ ऐल्फ़ा रिलीज़
09 सितंबर, 2026 2.8.5 - - -

डिपेंडेंसी का एलान करना

Room पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट में Google Maven रिपॉज़िटरी जोड़नी होगी. ज़्यादा जानकारी के लिए, Google की Maven रिपॉज़िटरी पढ़ें.

रूम के लिए डिपेंडेंसी में, रूम माइग्रेशन की जांच करना और रूम RxJava शामिल हैं

अपने ऐप्लिकेशन या मॉड्यूल के लिए, build.gradle फ़ाइल में उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको ज़रूरत है:

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

ग्रूवी

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 प्लग इन इस्तेमाल करने के बारे में जानकारी पाने के लिए, KAPT दस्तावेज़ देखें.

केएसपी प्लगिन इस्तेमाल करने के बारे में जानकारी पाने के लिए, केएसपी क्विक-स्टार्ट दस्तावेज़ देखें.

Kotlin एक्सटेंशन इस्तेमाल करने के बारे में जानकारी पाने के लिए, ktx दस्तावेज़ देखें.

डिपेंडेंसी के बारे में ज़्यादा जानने के लिए, बिल्ड डिपेंडेंसी जोड़ना लेख पढ़ें.

इसके अलावा, Java या Kotlin जैसे Gradle मॉड्यूल वाली नॉन-Android लाइब्रेरी के लिए, Room एनोटेशन का इस्तेमाल करने के लिए androidx.room:room-common पर निर्भर रहा जा सकता है.

कंपाइलर के विकल्पों को कॉन्फ़िगर करना

Room में, व्याख्या प्रोसेसर के ये विकल्प मौजूद हैं.

room.schemaLocation directory
इसकी मदद से, डेटाबेस स्कीमा को दी गई डायरेक्ट्री में JSON फ़ाइलों में एक्सपोर्ट किया जा सकता है. ज़्यादा जानकारी के लिए, रूम माइग्रेशन देखें.
room.incremental boolean
इससे Gradle इंक्रीमेंटल एनोटेशन प्रोसेसर चालू होता है. डिफ़ॉल्ट वैल्यू true है.
room.generateKotlin boolean
Java के बजाय Kotlin सोर्स फ़ाइलें जनरेट करें. केएसपी की ज़रूरत होती है. वर्शन 2.7.0 के मुताबिक, डिफ़ॉल्ट वैल्यू true है. ज़्यादा जानकारी के लिए, वर्शन 2.6.0 के नोट देखें. इसमें बताया गया है कि इसे कब लॉन्च किया गया था.

Room Gradle प्लग इन का इस्तेमाल करना

Room के 2.6.0 और इसके बाद के वर्शन में, Room Gradle प्लगिन का इस्तेमाल करके, Room कंपाइलर के लिए विकल्प कॉन्फ़िगर किए जा सकते हैं. प्लग इन, प्रोजेक्ट को इस तरह कॉन्फ़िगर करता है कि जनरेट किए गए स्कीमा (जो कंपाइल टास्क का आउटपुट होते हैं और ऑटो-माइग्रेशन के लिए इस्तेमाल किए जाते हैं) को सही तरीके से कॉन्फ़िगर किया जाए, ताकि फिर से जनरेट किए जा सकने वाले और कैश मेमोरी में सेव किए जा सकने वाले बिल्ड बनाए जा सकें.

प्लगिन जोड़ने के लिए, अपनी टॉप-लेवल Gradle बिल्ड फ़ाइल में प्लगिन और उसका वर्शन तय करें.

Groovy

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

Kotlin

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

मॉड्यूल-लेवल की Gradle बिल्ड फ़ाइल में, प्लगिन लागू करें और room एक्सटेंशन का इस्तेमाल करें.

Groovy

plugins {
    id 'androidx.room'
}

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

Kotlin

plugins {
    id("androidx.room")
}

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

Room Gradle प्लगिन का इस्तेमाल करते समय, schemaDirectory सेट करना ज़रूरी है. इससे Room कंपाइलर, कंपाइल करने के अलग-अलग टास्क, और इसके बैकएंड (javac, KAPT, KSP) कॉन्फ़िगर हो जाएंगे, ताकि स्कीमा फ़ाइलों को फ़्लेवर वाले फ़ोल्डर में आउटपुट किया जा सके. उदाहरण के लिए, schemas/flavorOneDebug/com.package.MyDatabase/1.json. इन फ़ाइलों को रिपॉज़िटरी में चेक इन किया जाना चाहिए, ताकि इनका इस्तेमाल पुष्टि करने और अपने-आप माइग्रेट होने के लिए किया जा सके.

कुछ विकल्पों को Room Gradle प्लग इन के सभी वर्शन में कॉन्फ़िगर नहीं किया जा सकता. भले ही, Room कंपाइलर के साथ ये काम करते हों. यहां दी गई टेबल में हर विकल्प की सूची दी गई है. साथ ही, Room Gradle प्लग इन का वह वर्शन दिखाया गया है जिसमें room एक्सटेंशन का इस्तेमाल करके, उस विकल्प को कॉन्फ़िगर करने की सुविधा जोड़ी गई है. अगर आपके पास इससे पुराना वर्शन है या यह विकल्प अब तक काम नहीं करता है, तो इसके बजाय व्याख्या प्रोसेसर के विकल्प इस्तेमाल किए जा सकते हैं.

विकल्प इस वर्शन के बाद
room.schemaLocation (ज़रूरी) 2.6.0
room.incremental -
room.generateKotlin -

व्याख्या प्रोसेसर के विकल्पों का इस्तेमाल करना

अगर Room Gradle प्लग इन का इस्तेमाल नहीं किया जा रहा है या आपको जो विकल्प चाहिए वह आपके प्लग इन के वर्शन के साथ काम नहीं करता है, तो व्याख्या प्रोसेसर के विकल्पों का इस्तेमाल करके Room को कॉन्फ़िगर किया जा सकता है. इसके बारे में बिल्ड डिपेंडेंसी जोड़ें में बताया गया है. एनोटेशन के विकल्प तय करने का तरीका इस बात पर निर्भर करता है कि Room के लिए केएसपी का इस्तेमाल किया जा रहा है या KAPT का.

Groovy

// 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 एक डायरेक्ट्री है, न कि प्रिमिटिव टाइप. इसलिए, इस विकल्प को जोड़ते समय CommandLineArgumentsProvider का इस्तेमाल करना ज़रूरी है, ताकि अप-टू-डेट जांच करते समय Gradle को इस डायरेक्ट्री के बारे में पता चल सके. अपने रूम डेटाबेस को माइग्रेट करें में, CommandLineArgumentsProvider को लागू करने का पूरा तरीका बताया गया है. इससे स्कीमा की जगह की जानकारी मिलती है.

सुझाव/राय दें या शिकायत करें

आपके सुझाव, शिकायत या राय से Jetpack को बेहतर बनाने में मदद मिलती है. अगर आपको कोई नई समस्या मिलती है या आपके पास इस लाइब्रेरी को बेहतर बनाने के लिए सुझाव हैं, तो हमें बताएं. कृपया नई समस्या सबमिट करने से पहले, इस लाइब्रेरी में शामिल मौजूदा समस्याओं को देखें. स्टार बटन पर क्लिक करके, किसी मौजूदा समस्या के लिए वोट किया जा सकता है.

नई समस्या दर्ज करने का तरीका

ज़्यादा जानकारी के लिए, Issue Tracker का दस्तावेज़ देखें.

वर्शन 2.8

वर्शन 2.8.5

09 सितंबर, 2026

androidx.room:room-*:2.8.5 रिलीज़ हो गया है. वर्शन 2.8.5 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • डेटाबेस बंद होने के बाद, रूम सस्पेंडिंग क्वेरी और अमान्य ट्रैकर ऑपरेशन को कॉल करने पर, अब IllegalStateException दिखेगा. (Ic0166, b/543076356)

वर्शन 2.8.4

19 नवंबर, 2025

androidx.room:room-*:2.8.4 रिलीज़ हो गया है. वर्शन 2.8.4 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • SQLiteDriver का इस्तेमाल करते समय, Room के कनेक्शन पूल में तैयार स्टेटमेंट कैश मेमोरी जोड़ी गई. इसमें, BundledSQLiteDriver जैसे पूल नहीं होते. इससे एक ही एसक्यूएल स्टेटमेंट को बार-बार चलाने पर परफ़ॉर्मेंस बेहतर होती है. (5f43bc, b/319653917)
  • स्कीमा की पुष्टि करने पर, असल / संभावित गड़बड़ी के मैसेज में जानकारी मौजूद न होने की समस्या को ठीक किया गया. (8b23da, b/454531083)
  • उस समस्या को ठीक किया गया है जिसमें Room के Kotlin कोड जनरेशन में, टाइप वैरिएबल वाले @Transaction डीएओ फ़ंक्शन मौजूद नहीं थे. (a8365d, b/251316420)
  • थ्रेड हॉप से बचकर, Room के SupportSQLite रैपर की परफ़ॉर्मेंस को बेहतर बनाएं. साथ ही, SupportSQLiteDatabase एपीआई की तरह ही ब्लॉक करने के तरीके को बनाए रखें. (fc70e4)

वर्शन 2.8.3

22 अक्टूबर, 2025

androidx.room:room-*:2.8.3 रिलीज़ हो गया है. वर्शन 2.8.3 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • Room SQLite रैपर की परफ़ॉर्मेंस से जुड़ी समस्या को ठीक किया गया. इसकी वजह से, कर्सर पर बार-बार जाने पर, बहुत ज़्यादा जेएनआई कॉल हो रहे थे और परफ़ॉर्मेंस में काफ़ी गिरावट आ रही थी.

वर्शन 2.8.2

8 अक्टूबर, 2025

androidx.room:room-*:2.8.2 रिलीज़ हो गया है. वर्शन 2.8.2 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • फ़्लो एमिशन (b/446643789) से, अपने-आप बंद हुए डेटाबेस को फिर से खोलने पर होने वाले डेडलॉक को ठीक किया गया.

वर्शन 2.8.1

24 सितंबर, 2025

androidx.room:room-*:2.8.1 रिलीज़ हो गया है. वर्शन 2.8.1 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • प्रोसेसर के क्रैश होने की समस्या को ठीक किया गया है. यह समस्या, सस्पेंड लैम्ब्डा के साथ डीएओ फ़ंक्शन को प्रोसेस करते समय होती थी. (b/442220723).
  • रेस कंडिशन को ठीक किया गया, ताकि फ़्लो को नए अपडेट मिल सकें.

वर्शन 2.8.0

10 सितंबर, 2025

androidx.room:room-*:2.8.0 रिलीज़ हो गया है. वर्शन 2.8.0 में ये कमिट शामिल हैं.

2.7.0 के बाद किए गए अहम बदलाव:

  • नया आर्टफ़ैक्ट androidx.room:room-sqlite-wrapper जोड़ा गया है. इसमें कॉन्फ़िगर किए गए SQLiteDriver वाले RoomDatabase से SupportSQLiteDatabase रैपर पाने के लिए एपीआई शामिल हैं. रैपर पाने के लिए, नए एक्सटेंशन फ़ंक्शन RoomDatabase.getSupportWrapper() का इस्तेमाल करें. यह SupportSQLiteDatabase के इस्तेमाल को बनाए रखने के लिए, साथ काम करने वाला आर्टफ़ैक्ट है. आम तौर पर, यह roomDatabase.openHelper.writableDatabase से मिलता है. भले ही, Room डेटाबेस को SQLiteDriver के साथ कॉन्फ़िगर किया गया हो. यह रैपर, उन कोड बेस को धीरे-धीरे माइग्रेट करने के लिए मददगार है जो SQLiteDriver API का इस्तेमाल करना चाहते हैं, लेकिन SupportSQLite API का बड़े पैमाने पर इस्तेमाल करते हैं. हालांकि, वे BundledSQLiteDriver का फ़ायदा लेना चाहते हैं. ज़्यादा जानकारी के लिए, माइग्रेट करने से जुड़ी गाइड देखें.
  • केएमपी टारगेट के लिए, Watch OS और Tv OS की सुविधा जोड़ी गई.
  • लाइब्रेरी के Android minSDK को एपीआई 21 से एपीआई 23 पर अपडेट किया गया

वर्शन 2.8.0-rc02

27 अगस्त, 2025

androidx.room:room-*:2.8.0-rc02 रिलीज़ हो गया है. वर्शन 2.8.0-rc02 में ये कमिट शामिल हैं.

एपीआई में बदलाव

  • minSDK को एपीआई 21 से एपीआई 23 पर अपडेट करें (Ibdfca, b/380448311, b/435705964, b/435705223)
  • Room Gradle प्लगिन के साथ काम करने वाले Android Gradle प्लगिन (एजीपी) के कम से कम वर्शन को 8.1 से 8.4 पर अपडेट करें. (Ia0d28)

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसमें पहले से पैकेज किए गए डेटाबेस के लिए माइग्रेशन पाथ उपलब्ध होने के बावजूद, डिस्ट्रक्टिव माइग्रेशन किया जा रहा था (b/432634197).

वर्शन 2.8.0-rc01

13 अगस्त, 2025

androidx.room:room-*:2.8.0-rc01 रिलीज़ हो गया है. वर्शन 2.8.0-rc01 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • @RequiresApi(21) के पुराने एनोटेशन हटाए जा रहे हैं (Ic4792, I9103b)

गड़बड़ियां ठीक की गईं

  • उस रेस कंडिशन को ठीक करें जिसमें Room Flows, एसिंक्रोनस मल्टी-क्वेरी/राइट की स्थिति में क्वेरी का नया नतीजा नहीं दिखाता. (Ic9a3c)

वर्शन 2.8.0-beta01

1 अगस्त, 2025

androidx.room:room-*:2.8.0-beta01 रिलीज़ हो गया है. वर्शन 2.8.0-beta01 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • डिस्ट्रक्टिव माइग्रेशन के दौरान, टेबल और व्यू के नाम अब सही तरीके से एस्केप किए जाते हैं. (9e55f8, b/427095319)

वर्शन 2.8.0-alpha01

16 जुलाई, 2025

androidx.room:room-*:2.8.0-alpha01 रिलीज़ हो गया है. वर्शन 2.8.0-alpha01 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • एक नया आर्टफ़ैक्ट androidx.room:room-sqlite-wrapper जोड़ा गया है. इसमें कॉन्फ़िगर किए गए SQLiteDriver के साथ RoomDatabase का SupportSQLiteDatabase रैपर पाने के लिए एपीआई शामिल हैं. रैपर पाने के लिए, नए एक्सटेंशन फ़ंक्शन RoomDatabase.getSupportWrapper() का इस्तेमाल करें. यह SupportSQLiteDatabase के इस्तेमाल को बनाए रखने के लिए, साथ काम करने वाला आर्टफ़ैक्ट है. आम तौर पर, यह RoomDatabase.openHelper.writableDatabase से मिलता है. भले ही, Room डेटाबेस को SQLiteDriver के साथ कॉन्फ़िगर किया गया हो. यह रैपर, कोड बेस के इंक्रीमेंटल माइग्रेशन के लिए मददगार है. यह उन लोगों के लिए है जो SQLiteDriver को अपनाना चाहते हैं, लेकिन SupportSQLite एपीआई का बड़े पैमाने पर इस्तेमाल करते हैं. हालांकि, वे BundledSQLiteDriver का फ़ायदा लेना चाहते हैं. (Icf6ac)
  • Watch OS और TV OS के लिए केएमपी टारगेट जोड़े गए (I228f6, b/394238801)

गड़बड़ियां ठीक की गईं

  • लेन-देन को निलंबित करने और AndroidSQLiteDriver का इस्तेमाल करने पर, कभी-कभी होने वाले डेडलॉक को ठीक करें. (b/415006268)

वर्शन 2.7

वर्शन 2.7.2

18 जून, 2025

androidx.room:room-*:2.7.2 रिलीज़ हो गया है. वर्शन 2.7.2 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • केएसपी के साथ नेटिव सोर्स को प्रोसेस करते समय, एनोटेशन की वैल्यू गलत तरीके से पढ़ी जाती थीं. इस वजह से, कभी-कभी स्कीमा एक्सपोर्ट नहीं हो पाते थे. इस समस्या को ठीक किया गया है. (b/416549580)
  • उस गड़बड़ी को ठीक किया गया है जिसमें SQL में शुरुआती टिप्पणियों की वजह से, स्टेटमेंट को इस तरह से लागू किया जाता था जैसे कि वे ऐसी क्वेरी हों जिन्हें पढ़ा नहीं जा सकता. (b/413061402)
  • स्कीमा डायरेक्ट्री खाली होने की वजह से, Room के Gradle प्लग इन को कॉन्फ़िगर न कर पाने की समस्या को ठीक किया गया. (b/417823384)
  • कनेक्शन मिलने में ज़्यादा समय लगने पर, अब SQLiteException नहीं दिखेगा. इसके बजाय, लाइब्रेरी से एक लॉग मैसेज भेजा जाएगा. अपवाद को थ्रो करने के बजाय लॉग करने से, iOS के सस्पेंड किए गए लूपर की समस्या हल हो जाती है. इस समस्या की वजह से, Room को Kotlin Coroutine में कनेक्शन हासिल करने के दौरान होने वाले टाइम आउट का गलत अनुमान लगता है. इस वजह से, iOS ऐप्लिकेशन के बैकग्राउंड में चलने और बाद में डेटाबेस ऑपरेशन के बीच में फिर से शुरू होने पर, अपवाद को थ्रो होने से रोका जाता है. (b/422448815)

वर्शन 2.7.1

23 अप्रैल, 2025

androidx.room:room-*:2.7.1 रिलीज़ हो गया है. वर्शन 2.7.1 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • उपलब्ध कराए गए टाइप कन्वर्टर की पुष्टि के दौरान, IndexOutOfBoundsException गड़बड़ी को ठीक करना. (b/409804755).
  • जब किसी SQLiteDriver को रूम के साथ कॉन्फ़िगर किया जाता है, तो RoomDatabase.runInTransaction() का इस्तेमाल किया जा सकता है. (b/408364828).

वर्शन 2.7.0

9 अप्रैल, 2025

androidx.room:room-*:2.7.0 रिलीज़ हो गया है. वर्शन 2.7.0 में ये बदलाव शामिल हैं.

2.6.0 के बाद किए गए अहम बदलाव

  • Kotlin Multiplatform (KMP) के लिए सहायता: इस रिलीज़ में, Room को Kotlin Multiplatform (KMP) लाइब्रेरी के तौर पर फिर से तैयार किया गया है. फ़िलहाल, यह Android, iOS, जेवीएम (डेस्कटॉप), नेटिव Mac, और नेटिव Linux के साथ काम करता है. Room KMP का इस्तेमाल शुरू करने के बारे में ज़्यादा जानने के लिए, कृपया Room KMP का आधिकारिक दस्तावेज़ पढ़ें. केएमपी के साथ काम करने के लिए, Room को SQLiteDriver के साथ भी कॉन्फ़िगर किया जा सकता है. किसी मौजूदा ऐप्लिकेशन को ड्राइवर एपीआई और Room केएमपी पर माइग्रेट करने के तरीके के बारे में जानने के लिए, माइग्रेशन से जुड़ा दस्तावेज़ देखें.
  • अगर प्रोसेसिंग केएसपी के ज़रिए की जाती है, तो केएसपी पर Kotlin कोड जनरेट करने की सुविधा डिफ़ॉल्ट रूप से चालू हो जाती है. सिर्फ़ KAPT या Java प्रोजेक्ट के लिए, Room अब भी Java सोर्स जनरेट करेगा.
  • Kotlin 2.0 और KSP2: Room अब Kotlin 2.0 को टारगेट करता है. इसके लिए, प्रोजेक्ट को Kotlin 2.0 और इसके बराबर या इसके बाद के वर्शन के साथ कंपाइल करना होगा. KSP2 के लिए भी सहायता जोड़ी गई है. Kotlin 2.0 या इसके बाद के वर्शन के साथ Room का इस्तेमाल करते समय, KSP2 का इस्तेमाल करने का सुझाव दिया जाता है.

वर्शन 2.7.0-rc03

26 मार्च, 2025

androidx.room:room-*:2.7.0-rc03 रिलीज़ हो गया है. वर्शन 2.7.0-rc03 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • DAO फ़ंक्शन को ब्लॉक करने के साथ-साथ, Room को ब्लॉक करने वाले एपीआई के लागू होने के दौरान किसी थ्रेड में रुकावट आने पर, अब InterruptedException को थ्रो नहीं किया जाता (b/400584611).
  • SQLException: Error code: 5, message: Timed out attempting to acquire a reader connection. और इससे मिलती-जुलती समस्याओं (b/380088809) को कम करने के लिए, Room के कनेक्शन पूल को फिर से लागू किया गया.

वर्शन 2.7.0-rc02

12 मार्च, 2025

androidx.room:room-*:2.7.0-rc02 रिलीज़ हो गया है. वर्शन 2.7.0-rc02 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • ऑटो माइग्रेशन की सुविधा, एफ़टीएस टेबल में नए कॉलम को गलत तरीके से हैंडल करती थी. इस समस्या को ठीक किया गया. (b/348227770, Ic53f3)
  • केएसपी के ज़रिए नॉन-जेवीएम सोर्स को प्रोसेस करते समय, NullPointerException की वजह से रूम-कंपाइलर के क्रैश होने की समस्या को ठीक किया गया. (b/396607230, I693c9)
  • उस समस्या को ठीक किया गया है जिसमें Room, राइटर कनेक्शन का इस्तेमाल करने के बाद टेबल को अमान्य नहीं करता था. (b/340606803, I73ef6)

वर्शन 2.7.0-rc01

26 फ़रवरी, 2025

androidx.room:room-*:2.7.0-rc01 रिलीज़ हो गया है. वर्शन 2.7.0-rc01 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसमें Room, शुरुआती डेटाबेस कनेक्शन में busy_timeout को सेट नहीं करता था. इसकी वजह से, SQLException: Error code: 5, message: database is locked से जुड़ी समस्याएं होती थीं (I93208, b/380088809).
  • Room के कंपाइलर में मौजूद एक समस्या को ठीक किया गया है. इसकी वजह से, Kotlin 2.1.x और KSP1 पर नेटिव सोर्स सेट (जैसे, iOS) को प्रोसेस करते समय, KSP प्रोसेसर क्रैश हो जाता था (I883b8, b/396607230).

वर्शन 2.7.0-beta01

12 फ़रवरी, 2025

androidx.room:room-*:2.7.0-beta01 रिलीज़ हो गया है. वर्शन 2.7.0-beta01 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • RoomDatabase.inTransaction() में मौजूद उस समस्या को ठीक किया गया है जिसकी वजह से, बंद डेटाबेस को नहीं खोले जाने पर भी वह खुल जाता था. साथ ही, डेटाबेस बंद होने पर उसे तुरंत 'गलत' वैल्यू दिखानी चाहिए (b/325432967).
  • Kotlin इनलाइन / वैल्यू क्लास (b/388299754) के साथ डीएओ फ़ंक्शन प्रोसेस करते समय, Room के कंपाइलर में होने वाली क्रैश (IllegalArgumentException: not a valid name) की समस्या को ठीक किया गया.
  • room-runtime के जेवीएम आर्टफ़ैक्ट में Proguard के नियम शामिल करें, ताकि जनरेट किए गए डेटाबेस के डिफ़ॉल्ट कंस्ट्रक्टर को न हटाया जाए. ऐसा इसलिए, क्योंकि इसका इस्तेमाल Room के डिफ़ॉल्ट इनिशलाइज़ेशन के लिए किया जाता है. यह इनिशलाइज़ेशन, रिफ़्लेक्शन का इस्तेमाल करता है (b/392657750).

वर्शन 2.7.0-alpha13

29 जनवरी, 2025

androidx.room:room-*:2.7.0-alpha13 रिलीज़ हो गया है. वर्शन 2.7.0-alpha13 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • Room अब Kotlin 2.0 को टारगेट करता है. इसके लिए, प्रोजेक्ट को Kotlin 2.0 और इसके बराबर या इसके बाद के वर्शन के साथ कंपाइल करना होगा. (I8efb0, b/315461431, b/384600605)

गड़बड़ियां ठीक की गईं

  • Room के केएमपी डेटाबेस बिल्डर में आने वाली एक समस्या को ठीक किया गया है. यह समस्या तब आती थी, जब Android में पाथ के बजाय किसी सामान्य नाम का इस्तेमाल किया जाता था और डेटाबेस फ़ाइल का पाथ, ऐप्लिकेशन की डेटा डायरेक्ट्री में नहीं मिलता था. (I83315, b/377830104)
  • Room Gradle प्लगिन से जुड़ी समस्या को ठीक किया गया है. इसमें स्कीमा इनपुट और आउटपुट को कॉन्फ़िगर करने पर, Android प्रोजेक्ट में समस्या आ रही थी: property 'inputDirectory' is final and cannot be changed any further. (1dbb4c, b/376071291)
  • Room Gradle प्लग इन में KSP2 के लिए सहायता जोड़ी गई है. इससे उस समस्या को ठीक किया गया है जिसमें प्लग इन, स्कीमा डायरेक्ट्री को सही तरीके से सेट अप नहीं कर रहा था. (Iec3c4, b/379159770)

बाहरी योगदान

  • Room पेजिंग इंटिग्रेशन से जुड़ी समस्या को ठीक किया गया है. इस समस्या की वजह से, यूज़र इंटरफ़ेस (यूआई) में जंप होते थे. ऐसा तब होता था, जब रीफ़्रेश करने के लिए शुरुआती बटन, सूची के आखिर के बहुत करीब होता था. ईवा को धन्यवाद! (I2abbe, b/389729367)

वर्शन 2.7.0-alpha12

11 दिसंबर, 2024

androidx.room:room-*:2.7.0-alpha12 रिलीज़ हो गया है. वर्शन 2.7.0-alpha12 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई RoomDatabase.Builder.setInMemoryTrackingMode() जोड़ें, ताकि यह कॉन्फ़िगर किया जा सके कि Room, अमान्य होने की ट्रैकिंग के लिए इन-मेमोरी टेबल का इस्तेमाल करेगा या नहीं. (I2a9b2, b/185414040)

गड़बड़ियां ठीक की गईं

  • डिस्ट्रक्टिव माइग्रेशन अब व्यू को ड्रॉप कर देते हैं, ताकि यह पक्का किया जा सके कि वे फिर से बनाए जाएं. इससे allowDestructiveMigrationForAllTables के चालू होने पर (केएमपी डिफ़ॉल्ट) और बंद होने पर, मौजूदा व्यवहार के साथ अलाइन किया जा सकता है. (0a3e83, b/381518941)

वर्शन 2.7.0-alpha11

30 अक्टूबर, 2024

androidx.room:room-*:2.7.0-alpha11 रिलीज़ हो गया है. वर्शन 2.7.0-alpha11 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • नए जोड़े गए convertRows() मेथड सिग्नेचर को फिर से देखें, ताकि यह एक सस्पेंड फ़ंक्शन बन सके. यह फ़ंक्शन, रूम-पेजिंग के लिए RawRoomQuery को रिसीव करता है. (Ie57b5, b/369136627)

गड़बड़ियां ठीक की गईं

  • रूम-पेजिंग में आने वाली उस समस्या को ठीक किया गया है जिसकी वजह से, @Relation के साथ PagingSource का इस्तेमाल करने पर अमान्य कोड जनरेट हो रहा था.

वर्शन 2.7.0-alpha10

16 अक्टूबर, 2024

androidx.room:room-*:2.7.0-alpha10 रिलीज़ हो गया है. वर्शन 2.7.0-alpha10 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • नॉन-Android और नॉन-जेवीएम प्लैटफ़ॉर्म पर, ByteBuffer के साथ रिलेशन को सपोर्ट करने के लिए, इंटरनल ByteArrayWrapper क्लास बनाएं. (I75543, b/367205685)
  • किसी कॉलम के डेटा टाइप को वापस पाने की सुविधा चालू करने के लिए, SQLiteStatement.getColumnType() के साथ-साथ SQLITE_DATA_* के अलग-अलग रिज़ल्ट कॉन्स्टेंट जोड़ें. (I1985c, b/369636251)

वर्शन 2.7.0-alpha09

2 अक्टूबर, 2024

androidx.room:room-*:2.7.0-alpha09 रिलीज़ हो गया है. वर्शन 2.7.0-alpha09 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • room-paging के केएमपी को लागू करने से जुड़ी समस्या को ठीक किया गया है. इसकी वजह से, रीड कनेक्शन पर राइट ट्रांज़ैक्शन शुरू करने पर Error code: 8, message: attempt to write a readonly database की गड़बड़ी होती थी. (b/368380988)

वर्शन 2.7.0-alpha08

18 सितंबर, 2024

androidx.room:room-*:2.7.0-alpha08 रिलीज़ हो गया है. वर्शन 2.7.0-alpha08 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • room-paging आर्टफ़ैक्ट को केएमपी के साथ काम करने के लिए माइग्रेट कर दिया गया है. (Ib8756, b/339934824)
  • एपीआई invalidationTrackerFlow() को पहले पक्ष के एपीआई के तौर पर InvalidationTracker.createFlow() के साथ जोड़ दिया गया है. अब यह केएमपी प्रोजेक्ट में, Android के अलावा अन्य सोर्स सेट के लिए उपलब्ध है. (I1fbfa, (I8fb29), b/329291639, b/329315924)

एपीआई में बदलाव

  • Room में मौजूद उन सभी चेतावनियों और गड़बड़ी के मैसेज को हटा दिया गया है या बदल दिया गया है जिनमें Cursor शब्द का इस्तेमाल किया गया है. ऐसा इसलिए, क्योंकि Room के केएमपी वर्शन में इस्तेमाल करने के लिए, Cursor अब सटीक सामान्य शब्द नहीं है. (Id8cd9, b/334087492)

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसमें Room KMP, नॉन-जेवीएम प्लैटफ़ॉर्म के लिए UUID का इस्तेमाल करके कोड जनरेट करने की कोशिश करता था. (b/362994709)
  • Room Gradle प्लग इन से जुड़ी एक समस्या को ठीक किया गया है. इसकी वजह से, Compose Multiplatform के साथ केएमपी प्रोजेक्ट में इस्तेमाल किए जाने पर, ‘म्यूटेशन के लिए लॉक किए जाने के बाद, कॉन्फ़िगरेशन … के एट्रिब्यूट नहीं बदले जा सकते’ जैसी गड़बड़ी होती थी. (b/343408758)

वर्शन 2.7.0-alpha07

21 अगस्त, 2024

androidx.room:room-*:2.7.0-alpha07 रिलीज़ हो गया है. वर्शन 2.7.0-alpha07 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • Room Gradle प्लग इन, अब एक्सपोर्ट किए गए स्कीमा को Android इंस्ट्रुमेंटेशन टेस्ट के रिसॉर्स सोर्स में अपने-आप जोड़ देगा, ताकि MigrationTestHelper उनका इस्तेमाल कर सके.

गड़बड़ियां ठीक की गईं

  • RoomDatabaseConstructor के जनरेट किए गए ‘actual’ से जुड़ी समस्या को ठीक किया गया. इसमें initialize फ़ंक्शन में ‘actual’ मॉडिफ़ायर मौजूद नहीं था. ऐसा तब होता है, जब ‘expect’ एलान में भी इस तरह के फ़ंक्शन को बदला जाता है. (359631627)
  • RoomDatabaseConstructor के जनरेट किए गए ‘actual’ के, ‘expect’ एलान की विज़िबिलिटी से मैच न होने की समस्या को ठीक किया गया. (358138953)

वर्शन 2.7.0-alpha06

7 अगस्त, 2024

androidx.room:room-*:2.7.0-alpha06 रिलीज़ हो गया है. वर्शन 2.7.0-alpha06 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • केएमपी प्रोजेक्ट में RoomDatabase के लिए, इंस्टैंशिएशन सेटअप बदलें.

Kotlin 2.0 कंपाइलेशन मॉडल की वजह से, जनरेट किए जाने वाले फ़ंक्शन instantiateImpl() को रेफ़रंस देने की रणनीति अब काम नहीं करती. दो नए एपीआई, @ConstructedBy और RoomDatabaseConstructor लॉन्च किए गए हैं. ये instantiateImpl() रणनीति की जगह लेंगे. नई रणनीति इस तरह है:

  1. RoomDatabaseConstructor को लागू करने वाला एक expect ऑब्जेक्ट तय करें

      expect object MyDatabaseCtor : RoomDatabaseConstructor<MyDatabase>
    
  2. @ConstructedBy का इस्तेमाल करके, ऑब्जेक्ट को @Database एलान से लिंक करें

      @Database(...)
      @ConstructedBy(MyDatabaseCtor::class) // NEW
      abstract class MyDatabase : RoomDatabase
    
  3. फ़ैक्ट्री आर्ग्युमेंट पास किए बिना, नया डेटाबेस इंस्टेंस बनाएं

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

b/316978491, b/338446862, और b/342905180 को ठीक किया गया

  • Room केएमपी में @RawQuery के लिए सहायता जोड़ी गई. इसके लिए, RoomRawQuery नाम का एक नया एपीआई जोड़ा गया. यह एपीआई, रॉ एसक्यूएल स्ट्रिंग को होल्ड करने और स्टेटमेंट में आर्ग्युमेंट को बाइंड करने वाले फ़ंक्शन के मामले में, SupportSQLiteQuery जैसा ही है. @RawQuery एनोटेट किए गए फ़ंक्शन, अब RoomRawQuery को अपने सिंगल पैरामीटर के तौर पर स्वीकार कर सकते हैं. (Iea844, b/330586815)
  • setQueryCallback() का एक ओवरलोड जोड़ें जो CoroutineContext को स्वीकार करता हो. (Id66ff, b/309996304)
  • linuxArm64 Kotlin Multiplatform टारगेट के लिए सहायता जोड़ी गई (I139d3, b/338268719)

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसकी वजह से Room, नॉन-Android टारगेट में recursiveFetchArrayMap को गलत तरीके से कॉल जनरेट करता था. (710c36, b/352482325)
  • उस समस्या को ठीक किया गया है जिसमें कभी-कभी Room, केएमपी प्रोजेक्ट में ‘कनेक्शन की कोशिश के दौरान टाइम आउट हो गया’ अपवाद दिखाता था. (fa72d0, b/347737870)
  • ऑटो-माइग्रेशन में आने वाली उस समस्या को ठीक किया गया है जिसकी वजह से, फ़ॉरेन की की जांच बहुत जल्दी हो जाती थी. ऐसा तब होता था, जब अन्य टेबल ने नई फ़ॉरेन की के मुताबिक अपने स्कीमा में बदलाव नहीं किया होता था. (7672c0, b/352085724)

वर्शन 2.7.0-alpha05

10 जुलाई, 2024

androidx.room:room-*:2.7.0-alpha05 रिलीज़ हो गया है. वर्शन 2.7.0-alpha05 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • SQLiteKt का नाम बदलकर SQLite और BundledSQLiteKt का नाम बदलकर BundledSQLite किया गया. (I8b501)

गड़बड़ियां ठीक की गईं

  • AndroidSQLiteDriver का इस्तेमाल करने पर, RoomDatabase के डेडलॉक होने या कनेक्शन टाइम आउट होने की गड़बड़ी को ठीक किया गया है.

वर्शन 2.7.0-alpha04

12 जून, 2024

androidx.room:room-*:2.7.0-alpha04 रिलीज़ हो गया है. वर्शन 2.7.0-alpha04 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • Room के एनोटेशन प्रोसेसर में मौजूद एक समस्या को ठीक किया गया है. इस समस्या की वजह से, डीएओ में मल्टी-मैप रिटर्न टाइप तय होने पर, काम न करने वाला केएमपी कोड जनरेट होता था. (b/340983093)
  • उस समस्या को ठीक किया गया है जिसकी वजह से, अगर @Database एनोटेट की गई क्लास में कोई पैकेज नहीं होता था, तो Room जनरेट किए गए डेटाबेस को ढूंढ नहीं पाता था. (b/342097292)
  • उस समस्या को ठीक कर दिया गया है जिसकी वजह से, अपने-आप बंद होने और एक से ज़्यादा इंस्टेंस को अमान्य करने की सुविधा चालू करने पर, कभी-कभी ConcurrentModificationException की गड़बड़ी होती थी. ऐसा तब होता था, जब डेटाबेस के इस्तेमाल में न होने की वजह से वह अपने-आप बंद हो जाता था.

वर्शन 2.7.0-alpha03

29 मई, 2024

androidx.room:room-*:2.7.0-alpha03 रिलीज़ हो गया है. वर्शन 2.7.0-alpha03 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • Kotlin 2.0 और KSP 2.0 से जुड़ी कई समस्याएं ठीक की गईं. ध्यान दें कि केएसपी 2 के साथ Kotlin 2.0 का इस्तेमाल करने की सुविधा पूरी तरह से उपलब्ध नहीं है. टीम, नए कंपाइलर में अलग-अलग एपीआई और व्यवहार में होने वाले बदलावों पर काम कर रही है. (b/314151707)

वर्शन 2.7.0-alpha02

14 मई, 2024

androidx.room:room-*:2.7.0-alpha02 रिलीज़ हो गया है. वर्शन 2.7.0-alpha02 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • केएसपी से जुड़ी कई समस्याएं ठीक की गईं.

वर्शन 2.7.0-alpha01

1 मई, 2024

androidx.room:room-*:2.7.0-alpha01 रिलीज़ हो गया है. वर्शन 2.7.0-alpha01 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • Kotlin Multiplatform (KMP) के साथ काम करना: इस रिलीज़ में, Room को Kotlin Multiplatform (KMP) लाइब्रेरी के तौर पर फिर से तैयार किया गया है. हालांकि, अभी कुछ काम बाकी है, लेकिन इस रिलीज़ में Room का एक नया वर्शन पेश किया गया है. इसमें ज़्यादातर फ़ंक्शन को “कॉमन” (मल्टीप्लैटफ़ॉर्म के लिए बनाया गया) कर दिया गया है. फ़िलहाल, यह Android, iOS, जेवीएम (डेस्कटॉप), नेटिव Mac, और नेटिव Linux के साथ काम करता है. जिन प्लैटफ़ॉर्म पर Room की सुविधा हाल ही में उपलब्ध कराई गई है उनमें अगर कोई सुविधा मौजूद नहीं है, तो उसे Room के आने वाले वर्शन में उपलब्ध कराया जाएगा.

Room KMP का इस्तेमाल शुरू करने के बारे में ज़्यादा जानने के लिए, कृपया Room KMP का आधिकारिक दस्तावेज़ पढ़ें.

  • अगर प्रोसेसिंग केएसपी के ज़रिए की जाती है, तो केएसपी पर Kotlin कोड जनरेट करने की सुविधा डिफ़ॉल्ट रूप से चालू हो जाती है. सिर्फ़ KAPT या Java प्रोजेक्ट के लिए, Room अब भी Java सोर्स जनरेट करेगा.

एपीआई में बदलाव

  • Room.databaseBuilder() का एक ओवरलोड जोड़ा गया है. यह एक लैम्डा पैरामीटर लेता है, जिसका इस्तेमाल Room से जनरेट किए गए फ़ंक्शन के साथ किया जाना चाहिए. इससे, जनरेट किए गए RoomDatabase को लागू करने के दौरान, रिफ़्लेक्शन का इस्तेमाल करने से बचा जा सकता है. इस्तेमाल का उदाहरण:
Room.databaseBuilder<MyDatabase>(
    context = appContext,
    name = dbFilePath,
    factory =  { MyDatabase::class.instantiateImpl() }
)
  • बिल्डर में, CoroutineContext के साथ रूम को कॉन्फ़िगर करने के लिए एक एपीआई जोड़ा गया है: RoomDatabase.Builder.setQueryCoroutineContext. ध्यान दें कि RoomDatabase को सिर्फ़ setQueryExecutor का इस्तेमाल करने वाले एक्ज़ीक्यूटर या कोरूटीन कॉन्टेक्स्ट के साथ कॉन्फ़िगर किया जा सकता है. दोनों के साथ नहीं.
  • SQLite ड्राइवर के साथ Room को कॉन्फ़िगर करने के लिए, एक एपीआई जोड़ा गया है: RoomDatabase.Builder.setDriver(). SQLite ड्राइवर एपीआई के बारे में ज़्यादा जानकारी के लिए, SQLite केएमपी से जुड़ा दस्तावेज़ देखें
  • ड्राइवर एपीआई से, मौजूदा SQLiteConnection को ऐक्सेस करने के लिए एपीआई जोड़े गए हैं: RoomDatabase.useReaderConnection और RoomDatabase.useWriterConnection.
  • रूम से जुड़े कई कॉलबैक में अब एक ओवरलोड किया गया वर्शन है. इसमें SupportSQLiteDatabase के बजाय SQLiteConnection मिलता है. केएमपी प्रोजेक्ट पर माइग्रेट करते समय, इन्हें ओवरराइड किया जाना चाहिए. किसी Android ऐप्लिकेशन में Room के इस्तेमाल को सामान्य केएमपी मॉड्यूल पर माइग्रेट करने के बारे में ज़्यादा जानने के लिए, माइग्रेट करने से जुड़ी गाइड देखें. कॉलबैक ये हैं:
    • Migration.migrate(SQLiteConnection)
    • AutoMigrationSpec.onPostMigrate(SQLiteConnection)
    • RoomDatabase.Callback.onCreate(SQLiteConnection)
    • RoomDatabase.Callback.onDestructiveMigration(SQLiteConnection)
    • RoomDatabase.Callback.onOpen(SQLiteConnection)
  • KTX आर्टफ़ैक्ट androidx.room:room-ktx को इसके सभी एपीआई के साथ androidx.room:room-runtime में मर्ज कर दिया गया है. अब आर्टफ़ैक्ट खाली है. कृपया इसे अपनी डिपेंडेंसी सूची से हटाएं.

वर्शन 2.6

वर्शन 2.6.1

29 नवंबर, 2023

androidx.room:room-*:2.6.1 रिलीज़ हो गया है. वर्शन 2.6.1 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • जनरेट किए गए कोड में मौजूद उस समस्या को ठीक किया गया है जिसकी वजह से, EntityCursorConverter में डबल कॉलम के लिए डिफ़ॉल्ट वैल्यू 0.0 के बजाय 0 पर सेट हो रही थी. फ़्लोट तय डेटा टाइप वाले कॉलम के लिए, इसी तरह के एज-केस को ठीक करने का संभावित तरीका भी शामिल किया गया है. (Id75f5, b/304584179)
  • PagingSource लोड से मिलने वाले अपवादों को अब LoadResult.Error के LoadStateUpdate के तौर पर दिखाया जाएगा. इसमें Throwable शामिल होगा. गड़बड़ी की इस स्थिति को PagingDataAdapter.loadStateFlow(Views) या LazyPagingItems.loadState(Compose) की मदद से देखा जा सकता है. ध्यान दें कि यह व्यवहार में बदलाव को दिखाता है. इसमें, लोड करने से जुड़ी पिछली गड़बड़ियां, लोड को ट्रिगर करने वाले dao तरीके से मिले अपवाद के तौर पर दिखेंगी. (I93887, b/302708983)

वर्शन 2.6.0

18 अक्टूबर, 2023

androidx.room:room-*:2.6.0 रिलीज़ हो गया है. वर्शन 2.6.0 में ये बदलाव शामिल हैं.

2.5.0 के बाद किए गए अहम बदलाव

  • Kotlin कोड जनरेट करने (या “Kotlin CodeGen”) की सुविधा को चालू करने का विकल्प, अब Room KSP में उपलब्ध है. (4297ec0). Room में Kotlin CodeGen को चालू करने के लिए, KSP के लिए प्रोसेसर के विकल्पों में room.generateKotlin विकल्प का नाम जोड़ें. केएसपी के लिए प्रोसेसर के विकल्प पास करने के तरीके के बारे में ज़्यादा जानने के लिए, केएसपी का दस्तावेज़ देखें.

ध्यान दें: Kotlin CodeGen का इस्तेमाल करते समय, यह ध्यान रखना ज़रूरी है कि इसमें कुछ और पाबंदियां जोड़ी गई हैं. Kotlin CodeGen में, DAO गेटर या DAO क्वेरी के तौर पर ऐब्स्ट्रैक्ट प्रॉपर्टी इस्तेमाल करने की अनुमति नहीं है. इसके बजाय, उन्हें फ़ंक्शन के तौर पर फिर से लिखा जाना चाहिए. इससे इस गलत धारणा से बचा जा सकता है कि प्रॉपर्टी की वैल्यू में बदलाव नहीं किया जा सकता और उसका नतीजा तय होता है. एक और पाबंदी जोड़ी गई है. इसके तहत, Kotlin CodeGen के लिए Room में, Nullable कलेक्शन के रिटर्न टाइप की अनुमति नहीं है.

चेतावनी: Kotlin CodeGen का इस्तेमाल करने पर, आपको लग सकता है कि आपके प्रोजेक्ट में शून्यता के लिए ज़्यादा सख्त नियम हैं. Kotlin CodeGen में, टाइप आर्ग्युमेंट की शून्यता अहम होती है. हालांकि, Java में इसे ज़्यादातर अनदेखा किया जाता है. उदाहरण के लिए, मान लें कि आपके पास `Flow<foo\>` रिटर्न टाइप है और टेबल खाली है. Java CodeGen में इससे कोई समस्या नहीं होगी, लेकिन Kotlin CodeGen में आपको गड़बड़ी का मैसेज मिलेगा. इससे बचने के लिए, आपको `Flow<foo?\>` का इस्तेमाल करना होगा. यह मानते हुए कि कोई शून्य वैल्यू दी गई है. </foo?\></foo\>

  • Room Gradle प्लगिन के लिए नया आर्टफ़ैक्ट, Room में androidx.room आईडी के साथ जोड़ा गया है. इससे Room में मौजूद कई समस्याएं हल हो जाती हैं. ये समस्याएं, Gradle एनोटेशन प्रोसेसर के विकल्पों के ज़रिए स्कीमा के इनपुट और आउटपुट से जुड़ी होती हैं. ज़्यादा जानकारी के लिए, Room वर्शन 2.6.0-alpha02 के रिलीज़ नोट देखें.
  • Room Entities में वैल्यू क्लास, अब केएसपी के लिए काम करती हैं. (4194095)
  • Room में अब डीएओ फ़ंक्शन में नेस्ट किए गए मैप रिटर्न टाइप इस्तेमाल किए जा सकते हैं. (I13f48, 203008711)

वर्शन 2.6.0-rc01

20 सितंबर, 2023

androidx.room:room-*:2.6.0-rc01 रिलीज़ हो गया है. वर्शन 2.6.0-rc01 में ये बदलाव शामिल हैं.

वर्शन 2.6.0-beta01

23 अगस्त, 2023

androidx.room:room-*:2.6.0-beta01 रिलीज़ हो गया है. वर्शन 2.6.0-beta01 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • अपसर्ट के दौरान SQLite अपवाद को मैनेज करना. यह अपवाद तब मिलता है, जब अपसर्ट के दौरान 2067 SQLITE_CONSTRAINT_UNIQUE अपवाद मिलता है. अपसर्ट को अपडेट करना चाहिए. (If2849, b/243039555)

वर्शन 2.6.0-alpha03

9 अगस्त, 2023

androidx.room:room-*:2.6.0-alpha03 रिलीज़ हो गया है. वर्शन 2.6.0-alpha03 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • Room में अब डीएओ फ़ंक्शन में नेस्ट किए गए मैप रिटर्न टाइप इस्तेमाल किए जा सकते हैं. (I13f48, 203008711)

एपीआई में बदलाव

  • @MapInfo को बदलने के लिए, @MapColumn नाम का एक नया टाइप एनोटेशन बनाया गया है. अब का इस्तेमाल नहीं किया जा सकता. @MapInfo एनोटेशन में दिए गए हर कॉलम के नाम (keyColumnName, valueColumnName या दोनों) के लिए, आपको सिर्फ़ columnName के साथ @MapColumn एनोटेशन का एलान करना होगा. साथ ही, डीएओ फ़ंक्शन के रिटर्न टाइप में रेफ़रंस किए जा रहे खास टाइप के आर्ग्युमेंट (मैप की कुंजी या वैल्यू) पर एनोटेशन का इस्तेमाल करना होगा. ऐसा इसलिए है, क्योंकि @MapColumn एनोटेशन का इस्तेमाल, डीएओ फ़ंक्शन के रिटर्न टाइप में टाइप आर्ग्युमेंट पर सीधे तौर पर किया जाता है. इसे @MapInfo की तरह फ़ंक्शन पर इस्तेमाल नहीं किया जाता. ज़्यादा जानकारी के लिए, कृपया @MapColumn का दस्तावेज़ देखें. (Ib0305, b/203008711)
  • साथ काम करने की सुविधा को दबाने के लिए, एपीआई फ़ाइलों को अपडेट किया गया (I8e87a, b/287516207)
  • Room Gradle प्लगिन के एपीआई अपडेट कर दिए गए हैं, ताकि हर वैरिएंट के लिए कॉन्फ़िगरेशन की ज़रूरत न पड़े. इसका मतलब है कि प्लगिन, सभी वैरिएंट के लिए एक ग्लोबल जगह को स्वीकार कर सकता है. इसके लिए, कई डायरेक्ट्री बनाने की ज़रूरत नहीं होती. इससे माइग्रेशन की प्रोसेस आसान हो जाती है. साथ ही, फ़्लेवर या बिल्ड टाइप स्कीमा को मैन्युअल तरीके से कॉन्फ़िगर करने की सुविधा भी मिलती है. इसके अलावा, प्लगिन के फ़ायदे भी मिलते हैं. जैसे, फिर से जनरेट किए जा सकने वाले और कैश मेमोरी में सेव किए जा सकने वाले बिल्ड. (I09d6f, b/278266663)

गड़बड़ियां ठीक की गईं

  • QueryInterceptorStatement में मेमोरी लीक की संभावित समस्या को ठीक किया गया. (I193d1)
  • QueryInterceptorDatabase execSQL() फ़ंक्शन में गलत व्यवहार को ठीक किया गया. (Iefdc8)

वर्शन 2.6.0-alpha02

21 जून, 2023

androidx.room:room-*:2.6.0-alpha02 रिलीज़ हो गया है. वर्शन 2.6.0-alpha02 में ये बदलाव शामिल हैं.

Room Gradle प्लगिन

इस नई रिलीज़ में, Room Gradle प्लगिन के लिए एक नया आर्टफ़ैक्ट शामिल है. इसका आईडी androidx.room है. इससे Room में मौजूद कई समस्याएं हल हो जाती हैं. ये समस्याएं, Gradle एनोटेशन प्रोसेसर के विकल्पों के ज़रिए स्कीमा के इनपुट और आउटपुट से जुड़ी होती हैं. Room Gradle प्लग इन, प्रोजेक्ट को इस तरह कॉन्फ़िगर करता है कि जनरेट किए गए स्कीमा, अपने-आप होने वाले माइग्रेशन के लिए इस्तेमाल किए जाते हैं और कंपाइल टास्क के आउटपुट होते हैं. इन्हें इस तरह से कॉन्फ़िगर किया जाता है कि बिल्ड को फिर से जनरेट किया जा सके और उन्हें कैश मेमोरी में सेव किया जा सके. प्लग इन, बुनियादी स्कीमा की जगह को कॉन्फ़िगर करने के लिए डीएसएल उपलब्ध कराता है:

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

इसके बाद, प्लग इन, Room कंपाइलर और अलग-अलग कंपाइल टास्क और उनके बैकएंड (javac, KAPT, KSP) को कॉन्फ़िगर करेगा, ताकि स्कीमा फ़ाइलों को फ़्लेवर वाले फ़ोल्डर में आउटपुट किया जा सके. जैसे, schemas/flavorOneDebug/com.package.MyDatabase/1.json. आम तौर पर, इन फ़ाइलों को रिपॉज़िटरी में चेक-इन किया जाता है, ताकि इनका इस्तेमाल पुष्टि करने और अपने-आप माइग्रेट करने के लिए किया जा सके. व्याख्या प्रोसेसर के विकल्पों के बजाय प्लगिन का इस्तेमाल करने पर, मौजूदा स्कीमा फ़ाइलों को प्लगिन से बनाई गई फ़्लेवर डायरेक्ट्री में कॉपी करना होगा. यह माइग्रेशन की एक प्रोसेस है, जिसे मैन्युअल तरीके से करना होगा. सुझाव/राय देने या शिकायत करने की सुविधा मिलने और प्लगिन के स्टेबल होने के बाद, developers.android.com में मौजूद स्कीमा दस्तावेज़ को अपडेट किया जाएगा. इसलिए, कृपया इसे आज़माएं.

एपीआई में बदलाव

  • RoomDatabase.QueryCallback को फ़ंक्शनल इंटरफ़ेस के तौर पर तय किया गया है, ताकि एसएएम कन्वर्ज़न के इस्तेमाल की अनुमति दी जा सके. (Iab8ea, b/281008549)

गड़बड़ियां ठीक की गईं

  • Room सोर्स को Java से Kotlin में माइग्रेट करने के बाद, Robolectric में डेटाबेस को इंस्टैंशिएट करते समय आने वाली समस्या को हल किया गया. (Ic053c, b/274924903)

वर्शन 2.6.0-alpha01

22 मार्च, 2023

androidx.room:room-*:2.6.0-alpha01 रिलीज़ हो गया है. वर्शन 2.6.0-alpha01 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • केएसपी के लिए Room में वैल्यू क्लास का इस्तेमाल किया जा सकता है. Room अब इकाइयों में वैल्यू क्लास के साथ काम कर सकता है. (4194095)
  • Kotlin कोड जनरेशन (या “Kotlin CodeGen”) को अब Room (4297ec0) में चालू किया जा सकता है. Room में Kotlin CodeGen को चालू करने के लिए, KSP के लिए प्रोसेसर के विकल्पों में room.generateKotlin विकल्प का नाम जोड़ें. केएसपी के लिए प्रोसेसर के विकल्प पास करने के तरीके के बारे में ज़्यादा जानने के लिए, केएसपी का दस्तावेज़ देखें.

ध्यान दें: Kotlin CodeGen का इस्तेमाल करते समय, यह ध्यान रखना ज़रूरी है कि इसमें कुछ और पाबंदियां जोड़ी गई हैं. Kotlin CodeGen में, DAO गेटर या DAO क्वेरी के तौर पर ऐब्स्ट्रैक्ट प्रॉपर्टी इस्तेमाल करने की अनुमति नहीं है. इसके बजाय, उन्हें फ़ंक्शन के तौर पर फिर से लिखा जाना चाहिए. इससे इस गलत धारणा से बचा जा सकता है कि प्रॉपर्टी की वैल्यू में बदलाव नहीं किया जा सकता और उसका नतीजा तय होता है. एक और पाबंदी जोड़ी गई है. इसके तहत, Kotlin CodeGen के लिए Room में, अब Nullable कलेक्शन के रिटर्न टाइप इस्तेमाल नहीं किए जा सकते.

चेतावनी: Kotlin CodeGen का इस्तेमाल करने पर, आपको लग सकता है कि आपके प्रोजेक्ट में शून्यता के लिए ज़्यादा सख्त नियम हैं. Kotlin CodeGen में, टाइप आर्ग्युमेंट की शून्यता अहम होती है. हालांकि, Java में इसे ज़्यादातर अनदेखा किया जाता है. उदाहरण के लिए, मान लें कि आपके पास `Flow<foo\>` रिटर्न टाइप है और टेबल खाली है. Java CodeGen में इससे कोई समस्या नहीं होगी, लेकिन Kotlin CodeGen में आपको गड़बड़ी का मैसेज मिलेगा. इससे बचने के लिए, आपको `Flow<foo?\>` का इस्तेमाल करना होगा. यह मानते हुए कि कोई शून्य वैल्यू दी गई है. </foo?\></foo\>

एपीआई में बदलाव

  • डीएओ मेथड के रिटर्न टाइप में, नलेबल कलेक्शन के गलत इस्तेमाल को रोकना. (I777dc, b/253271782, b/259426907)
  • अमान्य ट्रैकर में हुए बदलावों को दिखाने वाला फ़्लो बनाने के लिए, एक एपीआई जोड़ें. यह एपीआई, ऐसी स्ट्रीम बनाने के लिए मददगार है जिन्हें डेटाबेस में होने वाले बदलावों पर प्रतिक्रिया देनी होती है. (I8c790, b/252899305)

गड़बड़ियां ठीक की गईं

  • Kotlin codegen में, DAO गेटर या DAO क्वेरी के तौर पर ऐब्स्ट्रैक्ट प्रॉपर्टी इस्तेमाल करने की अनुमति न दें. इसके बजाय, उन्हें फ़ंक्शन के तौर पर फिर से लिखा जाना चाहिए. इससे इस गलत धारणा से बचा जा सकता है कि प्रॉपर्टी की वैल्यू में बदलाव नहीं किया जा सकता और उसका नतीजा तय होता है. (If6a13, b/127483380, b/257967987)

वर्शन 2.5.2

वर्शन 2.5.2

21 जून, 2023

androidx.room:room-*:2.5.2 रिलीज़ हो गया है. वर्शन 2.5.2 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • kotlinx-metadata-jvm के साथ काम न करने की समस्या को ठीक किया गया. (386d5c)
  • उस समस्या को ठीक किया गया है जिसकी वजह से Robolectric टेस्ट में इस्तेमाल किए जाने पर, Room में गड़बड़ी होती थी. (f79bea, b/274924903)

वर्शन 2.5.1

वर्शन 2.5.1

22 मार्च, 2023

androidx.room:room-*:2.5.1 रिलीज़ हो गया है. वर्शन 2.5.1 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • अगर डेटाबेस पहले से खुला है, तो FrameworkSQLiteHelper में डेटाबेस की पैरंट डायरेक्ट्री को देखने से बचें. (5de86b8)
  • डेटाबेस पहले से खुला है या नहीं, यह देखने के लिए isOpenInternal का इस्तेमाल करें. (e91fb35)
  • Room के acquireTransactionThread() में, रीएंट्रेंट केस को बेहतर तरीके से मैनेज करने की सुविधा अब उपलब्ध है. (219f98b). सस्पेंडिंग ट्रांज़ैक्शन के दौरान, Room, ट्रांज़ैक्शन एक्ज़ीक्यूटर से थ्रेड का इस्तेमाल करता है. साथ ही, इसमें इवेंट लूप शुरू करता है और सस्पेंडिंग डेटाबेस ऑपरेशन को इसमें भेजता है, ताकि वे सभी ट्रांज़ैक्शन कोरूटीन में शामिल हो जाएं. आम तौर पर, लेन-देन का थ्रेड, लेन-देन शुरू करने वाले थ्रेड से अलग होता है. हालांकि, कुछ मामलों में ये दोनों एक ही होते हैं. रीएंट्रेंट के ऐसे मामलों को हैंडल करने के लिए, withTransaction() को फिर से रिफ़ैक्टर किया गया है. इससे अब यह कंट्रोल जॉब पर निर्भर नहीं रहेगा. इसके बजाय, यह लेन-देन थ्रेड में runBlocking से, लेन-देन ब्लॉक को निलंबित करने की प्रोसेस को लागू करेगा.

वर्शन 2.5.0

वर्शन 2.5.0

22 फ़रवरी, 2023

androidx.room:room-paging-guava:2.5.0, androidx.room:room-paging-rxjava2:2.5.0, और androidx.room:room-paging-rxjava3:2.5.0 रिलीज़ किए गए हैं. वर्शन 2.5.0 में ये बदलाव शामिल हैं.

वर्शन 2.5.0

11 जनवरी, 2023

androidx.room:room-*:2.5.0 रिलीज़ हो गया है. वर्शन 2.5.0 में ये बदलाव शामिल हैं.

2.4.0 के बाद किए गए अहम बदलाव

  • room-runtime के सभी सोर्स को Java से Kotlin में बदल दिया गया है. ध्यान दें कि अगर आपका कोड Kotlin में है, तो आपको सोर्स के साथ काम न करने से जुड़ी समस्याएं आ सकती हैं. ऐसा लाइब्रेरी को Kotlin में बदलने की वजह से होता है. उदाहरण के लिए, सोर्स कोड में किया गया एक ऐसा बदलाव जो पुराने वर्शन के साथ काम नहीं करता, वह यह है कि InvalidationTracker में अब आपको Observer में onInvalidate() का एलान करना होगा, ताकि MutableSet के बजाय Set टाइप का पैरामीटर हो. इसके अलावा, कुछ गेटर मेथड को प्रॉपर्टी में बदल दिया गया है. इसके लिए, Kotlin फ़ाइलों पर प्रॉपर्टी ऐक्सेस सिंटैक्स की ज़रूरत होती है. अगर आपको कोई बड़ी गड़बड़ी मिलती है, तो कृपया उसकी शिकायत करें.
  • एक नया शॉर्टकट एनोटेशन, @Upsert जोड़ा गया है. यह किसी इकाई को तब शामिल करने की कोशिश करता है, जब यूनीकनेस से जुड़ी कोई समस्या न हो. अगर कोई समस्या होती है, तो यह इकाई को अपडेट करता है. (I7aaab, b/241964353)
  • रूम पेजिंग की सुविधा के लिए, नए रूम-पेजिंग आर्टफ़ैक्ट room-paging-rxjava2, room-paging-rxjava3, और room-paging-guava जोड़े गए हैं.
  • @MapInfo में, साफ़ तौर पर जानकारी देने के लिए, कुंजी और वैल्यू टेबल के नाम उपलब्ध कराने वाले एपीआई जोड़े गए (Icc4b5)

वर्शन 2.5.0-rc01

7 दिसंबर, 2022

androidx.room:room-*:2.5.0-rc01 रिलीज़ हो गया है. वर्शन 2.5.0-rc01 में ये बदलाव शामिल हैं.

  • यह रिलीज़, 2.5.0-beta02 से मिलती-जुलती है.

वर्शन 2.5.0-beta02

9 नवंबर, 2022

androidx.room:room-*:2.5.0-beta02 रिलीज़ हो गया है. वर्शन 2.5.0-beta02 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • ऐसे कई एपीआई को ठीक किया गया है जो क्वेरी आर्ग्युमेंट को इनवैरिएंट (Array<Any?>) से कॉन्ट्रावैरिएंट (Array<out Any?>) में बदलते हैं, ताकि वे Java के कलेक्शन के व्यवहार से मैच कर सकें. (b/253531073)

वर्शन 2.5.0-beta01

5 अक्टूबर, 2022

androidx.room:room-*:2.5.0-beta01 रिलीज़ हो गया है. वर्शन 2.5.0-beta01 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • @Upsert के साथ काम करने वाले कम से कम वर्शन को एपीआई 16 पर सेट करें. ऐसा इसलिए होता है, क्योंकि पुराने एपीआई में प्राइमरी कुंजी की पाबंदी से जुड़ी समस्या की पहचान नहीं की जा सकती. (I5f67f, b/243039555)

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसमें शैडो टेबल, स्कीमा .json फ़ाइलों में गलत तरीके से एक्सपोर्ट हो रही थीं. इससे फ़ाइलें खराब हो रही थीं. (I4f83b, b/246751839)

वर्शन 2.5.0-alpha03

24 अगस्त, 2022

androidx.room:room-*:2.5.0-alpha03 रिलीज़ हो गया है. वर्शन 2.5.0-alpha03 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • एक नया शॉर्टकट एनोटेशन, @Upsert जोड़ा गया है. यह किसी इकाई को तब शामिल करने की कोशिश करता है, जब यूनीकनेस से जुड़ी कोई समस्या न हो. अगर कोई समस्या होती है, तो यह इकाई को अपडेट करता है. (I7aaab, b/241964353)

गड़बड़ियां ठीक की गईं

  • ऑटो-माइग्रेशन के दौरान, फ़ॉरेन की कंस्ट्रेंट की जांच करते समय, Room अब IllegalStateException के बजाय SQLiteConstraintException थ्रो करेगा. (I328dd)
  • getOpenHelper, getQueryExecutor, और getTransactionExecutor के गेटर / प्रॉपर्टी के लिए, Kotlin सोर्स के साथ काम न करने वाले बदलाव को ठीक किया गया. (Iad0ac)

वर्शन 2.5.0-alpha02

1 जून, 2022

androidx.room:room-*:2.5.0-alpha02 रिलीज़ हो गया है. वर्शन 2.5.0-alpha02 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • रूम पेजिंग की सुविधा के लिए, नए room-paging आर्टफ़ैक्ट room-paging-rxjava2, room-paging-rxjava3, और room-paging-guava जोड़े गए हैं.(41a1d4,b/203666906),(eb6098,b/203666906),(1b9ae4,b/203666906)

एपीआई में बदलाव

  • room-runtime के सभी कोड को Java से Kotlin में बदल दिया गया है. (If2069, b/206859668),(Ie4b55, b/206859668), (I697ee, b/206859668), (I96c25, b/206859668)

    ध्यान दें: लाइब्रेरी को Kotlin में बदलने की वजह से, आपको सोर्स के साथ काम न करने से जुड़ी समस्याएं आ सकती हैं. अगर आपका कोड Kotlin में था और Room के पुराने वर्शन को कॉल कर रहा था, तो नए वर्शन को इन मामलों को मैनेज करना होगा. उदाहरण के लिए, सोर्स कोड में किया गया एक ऐसा बदलाव जो पुराने वर्शन के साथ काम नहीं करता, वह यह है कि InvalidationTracker में अब आपको Observer में onInvalidate() का एलान करना होगा, ताकि MutableSet के बजाय Set टाइप का पैरामीटर हो.

  • @MapInfo में, साफ़ तौर पर जानकारी देने के लिए, कुंजी और वैल्यू टेबल के नाम उपलब्ध कराने वाले एपीआई जोड़े गए (Icc4b5)
  • प्रॉपर्टी गेटर में @Ignore को फिर से अनुमति देने के लिए, सोर्स के साथ काम करने से जुड़ी समस्या को ठीक करें. (Ifc2fb)

गड़बड़ियां ठीक की गईं

  • डुप्लीकेट कॉलम रिज़ॉल्यूशन ह्यूरिस्टिक एल्गोरिदम. Room अब मल्टीमैप क्वेरी में, साफ़ तौर पर न बताए गए कॉलम की समस्या को हल करने की कोशिश करेगा. इससे एक ही नाम वाली टेबल को, नतीजे के डेटा ऑब्जेक्ट से सही तरीके से मैप किया जा सकता है. (I4b444, b/201306012, b/212279118)

वर्शन 2.5.0-alpha01

23 फ़रवरी, 2022

androidx.room:room-*:2.5.0-alpha01 रिलीज़ हो गया है. वर्शन 2.5.0-alpha01 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • उस समस्या को ठीक किया गया है जिसकी वजह से Kotlin सोर्स में, Room @IntDef के इस्तेमाल को लागू नहीं किया जा रहा था. (I75f41, b/217951311)
  • सोर्स के साथ काम करने से जुड़ी समस्या को ठीक किया गया, ताकि प्रॉपर्टी गेटर में @Query को फिर से अनुमति दी जा सके. (I0a09b)
  • room-common को Java से Kotlin में बदला गया. (I69c48, b/206858235)

    ध्यान दें: आपको सोर्स के साथ काम न करने से जुड़ी समस्याएं आ सकती हैं. ऐसा इसलिए, क्योंकि लाइब्रेरी को Kotlin में बदलने के दौरान, कुछ प्रॉपर्टी को कंपैनियन ऑब्जेक्ट में ले जाया गया है. अगर आपका कोड Kotlin में था और Room के पुराने वर्शन को कॉल कर रहा था, तो नए वर्शन को इन प्रॉपर्टी को ऐक्सेस करते समय ".Companion" सफ़िक्स की ज़रूरत होगी.

  • रूम-माइग्रेशन को Java से Kotlin में बदला गया. (I2724b, b/206858622)
  • room-runtime में, paging से जुड़ी फ़ाइलों को Java से Kotlin में बदला गया. (I82fc8, b/206859668)
  • FrameworkSQLite* लेवल पर, मल्टी-प्रोसेस लॉक और इस्तेमाल के लिए एपीआई जोड़ा गया है. इससे मल्टी-प्रोसेस के लिए पहली बार डेटाबेस बनाने और माइग्रेशन को सुरक्षित रखने में मदद मिलती है. (Ied267, b/193182592)

गड़बड़ियां ठीक की गईं

  • Kotlin सोर्स में इंटरनल प्रॉपर्टी के लिए सहायता जोड़ी गई. यह Room के काम करने के तरीके में थोड़ा बदलाव है. इसमें फ़ंक्शन को गेटर/सेटर के तौर पर प्रॉपर्टी से मैच करते समय, फ़ंक्शन के सोर्स नेम का इस्तेमाल किया जाएगा. पहले, यह फ़ंक्शन के JVM नेम का इस्तेमाल करता था, जो इंटरनल फ़ंक्शन/प्रॉपर्टी के लिए अलग होता है. अगर निजी प्रॉपर्टी के लिए गेटर/सेटर को मैच करने के लिए, कस्टम @JvmName एनोटेशन का इस्तेमाल किया जा रहा है, तो कृपया अपडेट के बाद जनरेट किए गए कोड की दोबारा जांच करें (If6531, b/205289020)

वर्शन 2.4.3

वर्शन 2.4.3

27 जुलाई, 2022

androidx.room:room-*:2.4.3 रिलीज़ हो गया है. वर्शन 2.4.3 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसकी वजह से Room, Kotlin 1.7 में सस्पेंड फ़ंक्शन की पहचान नहीं कर पाता था (b/236612358)

वर्शन 2.4.2

वर्शन 2.4.2

23 फ़रवरी, 2022

androidx.room:room-*:2.4.2 रिलीज़ हो गया है. वर्शन 2.4.2 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • Dao @Transaction के सस्पेंड फ़ंक्शन के लिए कोड जनरेट करने से जुड़ी समस्या को ठीक किया गया. इस फ़ंक्शन में एक बॉडी होती है, जो -Xjvm-default=all या इसके जैसे किसी अन्य टूल के साथ कंपाइल करने की वजह से, डिफ़ॉल्ट इंटरफ़ेस मेथड जनरेट करती है. (Ia4ce5)
  • उस गड़बड़ी को ठीक किया गया है जिसमें Room, Array<ByteArray> रिटर्न टाइप क्वेरी मेथड के लिए कोड जनरेट करता है. (If086e, b/213789489)

वर्शन 2.4.1

वर्शन 2.4.1

12 जनवरी, 2022

androidx.room:room-*:2.4.1 रिलीज़ हो गया है. वर्शन 2.4.1 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • Kotlin सोर्स में इंटरनल प्रॉपर्टी के लिए सहायता जोड़ी गई. यह Room के काम करने के तरीके में थोड़ा बदलाव है. इसमें फ़ंक्शन को गेटर/सेटर के तौर पर प्रॉपर्टी से मैच करते समय, फ़ंक्शन के सोर्स नेम का इस्तेमाल किया जाएगा. पहले, यह फ़ंक्शन के JVM नेम का इस्तेमाल करता था, जो इंटरनल फ़ंक्शन/प्रॉपर्टी के लिए अलग होता है. अगर निजी प्रॉपर्टी के लिए गेटर/सेटर को मैच करने के लिए, कस्टम @JvmName एनोटेशन का इस्तेमाल किया जा रहा है, तो कृपया अपडेट के बाद जनरेट किए गए कोड की दोबारा जांच करें (If6531, b/205289020)

वर्शन 2.4.0

वर्शन 2.4.0

15 दिसंबर, 2021

androidx.room:room-*:2.4.0 रिलीज़ हो गया है. वर्शन 2.4.0 में ये कमिट शामिल हैं.

2.3.0 के बाद किए गए अहम बदलाव

  • अपने-आप माइग्रेट होने की सुविधा: Room अब स्कीमा एक्सपोर्ट होने पर, माइग्रेशन को अपने-आप जनरेट करने के लिए एपीआई उपलब्ध कराता है. Room को यह बताने के लिए कि उसे अपने-आप माइग्रेट होने की सुविधा जनरेट करनी चाहिए, नई प्रॉपर्टी @Database#autoMigrations का इस्तेमाल किया जा सकता है. इससे यह एलान किया जा सकता है कि किन वर्शन से और किन वर्शन पर अपने-आप माइग्रेट होने की सुविधा चालू की जाए. जब Room को टेबल और कॉलम के नाम बदलने या मिटाने के बारे में ज़्यादा जानकारी की ज़रूरत होती है, तब @AutoMigration एनोटेशन, इस तरह के इनपुट वाली स्पेसिफ़िकेशन क्लास का एलान कर सकता है. ज़्यादा जानकारी के लिए, @AutoMigration दस्तावेज़ देखें.
  • अपने-आप होने वाले माइग्रेशन में डिपेंडेंसी इंजेक्शन: @ProvidedAutoMigrationSpec एक नया एपीआई है. इससे यह एलान किया जाता है कि रनटाइम के दौरान, RoomDatabase.Builder#addAutoMigrationSpec() के ज़रिए AutoMigrationSpec उपलब्ध कराया जाएगा. इससे डिपेंडेंसी इंजेक्शन फ़्रेमवर्क को ऐसी खास जानकारी देने की अनुमति मिलती है, जब उन्हें जटिल डिपेंडेंसी की ज़रूरत होती है.
  • अपने-आप होने वाले माइग्रेशन के लिए, Migration Test Helper की सुविधा: Room के MigrationTestHelper को अपडेट किया गया, ताकि अपने-आप होने वाले माइग्रेशन की सुविधा काम कर सके. इसके लिए, एक नया कंस्ट्रक्टर एपीआई उपलब्ध कराया गया है. यह एपीआई, टेस्ट किए जा रहे डेटाबेस क्लास को रिसीव करता है. इससे हेल्पर को runMigrationsAndValidate के दौरान, अपने-आप होने वाले माइग्रेशन को उसी तरह जोड़ने की अनुमति मिलती है.
  • Room-Paging Support: androidx.room:room-paging को रिलीज़ किया गया है. इसमें androidx.paging.PagingSource दिखाने वाली Room क्वेरी के लिए, नेटिव Paging 3.0 की सुविधा उपलब्ध है.
  • रिलेशनल क्वेरी के तरीके: Room अब मल्टीमैप रिटर्न टाइप @Dao तरीकों के साथ काम करता है. ये तरीके, JOIN स्टेटमेंट के लिए काम के होते हैं. मल्टीमैप के लिए, Map, SparseArray, LongSparseArray के साथ-साथ Guava के ImmutableMap, ImmutableSetMultimap, और ImmutableListMultimap का इस्तेमाल किया जा सकता है.

वर्शन 2.4.0-rc01

1 दिसंबर, 2021

androidx.room:room-*:2.4.0-rc01 रिलीज़ हो गया है. वर्शन 2.4.0-rc01 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • Kotlin 1.6 के साथ काम करने के लिए, Room की केएसपी डिपेंडेंसी को 1.6.0-1.0.1 पर अपडेट करें

वर्शन 2.4.0-beta02

17 नवंबर, 2021

androidx.room:room-*:2.4.0-beta02 रिलीज़ हो गया है. वर्शन 2.4.0-beta02 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • हमने @MapInfo में SparseArray और LongSparseArray के लिए सहायता जोड़ी है. (Ic91a2b/138910317)

गड़बड़ियां ठीक की गईं

  • हमने एक नया TypeConverter ऐनलाइज़र जोड़ा है. यह टाइप में शून्यता की जानकारी को ध्यान में रखता है. यह जानकारी सिर्फ़ केएसपी में उपलब्ध है. इसलिए, यह डिफ़ॉल्ट रूप से सिर्फ़ केएसपी में चालू होती है. अगर इससे कोई समस्या आती है, तो व्याख्या प्रोसेसर को room.useNullAwareTypeAnalysis=false पास करके, इसे बंद किया जा सकता है. अगर ऐसा होता है, तो कृपया गड़बड़ी की शिकायत करें, क्योंकि आने वाले समय में इस फ़्लैग को हटा दिया जाएगा. इस नए TypeConverter ऐनलाइज़र के साथ, हमारा सुझाव है कि सिर्फ़ नॉन-नुल रिसीविंग TypeConverters उपलब्ध कराएं. ऐसा इसलिए, क्योंकि नए ऐनलाइज़र में उन्हें नुल चेक के साथ रैप करने की सुविधा होती है. ध्यान दें कि इसका असर KAPT या Java का इस्तेमाल करने वाले उपयोगकर्ताओं पर नहीं पड़ता. ऐसा इसलिए, क्योंकि व्याख्या प्रोसेसर (KSP से अलग) के टाइप में शून्यता की जानकारी नहीं होती. (Ia88f9, b/193437407)
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, Room को SQL गड़बड़ी के साथ कंपाइल नहीं किया जा सकता था. ऐसा तब होता था, जब किसी एफ़टीएस इकाई को आईसीयू टोकनाइज़र का इस्तेमाल करने के लिए एलान किया जाता था. (I00db9, b/201753224)
  • ऑटो माइग्रेशन में, वर्शन के बीच एंबेड की गई इकाई में जोड़े गए नए कॉलम से जुड़ी समस्या को हल किया गया. (I5fcb1b/193798291)
  • हमने LEFT JOIN क्वेरी में, रिलेशनल क्वेरी मेथड के रिटर्न टाइप से जुड़ी समस्या को ठीक कर दिया है. इन बदलावों के बाद, अगर एक से ज़्यादा मैपिंग मौजूद है, तो किसी कुंजी के लिए दिखाए गए कलेक्शन में अमान्य वैल्यू वाला ऑब्जेक्ट शामिल नहीं होगा. ऐसा तब होगा, जब वह कर्सर में न मिले. अगर कोई मान्य वैल्यू नहीं मिलती है, तो कुंजी को खाली कलेक्शन पर मैप किया जाएगा. (Id5552b/201946438)
  • अपने-आप माइग्रेट होने की समस्या को ठीक किया गया. इसमें कॉलम के नामों में SQLite कीवर्ड एस्केप नहीं हो पा रहे थे. (Idbed4b/197133152)

वर्शन 2.4.0-beta01

13 अक्टूबर, 2021

androidx.room:room-*:2.4.0-beta01 रिलीज़ हो गया है. वर्शन 2.4.0-beta01 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • ऑटो-माइग्रेशन की उस समस्या को ठीक किया गया है जिसमें नए कॉलम नहीं जोड़े जा रहे थे. ऐसा तब हो रहा था, जब उसी ऑटो-माइग्रेशन की किसी दूसरी टेबल में भी उसी नाम का एक नया कॉलम मौजूद था. (Ia5db5, b/200818663)
  • room-paging से जनरेट किया गया PagingSource लागू करने का तरीका, अब RoomDatabase.Builder से पास किए गए queryExecutor का इस्तेमाल करता है. इसलिए, इसे पहले के Dispatchers.IO के बजाय बदला जा सकता है. (Iae259)

वर्शन 2.4.0-alpha05

29 सितंबर, 2021

androidx.room:room-*:2.4.0-alpha05 रिलीज़ हो गया है. वर्शन 2.4.0-alpha05 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • UUID के लिए, पहले से मौजूद टाइप कन्वर्टर जोड़ा गया. (I671e8, b/73132006)

एपीआई में बदलाव

  • TypeConverters एनोटेशन में एक नई प्रॉपर्टी जोड़ी गई है, ताकि डेवलपर पहले से मौजूद Enum और UUID कन्वर्टर को बंद कर सकें. डिफ़ॉल्ट रूप से, ये कन्वर्टर चालू होते हैं. हालांकि, इन्हें किसी खास स्कोप या पूरे डेटाबेस के लिए बंद किया जा सकता है. ज़्यादा जानकारी के लिए, TypeConverters दस्तावेज़ देखें. (36ae9e, b/195413406)

  • @MapInfo एनोटेशन की मदद से, डीएओ में मल्टीमैप रिटर्न टाइप के लिए, नॉन-पीओजेओ कुंजियों/वैल्यू का इस्तेमाल किया जा सकता है. (I4d704)

@MapInfo की ज़रूरत तब होगी, जब मैप की कुंजी या वैल्यू वाला कॉलम किसी एक कॉलम से हो. उदाहरण देखें:

@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>
  • Room के साथ Paging3 का इस्तेमाल करते समय, room-paging को ज़रूरी आर्टफ़ैक्ट बनाएं. (Ieaffe)

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसमें मल्टीमैप क्वेरी के नतीजे सही क्रम में नहीं दिखते थे. ऐसा तब होता था, जब क्वेरी में मैप की कुंजी के कॉलम का ORDER BY क्लॉज़ शामिल होता था. (I6b887)

बाहरी योगदान

  • @Index में इंडेक्स ऑर्डर तय करने के लिए, नया एपीआई जोड़ा गया. निकिता ज़ेलॉन्किन को धन्यवाद. (I033fc)

वर्शन 2.4.0-alpha04

21 जुलाई, 2021

androidx.room:room-*:2.4.0-alpha04 रिलीज़ हो गया है. वर्शन 2.4.0-alpha04 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • Room अब मल्टीमैप रिटर्न टाइप @Dao मेथड के साथ काम करता है. ये JOIN स्टेटमेंट के लिए काम के हैं. मल्टीमैप के लिए, Map के साथ-साथ Guava के ImmutableMap, ImmutableSetMultimap, और ImmutableListMultimap का इस्तेमाल किया जा सकता है.

    यहां मल्टीमैप क्वेरी के उदाहरण दिए गए हैं:

    वन-टू-वन रिलेशन मैप

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

    वन-टू-मेनी रिलेशन मैप (स्टैंडर्ड मल्टीमैप)

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

    मल्टीमैप के नतीजे को, एसिंक्रोनस रिटर्न टाइप में भी रैप किया जा सकता है. जैसे, LiveData, Rx का Observable या कोरूटीन Flow.

रूम-पेजिंग

  • androidx.room:room-paging को रिलीज़ किया गया है. इसमें androidx.paging.PagingSource दिखाने वाली रूम क्वेरी के लिए, नेटिव Paging 3.0 की सुविधा जोड़ी गई है.

    @Dao
    interface UserDao {
      @Query("SELECT * FROM users ORDER BY id ASC")
      fun loadUsers(): PagingSource<Int, User>
    }
    
  • यह आर्टफ़ैक्ट, Room से जनरेट किए गए androidx.paging.PagingSource के लागू होने की जगह, Paging 3.0 एपीआई पर बने आर्टफ़ैक्ट को लागू करता है. PagingSource का नया वर्शन, कुंजियों को अलग तरीके से पार्स करता है. इसलिए, Room के PagingSource को मैन्युअल तरीके से दी गई किसी भी कुंजी को इस बदलाव के हिसाब से अडजस्ट करना होगा. इसमें Pager के कंस्ट्रक्टर के ज़रिए पास की गई initialKey भी शामिल है. पेज, Key से लोड होना शुरू होंगे. इसमें Key, लोड होने वाला पहला आइटम होगा. यह मौजूदा तरीके से अलग है. इसमें LoadParams.Refresh.Key को उपयोगकर्ता की स्क्रोल पोज़िशन माना जाता है और आइटम, कुंजी से पहले और बाद में लोड होते हैं.

  • यह आर्टफ़ैक्ट ज़रूरी नहीं है. इससे ऑप्ट आउट करने पर, Paging 3.0 के लिए मौजूदा सहायता का इस्तेमाल किया जाएगा. इसे Room 2.3 में पेश किया गया था. हालांकि, आने वाले समय में रिलीज़ होने वाले वर्शन में, Room के साथ Paging 3.0 का इस्तेमाल करने वाले लोगों के लिए यह आर्टफ़ैक्ट ज़रूरी हो जाएगा. शामिल होने के लिए, अपने क्लासपाथ में नया Room-Paging आर्टफ़ैक्ट जोड़ें. अगर Gradle का इस्तेमाल किया जा रहा है, तो अपनी build.gradle फ़ाइल में यह स्निपेट जोड़ा जा सकता है:

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

गड़बड़ियां ठीक की गईं

  • ऑटो माइग्रेशन में, फ़ॉरेन की के उल्लंघन को मैनेज करने से जुड़ी समस्या को ठीक किया गया. (b/190113935)

वर्शन 2.4.0-alpha03

16 जून, 2021

androidx.room:room-*:2.4.0-alpha03 रिलीज़ हो गया है. वर्शन 2.4.0-alpha03 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • Room के MigrationTestHelper को अपडेट करें, ताकि अपने-आप होने वाले माइग्रेशन की सुविधा काम कर सके. इसके लिए, एक नया कंस्ट्रक्टर एपीआई उपलब्ध कराएं जो टेस्ट किए जा रहे डेटाबेस क्लास को रिसीव करता हो. इससे हेल्पर को runMigrationsAndValidate के दौरान, अपने-आप होने वाले माइग्रेशन को उसी तरह जोड़ने की अनुमति मिलती है.

गड़बड़ियां ठीक की गईं

  • Apple के M1 चिप के साथ काम करने के लिए, Room की SQLite नेटिव लाइब्रेरी से जुड़ी समस्या को ठीक किया गया. (b/174695268

  • उस समस्या को ठीक किया गया है जिसमें @Transaction फ़ंक्शन का रिटर्न टाइप Flow होने पर, Room गड़बड़ी नहीं दिखाता था (I56ddd, b/190075899)

  • ऑटो माइग्रेशन में इंडेक्स से जुड़ी समस्या को ठीक किया गया. b/177673291

डिपेंडेंसी अपडेट

  • Room में केएसपी की सुविधा अब केएसपी 1.5.10-1.0.0-beta01 पर निर्भर करती है. (1ecb11, b/160322705)

वर्शन 2.4.0-alpha02

5 मई, 2021

androidx.room:room-*:2.4.0-alpha02 रिलीज़ हो गया है. वर्शन 2.4.0-alpha02 में ये बदलाव शामिल हैं.

एपीआई में बदलाव

  • @ProvidedAutoMigrationSpec एक नया एपीआई है. इसका इस्तेमाल करके यह एलान किया जाता है कि रनटाइम के दौरान RoomDatabase.Builder#addAutoMigrationSpec() की मदद से AutoMigrationSpec उपलब्ध कराया जाएगा. इससे डिपेंडेंसी इंजेक्शन फ़्रेमवर्क को ऐसी खास जानकारी देने की अनुमति मिलती है, जब उन्हें जटिल डिपेंडेंसी की ज़रूरत होती है.

गड़बड़ियां ठीक की गईं

  • अपने-आप होने वाले माइग्रेशन से जुड़ी उस समस्या को ठीक किया गया है जिसकी वजह से @DatabaseView को सही तरीके से फिर से नहीं बनाया जा रहा था.

बाहरी योगदान

  • Room के JournalMode.TRUNCATE में आने वाली उस समस्या को ठीक किया गया है जिसमें InvalidationTracker कॉलबैक को कभी-कभी गलत तरीके से, बहुत देर से या बिलकुल भी शुरू नहीं किया जाता था. Uli Bubenheimer | bubenheimer@users.noreply.github.com (b/154040286) को धन्यवाद

वर्शन 2.4.0-alpha01

21 अप्रैल, 2021

androidx.room:room-*:2.4.0-alpha01 रिलीज़ हो गया है. वर्शन 2.4.0-alpha01 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • अपने-आप माइग्रेट होने की सुविधा: Room अब स्कीमा एक्सपोर्ट होने पर, माइग्रेशन को अपने-आप जनरेट करने के लिए एपीआई उपलब्ध कराता है. Room को यह बताने के लिए कि उसे अपने-आप माइग्रेट होने की सुविधा जनरेट करनी चाहिए, नई प्रॉपर्टी @Database#autoMigrations का इस्तेमाल किया जा सकता है. इससे यह एलान किया जा सकता है कि किन वर्शन से और किन वर्शन पर अपने-आप माइग्रेट होने की सुविधा चालू की जाए. जब Room को टेबल और कॉलम के नाम बदलने या मिटाने के बारे में ज़्यादा जानकारी की ज़रूरत होती है, तब @AutoMigration एनोटेशन, इस तरह के इनपुट वाली स्पेसिफ़िकेशन क्लास का एलान कर सकता है. ज़्यादा जानकारी के लिए, @AutoMigration दस्तावेज़ देखें.

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसमें Room के स्कीमा की पुष्टि करने की सुविधा, अतिरिक्त ब्रैकेट वाले defaultValue की गलत तरीके से पुष्टि कर रही थी. b/182284899

वर्शन 2.3.0

वर्शन 2.3.0

21 अप्रैल, 2021

androidx.room:room-*:2.3.0 रिलीज़ हो गया है. वर्शन 2.3.0 में ये बदलाव शामिल हैं.

2.2.0 के बाद किए गए अहम बदलाव

  • पहले से मौजूद Enum की सुविधा: अगर कोई टाइप कन्वर्टर नहीं दिया गया है, तो Room अब डिफ़ॉल्ट रूप से Enum से स्ट्रिंग और स्ट्रिंग से Enum में बदलने वाले टाइप कन्वर्टर का इस्तेमाल करेगा. अगर किसी enum के लिए टाइप कन्वर्टर पहले से मौजूद है, तो Room डिफ़ॉल्ट कन्वर्टर के बजाय उसका इस्तेमाल करेगा.
  • क्वेरी कॉलबैक: Room अब एक सामान्य कॉलबैक एपीआई RoomDatabase.QueryCallback उपलब्ध कराता है. इसका इस्तेमाल तब किया जाता है, जब क्वेरी लागू होने वाली हों. यह डीबग बिल्ड में लॉग इन करने के लिए मददगार हो सकता है. कॉलबैक को RoomDatabase.Builder#setQueryCallback() के ज़रिए सेट किया जा सकता है.
  • पहले से पैकेज किए गए सुधार: Room में अब इनपुट स्ट्रीम से पढ़े गए, पहले से पैकेज किए गए डेटाबेस का इस्तेमाल करके डेटाबेस बनाने के लिए एपीआई मौजूद हैं. इससे ऐसे मामलों में मदद मिलती है, जब पहले से पैकेज किए गए डेटाबेस को gzip किया जाता है.
  • टाइप कन्वर्टर उपलब्ध कराए गए: Room में अब टाइप कन्वर्टर के इंस्टेंस उपलब्ध कराने के लिए एपीआई मौजूद हैं. इससे ऐप्लिकेशन, उनके शुरू होने की प्रोसेस को कंट्रोल कर सकता है. Room को उपलब्ध कराए जाने वाले टाइप कन्वर्टर को मार्क करने के लिए, नए एनोटेशन @ProvidedTypeConverter का इस्तेमाल करें.
  • RxJava3 के साथ काम करना: Room अब RxJava3 के टाइप के साथ काम करता है. RxJava2 की तरह ही, डीएओ के ऐसे तरीके तय किए जा सकते हैं जिनका रिटर्न टाइप Flowable, Single, Maybe, और Completable हो. इसके अलावा, RxJava3 के साथ काम करने के लिए, एक नया आर्टफ़ैक्ट androidx.room:room-rxjava3 उपलब्ध है.
  • Paging 3.0 के लिए सहायता: Room अब @Query एनोटेशन वाले उन तरीकों के लिए, लागू करने की प्रोसेस जनरेट करने की सुविधा देगा जिनका रिटर्न टाइप androidx.paging.PagingSource है.

वर्शन 2.3.0-rc01

24 मार्च, 2021

androidx.room:room-*:2.3.0-rc01 रिलीज़ हो गया है. वर्शन 2.3.0-rc01 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसकी वजह से, Room से बनाई गई Coroutine Flow क्वेरी, निलंबित किए जा रहे withTransaction ब्लॉक में इस्तेमाल नहीं की जा सकती थीं. (I797bf)

वर्शन 2.3.0-beta03

10 मार्च, 2021

androidx.room:room-*:2.3.0-beta03 रिलीज़ हो गया है. वर्शन 2.3.0-beta03 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • केएसपी के लिए, इंक्रीमेंटल कंपाइलेशन की सुविधा जोड़ी गई. (I031c1, b/176453350)

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से मुख्य थ्रेड पर PagingSource बनाने से, ANR की गड़बड़ी ट्रिगर हो सकती थी. (I42b74, b/181221318)
  • @ExperimentalRoomApi के दिखने की सेटिंग को पैकेज प्राइवेट के बजाय सार्वजनिक के तौर पर सेट किया गया. (b/181356119)

बाहरी योगदान

  • Room को @Query एनोटेशन वाले डीएओ मेथड में, POJO रिटर्न टाइप स्वीकार करने की अनुमति दें. ऐसा तब करें, जब इसमें @SkipQueryVerification एनोटेशन भी हो. Room, क्वेरी के नतीजे को POJO रिटर्न टाइप में बदलने की पूरी कोशिश करेगा. ठीक उसी तरह जैसे @RawQuery एनोटेट किए गए डीएओ तरीके के लिए किया जाता है. ‘Markus Riegel | hey@marcorei.com’ को धन्यवाद. (I45acb)

वर्शन 2.3.0-beta02

18 फ़रवरी, 2021

androidx.room:room-*:2.3.0-beta02 रिलीज़ हो गया है. वर्शन 2.3.0-beta02 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • Room में अब Kotlin सिंबल प्रोसेसिंग केएसपी की सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है.

    केएसपी, KAPT की जगह इस्तेमाल किया जाता है. इससे Kotlin कंपाइलर पर, नेटिव तौर पर एनोटेशन प्रोसेसर चलाए जा सकते हैं. इससे बिल्ड टाइम काफ़ी कम हो जाता है.

    केएसपी के साथ Room का इस्तेमाल करने के लिए, केएसपी Gradle प्लगिन को लागू किया जा सकता है. साथ ही, अपनी बिल्ड फ़ाइल में kapt कॉन्फ़िगरेशन को ksp से बदला जा सकता है. उदाहरण के लिए, kapt 'androidx.room:room-compiler:2.3.0-beta02' के बजाय ksp 'androidx.room:room-compiler:2.3.0-beta02' का इस्तेमाल करें. ज़्यादा जानकारी के लिए, केएसपी से जुड़ा दस्तावेज़ देखें.

    ध्यान दें कि केएसपी पर अब भी एक्सपेरिमेंट किया जा रहा है. इसलिए, हमारा सुझाव है कि प्रोडक्शन कोड के लिए अब भी केएपीटी का इस्तेमाल करें. बिल्ड टाइम में कमी सिर्फ़ तब लागू होती है, जब KAPT का इस्तेमाल करने वाले कोई अन्य प्रोसेसर न हों. पहले से मालूम समस्याओं के बारे में जानने के लिए, b/160322705 देखें.

वर्शन 2.3.0-beta01

27 जनवरी, 2021

androidx.room:room-*:2.3.0-beta01 रिलीज़ हो गया है. वर्शन 2.3.0-beta01 में ये कमिट शामिल हैं.

नई सुविधाएं

  • अपने-आप बंद होने वाले डेटाबेस: Room में अब उन डेटाबेस को बंद करने की सुविधा है जिन्हें तय समय के बाद ऐक्सेस नहीं किया जाता. यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है. इसे RoomDatabase.Builder#setAutoCloseTimeout() को कॉल करके चालू किया जा सकता है. यह सुविधा, कई डेटाबेस वाले ऐप्लिकेशन के लिए काम की है.

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसमें अलग-अलग कॉन्फ़्लिक्ट स्ट्रेटजी वाले कई @Update या @Delete तरीकों वाले Dao तरीके, सिर्फ़ एक स्ट्रेटजी के साथ कोड जनरेट करते थे. इससे, तय की गई स्ट्रेटजी को अनदेखा कर दिया जाता था. (/I0b90d, b/176138543)

वर्शन 2.3.0-alpha04

16 दिसंबर, 2020

androidx.room:room-*:2.3.0-alpha04 रिलीज़ हो गया है. वर्शन 2.3.0-alpha04 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • Room अब एक सामान्य कॉलबैक एपीआई RoomDatabase.QueryCallback उपलब्ध कराता है. इसका इस्तेमाल तब किया जाता है, जब क्वेरी लागू होने वाली हों. यह डीबग बिल्ड में लॉग इन करने के लिए मददगार हो सकता है. कॉलबैक को RoomDatabase.Builder#setQueryCallback() के ज़रिए सेट किया जा सकता है. (Iaa513, b/174478034, b/74877608)
  • अगर कोई टाइप कन्वर्टर नहीं दिया गया है, तो Room अब डिफ़ॉल्ट रूप से Enum से String और String से Enum टाइप कन्वर्टर का इस्तेमाल करेगा. अगर किसी enum के लिए टाइप कन्वर्टर पहले से मौजूद है, तो Room डिफ़ॉल्ट कन्वर्टर के बजाय उसका इस्तेमाल करेगा. (b/73132006)

आम समस्या

  • अगर Enum को पढ़ने के लिए, पहले से ही वन-वे टाइप कन्वर्टर मौजूद है, तो हो सकता है कि Room गलती से पहले से मौजूद String से Enum कन्वर्टर का इस्तेमाल कर ले. ऐसा हो सकता है कि आपको इसकी ज़रूरत न हो. यह एक आम समस्या है. इसे ठीक करने के लिए, इसे टू-वे कन्वर्टर बनाया जा सकता है. देखें: b/175707691

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसकी वजह से Room, जेडीके के नए वर्शन में इंक्रीमेंटल एनोटेशन प्रोसेसिंग को गलत तरीके से बंद कर देता था. (b/171387388)
  • एक से ज़्यादा क्लास लोडर इस्तेमाल किए जाने पर, जनरेट की गई क्लास को ढूंढने में Room को होने वाली समस्या को ठीक किया गया. समस्या को ठीक करने के लिए, ‘Serendipity | 892449346@qq.com’ को धन्यवाद! (b/170141113)
  • हमने उस समस्या को ठीक कर दिया है जिसमें Room गलत कोड जनरेट करता था. ऐसा तब होता था, जब Kotlin @Dao में कोई ऐसी बेस क्लास होती थी जिसके जेनेरिक, JVM में प्रिमिटिव होते थे. (b/160258066)

बाहरी योगदान

  • अगर WAL मोड चालू है और एपीआई 16 या इससे ज़्यादा है, तो Room अब डिफ़ॉल्ट रूप से beginTransactionNonExclusive का इस्तेमाल करेगा. अहमद आई. Khalil | ahmedibrahimkhali@gmail.com’! (b/126258791)

वर्शन 2.3.0-alpha03

14 अक्टूबर, 2020

androidx.room:room-*:2.3.0-alpha03 रिलीज़ हो गया है. वर्शन 2.3.0-alpha03 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • Room में अब टाइप कन्वर्टर के इंस्टेंस उपलब्ध कराने के लिए एपीआई मौजूद हैं. इससे ऐप्लिकेशन, उनके शुरू होने की प्रोसेस को कंट्रोल कर सकता है. Room को दिए जाने वाले टाइप कन्वर्टर को मार्क करने के लिए, नए एनोटेशन @ProvidedTypeConverter का इस्तेमाल करें. ‘mzgreen yairobbe@gmail.com’ को धन्यवाद. (Ie4fa5, b/121067210)

  • Room में अब इनपुट स्ट्रीम से पढ़े गए पहले से पैकेज किए गए डेटाबेस का इस्तेमाल करके, डेटाबेस बनाने के लिए एपीआई मौजूद हैं. इससे ऐसे मामलों में मदद मिलती है, जब पहले से पैकेज किए गए डेटाबेस को gzip किया जाता है. ‘अहमद एल-हेल्व ahmedre@gmail.com’ (3e6792, b/146911060) को धन्यवाद

एपीआई में बदलाव

  • @ForeignKey एनोटेशन में वह टारगेट एट्रिब्यूट जोड़ा गया जो पहले मौजूद नहीं था. इससे, @Entity एनोटेशन के बाहर इसका इस्तेमाल नहीं किया जा सकेगा. (Iced1e)

  • RoomDatabase.java में मौजूद mCallbacks फ़ील्ड को अब छिपा दिया गया है. (d576cb, b/76109329)

गड़बड़ियां ठीक की गईं

  • TypeConverters के दस्तावेज़ को अपडेट किया गया है, ताकि यह साफ़ तौर पर बताया जा सके कि TypeConverters का इस्तेमाल सिर्फ़ कॉलम / फ़ील्ड को बदलने के लिए किया जा सकता है, न कि पंक्तियों को बदलने के लिए. (I07c56, b/77307836)

  • DaoProcessor को अपडेट किया गया, ताकि Kotlin "प्रिमिटिव" के साथ जेनरिक सुपर टाइप वाले Dao पर कंपाइलर की गड़बड़ी को ठीक किया जा सके. (Ice6bb, b/160258066)

  • ऑब्ज़र्वर को जोड़ने/हटाने के तरीकों से जुड़े दस्तावेज़ को अपडेट किया गया, ताकि थ्रेडिंग को साफ़ तौर पर समझाया जा सके (Ifd1d9, b/153948821)

  • Room में मौजूद उस समस्या को ठीक किया गया है जिसमें FTS टेबल की गलत तरीके से पुष्टि की जाती थी. ये ऐसी टेबल होती थीं जिनमें rowid कॉलम का एलान किया जाता था. (d62ebc, b/145858914)

बाहरी योगदान

  • टर्किश भाषा में अपरकेस/लोअरकेस से जुड़ी समस्याओं को ठीक किया गया (5746e3), b/68159494

  • Android Lollipop पर समस्याओं से बचने के लिए, RoomDatabase में मौजूद ConcurrentHashMap को Collections.synchronizedMap() से बदलें (d1cfc7, b/162431855)

  • पहले से पैकेज किए गए डेटाबेस को कॉपी करने के लिए, onOpenPrepackagedDatabase कॉलबैक जोड़ें. (I1ba74, b/148934423)

वर्शन 2.3.0-alpha02

22 जुलाई, 2020

androidx.room:room-*:2.3.0-alpha02 रिलीज़ हो गया है. वर्शन 2.3.0-alpha02 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • RxJava3 के साथ काम करना: Room अब RxJava3 के टाइप के साथ काम करता है. RxJava2 की तरह ही, डीएओ के ऐसे तरीके तय किए जा सकते हैं जिनका रिटर्न टाइप Flowable, Single, Maybe, और Completable हो. इसके अलावा, RxJava3 के साथ काम करने के लिए, एक नया आर्टफ़ैक्ट androidx.room:room-rxjava3 उपलब्ध है. (b/152427884)

एपीआई में बदलाव

  • Kotlin ऑब्जेक्ट क्लास में @TypeConverter को एलान करने की सुविधा अब उपलब्ध है. (b/151110764)
  • Room एनोटेशन प्रोसेसिंग का इंक्रीमेंटल विकल्प, अब डिफ़ॉल्ट रूप से चालू है. (b/112110217)

वर्शन 2.3.0-alpha01

10 जून, 2020

androidx.room:room-*:2.3.0-alpha01 रिलीज़ हो गया है. वर्शन 2.3.0-alpha01 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • Paging 3.0 के लिए सहायता: Room अब @Query एनोटेट किए गए उन तरीकों के लिए, लागू करने की सुविधा जनरेट कर सकता है जिनका रिटर्न टाइप androidx.paging.PagingSource है.

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

एपीआई में बदलाव

  • @RewriteQueriesToDropUnusedColumns एक नया एनोटेशन है. इसकी मदद से, Room किसी क्वेरी में '*' प्रोजेक्शन को फिर से लिखता है, ताकि नतीजे में इस्तेमाल न किए गए कॉलम हटा दिए जाएं.
  • प्रोसेसर का विकल्प room.expandProjection अब बंद कर दिया गया है. स्टार प्रोजेक्शन वाली रूम ऑप्टिमाइज़िंग क्वेरी के विकल्प के तौर पर, @RewriteQueriesToDropUnusedColumns का इस्तेमाल करें. ध्यान दें कि @RewriteQueriesToDropUnusedColumns, कॉलम से जुड़ी समस्या के समाधान room.expandProjection को नहीं बदलता है. यह समाधान, रिटर्न टाइप के लिए दिया गया है. इसमें @Embedded फ़ील्ड शामिल हैं.

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, इंक्रीमेंटल एनोटेशन प्रोसेसर को चालू करने के लिए इस्तेमाल किए गए जेडीके वर्शन का सही तरीके से पता नहीं लगा पाता था. ब्लेज़ सोलर (me@blaz.solar) को धन्यवाद (b/155215201)
  • Room अब अपनी ANTLR डिपेंडेंसी को व्याख्या प्रोसेसर के साथ एम्बेड करता है. इससे ANTLR का इस्तेमाल करने वाले अन्य प्रोसेसर के साथ वर्शन के टकराव से बचा जा सकता है. (b/150106190)

वर्शन 2.2.6

वर्शन 2.2.6

16 दिसंबर, 2020

androidx.room:room-*:2.2.6 रिलीज़ हो गया है. वर्शन 2.2.6 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • उस समस्या को ठीक किया गया है जिसकी वजह से Room, जेडीके के नए वर्शन में इंक्रीमेंटल एनोटेशन प्रोसेसिंग को गलत तरीके से बंद कर देता था. (b/171387388)

वर्शन 2.2.5

वर्शन 2.2.5

18 मार्च, 2020

androidx.room:room-*:2.2.5 रिलीज़ हो गया है. वर्शन 2.2.5 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • MultiInstanceInvalidationService को directBootAware बनाएं. ‘Mygod contact-git@mygod.be’ (b/148240967) को धन्यवाद
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, एक से ज़्यादा इंस्टेंस इनवैलिडेशन चालू होने और डेटाबेस में एफ़टीएस इकाई होने पर ऐप्लिकेशन क्रैश हो जाता था. (b/148969394)
  • हमने Room एनोटेशन प्रोसेसर में SQLite नेटिव लाइब्रेरी लोड करते समय आने वाली समस्या को ठीक कर दिया है. इस समस्या की वजह से, एक साथ कई कंपाइलेशन होने पर कंपाइलर क्रैश हो जाता था. (b/146217083)

वर्शन 2.2.4

वर्शन 2.2.4

19 फ़रवरी, 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, और androidx.room:room-testing:2.2.4 रिलीज़ किए गए हैं. वर्शन 2.2.4 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • लेन-देन को निलंबित करने से जुड़ी समस्या को ठीक किया गया है. इस समस्या की वजह से, लेन-देन शुरू होने से पहले ही कोरूटीन को रद्द करने पर, लेन-देन रुक जाते थे. (b/148181325)
  • JDK 9 के साथ बिल्ड करते समय, @Generated के गलत तरीके से इस्तेमाल होने की समस्या को ठीक किया गया. (b/146538330)
  • उस समस्या को ठीक किया गया है जिसमें Kotlin में डीएओ इंटरफ़ेस में कॉन्क्रीट फ़ंक्शन होने पर, Room गलत कोड जनरेट करता था. (b/146825845)

वर्शन 2.2.3

वर्शन 2.2.3

18 दिसंबर, 2019

androidx.room:room-*:2.2.3 रिलीज़ हो गया है. वर्शन 2.2.3 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, ऐसे डेटाबेस की पुष्टि नहीं कर पाता था जिसे माइग्रेट नहीं किया गया था और जिसके स्कीमा में इंडेक्स के साथ लेगसी हैश मौजूद था. (b/139306173)

वर्शन 2.2.2

वर्शन 2.2.2

20 नवंबर, 2019

androidx.room:room-*:2.2.2 रिलीज़ हो गया है. वर्शन 2.2.2 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, 999 से ज़्यादा लाइनों वाले वन-टू-वन रिलेशनशिप को इकट्ठा करने पर, Room से शून्य आइटम मिलते थे. (b/143105450)

वर्शन 2.2.1

वर्शन 2.2.1

23 अक्टूबर, 2019

androidx.room:room-*:2.2.1 रिलीज़ हो गया है. वर्शन 2.2.1 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, कंपाइलर विकल्प expandProjection चालू होने पर, Room गलत तरीके से CURSOR_MISMATCH के बारे में चेतावनी देता था. (b/140759491)
  • कंपाइल के समय क्वेरी की पुष्टि करने के लिए इस्तेमाल की जाने वाली नेटिव लाइब्रेरी मौजूद न होने पर, फिर से कोशिश करने का तरीका जोड़ा गया.

वर्शन 2.2.0

वर्शन 2.2.0

9 अक्टूबर, 2019

androidx.room:room-*:2.2.0 रिलीज़ हो गया है. वर्शन 2.2.0 में ये बदलाव शामिल हैं.

वर्शन 2.1.0 के बाद किए गए अहम बदलाव

  • पहले से पैकेज किया गया डेटाबेस: RoomDatabase.Builder में दो नए एपीआई अब उपलब्ध हैं. इनकी मदद से, पहले से भरी हुई डेटाबेस फ़ाइल के लिए RoomDatabase बनाया जा सकता है. createFromAsset() का इस्तेमाल तब किया जाता है, जब पहले से भरी हुई डेटाबेस फ़ाइल, APK के ऐसेट फ़ोल्डर में मौजूद हो. वहीं, createFromFile() का इस्तेमाल तब किया जाता है, जब फ़ाइल किसी भी जगह पर मौजूद हो. इन एपीआई के इस्तेमाल से, डिस्ट्रक्टिव माइग्रेशन का व्यवहार बदल जाता है. इससे फ़ॉलबैक माइग्रेशन के दौरान, Room पहले से मौजूद डेटाबेस को फिर से कॉपी करने की कोशिश करेगा. अगर डेटाबेस उपलब्ध नहीं है, तो वह सभी टेबल को हटाकर फिर से बनाएगा. b/62185732
  • स्कीमा की डिफ़ॉल्ट वैल्यू: @ColumnInfo में अब एक नई प्रॉपर्टी defaultValue है. इसका इस्तेमाल, किसी कॉलम की डिफ़ॉल्ट वैल्यू तय करने के लिए किया जा सकता है. डिफ़ॉल्ट वैल्यू, डेटाबेस स्कीमा का हिस्सा होती हैं. अगर इन्हें तय किया जाता है, तो माइग्रेशन के दौरान इनकी पुष्टि की जाएगी. b/64088772
  • मेनी-टू-मेनी रिलेशन: @Relation में अब एक नई प्रॉपर्टी associateBy है, जो एक नया एनोटेशन @Junction लेती है. इसका इस्तेमाल, ऐसे रिलेशन का एलान करने के लिए किया जाता है जिसे जंक्शन टेबल (इसे जॉइन टेबल भी कहा जाता है) के ज़रिए पूरा करना ज़रूरी है. b/69201917
  • वन-टू-वन रिलेशन: @Relation से एनोटेट किए गए POJO फ़ील्ड में, List या Set टाइप की पाबंदी हटा दी गई है. इससे सिंगल-वैल्यू रिलेशन को दिखाया जा सकता है. b/62905145
  • टारगेट एंटिटी: डीएओ एनोटेशन @Insert, @Update, और @Delete में अब एक नई प्रॉपर्टी targetEntity है. इसकी मदद से, उस टारगेट टेबल के बारे में बताया जा सकता है जिस पर डीएओ मेथड को काम करना है. इससे डीएओ के उन तरीकों के पैरामीटर, आर्बिट्रेरी पीओजेओ हो सकते हैं जिन्हें पार्शियल एंटिटी के तौर पर समझा जाएगा. प्रैक्टिकल तौर पर, इससे कुछ डेटा को शामिल किया जा सकता है, मिटाया जा सकता है, और अपडेट किया जा सकता है. b/127549506
  • Coroutines Flow: @Query डीएओ के तरीके अब Flow<T> रिटर्न टाइप के हो सकते हैं. अगर क्वेरी में मौजूद टेबल अमान्य हो जाती हैं, तो रिटर्न किया गया फ़्लो, वैल्यू का एक नया सेट फिर से जनरेट करेगा. Channel<T> रिटर्न टाइप के साथ डीएओ फ़ंक्शन का एलान करना एक गड़बड़ी है. इसके बजाय, Room आपको Flow का इस्तेमाल करने और फिर आस-पास के फ़ंक्शन का इस्तेमाल करके, Flow को Channel में बदलने का सुझाव देता है. b/130428884
  • Gradle Incremental Annotation Processor: Room अब Gradle आइसोलेटिंग एनोटेशन प्रोसेसर है. साथ ही, प्रोसेसर के विकल्प room.incremental की मदद से, इंक्रीमेंटेबिलिटी को चालू किया जा सकता है. ज़्यादा जानकारी के लिए, Room कंपाइलर के विकल्प देखें. अगर आपको कोई समस्या आती है, तो कृपया यहां गड़बड़ी की शिकायत करें. हम आने वाले समय में, स्टेबल वर्शन में इंक्रीमेंटैबिलिटी को डिफ़ॉल्ट रूप से चालू करने की योजना बना रहे हैं. b/112110217
  • प्रोजेक्शन को बड़ा करना: कंपाइलर का एक नया विकल्प room.expandProjection जोड़ा गया है. यह अभी एक्सपेरिमेंट के तौर पर उपलब्ध है. इसकी मदद से, Room किसी क्वेरी को स्टार प्रोजेक्शन के साथ फिर से लिखता है, ताकि रिटर्न टाइप POJO में सिर्फ़ कॉलम शामिल हों. उदाहरण के लिए, @Query("SELECT * FROM Song") वाले डीएओ तरीके के लिए, जो सिर्फ़ दो फ़ील्ड वाले SongIdAndTitle नाम के पीओजेओ को दिखाता है. इसके बाद, Room क्वेरी को SELECT id, title FROM Song में फिर से लिखेगा, ताकि रिटर्न टाइप के लिए ज़रूरी कॉलम का कम से कम सेट फ़ेच किया जा सके. इससे, CURSOR_MISMATCH चेतावनी नहीं दिखती. यह चेतावनी तब दिखती है, जब क्वेरी से ऐसे अतिरिक्त कॉलम मिलते हैं जो वापस मिलने वाले POJO टाइप के किसी भी फ़ील्ड से मैच नहीं करते.

वर्शन 2.2.0-rc01

5 सितंबर, 2019

androidx.room:room:2.2.0-rc01 रिलीज़ हो गया है. इस वर्शन में शामिल बदलाव यहां देखे जा सकते हैं.

Room 2.2.0-beta01 के बाद से, सार्वजनिक तौर पर कोई बदलाव नहीं किया गया है.

वर्शन 2.2.0-beta01

22 अगस्त, 2019

androidx.room:room-*:2.2.0-beta01 रिलीज़ हो गया है. इस वर्शन में शामिल बदलाव यहां देखे जा सकते हैं.

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Coroutine Flow क्वेरी, कुछ समय बाद नई वैल्यू को फिर से दिखाना बंद कर देती थी. (b/139175786)
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, लेगसी स्कीमा हैश कोड को स्वीकार नहीं करता था. ऐसा तब होता था, जब कोई ऐसा डेटाबेस खोला जाता था जिसे Room 1.0 के बाद से माइग्रेट नहीं किया गया था. इस वजह से, अमान्य स्कीमा की वजह से रनटाइम क्रैश हो जाता था. (b/139306173)

वर्शन 2.2.0-alpha02

7 अगस्त, 2019

androidx.room:room-*:2.2.0-alpha02 रिलीज़ हो गया है. इस वर्शन में शामिल बदलाव यहां देखे जा सकते हैं.

नई सुविधाएं

  • Coroutines Flow: @Query डीएओ के तरीके अब Flow<T> रिटर्न टाइप के हो सकते हैं. अगर क्वेरी में मौजूद टेबल अमान्य हो जाती हैं, तो रिटर्न किया गया फ़्लो, वैल्यू का एक नया सेट फिर से जनरेट करेगा. Channel<T> रिटर्न टाइप के साथ डीएओ फ़ंक्शन का एलान करना एक गड़बड़ी है. इसके बजाय, Room आपको Flow का इस्तेमाल करने और फिर आस-पास के फ़ंक्शन का इस्तेमाल करके, Flow को Channel में बदलने का सुझाव देता है. b/130428884
  • प्रोजेक्शन को बड़ा करना: कंपाइलर का एक नया विकल्प room.expandProjection जोड़ा गया है. यह अभी एक्सपेरिमेंट के तौर पर उपलब्ध है. इसकी मदद से, Room किसी क्वेरी को स्टार प्रोजेक्शन के साथ फिर से लिखता है, ताकि रिटर्न टाइप POJO में सिर्फ़ कॉलम शामिल हों. उदाहरण के लिए, @Query("SELECT * FROM Song") वाले डीएओ तरीके के लिए, जो सिर्फ़ दो फ़ील्ड वाले SongIdAndTitle नाम के पीओजेओ को दिखाता है. इसके बाद, Room क्वेरी को SELECT id, title FROM Song में फिर से लिखेगा, ताकि रिटर्न टाइप के लिए ज़रूरी कॉलम का कम से कम सेट फ़ेच किया जा सके. इससे, CURSOR_MISMATCH चेतावनी नहीं दिखती. यह चेतावनी तब दिखती है, जब क्वेरी से ऐसे अतिरिक्त कॉलम मिलते हैं जो वापस मिलने वाले POJO टाइप के किसी भी फ़ील्ड से मैच नहीं करते.
  • onDestructiveMigrate, RoomDatabase.Callback में जोड़ा गया एक नया कॉलबैक एपीआई है. इसका इस्तेमाल तब किया जाता है, जब Room किसी डेटाबेस को नुकसान पहुंचाकर माइग्रेट करता है. b/79962330

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसमें फ़ील्ड के सुरक्षित होने पर, Room फ़ील्ड सेटर के तौर पर किसी तरीके का इस्तेमाल करके गलत कोड जनरेट करता था. b/136194628
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, मल्टी-इंस्टेंस इनवैलिडेशन चालू होने और इनवैलिडेशन सेवा बंद होने पर, InvalidationTracker दूसरी प्रोसेस में एनपीई दिखाता था. b/137454915
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, @RawQuery के साथ एनोटेट किए गए इनहेरिट किए गए सस्पेंड फ़ंक्शन के रिटर्न टाइप की सही तरीके से पहचान नहीं कर पाता था. b/137878827
  • जब संबंधित कुंजी BLOB टाइप की हो, तब @Relation के लिए जनरेट किए गए कोड को अपडेट किया गया, ताकि तुलना की जा सकने वाली ByteBuffer का इस्तेमाल किया जा सके. b/137881998
  • उस गड़बड़ी को ठीक किया गया है जिसमें Room, @Insert, @Update, और @Delete के पार्शियल एंटिटी पैरामीटर के तौर पर इस्तेमाल किए गए POJO पर, सेटर मौजूद न होने की शिकायत करता था. b/138664463
  • उस गड़बड़ी को ठीक किया गया है जिसमें Room, @Entity की मदद से अनदेखा किए गए कॉलम के लिए, मौजूद नहीं होने वाले गेटर और सेटर के बारे में शिकायत करता था. ऐसा तब होता था, जब इकाई क्लास का इस्तेमाल कुछ डीएओ तरीकों में किया जाता था. b/138238182
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, नाम वाले बाइंडिंग आर्ग्युमेंट को पोज़िशनल आर्ग्युमेंट में सही तरीके से नहीं बदल पाता था. इस वजह से, फिर से इस्तेमाल किए गए पैरामीटर वाली क्वेरी को लागू करते समय, रनटाइम एक्सेप्शन की समस्या आती थी. b/137254857

वर्शन 2.2.0-alpha01

10 जुलाई, 2019

नई सुविधाएं

  • पहले से पैकेज किया गया डेटाबेस: RoomDatabase.Builder में दो नए एपीआई अब उपलब्ध हैं. इनकी मदद से, पहले से भरी हुई डेटाबेस फ़ाइल के लिए RoomDatabase बनाया जा सकता है. createFromAsset() का इस्तेमाल तब किया जाता है, जब पहले से भरी हुई डेटाबेस फ़ाइल, APK के ऐसेट फ़ोल्डर में मौजूद हो. वहीं, createFromFile() का इस्तेमाल तब किया जाता है, जब फ़ाइल किसी भी जगह पर मौजूद हो. इन एपीआई के इस्तेमाल से, डिस्ट्रक्टिव माइग्रेशन का व्यवहार बदल जाता है. इससे फ़ॉलबैक माइग्रेशन के दौरान, Room पहले से मौजूद डेटाबेस को फिर से कॉपी करने की कोशिश करेगा. अगर डेटाबेस उपलब्ध नहीं है, तो वह सभी टेबल को हटाकर फिर से बनाएगा. b/62185732
  • स्कीमा की डिफ़ॉल्ट वैल्यू: @ColumnInfo में अब एक नई प्रॉपर्टी defaultValue है. इसका इस्तेमाल, किसी कॉलम की डिफ़ॉल्ट वैल्यू तय करने के लिए किया जा सकता है. डिफ़ॉल्ट वैल्यू, डेटाबेस स्कीमा का हिस्सा होती हैं. अगर इन्हें तय किया जाता है, तो माइग्रेशन के दौरान इनकी पुष्टि की जाएगी. b/64088772

    ध्यान दें: अगर आपके डेटाबेस स्कीमा में पहले से ही डिफ़ॉल्ट वैल्यू मौजूद हैं, जैसे कि ALTER TABLE x ADD COLUMN y INTEGER NOTNULL DEFAULT z के ज़रिए जोड़ी गई वैल्यू, और आपको उन्हीं कॉलम में @ColumnInfo के ज़रिए डिफ़ॉल्ट वैल्यू तय करनी हैं, तो आपको उन डिफ़ॉल्ट वैल्यू की पुष्टि करने के लिए माइग्रेशन की ज़रूरत पड़ सकती है जिनका हिसाब नहीं लगाया गया है. ज़्यादा जानकारी के लिए, रूम माइग्रेशन देखें.

  • मेनी-टू-मेनी रिलेशन: @Relation में अब एक नई प्रॉपर्टी associateBy है, जो एक नया एनोटेशन @Junction लेती है. इसका इस्तेमाल, ऐसे रिलेशन का एलान करने के लिए किया जाता है जिसे जंक्शन टेबल (इसे जॉइन टेबल भी कहा जाता है) के ज़रिए पूरा करना ज़रूरी है. b/69201917
  • वन-टू-वन रिलेशन: @Relation से एनोटेट किए गए POJO फ़ील्ड में, List या Set टाइप की पाबंदी हटा दी गई है. इससे सिंगल-वैल्यू रिलेशन को दिखाया जा सकता है. b/62905145
  • टारगेट एंटिटी: डीएओ एनोटेशन @Insert, @Update, और @Delete में अब एक नई प्रॉपर्टी targetEntity है. इसकी मदद से, उस टारगेट टेबल के बारे में बताया जा सकता है जिस पर डीएओ मेथड को काम करना है. इससे डीएओ के उन तरीकों के पैरामीटर, आर्बिट्रेरी पीओजेओ हो सकते हैं जिन्हें पार्शियल एंटिटी के तौर पर समझा जाएगा. प्रैक्टिकल तौर पर, इससे कुछ डेटा को शामिल किया जा सकता है, मिटाया जा सकता है, और अपडेट किया जा सकता है. b/127549506
  • Gradle Incremental Annotation Processor: Room अब Gradle आइसोलेटिंग एनोटेशन प्रोसेसर है. साथ ही, प्रोसेसर के विकल्प room.incremental की मदद से, इंक्रीमेंटेबिलिटी को चालू किया जा सकता है. ज़्यादा जानकारी के लिए, Room कंपाइलर के विकल्प देखें. अगर आपको कोई समस्या आती है, तो कृपया यहां गड़बड़ी की शिकायत करें. हम आने वाले समय में, स्टेबल वर्शन में इंक्रीमेंटैबिलिटी को डिफ़ॉल्ट रूप से चालू करने की योजना बना रहे हैं. b/112110217

गड़बड़ियां ठीक की गईं

  • क्वेरी पूरी होने से पहले, क्वेरी की Rx स्ट्रीम को हटा दिए जाने पर, Room अब ग्लोबल एरर हैंडलर को EmptySetResultException नहीं भेजेगा. b/130257475
  • उस गड़बड़ी को ठीक किया गया है जिसमें Room, गड़बड़ी का गलत मैसेज दिखाता था. ऐसा तब होता था, जब @RawQuery के साथ एनोटेट किए गए सस्पेंड डीएओ फ़ंक्शन में कोई रिटर्न टाइप नहीं होता था. b/134303897
  • Room अब रॉ टाइप वाले डीएओ अडैप्टर जनरेट नहीं करेगा. b/135747255

वर्शन 2.1.0

वर्शन 2.1.0

13 जून, 2019

Room 2.1.0 को 2.1.0-rc01 के बाद से बिना किसी बदलाव के रिलीज़ किया गया है. इस वर्शन में शामिल बदलाव यहां देखे जा सकते हैं.

2.0.0 के बाद किए गए अहम बदलाव

  • FTS: Room अब FTS3 या FTS4 टेबल के साथ मैप की गई इकाइयों के साथ काम करता है. @Entity से एनोटेट की गई क्लास को अब @Fts3 या @Fts4 से भी एनोटेट किया जा सकता है. इससे, पूरे टेक्स्ट की खोज वाली टेबल को मैप करने वाली क्लास का एलान किया जा सकता है. एनोटेशन के तरीकों का इस्तेमाल करके, एफ़टीएस को अपनी ज़रूरत के मुताबिक और बेहतर तरीके से इस्तेमाल किया जा सकता है.
  • व्यू: Room में अब किसी क्लास को सेव की गई क्वेरी के तौर पर एलान किया जा सकता है. इसे व्यू भी कहा जाता है. इसके लिए, @DatabaseView एनोटेशन का इस्तेमाल किया जाता है.
  • Couroutines: डीएओ के तरीके अब सस्पेंड फ़ंक्शन हो सकते हैं. इस सुविधा का फ़ायदा पाने के लिए, अपनी डिपेंडेंसी में room-ktx को शामिल करें. ktx आर्टफ़ैक्ट, कोरूटीन में डेटाबेस ट्रांज़ैक्शन करने के लिए, एक्सटेंशन फ़ंक्शन RoomDatabase.withTransaction भी उपलब्ध कराता है.
  • Auto Value: Room अब AutoValue एनोटेट की गई क्लास को इकाइयों और पीओजेओ के तौर पर एलान करने की सुविधा देता है. Room एनोटेशन @PrimaryKey, @ColumnInfo, @Embedded, और @Relation को अब ऑटो वैल्यू एनोटेट की गई क्लास के ऐब्स्ट्रैक्ट तरीकों में एलान किया जा सकता है. ध्यान दें कि इन एनोटेशन के साथ @CopyAnnotations भी होना चाहिए, ताकि Room उन्हें ठीक से समझ सके.
  • अतिरिक्त एसिंक सहायता: @Insert, @Delete या @Update के साथ एनोटेट किए गए डीएओ तरीके, अब Rx रिटर्न टाइप Completable, Single, Maybe, और Guava के रिटर्न टाइप ListenableFuture के साथ काम करते हैं. साथ ही, @Query में INSERT, DELETE या UPDATE स्टेटमेंट शामिल होते हैं. इसके अलावा, ये फ़ंक्शन निलंबित भी किए जा सकते हैं.
  • enableMultiInstanceInvalidation, RoomDatabase.Builder में मौजूद एक नया एपीआई है. इसकी मदद से, एक ही डेटाबेस फ़ाइल का इस्तेमाल करके, RoomDatabase के कई इंस्टेंस में अमान्य करने की सुविधा चालू की जा सकती है.
  • fallbackToDestructiveMigrationOnDowngrade, RoomDatabase.Builder में मौजूद एक नया एपीआई है. इसकी मदद से, डाउनग्रेड होने पर डेटाबेस को अपने-आप फिर से बनाया जाता है.
  • ignoredColumns, @Entity एनोटेशन में मौजूद एक नया एपीआई है. इसका इस्तेमाल, अनदेखा किए गए फ़ील्ड को नाम के हिसाब से लिस्ट करने के लिए किया जा सकता है.
  • Room अब डेटा क्लास में Kotlin के प्राइमरी कंस्ट्रक्टर का सही तरीके से इस्तेमाल करेगा. इससे प्रॉपर्टी को vars के तौर पर एलान करने की ज़रूरत नहीं पड़ेगी.

वर्शन 2.1.0-rc01

29 मई, 2019

गड़बड़ियां ठीक की गईं

  • Room को शुरू करने से जुड़ी गड़बड़ी को ठीक किया गया. यह गड़बड़ी, temp_store कॉन्फ़िगरेशन के पहले से सेट अप होने की वजह से हो सकती है. b/132602198
  • SQLite 3.27.0 और इसके बाद के वर्शन का इस्तेमाल करने वाले उपयोगकर्ताओं के लिए, डबल कोट के इस्तेमाल से जुड़ी चेतावनी को ठीक किया गया. b/131712640
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, एक साथ कई अमान्य जांच होने पर, InvalidationTracker क्रैश हो जाता था. b/133457594

वर्शन 2.1.0-beta01

7 मई, 2019

androidx.room 2.1.0-beta01 को 2.1.0-alpha07 के बाद से बिना किसी बदलाव के रिलीज़ किया गया है. इस वर्शन में शामिल बदलाव यहां देखे जा सकते हैं.

वर्शन 2.1.0-alpha07

25 अप्रैल, 2019

एपीआई / काम करने के तरीके में बदलाव

  • एक्सटेंशन फ़ंक्शन RoomDatabase.withTransaction में बदलाव किया गया है, ताकि यह रिसीवर के तौर पर CoroutineScope वाले फ़ंक्शन ब्लॉक को अब न ले. इससे, लेन-देन ब्लॉक में चीज़ों को एक साथ चलाने के लिए ज़रूरी अतिरिक्त coroutineScope { } रैपर को स्किप करने से बचा जा सकता है.

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, Kotlin DAO फ़ंक्शन के लिए TypeConverter को मैच नहीं कर पाता था. इस फ़ंक्शन में कलेक्शन टाइप का पैरामीटर शामिल होता है. b/122066791

वर्शन 2.1.0-alpha06

22 मार्च, 2019

एपीआई / काम करने के तरीके में बदलाव

  • एसिंक्रोनस लेन-देन क्वेरी को अब इस तरह से क्रम में लगाया गया है कि Room, डेटाबेस लेन-देन को लागू करने के लिए एक से ज़्यादा थ्रेड का इस्तेमाल नहीं करेगा. लेन-देन के लिए इस्तेमाल किए जाने वाले एक्ज़ीक्यूटर को कॉन्फ़िगर करने की अनुमति देने के लिए, RoomDatabase.Builder.setTransactionExecutor(Executor) को जोड़ा गया.
  • RoomDatabase.runInTransaction(Callable) अब चेक किए गए अपवादों को RuntimeExceptions में रैप नहीं करेगा. b/128623748

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, कॉन्टेंट टेबल और बाहरी कॉन्टेंट एफ़टीएस टेबल, दोनों के लिए ऑब्ज़र्वर जोड़ने पर, इनवैलिडेशन ट्रैकर, कॉन्टेंट टेबल को मॉनिटर करना बंद कर देता था. b/128508917
  • SQLite 3.24.0 से मैच करने के लिए, Room SQLite ग्रामर को अपडेट किया गया. b/110883668

वर्शन 2.1.0-alpha05

13 मार्च, 2019

नई सुविधाएं

  • एक्सटेंशन फ़ंक्शन RoomDatabase.withTransaction की मदद से, कोरूटीन में डेटाबेस ट्रांज़ैक्शन सुरक्षित तरीके से किए जा सकते हैं. room-ktx आर्टफ़ैक्ट में, रूम एक्सटेंशन फ़ंक्शन के साथ-साथ कोरूटीन की सुविधा भी उपलब्ध है.
  • @Transaction के साथ एनोटेट किए गए नॉन-ऐब्स्ट्रैक्ट डीएओ मेथड, अब सस्पेंड फ़ंक्शन हो सकते हैं. b/120241587

एपीआई / काम करने के तरीके में बदलाव

  • आर्टफ़ैक्ट room-coroutines का नाम बदलकर room-ktx कर दिया गया है. यह नाम, अन्य androidx आर्टफ़ैक्ट के नाम रखने के तरीके के मुताबिक है.
  • RoomDatabase में beginTransaction, setTransactionSuccessful, और endTransaction को बंद कर दिया गया है. इनकी जगह, runInTransaction और room-ktx एक्सटेंशन फ़ंक्शन withTransaction का इस्तेमाल किया जा सकता है.

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, SIMPLE टोकनाइज़र का इस्तेमाल करने पर टोकनाइज़र आर्ग्युमेंट हटा दिए जाते थे. b/125427014
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, सस्पेंड करने वाले फ़ंक्शन की सही तरीके से पहचान नहीं कर पाता था. ऐसा उन पैरामीटर के साथ होता था जिनका टाइप इनर क्लास था. b/123767877
  • उस गड़बड़ी को ठीक किया गया है जिसमें INSERT, UPDATE या DELETE स्टेटमेंट वाले, बाद में लागू होने वाले @Query डीएओ तरीके, मुख्य थ्रेड में क्वेरी को तुरंत तैयार कर रहे थे. b/123695593
  • कई गड़बड़ियां ठीक की गईं. इनकी वजह से, Room कुछ सस्पेंड फ़ंक्शन के लिए गलत कोड जनरेट करता था. b/123466702 और b/123457323
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, जनरेट किए गए कोड में, इस्तेमाल से बाहर हो चुके तरीकों को सही तरीके से नहीं दबाया जा रहा था. b/117602586
  • androidx.sqlite की Room डिपेंडेंसी को 1.0.2 पर अपडेट किया गया है. इसमें खराब डेटाबेस को सही तरीके से मैनेज करने के लिए, गड़बड़ियां ठीक की गई हैं. b/124476912

पहले से मालूम समस्याएं

  • Room 2.1.0-alpha05, kotlinx-metadata-jvm आर्टफ़ैक्ट पर निर्भर करता है. फ़िलहाल, यह Maven Central (KT-27991) में उपलब्ध नहीं है. इस डिपेंडेंसी को हल करने के लिए, अपने प्रोजेक्ट डेटाबेस में maven { url "https://kotlin.bintray.com/kotlinx/" } जोड़ें.

वर्शन 2.1.0-alpha04

25 जनवरी, 2019

नई सुविधाएं

  • @Query के साथ एनोटेट किए गए डीएओ मेथड में अब INSERT, UPDATE या DELETE स्टेटमेंट शामिल हो सकते हैं. ये मेथड अब एसिंक्रोनस टाइप Single, Mayble, Completable, और ListenableFuture रिटर्न कर सकते हैं. इसके अलावा, ये suspend फ़ंक्शन भी हो सकते हैं. b/120227284

एपीआई / काम करने के तरीके में बदलाव

  • अगर @Transaction के साथ एनोटेट किया गया कोई नॉन-ऐब्स्ट्रैक्ट डीएओ तरीका, Single, Mayble, Completable, LiveData या ListenableFuture जैसा कोई एसिंक टाइप दिखाता है, तो Room अब गड़बड़ी दिखाएगा. ट्रांज़ैक्शन, थ्रेड तक सीमित होते हैं. इसलिए, फ़िलहाल Room के लिए किसी ऐसे फ़ंक्शन के आस-पास ट्रांज़ैक्शन शुरू और खत्म करना नामुमकिन है जो अलग-अलग थ्रेड में क्वेरी कर सकता है. b/120109336
  • OnConflictStrategy.FAIL और OnConflictStrategy.ROLLBACK को @Deprecated कर दिया गया है, क्योंकि वे Android के मौजूदा SQLite बाइंडिंग के साथ उम्मीद के मुताबिक काम नहीं करते. b/117266738

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, अगर डीएओ मेथड एक सस्पेंड फ़ंक्शन था, तो रूम, रिटर्न टाइप के TypeConverter का सही तरीके से इस्तेमाल नहीं कर पाता था. b/122988159
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, इनहेरिट किए गए सस्पेंड फ़ंक्शन को नॉन-सस्पेंडिंग के तौर पर गलत तरीके से पहचानता था. b/122902595
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, गलत कोड जनरेट करता था. ऐसा तब होता था, जब कोई @Embedded फ़ील्ड, पैरंट क्लास में मौजूद होता था और उसका इस्तेमाल कई चाइल्ड क्लास में किया जाता था. b/121099048
  • उस समस्या को ठीक किया गया है जिसमें beginTransaction() और endTransaction() के बीच डीएओ सस्पेंड फ़ंक्शन को शुरू करने पर, डेटाबेस डेडलॉक हो जाता था. b/120854786

वर्शन 2.1.0-alpha03

4 दिसंबर, 2018

एपीआई में बदलाव

  • @Fts3/@Fts4 में मौजूद एफ़टीएस tokenizer, अब Enum के बजाय स्ट्रिंग का इस्तेमाल करता है. इससे Room, कस्टम टोकनाइज़र का इस्तेमाल कर सकता है. पहले से मौजूद टोकनाइज़र, अब भी FtsOptions में स्ट्रिंग कॉन्सटैंट के तौर पर तय किए जाते हैं. b/119234881

नई सुविधाएं

  • Couroutines: डीएओ के तरीके अब सस्पेंड फ़ंक्शन हो सकते हैं. Room में सस्पेंड फ़ंक्शन के साथ काम करने के लिए, एक नया आर्टफ़ैक्ट room-coroutines रिलीज़ किया गया है. b/69474692
  • @Insert, @Delete या @Update के साथ एनोटेट किए गए डीएओ मेथड, अब रिटर्न टाइप के तौर पर ListenableFuture के साथ काम करते हैं. b/119418331

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, @Entity की ignoredColumns प्रॉपर्टी में कॉलम के साथ कंस्ट्रक्टर को गलत तरीके से ढूंढने की कोशिश करता था. b/119830714
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, जनरेट किए गए लागू करने के तरीके में डीएओ मेथड के पैरामीटर को फ़ाइनल के तौर पर मार्क नहीं करता था. b/118015483
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, खास सिंबल वाली क्वेरी पर गड़बड़ी की रिपोर्ट करने पर, Room प्रोसेसर क्रैश हो जाता था. b/119520136
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, IN एक्सप्रेशन के आर्ग्युमेंट के तौर पर, Collection के अन्य कई लागू किए गए तरीकों को अस्वीकार कर देता था. b/119884035
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, Room से मिले LiveData को हमेशा के लिए मॉनिटर करने पर, उसे गार्बेज कलेक्शन में डाल दिया जाता था. इससे नया डेटा मिलना बंद हो जाता था. b/74477406
  • लॉक के विवाद को कम करने के लिए, RoomDatabase के क्लोज़ लॉक को अपडेट किया गया. b/117900450

वर्शन 2.1.0-alpha02

30 अक्टूबर, 2018

नई सुविधाएं

  • @Relation में @DatabaseView का रेफ़रंस देने की सुविधा जोड़ी गई. b/117680932

गड़बड़ियां ठीक की गईं

  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Rx रिटर्न टाइप से सदस्यता लेने और उसे हटाने पर, Room मुख्य थ्रेड में डिस्क I/O को लागू करता था. b/117201279
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, Kotlin की इकाई क्लास में किसी फ़ील्ड के लिए सही टाइप कन्वर्टर नहीं ढूंढ पाता था. b/111404868
  • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, DAO इंटरफ़ेस को लागू करने के लिए गलत कोड जनरेट करता था. इसमें Kotlin का डिफ़ॉल्ट तरीका शामिल होता था, जिसमें कोई आर्ग्युमेंट नहीं होता था. b/117527454
  • Room SQLite ग्रामर पार्सर को अपडेट किया गया. इससे परफ़ॉर्मेंस से जुड़ी वह समस्या ठीक हो गई है जिसकी वजह से बिल्ड होने में ज़्यादा समय लगता था. b/117401230

वर्शन 2.1.0-alpha01

8 अक्टूबर, 2018

नई सुविधाएं

  • FTS: Room अब FTS3 या FTS4 टेबल के साथ मैप की गई इकाइयों के साथ काम करता है. @Entity के साथ एनोटेट की गई क्लास को अब @Fts3 या @Fts4 के साथ भी एनोटेट किया जा सकता है. इससे, पूरे टेक्स्ट की खोज वाली टेबल के साथ क्लास को मैप किया जा सकता है. एनोटेशन के तरीकों से, एफ़टीएस को पसंद के मुताबिक बनाने के ज़्यादा विकल्प उपलब्ध हैं. b/62356416
  • व्यू: रूम अब किसी क्लास को सेव की गई क्वेरी के तौर पर एलान करने की सुविधा देता है. इसे @DatabaseView एनोटेशन का इस्तेमाल करके व्यू भी कहा जाता है. b/67033276
  • Auto Value: Room अब AutoValue एनोटेट की गई क्लास को इकाइयों और पीओजेओ के तौर पर एलान करने की सुविधा देता है. Room एनोटेशन @PrimaryKey, @ColumnInfo, @Embedded, और @Relation को अब ऑटो वैल्यू एनोटेट की गई क्लास के ऐब्स्ट्रैक्ट तरीकों में एलान किया जा सकता है. ध्यान दें कि इन एनोटेशन के साथ @CopyAnnotations भी होना चाहिए, ताकि Room उन्हें ठीक से समझ सके. b/62408420
  • Rx रिटर्न टाइप के लिए अतिरिक्त सहायता: @Insert, @Delete या @Update के साथ एनोटेट किए गए डीएओ मेथड, अब Rx रिटर्न टाइप Completable, Single<T>, और Maybe<T> के साथ काम करते हैं. b/63317956
  • @Relation के साथ इम्यूटेबल टाइप: पहले Room में, @Relation एनोटेशन वाले फ़ील्ड को सेट करना ज़रूरी था. हालांकि, अब उन्हें कंस्ट्रक्टर पैरामीटर के तौर पर इस्तेमाल किया जा सकता है.
  • enableMultiInstanceInvalidation: यह RoomDatabase.Builder में मौजूद एक नया एपीआई है. इसकी मदद से, एक ही डेटाबेस फ़ाइल का इस्तेमाल करके, RoomDatabase के कई इंस्टेंस में अमान्य करने की सुविधा चालू की जा सकती है. यह मल्टी-इंस्टेंस इनवैलिडेशन मैकेनिज़्म, कई प्रोसेस में भी काम करता है. b/62334005
  • fallbackToDestructiveMigrationOnDowngrade: यह RoomDatabase.Builder में एक नया एपीआई है. इससे डाउनग्रेड होने पर, डेटाबेस अपने-आप फिर से बन जाता है. b/110416954
  • ignoredColumns: यह @Entity एनोटेशन में एक नया एपीआई है. इसका इस्तेमाल, अनदेखा किए गए फ़ील्ड को नाम के हिसाब से लिस्ट करने के लिए किया जा सकता है. किसी इकाई पर इनहेरिट किए गए फ़ील्ड को अनदेखा करने के लिए उपयोगी. b/63522075

एपीआई / काम करने के तरीके में बदलाव

  • RoomDatabase में mCallback और mDatabase को अब @Deprecated कर दिया गया है. इन्हें Room के अगले मेजर वर्शन से हटा दिया जाएगा. b/76109329

गड़बड़ियां ठीक की गईं

  • हमने दो समस्याओं को ठीक किया है. इनमें से एक समस्या यह थी कि Room, शुरू होने के दौरान खराब डेटाबेस या खराब माइग्रेशन से ठीक से डेटा वापस नहीं ला पाता था. b/111504749 और b/111519144
  • Room अब डेटा क्लास में Kotlin के प्राइमरी कंस्ट्रक्टर का सही तरीके से इस्तेमाल करेगा. इससे फ़ील्ड को vars के तौर पर एलान करने की ज़रूरत नहीं पड़ेगी. b/105769985

वर्शन 2.0.0

वर्शन 2.0.0

1 अक्टूबर, 2018

androidx.room 2.0.0 को 2.0.0-rc01 के बाद से बिना किसी बदलाव के रिलीज़ किया गया है.

वर्शन 2.0.0-rc01

20 सितंबर, 2018

androidx.room 2.0.0-rc01 को 2.0.0-beta01 के बाद से बिना किसी बदलाव के रिलीज़ किया गया है.

वर्शन 2.0.0-beta01

2 जुलाई, 2018

एपीआई / काम करने के तरीके में बदलाव

  • RoomDatabase.Builder.setQueryExecutor() को जोड़ा गया, ताकि यह तय किया जा सके कि क्वेरी कहां चलाई जाएं
  • RxJava2 Observable के लिए सहायता जोड़ी गई
  • जनरेट किए गए डीएओ और डेटाबेस के लागू होने की प्रोसेस अब पूरी हो गई है

गड़बड़ियां ठीक की गईं

  • "cannot find getter for field" गड़बड़ी में क्लास/फ़ील्ड का नाम बताएं b/73334503
  • Room के पुराने वर्शन के साथ RoomOpenHelper के पुराने सिस्टम के साथ काम करने की सुविधा को ठीक किया गया b/110197391

AndroidX से पहले की डिपेंडेंसी

AndroidX से पहले के Room के वर्शन के लिए, ये डिपेंडेंसी शामिल करें:

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

वर्शन 1.1.1

वर्शन 1.1.1

19 जून, 2018

1.1.1 कमरा, 1.1.1-rc1 कमरे जैसा ही है.

वर्शन 1.1.1-rc1

16 मई, 2018 अगर माइग्रेशन का इस्तेमाल किया जा रहा है, तो हमारा सुझाव है कि आप 1.1.0 के बजाय Room 1.1.1-rc1 का इस्तेमाल करें.

उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Room, माइग्रेशन के बाद शुरू होने की प्रोसेस को ठीक से मैनेज नहीं कर पाता था b/79362399

वर्शन 1.1.0

वर्शन 1.1.0-beta3

19 अप्रैल, 2018

गड़बड़ियां ठीक की गईं

  • जब Kotlin POJO, Java b/78199923 में तय की गई किसी रिलेशन इकाई का रेफ़रंस देता है, तो कंपाइलेशन की गड़बड़ी को ठीक किया गया

वर्शन 1.1.0-beta2

5 अप्रैल, 2018

गड़बड़ियां ठीक की गईं

  • Room Rx Single और Maybe को लागू करने में आने वाली एक गंभीर गड़बड़ी को ठीक किया गया है. इस गड़बड़ी की वजह से, क्वेरी को समय से पहले रीसाइकल कर दिया जाता था. इससे, वापस किए गए Single या Maybe इंस्टेंस में एक से ज़्यादा ऑब्ज़र्वर जोड़ने पर समस्याएं आती थीं. b/76031240

  • अगर [RoomDatabase.clearAllTables][ref-clearAllTables] को किसी लेन-देन के अंदर कॉल किया जाता है, तो यह डेटाबेस को VACUUM नहीं करेगा. b/77235565

वर्शन 1.1.0-beta1

21 मार्च, 2018

एपीआई में बदलाव

  • एपीआई की समीक्षा से मिले सुझाव के आधार पर, @RawQuery अब क्वेरी पैरामीटर के तौर पर String को स्वीकार नहीं करता. आपको [SupportSQLiteQuery][ref-SupportSQLiteQuery] का इस्तेमाल करना होगा. (आर्ग्युमेंट के साथ [SupportSQLiteQuery][ref-SupportSQLiteQuery] का इंस्टेंस आसानी से बनाने के लिए, [SimpleSQLiteQuery][ref-SimpleSQLiteQuery] देखें).
  • RoomDatabase.Builder का [fallbackToDestructiveMigrationFrom][ref-fallbackToDestructiveMigrationFrom] तरीका, अब vararg Integer के बजाय vararg int को स्वीकार करता है.

गड़बड़ियां ठीक की गईं

  • [RoomDatabase.clearAllTables][ref-clearAllTables] अब WAL चेकपॉइंट सेट करके और डेटाबेस को VACUUM करके, ऑपरेटिंग सिस्टम को स्टोरेज वापस करने की कोशिश करता है.
  • [@RawQuery][ref-RawQuery] अब observedEntities प्रॉपर्टी के लिए किसी भी Pojo को स्वीकार करता है. हालांकि, इसके लिए ज़रूरी है कि Pojo अपने Embedded फ़ील्ड या Relation के ज़रिए एक या उससे ज़्यादा इकाइयों को रेफ़र करे. b/74041772
  • पेजिंग: रूम का DataSource लागू करने की सुविधा, अब कई टेबल पर निर्भरता को सही तरीके से मैनेज करती है. जैसे, रिलेशन और जॉइन. पहले, इनसे नए नतीजे ट्रिगर नहीं होते थे या इन्हें कंपाइल नहीं किया जा सकता था. b/74128314

वर्शन 1.1.0-alpha1

22 जनवरी, 2018

नई सुविधाएं

  • RawQuery: इस नए एपीआई की मदद से, @Dao तरीके, एसक्यूएल को क्वेरी पैरामीटर के तौर पर पा सकते हैं b/62103290, b/71458963
  • fallBackToDestructiveMigrationsFrom: RoomDatabase.Builder में मौजूद इस नए एपीआई की मदद से, यह कंट्रोल किया जा सकता है कि स्कीमा के किन शुरुआती वर्शन से, डेटा को नुकसान पहुंचाने वाले माइग्रेशन की अनुमति दी जाए. यह fallbackToDestructiveMigration की तुलना में ज़्यादा बेहतर तरीके से काम करता है b/64989640
  • Room अब सिर्फ़ नए Paging API (alpha-4+) के साथ काम करता है. अब यह बंद हो चुके LivePagedListProvider के साथ काम नहीं करता. Room के नए ऐल्फ़ा वर्शन का इस्तेमाल करने के लिए, आपको पेजिंग alpha-4 या इसके बाद के वर्शन का इस्तेमाल करना होगा. साथ ही, अगर आपने अब तक LivePagedListProvider से LivePagedListBuilder पर स्विच नहीं किया है, तो आपको ऐसा करना होगा.

गड़बड़ियां ठीक की गईं

  • Kotlin Kapt टाइप के लिए बेहतर सहायता. b/69164099
  • फ़ील्ड के क्रम से अब स्कीमा अमान्य नहीं होता. b/64290754