Room

Deklarowanie zależności

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

Zależności dotyczące sal obejmują migracje sal i pokoje RxJava.

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

dependencies {
    def room_version = "2.6.1"

    implementation "androidx.room:room-runtime:$room_version"
    annotationProcessor "androidx.room:room-compiler:$room_version"

    // To use Kotlin annotation processing tool (kapt)
    kapt "androidx.room:room-compiler:$room_version"
    // To use Kotlin Symbol Processing (KSP)
    ksp "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"
}

dependencies {
    val room_version = "2.6.1"

    implementation("androidx.room:room-runtime:$room_version")
    annotationProcessor("androidx.room:room-compiler:$room_version")

    // To use Kotlin annotation processing tool (kapt)
    kapt("androidx.room:room-compiler:$room_version")
    // To use Kotlin Symbol Processing (KSP)
    ksp("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")
}

Informacje o używaniu wtyczki KAPT znajdziesz w dokumentacji KAPT.

Informacje o korzystaniu z wtyczki KSP znajdziesz w krótkim wprowadzeniu do KSP.

Informacje o korzystaniu z rozszerzeń Kotlina 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ż na Androida (np. modułów Gradle tylko w języku Java lub Kotlin) możesz polegać na androidx.room:room-common, aby używać adnotacji Room.

Konfigurowanie opcji kompilatora

Pokój ma te opcje procesora adnotacji.

Korzystanie z wtyczki Room Gradle

W wersji Room 2.6.0 i nowszych możesz użyć wtyczki Room Gradle, aby skonfigurować opcje kompilatora Room. Wtyczka konfiguruje projekt w taki sposób, aby wygenerowane schematy (które są danymi wyjściowymi zadań kompilacji i są wykorzystywane na potrzeby migracji automatycznych) były prawidłowo skonfigurowane tak, aby kompilacje można było odtworzyć i zapisać w pamięci podręcznej.

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

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

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

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

plugins {
    id 'androidx.room'
}

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

plugins {
    id("androidx.room")
}

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

Ustawienie schemaDirectory jest wymagane podczas korzystania z wtyczki Gradle Room. Spowoduje to skonfigurowanie kompilatora sal oraz różnych zadań i jego backendów (javac, KAPT, KSP) do umieszczania plików schematu w folderach o różnych nazwach, 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, nawet jeśli są one obsługiwane przez kompilator do obsługi pokoi. Tabela poniżej zawiera listę opcji i wersję wtyczki Gradle Room, która dodała obsługę konfigurowania danej 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.

Korzystanie z opcji procesora adnotacji

Jeśli nie używasz wtyczki Room Gradle lub jeśli wybrana opcja 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 używasz KSP czy KAPT w przypadku pokoju.

// 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...
                    ]
            }
        }
    }
}

// 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...
                )
            }
        }
    }
}

Ponieważ room.schemaLocation jest katalogiem, a nie typem prymitywnym, podczas dodawania tej opcji należy użyć CommandLineArgumentsProvider, aby Gradle wiedział o tym katalogu podczas przeprowadzania sprawdzeń aktualności. Opcja Przenieś bazę danych sal pokazuje pełną implementację CommandLineArgumentsProvider, która zawiera lokalizację schematu.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Daj nam znać, jeśli odkryjesz nowe wydania lub masz pomysły na ulepszenie tej biblioteki. Zanim utworzysz nową bibliotekę, przejrzyj istniejące problemy w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk z gwiazdką.

Tworzenie nowego zgłoszenia

Więcej informacji znajdziesz w dokumentacji narzędzia do śledzenia problemów.

Wersja 2.7

Wersja 2.7.0-alpha11

30 października 2024 r.

androidx.room:room-*:2.7.0-alpha11 został zwolniony. Wersja 2.7.0-alfa11 zawiera te zatwierdzenia.

Zmiany interfejsu API

• Sprawdź nowo dodany podpis metody convertRows(), aby był to funkcja zawieszania, która otrzymuje RawRoomQuery do stronicowania pokoju. (Ie57b5, b/369136627)

Poprawki błędów

• Rozwiązaliśmy problem z przekierowywaniem w pokojach, w którym nieprawidłowy kod był generowany podczas używania @Relation w połączeniu z PagingSource.

Wersja 2.7.0-alpha10

16 października 2024 r.

androidx.room:room-*:2.7.0-alpha10 został zwolniony. Wersja 2.7.0-alpha10 zawiera te komity.

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 funkcję SQLiteStatement.getColumnType() oraz różne stałe wyników SQLITE_DATA_*, aby umożliwić pobieranie typu danych kolumny. (I1985c, b/369636251)

Wersja 2.7.0-alpha09

2 października 2024 r.

androidx.room:room-*:2.7.0-alpha09 został zwolniony. Wersja 2.7.0-alfa09 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązano problem z implementacją room-paging w KPM, który powodował Error code: 8, message: attempt to write a readonly database z powodu rozpoczęcia transakcji zapisu na połączeniu odczytu. (B/368380988)

Wersja 2.7.0-alpha08

18 września 2024 r.

androidx.room:room-*:2.7.0-alpha08 został zwolniony. Wersja 2.7.0-alfa08 zawiera te zatwierdzenia.

Nowe funkcje

• Artefakty room-paging zostały przeniesione, aby były zgodne z KMP. (Ib8756, b/339934824)
• Interfejs API invalidationTrackerFlow() został udostępniony jako interfejs własny InvalidationTracker.createFlow() i jest teraz dostępny w przypadku zbiorów źródłowych 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ż odpowiednim ogólnym terminem do użycia w wersji Room w KMP. (Id8cd9, b/334087492)

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że Room KMP próbował wygenerować kod za pomocą UUID na platformach innych niż JVM. (b/362994709)
• Rozwiązaliśmy problem z wtyczką Room Gradle, który powodował błąd, np. „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.

androidx.room:room-*:2.7.0-alpha07 został zwolniony. Wersja 2.7.0-alpha07 zawiera te komity.

Nowe funkcje

• Wtyczka Gradle Room będzie teraz automatycznie dodawać wyeksportowane schematy do źródeł zasobów testu Android Instrumentation, aby można było ich używać w MigrationTestHelper.

Poprawki błędów

• Usunięto błąd związany z wygenerowanym parametrem „actual” funkcji RoomDatabaseConstructor, w którym w funkcji initialize brakuje modyfikatora „actual”, jeśli taka funkcja jest też zastąpiona w deklaracji „expect”. (359631627).
• Rozwiązaliśmy problem polegający na tym, że wygenerowana wartość „actual” (rzeczywista) w elemencie RoomDatabaseConstructor nie odpowiadała widoczności deklaracji „expect” (oczekiwana). (358138953)

Wersja 2.7.0-alpha06

7 sierpnia 2024 r.

androidx.room:room-*:2.7.0-alpha06 został zwolniony. Wersja 2.7.0-alpha06 zawiera te komity.

Zmiany w interfejsie API

• Zmień konfigurację instancjonowania RoomDatabase w projekcie KMP.

Ze względu na model kompilacji Kotlin 2.0 strategia odwoływania się do funkcji o nazwie instantiateImpl() do wygenerowania jest bardziej uzasadniona. Wprowadziliśmy 2 nowe interfejsy API: @ConstructedBy i RoomDatabaseConstructor, które zastępują strategię instantiateImpl(). Nowa strategia:

1. Zdefiniuj oczekiwany obiekt, 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. Tworzenie nowej instancji bazy danych bez przekazywania argumentu fabrycznego

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

Poprawki b/316978491, b/338446862 i b/342905180

• Obsługa funkcji @RawQuery w Room KMP dzięki dodaniu nowego interfejsu API o nazwie RoomRawQuery, który jest podobny do funkcji SupportSQLiteQuery pod względem przechowywania w surowym ciągu znaków SQL i funkcji służącej do wiązania argumentów w wyrażeniu. Funkcje z adnotacjami funkcji @RawQuery mogą teraz akceptować RoomRawQuery jako pojedynczy parametr. (Iea844, b/330586815)
• Dodaj przeciążenie metody setQueryCallback(), która przyjmuje argument CoroutineContext. (Id66ff, b/309996304)
• Dodano obsługę linuxArm64 celów Kotlin Multiplatform (I139d3, b/338268719)

Poprawki błędów

• Rozwiązanie problemu polegającego na tym, że Room nieprawidłowo generował wywołanie recursiveFetchArrayMap w przypadku celów innych niż Android. (710c36, b/352482325)
• Rozwiązaliśmy problem, który powodował, że w ramach projektu KMP Room czasami wyrzucał wyjątek o „przekroczeniu limitu czasu próby połączenia”. (fa72d0, b/347737870)
• Rozwiązanie problemu z automatycznymi migracjami, które zbyt wcześnie sprawdzały obce klucze, zanim inne tabele zmieniły swoje schematy, aby pasowały do nowych obcych kluczy. (7672c0, b/352085724)

Wersja 2.7.0-alpha05

10 lipca 2024 r.

androidx.room:room-*:2.7.0-alpha05 został zwolniony. Wersja 2.7.0-alpha05 zawiera te komity.

Zmiany interfejsu API

• Zmieniono nazwę SQLiteKt na SQLite, a BundledSQLiteKt na BundledSQLite. (I8B501)

Poprawki błędów

• Naprawiliśmy błąd, który powodował, że RoomDatabase blokował się lub generował błąd z ze względu na przekroczenie limitu czasu połączenia podczas korzystania z AndroidSQLiteDriver.

Wersja 2.7.0-alpha04

12 czerwca 2024 r.

Usługa androidx.room:room-*:2.7.0-alpha04 została zwolniona. Wersja 2.7.0-alfa04 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem związany z procesorem adnotacji Room, który generował niezgodny kod KMP, gdy w DAO zdefiniowano typ zwracany mapy wielopoziomowej. (b/340983093)
• Rozwiązaliśmy problem, który powodował, że Room nie mógł znaleźć implementacji wygenerowanej bazy danych, jeśli klasa z adnotacjami @Database nie miała pakietu. (b/342097292)
• Naprawiono błąd, który powodował, że włączenie automatycznego zamykania i unieważniania wielu wystąpień czasami powodowało błąd ConcurrentModificationException, gdy baza danych została zamknięta automatycznie z powodu braku aktywności.

Wersja 2.7.0-alpha03

29 maja 2024 r.

androidx.room:room-*:2.7.0-alpha03 został zwolniony. Wersja 2.7.0-alpha03 zawiera te komity.

Poprawki błędów

• Naprawiono różne problemy dotyczące Kotlina 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.

androidx.room:room-*:2.7.0-alpha02 został zwolniony. Wersja 2.7.0-alfa02 zawiera te zatwierdzenia.

