Pomieszczenie

Biblioteka trwałości danych Room zapewnia warstwę abstrakcji nad SQLite, aby umożliwić bardziej niezawodny dostęp do bazy danych przy jednoczesnym wykorzystaniu pełnej mocy SQLite.
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja beta Wersja alfa
9 września 2026 r. 2.8.5 - - -

Deklarowanie zależności

Aby dodać zależność od Room, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w repozytorium Maven Google.

Zależności Room obejmują testowanie migracji Room i Room RxJava.

Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

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

Informacje o korzystaniu z wtyczki KAPT znajdziesz w dokumentacji KAPT.

Informacje o korzystaniu z wtyczki KSP znajdziesz w dokumentacji dotyczącej szybkiego startu KSP.

Informacje o korzystaniu z rozszerzeń Kotlin znajdziesz w dokumentacji ktx.

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opcjonalnie w przypadku bibliotek innych niż Android (czyli modułów Gradle tylko w języku Java lub Kotlin) możesz używać adnotacji Room, korzystając z androidx.room:room-common.

Konfigurowanie opcji kompilatora

Room ma te opcje procesora adnotacji.

room.schemaLocation directory
Umożliwia eksportowanie schematów baz danych do plików JSON w podanym katalogu. Więcej informacji znajdziesz w artykule Migracja sal.
room.incremental boolean
Włącza przyrostowy procesor adnotacji Gradle. Wartość domyślna to true.
room.generateKotlin boolean
Generuj pliki źródłowe Kotlin zamiast Java. Wymaga KSP. Wartość domyślna to true od wersji 2.7.0. Więcej informacji znajdziesz w informacjach o wersji 2.6.0, w której wprowadzono tę funkcję.

Korzystanie z wtyczki Room Gradle

W przypadku Room w wersji 2.6.0 lub nowszej możesz użyć wtyczki Room do obsługi Gradle, aby skonfigurować opcje kompilatora Room. Wtyczka konfiguruje projekt w taki sposób, że wygenerowane schematy (które są wynikiem zadań kompilacji i są używane do automatycznych migracji) są prawidłowo skonfigurowane, aby umożliwiać powtarzalne i możliwe do zapisania w pamięci podręcznej kompilacje.

Aby dodać wtyczkę, w pliku kompilacji Gradle najwyższego poziomu zdefiniuj wtyczkę i jej wersję.

Dynamiczny

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

Kotlin

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

W pliku kompilacji Gradle na poziomie modułu zastosuj wtyczkę i użyj rozszerzenia room.

Dynamiczny

plugins {
    id 'androidx.room'
}

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

Kotlin

plugins {
    id("androidx.room")
}

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

Ustawienie schemaDirectory jest wymagane, gdy używasz wtyczki Room Gradle. Spowoduje to skonfigurowanie kompilatora Room oraz różnych zadań kompilacji i ich backendów (javac, KAPT, KSP) do generowania plików schematu w folderach wersji, np. schemas/flavorOneDebug/com.package.MyDatabase/1.json. Te pliki powinny zostać przesłane do repozytorium, aby można było ich używać do weryfikacji i automatycznych migracji.

Niektórych opcji nie można skonfigurować we wszystkich wersjach wtyczki Room Gradle, mimo że są one obsługiwane przez kompilator Room. W tabeli poniżej znajdziesz listę wszystkich opcji i wersję wtyczki Room Gradle, która dodała obsługę konfigurowania tej opcji za pomocą rozszerzenia room. Jeśli masz starszą wersję lub ta opcja nie jest jeszcze obsługiwana, możesz użyć opcji procesora adnotacji.

Opcja Od wersji
room.schemaLocation (pole wymagane) 2.6.0
room.incremental -
room.generateKotlin -

Używanie opcji procesora adnotacji

Jeśli nie używasz wtyczki Room Gradle lub opcja, której chcesz użyć, nie jest obsługiwana przez Twoją wersję wtyczki, możesz skonfigurować Room za pomocą opcji procesora adnotacji, jak opisano w sekcji Dodawanie zależności kompilacji. Sposób określania opcji adnotacji zależy od tego, czy w przypadku Room używasz KSP czy KAPT.

Dynamiczny

// 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 jest katalogiem, a nie typem podstawowym, dlatego podczas dodawania tej opcji należy użyć CommandLineArgumentsProvider, aby Gradle wiedział o tym katalogu podczas sprawdzania aktualności. Migracja bazy danych Room pokazuje pełną implementację CommandLineArgumentsProvider, która udostępnia lokalizację schematu.

Prześlij opinię

Twoja opinia pomoże nam ulepszyć Jetpacka. Daj nam znać, jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki. Przed utworzeniem nowego problemu zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 2.8

Wersja 2.8.5

9 września 2026 r.

Publikacja androidx.room:room-*:2.8.5 Wersja 2.8.5 zawiera te zatwierdzenia.

Poprawki błędów

  • Zapytania zawieszające Room i operacje śledzenia unieważnienia będą teraz zgłaszać błąd IllegalStateException, gdy zostaną wywołane po zamknięciu bazy danych. (Ic0166, b/543076356)

Wersja 2.8.4

19 listopada 2025 r.

Publikacja androidx.room:room-*:2.8.4 Wersja 2.8.4 zawiera te zatwierdzenia.

Poprawki błędów

  • Dodaliśmy pamięć podręczną przygotowanych instrukcji do puli połączeń Room, gdy używasz SQLiteDriver, który nie ma wewnętrznej puli, np. BundledSQLiteDriver. Poprawia to wydajność podczas wielokrotnego wykonywania tej samej instrukcji SQL. (5f43bc, b/319653917)
  • Rozwiązaliśmy problem, który powodował, że w komunikacie o błędzie dotyczącym rzeczywistej/oczekiwanej wartości podczas weryfikacji schematu brakowało informacji. (8b23da, b/454531083)
  • Rozwiązaliśmy problem z generowaniem kodu Kotlin w Room, który nie zawierał funkcji DAO @Transaction ze zmiennymi typu. (a8365d, b/251316420)
  • Popraw wydajność kodu otaczającego SupportSQLite w Room, unikając przeskoków wątków i zachowując takie samo zachowanie blokowania jak w przypadku interfejsów API SupportSQLiteDatabase. (fc70e4)

Wersja 2.8.3

22 października 2025 r.

Publikacja androidx.room:room-*:2.8.3 Wersja 2.8.3 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem z wydajnością kodu Room SQLite Wrapper, który powodował nadmierne wywołania JNI i znaczne pogorszenie wydajności podczas iteracji po kursorze.

Wersja 2.8.2

8 października 2025 r.

Publikacja androidx.room:room-*:2.8.2 Wersja 2.8.2 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiono zakleszczenie, które mogło wystąpić podczas ponownego otwierania automatycznie zamkniętej bazy danych z emisji Flow (b/446643789).

Wersja 2.8.1

24 września 2025 r.

Publikacja androidx.room:room-*:2.8.1 Wersja 2.8.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiono błąd procesora, który występował podczas przetwarzania funkcji DAO z zawieszoną funkcją lambda. (b/442220723).
  • Naprawiono sytuację wyścigu, która uniemożliwiała przepływom otrzymywanie najnowszych aktualizacji.

Wersja 2.8.0

10 września 2025 r.

Publikacja androidx.room:room-*:2.8.0 Wersja 2.8.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.7.0:

  • Dodano nowy artefakt androidx.room:room-sqlite-wrapper, który zawiera interfejsy API do pobierania opakowania SupportSQLiteDatabase z RoomDatabase ze skonfigurowanym SQLiteDriver. Aby uzyskać kod, użyj nowej funkcji rozszerzenia RoomDatabase.getSupportWrapper(). Jest to artefakt zgodności, który pozwala zachować użycie SupportSQLiteDatabase, zwykle uzyskiwane z roomDatabase.openHelper.writableDatabase, nawet jeśli baza danych Room jest skonfigurowana z SQLiteDriver. Ta klasa otoki jest przydatna do stopniowej migracji baz kodu, które chcą korzystać z interfejsów API SQLiteDriver, ale mają rozległe zastosowania interfejsów API SupportSQLite, a jednocześnie chcą korzystać z BundledSQLiteDriver. Więcej informacji znajdziesz w przewodniku po migracji.
  • Dodaliśmy obsługę celów KMP w systemach Watch OS i Tv OS.
  • Zaktualizowano minimalną wersję pakietu SDK biblioteki na Androida z interfejsu API 21 do interfejsu API 23.

Wersja 2.8.0-rc02

27 sierpnia 2025 roku

Publikacja androidx.room:room-*:2.8.0-rc02 Wersja 2.8.0-rc02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Zaktualizowano minSDK z interfejsu API 21 do interfejsu API 23 (Ibdfca, b/380448311, b/435705964, b/435705223).
  • Zaktualizowano minimalną wersję wtyczki Androida do obsługi Gradle (AGP) zgodną z wtyczką Room do obsługi Gradle z 8.1 do 8.4. (Ia0d28)

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że migracja destrukcyjna była wykonywana nawet wtedy, gdy ścieżka migracji była dostępna dla gotowej bazy danych (b/432634197).

Wersja 2.8.0-rc01

13 sierpnia 2025 r.

Publikacja androidx.room:room-*:2.8.0-rc01 Wersja 2.8.0-rc01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Usuwanie nieaktualnych adnotacji @RequiresApi(21) (Ic4792, I9103b)

Poprawki błędów

  • Naprawiliśmy sytuację wyścigu, w której Room Flows nie emitował najnowszego wyniku zapytania w przypadku asynchronicznego zapisu lub wielu zapytań. (Ic9a3c)

Wersja 2.8.0-beta01

1 sierpnia 2025 r.

Publikacja androidx.room:room-*:2.8.0-beta01 Wersja 2.8.0-beta01 zawiera te zatwierdzenia.

Poprawki błędów

  • Nazwy tabel i widoków są teraz prawidłowo zastępowane podczas migracji destrukcyjnych. (9e55f8, b/427095319)

Wersja 2.8.0-alpha01

16 lipca 2025 r.

Publikacja androidx.room:room-*:2.8.0-alpha01 Wersja 2.8.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano nowy artefakt androidx.room:room-sqlite-wrapper, który zawiera interfejsy API do uzyskiwania opakowania SupportSQLiteDatabase klasy RoomDatabase ze skonfigurowanym SQLiteDriver. Aby uzyskać kod, użyj nowej funkcji rozszerzenia RoomDatabase.getSupportWrapper(). Jest to artefakt zgodności, który pozwala zachować użycie SupportSQLiteDatabase, zwykle uzyskiwane z RoomDatabase.openHelper.writableDatabase, nawet jeśli baza danych Room jest skonfigurowana z SQLiteDriver. Ten kod jest przydatny do stopniowej migracji baz kodu, które chcą przejść na SQLiteDriver, ale intensywnie korzystają z interfejsów API SupportSQLite, a jednocześnie chcą korzystać z BundledSQLiteDriver. (Icf6ac)
  • Dodano cele KMP dla systemów Watch OS i TV OS (I228f6, b/394238801).

Poprawki błędów

  • Naprawiliśmy błąd, który mógł czasami powodować zakleszczenie podczas korzystania z transakcji zawieszających i AndroidSQLiteDriver. (b/415006268)

Wersja 2.7

Wersja 2.7.2

18 czerwca 2025 r.

Publikacja androidx.room:room-*:2.7.2 Wersja 2.7.2 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że wartości adnotacji były nieprawidłowo odczytywane podczas przetwarzania źródeł natywnych za pomocą KSP, co czasami powodowało brak eksportu schematu. (b/416549580)
  • Naprawiliśmy błąd, który powodował, że komentarze na początku kodu SQL powodowały wykonywanie instrukcji tak, jakby były zapytaniami nieodczytywanymi. (b/413061402)
  • Rozwiązaliśmy problem z błędem konfiguracji wtyczki Gradle Room, który występował, gdy katalog schematu był pusty. (b/417823384)
  • Gdy uzyskanie połączenia trwa zbyt długo, nie jest już zgłaszany błąd SQLiteException. Zamiast tego biblioteka wysyła komunikat logu. Rejestrowanie zamiast zgłaszania błędów pozwala obejść problem z zawieszaniem pętli przez iOS, co powoduje, że Room błędnie interpretuje czas oczekiwania w przypadku współprogramu Kotlin, który uzyskuje połączenie. Zapobiega to zgłaszaniu wyjątku, gdy aplikacja na iOS działa w tle, a następnie zostaje wznowiona w trakcie operacji na bazie danych. (b/422448815)

Wersja 2.7.1

23 kwietnia 2025 r.

Publikacja androidx.room:room-*:2.7.1 Wersja 2.7.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiono błąd IndexOutOfBoundsException podczas weryfikacji podanego konwertera typów. (b/409804755).
  • Obsługa RoomDatabase.runInTransaction(), gdy SQLiteDriver jest skonfigurowany z salą. (b/408364828).

Wersja 2.7.0

9 kwietnia 2025 r.

Publikacja androidx.room:room-*:2.7.0 Wersja 2.7.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.6.0

  • Obsługa Kotlin Multiplatform (KMP): w tej wersji Room został przekształcony w bibliotekę Kotlin Multiplatform (KMP). Obecnie obsługiwane platformy to Android, iOS, JVM (komputer), natywny Mac i natywny Linux. Więcej informacji o tym, jak zacząć korzystać z Room KMP, znajdziesz w oficjalnej dokumentacji Room KMP. W ramach obsługi KMP Room można też skonfigurować za pomocą SQLiteDriver. Informacje o tym, jak przenieść istniejącą aplikację do interfejsów API sterowników i Room KMP, znajdziesz w dokumentacji dotyczącej migracji.
  • Generowanie kodu Kotlin w KSP jest domyślnie włączone, jeśli przetwarzanie odbywa się za pomocą KSP. W przypadku projektów korzystających tylko z KAPT lub Javy Room nadal będzie generować źródła Javy.
  • Kotlin 2.0 i KSP2: Room jest teraz przeznaczony dla języka Kotlin 2.0 i wymaga, aby projekty były kompilowane w Kotlinie 2.0 lub jego odpowiedniku albo nowszej wersji. Dodaliśmy też obsługę KSP2, która jest zalecana, gdy używasz Room z Kotlinem 2.0 lub nowszym.

