कमरा
| नया अपडेट | स्टेबल वर्शन | रिलीज़ कैंडिडेट | बीटा रिलीज़ | ऐल्फ़ा रिलीज़ |
|---|---|---|---|---|
| 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 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
गड़बड़ियां ठीक की गईं
- उस रेस कंडिशन को ठीक करें जिसमें 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() रणनीति की जगह लेंगे. नई रणनीति इस तरह है:
RoomDatabaseConstructorको लागू करने वाला एक expect ऑब्जेक्ट तय करेंexpect object MyDatabaseCtor : RoomDatabaseConstructor<MyDatabase>@ConstructedByका इस्तेमाल करके, ऑब्जेक्ट को@Databaseएलान से लिंक करें@Database(...) @ConstructedBy(MyDatabaseCtor::class) // NEW abstract class MyDatabase : RoomDatabaseफ़ैक्ट्री आर्ग्युमेंट पास किए बिना, नया डेटाबेस इंस्टेंस बनाएं
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)linuxArm64Kotlin 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 से मैच करने के लिए,
RoomSQLite ग्रामर को अपडेट किया गया. 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 RoomSQLite ग्रामर पार्सर को अपडेट किया गया. इससे परफ़ॉर्मेंस से जुड़ी वह समस्या ठीक हो गई है जिसकी वजह से बिल्ड होने में ज़्यादा समय लगता था. 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/62334005fallbackToDestructiveMigrationOnDowngrade: यहRoomDatabase.Builderमें एक नया एपीआई है. इससे डाउनग्रेड होने पर, डेटाबेस अपने-आप फिर से बन जाता है. b/110416954ignoredColumns: यह@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
गड़बड़ियां ठीक की गईं
RoomRxSingleऔर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/71458963fallBackToDestructiveMigrationsFrom:RoomDatabase.Builderमें मौजूद इस नए एपीआई की मदद से, यह कंट्रोल किया जा सकता है कि स्कीमा के किन शुरुआती वर्शन से, डेटा को नुकसान पहुंचाने वाले माइग्रेशन की अनुमति दी जाए. यह fallbackToDestructiveMigration की तुलना में ज़्यादा बेहतर तरीके से काम करता है b/64989640- Room अब सिर्फ़ नए Paging API (alpha-4+) के साथ काम करता है. अब यह बंद हो चुके
LivePagedListProviderके साथ काम नहीं करता. Room के नए ऐल्फ़ा वर्शन का इस्तेमाल करने के लिए, आपको पेजिंगalpha-4या इसके बाद के वर्शन का इस्तेमाल करना होगा. साथ ही, अगर आपने अब तकLivePagedListProviderसेLivePagedListBuilderपर स्विच नहीं किया है, तो आपको ऐसा करना होगा.
गड़बड़ियां ठीक की गईं
- Kotlin Kapt टाइप के लिए बेहतर सहायता. b/69164099
- फ़ील्ड के क्रम से अब स्कीमा अमान्य नहीं होता. b/64290754