Poprawki błędów

• Usunięto różne problemy z KSP.

Wersja 2.7.0-alpha01

1 maja 2024 r.

androidx.room:room-*:2.7.0-alpha01 został zwolniony. Wersja 2.7.0-alfa01 zawiera te zatwierdzenia.

Nowe funkcje

• Obsługa Kotlin Multiplatform (KMP): w tej wersji biblioteka Room została przebudowana, aby stała się biblioteką Kotlin Multiplatform (KMP). Chociaż wciąż wymaga trochę pracy, ta wersja wprowadza nową wersję Room, w której większość funkcji została ujednolicona (jest wieloplatformowa). Obecnie obsługiwane platformy to Android, iOS, JVM (na komputery), natywny Mac i natywny Linux. W nadchodzących wersjach Room zostaną dodane brakujące funkcje na nowo obsługiwanych platformach.

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

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

Zmiany w interfejsie API

• Dodano przeciążenie funkcji Room.databaseBuilder(), która przyjmuje parametr lambda przeznaczony do użycia z funkcja generowana przez Room. Ma to na celu uniknięcie korzystania z odzwierciedlenia podczas tworzenia instancji wygenerowanej implementacji RoomDatabase. Przykładowe zastosowanie:

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 RoomDatabase można skonfigurować tylko za pomocą wykonawców używających setQueryExecutor lub w kontekście coroutine, ale nie obu jednocześnie.
• Dodano interfejs API do konfigurowania Room za pomocą sterownika SQLite: RoomDatabase.Builder.setDriver(). Więcej informacji o interfejsie API SQLite Driver znajdziesz w dokumentacji SQLite KMP.
• Dodano interfejsy API umożliwiające dostęp do podstawowego interfejsu SQLiteConnection z interfejsów API sterownika: RoomDatabase.useReaderConnection i RoomDatabase.useWriterConnection.
• Funkcje zwracające informacje o pokoju mają teraz przeciążoną wersję, która zwraca SQLiteConnection zamiast SupportSQLiteDatabase. Należy je zastąpić podczas migracji do projektu KMP. Więcej informacji o przenoszeniu zastosowań Room w aplikacji na Androida do wspólnego modułu KMP znajdziesz w przewodniku po migracji. Te funkcje zwracają:
  • Migration.migrate(SQLiteConnection)
  • AutoMigrationSpec.onPostMigrate(SQLiteConnection)
  • RoomDatabase.Callback.onCreate(SQLiteConnection)
  • RoomDatabase.Callback.onDestructiveMigration(SQLiteConnection)
  • RoomDatabase.Callback.onOpen(SQLiteConnection)
• Element KTX androidx.room:room-ktx został scalony z elementem androidx.room:room-runtime wraz ze wszystkimi jego interfejsami API. Element jest teraz pusty. Usuń je z listy zależności.

Wersja 2.6

Wersja 2.6.1

29 listopada 2023 r.

androidx.room:room-*:2.6.1 został zwolniony. Wersja 2.6.1 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązanie problemu w generowanym kodzie, w którym wartość domyślna kolumn podwójnych w EntityCursorConverter była ustawiana na 0 zamiast na 0,0. Dodano też potencjalną poprawkę dla podobnego przypadku krawędzi dla kolumn typu Float. (Id75f5, b/304584179)
• Wyjątki rzucane przez wczytywanie PagingSource będą teraz propagowane jako LoadStateUpdate z LoadResult.Error zawierającym Throwable. Ten stan błędu można zaobserwować w PagingDataAdapter.loadStateFlow(Views) lub LazyPagingItems.loadState(Compose). Pamiętaj, że jest to zmiana zachowania. Wcześniej błędy wczytywania były przekazywane jako wyjątek przez metodę dao, która wywołała wczytywanie. (I93887, b/302708983)

Wersja 2.6.0

18 października 2023 r.

androidx.room:room-*:2.6.0 został zwolniony. Wersja 2.6.0 zawiera te commity.

Ważne zmiany od wersji 2.5.0

• Opcja włączenia generowania kodu Kotlina (czyli „Kotlin CodeGen”) jest teraz 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 na potrzeby KSP znajdziesz w dokumentacji KSP.

Uwaga: podczas korzystania z kotlin CodeGen należy pamiętać, że zostały dodane dodatkowe ograniczenia. W Kotlinie nie można używać abstrakcyjnych właściwości jako metod getera DAO ani zapytań DAO. Zamiast tego należy je przepisać jako funkcje, aby uniknąć błędnego przekonania, że wartość właściwości jest niezmienna i ma ustalony wynik. Kolejnym dodanym ograniczeniem jest to, że w Room dla Kotlin CodeGen nie są już dozwolone typy zwracania kolekcji Nullable.

Ostrzeżenie: podczas korzystania z Kotlin CodeGen Twoje projekty mogą być bardziej restrykcyjne pod względem możliwości wystąpienia wartości null. W Kotlin CodeGen ważna jest możliwość wystąpienia wartości null w argumentach typu, podczas gdy w Java jest ona w większości ignorowana. Załóżmy np., że masz typ zwracany „Flow<foo>” i tabela jest pusta. W generowaniu kodu w języku Java nie spowoduje to żadnych problemów, ale w generowaniu kodu w języku Kotlin wystąpi błąd. Aby tego uniknąć, musisz użyć parametru „Flow<foo?\>” przy założeniu, że emitowana jest wartość null. </foo?\></foo\>

• Do Room dodano nowy artefakt wtyczki Room Gradle o identyfikatorze androidx.room, który rozwiązuje różne dotychczasowe problemy w Room dotyczące danych wejściowych i wyjściowych schematów za pomocą opcji procesora adnotacji Gradle. Więcej informacji znajdziesz w informacjach o wersji 2.6.0-alfa02 pokoju.
• Klasy wartości w elementach pokoju są teraz obsługiwane przez KSP. (4194095)
• W Room obsługiwane są teraz zagnieżdżone typy zwracane mapy w funkcjach DAO. (I13f48, 203008711)

Wersja 2.6.0-rc01

20 września 2023 r.

androidx.room:room-*:2.6.0-rc01 został zwolniony. Wersja 2.6.0-rc01 zawiera te zatwierdzenia.

Wersja 2.6.0-beta01

23 sierpnia 2023 r.

androidx.room:room-*:2.6.0-beta01 został zwolniony. Wersja 2.6.0-beta01 zawiera te commity.

Poprawki błędów

• Obsługa specjalnego przypadku wyjątku SQLite podczas operacji upsert, gdy podczas operacji upsert wystąpił wyjątek 2067 SQLITE_CONSTRAINT_UNIQUE, upsert powinien wykonać aktualizację. (If2849, b/243039555)

Wersja 2.6.0-alpha03

9 sierpnia 2023 r.

androidx.room:room-*:2.6.0-alpha03 został zwolniony. Wersja 2.6.0-alfa03 zawiera te zatwierdzenia.

Nowe funkcje

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

Zmiany w interfejsie API

• Utworzono nowy typ adnotacji o nazwie @MapColumn, który zastąpił wycofany typ @MapInfo. W przypadku każdej nazwy kolumny (keyColumnName, valueColumnName lub obie) podanej w adnotacji @MapInfo musisz zadeklarować adnotację @MapColumn z samym columnName i użyć adnotacji w argumencie o określonym typie, do którego się odwołujesz (klucz lub wartość mapy) w typie zwracanym funkcji DAO. Dzieje się tak, ponieważ adnotacja @MapColumn jest używana bezpośrednio w argumencie type w typie zwracanym funkcji DAO, a nie w samej funkcji, np. @MapInfo. Więcej informacji znajdziesz w dokumentacji usługi @MapColumn. (Ib0305, b/203008711)
• Zaktualizowano pliki interfejsu API, aby dodać adnotacje do pominięcia 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ć globalne położenie dla wszystkich wariantów bez tworzenia wielu katalogów, co umożliwia płynniejsze migracje, ale też wystarczającą elastyczność, aby ręcznie konfigurować wariacje lub schematy typu kompilacji, zachowując przy tym zalety wtyczki (kompilacje możliwe do odtworzenia i zapisania w pamięci podręcznej). (I09d6f, b/278266663)

Poprawki błędów

• Usunięto potencjalną lukę w zabezpieczeniach pamięci w QueryInterceptorStatement. (I193d1)
• Naprawiono nieprawidłowe działanie funkcji QueryInterceptorDatabase execSQL(). (Iefdc8)

Wersja 2.6.0-alpha02

21 czerwca 2023 r.

Usługa androidx.room:room-*:2.6.0-alpha02 została zwolniona. Wersja 2.6.0-alfa02 zawiera te zatwierdzenia.

Wtyczka Gradle do pokoju

Ta nowa wersja zawiera nowy artefakt dla wtyczki Room 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 Gradle do pokoju konfiguruje projekt w taki sposób, że wygenerowane schematy są używane na potrzeby migracji automatycznych i są dane wyjściowe zadań kompilacji, które są prawidłowo skonfigurowane tak, aby miały możliwe do odtworzenia i buforowane kompilacje. Wtyczka udostępnia DSL do konfigurowania lokalizacji schematu podstawowego:

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

Następnie wtyczka skonfiguruje kompilator Room oraz różne zadania kompilacji i jego backendy (javac, KAPT, KSP), aby generować pliki schematu w folderach z dodatkowymi informacjami, np. schemas/flavorOneDebug/com.package.MyDatabase/1.json. Zwykle te pliki są sprawdzane w repozytorium, które służą 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 katalogów wersji utworzonych przez wtyczkę. 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 użytkowników i ustabilizujemy działanie wtyczki.

Zmiany w interfejsie API

• Usługa RoomDatabase.QueryCallback została zdefiniowana jako funkcjonalny interfejs umożliwiający użycie konwersji SAM. (Iab8ea, b/281008549)

Poprawki błędów

• Rozwiązanie problemu występującego podczas tworzenia instancji bazy danych w Robolectric po migracji źródeł sal z Javy do Kotlin. (Ic053c, b/274924903)

Wersja 2.6.0-alpha01

22 marca 2023 r.

Usługa androidx.room:room-*:2.6.0-alpha01 została zwolniona. Wersja 2.6.0-alpha01 zawiera te commity.

Nowe funkcje