Wersja 2.7.0-rc03

26 marca 2025 r.

Publikacja androidx.room:room-*:2.7.0-rc03 Wersja 2.7.0-rc03 zawiera te zatwierdzenia.

Poprawki błędów

  • Nie zgłaszaj już błędu InterruptedException, gdy wątek zostanie przerwany podczas wykonywania interfejsów API blokujących Room, w tym blokujących funkcji DAO (b/400584611).
  • Ponownie zaimplementowano pulę połączeń Room, aby spróbować rozwiązać problem SQLException: Error code: 5, message: Timed out attempting to acquire a reader connection. i podobne (b/380088809).

Wersja 2.7.0-rc02

12 marca 2025 r.

Publikacja androidx.room:room-*:2.7.0-rc02 Wersja 2.7.0-rc02 zawiera te commity.

Poprawki błędów

  • Naprawiono błąd, który powodował, że automatyczne migracje nieprawidłowo obsługiwały nową kolumnę w tabeli FTS. (b/348227770, Ic53f3)
  • Naprawiono błąd powodujący awarię kompilatora Room z powodu błędu NullPointerException podczas przetwarzania źródeł innych niż JVM za pomocą KSP. (b/396607230, I693c9)
  • Rozwiązaliśmy problem, który powodował, że Room nie unieważniał tabel po zakończeniu korzystania z połączenia zapisu. (b/340606803, I73ef6)

Wersja 2.7.0-rc01

26 lutego 2025 r.

Publikacja androidx.room:room-*:2.7.0-rc01 Wersja 2.7.0-rc01 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że Room nie ustawiał busy_timeout w początkowym połączeniu z bazą danych, co prowadziło do problemów z SQLException: Error code: 5, message: database is locked (I93208, b/380088809).
  • Naprawiliśmy błąd w kompilatorze Room, który powodował awarię procesora KSP podczas przetwarzania natywnych zbiorów źródeł (np. iOS) w Kotlin 2.1.x i KSP1 (I883b8, b/396607230).

Wersja 2.7.0-beta01

12 lutego 2025 r.

Publikacja androidx.room:room-*:2.7.0-beta01 Wersja 2.7.0-beta01 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem z RoomDatabase.inTransaction(), który powodował otwieranie zamkniętej bazy danych, gdy nie powinno to mieć miejsca, i powinien szybko zwracać wartość false, jeśli baza danych jest zamknięta (b/325432967).
  • Naprawiono błąd (IllegalArgumentException: not a valid name) powodujący awarię kompilatora Room podczas przetwarzania funkcji DAO z klasami inline/value w Kotlinie (b/388299754).
  • Dołącz reguły Proguard do artefaktu JVM room-runtime, aby domyślny konstruktor wygenerowanej implementacji bazy danych nie został usunięty, ponieważ jest używany przez domyślną inicjalizację Room, która korzysta z refleksji (b/392657750).

Wersja 2.7.0-alpha13

29 stycznia 2025 r.

Publikacja androidx.room:room-*:2.7.0-alpha13 Wersja 2.7.0-alpha13 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Room jest teraz przeznaczony do języka Kotlin 2.0 i wymaga, aby projekty były kompilowane za pomocą języka Kotlin 2.0 i jego odpowiednika lub nowszej wersji. (I8efb0, b/315461431, b/384600605)

Poprawki błędów

  • Rozwiązaliśmy problem w konstruktorze bazy danych Room KMP, który występował, gdy na Androidzie użyto prostej nazwy zamiast ścieżki, a rozpoznana ścieżka pliku bazy danych nie znajdowała się w katalogu danych aplikacji. (I83315, b/377830104)
  • Rozwiązaliśmy problem z wtyczką Room Gradle, w przypadku którego konfigurowanie danych wejściowych i wyjściowych schematu powodowało błąd w projektach aplikacji na Androida: property 'inputDirectory' is final and cannot be changed any further. (1dbb4c, b/376071291).
  • Dodano obsługę KSP2 we wtyczce Room Gradle, co rozwiązuje problem polegający na tym, że katalog schematu nie był prawidłowo konfigurowany przez wtyczkę. (Iec3c4, b/379159770)

Zewnętrzny wkład

  • Rozwiązaliśmy problem z integracją stronicowania Room, który powodował przeskakiwanie interfejsu, gdy początkowy klucz do odświeżenia znajdował się zbyt blisko końca listy. Dziękujemy Ewie. (I2abbe, b/389729367)

Wersja 2.7.0-alpha12

11 grudnia 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha12 Wersja 2.7.0-alpha12 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaj eksperymentalny interfejs API RoomDatabase.Builder.setInMemoryTrackingMode(), aby określić, czy Room będzie używać tabeli w pamięci do śledzenia unieważnienia. (I2a9b2, b/185414040)

Poprawki błędów

  • Migracje destrukcyjne usuwają teraz widoki, aby zapewnić ich ponowne utworzenie, co pozwala dostosować działanie, gdy opcja allowDestructiveMigrationForAllTables jest włączona (domyślne ustawienie KMP), do dotychczasowego działania, gdy jest wyłączona. (0a3e83, b/381518941)

Wersja 2.7.0-alpha11

30 października 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha11 Wersja 2.7.0-alpha11 zawiera te zmiany.

Zmiany w interfejsie API

  • Zmień sygnaturę nowo dodanej metody convertRows(), aby była funkcją zawieszenia, która otrzymuje RawRoomQuery na potrzeby stronicowania w Room. (Ie57b5, b/369136627)

Poprawki błędów

  • Rozwiązaliśmy problem ze stronicowaniem w Room, który powodował generowanie nieprawidłowego kodu, gdy używano @Relation w połączeniu z PagingSource.

Wersja 2.7.0-alpha10

16 października 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha10 Wersja 2.7.0-alpha10 zawiera te zmiany.

Zmiany w interfejsie API

  • Utwórz wewnętrzną klasę ByteArrayWrapper, aby obsługiwać relacje z ByteBuffer na platformach innych niż Android i JVM. (I75543, b/367205685)
  • Dodaj SQLiteStatement.getColumnType() wraz z różnymi stałymi wyników SQLITE_DATA_*, aby umożliwić pobieranie typu danych kolumny. (I1985c, b/369636251)

Wersja 2.7.0-alpha09

2 października 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha09 Wersja 2.7.0-alpha09 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem z implementacją KMP interfejsu room-paging, który powodował błąd Error code: 8, message: attempt to write a readonly database z powodu rozpoczęcia transakcji zapisu w połączeniu do odczytu. (b/368380988)

Wersja 2.7.0-alpha08

18 września 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha08 Wersja 2.7.0-alpha08 zawiera te zmiany.

Nowe funkcje

  • Artefakty room-paging zostały przeniesione, aby były zgodne z KMP. (Ib8756, b/339934824)
  • Interfejs API invalidationTrackerFlow() został ujednolicony jako interfejs API własny InvalidationTracker.createFlow() i już jest dostępny dla zbiorów źródeł innych niż Android w projektach KMP. (I1fbfa, (I8fb29), b/329291639, b/329315924)

Zmiany w interfejsie API

  • Wszystkie ostrzeżenia i komunikaty o błędach w Room, które zawierają słowo Cursor, zostały usunięte lub zastąpione, ponieważ Cursor nie jest już dokładnym ogólnym terminem do użycia w wersji KMP Room. (Id8cd9, b/334087492)

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że Room KMP próbował emitować kod za pomocą UUID na platformach innych niż JVM. (b/362994709)
  • Rozwiązaliśmy problem z wtyczką Room Gradle, który powodował błąd „Nie można zmienić atrybutów konfiguracji… po zablokowaniu jej na potrzeby mutacji” podczas używania w projekcie KMP z Compose Multiplatform. (b/343408758)

Wersja 2.7.0-alpha07

21 sierpnia 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha07 Wersja 2.7.0-alpha07 zawiera te zmiany.

Nowe funkcje

  • Wtyczka Room Gradle będzie teraz automatycznie dodawać wyeksportowane schematy do źródeł zasobów testu z instrumentacją Androida, aby mogły być używane przez MigrationTestHelper.

Poprawki błędów

  • Rozwiązaliśmy problem z wygenerowaną funkcją „actual” w RoomDatabaseConstructor, w której brakowało modyfikatora „actual” w funkcji initialize, jeśli ta funkcja została również zastąpiona w deklaracji „expect”. (359631627)
  • Rozwiązaliśmy problem polegający na tym, że wygenerowana deklaracja „actual” elementu RoomDatabaseConstructor nie odpowiadała widoczności deklaracji „expect”. (358138953)

Wersja 2.7.0-alpha06

7 sierpnia 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha06 Wersja 2.7.0-alpha06 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Zmień konfigurację instancji RoomDatabase w projekcie KMP.

Ze względu na model kompilacji Kotlin 2.0 strategia odwoływania się do funkcji, która ma zostać wygenerowana, o nazwie instantiateImpl() nie jest już możliwa. Wprowadzono 2 nowe interfejsy API, @ConstructedBy i RoomDatabaseConstructor, które zastępują strategię instantiateImpl(). Nowa strategia wygląda tak:

  1. Zdefiniuj obiekt expect, który implementuje RoomDatabaseConstructor

      expect object MyDatabaseCtor : RoomDatabaseConstructor<MyDatabase>
    
  2. Połącz obiekt z deklaracją @Database za pomocą @ConstructedBy

      @Database(...)
      @ConstructedBy(MyDatabaseCtor::class) // NEW
      abstract class MyDatabase : RoomDatabase
    
  3. Utwórz nową instancję bazy danych, ale bez przekazywania argumentu fabryki.

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

Rozwiązuje problemy b/316978491, b/338446862 i b/342905180.

  • Obsługa @RawQuery w Room KMP przez dodanie nowego interfejsu API o nazwie RoomRawQuery, który jest podobny do SupportSQLiteQuery pod względem przechowywania nieprzetworzonego ciągu SQL i funkcji wiązania argumentów z instrukcją. Funkcje z adnotacją @RawQuery mogą teraz przyjmować RoomRawQuery jako jedyny parametr. (Iea844, b/330586815)
  • Dodaj przeciążenie metody setQueryCallback(), która akceptuje CoroutineContext. (Id66ff, b/309996304)
  • Dodano obsługę platform docelowych Kotlin Multiplatform linuxArm64 (I139d3, b/338268719).

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że Room nieprawidłowo generował wywołanie recursiveFetchArrayMap w przypadku środowisk docelowych innych niż Android. (710c36, b/352482325)
  • Naprawiliśmy błąd, który powodował, że Room czasami zgłaszał wyjątek „Przekroczono limit czasu próby połączenia” w projekcie KMP. (fa72d0, b/347737870)
  • Rozwiązaliśmy problem z automatycznymi migracjami, który powodował zbyt wczesne sprawdzanie kluczy obcych, zanim inne tabele zmieniły swoje schematy, aby dostosować się do nowych kluczy obcych. (7672c0, b/352085724)

Wersja 2.7.0-alpha05

10 lipca 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha05 Wersja 2.7.0-alpha05 zawiera te commity.

Zmiany w interfejsie API

  • Zmieniono nazwę SQLiteKt na SQLite i BundledSQLiteKt na BundledSQLite. (I8b501)

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że podczas korzystania z AndroidSQLiteDriver RoomDatabase ulegał zakleszczeniu lub wyświetlał błąd z powodu przekroczenia limitu czasu połączenia.

Wersja 2.7.0-alpha04

12 czerwca 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha04 Wersja 2.7.0-alpha04 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że procesor adnotacji Room generował niezgodny kod KMP, gdy w DAO zdefiniowano zwracany typ multimapy. (b/340983093)
  • Rozwiązaliśmy problem, który powodował, że Room nie mógł znaleźć wygenerowanej implementacji bazy danych, jeśli klasa z adnotacją @Database nie miała pakietu. (b/342097292)
  • Rozwiązaliśmy problem, który powodował, że włączenie automatycznego zamykania i unieważniania w trybie podzielonym czasami powodowało błąd ConcurrentModificationException, gdy baza danych była automatycznie zamykana z powodu bezczynności.

Wersja 2.7.0-alpha03

29 maja 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha03 Wersja 2.7.0-alpha03 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy różne problemy związane z Kotlinem 2.0 i KSP 2.0. Pamiętaj, że Kotlin 2.0 z obsługą KSP 2 nie jest jeszcze gotowy, a zespół pracuje nad różnymi interfejsami API i zmianami zachowania w nowym kompilatorze. (b/314151707)

Wersja 2.7.0-alpha02

14 maja 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha02 Wersja 2.7.0-alpha02 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy różne problemy z KSP.

Wersja 2.7.0-alpha01

1 maja 2024 r.

Publikacja androidx.room:room-*:2.7.0-alpha01 Wersja 2.7.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Obsługa Kotlin Multiplatform (KMP): w tej wersji Room został przekształcony w bibliotekę Kotlin Multiplatform (KMP). Chociaż nadal jest jeszcze trochę do zrobienia, ta wersja wprowadza nową wersję Room, w której większość funkcji została „ujednolicona” (dostosowana do wielu platform). Obecnie obsługiwane platformy to Android, iOS, JVM (komputer), natywny Mac i natywny Linux. Wszystkie brakujące funkcje na nowo obsługiwanych platformach zostaną dodane w nadchodzących wersjach Room.

