ห้อง

ไลบรารี Room Persistence มีเลเยอร์นามธรรมเหนือ SQLite เพื่อให้เข้าถึงฐานข้อมูลได้อย่างมีประสิทธิภาพมากขึ้นพร้อมกับใช้ประโยชน์จาก SQLite ได้อย่างเต็มที่
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
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 โดยหลีกเลี่ยงการข้ามเทรดที่คงลักษณะการบล็อกแบบเดียวกับ API SupportSQLiteDatabase (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 เพื่อรับ Wrapper SupportSQLiteDatabase จาก 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

  • การนำคำอธิบายประกอบ @RequiresApi(21) ที่ล้าสมัยออก (Ic4792, I9103b)

แก้ไขข้อบกพร่อง

  • แก้ไขภาวะแข่งขันที่ Room Flows ไม่แสดงผลการค้นหาล่าสุดในสถานการณ์การค้นหา/เขียนหลายรายการแบบอะซิงโครนัส (Ic9a3c)

เวอร์ชัน 2.8.0-beta01

1 สิงหาคม 2025

androidx.room:room-*:2.8.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.8.0-beta01 มี คอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • ตอนนี้ชื่อตารางและมุมมองจะได้รับการหลีกเลี่ยงอย่างถูกต้องในระหว่างการย้ายข้อมูลแบบทำลายล้าง (9e55f8, b/427095319)

เวอร์ชัน 2.8.0-alpha01

16 กรกฎาคม 2025

androidx.room:room-*:2.8.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มอาร์ติแฟกต์ใหม่ androidx.room:room-sqlite-wrapper ซึ่งมี API เพื่อรับ Wrapper SupportSQLiteDatabase ของ 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() กลยุทธ์ใหม่มีดังนี้

  1. กำหนดออบเจ็กต์ที่คาดหวังซึ่งใช้ RoomDatabaseConstructor

      expect object MyDatabaseCtor : RoomDatabaseConstructor<MyDatabase>
    
  2. ลิงก์ออบเจ็กต์กับการประกาศ @Database โดยใช้ @ConstructedBy

      @Database(...)
      @ConstructedBy(MyDatabaseCtor::class) // NEW
      abstract class MyDatabase : RoomDatabase
    
  3. สร้างอินสแตนซ์ฐานข้อมูลใหม่โดยไม่ส่งอาร์กิวเมนต์ 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() ดูข้อมูลเพิ่มเติมเกี่ยวกับ SQLite Driver 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 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ตอนนี้ Room รองรับประเภทการแสดงผล Map ที่ซ้อนกันในฟังก์ชัน DAO แล้ว (I13f48, 203008711)

การเปลี่ยนแปลง 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 หรือ Coroutine Flow

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 ที่บางครั้งมีการเรียกใช้ Callback 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 มี 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: ตอนนี้เมธอด @Query DAO สามารถเป็นประเภทการแสดงผล 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: ตอนนี้เมธอด @Query DAO สามารถเป็นประเภทการแสดงผล 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 และ @Delete b/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 ตอนนี้รองรับประเภทการแสดงผล Rx Completable, 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 เป็นตัวรับอีกต่อไป วิธีนี้จะป้องกันไม่ให้ข้าม Wrapper coroutineScope { } เพิ่มเติมที่จำเป็นสำหรับการเรียกใช้สิ่งต่างๆ ในบล็อกธุรกรรมพร้อมกัน

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องที่ 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-ktx withTransaction แทน

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องที่อาร์กิวเมนต์ของ 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 อื่นๆ เป็นอาร์กิวเมนต์ของนิพจน์ IN b/119884035
  • แก้ไขข้อบกพร่องที่ LiveData ที่แสดงผลจาก Room จะถูกรวบรวมเป็นขยะเมื่อสังเกตเห็นตลอดไป ทำให้ไม่แสดงข้อมูลใหม่อีกต่อไป b/74477406
  • อัปเดตการล็อกแบบปิดของ RoomDatabase เพื่อลดการช่วงชิงล็อก b/117900450

เวอร์ชัน 2.1.0-alpha02

30 ตุลาคม 2018

ฟีเจอร์ใหม่

  • เพิ่มการรองรับการอ้างอิง @DatabaseView ใน @Relation b/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 รองรับประเภทการแสดงผล Rx Completable, Single<T> และ Maybe<T> แล้ว b/63317956
  • ประเภทที่เปลี่ยนแปลงไม่ได้ด้วย @Relation: ก่อนหน้านี้ Room กำหนดให้ช่องที่มีคำอธิบายประกอบ @Relation ต้องตั้งค่าได้ แต่ตอนนี้สามารถเป็นพารามิเตอร์คอนสตรัคเตอร์ได้แล้ว
  • enableMultiInstanceInvalidation: เป็น API ใหม่ใน RoomDatabase.Builder เพื่อเปิดใช้การทำให้เป็นโมฆะใน RoomDatabase หลายอินสแตนซ์โดยใช้ไฟล์ฐานข้อมูลเดียวกัน กลไกการทำให้เป็นโมฆะแบบหลายอินสแตนซ์นี้ยังทำงานในหลายกระบวนการด้วย b/62334005
  • fallbackToDestructiveMigrationOnDowngrade: เป็น API ใหม่ใน RoomDatabase.Builder เพื่อสร้างฐานข้อมูลใหม่โดยอัตโนมัติหากมีการดาวน์เกรด b/110416954
  • ignoredColumns: เป็น API ใหม่ในคำอธิบายประกอบ @Entity ที่ใช้เพื่อแสดงรายการฟิลด์ที่ละเว้นตามชื่อได้ มีประโยชน์สำหรับการละเว้นฟิลด์ที่รับค่ามาในเอนทิตี b/63522075

การเปลี่ยนแปลง API/ลักษณะการทำงาน

  • mCallback และ mDatabase ใน RoomDatabase เปลี่ยนเป็น @Deprecated แล้ว และจะถูกนำออกใน Room เวอร์ชันหลักถัดไป b/76109329

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหา 2 รายการที่ 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

การเปลี่ยนแปลง 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

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องที่สำคัญในการติดตั้งใช้งาน Room Rx Single และ 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 หรือ Relation b/74041772
  • เพจจิ้ง: การติดตั้งใช้งาน DataSource ของ Room จัดการทรัพยากร Dependency แบบหลายตาราง (เช่น ความสัมพันธ์และการรวม) ได้อย่างถูกต้องแล้ว ก่อนหน้านี้ การดำเนินการเหล่านี้จะไม่สามารถทริกเกอร์ผลลัพธ์ใหม่หรือคอมไพล์ไม่สำเร็จ b/74128314

เวอร์ชัน 1.1.0-alpha1

22 มกราคม 2018

ฟีเจอร์ใหม่

  • RawQuery: API ใหม่นี้ช่วยให้เมธอด @Dao รับ SQL เป็นพารามิเตอร์การค้นหาได้ b/62103290, b/71458963
  • fallBackToDestructiveMigrationsFrom: API ใหม่นี้ใน RoomDatabase.Builder ช่วยให้ควบคุมได้ละเอียดยิ่งขึ้นว่าอนุญาตให้ทำการย้ายข้อมูลแบบทำลายล้างจากเวอร์ชันสคีมาเริ่มต้นใด (เมื่อเทียบกับ fallbackToDestructiveMigration) b/64989640
  • ตอนนี้ Room รองรับเฉพาะ Paging API เวอร์ชันใหม่ (alpha-4 ขึ้นไป) และหยุดรองรับ LivePagedListProvider ที่เลิกใช้งานแล้ว หากต้องการใช้ Room เวอร์ชันอัลฟ่าใหม่ คุณจะต้องใช้การแบ่งหน้า alpha-4 ขึ้นไป และเปลี่ยนจาก LivePagedListProvider เป็น LivePagedListBuilder หากยังไม่ได้ดำเนินการ

แก้ไขข้อบกพร่อง

  • ปรับปรุงการรองรับประเภท Kotlin Kapt b/69164099
  • ลำดับของฟิลด์จะไม่ทำให้สคีมาไม่ถูกต้องอีกต่อไป b/64290754