• Obsługa klas wartości w pokoju w przypadku KSP Pokój może teraz obsługiwać klasy wartości w elementach. (4194095).
• Generowanie kodu Kotlin(lub „Kotlin CodeGen”) można teraz włączyć w pokoju (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ć, że zostały dodane dodatkowe ograniczenia. W Kotlinie nie można używać abstrakcyjnych właściwości jako metod getera DAO ani zapytań DAO. Zamiast tego należy je przepisać jako funkcje, aby uniknąć błędnego przekonania, że wartość właściwości jest niezmienna i ma ustalony wynik. Kolejnym dodanym ograniczeniem jest to, że w Room dla Kotlin CodeGen nie są już dozwolone typy zwracania kolekcji Nullable.

Ostrzeżenie: podczas korzystania z Kotlin CodeGen Twoje projekty mogą być bardziej restrykcyjne pod względem możliwości wystąpienia wartości null. W Kotlin CodeGen ważna jest możliwość wystąpienia wartości null w argumentach typu, podczas gdy w Java jest ona w większości ignorowana. Załóżmy np., że masz typ zwracany „Flow<foo>” i tabela jest pusta. W generowaniu kodu w języku Java nie spowoduje to żadnych problemów, ale w generowaniu kodu w języku Kotlin wystąpi błąd. Aby tego uniknąć, użyj instrukcji `Flow<foo?\>`, zakładając, że zostanie zwrócona wartość null. </foo?\></foo\>

Zmiany w interfejsie API

• Ochrona przed bezcelowym używaniem kolekcji z wartościami opcjonalnymi w typach zwracanych przez metody DAO. (I777dc, b/253271782, b/259426907)
• Dodaj interfejs API do tworzenia przepływu, który generuje zmiany narzędzia do śledzenia unieważnień. Interfejs API jest przydatny do tworzenia strumieni, które muszą reagować na zmiany w bazie danych. (I8c790, b/252899305)

Poprawki błędów

• Nie zezwalaj na właściwości abstrakcyjne w postaci modułów pobierających DAO ani zapytań DAO w codegencie Kotlin. Należy je tylko przepisywać jako funkcje, aby uniknąć fałszywego 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.

androidx.room:room-*:2.5.2 został zwolniony. Wersja 2.5.2 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązanie problemu z niezgodnością z kotlinx-metadata-jvm. (386d5c)
• Rozwiązaliśmy problem, który powodował wyświetlanie błędu w Room podczas testowania w Robolectric. (f79bea, b/274924903)

Wersja 2.5.1

Wersja 2.5.1

22 marca 2023 r.

androidx.room:room-*:2.5.1 został zwolniony. 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)
• Aby sprawdzić, czy baza danych jest już otwarta, użyj kontroli isOpenInternal. (E91fb35)
• Ulepszono obsługę okna reentrant w funkcji acquireTransactionThread() w Rooms. (219f98b). Podczas zawieszania transakcji Room używa wątku z wykonawcy transakcji, uruchamia w nim pętlę zdarzeń i przesyła do niej zawieszone operacje bazy danych, aby były one zakapsułowane w korobowej transakcji. Zwykle wątek transakcji różni się od tego, z którego została rozpoczęta transakcja, ale w niektórych przypadkach są takie same. Aby obsłużyć takie przypadki ponownego wywołania, funkcja withTransaction() została przebudowana, aby nie polegać już na zadaniu sterującym. Zamiast tego będzie ona wykonywać blok zawieszania transakcji z poziomu runBlocking w wątku transakcji.

Wersja 2.5.0

Wersja 2.5.0

22 lutego 2023 roku

Funkcje 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 są dostępne. Wersja 2.5.0 zawiera te zatwierdzenia.

Wersja 2.5.0

11 stycznia 2023 r.

androidx.room:room-*:2.5.0 został zwolniony. Wersja 2.5.0 zawiera te zatwierdzenia.

Ważne zmiany wprowadzone od wersji 2.4.0

• Wszystkie źródła room-runtime zostały przekonwertowane z języka Java na Kotlin. Pamiętaj, że jeśli Twój kod jest w Kotlinie, możesz napotkać problemy ze zgodnością źródeł z powodu konwersji biblioteki na Kotlin. Na przykład zmiana w znanym źródle, która powoduje niezgodność, polega na tym, że w funkcji InvalidationTracker musisz teraz zadeklarować onInvalidate() w funkcji Observer, aby mieć parametr typu Set, a nie MutableSet. Ponadto niektóre metody gettera zostały przekonwertowane na właściwości wymagające składni dostępu do właściwości w plikach Kotlin. Jeśli zauważysz istotne niezgodności, zgłoś błąd.
• Dodano nową adnotację skrótu @Upsert, która próbuje wstawić element, gdy nie ma konfliktu dotyczącego unikalności, lub zaktualizować element, jeśli występuje konflikt. (I7aaab, b/241964353)
• Do obsługi funkcji pagingu pokoi dodano nowe komponenty room-paging-rxjava2, room-paging-rxjava3 i room-paging-guava.
• Dodano interfejsy API do udostępniania nazw tabel kluczy i wartości w celu rozróżnienia w @MapInfo (Icc4b5)

Wersja 2.5.0-rc01

7 grudnia 2022 r.

Usługa androidx.room:room-*:2.5.0-rc01 została zwolniona. Wersja 2.5.0-rc01 zawiera te zatwierdzenia.

• Ta wersja jest identyczna z 2.5.0-beta02.

Wersja 2.5.0-beta02

9 listopada 2022 r.

Usługa androidx.room:room-*:2.5.0-beta02 została zwolniona. Wersja 2.5.0-beta02 zawiera te commity.

Zmiany w interfejsie API

• Poprawiliśmy różne interfejsy API, które przyjmują argumenty zapytania z invariant (Array<Any?>) na contravariant (Array<out Any?>), aby dopasować zachowanie tablicy do Java. (b/253531073)

Wersja 2.5.0-beta01

5 października 2022 r.

androidx.room:room-*:2.5.0-beta01 został zwolniony. Wersja 2.5.0-beta01 zawiera te commity.

Zmiany interfejsu API

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

Poprawki błędów

• Rozwiązaliśmy problem, który powodował nieprawidłowe wyeksportowanie tabel cieni do plików schematu .json, co powodowało ich uszkodzenie. (I4f83b, b/246751839)

Wersja 2.5.0-alpha03

24 sierpnia 2022 r.

androidx.room:room-*:2.5.0-alpha03 został zwolniony. Wersja 2.5.0-alpha03 zawiera te commity.

Nowe funkcje

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

Poprawki błędów

• Podczas automatycznej migracji podczas sprawdzania ograniczeń klucza obcego Room zwraca teraz wartość SQLiteConstraintException zamiast IllegalStateException. (I328dd)
• Naprawić zmianę w źródle Kotlina, która powoduje niezgodność z metodami gettera / właściwościami getOpenHelper, getQueryExecutor i getTransactionExecutor. (Iad0ac)

Wersja 2.5.0-alpha02

1 czerwca 2022 r.

androidx.room:room-*:2.5.0-alpha02 został zwolniony. Wersja 2.5.0-alpha02 zawiera te commity.

Nowe funkcje

• Dodano nowe elementy room-paging room-paging-rxjava2, room-paging-rxjava3 i room-paging-guava, aby obsługiwać przekierowanie do pokoju.(41a1d4,b/203666906),(eb6098, b/203666906),(1b9ae4, b/203666906)

Zmiany w interfejsie API

• Wszystkie pliki room-runtime zostały przekonwertowane z języka Java na Kotlin. (If2069, b/206859668),(Ie4b55, b/206859668), (I697ee, b/206859668), (I96c25, b/265b/268}

  Uwaga: z powodu konwersji biblioteki na Kotlin mogą wystąpić problemy ze zgodnością źródła. Jeśli Twój kod był w Kotlinie i wywoływał starą wersję Room, nowa wersja będzie musiała obsługiwać te przypadki. Na przykład zmiana w znanym źródle, która powoduje niezgodność, polega na tym, że w funkcji InvalidationTracker musisz teraz zadeklarować onInvalidate() w funkcji Observer, aby mieć parametr typu Set, a nie MutableSet.

• Dodano interfejsy API do udostępniania nazw tabel kluczy i wartości w celu rozróżnienia w @MapInfo (Icc4b5)
• Rozwiązanie problemu ze zgodnością ze źródłem, aby ponownie zezwolić na @Ignore w metodach dostępu do właściwości. (Ifc2fb)

Poprawki błędów

• Heurystyczny algorytm rozwiązywania problemu zduplikowanych kolumn. Room będzie teraz próbować rozwiązywać niejednoznaczne kolumny w zapytaniu wielomapowym. Dzięki temu operatory JOIN z tabelami zawierającymi tabele o tej samej nazwie mogą być prawidłowo mapowane na obiekt danych wynikowych. (I4b444, b/201306012, b/212279118)

Wersja 2.5.0-alpha01

23 lutego 2022 r.

androidx.room:room-*:2.5.0-alpha01 został zwolniony. Wersja 2.5.0-alpha01 zawiera te commity.

Zmiany w interfejsie API

• Rozwiązaliśmy problem, który powodował, że w źródłach kodu Kotlin nie było wymuszane używanie Room @IntDef. (I75f41, b/217951311)
• Rozwiązaliśmy problem ze zgodnością ze źródłem, aby ponownie zezwolić na @Query w metodach Getter właściwości. (I0a09b)
• Przekonwertowano pokój-common z Javy na Kotlin. (I69c48, b/206858235)

  Uwaga: podczas konwertowania biblioteki na Kotlina niektóre właściwości zostały przeniesione do obiektów towarzyszących, więc możesz napotkać problemy z niezgodnością źródeł. Jeśli Twój kod był w języku Kotlin i wywoływał starszą wersję Room, nowa wersja będzie potrzebować przywołania sufiksu „.Companion” podczas uzyskiwania dostępu do tych właściwości.

• Konwersja funkcji room-migration z Java na Kotlin. (I2724b, b/206858622)
• Przekonwertowano pliki paging w folderze room-runtime z języka Java na Kotlin. (I82fc8, b/206859668)
• Dodano interfejs API do blokowania i używania wieloprocesowych procesów na poziomie FrameworkSQLite*, aby chronić tworzenie i migracje baz danych w ramach pierwszej sesji obejmującej wiele procesów. (Ied267, b/193182592)

Poprawki błędów

• Dodaliśmy obsługę właściwości wewnętrznych w źródłach w języku Kotlin. Jest to niewielkie zmiany zachowania w Room, gdzie podczas dopasowywania właściwości do funkcji jako funkcji pobierających i zmieniających wartości będzie używana nazwa źródłowa funkcji (wcześniej używano nazwy funkcji w JVM, która jest inna w przypadku funkcji i właściwości wewnętrznych). Jeśli używasz niestandardowych adnotacji @JvmName, aby dopasowywać metody getter i setter do prywatnych właściwości, sprawdź wygenerowany kod po aktualizacji (If6531, b/205289020).

Wersja 2.4.3

Wersja 2.4.3

27 lipca 2022 roku