Więcej informacji o tym, jak zacząć korzystać z Room KMP, znajdziesz w oficjalnej dokumentacji Room KMP.

  • Generowanie kodu Kotlin w KSP jest domyślnie włączone, jeśli przetwarzanie odbywa się za pomocą KSP. W przypadku projektów korzystających tylko z KAPT lub Javy Room nadal będzie generować źródła Javy.

Zmiany w interfejsie API

  • Dodano przeciążenie funkcji Room.databaseBuilder(), które przyjmuje parametr lambda przeznaczony do użycia z funkcją wygenerowaną przez Room, aby uniknąć używania refleksji podczas tworzenia instancji wygenerowanej implementacji RoomDatabase. Przykład użycia:
Room.databaseBuilder<MyDatabase>(
    context = appContext,
    name = dbFilePath,
    factory =  { MyDatabase::class.instantiateImpl() }
)
  • Do kreatora dodano interfejs API do konfigurowania pokoju z CoroutineContext: RoomDatabase.Builder.setQueryCoroutineContext. Pamiętaj, że obiekt RoomDatabase można skonfigurować tylko za pomocą wykonawców korzystających z setQueryExecutor lub kontekstu współprogramu, ale nie obu tych elementów.
  • Dodano interfejs API do konfigurowania pokoju ze sterownikiem SQLite: RoomDatabase.Builder.setDriver(). Więcej informacji o interfejsie SQLite Driver API znajdziesz w dokumentacji SQLite KMP.
  • Dodano interfejsy API umożliwiające dostęp do bazowego elementu SQLiteConnection z interfejsów API sterownika: RoomDatabase.useReaderConnection i RoomDatabase.useWriterConnection.
  • Różne wywołania zwrotne związane z pokojem mają teraz przeciążoną wersję, która otrzymuje SQLiteConnection zamiast SupportSQLiteDatabase. Te wartości mają zostać zastąpione podczas migracji do projektu KMP. Więcej informacji o migracji zastosowań Room w aplikacji na Androida do wspólnego modułu KMP znajdziesz w przewodniku po migracji. Wywołania zwrotne:
    • Migration.migrate(SQLiteConnection)
    • AutoMigrationSpec.onPostMigrate(SQLiteConnection)
    • RoomDatabase.Callback.onCreate(SQLiteConnection)
    • RoomDatabase.Callback.onDestructiveMigration(SQLiteConnection)
    • RoomDatabase.Callback.onOpen(SQLiteConnection)
  • Artefakt KTX androidx.room:room-ktx został scalony z artefaktem androidx.room:room-runtime wraz ze wszystkimi interfejsami API. Artefakt jest teraz pusty. Usuń go z listy zależności.

Wersja 2.6

Wersja 2.6.1

29 listopada 2023 r.

Publikacja androidx.room:room-*:2.6.1 Wersja 2.6.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem w wygenerowanym kodzie, który powodował, że domyślna wartość kolumn Double w EntityCursorConverter była ustawiana na 0 zamiast na 0.0. Dodaliśmy też potencjalne rozwiązanie podobnego problemu w przypadku kolumn typu Float. (Id75f5, b/304584179)
  • Wyjątki zgłaszane podczas wczytywania PagingSource będą teraz propagowane jako LoadStateUpdate z LoadResult.Error zawierającym obiekt Throwable. Ten stan błędu można zaobserwować w PagingDataAdapter.loadStateFlow(Views) lub LazyPagingItems.loadState(Compose). Pamiętaj, że oznacza to zmianę zachowania, ponieważ w przeszłości błędy wczytywania były zgłaszane jako wyjątek przez metodę DAO, która wywołała wczytywanie. (I93887, b/302708983)

Wersja 2.6.0

18 października 2023 r.

Publikacja androidx.room:room-*:2.6.0 Wersja 2.6.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.5.0

  • Opcja włączenia generowania kodu Kotlin (lub „Kotlin CodeGen”) jest już dostępna w Room KSP. (4297ec0). Aby włączyć Kotlin CodeGen w Room, dodaj nazwę opcji room.generateKotlin do opcji procesora dla KSP. Więcej informacji o przekazywaniu opcji procesora do KSP znajdziesz w dokumentacji KSP.

Uwaga: podczas korzystania z Kotlin CodeGen należy pamiętać o dodatkowych ograniczeniach. Właściwości abstrakcyjne jako metody pobierające DAO lub zapytania DAO w Kotlin CodeGen są niedozwolone. Zamiast tego powinny być zapisywane jako funkcje, aby uniknąć błędnego przekonania, że wartość właściwości jest niezmienna i ma stały zapisany wynik. Dodano też kolejne ograniczenie: w Room dla Kotlin CodeGen nie są już dozwolone zwracane typy kolekcji Nullable.

Ostrzeżenie: podczas korzystania z Kotlin CodeGen projekty mogą być bardziej rygorystyczne pod względem dopuszczalności wartości null. W Kotlin CodeGen dopuszczalność wartości null w argumentach typu jest ważna, podczas gdy w języku Java jest ona zwykle ignorowana. Załóżmy na przykład, że masz zwracany typ `Flow<foo\>`, a tabela jest pusta. W przypadku Java CodeGen nie spowoduje to żadnych problemów, ale w Kotlin CodeGen wystąpi błąd. Aby tego uniknąć, musisz użyć `Flow<foo?\>`, zakładając, że emitowana jest wartość null. </foo?\></foo\>

  • Do Room dodano nowy artefakt wtyczki Room do obsługi Gradle o identyfikatorze androidx.room, który rozwiązuje różne problemy z danymi wejściowymi i wyjściowymi schematów za pomocą opcji procesora adnotacji Gradle. Więcej informacji znajdziesz w informacjach o wersji Room 2.6.0-alpha02.
  • Klasy wartości w obiektach Room są teraz obsługiwane w przypadku KSP. (4194095)
  • Zagnieżdżone zwracane typy map w funkcjach DAO są teraz obsługiwane w Room. (I13f48, 203008711)

Wersja 2.6.0-rc01

20 września 2023 r.

Publikacja androidx.room:room-*:2.6.0-rc01 Wersja 2.6.0-rc01 zawiera te zatwierdzenia.

Wersja 2.6.0-beta01

23 sierpnia 2023 r.

Publikacja androidx.room:room-*:2.6.0-beta01 Wersja 2.6.0-beta01 zawiera te zatwierdzenia.

Poprawki błędów

  • Obsługa wyjątku SQLite w przypadku specjalnym podczas operacji upsert. Gdy podczas operacji upsert zostanie zgłoszony wyjątek 2067 SQLITE_CONSTRAINT_UNIQUE, operacja upsert powinna wykonać aktualizację. (If2849, b/243039555)

Wersja 2.6.0-alpha03

9 sierpnia 2023 r.

Publikacja androidx.room:room-*:2.6.0-alpha03 Wersja 2.6.0-alpha03 zawiera te zatwierdzenia.

Nowe funkcje

  • Zagnieżdżone zwracane typy map w funkcjach DAO są teraz obsługiwane w Room. (I13f48, 203008711)

Zmiany w interfejsie API

  • Utworzono nową adnotację typu o nazwie @MapColumn, która zastąpi wycofaną adnotację @MapInfo. W przypadku każdej nazwy kolumny (keyColumnName, valueColumnName lub obu) podanej w adnotacji @MapInfo musisz zadeklarować adnotację @MapColumn z samym columnName i użyć jej w odpowiednim argumencie typu, do którego się odwołujesz (klucz lub wartość mapy), w zwracanym typie funkcji DAO. Dzieje się tak, ponieważ adnotacja @MapColumn jest używana bezpośrednio w argumencie typu w zwracanym typie funkcji DAO, a nie w samej funkcji, jak @MapInfo. Więcej informacji znajdziesz w dokumentacji @MapColumn. (Ib0305, b/203008711)
  • thought Zaktualizowano pliki interfejsu API, aby dodać adnotacje dotyczące pomijania zgodności (I8e87a, b/287516207).
  • Interfejsy API wtyczki Room Gradle zostały zaktualizowane, aby nie zawsze wymagały konfiguracji dla poszczególnych wariantów. Oznacza to, że wtyczka może akceptować globalną lokalizację dla wszystkich wariantów bez tworzenia wielu katalogów, co umożliwia płynniejsze migracje, ale jest też wystarczająco elastyczna, aby ręcznie konfigurować wersje lub schematy typów kompilacji, zachowując jednocześnie zalety wtyczki (powtarzalne i możliwe do zapisania w pamięci podręcznej kompilacje). (I09d6f, b/278266663)

Poprawki błędów

  • Naprawiono potencjalną lukę w zabezpieczeniach związaną z wyciekiem pamięci w QueryInterceptorStatement. (I193d1)
  • Naprawiliśmy nieprawidłowe działanie funkcji QueryInterceptorDatabase execSQL(). (Iefdc8)

Wersja 2.6.0-alpha02

21 czerwca 2023 r.

Publikacja androidx.room:room-*:2.6.0-alpha02 Wersja 2.6.0-alpha02 zawiera te zatwierdzenia.

Wtyczka Gradle do Room

Ta nowa wersja zawiera nowy artefakt wtyczki Room do obsługi Gradle o identyfikatorze androidx.room, który rozwiązuje różne istniejące problemy w Room dotyczące danych wejściowych i wyjściowych schematów za pomocą opcji procesora adnotacji Gradle. Wtyczka Room Gradle konfiguruje projekt w taki sposób, aby wygenerowane schematy, które są używane do automatycznych migracji i są wynikiem zadań kompilacji, były prawidłowo skonfigurowane pod kątem powtarzalnych i możliwych do zapisania w pamięci podręcznej kompilacji. Wtyczka udostępnia DSL do konfigurowania lokalizacji schematu podstawowego:

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

Wtyczka skonfiguruje kompilator Room oraz różne zadania kompilacji i ich backendy (javac, KAPT, KSP), aby pliki schematu były zapisywane w folderach wersji, np. schemas/flavorOneDebug/com.package.MyDatabase/1.json. Jak zwykle te pliki są przesyłane do repozytorium, aby można było ich używać do weryfikacji i automatycznej migracji. Po przejściu na korzystanie z wtyczki zamiast opcji procesora adnotacji istniejące pliki schematu należy skopiować do wygenerowanych przez wtyczkę katalogów wersji. Jest to jednorazowa operacja migracji, którą należy wykonać ręcznie. Dokumentacja schematu na stronie developers.android.com zostanie zaktualizowana w przyszłości, gdy uwzględnimy opinie i wtyczka osiągnie stabilną wersję. Zachęcamy do jej wypróbowania.

Zmiany w interfejsie API

  • Interfejs RoomDatabase.QueryCallback został zdefiniowany jako interfejs funkcjonalny, aby umożliwić konwersje SAM. (Iab8ea, b/281008549)

Poprawki błędów

  • Rozwiązaliśmy problem, który występował podczas tworzenia instancji bazy danych w Robolectric po migracji źródeł Room z Javy do Kotlina. (Ic053c, b/274924903)

Wersja 2.6.0-alpha01

22 marca 2023 r.

Publikacja androidx.room:room-*:2.6.0-alpha01 Wersja 2.6.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Obsługa klas wartości w Room dla KSP. Room obsługuje teraz klasy wartości w encjach. (4194095)
  • W Room można teraz włączyć generowanie kodu w języku Kotlin (lub „Kotlin CodeGen”) (4297ec0). Aby włączyć Kotlin CodeGen w Room, dodaj nazwę opcji room.generateKotlin do opcji procesora dla KSP. Więcej informacji o przekazywaniu opcji procesora do KSP znajdziesz w dokumentacji KSP.

Uwaga: podczas korzystania z Kotlin CodeGen należy pamiętać o dodatkowych ograniczeniach. Właściwości abstrakcyjne jako metody pobierające DAO lub zapytania DAO w Kotlin CodeGen są niedozwolone. Zamiast tego powinny być zapisywane jako funkcje, aby uniknąć błędnego przekonania, że wartość właściwości jest niezmienna i ma stały zapisany wynik. Dodano też kolejne ograniczenie: w Room dla Kotlin CodeGen nie są już dozwolone zwracane typy kolekcji Nullable.

Ostrzeżenie: podczas korzystania z Kotlin CodeGen projekty mogą być bardziej rygorystyczne pod względem dopuszczalności wartości null. W Kotlin CodeGen dopuszczalność wartości null w argumentach typu jest ważna, podczas gdy w języku Java jest ona zwykle ignorowana. Załóżmy na przykład, że masz zwracany typ `Flow<foo\>`, a tabela jest pusta. W przypadku Java CodeGen nie spowoduje to żadnych problemów, ale w Kotlin CodeGen wystąpi błąd. Aby tego uniknąć, musisz użyć `Flow<foo?\>`, zakładając, że emitowana jest wartość null. </foo?\></foo\>

Zmiany w interfejsie API

  • Ochrona przed bezsensownym użyciem kolekcji z możliwością wartości null w zwracanych typach metod DAO. (I777dc, b/253271782, b/259426907)
  • Dodano interfejs API do tworzenia przepływu, który emituje zmiany śledzenia unieważnienia. Interfejs API jest przydatny do tworzenia strumieni, które muszą reagować na zmiany w bazie danych. (I8c790, b/252899305)

Poprawki błędów

  • Zabroniono używania właściwości abstrakcyjnych jako metod pobierających DAO lub zapytań DAO w generatorze kodu Kotlin. Zamiast tego należy je przepisać jako funkcje, aby uniknąć błędnego przekonania, że wartość właściwości jest niezmienna i ma stały zapisany wynik. (If6a13, b/127483380, b/257967987)

