ห้อง
| อัปเดตล่าสุด | รุ่นที่เสถียร | รุ่นที่อาจได้รับการเผยแพร่ | รุ่นเบต้า | รุ่นอัลฟ่า |
|---|---|---|---|---|
| 9 กันยายน 2026 | 2.8.5 | - | - | - |
การประกาศทรัพยากร Dependency
หากต้องการเพิ่มทรัพยากร Dependency ใน Room คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google
ทรัพยากร Dependency สำหรับ Room ได้แก่การทดสอบการย้ายข้อมูล Room และ Room RxJava
เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ 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") }
Groovy
dependencies { def room_version = "2.8.5" implementation "androidx.room:room-runtime:$room_version" // If this project uses any Kotlin source, use Kotlin Symbol Processing (KSP) // See KSP Quickstart to add KSP to your build ksp "androidx.room:room-compiler:$room_version" // If this project only uses Java source, use the Java annotationProcessor // No additional plugins are necessary annotationProcessor "androidx.room:room-compiler:$room_version" // optional - RxJava2 support for Room implementation "androidx.room:room-rxjava2:$room_version" // optional - RxJava3 support for Room implementation "androidx.room:room-rxjava3:$room_version" // optional - Guava support for Room, including Optional and ListenableFuture implementation "androidx.room:room-guava:$room_version" // optional - Test helpers testImplementation "androidx.room:room-testing:$room_version" // optional - Paging 3 Integration implementation "androidx.room:room-paging:$room_version" }
ดูข้อมูลเกี่ยวกับการใช้ปลั๊กอิน KAPT ได้ที่เอกสารประกอบของ KAPT
ดูข้อมูลเกี่ยวกับการใช้ปลั๊กอิน KSP ได้ที่เอกสารประกอบการเริ่มต้นใช้งาน KSP ฉบับย่อ
ดูข้อมูลเกี่ยวกับการใช้ส่วนขยาย Kotlin ได้ที่เอกสารประกอบ ktx
ดูข้อมูลเพิ่มเติมเกี่ยวกับการขึ้นต่อกันได้ที่เพิ่มการขึ้นต่อกันของบิลด์
หรือสำหรับไลบรารีที่ไม่ใช่ Android (เช่น โมดูล Gradle ที่ใช้ Java หรือ Kotlin เท่านั้น) คุณสามารถใช้ androidx.room:room-common เพื่อใช้คำอธิบายประกอบ Room ได้
การกำหนดค่าตัวเลือกคอมไพเลอร์
Room มีตัวเลือกโปรเซสเซอร์สำหรับคำอธิบายประกอบต่อไปนี้
room.schemaLocation |
directory
เปิดใช้การส่งออกสคีมาฐานข้อมูลไปยังไฟล์ JSON ในไดเรกทอรีที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่การย้ายข้อมูลห้องแชท |
room.incremental |
boolean
เปิดใช้โปรเซสเซอร์สำหรับคำอธิบายประกอบแบบเพิ่มขึ้นของ Gradle ค่าเริ่มต้นคือ true
|
room.generateKotlin |
boolean
สร้างไฟล์ซอร์สโค้ด Kotlin แทน Java ต้องใช้ KSP ค่าเริ่มต้นคือ true ตั้งแต่เวอร์ชัน 2.7.0 เป็นต้นไป
ดูรายละเอียดเพิ่มเติมได้ที่บันทึกเวอร์ชัน 2.6.0 เมื่อมีการเปิดตัว
|
ใช้ปลั๊กอิน Room Gradle
เมื่อใช้ Room เวอร์ชัน 2.6.0 ขึ้นไป คุณจะใช้ปลั๊กอิน Room Gradle เพื่อกำหนดค่าตัวเลือกสำหรับคอมไพเลอร์ Room ได้ ปลั๊กอินจะกำหนดค่าโปรเจ็กต์เพื่อให้สคีมาที่สร้างขึ้น (ซึ่งเป็นเอาต์พุตของงานคอมไพล์และใช้สำหรับการย้ายข้อมูลอัตโนมัติ) ได้รับการกำหนดค่าอย่างถูกต้องเพื่อให้มีบิลด์ที่ทำซ้ำได้และแคชได้
หากต้องการเพิ่มปลั๊กอิน ให้กำหนดปลั๊กอินและเวอร์ชันในไฟล์ Gradle Build ระดับบนสุด
ดึงดูด
plugins { id 'androidx.room' version "$room_version" apply false }
Kotlin
plugins { id("androidx.room") version "$room_version" apply false }
ในไฟล์บิลด์ Gradle ระดับโมดูล ให้ใช้ปลั๊กอินและใช้ส่วนขยาย room
ดึงดูด
plugins { id 'androidx.room' } android { ... room { schemaDirectory "$projectDir/schemas" } }
Kotlin
plugins { id("androidx.room") } android { ... room { schemaDirectory("$projectDir/schemas") } }
ต้องตั้งค่า schemaDirectory เมื่อใช้ปลั๊กอิน Room Gradle การดำเนินการนี้จะกำหนดค่าคอมไพเลอร์ Room และงานคอมไพล์ต่างๆ รวมถึงแบ็กเอนด์ (javac, KAPT, KSP) เพื่อแสดงผลไฟล์สคีมาลงในโฟลเดอร์ที่กำหนด เช่น schemas/flavorOneDebug/com.package.MyDatabase/1.json คุณควรตรวจสอบไฟล์เหล่านี้ในที่เก็บเพื่อใช้สำหรับการตรวจสอบและการย้ายข้อมูลอัตโนมัติ
ตัวเลือกบางอย่างไม่สามารถกำหนดค่าได้ใน Room Gradle Plugin ทุกเวอร์ชัน แม้ว่าคอมไพเลอร์ Room จะรองรับก็ตาม ตารางด้านล่างแสดงรายการตัวเลือกแต่ละรายการและเวอร์ชันของ Room Gradle Plugin ที่เพิ่มการรองรับการกำหนดค่าตัวเลือกนั้นโดยใช้ส่วนขยาย room หากเวอร์ชันของคุณต่ำกว่า หรือหากยังไม่รองรับตัวเลือกนี้ คุณสามารถใช้ตัวเลือกโปรเซสเซอร์สำหรับคำอธิบายประกอบแทนได้
| ตัวเลือก | ตั้งแต่เวอร์ชัน |
|---|---|
room.schemaLocation (ต้องระบุ) |
2.6.0 |
room.incremental |
- |
room.generateKotlin |
- |
ใช้ตัวเลือกโปรเซสเซอร์สำหรับคำอธิบายประกอบ
หากไม่ได้ใช้ Room Gradle Plugin หรือเวอร์ชันของปลั๊กอินไม่รองรับตัวเลือกที่ต้องการ คุณสามารถกำหนดค่า Room โดยใช้ตัวเลือกโปรเซสเซอร์สำหรับคำอธิบายประกอบตามที่อธิบายไว้ในเพิ่มทรัพยากร Dependency ของบิลด์ วิธีระบุตัวเลือกคำอธิบายประกอบจะขึ้นอยู่กับว่าคุณใช้ KSP หรือ KAPT สำหรับ Room
ดึงดูด
// 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 ทราบเกี่ยวกับไดเรกทอรีนี้เมื่อทำการตรวจสอบข้อมูลล่าสุด
ย้ายข้อมูลฐานข้อมูล Room แสดงการติดตั้งใช้งาน CommandLineArgumentsProvider ที่สมบูรณ์ซึ่งระบุตำแหน่งสคีมา
ความคิดเห็น
ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากคุณพบปัญหาใหม่หรือมีแนวคิดในการปรับปรุงไลบรารีนี้ โปรดดูปัญหาที่มีอยู่ในคลังนี้ก่อนที่จะสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่ได้โดยคลิกปุ่มดาว
ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ Issue Tracker
เวอร์ชัน 2.8
เวอร์ชัน 2.8.5
9 กันยายน 2026
androidx.room:room-*:2.8.5 เผยแพร่แล้ว เวอร์ชัน 2.8.5 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้การดำเนินการระงับการค้นหาและการติดตามการทำให้เป็นโมฆะของ Room จะแสดง
IllegalStateExceptionเมื่อมีการเรียกใช้หลังจากปิดฐานข้อมูลแล้ว (Ic0166, b/543076356)
เวอร์ชัน 2.8.4
19 พฤศจิกายน 2025
androidx.room:room-*:2.8.4 เผยแพร่แล้ว เวอร์ชัน 2.8.4 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- เพิ่มแคชคำสั่งที่เตรียมไว้ลงในพูลการเชื่อมต่อของ Room เมื่อใช้
SQLiteDriverที่ไม่มีพูลภายใน เช่นBundledSQLiteDriverซึ่งจะช่วยปรับปรุงประสิทธิภาพในการดำเนินการซ้ำๆ ของคำสั่ง SQL เดียวกัน (5f43bc, b/319653917) - แก้ไขปัญหาที่ข้อความแสดงข้อผิดพลาดจริง/ที่คาดไว้ในการตรวจสอบสคีมาไม่มีข้อมูล (8b23da, b/454531083)
- แก้ไขปัญหาเกี่ยวกับการสร้างโค้ด Kotlin ของ Room ที่ไม่มีฟังก์ชัน DAO
@Transactionที่มีตัวแปรประเภท (a8365d, b/251316420) - ปรับปรุงประสิทธิภาพ Wrapper
SupportSQLiteของ Room โดยหลีกเลี่ยงการข้ามเทรดที่คงลักษณะการบล็อกแบบเดียวกับ APISupportSQLiteDatabase(fc70e4)
เวอร์ชัน 2.8.3
22 ตุลาคม 2025
androidx.room:room-*:2.8.3 เผยแพร่แล้ว เวอร์ชัน 2.8.3 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาด้านประสิทธิภาพเกี่ยวกับ Wrapper ของ Room SQLite ที่ทำให้เกิดการเรียก JNI มากเกินไปและประสิทธิภาพลดลงอย่างมากเมื่อทำซ้ำผ่านเคอร์เซอร์
เวอร์ชัน 2.8.2
8 ตุลาคม 2025
androidx.room:room-*:2.8.2 เผยแพร่แล้ว เวอร์ชัน 2.8.2 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาการติดตายที่อาจเกิดขึ้นเมื่อเปิดฐานข้อมูลที่ปิดอัตโนมัติอีกครั้งจากการปล่อย Flow (b/446643789)
เวอร์ชัน 2.8.1
24 กันยายน 2025
androidx.room:room-*:2.8.1 เผยแพร่แล้ว เวอร์ชัน 2.8.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องของโปรเซสเซอร์ที่เกิดขึ้นเมื่อประมวลผลฟังก์ชัน DAO ด้วยแลมบ์ดาที่ระงับ (b/442220723)
- แก้ไขภาวะแข่งขันที่ทำให้ Flows ไม่ได้รับการอัปเดตล่าสุด
เวอร์ชัน 2.8.0
10 กันยายน 2025
androidx.room:room-*:2.8.0 เผยแพร่แล้ว เวอร์ชัน 2.8.0 มี Commit เหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.7.0
- เพิ่มอาร์ติแฟกต์ใหม่
androidx.room:room-sqlite-wrapperซึ่งมี API เพื่อรับ WrapperSupportSQLiteDatabaseจากRoomDatabaseที่มีSQLiteDriverที่กำหนดค่าไว้ หากต้องการรับ Wrapper ให้ใช้ฟังก์ชันส่วนขยายใหม่RoomDatabase.getSupportWrapper()นี่คืออาร์ติแฟกต์ความเข้ากันได้เพื่อรักษาการใช้งานSupportSQLiteDatabaseซึ่งโดยปกติจะได้รับจากroomDatabase.openHelper.writableDatabaseแม้ว่าจะมีการกำหนดค่าฐานข้อมูล Room ด้วยSQLiteDriverก็ตาม Wrapper นี้มีประโยชน์สำหรับการย้ายข้อมูลฐานของโค้ดแบบเพิ่มทีละส่วนซึ่งต้องการใช้ SQLiteDriver API แต่มีการใช้งาน SupportSQLite API อย่างกว้างขวาง แต่ยังต้องการใช้ประโยชน์จากBundledSQLiteDriverดูข้อมูลเพิ่มเติมได้ในคำแนะนำในการย้ายข้อมูล - เพิ่มการรองรับ Watch OS และ Tv OS ของเป้าหมาย KMP
- อัปเดต minSDK ของ Android ของไลบรารีจาก API 21 เป็น API 23
เวอร์ชัน 2.8.0-rc02
27 สิงหาคม 2025
androidx.room:room-*:2.8.0-rc02 เผยแพร่แล้ว เวอร์ชัน 2.8.0-rc02 มี คอมมิตเหล่านี้
การเปลี่ยนแปลง API
- อัปเดต minSDK จาก API 21 เป็น API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)
- อัปเดตเวอร์ชันขั้นต่ำของปลั๊กอิน Android Gradle (AGP) ที่เข้ากันได้กับปลั๊กอิน Room 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 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
แก้ไขข้อบกพร่อง
- แก้ไขภาวะแข่งขันที่ 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ซึ่งมี API เพื่อรับ WrapperSupportSQLiteDatabaseของRoomDatabaseที่มีSQLiteDriverที่กำหนดค่าไว้ หากต้องการรับ Wrapper ให้ใช้ฟังก์ชันส่วนขยายใหม่RoomDatabase.getSupportWrapper()นี่คืออาร์ติแฟกต์ความเข้ากันได้เพื่อรักษาการใช้งานSupportSQLiteDatabaseซึ่งโดยปกติจะได้รับจากRoomDatabase.openHelper.writableDatabaseแม้ว่าจะมีการกำหนดค่าฐานข้อมูล Room ด้วยSQLiteDriverก็ตาม Wrapper นี้มีประโยชน์สำหรับการย้ายข้อมูลฐานของโค้ดแบบเพิ่มทีละส่วนซึ่งต้องการใช้SQLiteDriverแต่มีการใช้ API ของSupportSQLiteอย่างกว้างขวาง แต่ก็ต้องการใช้ประโยชน์จากBundledSQLiteDriverด้วย (Icf6ac) - เพิ่มเป้าหมาย KMP สำหรับ 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 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ระบบอ่านค่าคำอธิบายประกอบไม่ถูกต้องเมื่อประมวลผลแหล่งที่มาแบบเนทีฟด้วย KSP ซึ่งบางครั้งอาจทำให้การส่งออกสคีมาขาดหายไป (b/416549580)
- แก้ไขข้อบกพร่องที่ความคิดเห็นนำหน้าใน SQL ทำให้ระบบเรียกใช้คำสั่งเสมือนว่าเป็นคำค้นหาที่ไม่ได้อ่าน (b/413061402)
- แก้ไขปัญหาที่ปลั๊กอิน Gradle ของ Room กำหนดค่าไม่สำเร็จเนื่องจากไดเรกทอรีสคีมาว่างเปล่า (b/417823384)
- จะไม่แสดง
SQLiteExceptionอีกต่อไปเมื่อใช้เวลานานเกินไปในการเชื่อมต่อ แต่ไลบรารีจะส่งข้อความในบันทึกแทน การบันทึกแทนการส่งข้อมูลจะช่วยแก้ปัญหา iOS ที่ระงับ Looper ซึ่งทำให้ Room ตีความระยะหมดเวลาที่เกิดขึ้นใน Kotlin Coroutine ผิดพลาดเมื่อได้รับข้อมูลการเชื่อมต่อ และป้องกันไม่ให้มีการส่งข้อยกเว้นเมื่อแอป iOS ทำงานอยู่เบื้องหลังและกลับมาทำงานอีกครั้งในระหว่างการดำเนินการฐานข้อมูล (b/422448815)
เวอร์ชัน 2.7.1
23 เมษายน 2025
androidx.room:room-*:2.7.1 เผยแพร่แล้ว เวอร์ชัน 2.7.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่อง
IndexOutOfBoundsExceptionระหว่างการตรวจสอบความถูกต้องของตัวแปลงประเภทที่ระบุ (b/409804755) - รองรับ
RoomDatabase.runInTransaction()เมื่อกำหนดค่าSQLiteDriverด้วยห้อง (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, JVM (เดสก์ท็อป), Mac แบบเนทีฟ และ Linux แบบเนทีฟ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเริ่มต้นใช้งาน Room KMP ได้ที่เอกสารประกอบอย่างเป็นทางการของ Room KMP นอกจากนี้ คุณยังกำหนดค่า Room ด้วย
SQLiteDriverได้ด้วย โดยเป็นส่วนหนึ่งของการรองรับ KMP ดูข้อมูลเกี่ยวกับวิธีย้ายข้อมูลแอปที่มีอยู่ไปยัง Driver API และ Room KMP ได้ที่เอกสารประกอบเกี่ยวกับการย้ายข้อมูล - การสร้างโค้ด Kotlin ใน KSP จะเปิดอยู่โดยค่าเริ่มต้นหากการประมวลผลดำเนินการผ่าน KSP สำหรับโปรเจ็กต์ KAPT หรือ Java เท่านั้น Room จะยังคงสร้างแหล่งที่มาของ Java
- Kotlin 2.0 และ KSP2: ตอนนี้ Room กำหนดเป้าหมายเป็นภาษา Kotlin 2.0 และจะกำหนดให้โปรเจ็กต์ต้องคอมไพล์ด้วย Kotlin 2.0 และเวอร์ชันภาษาที่เทียบเท่าหรือสูงกว่าด้วย นอกจากนี้ยังเพิ่มการรองรับ KSP2 และขอแนะนำให้ใช้เมื่อใช้ Room กับ Kotlin 2.0 ขึ้นไป
เวอร์ชัน 2.7.0-rc03
26 มีนาคม 2025
androidx.room:room-*:2.7.0-rc03 เผยแพร่แล้ว เวอร์ชัน 2.7.0-rc03 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ไม่แสดง
InterruptedExceptionอีกต่อไปเมื่อชุดข้อความถูกขัดจังหวะระหว่างการดำเนินการ API การบล็อก Room รวมถึงฟังก์ชัน DAO การบล็อก (b/400584611) - ติดตั้งใช้งานพูลการเชื่อมต่อของ Room อีกครั้งเพื่อพยายามบรรเทาปัญหา
SQLException: Error code: 5, message: Timed out attempting to acquire a reader connection.และปัญหาที่คล้ายกัน (b/380088809)
เวอร์ชัน 2.7.0-rc02
12 มีนาคม 2025
androidx.room:room-*:2.7.0-rc02 เผยแพร่แล้ว เวอร์ชัน 2.7.0-rc02 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขการย้ายข้อมูลอัตโนมัติที่จัดการคอลัมน์ใหม่ในตาราง FTS ไม่ถูกต้อง (b/348227770, Ic53f3)
- แก้ไขข้อขัดข้องของ Room-compiler ที่เกิดจาก
NullPointerExceptionเมื่อประมวลผลแหล่งที่มาที่ไม่ใช่ JVM ผ่าน KSP (b/396607230, I693c9) - แก้ไขปัญหาที่ Room ไม่ทำให้ตารางไม่ถูกต้องเมื่อสิ้นสุดการใช้การเชื่อมต่อ Writer (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 ที่ทำให้โปรเซสเซอร์ KSP ขัดข้องเมื่อประมวลผลชุดซอร์สเนทีฟ (เช่น iOS) ใน Kotlin 2.1.x และ KSP1 (I883b8, b/396607230)
เวอร์ชัน 2.7.0-beta01
12 กุมภาพันธ์ 2025
androidx.room:room-*:2.7.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.7.0-beta01 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่
RoomDatabase.inTransaction()เปิดฐานข้อมูลที่ปิดอยู่เมื่อไม่ควรเปิด และควรแสดงผลเป็นเท็จอย่างรวดเร็วหากฐานข้อมูลปิดอยู่ (b/325432967) - แก้ไขข้อขัดข้อง (
IllegalArgumentException: not a valid name) ในคอมไพเลอร์ของ Room เมื่อประมวลผลฟังก์ชัน DAO ด้วยคลาสอินไลน์/ค่าของ Kotlin (b/388299754) - รวมกฎ Proguard ไว้ในอาร์ติแฟกต์ JVM ของ
room-runtimeเพื่อไม่ให้นำคอนสตรักเตอร์เริ่มต้นของการติดตั้งใช้งานฐานข้อมูลที่สร้างขึ้นออก เนื่องจาก Room ใช้การเริ่มต้นเริ่มต้นที่ใช้การสะท้อน (b/392657750)
เวอร์ชัน 2.7.0-alpha13
29 มกราคม 2025
androidx.room:room-*:2.7.0-alpha13 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha13 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้ Room กำหนดเป้าหมายเป็นภาษา Kotlin 2.0 และจะกำหนดให้โปรเจ็กต์ต้องคอมไพล์ด้วย Kotlin 2.0 และเวอร์ชันภาษาที่เทียบเท่าหรือสูงกว่าด้วย (I8efb0, b/315461431, b/384600605)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาในเครื่องมือสร้างฐานข้อมูล Room KMP เมื่อใช้ชื่อแบบง่ายแทนเส้นทางใน Android และเส้นทางที่แก้ไขแล้วของไฟล์ฐานข้อมูลจะไม่อยู่ในไดเรกทอรีข้อมูลของแอป (I83315, b/377830104)
- แก้ไขปัญหาเกี่ยวกับปลั๊กอิน Room Gradle ซึ่งการกำหนดค่าอินพุตและเอาต์พุตสคีมาทำให้เกิดปัญหาในโปรเจ็กต์ Android:
property 'inputDirectory' is final and cannot be changed any further.(1dbb4c, b/376071291) - เพิ่มการรองรับ KSP2 ในปลั๊กอิน Room Gradle เพื่อแก้ไขปัญหาที่ปลั๊กอินไม่ได้ตั้งค่าไดเรกทอรีสคีมาอย่างถูกต้อง (Iec3c4, b/379159770)
การมีส่วนร่วมจากภายนอก
- แก้ไขปัญหาเกี่ยวกับการผสานรวมการแบ่งหน้า
Roomที่ทำให้ UI ข้ามเมื่อคีย์เริ่มต้นในการรีเฟรชอยู่ใกล้กับส่วนท้ายของรายการมากเกินไป ขอขอบคุณ Eva (I2abbe, b/389729367)
เวอร์ชัน 2.7.0-alpha12
11 ธันวาคม 2024
androidx.room:room-*:2.7.0-alpha12 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha12 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่ม API เวอร์ชันทดลอง
RoomDatabase.Builder.setInMemoryTrackingMode()เพื่อกำหนดค่าว่า Room จะใช้ตารางในหน่วยความจำหรือไม่สำหรับการติดตามการทำให้เป็นโมฆะ (I2a9b2, b/185414040)
แก้ไขข้อบกพร่อง
- ตอนนี้การย้ายข้อมูลแบบทำลายจะยกเลิกมุมมองเพื่อให้แน่ใจว่ามีการสร้างมุมมองขึ้นมาใหม่ โดยปรับลักษณะการทำงานเมื่อ
allowDestructiveMigrationForAllTablesเปิดอยู่ (ค่าเริ่มต้นของ KMP) ให้สอดคล้องกับลักษณะการทำงานที่มีอยู่เมื่อปิดอยู่ (0a3e83, b/381518941)
เวอร์ชัน 2.7.0-alpha11
30 ตุลาคม 2024
androidx.room:room-*:2.7.0-alpha11 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha11 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- กลับไปที่ซิกเนเจอร์ของเมธอด
convertRows()ที่เพิ่มใหม่เพื่อให้เป็นฟังก์ชันระงับที่รับRawRoomQueryสำหรับการแบ่งหน้าของ Room (Ie57b5, b/369136627)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาในการแบ่งหน้าห้องแชทซึ่งมีการสร้างโค้ดที่ไม่ถูกต้องเมื่อใช้
@Relationร่วมกับPagingSource
เวอร์ชัน 2.7.0-alpha10
16 ตุลาคม 2024
androidx.room:room-*:2.7.0-alpha10 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha10 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- สร้างคลาส
ByteArrayWrapperภายในเพื่อรองรับความสัมพันธ์กับByteBufferในแพลตฟอร์มที่ไม่ใช่ Android และไม่ใช่ JVM (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 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับการติดตั้งใช้งาน KMP ของ
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ได้รับการย้ายข้อมูลเพื่อให้เข้ากันได้กับ KMP (Ib8756, b/339934824) - API
invalidationTrackerFlow()ได้รับการปรับให้เป็น API ของบุคคลที่หนึ่งในชื่อInvalidationTracker.createFlow()และตอนนี้พร้อมใช้งานสำหรับชุดซอร์สที่ไม่ใช่ Android ในโปรเจ็กต์ KMP แล้ว (I1fbfa, (I8fb29), b/329291639, b/329315924)
การเปลี่ยนแปลง API
- คำเตือนและข้อความแสดงข้อผิดพลาดทั้งหมดใน Room ที่ใช้คำว่า
Cursorได้ถูกนำออกหรือแทนที่แล้ว เนื่องจากCursorไม่ใช่คำทั่วไปที่ถูกต้องสำหรับใช้ใน Room เวอร์ชัน KMP อีกต่อไป (Id8cd9, b/334087492)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ Room KMP พยายามส่งโค้ดโดยใช้
UUIDสำหรับแพลตฟอร์มที่ไม่ใช่ JVM (b/362994709) - แก้ไขปัญหาเกี่ยวกับปลั๊กอิน Room Gradle ที่ทำให้เกิดข้อผิดพลาด เช่น "ไม่สามารถเปลี่ยนแอตทริบิวต์ของการกำหนดค่า … หลังจากล็อกเพื่อเปลี่ยนแปลงแล้ว" เมื่อใช้ในโปรเจ็กต์ KMP ที่มี 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นำไปใช้ได้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับ "actual" ที่สร้างขึ้นของ
RoomDatabaseConstructorซึ่งไม่มีตัวแก้ไข "actual" ในฟังก์ชันinitializeหากมีการลบล้างฟังก์ชันดังกล่าวในการประกาศ "expect" ด้วย (359631627) - แก้ไขปัญหาที่ "actual" ที่สร้างขึ้นของ
RoomDatabaseConstructorไม่ตรงกับระดับการเข้าถึงของการประกาศ "expect" (358138953)
เวอร์ชัน 2.7.0-alpha06
7 สิงหาคม 2024
androidx.room:room-*:2.7.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha06 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เปลี่ยนการตั้งค่าการสร้างอินสแตนซ์สำหรับ
RoomDatabaseในโปรเจ็กต์ KMP
เนื่องจากโมเดลการคอมไพล์ Kotlin 2.0 กลยุทธ์การอ้างอิงฟังก์ชันที่จะสร้างขึ้นซึ่งชื่อว่า instantiateImpl() จึงใช้ไม่ได้อีกต่อไป เราได้เปิดตัว API ใหม่ 2 รายการ ได้แก่ @ConstructedBy และ RoomDatabaseConstructor ซึ่งจะมาแทนที่กลยุทธ์ instantiateImpl() กลยุทธ์ใหม่มีดังนี้
กำหนดออบเจ็กต์ที่คาดหวังซึ่งใช้
RoomDatabaseConstructorexpect object MyDatabaseCtor : RoomDatabaseConstructor<MyDatabase>ลิงก์ออบเจ็กต์กับการประกาศ
@Databaseโดยใช้@ConstructedBy@Database(...) @ConstructedBy(MyDatabaseCtor::class) // NEW abstract class MyDatabase : RoomDatabaseสร้างอินสแตนซ์ฐานข้อมูลใหม่โดยไม่ส่งอาร์กิวเมนต์ Factory
fun createNewDatabase(path: String) = Room.databaseBuilder<AppDatabase>(name = path) .setDriver(BundledSQLiteDriver()) .setQueryCoroutineContext(Dispatchers.IO) .build()
แก้ไข b/316978491, b/338446862 และ b/342905180
- รองรับ
@RawQueryใน Room KMP โดยเพิ่ม API ใหม่ชื่อRoomRawQueryซึ่งคล้ายกับSupportSQLiteQueryในแง่ของการเก็บสตริง SQL ดิบและฟังก์ชันในการเชื่อมโยงอาร์กิวเมนต์เข้ากับคำสั่ง ตอนนี้ฟังก์ชันที่มีคำอธิบายประกอบ@RawQueryสามารถยอมรับRoomRawQueryเป็นพารามิเตอร์เดียวได้แล้ว (Iea844, b/330586815) - เพิ่มโอเวอร์โหลดของ
setQueryCallback()ที่ยอมรับCoroutineContext(Id66ff, b/309996304) - เพิ่มการรองรับเป้าหมาย Kotlin Multiplatform
linuxArm64รายการ (I139d3, b/338268719)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ Room สร้างการเรียกใช้
recursiveFetchArrayMapอย่างไม่ถูกต้องในเป้าหมายที่ไม่ใช่ Android (710c36, b/352482325) - แก้ไขปัญหาที่บางครั้ง Room แสดงข้อยกเว้นเกี่ยวกับ "หมดเวลาพยายามเชื่อมต่อ" ในโปรเจ็กต์ KMP (fa72d0, b/347737870)
- แก้ไขปัญหาในการย้ายข้อมูลอัตโนมัติที่จะตรวจสอบคีย์นอกเร็วเกินไปก่อนที่ตารางอื่นๆ จะเปลี่ยนสคีมาเพื่อให้สอดคล้องกับคีย์นอกใหม่ (7672c0, b/352085724)
เวอร์ชัน 2.7.0-alpha05
10 กรกฎาคม 2024
androidx.room:room-*:2.7.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha05 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เปลี่ยนชื่อ
SQLiteKtเป็นSQLiteและBundledSQLiteKtเป็นBundledSQLiteแล้ว (I8b501)
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่
RoomDatabaseจะเกิดข้อขัดข้องหรือข้อผิดพลาดเนื่องจากการหมดเวลาเชื่อมต่อเมื่อใช้AndroidSQLiteDriver
เวอร์ชัน 2.7.0-alpha04
12 มิถุนายน 2024
androidx.room:room-*:2.7.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha04 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่โปรเซสเซอร์สำหรับคำอธิบายประกอบของ Room จะสร้างโค้ด KMP ที่เข้ากันไม่ได้เมื่อมีการกำหนดประเภทการแสดงผลแบบ Multi-Map ใน DAO (b/340983093)
- แก้ไขปัญหาที่ Room ไม่พบการใช้งานฐานข้อมูลที่สร้างขึ้นหากคลาสที่มีคำอธิบายประกอบ
@Databaseไม่มีแพ็กเกจ (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 โปรดทราบว่า Kotlin 2.0 ที่รองรับ KSP 2 ยังไม่สมบูรณ์ และทีมกำลังทำงานกับ API ต่างๆ และการเปลี่ยนแปลงลักษณะการทำงานในคอมไพเลอร์ใหม่ (b/314151707)
เวอร์ชัน 2.7.0-alpha02
14 พฤษภาคม 2024
androidx.room:room-*:2.7.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha02 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหา KSP ต่างๆ
เวอร์ชัน 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, JVM (เดสก์ท็อป), Mac แบบเนทีฟ และ Linux แบบเนทีฟ ฟังก์ชันการทำงานที่ขาดหายไปในแพลตฟอร์มที่รองรับใหม่จะได้รับการอัปเดตให้ "มีฟีเจอร์ครบถ้วน" ใน Room เวอร์ชันต่อๆ ไป
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเริ่มต้นใช้งาน Room KMP ได้ที่เอกสารประกอบอย่างเป็นทางการของ Room KMP
- การสร้างโค้ด Kotlin ใน KSP จะเปิดอยู่โดยค่าเริ่มต้นหากการประมวลผลดำเนินการผ่าน KSP สำหรับโปรเจ็กต์ KAPT หรือ Java เท่านั้น Room จะยังคงสร้างแหล่งที่มาของ Java
การเปลี่ยนแปลง API
- มีการเพิ่มโอเวอร์โหลดของ
Room.databaseBuilder()ซึ่งใช้พารามิเตอร์ Lambda ที่มีไว้เพื่อใช้กับฟังก์ชันที่ Room สร้างขึ้นเพื่อหลีกเลี่ยงการใช้การสะท้อนเมื่อสร้างอินสแตนซ์การติดตั้งใช้งานRoomDatabaseที่สร้างขึ้น ตัวอย่างการใช้งานมีดังนี้
Room.databaseBuilder<MyDatabase>(
context = appContext,
name = dbFilePath,
factory = { MyDatabase::class.instantiateImpl() }
)
- เพิ่ม API สำหรับกำหนดค่าห้องด้วย
CoroutineContextลงในเครื่องมือสร้างแล้ว:RoomDatabase.Builder.setQueryCoroutineContextโปรดทราบว่าRoomDatabaseสามารถกำหนดค่าได้เฉพาะกับ Executor ที่ใช้setQueryExecutorหรือกับบริบท Coroutine เท่านั้น แต่จะใช้ทั้ง 2 อย่างไม่ได้ - เพิ่ม API สำหรับกำหนดค่าห้องด้วยไดรเวอร์
SQLiteแล้ว:RoomDatabase.Builder.setDriver()ดูข้อมูลเพิ่มเติมเกี่ยวกับSQLiteDriver API ได้ที่เอกสารประกอบ SQLite KMP - เพิ่ม API สำหรับเข้าถึง
SQLiteConnectionที่สำคัญจาก API ไดรเวอร์แล้ว:RoomDatabase.useReaderConnectionและRoomDatabase.useWriterConnection - ตอนนี้ Callback ที่เกี่ยวข้องกับห้องต่างๆ มีเวอร์ชันที่โอเวอร์โหลดซึ่งรับ
SQLiteConnectionแทนSupportSQLiteDatabaseซึ่งมีไว้เพื่อลบล้างเมื่อย้ายข้อมูลไปยังโปรเจ็กต์ KMP ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลการใช้งาน Room ในแอป Android ไปยังโมดูล KMP ทั่วไปได้ที่คำแนะนำในการย้ายข้อมูล โดย Callback มีดังนี้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พร้อมกับ API ทั้งหมดแล้ว ตอนนี้อาร์ติแฟกต์จึงว่างเปล่า โปรดนำไลบรารีดังกล่าวออกจากรายการทรัพยากร Dependency
เวอร์ชัน 2.6
เวอร์ชัน 2.6.1
29 พฤศจิกายน 2023
androidx.room:room-*:2.6.1 เผยแพร่แล้ว เวอร์ชัน 2.6.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาในโค้ดที่สร้างขึ้นซึ่งมีการตั้งค่าเริ่มต้นสำหรับคอลัมน์ Double ใน
EntityCursorConverterเป็น 0 แทนที่จะเป็น 0.0 นอกจากนี้ เรายังได้รวมการแก้ไขที่เป็นไปได้สำหรับกรณีที่คล้ายกันซึ่งเกิดขึ้นไม่บ่อยนักสำหรับคอลัมน์ประเภท Float ด้วย (Id75f5, b/304584179) - ตอนนี้ข้อยกเว้นที่เกิดจากการโหลด
PagingSourceจะได้รับการเผยแพร่เป็นLoadStateUpdateของLoadResult.Errorที่มี 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) หากต้องการเปิด Kotlin CodeGen ใน Room ให้เพิ่มชื่อตัวเลือก
room.generateKotlinลงในตัวเลือกโปรเซสเซอร์สำหรับ KSP ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีส่งตัวเลือกโปรเซสเซอร์สำหรับ KSP ได้ที่เอกสารประกอบ KSP
หมายเหตุ: เมื่อใช้ Kotlin CodeGen โปรดทราบว่ามีข้อจำกัดเพิ่มเติมที่เพิ่มเข้ามา ไม่อนุญาตให้ใช้พร็อพเพอร์ตี้ Abstract เป็น DAO Getter หรือการค้นหา DAO ใน Kotlin CodeGen และคาดว่าจะเขียนใหม่เป็นฟังก์ชันแทนเพื่อหลีกเลี่ยงแนวคิดที่ผิดพลาดว่าค่าพร็อพเพอร์ตี้เปลี่ยนแปลงไม่ได้และมีผลลัพธ์ที่จัดเก็บไว้คงที่ ข้อจำกัดอีกอย่างหนึ่งที่เพิ่มเข้ามาคือไม่อนุญาตให้ใช้ประเภทการแสดงผลคอลเล็กชันที่อนุญาตค่า Null ใน Room สำหรับ Kotlin CodeGen อีกต่อไป
คำเตือน: คุณอาจพบว่าโปรเจ็กต์มีความเข้มงวดมากขึ้นในแง่ของความสามารถในการเว้นว่างเมื่อใช้ Kotlin CodeGen ใน Kotlin CodeGen ความสามารถในการเว้นว่างของอาร์กิวเมนต์ประเภทเป็นสิ่งสำคัญ แต่ใน Java มักจะละเว้นส่วนนี้ ตัวอย่างเช่น สมมติว่าคุณมีประเภทการแสดงผล `Flow<foo\>` และตารางว่างเปล่า ใน Java CodeGen การดำเนินการนี้จะไม่ทำให้เกิดปัญหาใดๆ แต่ใน Kotlin CodeGen คุณจะได้รับข้อผิดพลาด เพื่อหลีกเลี่ยงปัญหานี้ คุณจะต้องใช้ `Flow<foo?\>` โดยสมมติว่ามีการปล่อยค่า Null </foo?\></foo\>
- อาร์ติแฟกต์ใหม่สำหรับปลั๊กอิน Room Gradle ได้รับการเพิ่มลงใน Room ด้วยรหัส
androidx.roomซึ่งช่วยแก้ปัญหาต่างๆ ที่มีอยู่ใน Room เกี่ยวกับการมีอินพุตและเอาต์พุตของสคีมาผ่านตัวเลือกโปรเซสเซอร์สำหรับคำอธิบายประกอบ Gradle ดูรายละเอียดเพิ่มเติมได้ที่บันทึกประจำรุ่นของ Room เวอร์ชัน 2.6.0-alpha02 - ตอนนี้ KSP รองรับคลาสค่าในเอนทิตี Room แล้ว (4194095)
- ตอนนี้ Room รองรับประเภทการแสดงผล Map ที่ซ้อนกันในฟังก์ชัน DAO แล้ว (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 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
การเปลี่ยนแปลง API
- ระบบได้สร้างคำอธิบายประกอบประเภทใหม่ที่ชื่อว่า
@MapColumnเพื่อแทนที่@MapInfoซึ่งเลิกใช้งานแล้ว สำหรับชื่อคอลัมน์แต่ละชื่อ (keyColumnName,valueColumnNameหรือทั้ง 2 อย่าง) ที่ระบุไว้ในคำอธิบายประกอบ@MapInfoคุณจะต้องประกาศคำอธิบายประกอบ@MapColumnโดยใช้เพียงcolumnNameและใช้คำอธิบายประกอบกับอาร์กิวเมนต์ประเภทที่เฉพาะเจาะจงซึ่งมีการอ้างอิง (คีย์หรือค่าของ Map) ในประเภทการแสดงผลของฟังก์ชัน DAO เนื่องจากมีการใช้คำอธิบายประกอบ@MapColumnโดยตรงกับอาร์กิวเมนต์ประเภทภายในประเภทการแสดงผลของฟังก์ชัน DAO แทนที่จะใช้กับตัวฟังก์ชันเองเหมือน@MapInfoโปรดดูข้อมูลเพิ่มเติมในเอกสารประกอบของ@MapColumn(Ib0305, b/203008711) - อัปเดตไฟล์ API เพื่อใส่คำอธิบายประกอบการระงับความเข้ากันได้ (I8e87a, b/287516207)
- API ของปลั๊กอิน Room Gradle ได้รับการอัปเดตให้ไม่จำเป็นต้องมีการกำหนดค่าต่อตัวแปรเสมอไป ซึ่งหมายความว่าปลั๊กอินสามารถยอมรับตำแหน่งส่วนกลางสำหรับตัวแปรทั้งหมดได้โดยไม่ต้องสร้างไดเรกทอรีหลายรายการ ซึ่งช่วยให้การย้ายข้อมูลราบรื่นขึ้น แต่ก็ยังยืดหยุ่นพอที่จะกำหนดค่า Flavor หรือสคีมาประเภทบิลด์ด้วยตนเองได้ ขณะเดียวกันก็ยังคงได้รับประโยชน์จากปลั๊กอิน (บิลด์ที่ทำซ้ำได้และแคชได้) (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 จะกำหนดค่าโปรเจ็กต์เพื่อให้สคีมาที่สร้างขึ้นซึ่งใช้สำหรับการย้ายข้อมูลอัตโนมัติและเป็นเอาต์พุตของงานคอมไพล์ได้รับการกำหนดค่าอย่างถูกต้องเพื่อให้มีบิลด์ที่ทำซ้ำได้และแคชได้ ปลั๊กอินมี DSL สำหรับกำหนดค่าตำแหน่งสคีมาพื้นฐาน ดังนี้
room {
schemaDirectory("$projectDir/schemas/")
}
จากนั้นปลั๊กอินจะกำหนดค่าคอมไพเลอร์ Room และงานคอมไพล์ต่างๆ รวมถึงแบ็กเอนด์ (javac, KAPT, KSP) เพื่อแสดงผลไฟล์สคีมาลงในโฟลเดอร์ที่แยกตามเวอร์ชัน เช่น schemas/flavorOneDebug/com.package.MyDatabase/1.json ตามปกติแล้ว ไฟล์เหล่านี้จะได้รับการตรวจสอบในที่เก็บเพื่อใช้สำหรับการตรวจสอบและการย้ายข้อมูลอัตโนมัติ เมื่อย้ายข้อมูลไปใช้ปลั๊กอินแทนตัวเลือกโปรเซสเซอร์สำหรับคำอธิบายประกอบ คุณต้องคัดลอกไฟล์สคีมาที่มีอยู่ไปยังไดเรกทอรี Flavor ที่สร้างขึ้นโดยปลั๊กอิน ซึ่งเป็นการดำเนินการย้ายข้อมูลแบบครั้งเดียวที่คุณต้องทำด้วยตนเอง เอกสารประกอบสคีมาใน developers.android.com จะได้รับการอัปเดตในอนาคตเมื่อมีการแก้ไขความคิดเห็นและปลั๊กอินมีความเสถียรแล้ว ดังนั้นโปรดลองใช้
การเปลี่ยนแปลง API
RoomDatabase.QueryCallbackได้รับการกำหนดให้เป็นอินเทอร์เฟซแบบฟังก์ชันเพื่ออนุญาตการใช้งานการแปลง SAM (Iab8ea, b/281008549)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่เกิดขึ้นเมื่อสร้างอินสแตนซ์ฐานข้อมูลใน Robolectric หลังจากย้ายข้อมูลแหล่งที่มาของ Room จาก Java ไปยัง Kotlin (Ic053c, b/274924903)
เวอร์ชัน 2.6.0-alpha01
22 มีนาคม 2023
androidx.room:room-*:2.6.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- รองรับคลาสค่าใน Room สำหรับ KSP ตอนนี้ Room รองรับคลาสค่าในเอนทิตีแล้ว (4194095)
- ตอนนี้คุณสามารถเปิดใช้การสร้างโค้ด Kotlin (หรือ "Kotlin CodeGen") ใน Room (4297ec0) ได้แล้ว หากต้องการเปิด Kotlin CodeGen ใน Room ให้เพิ่มชื่อตัวเลือก
room.generateKotlinลงในตัวเลือกโปรเซสเซอร์สำหรับ KSP ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีส่งตัวเลือกโปรเซสเซอร์สำหรับ KSP ได้ที่เอกสารประกอบของ KSP
หมายเหตุ: เมื่อใช้ Kotlin CodeGen โปรดทราบว่ามีข้อจำกัดเพิ่มเติมที่เพิ่มเข้ามา ไม่อนุญาตให้ใช้พร็อพเพอร์ตี้ Abstract เป็น DAO Getter หรือการค้นหา DAO ใน Kotlin CodeGen และคาดว่าจะเขียนใหม่เป็นฟังก์ชันแทนเพื่อหลีกเลี่ยงแนวคิดที่ผิดพลาดว่าค่าพร็อพเพอร์ตี้เปลี่ยนแปลงไม่ได้และมีผลลัพธ์ที่จัดเก็บไว้คงที่ ข้อจำกัดอีกอย่างหนึ่งที่เพิ่มเข้ามาคือไม่อนุญาตให้ใช้ประเภทการแสดงผลคอลเล็กชันที่อนุญาตค่า Null ใน Room สำหรับ Kotlin CodeGen อีกต่อไป
คำเตือน: คุณอาจพบว่าโปรเจ็กต์มีความเข้มงวดมากขึ้นในแง่ของความสามารถในการเว้นว่างเมื่อใช้ Kotlin CodeGen ใน Kotlin CodeGen ความสามารถในการเว้นว่างของอาร์กิวเมนต์ประเภทเป็นสิ่งสำคัญ แต่ใน Java มักจะละเว้นส่วนนี้ ตัวอย่างเช่น สมมติว่าคุณมีประเภทการแสดงผล `Flow<foo\>` และตารางว่างเปล่า ใน Java CodeGen การดำเนินการนี้จะไม่ทำให้เกิดปัญหาใดๆ แต่ใน Kotlin CodeGen คุณจะได้รับข้อผิดพลาด เพื่อหลีกเลี่ยงปัญหานี้ คุณจะต้องใช้ `Flow<foo?\>` โดยสมมติว่ามีการปล่อยค่า Null </foo?\></foo\>
การเปลี่ยนแปลง API
- ป้องกันการใช้คอลเล็กชันที่อนุญาตค่า Null อย่างไม่มีความหมายในประเภทการแสดงผลของเมธอด DAO (I777dc, b/253271782, b/259426907)
- เพิ่ม API สำหรับสร้าง Flow ที่ส่งการเปลี่ยนแปลงเครื่องมือติดตามการทำให้เป็นโมฆะ API นี้มีประโยชน์สำหรับการสร้างสตรีมที่ต้องตอบสนองต่อการเปลี่ยนแปลงฐานข้อมูล (I8c790, b/252899305)
แก้ไขข้อบกพร่อง
- ไม่อนุญาตพร็อพเพอร์ตี้ Abstract เป็น DAO Getter หรือการค้นหา DAO ใน Kotlin Codegen แต่ควรเขียนใหม่เป็นฟังก์ชันเพื่อหลีกเลี่ยงแนวคิดที่ผิดพลาดว่าค่าพร็อพเพอร์ตี้เปลี่ยนแปลงไม่ได้และมีผลลัพธ์ที่จัดเก็บไว้คงที่ (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)
- แก้ไขปัญหาที่ทำให้ Room แสดงข้อผิดพลาดเมื่อใช้ในการทดสอบ Robolectric (f79bea, b/274924903)
เวอร์ชัน 2.5.1
เวอร์ชัน 2.5.1
22 มีนาคม 2023
androidx.room:room-*:2.5.1 เผยแพร่แล้ว เวอร์ชัน 2.5.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- หลีกเลี่ยงการตรวจสอบไดเรกทอรีระดับบนของฐานข้อมูลใน
FrameworkSQLiteHelperหากฐานข้อมูลเปิดอยู่แล้ว (5de86b8) - ใช้การตรวจสอบ
isOpenInternalเมื่อตรวจสอบว่าฐานข้อมูลเปิดอยู่แล้วหรือไม่ (e91fb35) - ตอนนี้เราได้ปรับปรุงการจัดการเคสที่เกิดซ้ำใน
acquireTransactionThread()ของRoomแล้ว (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ตอนนี้คุณจะต้องประกาศonInvalidate()ในObserverเพื่อให้มีพารามิเตอร์ประเภทSetไม่ใช่MutableSetนอกจากนี้ เมธอด Getter บางเมธอดได้รับการแปลงเป็นพร็อพเพอร์ตี้ที่ต้องใช้ไวยากรณ์การเข้าถึงพร็อพเพอร์ตี้ในไฟล์ Kotlin โปรดรายงานข้อบกพร่องหากมีความไม่เข้ากันที่สำคัญ - เพิ่มคำอธิบายประกอบทางลัดใหม่
@Upsertซึ่งจะพยายามแทรกเอนทิตีเมื่อไม่มีความขัดแย้งด้านความไม่ซ้ำกัน หรืออัปเดตเอนทิตีหากมีความขัดแย้ง (I7aaab, b/241964353) - เพิ่มอาร์ติแฟกต์การแบ่งหน้าห้องใหม่
room-paging-rxjava2,room-paging-rxjava3และroom-paging-guavaเพื่อรองรับการแบ่งหน้าห้อง - เพิ่ม API สำหรับระบุชื่อตารางคีย์และค่าเพื่อแก้ความกำกวมใน
@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 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- แก้ไข API ต่างๆ ที่รับอาร์กิวเมนต์การค้นหาจากค่าคงที่ (
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 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- จำกัดเวอร์ชันขั้นต่ำที่รองรับ
@Upsertให้เป็น API 16 ซึ่งเกิดจากการไม่สามารถระบุความขัดแย้งของข้อจำกัดคีย์หลักใน API เวอร์ชันเก่าได้ (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 จะแสดง
SQLiteConstraintExceptionแทนIllegalStateExceptionในระหว่างการตรวจสอบข้อจำกัดของคีย์นอกสำหรับการย้ายข้อมูลอัตโนมัติ (I328dd) - แก้ไขการเปลี่ยนแปลงที่เข้ากันไม่ได้ของแหล่งที่มา Kotlin สำหรับ Getter/พร็อพเพอร์ตี้ของ
getOpenHelper,getQueryExecutorและgetTransactionExecutor(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เพื่อรองรับการแบ่งหน้าใน Room (41a1d4,b/203666906),(eb6098,b/203666906),(1b9ae4,b/203666906)
การเปลี่ยนแปลง API
room-runtimeทั้งหมดได้รับการแปลงจาก Java เป็น Kotlin แล้ว (If2069, b/206859668),(Ie4b55, b/206859668), (I697ee, b/206859668), (I96c25, b/206859668)หมายเหตุ: คุณอาจพบปัญหาความไม่เข้ากันของแหล่งที่มาเนื่องจากการแปลงไลบรารีเป็น Kotlin หากโค้ดของคุณอยู่ใน Kotlin และเรียกใช้ Room เวอร์ชันเก่า เวอร์ชันใหม่จะต้องจัดการกรณีเหล่านี้ ตัวอย่างเช่น การเปลี่ยนแปลงที่เข้ากันไม่ได้ของแหล่งที่มาที่ทราบคือใน
InvalidationTrackerตอนนี้คุณจะต้องประกาศonInvalidate()ในObserverเพื่อให้มีพารามิเตอร์ประเภทSetไม่ใช่MutableSet- เพิ่ม API สำหรับระบุชื่อตารางคีย์และค่าเพื่อแก้ความกำกวมใน
@MapInfo(Icc4b5) - แก้ไขปัญหาความเข้ากันได้ของแหล่งที่มาเพื่ออนุญาต
@Ignoreใน Getter ของพร็อพเพอร์ตี้อีกครั้ง (Ifc2fb)
แก้ไขข้อบกพร่อง
- อัลกอริทึมการแก้ปัญหาคอลัมน์ซ้ำแบบฮิวริสติก ตอนนี้ Room จะพยายามแก้ไขคอลัมน์ที่กำกวมในการค้นหา Multimap ซึ่งจะช่วยให้ JOIN กับตารางที่มีตารางชื่อเดียวกันได้รับการแมปกับออบเจ็กต์ข้อมูลผลลัพธ์อย่างถูกต้อง (I4b444, b/201306012, b/212279118)
เวอร์ชัน 2.5.0-alpha01
23 กุมภาพันธ์ 2022
androidx.room:room-*:2.5.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- แก้ไขปัญหาที่ไม่มีการบังคับใช้การใช้งาน Room
@IntDefในแหล่งที่มาของ Kotlin (I75f41, b/217951311) - แก้ไขปัญหาความเข้ากันได้ของแหล่งที่มาเพื่ออนุญาต
@Queryใน Getter ของพร็อพเพอร์ตี้อีกครั้ง (I0a09b) - แปลง room-common จาก Java เป็น Kotlin (I69c48, b/206858235)
หมายเหตุ: คุณอาจพบปัญหาความไม่เข้ากันของแหล่งที่มาเนื่องจากมีการย้ายพร็อพเพอร์ตี้บางรายการไปยังออบเจ็กต์ที่ใช้ร่วมกันระหว่างการแปลงไลบรารีเป็น Kotlin หากโค้ดของคุณอยู่ใน Kotlin และเรียกใช้ Room เวอร์ชันเก่า เวอร์ชันใหม่จะต้องมีคำต่อท้าย ".Companion" เมื่อเข้าถึงพร็อพเพอร์ตี้เหล่านี้
- แปลงการย้ายข้อมูลห้องจาก Java เป็น Kotlin (I2724b, b/206858622)
- แปลงไฟล์ที่เกี่ยวข้อง
pagingไฟล์ในroom-runtimeจาก Java เป็น Kotlin แล้ว (I82fc8, b/206859668) - เพิ่ม API สำหรับการล็อกและการใช้งานแบบหลายกระบวนการที่ระดับ FrameworkSQLite* เพื่อปกป้องการสร้างและการย้ายข้อมูลฐานข้อมูลครั้งแรกแบบหลายกระบวนการ (Ied267, b/193182592)
แก้ไขข้อบกพร่อง
- เพิ่มการรองรับพร็อพเพอร์ตี้ภายในในแหล่งที่มา Kotlin
นี่เป็นการเปลี่ยนแปลงลักษณะการทำงานเล็กน้อยใน Room โดยจะใช้ชื่อแหล่งที่มาของฟังก์ชันขณะจับคู่กับพร็อพเพอร์ตี้เป็น Getter/Setter (ก่อนหน้านี้ใช้ชื่อ JVM ของฟังก์ชันซึ่งแตกต่างกันสำหรับฟังก์ชัน/พร็อพเพอร์ตี้ภายใน)
หากคุณใช้คำอธิบายประกอบ
@JvmNameที่กำหนดเองเพื่อจับคู่ Getter/Setter กับพร็อพเพอร์ตี้ส่วนตัว โปรดตรวจสอบโค้ดที่สร้างขึ้นอีกครั้งหลังจากการอัปเดต (If6531, b/205289020)
เวอร์ชัน 2.4.3
เวอร์ชัน 2.4.3
27 กรกฎาคม 2022
androidx.room:room-*:2.4.3 เผยแพร่แล้ว เวอร์ชัน 2.4.3 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ทำให้ Room ไม่รู้จัก Suspend Function ใน 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 โดยจะใช้ชื่อแหล่งที่มาของฟังก์ชันขณะจับคู่กับพร็อพเพอร์ตี้เป็น Getter/Setter (ก่อนหน้านี้ใช้ชื่อ JVM ของฟังก์ชันซึ่งแตกต่างกันสำหรับฟังก์ชัน/พร็อพเพอร์ตี้ภายใน)
หากคุณใช้คำอธิบายประกอบ
@JvmNameที่กำหนดเองเพื่อจับคู่ Getter/Setter กับพร็อพเพอร์ตี้ส่วนตัว โปรดตรวจสอบโค้ดที่สร้างขึ้นอีกครั้งหลังจากการอัปเดต (If6531, b/205289020)
เวอร์ชัน 2.4.0
เวอร์ชัน 2.4.0
15 ธันวาคม 2021
androidx.room:room-*:2.4.0 เผยแพร่แล้ว เวอร์ชัน 2.4.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.3.0
- การย้ายข้อมูลอัตโนมัติ: ตอนนี้ Room มี API สำหรับสร้างการย้ายข้อมูลโดยอัตโนมัติตราบใดที่มีการส่งออกสคีมา หากต้องการแจ้งให้ Room ทราบว่าควรสร้างการย้ายข้อมูลอัตโนมัติ คุณสามารถใช้พร็อพเพอร์ตี้ใหม่
@Database#autoMigrationsเพื่อประกาศเวอร์ชันที่จะย้ายข้อมูลอัตโนมัติจากและไปยังเวอร์ชันดังกล่าว เมื่อ Room ต้องการข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนชื่อหรือการลบตารางและคอลัมน์ คำอธิบายประกอบ@AutoMigrationจะประกาศคลาสข้อกำหนดเฉพาะที่มีอินพุตดังกล่าวได้ ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ@AutoMigration - การแทรกทรัพยากร Dependency ในการย้ายข้อมูลอัตโนมัติ:
@ProvidedAutoMigrationSpecเป็น API ใหม่สำหรับประกาศว่าจะมีการจัดเตรียมAutoMigrationSpecขณะรันไทม์ผ่านRoomDatabase.Builder#addAutoMigrationSpec()ซึ่งจะช่วยให้เฟรมเวิร์กการแทรกทรัพยากร Dependency ระบุข้อกำหนดดังกล่าวได้เมื่อต้องการทรัพยากร Dependency ที่ซับซ้อน - การรองรับตัวช่วยทดสอบการย้ายข้อมูลสำหรับการย้ายข้อมูลอัตโนมัติ:
MigrationTestHelperของ Room ได้รับการอัปเดตเพื่อรองรับการย้ายข้อมูลอัตโนมัติโดยการจัดเตรียม API ตัวสร้างใหม่ที่รับคลาสฐานข้อมูลที่อยู่ระหว่างการทดสอบ ซึ่งจะช่วยให้ผู้ช่วยเพิ่มการย้ายข้อมูลอัตโนมัติในลักษณะเดียวกันได้โดยอัตโนมัติในระหว่างrunMigrationsAndValidate - การรองรับ Paging ของ Room:
androidx.room:room-pagingเปิดตัวแล้ว โดยรองรับ Paging 3.0 แบบเนทีฟสำหรับการค้นหา Room ที่แสดงผลandroidx.paging.PagingSource - เมธอดการค้นหาเชิงสัมพันธ์: ตอนนี้ Room รองรับเมธอด
@Daoประเภทการแสดงผลแบบ Multimap ซึ่งมีประโยชน์สำหรับคำสั่ง JOIN ประเภทของ Multimap ที่รองรับคือMap,SparseArray,LongSparseArrayพร้อมกับImmutableMap,ImmutableSetMultimapและImmutableListMultimapของ Guava
เวอร์ชัน 2.4.0-rc01
1 ธันวาคม 2021
androidx.room:room-*:2.4.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.4.0-rc01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- อัปเดตทรัพยากร Dependency ของ Room ใน KSP เป็น
1.6.0-1.0.1เพื่อรองรับ Kotlin 1.6
เวอร์ชัน 2.4.0-beta02
17 พฤศจิกายน 2021
androidx.room:room-*:2.4.0-beta02 เผยแพร่แล้ว เวอร์ชัน 2.4.0-beta02 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เพิ่มการรองรับ SparseArray และ LongSparseArray ใน @MapInfo (Ic91a2b/138910317)
แก้ไขข้อบกพร่อง
- เราได้เพิ่มเครื่องมือวิเคราะห์ TypeConverter ใหม่ที่พิจารณาข้อมูลความสามารถในการเป็นค่า Null ในประเภทต่างๆ เนื่องจากข้อมูลนี้มีให้เฉพาะใน KSP ระบบจึงเปิดใช้โดยค่าเริ่มต้นใน KSP เท่านั้น หากทำให้เกิดปัญหา คุณสามารถปิดได้โดยส่ง room.useNullAwareTypeAnalysis=false ไปยังโปรเซสเซอร์สำหรับคำอธิบายประกอบ หากเกิดกรณีดังกล่าว โปรดรายงานข้อบกพร่องเนื่องจากเราจะนำแฟล็กนี้ออกในอนาคต เมื่อใช้เครื่องมือวิเคราะห์ TypeConverter ใหม่นี้ เราขอแนะนำให้ระบุเฉพาะ TypeConverter ที่รับค่าที่ไม่ใช่ Null เนื่องจากเครื่องมือวิเคราะห์ใหม่มีความสามารถในการรวม TypeConverter ด้วยการตรวจสอบ Null โปรดทราบว่าการดำเนินการนี้ไม่มีผลต่อผู้ใช้ที่ใช้ KAPT หรือ Java เนื่องจากโปรเซสเซอร์สำหรับคำอธิบายประกอบ (ต่างจาก KSP) ไม่มีข้อมูลความสามารถในการเป็นค่า Null ในประเภท (Ia88f9, b/193437407)
- แก้ไขข้อบกพร่องที่ Room ไม่สามารถคอมไพล์ด้วยข้อผิดพลาด SQL เมื่อเอนทิตี FTS ประกาศให้ใช้ ICU Tokenizer (I00db9, b/201753224)
- แก้ไขปัญหาในการย้ายข้อมูลอัตโนมัติเกี่ยวกับคอลัมน์ใหม่ที่เพิ่มลงในเอนทิตีที่ฝังระหว่างเวอร์ชัน (I5fcb1b/193798291)
- เราได้แก้ไขปัญหาเกี่ยวกับประเภทการแสดงผลของเมธอดการค้นหาเชิงสัมพันธ์ในการค้นหา LEFT JOIN แล้ว การเปลี่ยนแปลงเหล่านี้ทำให้ในกรณีที่มีการแมปแบบ 1-หลายรายการ คอลเล็กชันที่แสดงผลสำหรับคีย์จะไม่มีออบเจ็กต์ค่าที่ไม่ถูกต้องหากไม่พบในเคอร์เซอร์ หากไม่พบค่าที่ถูกต้อง ระบบจะแมปคีย์กับคอลเล็กชันที่ว่างเปล่า (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)
- ตอนนี้การติดตั้งใช้งาน PagingSource ที่สร้างโดยการแบ่งหน้าห้องใช้
queryExecutorที่ส่งผ่านRoomDatabase.Builderจึงสามารถลบล้างได้ แทนที่จะเป็นDispatchers.IOก่อนหน้านี้ (Iae259)
เวอร์ชัน 2.4.0-alpha05
29 กันยายน 2021
androidx.room:room-*:2.4.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha05 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มตัวแปลงประเภทในตัวสำหรับ UUID (I671e8, b/73132006)
การเปลี่ยนแปลง API
เพิ่มพร็อพเพอร์ตี้ใหม่ลงในคำอธิบายประกอบ TypeConverters เพื่อให้นักพัฒนาแอปปิดใช้ตัวแปลง Enum และ UUID ในตัวได้ โดยค่าเริ่มต้น ตัวแปลงเหล่านี้จะเปิดอยู่ แต่คุณสามารถปิดใช้สำหรับขอบเขตหนึ่งๆ หรือทั้งฐานข้อมูลได้ ดูรายละเอียดได้ในเอกสารประกอบของ TypeConverters (36ae9e, b/195413406)
รองรับคีย์/ค่าที่ไม่ใช่ POJO สำหรับประเภทการแสดงผล Multimap ใน DAO ผ่านคำอธิบายประกอบ
@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-pagingเป็นอาร์ติแฟกต์ที่จำเป็นเมื่อใช้ Paging3 กับ Room (Ieaffe)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ผลลัพธ์การค้นหา Multimap ไม่ได้รับการจัดเรียงอย่างถูกต้องเมื่อการค้นหามีส่วนคำสั่ง ORDER BY ของคอลัมน์จากคีย์ของแผนที่ (I6b887)
การมีส่วนร่วมจากภายนอก
- เพิ่ม API ใหม่เพื่อระบุลำดับดัชนีใน @Index ขอขอบคุณ Nikita Zhelonkin (I033fc)
เวอร์ชัน 2.4.0-alpha04
21 กรกฎาคม 2021
androidx.room:room-*:2.4.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha04 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
ตอนนี้ Room รองรับเมธอด
@Daoประเภทการแสดงผลแบบหลายแผนที่ ซึ่งมีประโยชน์สำหรับคำสั่ง JOIN ประเภทของ Multimap ที่รองรับคือMapพร้อมกับImmutableMap,ImmutableSetMultimapและImmutableListMultimapของ Guavaตัวอย่างการค้นหาแบบหลายแผนที่ ได้แก่
แผนที่ความสัมพันธ์แบบหนึ่งต่อหนึ่ง
@Query("SELECT * FROM Song JOIN Artist ON Song.artistId = Artist.artistId") fun getSongAndArtist(): Map<Song, Artist>แผนที่ความสัมพันธ์แบบ 1 ต่อหลาย (Multimap มาตรฐาน)
@Query("SELECT * FROM Artist JOIN Album ON Artist.id = Album.artistId") fun getArtistAndAlbums(): Map<Artist, List<Album>>ผลลัพธ์ Multimap ยังรวมอยู่ในประเภทการแสดงผลแบบไม่พร้อมกันที่รองรับได้ด้วย เช่น
LiveData,Observableของ Rx หรือ CoroutineFlow
Room-Paging
androidx.room:room-pagingเปิดตัวแล้ว โดยให้การรองรับ Paging 3.0 แบบเนทีฟสำหรับการค้นหา Room ที่แสดงผลandroidx.paging.PagingSource@Dao interface UserDao { @Query("SELECT * FROM users ORDER BY id ASC") fun loadUsers(): PagingSource<Int, User> }อาร์ติแฟกต์นี้จะแทนที่การติดตั้งใช้งาน
androidx.paging.PagingSourceที่สร้างโดย Room ด้วยการติดตั้งใช้งานที่สร้างขึ้นบน Paging 3.0 API การติดตั้งใช้งาน PagingSource ใหม่จะแยกวิเคราะห์คีย์ต่างออกไป ดังนั้นคีย์ที่ส่งไปยัง PagingSource ของ Room ด้วยตนเองจะต้องพิจารณาการเปลี่ยนแปลงลักษณะการทำงานนี้ รวมถึง initialKey ที่ส่งผ่านคอนสตรัคเตอร์ของ Pager หน้าเว็บจะเริ่มโหลดจากKeyโดยมีKeyเป็นรายการแรกที่โหลด ซึ่งแตกต่างจากลักษณะการทำงานที่มีอยู่ซึ่งถือว่าLoadParams.Refresh.Keyเป็นตำแหน่งการเลื่อนของผู้ใช้ และระบบจะโหลดรายการทั้งก่อนและหลังคีย์อาร์ติแฟกต์เป็นตัวเลือกที่ไม่บังคับ และการเลือกไม่ใช้จะเปลี่ยนกลับไปใช้การรองรับที่มีอยู่สำหรับ Paging 3.0 ซึ่งเปิดตัวใน Room 2.3 อย่างไรก็ตาม อาร์ติแฟกต์นี้จะกลายเป็นสิ่งจำเป็นในรุ่นต่อๆ ไปสำหรับผู้ที่ใช้ Room กับ Paging 3.0 หากต้องการเลือกใช้ ให้เพิ่มอาร์ติแฟกต์การแบ่งหน้าห้องใหม่ลงใน classpath หากใช้ 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 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- อัปเดต
MigrationTestHelperของ Room เพื่อรองรับการย้ายข้อมูลอัตโนมัติโดยระบุ API ตัวสร้างใหม่ที่รับคลาสฐานข้อมูลที่อยู่ระหว่างการทดสอบ ซึ่งจะช่วยให้ผู้ช่วยเพิ่มการย้ายข้อมูลอัตโนมัติในลักษณะเดียวกันได้โดยอัตโนมัติในระหว่างrunMigrationsAndValidate
แก้ไขข้อบกพร่อง
แก้ไขปัญหาเกี่ยวกับไลบรารีแบบเนทีฟ SQLite ของ Room เพื่อรองรับชิป M1 ของ Apple (b/174695268
แก้ไขปัญหาที่ Room ไม่แสดงข้อผิดพลาดเมื่อประเภทการแสดงผลของฟังก์ชัน @Transaction เป็น Flow (I56ddd, b/190075899)
แก้ไขปัญหาในการย้ายข้อมูลอัตโนมัติเกี่ยวกับดัชนี b/177673291
การอัปเดตทรัพยากร Dependency
- ตอนนี้การรองรับ KSP ของห้องขึ้นอยู่กับ KSP
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 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
@ProvidedAutoMigrationSpecเป็น API ใหม่สำหรับประกาศว่าจะมีการระบุAutoMigrationSpecขณะรันไทม์ผ่านRoomDatabase.Builder#addAutoMigrationSpec()ซึ่งจะช่วยให้เฟรมเวิร์กการแทรกทรัพยากร Dependency ระบุข้อกำหนดดังกล่าวได้เมื่อต้องการทรัพยากร Dependency ที่ซับซ้อน
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับการย้ายข้อมูลอัตโนมัติที่ระบบไม่ได้สร้าง
@DatabaseViewขึ้นมาใหม่ให้ถูกต้อง
การมีส่วนร่วมจากภายนอก
- แก้ไขปัญหาใน
JournalMode.TRUNCATEของ Room ที่บางครั้งมีการเรียกใช้ CallbackInvalidationTrackerอย่างไม่ถูกต้อง ช้าเกินไป หรือไม่เรียกใช้เลย ขอขอบคุณ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 มี API สำหรับสร้างการย้ายข้อมูลโดยอัตโนมัติตราบใดที่มีการส่งออกสคีมา หากต้องการแจ้งให้ Room ทราบว่าควรสร้างการย้ายข้อมูลอัตโนมัติ คุณสามารถใช้พร็อพเพอร์ตี้ใหม่
@Database#autoMigrationsเพื่อประกาศเวอร์ชันที่จะย้ายข้อมูลอัตโนมัติจากและไปยังเวอร์ชันดังกล่าว เมื่อ Room ต้องการข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนชื่อหรือการลบตารางและคอลัมน์ คำอธิบายประกอบ@AutoMigrationจะประกาศคลาสข้อกำหนดเฉพาะที่มีอินพุตดังกล่าวได้ ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ@AutoMigration
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่
defaultValueที่มีวงเล็บเพิ่มเติมได้รับการตรวจสอบอย่างไม่ถูกต้องโดยการตรวจสอบสคีมาของ Room 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 เป็น String และในทางกลับกันโดยค่าเริ่มต้น หากไม่มีการระบุไว้ หากมีตัวแปลงประเภทสำหรับ enum อยู่แล้ว Room จะให้ความสำคัญกับการใช้ตัวแปลงประเภทนั้นมากกว่าตัวแปลงเริ่มต้น
- Query Callback: ตอนนี้ Room มี Callback API ทั่วไป RoomDatabase.QueryCallback สำหรับเมื่อการค้นหากำลังจะดำเนินการ ซึ่งจะเป็นประโยชน์สำหรับการบันทึกในบิลด์การแก้ไขข้อบกพร่อง คุณตั้งค่า Callback ได้ผ่าน
RoomDatabase.Builder#setQueryCallback() - การปรับปรุงที่จัดแพ็กเกจไว้ล่วงหน้า: ตอนนี้ Room มี API สำหรับสร้างฐานข้อมูลโดยใช้ฐานข้อมูลที่จัดแพ็กเกจไว้ล่วงหน้าซึ่งอ่านจากสตรีมอินพุต ซึ่งจะช่วยให้สามารถจัดการกับกรณีต่างๆ เช่น เมื่อฐานข้อมูลที่จัดแพ็กเกจไว้ล่วงหน้าเป็นไฟล์ gzip
- Type Converter ที่มีให้: ตอนนี้ Room มี API สำหรับการระบุอินสแตนซ์ของ Type Converter เพื่อให้แอปควบคุมการเริ่มต้นได้ หากต้องการทำเครื่องหมายตัวแปลงประเภทที่จะระบุให้กับ Room ให้ใช้คำอธิบายประกอบใหม่ @ProvidedTypeConverter
- การรองรับ RxJava3: ตอนนี้ Room รองรับประเภท RxJava3 แล้ว คุณสามารถประกาศเมธอด DAO ที่มีประเภทการแสดงผลเป็น Flowable, Single, Maybe และ Completable ได้เช่นเดียวกับ RxJava2 นอกจากนี้ยังมีอาร์ติแฟกต์ใหม่
androidx.room:room-rxjava3เพื่อรองรับ 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 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ทำให้ไม่สามารถใช้การค้นหา Coroutine Flow ที่สร้างโดย Room ในบล็อก
withTransactionที่ระงับได้ (I797bf)
เวอร์ชัน 2.3.0-beta03
10 มีนาคม 2021
androidx.room:room-*:2.3.0-beta03 เผยแพร่แล้ว เวอร์ชัน 2.3.0-beta03 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มการรองรับการคอมไพล์แบบเพิ่มขึ้นสำหรับ KSP (I031c1, b/176453350)
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่การสร้าง PagingSource ในเทรดหลักอาจทำให้เกิด ANR (I42b74, b/181221318)
- แก้ไขระดับการเข้าถึง
@ExperimentalRoomApiให้เป็นสาธารณะแทนที่จะเป็นแบบส่วนตัวของแพ็กเกจ (b/181356119)
การมีส่วนร่วมจากภายนอก
- อนุญาตให้ Room ยอมรับประเภทการแสดงผล POJO ในเมธอด DAO ที่มีคำอธิบายประกอบ
@Queryเมื่อมีคำอธิบายประกอบ@SkipQueryVerificationด้วย Room จะพยายามอย่างเต็มที่เพื่อแปลงผลลัพธ์ของคำค้นหาเป็นประเภทการแสดงผล POJO ในลักษณะเดียวกับที่ทำสำหรับเมธอด DAO ที่มีคำอธิบายประกอบ@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 Symbol Processing KSP ในขั้นทดลองแล้ว
KSP เป็นตัวแทนของ KAPT เพื่อเรียกใช้โปรเซสเซอร์สำหรับคำอธิบายประกอบในคอมไพเลอร์ Kotlin โดยตรง ซึ่งช่วยลดเวลาในการบิลด์ได้อย่างมาก
หากต้องการใช้ Room กับ KSP คุณสามารถใช้ปลั๊กอิน KSP Gradle และแทนที่การกำหนดค่า
kaptในไฟล์บิลด์ด้วยkspเช่น ใช้ksp 'androidx.room:room-compiler:2.3.0-beta02'แทนkapt 'androidx.room:room-compiler:2.3.0-beta02'ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบของ KSPโปรดทราบว่าเนื่องจาก KSP ยังอยู่ระหว่างการทดสอบ เราจึงขอแนะนำให้ใช้ KAPT สำหรับโค้ดเวอร์ชันที่ใช้งานจริงต่อไป การลดเวลาในการสร้างจะใช้ได้ก็ต่อเมื่อไม่มีโปรเซสเซอร์อื่นที่ใช้ KAPT ดูปัญหาที่ทราบได้ที่ b/160322705
เวอร์ชัน 2.3.0-beta01
27 มกราคม 2021
androidx.room:room-*:2.3.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.3.0-beta01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ฐานข้อมูลที่ปิดอัตโนมัติ: ตอนนี้ Room สามารถปิดฐานข้อมูลที่ไม่มีการเข้าถึงหลังจากระยะเวลาที่กำหนดได้แล้ว ฟีเจอร์นี้เป็นฟีเจอร์ทดลองและเปิดใช้ได้โดยเรียกใช้
RoomDatabase.Builder#setAutoCloseTimeout()ฟีเจอร์นี้มีประโยชน์สำหรับแอปพลิเคชันที่มีฐานข้อมูลหลายรายการ
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่เมธอด Dao ที่มีเมธอด
@Updateหรือ@Deleteหลายรายการซึ่งมีกลยุทธ์ความขัดแย้งที่แตกต่างกันจะสร้างโค้ดที่มีกลยุทธ์เพียงรายการเดียว โดยละเว้นกลยุทธ์ที่กำหนดไว้ (/I0b90d, b/176138543)
เวอร์ชัน 2.3.0-alpha04
16 ธันวาคม 2020
androidx.room:room-*:2.3.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha04 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้ Room มี Callback API
RoomDatabase.QueryCallbackทั่วไปสำหรับเมื่อคำค้นหากำลังจะดำเนินการ ซึ่งอาจเป็นประโยชน์สำหรับการบันทึกในบิลด์การแก้ไขข้อบกพร่อง คุณตั้งค่า Callback ได้ผ่านRoomDatabase.Builder#setQueryCallback()(Iaa513, b/174478034, b/74877608) - ตอนนี้ Room จะใช้ตัวแปลงประเภท Enum เป็น String และในทางกลับกันโดยค่าเริ่มต้น หากไม่มีการระบุไว้ หากมีตัวแปลงประเภทสำหรับ enum อยู่แล้ว Room จะให้ความสำคัญกับการใช้ตัวแปลงประเภทนั้นมากกว่าตัวแปลงเริ่มต้น (b/73132006)
ปัญหาที่ทราบ
- หากมีตัวแปลงประเภทแบบทางเดียวสำหรับการอ่านอยู่แล้วสำหรับ Enum นั้น Room อาจใช้ตัวแปลง String เป็น Enum ในตัวโดยไม่ตั้งใจ ซึ่งอาจไม่ใช่สิ่งที่ต้องการ เรารับทราบปัญหานี้แล้ว และสามารถแก้ไขได้โดยทำให้เป็นตัวแปลงแบบ 2 ทาง ดู b/175707691
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ Room ปิดใช้การประมวลผลคำอธิบายประกอบแบบเพิ่มขึ้นอย่างไม่ถูกต้องใน JDK เวอร์ชันใหม่ (b/171387388)
- แก้ไขปัญหาที่ Room ค้นหาคลาสที่สร้างขึ้นเมื่อใช้ Class Loader หลายรายการ ขอขอบคุณ Serendipity | 892449346@qq.com สำหรับการแก้ไข (b/170141113)
- แก้ไขปัญหาที่ Room สร้างโค้ดไม่ถูกต้องเมื่อ Kotlin
@Daoมีคลาสพื้นฐานที่มีประเภททั่วไปเป็นประเภทพื้นฐานใน JVM (b/160258066)
การมีส่วนร่วมจากภายนอก
- ตอนนี้ Room จะใช้
beginTransactionNonExclusiveเป็นค่าเริ่มต้นหากเปิดใช้โหมด WAL และ API มีค่าตั้งแต่ 16 ขึ้นไป ขอขอบคุณ "Ahmed I. Khalil | ahmedibrahimkhali@gmail.com’! (b/126258791)
เวอร์ชัน 2.3.0-alpha03
14 ตุลาคม 2020
androidx.room:room-*:2.3.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha03 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
ตอนนี้ Room มี API สำหรับจัดเตรียมอินสแตนซ์ของตัวแปลงประเภทเพื่อให้แอปควบคุมการเริ่มต้นได้ หากต้องการทำเครื่องหมายตัวแปลงประเภทที่จะส่งไปยัง Room ให้ใช้คำอธิบายประกอบ
@ProvidedTypeConverterใหม่ ขอขอบคุณ "mzgreen yairobbe@gmail.com" (Ie4fa5, b/121067210)ตอนนี้ Room มี API สำหรับสร้างฐานข้อมูลโดยใช้ฐานข้อมูลที่จัดแพ็กเกจไว้ล่วงหน้าซึ่งอ่านจากสตรีมอินพุต ซึ่งจะช่วยให้สามารถจัดการกับกรณีต่างๆ เช่น เมื่อฐานข้อมูลที่จัดแพ็กเกจไว้ล่วงหน้าเป็นไฟล์ gzip ขอขอบคุณ "Ahmed El-Helw ahmedre@gmail.com" (3e6792, b/146911060)
การเปลี่ยนแปลง API
เพิ่มเป้าหมายที่ขาดหายไปลงในคำอธิบายประกอบ
@ForeignKeyเพื่อป้องกันไม่ให้มีการใช้งานนอกคำอธิบายประกอบ@Entity(Iced1e)ซ่อนช่อง
mCallbacksในRoomDatabase.javaแล้ว (d576cb, b/76109329)
แก้ไขข้อบกพร่อง
อัปเดตเอกสารประกอบ TypeConverters เพื่อชี้แจงว่า TypeConverters ใช้ได้เฉพาะกับการแปลงคอลัมน์/ฟิลด์เท่านั้น ไม่ใช่แถว (I07c56, b/77307836)
อัปเดต DaoProcessor เพื่อแก้ไขข้อผิดพลาดของคอมไพเลอร์ใน Dao ที่มีซูเปอร์ไทป์ทั่วไปที่มี "ประเภทพื้นฐาน" ของ Kotlin (Ice6bb, b/160258066)
อัปเดตเอกสารประกอบเกี่ยวกับเมธอดเพิ่ม/นำผู้สังเกตการณ์ออกเพื่อชี้แจงเรื่องชุดข้อความ (Ifd1d9, b/153948821)
แก้ไขปัญหาที่ Room ตรวจสอบความถูกต้องของตาราง FTS ที่ประกาศคอลัมน์ rowid ไม่ถูกต้อง (d62ebc, b/145858914)
การมีส่วนร่วมจากภายนอก
แก้ไขปัญหาเกี่ยวกับภาษาที่ใช้อักษรตัวพิมพ์ใหญ่/เล็กที่เกี่ยวข้องกับภาษาตุรกี (5746e3), b/68159494
แทนที่
ConcurrentHashMapภายในRoomDatabaseด้วยCollections.synchronizedMap()เพื่อหลีกเลี่ยงปัญหาใน Android Lollipop (d1cfc7, b/162431855)เพิ่ม Callback onOpenPrepackagedDatabase สำหรับเมื่อมีการคัดลอกฐานข้อมูลที่จัดแพ็กเกจไว้ล่วงหน้า (I1ba74, b/148934423)
เวอร์ชัน 2.3.0-alpha02
22 กรกฎาคม 2020
androidx.room:room-*:2.3.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha02 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- การรองรับ RxJava3: ตอนนี้ Room รองรับประเภท RxJava3 แล้ว คุณสามารถประกาศเมธอด DAO ที่มีประเภทการแสดงผลเป็น Flowable, Single, Maybe และ Completable ได้เช่นเดียวกับ RxJava2 นอกจากนี้ยังมีอาร์ติแฟกต์ใหม่
androidx.room:room-rxjava3เพื่อรองรับ RxJava3 ด้วย (b/152427884)
การเปลี่ยนแปลง API
- ตอนนี้ระบบรองรับการประกาศ
@TypeConverterในคลาสออบเจ็กต์ Kotlin แล้ว (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> }
การเปลี่ยนแปลง API
@RewriteQueriesToDropUnusedColumnsเป็นคำอธิบายประกอบใหม่ที่สะดวกซึ่งทำให้ Room เขียนการฉายภาพ "*" ในการค้นหาใหม่เพื่อให้ระบบนำคอลัมน์ที่ไม่ได้ใช้ในผลลัพธ์ออก- ตัวเลือกโปรเซสเซอร์
room.expandProjectionเลิกใช้งานแล้ว ใช้@RewriteQueriesToDropUnusedColumnsแทนการค้นหาที่เพิ่มประสิทธิภาพ Room ด้วยการฉายภาพแบบดาว โปรดทราบว่า@RewriteQueriesToDropUnusedColumnsไม่ได้แทนที่โซลูชันความขัดแย้งของคอลัมน์room.expandProjectionที่เสนอเกี่ยวกับประเภทการแสดงผลที่มีฟิลด์@Embedded
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ Room ตรวจหาเวอร์ชัน JDK ที่ใช้เพื่อเปิดใช้โปรเซสเซอร์สำหรับคำอธิบายประกอบแบบเพิ่มขึ้นไม่ถูกต้อง ขอขอบคุณ Blaz Solar (me@blaz.solar) (b/155215201)
- ตอนนี้ Room จะฝังทรัพยากร Dependency ของ ANTLR ไว้กับโปรเซสเซอร์สำหรับคำอธิบายประกอบเพื่อหลีกเลี่ยงความขัดแย้งของเวอร์ชันกับโปรเซสเซอร์อื่นๆ ที่ใช้ ANTLR ด้วย (b/150106190)
เวอร์ชัน 2.2.6
เวอร์ชัน 2.2.6
16 ธันวาคม 2020
androidx.room:room-*:2.2.6 เผยแพร่แล้ว เวอร์ชัน 2.2.6 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ Room ปิดใช้การประมวลผลคำอธิบายประกอบแบบเพิ่มขึ้นอย่างไม่ถูกต้องใน JDK เวอร์ชันใหม่ (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) - แก้ไขข้อบกพร่องที่ทำให้เกิดข้อขัดข้องเมื่อเปิดใช้การทำให้ อินสแตนซ์หลายรายการ เป็นโมฆะและฐานข้อมูลมีเอนทิตี FTS (b/148969394)
- แก้ไขปัญหาเมื่อโหลดไลบรารีแบบเนทีฟ SQLite ในโปรเซสเซอร์สำหรับคำอธิบายประกอบ Room ซึ่งจะทำให้คอมไพเลอร์ขัดข้องเนื่องจากการคอมไพล์แบบขนาน (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)
- แก้ไขปัญหาที่มีการใช้ @Generated อย่างไม่ถูกต้องเมื่อสร้างด้วย JDK 9 (b/146538330)
- แก้ไขปัญหาที่ Room สร้างโค้ดไม่ถูกต้องเมื่ออินเทอร์เฟซ DAO ใน Kotlin มีฟังก์ชันที่เป็นรูปธรรม (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 แสดงผลรายการที่เกี่ยวข้องเป็น Null (b/143105450)
เวอร์ชัน 2.2.1
เวอร์ชัน 2.2.1
23 ตุลาคม 2019
androidx.room:room-*:2.2.1 เผยแพร่แล้ว เวอร์ชัน 2.2.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ Room จะเตือนอย่างไม่ถูกต้องเกี่ยวกับ
CURSOR_MISMATCHเมื่อเปิดตัวเลือกคอมไพเลอร์expandProjection(b/140759491) - เพิ่มกลไกการลองใหม่เพื่อจัดการไลบรารีแบบเนทีฟที่หายไปซึ่งใช้ในการยืนยันการค้นหาระหว่างเวลาคอมไพล์
เวอร์ชัน 2.2.0
เวอร์ชัน 2.2.0
9 ตุลาคม 2019
androidx.room:room-*:2.2.0 เผยแพร่แล้ว เวอร์ชัน 2.2.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.1.0
- ฐานข้อมูลที่จัดแพ็กเกจไว้ล่วงหน้า: API ใหม่ 2 รายการใน
RoomDatabase.Builderพร้อมให้ใช้งานแล้วสำหรับการสร้างRoomDatabaseโดยอิงตามไฟล์ฐานข้อมูลที่มีข้อมูลอยู่แล้วcreateFromAsset()ใช้เมื่อไฟล์ฐานข้อมูลที่ป้อนข้อมูลล่วงหน้าอยู่ในโฟลเดอร์ชิ้นงานของ APK ส่วนcreateFromFile()ใช้เมื่อไฟล์อยู่ในตำแหน่งที่กำหนดเอง การใช้ API เหล่านี้จะเปลี่ยนลักษณะการทำงานของการย้ายข้อมูลแบบทำลายล้าง โดยในระหว่างการย้ายข้อมูลสำรอง Room จะพยายามคัดลอกฐานข้อมูลที่ป้อนข้อมูลล่วงหน้าอีกครั้งหากมี มิฉะนั้นจะเปลี่ยนไปใช้การลบและสร้างตารางทั้งหมดอีกครั้ง b/62185732 - ค่าเริ่มต้นของสคีมา: ตอนนี้
@ColumnInfoมีพร็อพเพอร์ตี้ใหม่defaultValueซึ่งใช้ระบุค่าเริ่มต้นของคอลัมน์ได้ ค่าเริ่มต้นเป็นส่วนหนึ่งของสคีมาฐานข้อมูลและจะได้รับการตรวจสอบระหว่างการย้ายข้อมูลหากระบุไว้ b/64088772 - ความสัมพันธ์แบบหลายต่อหลาย: ตอนนี้
@Relationมีพร็อพเพอร์ตี้ใหม่associateByซึ่งใช้คำอธิบายประกอบใหม่@Junctionเพื่อประกาศความสัมพันธ์ที่ต้องเป็นไปตามเงื่อนไขผ่านตารางเชื่อมต่อ (หรือที่เรียกว่าตารางรวม) b/69201917 - ความสัมพันธ์แบบหนึ่งต่อหนึ่ง: ข้อจำกัดในฟิลด์ POJO ที่มีคำอธิบายประกอบเป็น
@Relationเพื่อให้เป็นประเภทListหรือSetได้ถูกยกเลิกแล้ว ซึ่งช่วยให้แสดงความสัมพันธ์แบบค่าเดียวได้อย่างมีประสิทธิภาพ b/62905145 - เอนทิตีเป้าหมาย: ตอนนี้คำอธิบายประกอบ DAO
@Insert,@Updateและ@Deleteมีพร็อพเพอร์ตี้ใหม่targetEntityซึ่งช่วยให้ระบุตารางเป้าหมายที่เมธอด DAO มีไว้เพื่อดำเนินการได้ ซึ่งจะช่วยให้พารามิเตอร์ของเมธอด DAO เหล่านั้นเป็น POJO ที่กำหนดเองได้ ซึ่งจะได้รับการตีความว่าเป็นเอนทิตีบางส่วน ในทางปฏิบัติ วิธีนี้จะช่วยให้แทรก ลบ และอัปเดตบางส่วนได้ b/127549506 - Coroutines Flow: ตอนนี้เมธอด
@QueryDAO สามารถเป็นประเภทการแสดงผลFlow<T>ได้แล้ว Flow ที่แสดงผลจะส่งชุดค่าใหม่อีกครั้งหากตารางที่สังเกตในคำค้นหาไม่ถูกต้อง การประกาศฟังก์ชัน DAO ที่มีประเภทการแสดงผลChannel<T>จะทำให้เกิดข้อผิดพลาด แต่ Room จะแนะนำให้คุณใช้Flowแล้วใช้ฟังก์ชันที่อยู่ใกล้เคียงเพื่อแปลงFlowเป็นChannelแทน b/130428884 - โปรเซสเซอร์สำหรับคำอธิบายประกอบแบบเพิ่มขึ้นของ Gradle: ตอนนี้ Room เป็นโปรเซสเซอร์สำหรับคำอธิบายประกอบแบบแยกของ Gradle และสามารถเปิดใช้การเพิ่มขึ้นได้ผ่านตัวเลือกโปรเซสเซอร์
room.incrementalดูข้อมูลเพิ่มเติมได้ที่ตัวเลือกคอมไพเลอร์ Room หากพบปัญหา โปรดรายงานข้อบกพร่องที่นี่ เราวางแผนที่จะเปิดใช้การเพิ่มขึ้นโดยค่าเริ่มต้นในเวอร์ชันเสถียรในอนาคต b/112110217 - การขยายการคาดการณ์: เพิ่มตัวเลือกคอมไพเลอร์ทดลองใหม่
room.expandProjectionซึ่งทำให้ Room เขียนการค้นหาใหม่ด้วยการคาดการณ์แบบดาวเพื่อให้มีเฉพาะคอลัมน์ใน POJO ประเภทการแสดงผล เช่น สำหรับเมธอด DAO ที่มี@Query("SELECT * FROM Song")ซึ่งแสดงผล POJO ชื่อSongIdAndTitleที่มีเพียง 2 ฟิลด์ จากนั้น Room จะเขียนคำค้นหาใหม่เป็นSELECT id, title FROM Songเพื่อให้ระบบดึงข้อมูลชุดคอลัมน์ขั้นต่ำที่ตรงตามประเภทการแสดงผล ซึ่งจะช่วยขจัดคำเตือนCURSOR_MISMATCHที่แสดงเมื่อการค้นหาแสดงคอลัมน์เพิ่มเติมที่ไม่ตรงกับฟิลด์ใดๆ ในประเภท POJO ที่แสดงผล
เวอร์ชัน 2.2.0-rc01
5 กันยายน 2019
androidx.room:room:2.2.0-rc01 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ไม่มีการเปลี่ยนแปลงแบบสาธารณะตั้งแต่ห้อง 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: ตอนนี้เมธอด
@QueryDAO สามารถเป็นประเภทการแสดงผลFlow<T>ได้แล้ว Flow ที่แสดงผลจะส่งชุดค่าใหม่อีกครั้งหากตารางที่สังเกตในคำค้นหาไม่ถูกต้อง การประกาศฟังก์ชัน DAO ที่มีประเภทการแสดงผลChannel<T>จะทำให้เกิดข้อผิดพลาด แต่ Room จะแนะนำให้คุณใช้Flowแล้วใช้ฟังก์ชันที่อยู่ใกล้เคียงเพื่อแปลงFlowเป็นChannelแทน b/130428884 - การขยายการคาดการณ์: เพิ่มตัวเลือกคอมไพเลอร์ทดลองใหม่
room.expandProjectionซึ่งทำให้ Room เขียนการค้นหาใหม่ด้วยการคาดการณ์แบบดาวเพื่อให้มีเฉพาะคอลัมน์ใน POJO ประเภทการแสดงผล เช่น สำหรับเมธอด DAO ที่มี@Query("SELECT * FROM Song")ซึ่งแสดงผล POJO ชื่อSongIdAndTitleที่มีเพียง 2 ฟิลด์ จากนั้น Room จะเขียนคำค้นหาใหม่เป็นSELECT id, title FROM Songเพื่อให้ระบบดึงข้อมูลชุดคอลัมน์ขั้นต่ำที่ตรงตามประเภทการแสดงผล ซึ่งจะช่วยขจัดคำเตือนCURSOR_MISMATCHที่แสดงเมื่อการค้นหาแสดงคอลัมน์เพิ่มเติมที่ไม่ตรงกับฟิลด์ใดๆ ในประเภท POJO ที่แสดงผล onDestructiveMigrateเป็น Callback API ใหม่ที่เพิ่มลงในRoomDatabase.Callbackสำหรับกรณีที่ Room ย้ายข้อมูลฐานข้อมูลแบบทำลายล้าง b/79962330
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ Room สร้างโค้ดไม่ถูกต้องโดยใช้เมธอดเป็นตัวตั้งค่าฟิลด์เมื่อฟิลด์ได้รับการป้องกัน b/136194628
- แก้ไขข้อบกพร่องที่ทำให้ InvalidationTracker แสดง NPE ในกระบวนการที่ 2 เมื่อเปิดใช้การลบล้างหลายอินสแตนซ์และบริการลบล้างถูกปิด b/137454915
- แก้ไขข้อบกพร่องที่ Room ไม่สามารถระบุประเภทการแสดงผลของฟังก์ชัน Suspend ที่รับค่ามาซึ่งมีคำอธิบายประกอบเป็น
@RawQueryได้อย่างถูกต้อง b/137878827 - อัปเดตโค้ดที่สร้างขึ้นสำหรับ
@Relationเมื่อคีย์ที่เกี่ยวข้องเป็นประเภท BLOB เพื่อใช้ByteBufferที่เปรียบเทียบได้ b/137881998 - แก้ไขข้อบกพร่องที่ Room จะแจ้งเกี่ยวกับ Setter ที่ขาดหายไปใน POJO ที่ใช้เป็นพารามิเตอร์เอนทิตีบางส่วนของ
@Insert,@Updateและ@Deleteb/138664463 - แก้ไขข้อบกพร่องที่ Room จะแจ้งเกี่ยวกับ Getter และ Setter ที่ขาดหายไปสำหรับคอลัมน์ที่ละเว้นผ่าน
@Entityเมื่อใช้คลาสเอนทิตีในเมธอด DAO บางรายการ b/138238182 - แก้ไขข้อบกพร่องที่ Room ไม่แปลงอาร์กิวเมนต์การเชื่อมโยงที่มีชื่อเป็นอาร์กิวเมนต์ตามตำแหน่งอย่างถูกต้อง ซึ่งทำให้เกิดข้อยกเว้นรันไทม์เมื่อเรียกใช้การค้นหาที่มีพารามิเตอร์ที่ใช้ซ้ำ b/137254857
เวอร์ชัน 2.2.0-alpha01
10 กรกฎาคม 2019
ฟีเจอร์ใหม่
- ฐานข้อมูลที่จัดแพ็กเกจไว้ล่วงหน้า: API ใหม่ 2 รายการใน
RoomDatabase.Builderพร้อมให้ใช้งานแล้วสำหรับการสร้างRoomDatabaseโดยอิงตามไฟล์ฐานข้อมูลที่มีข้อมูลอยู่แล้วcreateFromAsset()ใช้เมื่อไฟล์ฐานข้อมูลที่ป้อนข้อมูลล่วงหน้าอยู่ในโฟลเดอร์เนื้อหาของ APK ส่วนcreateFromFile()ใช้เมื่อไฟล์อยู่ในตำแหน่งที่กำหนดเอง การใช้ API เหล่านี้จะเปลี่ยนลักษณะการทำงานของการย้ายข้อมูลแบบทำลายล้าง โดยในระหว่างการย้ายข้อมูลสำรอง Room จะพยายามคัดลอกฐานข้อมูลที่ป้อนข้อมูลล่วงหน้าอีกครั้งหากมี มิฉะนั้นจะเปลี่ยนไปใช้การลบและสร้างตารางทั้งหมดอีกครั้ง b/62185732 - ค่าเริ่มต้นของสคีมา: ตอนนี้
@ColumnInfoมีพร็อพเพอร์ตี้ใหม่defaultValueซึ่งใช้ระบุค่าเริ่มต้นของคอลัมน์ได้ ค่าเริ่มต้นเป็นส่วนหนึ่งของสคีมาฐานข้อมูลและจะได้รับการตรวจสอบระหว่างการย้ายข้อมูลหากระบุไว้ b/64088772หมายเหตุ: หากสคีมาฐานข้อมูลมีค่าเริ่มต้นอยู่แล้ว เช่น ค่าที่เพิ่มผ่าน
ALTER TABLE x ADD COLUMN y INTEGER NOTNULL DEFAULT zและคุณตัดสินใจกำหนดค่าเริ่มต้นผ่าน@ColumnInfoให้กับคอลัมน์เดียวกัน คุณอาจต้องทำการย้ายข้อมูลเพื่อตรวจสอบค่าเริ่มต้นที่ไม่ได้ระบุไว้ ดูข้อมูลเพิ่มเติมได้ที่การย้ายข้อมูลห้องแชท - ความสัมพันธ์แบบหลายต่อหลาย: ตอนนี้
@Relationมีพร็อพเพอร์ตี้ใหม่associateByซึ่งใช้คำอธิบายประกอบใหม่@Junctionเพื่อประกาศความสัมพันธ์ที่ต้องเป็นไปตามเงื่อนไขผ่านตารางเชื่อมต่อ (หรือที่เรียกว่าตารางรวม) b/69201917 - ความสัมพันธ์แบบหนึ่งต่อหนึ่ง: ข้อจำกัดในฟิลด์ POJO ที่มีคำอธิบายประกอบเป็น
@Relationเพื่อให้เป็นประเภทListหรือSetได้ถูกยกเลิกแล้ว ซึ่งช่วยให้แสดงความสัมพันธ์แบบค่าเดียวได้อย่างมีประสิทธิภาพ b/62905145 - เอนทิตีเป้าหมาย: ตอนนี้คำอธิบายประกอบ DAO
@Insert,@Updateและ@Deleteมีพร็อพเพอร์ตี้ใหม่targetEntityซึ่งช่วยให้ระบุตารางเป้าหมายที่เมธอด DAO มีไว้เพื่อดำเนินการได้ ซึ่งจะช่วยให้พารามิเตอร์ของเมธอด DAO เหล่านั้นเป็น POJO ที่กำหนดเองได้ ซึ่งจะได้รับการตีความว่าเป็นเอนทิตีบางส่วน ในทางปฏิบัติ วิธีนี้จะช่วยให้แทรก ลบ และอัปเดตบางส่วนได้ b/127549506 - โปรเซสเซอร์สำหรับคำอธิบายประกอบแบบเพิ่มขึ้นของ Gradle: ตอนนี้ Room เป็นโปรเซสเซอร์สำหรับคำอธิบายประกอบแบบแยกของ Gradle และสามารถเปิดใช้การเพิ่มขึ้นได้ผ่านตัวเลือกโปรเซสเซอร์
room.incrementalดูข้อมูลเพิ่มเติมได้ที่ตัวเลือกคอมไพเลอร์ Room หากพบปัญหา โปรดรายงานข้อบกพร่องที่นี่ เราวางแผนที่จะเปิดใช้การเพิ่มขึ้นโดยค่าเริ่มต้นในเวอร์ชันเสถียรในอนาคต b/112110217
แก้ไขข้อบกพร่อง
- Room จะไม่เผยแพร่
EmptySetResultExceptionไปยังเครื่องมือจัดการข้อผิดพลาดส่วนกลางอีกต่อไปเมื่อสตรีม Rx ของการค้นหาถูกกำจัดก่อนที่การค้นหาจะเสร็จสมบูรณ์ b/130257475 - แก้ไขข้อบกพร่องที่ Room แสดงข้อความแสดงข้อผิดพลาดที่ไม่ถูกต้องเมื่อฟังก์ชัน DAO ที่ระงับซึ่งมีคำอธิบายประกอบ
@RawQueryไม่มีประเภทการแสดงผล b/134303897 - Room จะไม่สร้างอะแดปเตอร์ DAO ที่มีประเภทข้อมูลดิบอีกต่อไป 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เพื่อประกาศคลาสที่มีตารางการค้นหาข้อความแบบเต็มสำหรับการแมป ตัวเลือก FTS สำหรับการปรับแต่งเพิ่มเติมจะพร้อมใช้งานผ่านเมธอดของคำอธิบายประกอบ - มุมมอง: ตอนนี้ Room รองรับการประกาศคลาสเป็นคำค้นหาที่จัดเก็บไว้ หรือที่เรียกว่ามุมมอง โดยใช้คำอธิบายประกอบ
@DatabaseView - Couroutines: ตอนนี้เมธอด DAO เป็นฟังก์ชันระงับได้แล้ว รวม
room-ktxไว้ในการขึ้นต่อกันเพื่อใช้ประโยชน์จากฟังก์ชันนี้ อาร์ติแฟกต์ ktx ยังมีฟังก์ชันส่วนขยายRoomDatabase.withTransactionสำหรับทำธุรกรรมฐานข้อมูลภายใน Coroutine ด้วย - Auto Value: ตอนนี้ Room รองรับการประกาศคลาสที่มีคำอธิบายประกอบ AutoValue เป็นเอนทิตีและ POJO แล้ว ตอนนี้คุณสามารถประกาศคำอธิบายประกอบ Room
@PrimaryKey,@ColumnInfo,@Embeddedและ@Relationในเมธอดนามธรรมของคลาสที่มีคำอธิบายประกอบค่าอัตโนมัติได้แล้ว โปรดทราบว่าคำอธิบายประกอบเหล่านี้ต้องมาพร้อมกับ@CopyAnnotationsเพื่อให้ Room เข้าใจได้อย่างถูกต้อง - การรองรับ Async เพิ่มเติม: เมธอด DAO ที่มีคำอธิบายประกอบ
@Insert,@Deleteหรือ@Updateพร้อมกับ@Queryที่มีคำสั่งINSERT,DELETEหรือUPDATEตอนนี้รองรับประเภทการแสดงผล RxCompletable,Single,MaybeและประเภทการแสดงผลListenableFutureของ Guava และยังเป็นฟังก์ชัน Suspend ได้ด้วย enableMultiInstanceInvalidationเป็น API ใหม่ในRoomDatabase.Builderเพื่อเปิดใช้การทำให้เป็นโมฆะใน RoomDatabase หลายอินสแตนซ์โดยใช้ไฟล์ฐานข้อมูลเดียวกันfallbackToDestructiveMigrationOnDowngradeเป็น API ใหม่ในRoomDatabase.Builderเพื่อสร้างฐานข้อมูลใหม่โดยอัตโนมัติหากมีการดาวน์เกรดเกิดขึ้นignoredColumnsเป็น API ใหม่ในคำอธิบายประกอบ@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
การเปลี่ยนแปลง API/ลักษณะการทำงาน
- ฟังก์ชันส่วนขยาย
RoomDatabase.withTransactionมีการเปลี่ยนแปลงเป็นไม่ใช้บล็อกฟังก์ชันที่มีCoroutineScopeเป็นตัวรับอีกต่อไป วิธีนี้จะป้องกันไม่ให้ข้าม WrappercoroutineScope { }เพิ่มเติมที่จำเป็นสำหรับการเรียกใช้สิ่งต่างๆ ในบล็อกธุรกรรมพร้อมกัน
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ Room ไม่สามารถจับคู่ TypeConverter สำหรับฟังก์ชัน Kotlin DAO ที่มีพารามิเตอร์ประเภท Collection b/122066791
เวอร์ชัน 2.1.0-alpha06
22 มีนาคม 2019
การเปลี่ยนแปลง API/ลักษณะการทำงาน
- ตอนนี้การค้นหาธุรกรรมแบบไม่พร้อมกันจะได้รับการจัดเรียงเป็นอนุกรมเพื่อให้ Room ไม่ใช้มากกว่า 1 เทรดในการทำธุรกรรมฐานข้อมูล
เพิ่ม
RoomDatabase.Builder.setTransactionExecutor(Executor)เพื่ออนุญาตให้กำหนดค่าผู้ดำเนินการที่จะใช้สำหรับธุรกรรม RoomDatabase.runInTransaction(Callable)จะไม่รวมข้อยกเว้นที่ตรวจสอบแล้วไว้ใน RuntimeExceptions อีกต่อไป b/128623748
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่เครื่องมือติดตามการทำให้เป็นโมฆะหยุดสังเกตตารางเนื้อหาหากมีการเพิ่มผู้สังเกตการณ์สำหรับทั้งตารางเนื้อหาและตาราง FTS ของเนื้อหาภายนอก b/128508917
- อัปเดตไวยากรณ์ SQLite
Roomให้ตรงกับ SQLite 3.24.0 b/110883668
เวอร์ชัน 2.1.0-alpha05
13 มีนาคม 2019
ฟีเจอร์ใหม่
- ฟังก์ชันส่วนขยาย
RoomDatabase.withTransactionช่วยให้คุณทำธุรกรรมฐานข้อมูลภายใน Coroutine ได้อย่างปลอดภัย ฟังก์ชันส่วนขยาย Room พร้อมกับการรองรับ Coroutine มีอยู่ในอาร์ติแฟกต์room-ktx - เมธอด DAO ที่ไม่ใช่แบบนามธรรมซึ่งมีคำอธิบายประกอบด้วย
@Transactionจะเป็นฟังก์ชันระงับได้แล้ว b/120241587
การเปลี่ยนแปลง API/ลักษณะการทำงาน
- อาร์ติแฟกต์
room-coroutinesได้เปลี่ยนชื่อเป็นroom-ktxตามการตั้งชื่อเดียวกับอาร์ติแฟกต์ androidx อื่นๆ beginTransaction,setTransactionSuccessfulและendTransactionในRoomDatabaseเลิกใช้งานแล้วเพื่อใช้runInTransactionและฟังก์ชันส่วนขยายroom-ktxwithTransactionแทน
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่อาร์กิวเมนต์ของ Tokenizer ถูกทิ้งหาก Tokenizer ที่ใช้เป็น SIMPLE b/125427014
- แก้ไขข้อบกพร่องที่ทำให้ Room ไม่สามารถระบุฟังก์ชันการระงับได้อย่างถูกต้องด้วยพารามิเตอร์ที่มีประเภทเป็นคลาสภายใน b/123767877
- แก้ไขข้อบกพร่องที่เมธอด DAO ของ
@Queryที่เลื่อนเวลาออกไปซึ่งมีคำสั่งINSERT,UPDATEหรือDELETEเตรียมการค้นหาอย่างกระตือรือร้นในเทรดหลัก b/123695593 - แก้ไขข้อบกพร่องต่างๆ ที่ Room จะสร้างโค้ดที่ไม่ถูกต้องสำหรับฟังก์ชันระงับบางอย่าง b/123466702 และ b/123457323
- แก้ไขข้อบกพร่องที่ระบบไม่ได้ระงับการใช้งานเมธอดที่เลิกใช้งานแล้วอย่างถูกต้องในโค้ดที่สร้างขึ้น b/117602586
- อัปเดตทรัพยากร Dependency ของ Room ของ androidx.sqlite เป็น 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
ฟีเจอร์ใหม่
- ตอนนี้เมธอด DAO ที่มีคำอธิบายประกอบเป็น
@Queryซึ่งมีคำสั่งINSERT,UPDATEหรือDELETEสามารถแสดงผลประเภทไม่พร้อมกันSingle,Mayble,CompletableและListenableFutureได้แล้ว นอกจากนี้ยังสามารถเป็นฟังก์ชันระงับได้ด้วย b/120227284
การเปลี่ยนแปลง API/ลักษณะการทำงาน
- ตอนนี้ Room จะแสดงข้อผิดพลาดหากเมธอด DAO ที่ไม่ใช่แบบนามธรรมซึ่งมีคำอธิบายประกอบเป็น
@Transactionแสดงผลประเภทไม่พร้อมกัน เช่นSingle,Mayble,Completable,LiveDataหรือListenableFutureเนื่องจากธุรกรรมถูกจำกัดไว้ในเทรด ปัจจุบัน Room จึงไม่สามารถเริ่มและสิ้นสุดธุรกรรมเกี่ยวกับฟังก์ชันที่อาจทำการค้นหาในเทรดต่างๆ ได้ b/120109336 OnConflictStrategy.FAILและOnConflictStrategy.ROLLBACKได้รับการ@Deprecatedเนื่องจากไม่ได้ทำงานตามที่ตั้งใจไว้กับการเชื่อมโยง SQLite ปัจจุบันของ Android b/117266738
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ Room ไม่ใช้ TypeConverter ของประเภทการแสดงผลอย่างถูกต้องหากเมธอด DAO เป็นฟังก์ชันระงับ b/122988159
- แก้ไขข้อบกพร่องที่ Room ระบุฟังก์ชันการระงับที่รับค่ามาอย่างไม่ถูกต้องว่าเป็นแบบไม่ระงับ b/122902595
- แก้ไขข้อบกพร่องที่ Room สร้างโค้ดไม่ถูกต้องเมื่อช่อง
@Embeddedอยู่ในคลาสหลักและใช้ในคลาสย่อยหลายคลาส b/121099048 - แก้ไขปัญหาที่ฐานข้อมูลจะเกิดการเดดล็อกเมื่อเรียกใช้ฟังก์ชันระงับ DAO ระหว่าง
beginTransaction()และendTransaction()b/120854786
เวอร์ชัน 2.1.0-alpha03
4 ธันวาคม 2018
การเปลี่ยนแปลง API
- ตอนนี้ FTS
tokenizerใน@Fts3/@Fts4จะใช้สตริงแทน Enum ซึ่งจะช่วยให้ Room ใช้ Tokenizer ที่กำหนดเองได้ ระบบยังคงกำหนด Tokenizer ในตัวในFtsOptionsเป็นค่าคงที่สตริง b/119234881
ฟีเจอร์ใหม่
- Couroutines: ตอนนี้เมธอด DAO เป็นฟังก์ชันระงับได้แล้ว เราได้เปิดตัวอาร์ติแฟกต์ใหม่
room-coroutinesเพื่อรองรับฟังก์ชันระงับใน Room b/69474692 - ตอนนี้เมธอด DAO ที่มีคำอธิบายประกอบ
@Insert,@Deleteหรือ@UpdateรองรับListenableFutureเป็นประเภทการแสดงผลแล้ว b/119418331
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ Room พยายามค้นหาคอนสตรัคเตอร์ที่มีคอลัมน์ในพร็อพเพอร์ตี้
ignoredColumnsของ@Entityอย่างไม่ถูกต้อง b/119830714 - แก้ไขข้อบกพร่องที่ Room ไม่ทำเครื่องหมายพารามิเตอร์เมธอด DAO เป็น final ในการติดตั้งใช้งานที่สร้างขึ้น b/118015483
- แก้ไขข้อบกพร่องที่โปรเซสเซอร์
Roomขัดข้องเมื่อรายงานข้อผิดพลาดในการค้นหาที่มีสัญลักษณ์พิเศษ b/119520136 - แก้ไขข้อบกพร่องที่ Room จะปฏิเสธการใช้งาน
Collectionอื่นๆ เป็นอาร์กิวเมนต์ของนิพจน์INb/119884035 - แก้ไขข้อบกพร่องที่ LiveData ที่แสดงผลจาก Room จะถูกรวบรวมเป็นขยะเมื่อสังเกตเห็นตลอดไป ทำให้ไม่แสดงข้อมูลใหม่อีกต่อไป b/74477406
- อัปเดตการล็อกแบบปิดของ
RoomDatabaseเพื่อลดการช่วงชิงล็อก b/117900450
เวอร์ชัน 2.1.0-alpha02
30 ตุลาคม 2018
ฟีเจอร์ใหม่
- เพิ่มการรองรับการอ้างอิง
@DatabaseViewใน@Relationb/117680932
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ Room จะดำเนินการ I/O ของดิสก์ในเทรดหลักเมื่อสมัครใช้บริการและกำจัดจากประเภทการแสดงผล Rx b/117201279
- แก้ไขข้อบกพร่องที่ Room ไม่พบตัวแปลงประเภทที่เหมาะสมสำหรับช่องในคลาสเอนทิตี Kotlin b/111404868
- แก้ไขข้อบกพร่องที่ Room สร้างโค้ดที่ไม่ถูกต้องสำหรับการใช้งานอินเทอร์เฟซ
DAOที่มีเมธอดเริ่มต้นของ Kotlin ซึ่งไม่มีอาร์กิวเมนต์ b/117527454 - อัปเดตโปรแกรมแยกวิเคราะห์ไวยากรณ์ SQLite ของ
Roomเพื่อแก้ไขปัญหาด้านประสิทธิภาพที่ทำให้ใช้เวลาในการบิลด์นาน b/117401230
เวอร์ชัน 2.1.0-alpha01
8 ตุลาคม 2018
ฟีเจอร์ใหม่
- FTS: ตอนนี้ Room รองรับเอนทิตีที่มีตาราง FTS3 หรือ FTS4 ที่แมปแล้ว ตอนนี้คลาสที่มีคำอธิบายประกอบ
@Entityสามารถใส่คำอธิบายประกอบเพิ่มเติมด้วย@Fts3หรือ@Fts4เพื่อประกาศคลาสที่มีตารางการค้นหาข้อความแบบเต็มสำหรับการแมป ตัวเลือก FTS สำหรับการปรับแต่งเพิ่มเติมจะพร้อมใช้งานผ่านเมธอดของคำอธิบายประกอบ b/62356416 - มุมมอง: ตอนนี้ Room รองรับการประกาศคลาสเป็นคำค้นหาที่จัดเก็บไว้ หรือที่เรียกว่ามุมมองโดยใช้คำอธิบายประกอบ @DatabaseView b/67033276
- Auto Value: ตอนนี้ Room รองรับการประกาศคลาสที่มีคำอธิบายประกอบ AutoValue เป็นเอนทิตีและ POJO แล้ว ตอนนี้คุณสามารถประกาศคำอธิบายประกอบ Room
@PrimaryKey,@ColumnInfo,@Embeddedและ@Relationในเมธอดนามธรรมของคลาสที่มีคำอธิบายประกอบค่าอัตโนมัติได้แล้ว โปรดทราบว่าคำอธิบายประกอบเหล่านี้ต้องมาพร้อมกับ@CopyAnnotationsเพื่อให้ Room เข้าใจได้อย่างถูกต้อง b/62408420 - การรองรับประเภทการแสดงผล Rx เพิ่มเติม: ตอนนี้เมธอด DAO ที่มีคำอธิบายประกอบ
@Insert,@Deleteหรือ@Updateรองรับประเภทการแสดงผล RxCompletable,Single<T>และMaybe<T>แล้ว b/63317956 - ประเภทที่เปลี่ยนแปลงไม่ได้ด้วย
@Relation: ก่อนหน้านี้ Room กำหนดให้ช่องที่มีคำอธิบายประกอบ@Relationต้องตั้งค่าได้ แต่ตอนนี้สามารถเป็นพารามิเตอร์คอนสตรัคเตอร์ได้แล้ว enableMultiInstanceInvalidation: เป็น API ใหม่ในRoomDatabase.Builderเพื่อเปิดใช้การทำให้เป็นโมฆะใน RoomDatabase หลายอินสแตนซ์โดยใช้ไฟล์ฐานข้อมูลเดียวกัน กลไกการทำให้เป็นโมฆะแบบหลายอินสแตนซ์นี้ยังทำงานในหลายกระบวนการด้วย b/62334005fallbackToDestructiveMigrationOnDowngrade: เป็น API ใหม่ในRoomDatabase.Builderเพื่อสร้างฐานข้อมูลใหม่โดยอัตโนมัติหากมีการดาวน์เกรด b/110416954ignoredColumns: เป็น API ใหม่ในคำอธิบายประกอบ@Entityที่ใช้เพื่อแสดงรายการฟิลด์ที่ละเว้นตามชื่อได้ มีประโยชน์สำหรับการละเว้นฟิลด์ที่รับค่ามาในเอนทิตี b/63522075
การเปลี่ยนแปลง API/ลักษณะการทำงาน
mCallbackและmDatabaseในRoomDatabaseเปลี่ยนเป็น@Deprecatedแล้ว และจะถูกนำออกใน Room เวอร์ชันหลักถัดไป b/76109329
แก้ไขข้อบกพร่อง
- แก้ไขปัญหา 2 รายการที่ Room ไม่สามารถกู้คืนจากฐานข้อมูลที่เสียหายหรือการย้ายข้อมูลที่ไม่ถูกต้องระหว่างการเริ่มต้นได้อย่างถูกต้อง b/111504749 และ b/111519144
- ตอนนี้ Room จะใช้คอนสตรัคเตอร์หลักของ Kotlin ในคลาสข้อมูลอย่างถูกต้องเพื่อหลีกเลี่ยงความจำเป็นในการประกาศฟิลด์เป็น
varsb/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
การเปลี่ยนแปลง API/ลักษณะการทำงาน
- เพิ่ม
RoomDatabase.Builder.setQueryExecutor()เพื่อให้ปรับแต่งตำแหน่งที่เรียกใช้การค้นหาได้ - เพิ่มการรองรับ RxJava2
Observable - การติดตั้งใช้งาน DAO และฐานข้อมูลที่สร้างขึ้นถือเป็นที่สิ้นสุดแล้ว
แก้ไขข้อบกพร่อง
- ระบุชื่อคลาส/ฟิลด์ในข้อผิดพลาด "cannot find getter for field" b/73334503
- แก้ไขความเข้ากันได้แบบย้อนหลังของ RoomOpenHelper กับ Room เวอร์ชันเก่า b/110197391
ทรัพยากร Dependency ก่อน AndroidX
สำหรับ Room เวอร์ชันก่อน AndroidX ให้รวมทรัพยากร Dependency ต่อไปนี้
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
เราขอแนะนำอย่างยิ่งให้ใช้ Room 1.1.1-rc1 แทน 1.1.0 หากคุณใช้การย้ายข้อมูล
แก้ไขข้อบกพร่องที่ 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ซึ่งจะรีไซเคิลการค้นหาก่อนเวลาอันควร ทำให้เกิดปัญหาหากคุณเพิ่มผู้สังเกตการณ์มากกว่า 1 รายลงในอินสแตนซ์SingleหรือMaybeที่แสดงผล b/76031240[RoomDatabase.clearAllTables][ref-clearAllTables] จะไม่
VACUUMฐานข้อมูลหากมีการเรียกใช้ภายในธุรกรรม b/77235565
เวอร์ชัน 1.1.0-beta1
21 มีนาคม 2018
การเปลี่ยนแปลง API
- จากความคิดเห็นเกี่ยวกับการตรวจสอบ API
@RawQueryไม่ยอมรับการส่งStringเป็นพารามิเตอร์การค้นหาอีกต่อไป คุณต้องใช้ [SupportSQLiteQuery][ref-SupportSQLiteQuery] (ดู [SimpleSQLiteQuery][ref-SimpleSQLiteQuery] เพื่อสร้างอินสแตนซ์ของ [SupportSQLiteQuery][ref-SupportSQLiteQuery] ได้อย่างง่ายดายด้วยการรองรับอาร์กิวเมนต์) - ตอนนี้เมธอด [fallbackToDestructiveMigrationFrom][ref-fallbackToDestructiveMigrationFrom] ของ RoomDatabase.Builder ยอมรับ
vararg intแทนvararg Integerแล้ว
แก้ไขข้อบกพร่อง
- ตอนนี้ [RoomDatabase.clearAllTables][ref-clearAllTables] จะพยายามคืนพื้นที่ให้กับระบบปฏิบัติการโดยการตั้งค่าจุดตรวจสอบ WAL และ
VACUUMฐานข้อมูล - [
@RawQuery][ref-RawQuery] ตอนนี้ยอมรับ Pojo ใดๆ สำหรับพร็อพเพอร์ตี้observedEntitiesตราบใดที่ Pojo อ้างอิงไปยังเอนทิตีอย่างน้อย 1 รายการผ่านช่องEmbeddedหรือRelationb/74041772 - เพจจิ้ง: การติดตั้งใช้งาน DataSource ของ Room จัดการทรัพยากร Dependency แบบหลายตาราง (เช่น ความสัมพันธ์และการรวม) ได้อย่างถูกต้องแล้ว ก่อนหน้านี้ การดำเนินการเหล่านี้จะไม่สามารถทริกเกอร์ผลลัพธ์ใหม่หรือคอมไพล์ไม่สำเร็จ b/74128314
เวอร์ชัน 1.1.0-alpha1
22 มกราคม 2018
ฟีเจอร์ใหม่
RawQuery: API ใหม่นี้ช่วยให้เมธอด@Daoรับ SQL เป็นพารามิเตอร์การค้นหาได้ b/62103290, b/71458963fallBackToDestructiveMigrationsFrom: API ใหม่นี้ในRoomDatabase.Builderช่วยให้ควบคุมได้ละเอียดยิ่งขึ้นว่าอนุญาตให้ทำการย้ายข้อมูลแบบทำลายล้างจากเวอร์ชันสคีมาเริ่มต้นใด (เมื่อเทียบกับ fallbackToDestructiveMigration) b/64989640- ตอนนี้ Room รองรับเฉพาะ Paging API เวอร์ชันใหม่ (alpha-4 ขึ้นไป) และหยุดรองรับ
LivePagedListProviderที่เลิกใช้งานแล้ว หากต้องการใช้ Room เวอร์ชันอัลฟ่าใหม่ คุณจะต้องใช้การแบ่งหน้าalpha-4ขึ้นไป และเปลี่ยนจากLivePagedListProviderเป็นLivePagedListBuilderหากยังไม่ได้ดำเนินการ
แก้ไขข้อบกพร่อง
- ปรับปรุงการรองรับประเภท Kotlin Kapt b/69164099
- ลำดับของฟิลด์จะไม่ทำให้สคีมาไม่ถูกต้องอีกต่อไป b/64290754