Usługa androidx.room:room-*:2.4.3 została zwolniona. 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 Kotlinie 1.7 (b/236612358).

Wersja 2.4.2

Wersja 2.4.2

23 lutego 2022 r.

androidx.room:room-*:2.4.2 został zwolniony. Wersja 2.4.2 zawiera te commity.

Poprawki błędów

• Rozwiązano problem z generowaniem kodu dla funkcji zawieszania Dao @Transaction z ciałem generującym domyślną metodę interfejsu z powodu kompilacji z użyciem -Xjvm-default=all lub równoważnego narzędzia. (Ia4ce5).
• Rozwiązanie błędu, w którym Room generuje kod dla metody zapytania o typ zwracania Array<ByteArray>. (If086e, b/213789489)

Wersja 2.4.1

Wersja 2.4.1

12 stycznia 2022 r.

Usługa androidx.room:room-*:2.4.1 została zwolniona. 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 w języku Kotlin. Jest to niewielkie zmiany zachowania w Room, gdzie podczas dopasowywania właściwości do funkcji jako funkcji pobierających i zmieniających wartości będzie używana nazwa źródłowa funkcji (wcześniej używano nazwy funkcji w JVM, która jest inna w przypadku funkcji i właściwości wewnętrznych). Jeśli używasz niestandardowych adnotacji @JvmName, aby dopasować metody pobierania/seterów do właściwości prywatnych, dokładnie sprawdź wygenerowany kod po aktualizacji (If6531, b/205289020).

Wersja 2.4.0

Wersja 2.4.0

15 grudnia 2021 roku

androidx.room:room-*:2.4.0 został zwolniony. Wersja 2.4.0 zawiera te commity.

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 Room wiedziało, że ma wygenerować automatyczną migrację, możesz użyć nowej właściwości @Database#autoMigrations, aby określić wersje, między którymi ma nastąpić automatyczna migracja. Gdy Room potrzebuje dodatkowych informacji dotyczących tabel i zmian nazw lub usunięcia kolumn, adnotacja @AutoMigration może zadeklarować klasę specyfikacji zawierającą takie dane wejściowe. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją @AutoMigration.
• Wstrzykiwanie zależności w ramach automatycznych migracji: @ProvidedAutoMigrationSpec to nowy interfejs API do deklarowania, że AutoMigrationSpec zostanie dostarczony w czasie działania za pomocą RoomDatabase.Builder#addAutoMigrationSpec(). Umożliwia to frameworkowi do wstrzykiwania zależności udostępnianie takich specyfikacji, gdy potrzebne są złożone zależności.
• Obsługa narzędzia do testowania migracji w przypadku automatycznych migracji: funkcja MigrationTestHelper w Room została zaktualizowana, aby obsługiwać automatyczne migracje. Dodano nowy konstruktor interfejsu API, który przyjmuje testowaną klasę bazy danych. Dzięki temu pomocnik może automatycznie dodawać migracje automatyczne w ten sam sposób podczas runMigrationsAndValidate.
• Obsługa wywołania pokoju: udostępniono androidx.room:room-paging, który zapewnia obsługę natywnej funkcji Paging 3.0 w przypadku zapytań dotyczących pokoju zwracających androidx.paging.PagingSource.
• Relacyjne metody zapytań: pokój obsługuje teraz wiele metod zwracanych z użyciem wielu map metod @Dao, które są przydatne w przypadku instrukcji JOIN. Obsługiwane typy multimap to Map, SparseArray, LongSparseArray oraz ImmutableMap, ImmutableSetMultimap i ImmutableListMultimap Gujawy.

Wersja 2.4.0-rc01

1 grudnia 2021 r.

Usługa androidx.room:room-*:2.4.0-rc01 została zwolniona. Wersja 2.4.0-rc01 zawiera te zatwierdzenia.

Nowe funkcje

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

Wersja 2.4.0-beta02

17 listopada 2021 r.

Usługa androidx.room:room-*:2.4.0-beta02 została zwolniona. Wersja 2.4.0-beta02 zawiera te commity.

Nowe funkcje

• Dodaliśmy obsługę tablic rzadkich i tablic rzadkich długich w @MapInfo. (Ic91a2b/138910317)

Poprawki błędów

• Dodaliśmy nowy analizator TypeConverter, który uwzględnia informacje o możliwości wystąpienia wartości null w typach. Te informacje są dostępne tylko w KSP, dlatego domyślnie są włączone tylko w tym narzędziu. Jeśli powoduje to problemy, możesz go wyłączyć, przekazując room.useNullAwareTypeAnalysis=false do procesora adnotacji. Jeśli tak się stanie, zgłoś błąd, a ten flaga zostanie w przyszłości usunięta. W przypadku tego nowego analizatora TypeConverter zalecamy podawanie tylko TypeConverters, które przyjmują wartości niezerowe, ponieważ nowy analizator ma możliwość owijania ich za pomocą sprawdzania wartości null. Pamiętaj, że ta zmiana nie ma wpływu na użytkowników, którzy używają procesorów adnotacji KAPT lub Java (w przeciwieństwie do KSP), ponieważ nie mają informacji o możliwości wystąpienia wartości null w typach. (Ia88f9, b/193437407)
• Naprawiliśmy błąd, który powodował, że Room nie mógł zostać skompilowany z błędem SQL, gdy element FTS zadeklarował użycie zliczarki ICU. (I00db9, b/201753224)
• Rozwiązaliśmy problem z automatycznymi migracjami związany z dodawaniem nowej kolumny do umieszczonego elementu między wersjami. (I5fcb1b/193798291)
• Rozwiązaliśmy problem z typami zwracanymi przez relacyjną metodę zapytań w zapytaniach LEFT JOIN. Dzięki tym zmianom w przypadku mapowania 1-wiele kolekcja zwrócona dla klucza nie będzie zawierać obiektu nieprawidłowej 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 nie udało się zmienić znaczenia słów kluczowych SQLite w nazwach kolumn. (Idbed4b/197133152)

Wersja 2.4.0-beta01

13 października 2021 r.

androidx.room:room-*:2.4.0-beta01 został zwolniony. Wersja 2.4.0-beta01 zawiera te commity.

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że podczas automatycznej migracji nie dodawano nowych kolumn, gdy inna tabela w ramach tej samej automatycznej migracji miała nową kolumnę o tej samej nazwie. (Ia5db5, b/200818663)
• Implementacja PagingSource wygenerowana przez room-paging używa teraz wartości queryExecutor przekazanej przez RoomDatabase.Builder, dzięki czemu można ją zastąpić zamiast Dispatchers.IO, jak to miało miejsce wcześniej. (Iae259)

Wersja 2.4.0-alpha05

29 września 2021 r.

androidx.room:room-*:2.4.0-alpha05 został zwolniony. Wersja 2.4.0-alpha05 zawiera te commity.

Nowe funkcje

• Dodano wbudowany konwerter typu dla UUID. (I671e8, b/73132006)

Zmiany w interfejsie API

• Dodaliśmy do adnotacji TypeConverters nową właściwość, aby umożliwić programistom wyłączenie wbudowanych konwerterów Enum i UUID. Domyślnie te konwertery są włączone, ale możesz je wyłączyć dla określonego zakresu lub dla całej bazy danych. Więcej informacji znajdziesz w dokumentacji TypeConverters. (36ae9e, b/195413406)

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

Kolumna @MapInfo będzie wymagana, gdy kolumna klucza lub wartości na mapie pochodzi z jednej kolumny. 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, gdy używasz strony 3 z pokojem. (Ieaffe)

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że wyniki zapytań obejmujących wiele map nie były uporządkowane, gdy zapytanie zawierało klauzulę ORDER BY dla kolumny z klucza mapy. (I6B887)

Darowizna zewnętrzna

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

Wersja 2.4.0-alpha04

21 lipca 2021 r.

androidx.room:room-*:2.4.0-alpha04 został zwolniony. Wersja 2.4.0-alpha04 zawiera te commity.

Nowe funkcje

• Room obsługuje teraz typy zwracane multimap @Dao, które są przydatne w przypadku instrukcji JOIN. Obsługiwane typy map wieloelementowych to Map oraz ImmutableMap, ImmutableSetMultimap i ImmutableListMultimap z Guavy.

  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 mapa wieloelementowa)

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

  Wynik wielomapy może być również zapakowany w obsługiwane asynchroniczne typy zwracania, takie jak LiveData, Observable z Rx lub coroutines Flow.

Wybieranie pokoju

• Udostępniamy usługę androidx.room:room-paging, która zapewnia natywną obsługę stronicowania w wersji 3.0 w przypadku zapytań o pokoje zwracających wartość 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 pokój na podstawie interfejsów API stronicowania 3.0. Nowa implementacja PagingSource analizuje klucze inaczej, więc każdy klucz podany ręcznie do PagingSource w Room musiałby uwzględniać tę zmianę zachowania, w tym klucz początkowy przekazany przez konstruktor Pagera. Strony zaczną się wczytywać od Key, a pierwszym wczytywanym elementem będzie Key. Odbiega to od obecnego sposobu działania, 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.

• Ten element jest opcjonalny. Jeśli z niego zrezygnujesz, zostanie przywrócone dotychczasowe wsparcie dla wersji Paging 3.0, która została wprowadzona w Room 2.3. W przyszłej wersji funkcja ta stanie się obowiązkowa dla użytkowników korzystających z pokoju z systemem pagingu 3.0. Aby to zrobić, dodaj nowy artefakt strony pomieszczenia do classpath. 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

• Naprawiono błąd automatycznej migracji dotyczący obsługi naruszeń kluczy obcych. (B/190113935)

Wersja 2.4.0-alpha03

16 czerwca 2021 r.

Usługa androidx.room:room-*:2.4.0-alpha03 została zwolniona. Wersja 2.4.0-alpha03 zawiera te commity.

Zmiany interfejsu API

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

Poprawki błędów