Wersja 2.5.2

Wersja 2.5.2

21 czerwca 2023 r.

Publikacja androidx.room:room-*:2.5.2 Wersja 2.5.2 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem z niezgodnością z kotlinx-metadata-jvm. (386d5c)
  • Rozwiązaliśmy problem, który powodował, że Room zgłaszał błąd podczas używania w teście Robolectric. (f79bea, b/274924903)

Wersja 2.5.1

Wersja 2.5.1

22 marca 2023 r.

Publikacja androidx.room:room-*:2.5.1 Wersja 2.5.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Unikaj sprawdzania katalogu nadrzędnego bazy danych w FrameworkSQLiteHelper, jeśli baza danych jest już otwarta. (5de86b8)
  • Podczas sprawdzania, czy baza danych jest już otwarta, użyj sprawdzenia isOpenInternal. (e91fb35)
  • Lepsza obsługa przypadku ponownego wejścia w acquireTransactionThread() w Room jest już dostępna. (219f98b). Podczas transakcji zawieszającej Room używa wątku z wykonawcy transakcji, uruchamia w nim pętlę zdarzeń i wysyła do niego operacje zawieszające bazy danych, dzięki czemu wszystkie są zawarte w współprogramie transakcji. Zwykle oczekuje się, że wątek transakcji różni się od wątku, który ją rozpoczął, ale w niektórych przypadkach są one takie same. Aby obsłużyć takie przypadki, usługa withTransaction() została poddana refaktoryzacji, dzięki czemu nie korzysta już z zadania kontrolnego, ale wykonuje blok transakcji zawieszającej z poziomu runBlocking w wątku transakcji.

Wersja 2.5.0

Wersja 2.5.0

22 lutego 2023 roku

Wersje androidx.room:room-paging-guava:2.5.0, androidx.room:room-paging-rxjava2:2.5.0 i androidx.room:room-paging-rxjava3:2.5.0 zostały opublikowane. Wersja 2.5.0 zawiera te zatwierdzenia.

Wersja 2.5.0

11 stycznia 2023 r.

Publikacja androidx.room:room-*:2.5.0 Wersja 2.5.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.4.0

  • Wszystkie źródła (room-runtime) zostały przekonwertowane z Javy na Kotlina. Pamiętaj, że jeśli Twój kod jest w języku Kotlin, mogą wystąpić problemy ze zgodnością źródła z powodu konwersji biblioteki na ten język. Na przykład znaną niezgodną zmianą źródła jest to, że w InvalidationTracker musisz teraz zadeklarować onInvalidate() w Observer, aby mieć parametr typu Set, a nie MutableSet. Ponadto niektóre metody pobierające zostały przekonwertowane na właściwości wymagające składni dostępu do właściwości w plikach Kotlin. Jeśli występują jakieś istotne niezgodności, zgłoś błąd.
  • Dodano nową adnotację skrótu @Upsert, która próbuje wstawić encję, gdy nie ma konfliktu unikalności, lub zaktualizować encję, jeśli występuje konflikt. (I7aaab, b/241964353)
  • Dodano nowe artefakty stronicowania Room room-paging-rxjava2, room-paging-rxjava3 i room-paging-guava, aby zapewnić obsługę stronicowania Room.
  • Dodano interfejsy API do podawania nazw tabel kluczy i wartości na potrzeby uściślania w @MapInfo (Icc4b5)

Wersja 2.5.0-rc01

7 grudnia 2022 r.

Publikacja androidx.room:room-*:2.5.0-rc01 Wersja 2.5.0-rc01 zawiera te zatwierdzenia.

  • Ta wersja jest identyczna z wersją 2.5.0-beta02.

Wersja 2.5.0-beta02

9 listopada 2022 r.

Publikacja androidx.room:room-*:2.5.0-beta02 Wersja 2.5.0-beta02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Naprawiono różne interfejsy API, które pobierają argumenty zapytania z niezmiennika (Array<Any?>) do kontrawariantu (Array<out Any?>), aby dopasować je do zachowania tablicy Javy. (b/253531073)

Wersja 2.5.0-beta01

5 października 2022 r.

Publikacja androidx.room:room-*:2.5.0-beta01 Wersja 2.5.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Ogranicz minimalną wersję obsługującą @Upsert do interfejsu API 16. Wynika to z niemożności zidentyfikowania konfliktu ograniczeń klucza podstawowego w starszych interfejsach API. (I5f67f, b/243039555)

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że tabele cieni były nieprawidłowo eksportowane do plików schematu .json, co powodowało ich uszkodzenie. (I4f83b, b/246751839)

Wersja 2.5.0-alpha03

24 sierpnia 2022 r.

Publikacja androidx.room:room-*:2.5.0-alpha03 Wersja 2.5.0-alpha03 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano nową adnotację skrótu @Upsert, która próbuje wstawić encję, gdy nie ma konfliktu unikalności, lub zaktualizować encję, jeśli występuje konflikt. (I7aaab, b/241964353)

Poprawki błędów

  • Podczas sprawdzania ograniczenia klucza obcego w ramach automatycznej migracji Room będzie teraz zgłaszać błąd SQLiteConstraintException zamiast IllegalStateException. (I328dd)
  • Naprawiono zmianę niezgodną ze źródłem Kotlin w przypadku metod pobierających i właściwości getOpenHelper, getQueryExecutor i getTransactionExecutor. (Iad0ac)

Wersja 2.5.0-alpha02

1 czerwca 2022 r.

Publikacja androidx.room:room-*:2.5.0-alpha02 Wersja 2.5.0-alpha02 zawiera te zatwierdzenia.

Nowe funkcje

Zmiany w interfejsie API

  • Cały projekt room-runtime został przekonwertowany z Javy na Kotlina. (If2069, b/206859668),(Ie4b55, b/206859668), (I697ee, b/206859668), (I96c25, b/206859668)

    Uwaga: z powodu konwersji biblioteki na Kotlin mogą wystąpić problemy ze zgodnością źródeł. Jeśli kod był napisany w Kotlinie i wywoływał starą wersję Room, nowa wersja będzie musiała obsługiwać te przypadki. Na przykład znaną niezgodną zmianą źródła jest to, że w InvalidationTracker musisz teraz zadeklarować onInvalidate() w Observer, aby mieć parametr typu Set, a nie MutableSet.

  • Dodano interfejsy API do podawania nazw tabel kluczy i wartości na potrzeby uściślania w @MapInfo (Icc4b5)
  • Rozwiązaliśmy problem ze zgodnością źródła, aby ponownie zezwolić na @Ignore w metodach pobierających właściwości. (Ifc2fb)

Poprawki błędów

  • Algorytm heurystyczny do rozwiązywania problemu zduplikowanych kolumn. Room będzie teraz próbować rozwiązywać niejednoznaczne kolumny w zapytaniu multimap. Umożliwia to prawidłowe mapowanie operacji JOIN z tabelami o tej samej nazwie na wynikowy obiekt danych. (I4b444, b/201306012, b/212279118)

Wersja 2.5.0-alpha01

23 lutego 2022 r.

Publikacja androidx.room:room-*:2.5.0-alpha01 Wersja 2.5.0-alpha01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Rozwiązaliśmy problem polegający na tym, że użycie Room @IntDef nie było wymuszane w źródłach Kotlin. (I75f41, b/217951311)
  • Rozwiązaliśmy problem ze zgodnością źródła, aby ponownie zezwolić na @Query w metodach pobierających właściwości. (I0a09b)
  • Przekonwertowano room-common z języka Java na Kotlin. (I69c48, b/206858235)

    Uwaga: mogą wystąpić problemy ze zgodnością źródeł, ponieważ niektóre właściwości zostały przeniesione do obiektów towarzyszących podczas konwersji biblioteki na język Kotlin. Jeśli kod był napisany w języku Kotlin i wywoływał starą wersję Room, nowa wersja będzie wymagać sufiksu „.Companion” podczas uzyskiwania dostępu do tych właściwości.

  • Przekonwertowano migrację Room z Javy na Kotlina. (I2724b, b/206858622)
  • Przekonwertowano paging powiązanych plików w projekcie room-runtime z języka Java na Kotlin. (I82fc8, b/206859668)
  • Dodano interfejs API do blokowania i używania wielu procesów na poziomie FrameworkSQLite*, aby chronić tworzenie i migrację baz danych w przypadku wielu procesów. (Ied267, b/193182592)

Poprawki błędów

  • Dodaliśmy obsługę właściwości wewnętrznych w źródłach Kotlin. Jest to niewielka zmiana działania Room, która będzie używać nazwy źródłowej funkcji podczas dopasowywania ich do właściwości jako metod pobierających/ustawiających (wcześniej używana była nazwa JVM funkcji, która jest inna w przypadku funkcji/właściwości wewnętrznych). Jeśli używasz niestandardowych adnotacji @JvmName do dopasowywania metod pobierających i ustawiających do właściwości prywatnych, po aktualizacji dokładnie sprawdź wygenerowany kod (If6531, b/205289020).

Wersja 2.4.3

Wersja 2.4.3

27 lipca 2022 roku

Publikacja androidx.room:room-*:2.4.3 Wersja 2.4.3 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że Room nie rozpoznawał funkcji zawieszania w Kotlin 1.7 (b/236612358).

Wersja 2.4.2

Wersja 2.4.2

23 lutego 2022 r.

Publikacja androidx.room:room-*:2.4.2 Wersja 2.4.2 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem z generowaniem kodu dla funkcji zawieszenia Dao @Transaction z treścią, która generuje domyślną metodę interfejsu z powodu kompilacji z -Xjvm-default=all lub odpowiednikiem. (Ia4ce5)
  • Rozwiązaliśmy błąd, który powodował, że Room generował kod dla metody zapytania zwracającej typ Array<ByteArray>. (If086e, b/213789489)

Wersja 2.4.1

Wersja 2.4.1

12 stycznia 2022 r.

Publikacja androidx.room:room-*:2.4.1 Wersja 2.4.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Dodaliśmy obsługę właściwości wewnętrznych w źródłach Kotlin. Jest to niewielka zmiana działania Room, która będzie używać nazwy źródłowej funkcji podczas dopasowywania ich do właściwości jako metod pobierających/ustawiających (wcześniej używana była nazwa JVM funkcji, która jest inna w przypadku funkcji/właściwości wewnętrznych). Jeśli używasz niestandardowych adnotacji @JvmName do dopasowywania metod pobierających i ustawiających do właściwości prywatnych, po aktualizacji dokładnie sprawdź wygenerowany kod (If6531, b/205289020).

Wersja 2.4.0

Wersja 2.4.0

15 grudnia 2021 roku

Publikacja androidx.room:room-*:2.4.0 Wersja 2.4.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.3.0

  • Automatyczne migracje: Room udostępnia teraz interfejs API do automatycznego generowania migracji, o ile schematy są eksportowane. Aby poinformować Room, że ma wygenerować automatyczną migrację, można użyć nowej właściwości @Database#autoMigrations do zadeklarowania wersji, z których i do których ma nastąpić automatyczna migracja. Gdy Room potrzebuje dodatkowych informacji o zmianach nazw lub usunięciach tabel i kolumn, adnotacja @AutoMigration może zadeklarować klasę specyfikacji zawierającą takie dane wejściowe. Więcej informacji znajdziesz w dokumentacji @AutoMigration.
  • Wstrzykiwanie zależności w automatycznych migracjach: @ProvidedAutoMigrationSpec to nowy interfejs API do deklarowania, że AutoMigrationSpec będzie dostarczany w czasie działania przez RoomDatabase.Builder#addAutoMigrationSpec(). Dzięki temu platforma wstrzykiwania zależności może dostarczać takie specyfikacje, gdy wymagają one złożonych zależności.
  • Obsługa automatycznych migracji przez pomocnika testowania migracji: zaktualizowaliśmy klasę MigrationTestHelper w Room, aby obsługiwała automatyczne migracje, udostępniając nowy interfejs API konstruktora, który otrzymuje testowaną klasę bazy danych. Dzięki temu asystent może automatycznie dodawać automatyczne migracje w ten sam sposób podczas runMigrationsAndValidate.
  • Obsługa Room-Paging: udostępniliśmy wersję androidx.room:room-paging, która zapewnia natywną obsługę Paging 3.0 w przypadku zapytań Room zwracających androidx.paging.PagingSource.
  • Metody zapytań relacyjnych: Room obsługuje teraz metody zwracanych typów multimap @Dao, które są przydatne w przypadku instrukcji JOIN. Obsługiwane typy multimap to Map, SparseArray, LongSparseArray oraz ImmutableMap, ImmutableSetMultimap i ImmutableListMultimap Guava.

Wersja 2.4.0-rc01

1 grudnia 2021 r.

Publikacja androidx.room:room-*:2.4.0-rc01 Wersja 2.4.0-rc01 zawiera te zatwierdzenia.

Nowe funkcje

  • Zaktualizuj zależność Room od KSP do wersji 1.6.0-1.0.1, aby obsługiwać Kotlin 1.6

Wersja 2.4.0-beta02

17 listopada 2021 r.

Publikacja androidx.room:room-*:2.4.0-beta02 Wersja 2.4.0-beta02 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodaliśmy obsługę SparseArray i LongSparseArray w @MapInfo. (Ic91a2b/138910317)