• Rozwiązano problem z biblioteką natywną SQLite w Room, aby obsługiwała procesory Apple M1. (b/174695268

• Rozwiązaliśmy problem polegający na tym, że Room nie generował błędu, gdy typ zwracany przez funkcję @Transaction był typu Flow (I56ddd, b/190075899).

• Rozwiązanie problemu z automatyczną migracją dotyczącym indeksów. b/177673291

Aktualizacje zależności

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

Wersja 2.4.0-alpha02

5 maja 2021 roku

Usługa androidx.room:room-*:2.4.0-alpha02 została zwolniona. Wersja 2.4.0-alpha02 zawiera te commity.

Zmiany w interfejsie API

• @ProvidedAutoMigrationSpec to nowy interfejs API służący do deklarowania, że AutoMigrationSpec zostanie dostarczony w czasie wykonywania za pomocą RoomDatabase.Builder#addAutoMigrationSpec(). Umożliwia to frameworkowi do wstrzykiwania zależności udostępnianie takich specyfikacji, gdy potrzebne są złożone zależności.

Poprawki błędów

• Rozwiązaliśmy problem z automatycznymi migracjami, w których @DatabaseView nie były prawidłowo ponownie tworzone.

Darowizna zewnętrzna

• Rozwiązaliśmy problem w JournalMode.TRUNCATE w Room, w którym wywołanie zwrotne InvalidationTracker było czasami wywoływane nieprawidłowo, zbyt późno lub wcale. Dziękujemy Uli Bubenheimer | [email protected] (b/154040286).

Wersja 2.4.0-alpha01

21 kwietnia 2021 r.

androidx.room:room-*:2.4.0-alpha01 został zwolniony. Wersja 2.4.0-alpha01 zawiera te commity.

Nowe funkcje

• Automatyczne migracje: Room udostępnia teraz interfejs API do automatycznego generowania migracji, o ile schematy są eksportowane. Aby poinformować pokój o konieczności wygenerowania automatycznej migracji, można użyć nowej usługi @Database#autoMigrations do zadeklarowania wersji, z których mają być automatycznie przenoszone dane. Gdy sala potrzebuje dodatkowych informacji na temat zmian nazw lub usuwania tabel i kolumn, adnotacja @AutoMigration może zadeklarować klasę specyfikacji zawierającą takie dane wejściowe. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją @AutoMigration.

Poprawki błędów

• Rozwiązaliśmy problem, który powodował nieprawidłowe sprawdzanie poprawności defaultValue z dodatkowymi nawiasami przez Room. b/182284899

Wersja 2.3.0

Wersja 2.3.0

21 kwietnia 2021 r.

androidx.room:room-*:2.3.0 został zwolniony. Wersja 2.3.0 zawiera te commity.

Ważne zmiany od wersji 2.2.0

• Wbudowana obsługa wyliczenia: jeśli nie podano żadnej wartości, sala będzie domyślnie używać konwertera typu enum na ciąg znaków i na odwrót. Jeśli konwerter typu dla typu zbiorczego już istnieje, Room będzie używać go zamiast domyślnego.
• Wywołanie zwrotne zapytania: Room udostępnia teraz ogólny interfejs API wywołania zwrotnego RoomDatabase.QueryCallback, który można wykorzystać do rejestrowania w edycjach debugowania. Oddzwanianie można ustawić w RoomDatabase.Builder#setQueryCallback().
• Wstępnie skompilowane ulepszenie: Room ma teraz interfejsy API do tworzenia bazy danych z użyciem wstępnie skompilowanej bazy danych odczytanej ze strumienia wejściowego. Pozwala to na przykład na skompresowanie bazy danych gotowej do użycia w pakiecie.
• Udostępniane konwertery typów: pokój ma teraz interfejsy API umożliwiające udostępnianie instancji konwerterów typów, aby aplikacja mogła kontrolować ich inicjowanie. Aby oznaczyć konwerter typu, który zostanie przekazany do Room, użyj nowej adnotacji @ProvidedTypeConverter.
• Obsługa RxJava3: Room obsługuje teraz typy RxJava3. Podobnie jak w przypadku RxJava2, możesz deklarować metody DAO, których typ zwracania to Flowable, Single, Maybe lub Completable. Dodatkowo dostępny jest nowy element androidx.room:room-rxjava3, który obsługuje RxJava3.
• Obsługa wywołania 3.0: Room będzie teraz generować implementacje dla metod z adnotacjami @Query, których typ zwracania to androidx.paging.PagingSource.

Wersja 2.3.0-rc01

24 marca 2021 r.

androidx.room:room-*:2.3.0-rc01 został zwolniony. 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 bloku zawieszania withTransaction. (I797bf)

Wersja 2.3.0-beta03

10 marca 2021 r.

Usługa androidx.room:room-*:2.3.0-beta03 została zwolniona. Wersja 2.3.0-beta03 zawiera te zatwierdzenia.

Nowe funkcje

• Dodano obsługę kompilacji przyrostowej dla KSP. (I031c1, b/176453350)

Poprawki błędów

• Naprawiono błąd polegający na tym, że utworzenie PagingSource w wątku głównym mogło wywołać błąd ANR. (I42b74, b/181221318)
• Poprawiono widoczność @ExperimentalRoomApi, która jest teraz publiczna, a nie prywatna. (b/181356119)

Darowizna zewnętrzna

• Umożliw Room akceptowanie typu zwracanego POJO w metodzie DAO z adnotacją @Query, gdy jest ona też opatrzona adnotacją @SkipQueryVerification. Room dołoży wszelkich starań, aby wynik zapytania został przekonwertowany na typ zwracany POJO w taki sam sposób jak w przypadku metody DAO z adnotacją @RawQuery. Dziękujemy „Markus Riegel | [email protected]” (I45acb).

Wersja 2.3.0-beta02

18 lutego 2021 r.

androidx.room:room-*:2.3.0-beta02 został zwolniony. Wersja 2.3.0-beta02 zawiera te commity.

Nowe funkcje

• W usłudze Room dostępna jest teraz eksperymentalna obsługa przetwarzania symboli Kotlina KSP.

  KSP zastępuje KAPT i pozwala na uruchamianie procesorów adnotacji natywnie w kompilatorze Kotlina, co znacznie skraca czas kompilacji.

  Aby używać pokoju z KSP, możesz zastosować wtyczkę do Gradle KSP i zastąpić konfigurację kapt w pliku kompilacji kodem 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'. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją KSP.

  Pamiętaj, że KSP jest w fazie eksperymentalnej, dlatego zalecamy używanie KAPT w przypadku kodu produkcyjnego. Skrócenie czasu kompilacji ma zastosowanie tylko wtedy, gdy nie ma innych procesorów, które korzystają z KAPT. Znane problemy znajdziesz w problemie b/160322705.

Wersja 2.3.0-beta01

27 stycznia 2021 r.

androidx.room:room-*:2.3.0-beta01 został zwolniony. Wersja 2.3.0-beta01 zawiera te zatwierdzenia.

Nowe funkcje

• Automatycznie zamykanie baz danych: Room może teraz zamykać bazy danych, do których nie ma dostępu po upływie określonego czasu. To jest funkcja eksperymentalna, którą można włączyć, wywołując funkcję RoomDatabase.Builder#setAutoCloseTimeout(). Ta funkcja jest przydatna w przypadku aplikacji z większą liczbą baz danych.

Poprawki błędów

• Rozwiązano problem, który powodował, że metody Dao z wieloma metodami @Update lub @Delete z różnymi strategiami konfliktowymi generowały kod tylko z jedną z tych strategii, ignorując zdefiniowaną. (/I0b90d, b/176138543)

Wersja 2.3.0-alfa04

16 grudnia 2020 roku

Usługa androidx.room:room-*:2.3.0-alpha04 została zwolniona. Wersja 2.3.0-alpha04 zawiera te commity.

Nowe funkcje

• Room oferuje teraz ogólny interfejs wywołania zwrotnego API RoomDatabase.QueryCallback, który można wykorzystać do logowania w edycjach debugowania. Można go użyć, gdy zapytania mają zostać wykonane. Wywołanie zwrotne można skonfigurować za pomocą RoomDatabase.Builder#setQueryCallback(). (Iaa513, b/174478034, b/74877608)
• W pokoju domyślnie będzie używany konwerter typu Enum na ciąg znaków i na odwrót, jeśli nie zostanie podana żadna wartość. Jeśli istnieje już konwerter typów dla wyliczenia, sala będzie używać go w pierwszej kolejności, a nie domyślnego. (b/73132006)

Znany problem

• Jeśli istnieje już konwerter jednokierunkowy do odczytu dla enum, pokój może przypadkowo użyć wbudowanego konwertera String to Enum, co może być niepożądane. To znany problem, który można rozwiązać, ustawiając dwukierunkowy konwerter. Patrz: b/175707691

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że Room nieprawidłowo wyłączał stopniowe przetwarzanie adnotacji w nowszych wersjach JDK. (b/171387388)
• Rozwiązaliśmy problem z funkcja Room, która znajdowała wygenerowaną klasę, gdy używano wielu ładowarek klas. Dziękuję za poprawkę „Serendipity | [email protected]” (b/170141113).
• Rozwiązaliśmy problem, który powodował, że funkcja Room generowała nieprawidłowy kod, gdy obiekt @Dao Kotlin miał klasę bazową, której generacje ogólne są elementami podstawowymi w JVM. (b/160258066)

Treści tłumaczone przez użytkowników zewnętrznych

• Jeśli tryb WAL jest włączony, a interfejs API ma co najmniej 16 bitów, pokój będzie domyślnie używać beginTransactionNonExclusive. Dziękujemy Ahmedowi I. Khalil | [email protected]’! (b/126258791)

Wersja 2.3.0-alpha03

14 października 2020 r.

androidx.room:room-*:2.3.0-alpha03 został zwolniony. Wersja 2.3.0-alpha03 zawiera te commity.

Nowe funkcje

• Room ma teraz interfejsy API do udostępniania instancji konwerterów typów, dzięki czemu aplikacja może kontrolować ich inicjalizację. Aby oznaczyć konwerter typu, który zostanie przekazany do pokoju, użyj nowej adnotacji @ProvidedTypeConverter. Dziękujemy użytkownikowi „mzgreen [email protected]”. (Ie4fa5, b/121067210)

• Room ma teraz interfejsy API do tworzenia bazy danych przy użyciu wstępnie skompresowanej bazy danych odczytanej ze strumienia wejściowego. Umożliwia to m.in. skompresowanie bazy danych w ramach pakietu. Dziękujemy użytkownikowi „Ahmed El-Helw” ([email protected]) (3e6792, b/146911060).

Zmiany interfejsu API

• Dodano brakujący cel do adnotacji @ForeignKey, aby zapobiec jej używaniu poza adnotacją @Entity. (Iced1e)

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

Poprawki błędów

• Zaktualizuj dokumentację TypeConverters, aby doprecyzować, że można jej używać tylko do konwertowania kolumn / pol, a nie wierszy. (I07c56, b/77307836)

• Zaktualizuj DaoProcessor, aby naprawić błąd kompilatora w przypadku typu super typu ogólnego Dao z „prostymi” typami Kotlina. (Ice6bb, b/160258066)

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

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

Wkład zewnętrzny

• Rozwiązanie problemów z lokalizacją w języku tureckim (5746e3) i b/68159494 związanych z wielkimi i małymi literami.

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

• Dodaj wywołanie zwrotne onOpenPrepackagedDatabase, gdy kopiowana jest wstępnie zapakowana baza danych. (I1ba74, b/148934423)

Wersja 2.3.0-alfa02

22 lipca 2020 r.

androidx.room:room-*:2.3.0-alpha02 został zwolniony. Wersja 2.3.0-alpha02 zawiera te commity.

Nowe funkcje

• Obsługa RxJava3: Room obsługuje teraz typy RxJava3. Podobnie jak w przypadku RxJava2, możesz deklarować metody DAO, których typ zwracania to Flowable, Single, Maybe lub Completable. Dostępny jest też nowy artefakt androidx.room:room-rxjava3 do obsługi RxJava3. (b/152427884)

Zmiany w interfejsie API

• Deklarowanie obiektu @TypeConverter w klasie obiektu Kotlin jest teraz obsługiwane. (B/151110764)
• Opcja stopniowego przetwarzania adnotacji pokoju jest teraz domyślnie włączona. (b/112110217)

Wersja 2.3.0-alpha01

10 czerwca 2020 r.

Usługa androidx.room:room-*:2.3.0-alpha01 została zwolniona. Wersja 2.3.0-alpha01 zawiera te commity.

Nowe funkcje

• Obsługa strony AMP 3.0: sala będzie teraz obsługiwać generowanie implementacji dla @Query metod z adnotacjami, dla których zwracany jest typ 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 powoduje, ż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 zamiast zapytań z optymalizacją sal z projekcjami gwiazd. Pamiętaj, że funkcja @RewriteQueriesToDropUnusedColumns nie zastępuje dostępnego rozwiązania room.expandProjection konfliktu kolumn w przypadku typów zwracanych zawierających pola @Embedded.

Poprawki błędów

• Naprawienie błędu polegającego na tym, że Room nie wykrywał prawidłowo wersji JDK używanej do włączenia procesora adnotacji przyrostowej. Dzięki Blaz Solar ([email protected]) (b/155215201)
• Room teraz umieszcza 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

androidx.room:room-*:2.2.6 został zwolniony. Wersja 2.2.6 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że Room nieprawidłowo wyłączał stopniowe przetwarzanie adnotacji w nowszych wersjach JDK. (b/171387388)

Wersja 2.2.5

Wersja 2.2.5

18 marca 2020 r.

Usługa androidx.room:room-*:2.2.5 została zwolniona. Wersja 2.2.5 zawiera te zatwierdzenia.

Poprawki błędów

• Ustaw MultiInstanceInvalidationService jako directBootAware. Podziękowania od „Mygod [email protected]” (b/148240967)
• Naprawiliśmy błąd, który powodował awarię, gdy włączona była anulacja wielu instancji, a baza danych zawierała większą liczbę encji FTS. (b/148969394)
• Rozwiązaliśmy problem, który występował podczas wczytywania natywnych bibliotek SQLite w procesorze adnotacji w pokoju, który powodował awarię kompilatora ze względu na kompilację równoległą. (b/146217083)

Wersja 2.2.4

Wersja 2.2.4

19 lutego 2020 r.

Udostępniono 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. Wersja 2.2.4 zawiera te commity.

Poprawki błędów

• Rozwiązaliśmy problem z zawieszaniem transakcji, które powodowały zakleszczenie, jeśli współrzędna została anulowana szybko przed faktycznym rozpoczęciem transakcji. (b/148181325)
• Rozwiązaliśmy problem z nieprawidłowym używaniem adnotacji @Generated podczas kompilowania za pomocą JDK 9. (b/146538330)
• Rozwiązaliśmy problem, który powodował, że Room generował nieprawidłowy kod, gdy interfejs DAO w Kotlinie miał konkretną funkcję. (b/146825845)

Wersja 2.2.3

Wersja 2.2.3

18 grudnia 2019 r.

Usługa androidx.room:room-*:2.2.3 została zwolniona. Wersja 2.2.3 zawiera te commity

Poprawki błędów.

• Rozwiązaliśmy błąd, który powodował, że Room nie sprawdzał poprawności bazy danych, która nie przeszła migracji i zawierała stary hasz z indektami w swoim schemacie. (b/139306173)

Wersja 2.2.2

Wersja 2.2.2

20 listopada 2019 r.

androidx.room:room-*:2.2.2 został zwolniony. 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 zwracanie przez Room pustych elementów powiązanych. (B/143105450)

Wersja 2.2.1

Wersja 2.2.1

23 października 2019 r.

Usługa androidx.room:room-*:2.2.1 została zwolniona. Wersja 2.2.1 zawiera te zatwierdzenia

Poprawki błędów.

• Naprawiliśmy błąd, który powodował, że Room nieprawidłowo ostrzegało o CURSOR_MISMATCH przy włączonej opcji kompilatora expandProjection. (b/140759491)
• Dodano mechanizm ponawiania prób obsługi brakującej biblioteki natywnej używanej do weryfikacji zapytań podczas kompilowania.

Wersja 2.2.0

Wersja 2.2.0

9 października 2019 r.

androidx.room:room-*:2.2.0 został zwolniony. Wersja 2.2.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.1.0

• Gotowa baza danych: dostępne są dwa nowe interfejsy API w RoomDatabase.Builder do tworzenia RoomDatabase dla już wypełnionego pliku bazy danych. Wartość createFromAsset() oznacza, że wstępnie wypełniony plik bazy danych znajduje się w folderze zasobów pliku APK, a wartość createFromFile() – że plik znajduje się w dowolnym miejscu. Zastosowanie tych interfejsów API zmienia działanie migracji niszczycielskich, tak aby podczas migracji zapasowej Room próbował ponownie skopiować wstępnie wypełnioną bazę danych (jeśli jest dostępna), a w przeciwnym razie po prostu usuwał i ponownie tworzył wszystkie tabele. b/62185732
• Domyślne wartości schematu: @ColumnInfo ma teraz nową właściwość defaultValue, która może służyć do określania domyślnej wartości kolumny. Wartości domyślne są częścią schematu bazy danych i zostaną zweryfikowane 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 służącą do zadeklarowania relacji, którą należy spełnić za pomocą tabeli połączeń (tzw. tabeli łączenia). b/69201917
• Relacje jeden-do-jednego: zniesiono ograniczenie dotyczące pól typu POJO z adnotacją @Relation, które muszą być typu List lub Set. Dzięki temu można reprezentować relacje jednowartościowe.b/62905145
• Jednostka docelowa: adnotacje DAO @Insert, @Update i @Delete mają teraz nową właściwość targetEntity, która umożliwia określenie tabeli docelowej, do której ma działać metoda DAO. Dzięki temu parametry tych metod DAO mogą być zwykłymi obiektami POJO, które są interpretowane jako częściowe jednostki. W praktyce umożliwia to częściowe wstawianie, usuwanie i aktualizowanie. b/127549506
• Procesy współbieżnych: metody @Query DAO mogą teraz zwracać typ Flow<T>. Jeśli tabele obserwacji w zapytaniu zostaną unieważnione, zwrócony przepływ ponownie utworzy nowy zbiór wartości. Zadeklarowanie funkcji DAO z typem zwracania Channel<T> jest błędem. Zamiast tego Room zaleca użycie funkcji Flow, a potem użycie funkcji sąsiednich, aby przekonwertować Flow na Channel. b/130428884
• Procesor adnotacji Gradle Incremental: Room jest teraz procesorem adnotacji Gradle, który izoluje i umożliwia zwiększanie za pomocą opcji procesora room.incremental. Więcej informacji znajdziesz w sekcji Opcje kompilatora pokoju. Jeśli napotkasz jakieś problemy, zgłoś je tutaj. W przyszłej wersji stabilnej planujemy włączyć możliwość zwiększania domyślnie. b/112110217
• Rozszerzanie projekcji: dodano nową eksperymentalną opcję kompilatora room.expandProjection, która powoduje, że Room przepisuje zapytanie z projekcją gwiazdy, aby zawierało tylko kolumny zwracane typu POJO. Na przykład w przypadku metody DAO o nazwie @Query("SELECT * FROM Song"), która zwraca obiekt POJO o nazwie SongIdAndTitle z tylko 2 polami. Następnie Room zmieni zapytanie na SELECT id, title FROM Song tak, aby pobrać minimalny zestaw kolumn odpowiadających typowi zwróconemu. Dzięki temu w zasadzie nie będzie wyświetlać się ostrzeżenieCURSOR_MISMATCH, które pojawia się, gdy zapytanie zwraca dodatkowe kolumny, które nie pasują do żadnego pola zwracanego typu POJO.

Wersja 2.2.0-rc01

5 września 2019 r.

Usługa androidx.room:room:2.2.0-rc01 została zwolniona. Zmiany zawarte w tej wersji znajdziesz tutaj.

Brak publicznych zmian od wersji 2.2.0-beta01.

Wersja 2.2.0-beta01

22 sierpnia 2019 r.

Usługa androidx.room:room-*:2.2.0-beta01 została zwolniona. Zmiany zawarte w tej wersji znajdziesz tutaj.

Poprawki błędów

• Rozwiązaliśmy błąd, który powodował, że po pewnym czasie zapytanie strumienia wydzielonego przestaje emitować nowe wartości. (b/139175786)
• Naprawiliśmy błąd, przez który Room nie akceptował starszego kodu szyfrowania schematu podczas otwierania bazy danych, która nie została przeniesiona od wersji Room 1.0. Powodowało to awarię podczas działania z powodu nieprawidłowego schematu. (b/139306173)

Wersja 2.2.0-alpha02

7 sierpnia 2019 r.

androidx.room:room-*:2.2.0-alpha02 został zwolniony. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Nowe funkcje

• Procesy współbieżnych: metody @Query DAO mogą teraz zwracać typ Flow<T>. Jeśli tabele obserwacji w zapytaniu zostaną unieważnione, zwrócony przepływ ponownie utworzy nowy zbiór wartości. Zadeklarowanie funkcji DAO z typem zwracania Channel<T> jest błędem. Zamiast tego Room zaleca użycie funkcji Flow, a potem użycie funkcji sąsiednich, aby przekonwertować Flow na Channel. b/130428884
• Rozszerzanie projekcji: dodano nową eksperymentalną opcję kompilatora room.expandProjection, która powoduje, że Room przepisuje zapytanie z projekcją gwiazdy, aby zawierało tylko kolumny zwracane typu POJO. Na przykład w przypadku metody DAO o nazwie @Query("SELECT * FROM Song"), która zwraca obiekt POJO o nazwie SongIdAndTitle z tylko 2 polami. Następnie Room zmieni zapytanie na SELECT id, title FROM Song tak, aby pobrać minimalny zestaw kolumn odpowiadających typowi zwróconemu. Dzięki temu w zasadzie nie będzie wyświetlać się ostrzeżenieCURSOR_MISMATCH, które pojawia się, gdy zapytanie zwraca dodatkowe kolumny, które nie pasują do żadnego pola zwracanego typu POJO.
• onDestructiveMigrate to nowy interfejs wywołania zwrotnego dodany do RoomDatabase.Callback na wypadek, gdy Room musi przeprowadzić migrację bazy danych w trybie destruktywnym. b/79962330

Poprawki błędów

• Naprawiliśmy błąd, który powodował, że Room generował nieprawidłowy kod, używając metody jako settera pola, gdy pole jest chronione.b/136194628
• Naprawiono błąd, który powodował, że InvalidationTracker wywoływał NPE w drugim procesie, gdy włączono anulowanie wielu instancji i usługa anulowania została zakończona. b/137454915
• Naprawienie błędu polegającego na tym, że Room nieprawidłowo rozpoznawał typ zwracany przez dziedziczoną funkcję zawieszania opatrzoną adnotacją @RawQuery. b/137878827
• Zaktualizowano wygenerowany kod dla @Relation, gdy klucz powiązany jest typu BLOB, aby używać ByteBuffer, który jest porównywalny. b/137881998
• Naprawiliśmy błąd, który powodował, że Room zgłasza brak setterów w obiektowych typach danych używanych jako parametry częściowych jednostek @Insert, @Update i @Delete. b/138664463
• Naprawiliśmy błąd, który powodował, że usługa Room narzekała na brakujące metody pobierania i seterów dla ignorowanej kolumny za pomocą funkcji @Entity, gdy w określonych metodach DAO była używana klasa encji. b/138238182
• Naprawiliśmy błąd, który powodował, że Room nieprawidłowo konwertował nazwane argumenty wiązania na argumenty pozycyjne, co powodowało wyjątek czasu wykonywania podczas wykonywania zapytania z wykorzystywanymi ponownie parametrami. b/137254857

Wersja 2.2.0-alpha01

10 lipca 2019 r.

Nowe funkcje

• Gotowa baza danych: w interfejsie RoomDatabase.Builder dostępne są teraz 2 nowe interfejsy API do tworzenia pliku RoomDatabase na podstawie już wypełnionego pliku bazy danych. Wartość createFromAsset() oznacza, że wstępnie wypełniony plik bazy danych znajduje się w folderze zasobów pliku APK, a wartość createFromFile() – że plik znajduje się w dowolnym miejscu. Zastosowanie tych interfejsów API zmienia działanie migracji niszczycielskich, tak aby podczas migracji zapasowej Room próbował ponownie skopiować wstępnie wypełnioną bazę danych (jeśli jest dostępna), a w przeciwnym razie po prostu usuwał i ponownie tworzył wszystkie tabele. b/62185732
• Wartości domyślne schematu: element @ColumnInfo ma teraz nową właściwość defaultValue, która może służyć do określania wartości domyślnej kolumny. Wartości domyślne są częścią schematu bazy danych i zostaną zweryfikowane podczas migracji, jeśli zostaną określone. b/64088772

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

• Relacje wiele do wielu: @Relation ma teraz nową właściwość associateBy, która przyjmuje nową adnotację @Junction służącą do zadeklarowania relacji, którą należy spełnić za pomocą tabeli połączeń (tzw. tabeli łączenia). b/69201917
• Relacje jeden-do-jednego: zniesiono ograniczenie dotyczące pól typu POJO z adnotacją @Relation, które muszą być typu List lub Set. Dzięki temu można reprezentować relacje jednowartościowe.b/62905145
• Jednostka docelowa: adnotacje DAO @Insert, @Update i @Delete mają teraz nową właściwość targetEntity, która umożliwia określenie tabeli docelowej, do której ma działać metoda DAO. Dzięki temu parametry tych metod DAO mogą być dowolnymi obiektami POJO, które będą interpretowane jako częściowe wystąpienia. W praktyce umożliwia to częściowe wstawianie, usuwanie i aktualizowanie. b/127549506
• Procesor adnotacji przyrostowych Gradle: sala jest teraz procesorem izolującym adnotacje w Gradle. Możliwość zwiększania wartości można włączyć za pomocą opcji procesora room.incremental. Więcej informacji znajdziesz w sekcji Opcje kompilatora pokoju. Jeśli napotkasz jakieś problemy, zgłoś je tutaj. W przyszłej wersji stabilnej planujemy włączyć możliwość zwiększania domyślnie. b/112110217

Poprawki błędów

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

Wersja 2.1.0

Wersja 2.1.0

13 czerwca 2019 r.

Zwolniono pokój 2.1.0 bez zmian w pokoju 2.1.0-rc01. Zmiany zawarte w tej wersji znajdziesz tutaj.

Ważne zmiany wprowadzone od wersji 2.0.0

• FTS: pokój obsługuje teraz elementy z tabeli mapowania FTS3 lub FTS4. Do klas z adnotacjami @Entity można teraz dodatkowo dodać adnotacje za pomocą @Fts3 lub @Fts4, aby zadeklarować klasę przy użyciu tabeli wyszukiwania pełnotekstowego mapowania. Opcje FTS do dalszej personalizacji są dostępne za pomocą metod adnotacji.
• Widoki: sala obsługuje teraz deklarowanie klasy jako zapisanego zapytania (nazywanego też widokiem) przy użyciu adnotacji @DatabaseView.
• Sytuacje: metody DAO mogą teraz być zawieszanymi funkcjami. Aby korzystać z tej funkcji, dodaj room-ktx do zależności. Element ktx zawiera też funkcję rozszerzenia RoomDatabase.withTransaction do wykonywania transakcji bazy danych w ramach współbieżnej funkcji.
• Auto Value: Room obsługuje teraz deklarowanie klas z adnotacją AutoValue jako obiektów 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 aby Room mogła je poprawnie zinterpretować, musisz też dodać adnotację @CopyAnnotations.
• Dodatkowe wsparcie asynchroniczne: metody DAO opatrzone adnotacjami @Insert, @Delete lub @Update, a także funkcje @Query zawierające instrukcje INSERT, DELETE lub UPDATE, obsługują teraz typy zwracane Rx Completable, Single, Maybe i typ zwracany Guavy ListenableFuture. Mogą one też być funkcjami zawieszania.
• enableMultiInstanceInvalidation to nowy interfejs API w RoomDatabase.Builder, który umożliwia unieważnienie wielu instancji RoomDatabase przy użyciu tego samego pliku bazy danych.
• fallbackToDestructiveMigrationOnDowngrade to nowy interfejs API w RoomDatabase.Builder, który automatycznie ponownie tworzy bazę danych, jeśli nastąpi obniżenie wersji.
• ignoredColumns to nowy interfejs API w adnotacji @Entity, który umożliwia wyświetlanie ignorowanych pól według nazwy.
• Sala będzie teraz prawidłowo używać głównego konstruktora Kotlina 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

• Rozwiązaliśmy błąd inicjalizowania pokoju, który mógł wystąpić z powodu już skonfigurowanej konfiguracji temp_store. b/132602198
• Naprawiono ostrzeżenie dotyczące użycia cudzysłowów dla użytkowników korzystających z SQLite w wersji 3.27.0 lub nowszej.b/131712640
• Naprawiono błąd, który powodował awarię InvalidationTrackera podczas równoległego przeprowadzania wielu weryfikacji nieważności. b/133457594

Wersja 2.1.0-beta01

7 maja 2019 r.

androidx.room 2.1.0-beta01 została wydana bez zmian w wersji 2.1.0-alpha07. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Wersja 2.1.0-alpha07

25 kwietnia 2019 r.

Zmiany interfejsu API / działania

• Funkcja rozszerzenia RoomDatabase.withTransaction została zmieniona tak, aby nie przyjmować już bloku funkcji z odbiornikiem CoroutineScope. Zapobiega to pomijaniu dodatkowego elementu coroutineScope { }, który jest wymagany do jednoczesnego wykonywania operacji w bloku transakcji.

Poprawki błędów

• Usunięto błąd, który powodował, że Room nie mógł dopasować typu TypeConverter do funkcji DAO w Kotlinie zawierającej parametr typu Collection. b/122066791

Wersja 2.1.0-alpha06

22 marca 2019 r.

Zmiany w interfejsie API i zachowaniu

• Zapytania dotyczące transakcji asynchronicznych są teraz serializowane, dzięki czemu Room nie będzie używać więcej niż 1 wątku do wykonywania transakcji bazy danych. Dodano RoomDatabase.Builder.setTransactionExecutor(Executor), aby umożliwić konfigurowanie wykonawcy na potrzeby transakcji.
• RoomDatabase.runInTransaction(Callable) nie będzie już dodawać zaznaczonych wyjątków do wyjątków środowiska wykonawczego. b/128623748

Poprawki błędów

• Usunięto błąd, który powodował, że licznik nieważności przestawał obserwować tabelę treści, jeśli dodano obserwatorów zarówno dla tabeli treści, jak i zewnętrznej tabeli FTS treści. b/128508917
• Gramatyka SQLite została zaktualizowana, tak aby była zgodna z gramatyką SQLite w wersji 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ółbieżnej funkcji. Funkcje rozszerzeń pokoju wraz z obsługą coroutines są dostępne w artefakcie room-ktx.
• Nieabstrakcyjne metody DAO otagowane jako @Transaction mogą teraz zawieszać funkcje. b/120241587

Zmiany w interfejsie API i zachowaniu

• Artefakt room-coroutines został przemianowany na room-ktx, aby zachować spójność nazewnictwa z innymi artefaktami androidx.
• Funkcje beginTransaction, setTransactionSuccessful i endTransaction w funkcji RoomDatabase zostały wycofane na rzecz funkcji runInTransaction i funkcji rozszerzenia room-ktx withTransaction.

Poprawki błędów

• Naprawiono błąd, który powodował, że argumenty tokenizera były pomijane, gdy używany był tokenizator, np. SIMPLE. b/125427014
• Naprawiono błąd polegający na tym, że Room nieprawidłowo rozpoznawał zawieszone funkcje z parametrami, których typ był klasą wewnętrzną. b/123767877
• Rozwiązano błąd polegający na tym, że opóźniona metoda @Query DAO z instrukcjami INSERT, UPDATE lub DELETE nadmiernie przygotowywała zapytanie w głównym wątku. b/123695593
• Naprawiono różne błędy, w których Room generował nieprawidłowy kod dla niektórych funkcji zawieszania. b/123466702 i b/123457323
• Naprawiono błąd, który powodował, że wycofane metody nie były prawidłowo pomijane w generowanym kodzie. b/117602586
• Zaktualizowano zależność Room od androidx.sqlite do wersji 1.0.2, która zawiera poprawki umożliwiające prawidłowe działanie uszkodzonych baz danych. b/124476912

Znane problemy

• Sala 2.1.0-alfa05 zależy od artefaktu kotlinx-metadata-jvm, który nie jest obecnie dostępny w Maven Central (KT-27991). Ten problem 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 opatrzone adnotacjami @Query, które zawierają instrukcje INSERT, UPDATE lub DELETE, mogą teraz zwracać asynchroniczne typy Single, Mayble, Completable i ListenableFuture. Dodatkowo można też zawiesić funkcje. b/120227284

Zmiany interfejsu API / działania

• Room zwróci teraz błąd, jeśli nieabstrakcyjna metoda DAO oznaczona adnotacją @Transaction zwróci typ asynchroniczny, taki jak Single, Mayble, Completable, LiveData lub ListenableFuture. Transakcje są ograniczone do wątku, dlatego obecnie nie można rozpocząć ani zakończyć transakcji wokół funkcji, która mogłaby wykonywać zapytania w różnych wątkach. b/120109336
• Funkcje OnConflictStrategy.FAIL i OnConflictStrategy.ROLLBACK zostały @Deprecated, ponieważ nie działają zgodnie z oczekiwaniami w ramach obecnych powiązań SQLite w Androidzie. b/117266738

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że Room nie używał prawidłowo typu zwracanego TypeConverter, jeśli metoda DAO była funkcją zawieszania. b/122988159
• Naprawiono błąd, który powodował nieprawidłowe oznaczanie odziedziczonych funkcji zawieszania w pokoju jako niezawieszonych. b/122902595
• Naprawiliśmy błąd, który powodował generowanie przez Room nieprawidłowego kodu, 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ł blokadę bazy danych podczas wywoływania funkcji zawieszania DAO między beginTransaction() a endTransaction(). b/120854786

Wersja 2.1.0-alpha03

4 grudnia 2018 r.

Zmiany interfejsu API

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

Nowe funkcje

• Couroutines: metody DAO mogą teraz zawieszać funkcje. Aby obsługiwać funkcje zawieszania w pokoju, udostępniliśmy nowy element room-coroutines. b/69474692
• Metody DAO otagowane jako @Insert, @Delete lub @Update obsługują teraz typ zwracanych danych ListenableFuture. b/119418331

Poprawki błędów

• Naprawiono błąd polegający na tym, że Room nieprawidłowo próbował znaleźć konstruktor z kolumnami w właściwości ignoredColumns obiektu @Entity. b/119830714
• Naprawiono błąd, który powodował, że Room nie oznaczał parametrów metody DAO jako finalnych w wygenerowanej implementacji. b/118015483
• Naprawiliśmy błąd powodujący awarię procesora Room podczas raportowania błędu w zapytaniu zawierającym symbole specjalne. b/119520136
• Naprawiono błąd, przez który Room odrzucał inne implementacje funkcji Collection jako argumenty wyrażenia IN. b/119884035
• Naprawiliśmy błąd, który powodował, że dane zwracane przez LiveData z Room były zbierane bez końca, co powodowało, że nie były już emitowane nowe dane. b/74477406
• Zaktualizowano funkcję zamykania RoomDatabase, aby zmniejszyć konflikty blokady. b/117900450

Wersja 2.1.0-alpha02

30 października 2018 r.

Nowe funkcje

• Dodaliśmy obsługę odwołań do @DatabaseView w definicji @Relation. b/117680932

Poprawki błędów

• Naprawiliśmy błąd polegający na tym, że usługa Room wykonywała operację wejścia-wyjścia dysku w wątku głównym podczas subskrybowania i usuwania danych zwracanych przez żądanie Rx. b/117201279
• Naprawiliśmy błąd, który powodował, że usługa Room nie znalazła odpowiedniego konwertera typu dla pola w klasie encji Kotlin. b/111404868
• Naprawiliśmy błąd polegający na tym, że usługa Room generowała nieprawidłowy kod dla implementacji interfejsu DAO zawierającej domyślną metodę Kotlin, która nie ma argumentów. b/117527454
• Zaktualizowano parsowanie gramatyki SQLite w Room, aby rozwiązać 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: sala obsługuje teraz elementy z mapowaną tabelą FTS3 lub FTS4. Zajęcia oznaczone etykietą @Entity mogą być teraz dodatkowo oznaczone etykietą @Fts3 lub @Fts4, aby zadeklarować zajęcia z mapowaniem tabeli wyszukiwania pełnego tekstu. Opcje FTS umożliwiające dalsze dostosowanie są dostępne za pomocą metod adnotacji. b/62356416
• Widok: Room obsługuje teraz deklarowanie klasy jako zapisanego zapytania, zwanego też widokiem, za pomocą adnotacji @DatabaseView. b/67033276
• Wartość automatyczna: Room obsługuje teraz deklarowanie klas z adnotacjami AutoValue jako obiektów i obiektów POJO. Adnotacje Room @PrimaryKey, @ColumnInfo, @Embedded i @Relation można teraz deklarować w metodach abstrakcyjnych klasy z adnotacją wartości automatycznej. Pamiętaj, że aby Room mogła je poprawnie zinterpretować, adnotacje muszą być też opatrzone parametrem @CopyAnnotations. b/62408420
• Dodatkowa obsługa typów zwrotów Rx: metody DAO oznaczone adnotacjami @Insert, @Delete lub @Update obsługują teraz zwroty Rx Completable, Single<T> i Maybe<T>. b/63317956
• Typy stałe za pomocą funkcji @Relation: wcześniej sala potrzebowała pól z adnotacjami @Relation, aby umożliwić ich konfigurowanie, ale teraz mogą one być parametrami konstruktora.
• enableMultiInstanceInvalidation: to nowy interfejs API w wersji RoomDatabase.Builder, który umożliwia unieważnienie wielu instancji RoomDatabase przy użyciu tego samego pliku bazy danych. Ten mechanizm unieważniania wielu instancji działa również w przypadku wielu procesów. b/62334005
• fallbackToDestructiveMigrationOnDowngrade: nowy interfejs API w RoomDatabase.Builder, który automatycznie ponownie tworzy bazę danych, jeśli nastąpi obniżenie wersji. b/110416954
• ignoredColumns: to nowy interfejs API w annotacji @Entity, którego można używać do wyświetlania ignorowanych pól według nazwy. Przydatne do ignorowania dziedziczonych pól w podmiocie. b/63522075

Zmiany w interfejsie API i zachowaniu

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

Poprawki błędów

• Rozwiązaliśmy 2 problemy, które powodowały, że pokoje nie były prawidłowo przywracane 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 jest wydana bez zmian w porównaniu z wersją 2.0.0-rc01.

Wersja 2.0.0-rc01

20 września 2018 r.

Wersja androidx.room 2.0.0-rc01 została udostępniona bez zmian od wersji 2.0.0-beta01.

Wersja 2.0.0-beta01

2 lipca 2018 r.

Zmiany w interfejsie API i zachowaniu

• Dodano RoomDatabase.Builder.setQueryExecutor(), aby umożliwić dostosowywanie miejsca wykonywania 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 przypadku błędu „Nie można znaleźć metody getter dla pola” b/73334503
• Naprawiono zgodność wsteczną RoomOpenHelper ze starszymi wersjami Room b/110197391

Zależności sprzed AndroidX

W przypadku wersji Room starszych niż 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.

Sala 1.1.1 jest identyczna z salą 1.1.1-rc1.

Wersja 1.1.1-rc1

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

Naprawiono błąd, który powodował, że Room nie inicjował prawidłowo 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 elementu relacji zdefiniowanego w języku Java b/78199923

Wersja 1.1.0-beta2

5 kwietnia 2018 r.

Poprawki błędów

• Naprawiliśmy błąd krytyczny w implementacjach Rx Single i Maybe w pokoju, w wyniku których zapytanie z wyprzedzeniem powodowało recykling zapytania, co powodowało problemy w przypadku dodania więcej niż 1 obserwatora do zwróconych wywołań Single lub Maybe. b/76031240

• [RoomDatabase.clearAllTables][ref-clearAllTables] nie VACUUM wywoła bazy danych, jeśli jest wywoływana w ramach transakcji. b/77235565

Wersja 1.1.0-beta1

21 marca 2018 r.

Zmiany interfejsu API

• Na podstawie opinii z weryfikacji interfejsu API interfejs @RawQuery nie akceptuje już przekazywania parametru zapytania String. Musisz użyć zapytania [SupportSQLiteQuery][ref-SupportSQLiteQuery]. (aby łatwo utworzyć instancję [SupportSQLiteQuery][ref-SupportSQLiteQuery] z obsługą argumentów, zobacz [SimpleSQLiteQuery][ref-SimpleSQLiteQuery]).
• Metoda [fallbackToDestructiveMigrationFrom][ref-fallbackToDestructiveMigrationFrom] w klasie RoomDatabase.Builder teraz akceptuje wartość vararg int zamiast vararg Integer.

Poprawki błędów

• Funkcja [RoomDatabase.clearAllTables][ref-clearAllTables] próbuje teraz zwrócić przestrzeń do systemu operacyjnego przez ustawienie punktu kontrolnego WAL i VACUUM bazy danych.
• [@RawQuery][ref-RawQuery] teraz akceptuje dowolne obiekty Pojo dla właściwości observedEntities, o ile tylko obiekty te odwołują się do co najmniej 1 elementu za pomocą pól Embedded lub Relation.b/74041772
• Strony: implementacja DataSource w Room obsługuje teraz poprawnie zależności między wieloma tabelami (np. relacje i złączenia). Wcześniej nie powodowały one generowania nowych wyników lub nie mogły zostać skompilowane. b/74128314

Wersja 1.1.0-alpha1

22 stycznia 2018 r.

Nowe funkcje

• RawQuery: ten nowy interfejs API umożliwia metodom @Dao otrzymywanie zapytania SQL jako parametru zapytania.b/62103290, b/71458963
• fallBackToDestructiveMigrationsFrom: ten nowy interfejs API w RoomDatabase.Builder umożliwia bardziej szczegółowe określenie wersji początkowych schematów, od których można przeprowadzać niszczące migracje (w porównaniu z fallbackToDestructiveMigration)b/64989640
• Pokój obsługuje teraz tylko nowsze interfejsy API (alpha-4 i nowsze), a nieaktualne interfejsy API LivePagedListProvider zostały wycofane. Aby korzystać z nowej wersji alfa aplikacji Room, musisz użyć stronyowania w wersji alpha-4 lub nowszej i przełączyć się z wersji 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 powoduje już unieważnienia schematu. b/64290754