Poprawki błędów

  • Dodaliśmy nowy analizator TypeConverter, który uwzględnia informacje o dopuszczalności wartości null w typach. Te informacje są dostępne tylko w KSP, dlatego są domyślnie włączone tylko w KSP. Jeśli powoduje to problemy, możesz wyłączyć tę funkcję, przekazując do procesora adnotacji room.useNullAwareTypeAnalysis=false. Jeśli tak się stanie, zgłoś błąd, ponieważ ta flaga zostanie w przyszłości usunięta. W przypadku nowego analizatora TypeConverter zalecamy podawanie tylko niepustych obiektów TypeConverter, ponieważ nowy analizator może je opakować za pomocą sprawdzania wartości null. Pamiętaj, że nie ma to wpływu na użytkowników korzystających z KAPT lub Javy, ponieważ procesory adnotacji (w przeciwieństwie do KSP) nie mają informacji o możliwości zwracania wartości null w typach. (Ia88f9, b/193437407)
  • Naprawiliśmy błąd, który powodował, że kompilacja Room kończyła się błędem SQL, gdy encja FTS deklarowała użycie tokenizatora ICU. (I00db9, b/201753224)
  • Rozwiązaliśmy problem z automatycznymi migracjami dotyczący nowej kolumny dodanej do umieszczonej encji między wersjami. (I5fcb1b/193798291)
  • Rozwiązaliśmy problem z typami zwracanymi przez metodę zapytania relacyjnego w zapytaniach LEFT JOIN. W przypadku tych zmian, gdy występuje mapowanie 1 do wielu, kolekcja zwracana dla klucza nie będzie zawierać nieprawidłowego obiektu wartości, jeśli nie zostanie on znaleziony w kursorze. Jeśli nie zostaną znalezione żadne prawidłowe wartości, klucz zostanie zmapowany na pustą kolekcję. (Id5552b/201946438)
  • Rozwiązaliśmy problem z automatyczną migracją, który powodował, że słowa kluczowe SQLite nie były poprzedzane znakiem zmiany znaczenia w nazwach kolumn. (Idbed4b/197133152)

Wersja 2.4.0-beta01

13 października 2021 r.

Publikacja androidx.room:room-*:2.4.0-beta01 Wersja 2.4.0-beta01 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem z automatycznymi migracjami, które nie dodawały nowych kolumn, gdy inna tabela w tej samej automatycznej migracji miała również nową kolumnę o tej samej nazwie. (Ia5db5, b/200818663)
  • Implementacja PagingSource wygenerowana przez room-paging używa teraz queryExecutor przekazanego przez RoomDatabase.Builder, dzięki czemu można go zastąpić, zamiast Dispatchers.IO jak wcześniej. (Iae259)

Wersja 2.4.0-alpha05

29 września 2021 r.

Publikacja androidx.room:room-*:2.4.0-alpha05 Wersja 2.4.0-alpha05 zawiera te zatwierdzenia.

Nowe funkcje

Zmiany w interfejsie API

  • Dodaliśmy nową właściwość do adnotacji TypeConverters, aby umożliwić deweloperom wyłączanie wbudowanych konwerterów Enum i UUID. Domyślnie te konwertery są włączone, ale możesz je wyłączyć w określonym zakresie lub w całej bazie danych. Szczegółowe informacje znajdziesz w dokumentacji TypeConverters. (36ae9e, b/195413406)

  • Obsługa kluczy/wartości innych niż POJO w przypadku zwracanych typów Multimap w obiektach DAO za pomocą adnotacji @MapInfo. (I4d704)

Jeśli kolumna klucza lub wartości mapy pochodzi z jednej kolumny, wymagana będzie funkcja @MapInfo. Zobacz przykład:

@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>
  • Ustaw room-paging jako wymagany artefakt podczas korzystania z Paging3 z Room. (Ieaffe)

Poprawki błędów

  • Rozwiązaliśmy problem polegający na tym, że wyniki zapytań dotyczących wielu map nie były prawidłowo uporządkowane, gdy zapytanie zawierało klauzulę ORDER BY kolumny z klucza mapy. (I6b887)

Zewnętrzny wkład

  • Dodano nowy interfejs API do określania kolejności indeksu w @Index. Dziękujemy Nikicie Zhelonkinowi. (I033fc)

Wersja 2.4.0-alpha04

21 lipca 2021 r.

Publikacja androidx.room:room-*:2.4.0-alpha04 Wersja 2.4.0-alpha04 zawiera te zatwierdzenia.

Nowe funkcje

  • Room obsługuje teraz metody @Dao zwracające typy multimap, co jest przydatne w przypadku instrukcji JOIN. Obsługiwane typy multimap to Map oraz ImmutableMap, ImmutableSetMultimap i ImmutableListMultimap z Guava.

    Oto przykłady zapytań dotyczących wielu map:

    Mapa relacji jeden do jednego

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

    Mapa relacji jeden do wielu (standardowa multimapa)

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

    Wynik multimapy można też opakować w obsługiwane asynchroniczne zwracane typy, takie jak LiveData, Observable Rx lub współprogramy Flow.

Room-Paging

  • Wydano androidx.room:room-paging, co zapewnia natywną obsługę Paging 3.0 w przypadku zapytań Room zwracających androidx.paging.PagingSource.

    @Dao
    interface UserDao {
      @Query("SELECT * FROM users ORDER BY id ASC")
      fun loadUsers(): PagingSource<Int, User>
    }
    
  • Ten artefakt zastępuje implementację androidx.paging.PagingSource wygenerowaną przez Room implementacją opartą na interfejsach API Paging 3.0. Nowa implementacja PagingSource inaczej analizuje klucze, więc każdy klucz dostarczany ręcznie do PagingSource w Room musi uwzględniać tę zmianę zachowania, w tym klucz initialKey przekazywany przez konstruktor Pager. Strony zaczną się wczytywać od Key, a Key będzie pierwszym wczytanym elementem. Różni się to od dotychczasowego zachowania, w którym LoadParams.Refresh.Key jest traktowany jako pozycja przewijania użytkownika, a elementy są wczytywane zarówno przed kluczem, jak i po nim.

  • Artefakt jest opcjonalny, a rezygnacja z niego spowoduje powrót do dotychczasowej obsługi Paging 3.0, która została wprowadzona w Room 2.3. Jednak w przyszłej wersji ten artefakt stanie się obowiązkowy dla użytkowników Room z Paging 3.0. Aby wyrazić zgodę, dodaj nowy artefakt room-paging do ścieżki klasy. Jeśli używasz Gradle, możesz dodać do pliku build.gradle ten fragment kodu:

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

Poprawki błędów

  • Rozwiązaliśmy problem z automatycznymi migracjami dotyczący obsługi naruszeń klucza obcego. (b/190113935)

Wersja 2.4.0-alpha03

16 czerwca 2021 r.

Publikacja androidx.room:room-*:2.4.0-alpha03 Wersja 2.4.0-alpha03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Zaktualizuj MigrationTestHelper Room, aby obsługiwać automatyczne migracje, udostępniając nowy interfejs API konstruktora, który otrzymuje testowaną klasę bazy danych. Dzięki temu asystent może automatycznie dodawać automatyczne migracje w ten sam sposób podczas runMigrationsAndValidate.

Poprawki błędów

  • Rozwiązaliśmy problem z natywną biblioteką SQLite Room, aby zapewnić obsługę układów M1 firmy Apple. (b/174695268)

  • Rozwiązaliśmy problem, który powodował, że Room nie zgłaszał błędu, gdy zwracany typ funkcji @Transaction był przepływem (I56ddd, b/190075899).

  • Rozwiązaliśmy problem z indeksami podczas automatycznych migracji. b/177673291

Aktualizacje zależności

  • Obsługa KSP w pokoju zależy teraz od KSP 1.5.10-1.0.0-beta01. (1ecb11, b/160322705)

Wersja 2.4.0-alpha02

5 maja 2021 roku

Publikacja androidx.room:room-*:2.4.0-alpha02 Wersja 2.4.0-alpha02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • @ProvidedAutoMigrationSpec to nowy interfejs API do deklarowania, że AutoMigrationSpec będzie dostarczany w czasie działania przez RoomDatabase.Builder#addAutoMigrationSpec(). Dzięki temu platforma wstrzykiwania zależności może dostarczać takie specyfikacje, gdy wymagają one złożonych zależności.

Poprawki błędów

  • Rozwiązaliśmy problem z automatycznymi migracjami, który powodował, że @DatabaseView nie były prawidłowo odtwarzane.

Zewnętrzny wkład

  • Rozwiązaliśmy problem w Room JournalMode.TRUNCATE, który powodował, że wywołanie zwrotne InvalidationTracker było czasami wywoływane nieprawidłowo, za późno lub wcale. Podziękowania dla: Uli Bubenheimer | bubenheimer@users.noreply.github.com (b/154040286)

Wersja 2.4.0-alpha01

21 kwietnia 2021 r.

Publikacja androidx.room:room-*:2.4.0-alpha01 Wersja 2.4.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Automatyczne migracje: Room udostępnia teraz interfejs API do automatycznego generowania migracji, o ile schematy są eksportowane. Aby poinformować Room, że ma wygenerować automatyczną migrację, można użyć nowej właściwości @Database#autoMigrations do zadeklarowania wersji, z których i do których ma nastąpić automatyczna migracja. Gdy Room potrzebuje dodatkowych informacji o zmianach nazw lub usunięciach tabel i kolumn, adnotacja @AutoMigration może zadeklarować klasę specyfikacji zawierającą takie dane wejściowe. Więcej informacji znajdziesz w dokumentacji @AutoMigration.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że zapytania defaultValue z dodatkowymi nawiasami były nieprawidłowo sprawdzane przez walidację schematu Room. b/182284899

Wersja 2.3.0

Wersja 2.3.0

21 kwietnia 2021 r.

Publikacja androidx.room:room-*:2.3.0 Wersja 2.3.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.2.0

  • Wbudowana obsługa typów wyliczeniowych: Room będzie teraz domyślnie używać konwertera typu wyliczeniowego na ciąg znaków i odwrotnie, jeśli nie zostanie podany żaden konwerter. Jeśli konwerter typu dla typu wyliczeniowego już istnieje, Room będzie go używać zamiast domyślnego.
  • Wywołanie zwrotne zapytania: Room oferuje teraz ogólny interfejs API oparty na wywołaniach zwrotnych RoomDatabase.QueryCallback, który jest przydatny do logowania w kompilacjach do debugowania, gdy zapytania mają zostać wykonane. Wywołanie zwrotne można ustawić za pomocą RoomDatabase.Builder#setQueryCallback().
  • Gotowe ulepszenie: Room ma teraz interfejsy API do tworzenia bazy danych przy użyciu gotowej bazy danych odczytywanej ze strumienia wejściowego. Umożliwia to obsługę przypadków, gdy wstępnie spakowana baza danych jest skompresowana za pomocą gzip.
  • Dostarczone konwertery typów: Room ma teraz interfejsy API do dostarczania instancji konwerterów typów, dzięki czemu aplikacja może kontrolować ich inicjowanie. Aby oznaczyć konwerter typu, który zostanie dostarczony do Room, użyj nowej adnotacji @ProvidedTypeConverter.
  • Obsługa RxJava3: Room obsługuje teraz typy RxJava3. Podobnie jak w przypadku RxJava2, możesz zadeklarować metody DAO, których zwracany typ to Flowable, Single, Maybe i Completable. Dodatkowo dostępny jest nowy artefakt androidx.room:room-rxjava3 obsługujący RxJava3.
  • Obsługa Paging 3.0: Room będzie teraz obsługiwać generowanie implementacji metod z adnotacją @Query, których zwracany typ to androidx.paging.PagingSource.

Wersja 2.3.0-rc01

24 marca 2021 r.

Publikacja androidx.room:room-*:2.3.0-rc01 Wersja 2.3.0-rc01 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który uniemożliwiał wykorzystanie zapytań Coroutine Flow utworzonych przez Room w zawieszającym bloku withTransaction. (I797bf)

Wersja 2.3.0-beta03

10 marca 2021 r.

Publikacja androidx.room:room-*:2.3.0-beta03 Wersja 2.3.0-beta03 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodaliśmy obsługę kompilacji przyrostowej w przypadku KSP. (I031c1, b/176453350)

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że utworzenie PagingSource w głównym wątku mogło wywołać błąd ANR. (I42b74, b/181221318)
  • Naprawiono widoczność @ExperimentalRoomApi, aby była publiczna, a nie prywatna w pakiecie. (b/181356119)

Zewnętrzny wkład

  • Zezwól Room na akceptowanie zwracanego typu POJO w metodzie DAO z adnotacją @Query, gdy ma ona również adnotację @SkipQueryVerification. Room dołoży wszelkich starań, aby przekonwertować wynik zapytania na zwracany typ POJO w taki sam sposób, jak w przypadku metody DAO z adnotacją @RawQuery. Podziękowania dla: Markus Riegel | hey@marcorei.com. (I45acb)

Wersja 2.3.0-beta02

18 lutego 2021 r.

Publikacja androidx.room:room-*:2.3.0-beta02 Wersja 2.3.0-beta02 zawiera te zatwierdzenia.

Nowe funkcje

  • Room obsługuje teraz eksperymentalnie przetwarzanie symboli Kotlin KSP.

    KSP zastępuje KAPT, aby uruchamiać procesory adnotacji natywnie w kompilatorze Kotlin, co znacznie skraca czas kompilacji.

    Aby używać Room z KSP, możesz zastosować wtyczkę KSP do obsługi Gradle i zastąpić konfigurację kapt w pliku kompilacji konfiguracją ksp. Na przykład zamiast kapt 'androidx.room:room-compiler:2.3.0-beta02' użyj ksp 'androidx.room:room-compiler:2.3.0-beta02'. Więcej informacji znajdziesz w dokumentacji KSP.

    Pamiętaj, że KSP jest w fazie eksperymentalnej, dlatego w kodzie produkcyjnym zalecamy nadal używać KAPT. Skrócenie czasu kompilacji jest możliwe tylko wtedy, gdy nie ma innych procesorów korzystających z KAPT. Znane problemy znajdziesz w b/160322705.

Wersja 2.3.0-beta01

27 stycznia 2021 r.

Publikacja androidx.room:room-*:2.3.0-beta01 Wersja 2.3.0-beta01 zawiera te zatwierdzenia.

Nowe funkcje

  • Automatycznie zamykane bazy danych: Room może teraz zamykać bazy danych, do których nie uzyskano dostępu po upływie określonego czasu. Jest to funkcja eksperymentalna, którą można włączyć, wywołując RoomDatabase.Builder#setAutoCloseTimeout(). Ta funkcja jest przydatna w przypadku aplikacji z wieloma bazami danych.

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że metody Dao z wieloma metodami @Update lub @Delete z różnymi strategiami rozwiązywania konfliktów generowały kod tylko z jedną ze strategii, ignorując zdefiniowaną strategię. (/I0b90d, b/176138543)

Wersja 2.3.0-alpha04

16 grudnia 2020 roku

Publikacja androidx.room:room-*:2.3.0-alpha04 Wersja 2.3.0-alpha04 zawiera te zatwierdzenia.

Nowe funkcje

  • Room oferuje teraz ogólny interfejs API oparty na wywołaniach zwrotnych RoomDatabase.QueryCallback, który jest przydatny, gdy zapytania mają zostać wykonane, co może być przydatne do logowania w kompilacjach do debugowania. Wywołanie zwrotne można ustawić za pomocą RoomDatabase.Builder#setQueryCallback(). (Iaa513, b/174478034, b/74877608)
  • Jeśli nie podano żadnego konwertera, Room będzie teraz domyślnie używać konwertera typu Enum na String i odwrotnie. Jeśli konwerter typu dla typu wyliczeniowego już istnieje, Room będzie go używać zamiast domyślnego. (b/73132006)

Znany problem

  • Jeśli dla typu wyliczeniowego istnieje już jednokierunkowy konwerter typów do odczytu, Room może przypadkowo użyć wbudowanego konwertera typu String na typ wyliczeniowy, co może być niepożądane. Jest to znany problem, który można rozwiązać, zmieniając konwerter na dwukierunkowy. Zobacz: b/175707691

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że Room nieprawidłowo wyłączał przyrostowe przetwarzanie adnotacji w nowszych wersjach JDK. (b/171387388)
  • Rozwiązaliśmy problem z Room, który polegał na tym, że nie znajdował wygenerowanej klasy, gdy używanych było wiele programów ładujących klasy. Dziękujemy za poprawkę użytkownikowi „Serendipity | 892449346@qq.com” (b/170141113).
  • Naprawiliśmy błąd, który powodował, że Room generował nieprawidłowy kod, gdy klasa @Dao w Kotlin miała klasę bazową, której typy ogólne były typami podstawowymi w JVM. (b/160258066)

Zewnętrzny wkład

  • Room będzie teraz domyślnie używać beginTransactionNonExclusive, jeśli tryb WAL jest włączony, a interfejs API ma wersję 16 lub nowszą. Dziękujemy użytkownikowi Ahmed I. Khalil | ahmedibrahimkhali@gmail.com’! (b/126258791)

Wersja 2.3.0-alpha03

14 października 2020 r.

Publikacja androidx.room:room-*:2.3.0-alpha03 Wersja 2.3.0-alpha03 zawiera te zatwierdzenia.

Nowe funkcje

  • Room ma teraz interfejsy API do udostępniania instancji konwerterów typów, dzięki czemu aplikacja może kontrolować ich inicjowanie. Aby oznaczyć konwerter typów, który zostanie dostarczony do Room, użyj nowej adnotacji @ProvidedTypeConverter. Podziękowania dla użytkownika „mzgreen yairobbe@gmail.com” (Ie4fa5, b/121067210).

  • Room ma teraz interfejsy API do tworzenia bazy danych przy użyciu gotowej bazy danych odczytywanej ze strumienia wejściowego. Umożliwia to obsługę przypadków, gdy wstępnie spakowana baza danych jest skompresowana za pomocą gzip. Podziękowania dla Ahmeda El-Helwa ahmedre@gmail.com (3e6792, b/146911060)

Zmiany w interfejsie API

  • Dodano brakujący cel do adnotacji @ForeignKey, co uniemożliwia jej użycie poza adnotacją @Entity. (Iced1e)

  • Pole mCallbacks w tabeli RoomDatabase.java jest teraz ukryte. (d576cb, b/76109329)

Poprawki błędów

  • Zaktualizowaliśmy dokumentację TypeConverters, aby wyjaśnić, że TypeConverters można używać tylko do konwertowania kolumn/pól, a nie wierszy. (I07c56, b/77307836)

  • Zaktualizowano DaoProcessor, aby naprawić błąd kompilatora w Dao z ogólnym supertypem z „elementami podstawowymi” Kotlina. (Ice6bb, b/160258066)

  • Zaktualizowano dokumentację metod dodawania i usuwania obserwatorów, aby wyjaśnić wątki (Ifd1d9, b/153948821).

  • Rozwiązaliśmy problem z nieprawidłowym sprawdzaniem przez Room tabel FTS, które zadeklarowały kolumnę rowid. (d62ebc, b/145858914)

Treści zewnętrzne

  • Rozwiązanie problemów z wielkością liter w języku tureckim (5746e3), b/68159494

  • Zastąp ConcurrentHashMap w RoomDatabase przez Collections.synchronizedMap(), aby uniknąć problemów na Androidzie Lollipop (d1cfc7, b/162431855)

  • Dodaj wywołanie zwrotne onOpenPrepackagedDatabase, gdy gotowa baza danych zostanie skopiowana. (I1ba74, b/148934423)

Wersja 2.3.0-alpha02

22 lipca 2020 r.

Publikacja androidx.room:room-*:2.3.0-alpha02 Wersja 2.3.0-alpha02 zawiera te zatwierdzenia.

Nowe funkcje

  • Obsługa RxJava3: Room obsługuje teraz typy RxJava3. Podobnie jak w przypadku RxJava2, możesz zadeklarować metody DAO, których zwracany typ to Flowable, Single, Maybe i Completable. Dodatkowo dostępny jest nowy artefakt androidx.room:room-rxjava3 obsługujący RxJava3. (b/152427884)

Zmiany w interfejsie API

  • Teraz obsługiwane jest deklarowanie @TypeConverter w klasie obiektów Kotlin. (b/151110764)
  • Opcja przyrostowego przetwarzania adnotacji Room jest teraz domyślnie włączona. (b/112110217)

Wersja 2.3.0-alpha01

10 czerwca 2020 r.

Publikacja androidx.room:room-*:2.3.0-alpha01 Wersja 2.3.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Obsługa Paging 3.0: Room będzie teraz obsługiwać generowanie implementacji metod z adnotacją @Query, których zwracany typ to androidx.paging.PagingSource.

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

Zmiany w interfejsie API

  • @RewriteQueriesToDropUnusedColumns to nowa, wygodna adnotacja, która sprawia, że Room przepisuje projekcję „*” w zapytaniu, tak aby nieużywane kolumny w wyniku zostały usunięte.
  • Opcja procesora room.expandProjection została wycofana. Użyj @RewriteQueriesToDropUnusedColumns jako zamiennika zapytań optymalizujących pokój z projekcjami gwiazd. Pamiętaj, że @RewriteQueriesToDropUnusedColumns nie zastępuje rozwiązania problemu konfliktu kolumn room.expandProjection oferowanego w przypadku zwracanych typów, które zawierały pola @Embedded.

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że Room nie wykrywał prawidłowo wersji JDK używanej do włączenia przyrostowego procesora adnotacji. Podziękowania dla Blaza Solara (me@blaz.solar) (b/155215201)
  • Room umieszcza teraz zależność ANTLR w procesorze adnotacji, aby uniknąć konfliktów wersji z innymi procesorami, które również używają ANTLR. (b/150106190)

Wersja 2.2.6

Wersja 2.2.6

16 grudnia 2020 roku

Publikacja androidx.room:room-*:2.2.6 Wersja 2.2.6 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że Room nieprawidłowo wyłączał przyrostowe przetwarzanie adnotacji w nowszych wersjach JDK. (b/171387388)

Wersja 2.2.5

Wersja 2.2.5

18 marca 2020 r.

Publikacja androidx.room:room-*:2.2.5 Wersja 2.2.5 zawiera te zatwierdzenia.

Poprawki błędów

  • Dodaj do MultiInstanceInvalidationService atrybut directBootAware. Podziękowania dla użytkownika „Mygod contact-git@mygod.be” (b/148240967).
  • Naprawiliśmy błąd, który powodował awarię, gdy włączone było unieważnianie w trybie podzielonym, a baza danych zawierała encję FTS. (b/148969394)
  • Rozwiązaliśmy problem z wczytywaniem bibliotek natywnych SQLite w procesorze adnotacji Room, który powodował awarię kompilatora z powodu kompilacji równoległych. (b/146217083)

Wersja 2.2.4

Wersja 2.2.4

19 lutego 2020 r.

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 i androidx.room:room-testing:2.2.4 zostały opublikowane. Wersja 2.2.4 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem z zawieszaniem transakcji, który powodował ich blokowanie, jeśli współprogram został szybko anulowany przed rozpoczęciem transakcji. (b/148181325)
  • Rozwiązaliśmy problem z nieprawidłowym użyciem @Generated podczas kompilowania za pomocą JDK 9. (b/146538330)
  • Naprawiliśmy błąd, który powodował, że Room generował nieprawidłowy kod, gdy interfejs DAO w Kotlinie miał funkcję konkretną. (b/146825845)

Wersja 2.2.3

Wersja 2.2.3

18 grudnia 2019 r.

Publikacja androidx.room:room-*:2.2.3 Wersja 2.2.3 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że Room nie mógł zweryfikować bazy danych, która nie przeszła żadnej migracji i zawierała starszy hasz z indeksami w schemacie. (b/139306173)

Wersja 2.2.2

Wersja 2.2.2

20 listopada 2019 r.

Publikacja androidx.room:room-*:2.2.2 Wersja 2.2.2 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że zbieranie relacji jeden do jednego z ponad 999 wierszami powodowało, że Room zwracał elementy powiązane z wartością null. (b/143105450)

Wersja 2.2.1

Wersja 2.2.1

23 października 2019 r.

Publikacja androidx.room:room-*:2.2.1 Wersja 2.2.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że Room nieprawidłowo ostrzegał o CURSOR_MISMATCH, gdy opcja kompilatora expandProjection była włączona. (b/140759491)
  • Dodaliśmy mechanizm ponawiania prób w przypadku braku biblioteki natywnej używanej do weryfikacji zapytań w czasie kompilowania.

Wersja 2.2.0

Wersja 2.2.0

9 października 2019 r.

Publikacja androidx.room:room-*:2.2.0 Wersja 2.2.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.1.0

  • Gotowa baza danych: w RoomDatabase.Builder są teraz dostępne 2 nowe interfejsy API do tworzenia RoomDatabase na podstawie już wypełnionego pliku bazy danych. createFromAsset() służy do określania, kiedy wstępnie wypełniony plik bazy danych znajduje się w folderze zasobów pliku APK, a createFromFile() – kiedy plik znajduje się w dowolnej lokalizacji. Użycie tych interfejsów API zmienia zachowanie migracji destrukcyjnych w taki sposób, że podczas migracji zastępczej Room próbuje ponownie skopiować wstępnie wypełnioną bazę danych, jeśli jest dostępna. W przeciwnym razie po prostu usuwa i ponownie tworzy wszystkie tabele. b/62185732
  • Wartości domyślne schematu: @ColumnInfo ma teraz nową właściwość defaultValue, której można użyć do określenia domyślnej wartości kolumny. Wartości domyślne są częścią schematu bazy danych i będą sprawdzane podczas migracji, jeśli zostaną określone. b/64088772
  • Relacje wiele do wielu: @Relation ma teraz nową właściwość associateBy, która przyjmuje nową adnotację @Junction, używaną do deklarowania relacji, która musi być spełniona przez tabelę połączeń (nazywaną też tabelą sprzężeń). b/69201917
  • Relacje jeden do jednego: usunięto ograniczenie, zgodnie z którym pola POJO z adnotacją @Relation musiały być typu List lub Set, co umożliwia reprezentowanie relacji z jedną wartością. b/62905145
  • Encja docelowa: adnotacje DAO @Insert, @Update i @Delete mają teraz nową właściwość targetEntity, która umożliwia określenie tabeli docelowej, na której ma działać metoda DAO. Dzięki temu parametrami tych metod DAO mogą być dowolne obiekty POJO, które będą interpretowane jako częściowe encje. W praktyce umożliwia to częściowe wstawianie, usuwanie i aktualizowanie. b/127549506
  • Przepływ współprogramów: metody DAO @Query mogą teraz zwracać typ Flow<T>. Zwrócony obiekt Flow ponownie wyemituje nowy zestaw wartości, jeśli tabele obserwowane w zapytaniu zostaną unieważnione. Zadeklarowanie funkcji DAO ze zwracanym typem Channel<T> jest błędem. Room zachęca do użycia Flow, a następnie użycia sąsiednich funkcji do przekonwertowania Flow na Channel. b/130428884
  • Przyrostowy procesor adnotacji Gradle: Room jest teraz procesorem adnotacji izolującym Gradle, a przyrostowość można włączyć za pomocą opcji procesora room.incremental. Więcej informacji znajdziesz w artykule Opcje kompilatora Room. Jeśli napotkasz jakieś problemy, zgłoś błąd tutaj. W przyszłej stabilnej wersji planujemy domyślnie włączyć przyrostowość. b/112110217
  • Rozszerzanie projekcji: dodano nową eksperymentalną opcję kompilatora room.expandProjection, która powoduje, że Room przepisuje zapytanie z projekcją gwiazdkową, aby zawierało tylko kolumny w zwracanym typie POJO. Na przykład w przypadku metody DAO z adnotacją @Query("SELECT * FROM Song"), która zwraca obiekt POJO o nazwie SongIdAndTitle z tylko 2 polami. Następnie Room przepisze zapytanie na SELECT id, title FROM Song, tak aby pobrać minimalny zestaw kolumn, który spełnia wymagania zwracanego typu. W ten sposób eliminowane jest ostrzeżenie CURSOR_MISMATCH, które pojawia się, gdy zapytanie zwraca dodatkowe kolumny, które nie pasują do żadnego pola w zwracanym typie POJO.

Wersja 2.2.0-rc01

5 września 2019 r.

Publikacja androidx.room:room:2.2.0-rc01 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Brak zmian publicznych od wersji Room 2.2.0-beta01.

Wersja 2.2.0-beta01

22 sierpnia 2019 r.

Publikacja androidx.room:room-*:2.2.0-beta01 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że zapytanie Coroutine Flow przestawało ponownie emitować nowe wartości po określonym czasie. (b/139175786)
  • Naprawiliśmy błąd, który powodował, że Room nie akceptował starszego kodu skrótu schematu podczas otwierania bazy danych, która nie została przeniesiona od wersji Room 1.0, co powodowało awarię w czasie działania z powodu nieprawidłowego schematu. (b/139306173)

Wersja 2.2.0-alpha02

7 sierpnia 2019 r.

Publikacja androidx.room:room-*:2.2.0-alpha02 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Nowe funkcje

  • Przepływ współprogramów: metody DAO @Query mogą teraz zwracać typ Flow<T>. Zwrócony obiekt Flow ponownie wyemituje nowy zestaw wartości, jeśli tabele obserwowane w zapytaniu zostaną unieważnione. Zadeklarowanie funkcji DAO ze zwracanym typem Channel<T> jest błędem. Room zachęca do użycia Flow, a następnie użycia sąsiednich funkcji do przekonwertowania Flow na Channel. b/130428884
  • Rozszerzanie projekcji: dodano nową eksperymentalną opcję kompilatora room.expandProjection, która powoduje, że Room przepisuje zapytanie z projekcją gwiazdkową, aby zawierało tylko kolumny w zwracanym typie POJO. Na przykład w przypadku metody DAO z adnotacją @Query("SELECT * FROM Song"), która zwraca obiekt POJO o nazwie SongIdAndTitle z tylko 2 polami. Następnie Room przepisze zapytanie na SELECT id, title FROM Song, tak aby pobrać minimalny zestaw kolumn, który spełnia wymagania zwracanego typu. W ten sposób eliminowane jest ostrzeżenie CURSOR_MISMATCH, które pojawia się, gdy zapytanie zwraca dodatkowe kolumny, które nie pasują do żadnego pola w zwracanym typie POJO.
  • onDestructiveMigrate to nowy interfejs API oparty na wywołaniach zwrotnych dodany do RoomDatabase.Callback, który jest używany, gdy Room przeprowadza destrukcyjną migrację bazy danych. b/79962330

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że Room generował nieprawidłowy kod, używając metody jako metody ustawiającej pole, gdy pole było chronione. b/136194628
  • Naprawiono błąd, który powodował, że InvalidationTracker zgłaszał wyjątek NPE w drugim procesie, gdy unieważnianie w trybie podzielonym było włączone, a usługa unieważniania została wyłączona. b/137454915
  • Naprawiliśmy błąd, który powodował, że Room nie rozpoznawał prawidłowo zwracanego typu odziedziczonej funkcji zawieszenia oznaczonej adnotacją @RawQuery. b/137878827
  • Zaktualizowano wygenerowany kod dla @Relation, gdy powiązany klucz jest typu BLOB, aby używać porównywalnego ByteBuffer. b/137881998
  • Naprawiliśmy błąd, który powodował, że Room zgłaszał brak metod ustawiających w obiektach POJO używanych jako parametry encji częściowej w @Insert, @Update i @Delete. b/138664463
  • Naprawiliśmy błąd, który powodował, że Room zgłaszał brak metod pobierających i ustawiających dla ignorowanej kolumny za pomocą @Entity, gdy klasa encji była używana w niektórych metodach DAO. b/138238182
  • Naprawiliśmy błąd, który powodował, że Room nie konwertował prawidłowo nazwanych argumentów wiązania na argumenty pozycyjne, co powodowało wyjątek czasu działania podczas wykonywania zapytania z ponownie używanymi parametrami. b/137254857

Wersja 2.2.0-alpha01

10 lipca 2019 r.

Nowe funkcje

  • Gotowa baza danych: w RoomDatabase.Builder są teraz dostępne 2 nowe interfejsy API do tworzenia RoomDatabase na podstawie już wypełnionego pliku bazy danych. createFromAsset() służy do określania, kiedy wstępnie wypełniony plik bazy danych znajduje się w folderze zasobów pliku APK, a createFromFile() – kiedy plik znajduje się w dowolnej lokalizacji. Użycie tych interfejsów API zmienia zachowanie migracji destrukcyjnych w taki sposób, że podczas migracji zastępczej Room próbuje ponownie skopiować wstępnie wypełnioną bazę danych, jeśli jest dostępna. W przeciwnym razie po prostu usuwa i ponownie tworzy wszystkie tabele. b/62185732
  • Wartości domyślne schematu: @ColumnInfo ma teraz nową właściwość defaultValue, której można użyć do określenia domyślnej wartości kolumny. Wartości domyślne są częścią schematu bazy danych i będą sprawdzane podczas migracji, jeśli zostaną określone. b/64088772

    Uwaga: jeśli schemat bazy danych ma już wartości domyślne, np. dodane za pomocą ALTER TABLE x ADD COLUMN y INTEGER NOTNULL DEFAULT z, i zdecydujesz się zdefiniować wartości domyślne za pomocą @ColumnInfo w tych samych kolumnach, może być konieczne przeprowadzenie migracji w celu zweryfikowania nieuwzględnionych wartości domyślnych. Więcej informacji znajdziesz w artykule Migracja sal.

  • Relacje wiele do wielu: @Relation ma teraz nową właściwość associateBy, która przyjmuje nową adnotację @Junction, używaną do deklarowania relacji, która musi być spełniona przez tabelę połączeń (nazywaną też tabelą sprzężeń). b/69201917
  • Relacje jeden do jednego: usunięto ograniczenie, zgodnie z którym pola POJO z adnotacją @Relation musiały być typu List lub Set, co umożliwia reprezentowanie relacji z jedną wartością. b/62905145
  • Encja docelowa: adnotacje DAO @Insert, @Update i @Delete mają teraz nową właściwość targetEntity, która umożliwia określenie tabeli docelowej, na której ma działać metoda DAO. Dzięki temu parametrami tych metod DAO mogą być dowolne obiekty POJO, które będą interpretowane jako częściowe encje. W praktyce umożliwia to częściowe wstawianie, usuwanie i aktualizowanie. b/127549506
  • Przyrostowy procesor adnotacji Gradle: Room jest teraz procesorem adnotacji izolującym Gradle, a przyrostowość można włączyć za pomocą opcji procesora room.incremental. Więcej informacji znajdziesz w artykule Opcje kompilatora Room. Jeśli napotkasz jakieś problemy, zgłoś błąd tutaj. W przyszłej stabilnej wersji planujemy domyślnie włączyć przyrostowość. b/112110217

Poprawki błędów

  • Room nie będzie już przekazywać błędu EmptySetResultException do globalnego modułu obsługi błędów, gdy strumień Rx zapytania zostanie usunięty przed zakończeniem zapytania. b/130257475
  • Naprawiliśmy błąd, który powodował, że Room wyświetlał nieprawidłowy komunikat o błędzie, gdy funkcja DAO zawieszenia z adnotacją @RawQuery nie miała zwracanego typu. b/134303897
  • Room nie będzie już generować adapterów DAO z surowymi typami. b/135747255

Wersja 2.1.0

Wersja 2.1.0

13 czerwca 2019 r.

Wersja 2.1.0 Room nie zawiera żadnych zmian w porównaniu z wersją 2.1.0-rc01. Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Ważne zmiany od wersji 2.0.0

  • FTS: Room obsługuje teraz encje z mapowaniem tabeli FTS3 lub FTS4. Klasy oznaczone adnotacją @Entity można teraz dodatkowo oznaczyć adnotacją @Fts3 lub @Fts4, aby zadeklarować klasę z tabelą mapowania wyszukiwania pełnotekstowego. Opcje FTS umożliwiające dalsze dostosowywanie są dostępne za pomocą metod adnotacji.
  • Widoki: Room obsługuje teraz deklarowanie klasy jako zapisanego zapytania, zwanego też widokiem, za pomocą adnotacji @DatabaseView.
  • Korutyny: metody DAO mogą teraz być funkcjami zawieszania. Aby korzystać z tej funkcji, uwzględnij room-ktx w zależnościach. Artefakt ktx udostępnia też funkcję rozszerzenia RoomDatabase.withTransaction do wykonywania transakcji bazy danych w ramach współprogramu.
  • Auto Value: Room obsługuje teraz deklarowanie klas z adnotacjami AutoValue jako encji i POJO. Adnotacje Room @PrimaryKey, @ColumnInfo, @Embedded i @Relation można teraz deklarować w metodach abstrakcyjnych klasy z adnotacją AutoValue. Pamiętaj, że tym adnotacjom musi towarzyszyć @CopyAnnotations, aby Room mógł je prawidłowo zrozumieć.
  • Dodatkowa obsługa asynchroniczności: metody DAO z adnotacjami @Insert, @Delete lub @Update oraz @Query zawierające instrukcje INSERT, DELETE lub UPDATE obsługują teraz zwracane typy Rx Completable, Single, Maybe i zwracany typ Guava ListenableFuture. Mogą też być funkcjami zawieszania.
  • enableMultiInstanceInvalidation to nowy interfejs API w RoomDatabase.Builder, który umożliwia unieważnianie w wielu instancjach RoomDatabase korzystających z tego samego pliku bazy danych.
  • fallbackToDestructiveMigrationOnDowngrade to nowy interfejs API w RoomDatabase.Builder, który automatycznie odtwarza bazę danych w przypadku przejścia na starszą wersję.
  • ignoredColumns to nowy interfejs API w adnotacji @Entity, którego można używać do wyświetlania listy ignorowanych pól według nazwy.
  • Room będzie teraz prawidłowo używać podstawowego konstruktora Kotlin w klasach danych, dzięki czemu nie trzeba będzie deklarować właściwości jako vars.

Wersja 2.1.0-rc01

29 maja 2019 r.

Poprawki błędów

  • Naprawiliśmy błąd inicjowania Room, który mógł wystąpić z powodu skonfigurowanego już ustawienia temp_store. b/132602198
  • Naprawiliśmy ostrzeżenie o użyciu podwójnego cudzysłowu u użytkowników SQLite w wersji 3.27.0 lub nowszej. b/131712640
  • Naprawiliśmy błąd, który powodował awarię InvalidationTracker, gdy równolegle występowało kilka kontroli unieważnienia. b/133457594

Wersja 2.1.0-beta01

7 maja 2019 r.

Wersja androidx.room 2.1.0-beta01 została opublikowana bez zmian w stosunku do wersji 2.1.0-alpha07. Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Wersja 2.1.0-alpha07

25 kwietnia 2019 r.

Zmiany w interfejsie API i działaniu

  • Funkcja rozszerzenia RoomDatabase.withTransaction została zmieniona i nie przyjmuje już bloku funkcji z CoroutineScope jako odbiorcą. Zapobiega to pominięciu dodatkowego opakowania coroutineScope { } wymaganego do jednoczesnego uruchamiania elementów w bloku transakcji.

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że Room nie dopasowywał TypeConverter do funkcji DAO w języku Kotlin zawierającej parametr typu Collection. b/122066791

Wersja 2.1.0-alpha06

22 marca 2019 r.

Zmiany w interfejsie API i działaniu

  • Zapytania o transakcje asynchroniczne są teraz serializowane, dzięki czemu Room nie będzie używać więcej niż 1 wątku do wykonywania transakcji w bazie danych. Dodano RoomDatabase.Builder.setTransactionExecutor(Executor), aby umożliwić konfigurowanie maszyny wykonawcy, która ma być używana do transakcji.
  • RoomDatabase.runInTransaction(Callable) nie będzie już opakowywać sprawdzonych wyjątków w RuntimeExceptions. b/128623748

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że moduł śledzenia unieważnienia przestawał obserwować tabelę treści, jeśli dodano obserwatorów zarówno dla tabeli treści, jak i zewnętrznej tabeli treści FTS. b/128508917
  • Zaktualizowano gramatykę SQLite w Room, aby była zgodna z SQLite 3.24.0. b/110883668

Wersja 2.1.0-alpha05

13 marca 2019 r.

Nowe funkcje

  • Funkcja rozszerzenia RoomDatabase.withTransaction umożliwia bezpieczne wykonywanie transakcji bazy danych w ramach współprogramu. Funkcje rozszerzeń Room wraz z obsługą współprogramów są dostępne w artefakcie room-ktx.
  • Nieabstrakcyjne metody DAO z adnotacją @Transaction mogą teraz być funkcjami zawieszającymi. b/120241587

Zmiany w interfejsie API i działaniu

  • Nazwa artefaktu room-coroutines została zmieniona na room-ktx, aby była zgodna z nazwami innych artefaktów androidx.
  • Funkcje beginTransaction, setTransactionSuccessful i endTransaction w RoomDatabase zostały wycofane na rzecz runInTransaction i funkcji rozszerzenia room-ktx withTransaction.

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że argumenty tokenizatora były odrzucane, jeśli używany był tokenizator SIMPLE. b/125427014
  • Naprawiono błąd, który powodował, że Room nie rozpoznawał prawidłowo funkcji zawieszających z parametrami, których typem była klasa wewnętrzna. b/123767877
  • Naprawiliśmy błąd, który powodował, że odroczona metoda DAO @Query z instrukcjami INSERT, UPDATE lub DELETE przygotowywała zapytanie w głównym wątku. b/123695593
  • Naprawiliśmy różne błędy, które powodowały, że Room generował nieprawidłowy kod dla niektórych funkcji zawieszania. b/123466702 i b/123457323
  • Naprawiliśmy błąd, który powodował, że wycofane metody nie były prawidłowo pomijane w wygenerowanym kodzie. b/117602586
  • Zaktualizowano zależność Room androidx.sqlite do wersji 1.0.2, która zawiera poprawki dotyczące prawidłowej obsługi uszkodzonych baz danych. b/124476912

Znane problemy

  • Room 2.1.0-alpha05 zależy od artefaktu kotlinx-metadata-jvm, który nie jest obecnie dostępny w Centralnym repozytorium Maven (KT-27991). Tę zależność można rozwiązać, dodając maven { url "https://kotlin.bintray.com/kotlinx/" } do repozytoriów projektu.

Wersja 2.1.0-alpha04

25 stycznia 2019 r.

Nowe funkcje

  • Metody DAO z adnotacją @Query zawierające instrukcje INSERT, UPDATE lub DELETE mogą teraz zwracać typy asynchroniczne Single, Mayble, Completable i ListenableFuture. Dodatkowo mogą to być funkcje zawieszenia. b/120227284

Zmiany w interfejsie API i działaniu

  • Room będzie teraz zgłaszać błąd, jeśli nieabstrakcyjna metoda DAO z adnotacją @Transaction zwraca typ asynchroniczny, taki jak Single, Mayble, Completable, LiveData lub ListenableFuture. Transakcje są ograniczone do wątku, dlatego Room nie może obecnie rozpocząć i zakończyć transakcji wokół funkcji, która może wykonywać zapytania w różnych wątkach. b/120109336
  • Metody OnConflictStrategy.FAIL i OnConflictStrategy.ROLLBACK zostały @Deprecated, ponieważ nie działają zgodnie z oczekiwaniami z obecnymi powiązaniami SQLite Androida. b/117266738

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że Room nie używał prawidłowo TypeConverter zwracanego typu, jeśli metoda DAO była funkcją zawieszenia. b/122988159
  • Naprawiliśmy błąd, który powodował, że Room nieprawidłowo identyfikował odziedziczone funkcje zawieszenia jako funkcje niezawieszające. b/122902595
  • Naprawiliśmy błąd, który powodował, że Room generował nieprawidłowy kod, gdy pole @Embedded znajdowało się w klasie nadrzędnej i było używane w wielu klasach podrzędnych. b/121099048
  • Rozwiązaliśmy problem, który powodował blokowanie bazy danych podczas wywoływania funkcji zawieszenia DAO między beginTransaction() a endTransaction(). b/120854786

Wersja 2.1.0-alpha03

4 grudnia 2018 r.

Zmiany w interfejsie API

  • FTS tokenizer w @Fts3/@Fts4 przyjmuje teraz ciąg znaków zamiast typu wyliczeniowego. Dzięki temu Room może używać niestandardowych tokenizatorów. Wbudowane tokenizatory są nadal definiowane w FtsOptions jako stałe ciągi znaków. b/119234881

Nowe funkcje

  • Korutyny: metody DAO mogą teraz być funkcjami zawieszania. Aby obsługiwać funkcje zawieszania w Room, opublikowano nowy artefakt: room-coroutines. b/69474692
  • Metody DAO z adnotacjami @Insert, @Delete lub @Update obsługują teraz ListenableFuture jako zwracany typ. b/119418331

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że Room nieprawidłowo próbował znaleźć konstruktor z kolumnami we właściwości ignoredColumns elementu @Entity. b/119830714
  • Naprawiliśmy błąd, który powodował, że Room nie oznaczał parametrów metody DAO jako ostatecznych w wygenerowanej implementacji. b/118015483
  • Naprawiliśmy błąd, który powodował awarię procesora Room podczas zgłaszania błędu w zapytaniu z symbolami specjalnymi. b/119520136
  • Naprawiliśmy błąd, który powodował, że Room odrzucał różne inne implementacje Collection jako argumenty wyrażenia IN. b/119884035
  • Naprawiliśmy błąd, który powodował, że dane LiveData zwracane z Room były usuwane przez moduł czyszczenia pamięci, gdy były obserwowane przez cały czas, co uniemożliwiało im emitowanie nowych danych. b/74477406
  • Zaktualizowano blokadę zamknięcia RoomDatabase, aby zmniejszyć rywalizację o blokadę. b/117900450

Wersja 2.1.0-alpha02

30 października 2018 r.

Nowe funkcje

  • Dodaliśmy obsługę odwoływania się do @DatabaseView w @Relation. b/117680932

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że Room wykonywał operacje wejścia-wyjścia na dysku w głównym wątku podczas subskrybowania i usuwania ze zwracanego typu Rx. b/117201279
  • Naprawiliśmy błąd, który powodował, że Room nie mógł znaleźć odpowiedniego konwertera typu dla pola w klasie encji Kotlin. b/111404868
  • Naprawiliśmy błąd, który powodował, że Room generował nieprawidłowy kod implementacji interfejsu DAO zawierającego domyślną metodę Kotlin bez argumentów. b/117527454
  • Zaktualizowano parser gramatyki SQLite Room, co rozwiązało problem z wydajnością, który powodował długi czas kompilacji. b/117401230

Wersja 2.1.0-alpha01

8 października 2018 r.

Nowe funkcje

  • FTS: Room obsługuje teraz encje z mapowaniem tabeli FTS3 lub FTS4. Klasy oznaczone adnotacją @Entity można teraz dodatkowo oznaczyć adnotacją @Fts3 lub @Fts4, aby zadeklarować klasę z tabelą mapowania wyszukiwania pełnotekstowego. Opcje FTS umożliwiające dalsze dostosowywanie są dostępne za pomocą metod adnotacji. b/62356416
  • Widoki: Room obsługuje teraz deklarowanie klasy jako zapisanego zapytania, czyli widoku, za pomocą adnotacji @DatabaseView. b/67033276
  • Auto Value: Room obsługuje teraz deklarowanie klas z adnotacjami AutoValue jako encji i obiektów POJO. Adnotacje Room @PrimaryKey, @ColumnInfo, @Embedded i @Relation można teraz deklarować w metodach abstrakcyjnych klasy z adnotacją AutoValue. Pamiętaj, że tym adnotacjom musi towarzyszyć @CopyAnnotations, aby Room mógł je prawidłowo zrozumieć. b/62408420
  • Obsługa dodatkowych zwracanych typów Rx: metody DAO z adnotacjami @Insert, @Delete lub @Update obsługują teraz zwracane typy Rx Completable, Single<T> i Maybe<T>. b/63317956
  • Typy niezmienne z @Relation: Room wcześniej wymagał, aby pola z adnotacją @Relation można było ustawiać, ale teraz mogą one być parametrami konstruktora.
  • enableMultiInstanceInvalidation: to nowy interfejs API w RoomDatabase.Builder, który umożliwia unieważnianie w wielu instancjach RoomDatabase przy użyciu tego samego pliku bazy danych. Ten mechanizm unieważniania wielu instancji działa też w wielu procesach. b/62334005
  • fallbackToDestructiveMigrationOnDowngrade: nowy interfejs API w RoomDatabase.Builder do automatycznego ponownego tworzenia bazy danych w przypadku przejścia na starszą wersję. b/110416954
  • ignoredColumns: to nowy interfejs API w adnotacji @Entity, którego można używać do wyświetlania listy ignorowanych pól według nazwy. Przydatne do ignorowania odziedziczonych pól w encji. b/63522075

Zmiany w interfejsie API i działaniu

  • mCallback i mDatabase w RoomDatabase są teraz @Deprecated i zostaną usunięte w następnej wersji głównej Room. b/76109329

Poprawki błędów

  • Rozwiązaliśmy 2 problemy, które powodowały, że Room nie odzyskiwał prawidłowo danych z uszkodzonej bazy danych lub nieprawidłowej migracji podczas inicjowania. b/111504749 i b/111519144
  • Room będzie teraz prawidłowo używać głównego konstruktora Kotlina w klasach danych, dzięki czemu nie trzeba będzie deklarować pól jako vars. b/105769985

Wersja 2.0.0

Wersja 2.0.0

1 października 2018 r.

androidx.room 2.0.0 została opublikowana bez zmian w stosunku do wersji 2.0.0-rc01.

Wersja 2.0.0-rc01

20 września 2018 r.

Wersja androidx.room 2.0.0-rc01 została opublikowana bez zmian w stosunku do wersji 2.0.0-beta01.

Wersja 2.0.0-beta01

2 lipca 2018 r.

Zmiany w interfejsie API i działaniu

  • Dodano RoomDatabase.Builder.setQueryExecutor(), aby umożliwić dostosowywanie miejsca uruchamiania zapytań
  • Dodano obsługę RxJava2 Observable
  • Wygenerowane implementacje DAO i bazy danych są teraz ostateczne

Poprawki błędów

  • Określanie nazwy klasy/pola w błędzie „nie można znaleźć metody pobierającej dla pola” b/73334503
  • Naprawiono zgodność wsteczną RoomOpenHelper ze starszymi wersjami Room b/110197391

Zależności sprzed AndroidX

W przypadku wersji Room sprzed AndroidX uwzględnij te zależności:

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

Wersja 1.1.1

Wersja 1.1.1

19 czerwca 2018 r.

Pokój 1.1.1 jest identyczny z pokojem 1.1.1-rc1.

Wersja 1.1.1-rc1

16 maja 2018 r. Jeśli używasz migracji, zdecydowanie zalecamy używanie Room 1.1.1-rc1 zamiast 1.1.0.

Naprawiliśmy błąd, który powodował, że Room nie obsługiwał prawidłowo inicjowania po migracji (b/79362399).

Wersja 1.1.0

Wersja 1.1.0-beta3

19 kwietnia 2018 r.

Poprawki błędów

  • Naprawiono błąd kompilacji, który występował, gdy obiekt POJO w języku Kotlin odwoływał się do encji relacji zdefiniowanej w języku Java (b/78199923).

Wersja 1.1.0-beta2

5 kwietnia 2018 r.

Poprawki błędów

  • Naprawiliśmy krytyczny błąd w implementacjach Room Rx Single i Maybe, który powodował przedwczesne ponowne wykorzystanie zapytania, co powodowało problemy, jeśli do zwróconych instancji Single lub Maybe dodano więcej niż 1 obserwatora. b/76031240

  • [RoomDatabase.clearAllTables][ref-clearAllTables] nie będzie VACUUM bazy danych, jeśli zostanie wywołana w ramach transakcji. b/77235565

Wersja 1.1.0-beta1

21 marca 2018 r.

Zmiany w interfejsie API

  • Zgodnie z opinią dotyczącą interfejsu API @RawQuery nie akceptuje już przekazywania String jako parametru zapytania. Musisz użyć [SupportSQLiteQuery][ref-SupportSQLiteQuery]. (zobacz [SimpleSQLiteQuery][ref-SimpleSQLiteQuery], aby łatwo utworzyć instancję [SupportSQLiteQuery][ref-SupportSQLiteQuery] z obsługą argumentów).
  • Metoda [fallbackToDestructiveMigrationFrom][ref-fallbackToDestructiveMigrationFrom] klasy RoomDatabase.Builder akceptuje teraz vararg int zamiast vararg Integer.

Poprawki błędów

  • [RoomDatabase.clearAllTables][ref-clearAllTables] próbuje teraz zwrócić miejsce systemowi operacyjnemu, ustawiając punkt kontrolny WAL i VACUUM bazę danych.
  • [@RawQuery][ref-RawQuery] akceptuje teraz dowolny obiekt Pojo dla właściwości observedEntities, o ile odwołuje się on do co najmniej 1 encji za pomocą pól Embedded lub Relation. b/74041772
  • Paging: implementacja DataSource w Room prawidłowo obsługuje teraz zależności między wieloma tabelami (takie jak relacje i złączenia). Wcześniej nie powodowało to wygenerowania nowych wyników lub mogło nie zostać skompilowane. b/74128314

Wersja 1.1.0-alpha1

22 stycznia 2018 r.

Nowe funkcje

  • RawQuery: ten nowy interfejs API umożliwia metodom @Dao odbieranie kodu SQL jako parametru zapytania b/62103290, b/71458963
  • fallBackToDestructiveMigrationsFrom: ten nowy interfejs API w RoomDatabase.Builder umożliwia bardziej szczegółową kontrolę nad tym, od których wersji schematu początkowego dozwolone są migracje destrukcyjne (w porównaniu z fallbackToDestructiveMigration) b/64989640
  • Room obsługuje teraz tylko nowsze interfejsy API Paging (alpha-4+), wycofując obsługę przestarzałego interfejsu LivePagedListProvider. Aby korzystać z nowej wersji alfa Room, musisz używać biblioteki Paging w wersji alpha-4 lub nowszej i przejść z LivePagedListProvider na LivePagedListBuilder, jeśli jeszcze tego nie zrobiono.

Poprawki błędów

  • Ulepszona obsługa typów Kotlin Kapt. b/69164099
  • Kolejność pól nie unieważnia już schematu. b/64290754