Комната
| Последнее обновление | Основная версия | Релиз-кандидат | Бета-версия | Альфа-версия |
|---|---|---|---|---|
| 9 сентября 2026 г. | 2.8.5 | - | - | - |
Объявление зависимостей
Чтобы добавить зависимость от библиотеки Room, необходимо добавить в проект репозиторий Google Maven. Подробную информацию можно найти в статье Репозиторий Google Maven.
Зависимости для Room включают тестирование переноса Room и Room RxJava.
Добавьте зависимости для нужных артефактов в файл build.gradle приложения или модуля:
Kotlin
dependencies { val room_version = "2.8.5" implementation("androidx.room:room-runtime:$room_version") // If this project uses any Kotlin source, use Kotlin Symbol Processing (KSP) // See Add the KSP plugin to your project ksp("androidx.room:room-compiler:$room_version") // If this project only uses Java source, use the Java annotationProcessor // No additional plugins are necessary annotationProcessor("androidx.room:room-compiler:$room_version") // optional - Kotlin Extensions and Coroutines support for Room implementation("androidx.room:room-ktx:$room_version") // optional - RxJava2 support for Room implementation("androidx.room:room-rxjava2:$room_version") // optional - RxJava3 support for Room implementation("androidx.room:room-rxjava3:$room_version") // optional - Guava support for Room, including Optional and ListenableFuture implementation("androidx.room:room-guava:$room_version") // optional - Test helpers testImplementation("androidx.room:room-testing:$room_version") // optional - Paging 3 Integration implementation("androidx.room:room-paging:$room_version") }
Яркий
dependencies { def room_version = "2.8.5" implementation "androidx.room:room-runtime:$room_version" // If this project uses any Kotlin source, use Kotlin Symbol Processing (KSP) // See KSP Quickstart to add KSP to your build ksp "androidx.room:room-compiler:$room_version" // If this project only uses Java source, use the Java annotationProcessor // No additional plugins are necessary annotationProcessor "androidx.room:room-compiler:$room_version" // optional - RxJava2 support for Room implementation "androidx.room:room-rxjava2:$room_version" // optional - RxJava3 support for Room implementation "androidx.room:room-rxjava3:$room_version" // optional - Guava support for Room, including Optional and ListenableFuture implementation "androidx.room:room-guava:$room_version" // optional - Test helpers testImplementation "androidx.room:room-testing:$room_version" // optional - Paging 3 Integration implementation "androidx.room:room-paging:$room_version" }
Информацию об использовании плагина KAPT можно найти в документации KAPT.
Информацию об использовании плагина KSP можно найти в кратком руководстве по KSP.
Информацию об использовании расширений Kotlin можно найти в документации по KTX.
Подробнее о добавлении зависимостей сборки…
Для библиотек, не предназначенных для Android (например, модулей Gradle только на Java или Kotlin), можно использовать androidx.room:room-common, чтобы применять аннотации Room.
Настройка параметров компилятора
В Room есть следующие параметры инструмента обработки аннотаций.
room.schemaLocation |
directory
Включает экспорт схем баз данных в файлы JSON в указанном каталоге. Подробнее о переносе чат-комнат… |
room.incremental |
boolean
Включает инкрементный инструмент обработки аннотаций Gradle. Значение по умолчанию – true.
|
room.generateKotlin |
boolean
Создавать исходные файлы Kotlin вместо Java. Требуется KSP. Значение по умолчанию – true (начиная с версии 2.7.0).
Подробную информацию можно найти в примечаниях к версии 2.6.0, в которой была добавлена эта функция.
|
Как использовать плагин Room Gradle
В Room версии 2.6.0 и выше вы можете использовать плагин Room Gradle для настройки параметров компилятора Room. Плагин настраивает проект таким образом, чтобы сгенерированные схемы (которые являются результатом задач компиляции и используются для автоматической миграции) были правильно настроены для воспроизводимых и кэшируемых сборок.
Чтобы добавить плагин, укажите его и его версию в файле сборки Gradle верхнего уровня.
Яркий
plugins { id 'androidx.room' version "$room_version" apply false }
Kotlin
plugins { id("androidx.room") version "$room_version" apply false }
В файле сборки Gradle на уровне модуля примените плагин и используйте расширение room.
Яркий
plugins { id 'androidx.room' } android { ... room { schemaDirectory "$projectDir/schemas" } }
Kotlin
plugins { id("androidx.room") } android { ... room { schemaDirectory("$projectDir/schemas") } }
При использовании плагина Room Gradle необходимо задать schemaDirectory. Это позволит настроить компилятор Room, различные задачи компиляции и его серверные части (javac, KAPT, KSP) для вывода файлов схемы в папки с ароматизаторами, например schemas/flavorOneDebug/com.package.MyDatabase/1.json. Эти файлы должны быть добавлены в репозиторий для использования при валидации и автоматических миграциях.
Некоторые параметры нельзя настроить во всех версиях плагина Room Gradle, даже если они поддерживаются компилятором Room. В таблице ниже перечислены все параметры и указана версия плагина Room Gradle, в которой добавлена поддержка настройки этого параметра с помощью расширения room. Если у вас более ранняя версия или эта функция пока не поддерживается, вы можете использовать параметры инструмента обработки аннотаций.
| Option | С версии |
|---|---|
room.schemaLocation (обязательное поле) |
2.6.0 |
room.incremental |
- |
room.generateKotlin |
- |
Используйте параметры инструмента обработки аннотаций
Если вы не используете плагин Room Gradle или нужный параметр не поддерживается вашей версией плагина, вы можете настроить Room с помощью параметров инструмента обработки аннотаций, как описано в разделе Добавление зависимостей сборки. Способ указания параметров аннотации зависит от того, используете ли вы KSP или KAPT для Room.
Яркий
// For KSP ksp { arg("option_name", "option_value") // other otions... } // For javac and KAPT android { ... defaultConfig { ... javaCompileOptions { annotationProcessorOptions { arguments += [ "option_name":"option_value", // other options... ] } } } }
Kotlin
// For KSP ksp { arg("option_name", "option_value") // other options... } // For javac and KAPT android { ... defaultConfig { ... javaCompileOptions { annotationProcessorOptions { arguments += mapOf( "option_name" to "option_value", // other options... ) } } } }
Поскольку room.schemaLocation – это каталог, а не примитивный тип, при добавлении этого параметра необходимо использовать CommandLineArgumentsProvider, чтобы Gradle знал об этом каталоге при проведении актуальных проверок.
В статье Перенос базы данных Room показана полная реализация CommandLineArgumentsProvider, которая предоставляет местоположение схемы.
Отзыв
Ваши отзывы помогают нам улучшать Jetpack. Если вы обнаружите новые проблемы или у вас появятся идеи по улучшению этой библиотеки, сообщите нам. Прежде чем сообщать о новых ошибках, изучите уже добавленные. Чтобы проголосовать за существующую проблему, нажмите на значок звездочки.
Дополнительную информацию можно найти в документации по системе отслеживания ошибок.
Версия 2.8
Версия 2.8.5
9 сентября 2026 г.
Данные "androidx.room:room-*:2.8.5" опубликованы. Версия 2.8.5 содержит эти коммиты.
Исправление ошибок
- Приостановка запросов и операции отслеживания недействительности в Room теперь будут вызывать ошибку
IllegalStateException, если они вызываются после закрытия базы данных. (Ic0166, b/543076356)
Версия 2.8.4
19 ноября 2025 г.
Данные "androidx.room:room-*:2.8.4" опубликованы. Версия 2.8.4 содержит эти коммиты.
Исправление ошибок
- Добавлен кеш подготовленных запросов в пул подключений Room при использовании
SQLiteDriver, у которого нет внутреннего пула, напримерBundledSQLiteDriver. Это повышает производительность при повторном выполнении одной и той же инструкции SQL. (5f43bc, b/319653917) - Исправлена ошибка, из-за которой в сообщении об ошибке фактического/ожидаемого значения при проверке схемы отсутствовала информация. (8b23da, b/454531083)
- Исправлена ошибка, из-за которой в сгенерированном коде Kotlin для Room отсутствовали функции DAO
@Transactionс переменными типа. (a8365d, b/251316420) - Повысьте производительность оболочки
SupportSQLiteбиблиотеки Room, избегая переходов между потоками и сохраняя то же поведение блокировки, что и у APISupportSQLiteDatabase. (fc70e4)
Версия 2.8.3
22 октября 2025 г.
Данные "androidx.room:room-*:2.8.3" опубликованы. Версия 2.8.3 содержит эти коммиты.
Исправление ошибок
- Исправлена проблема с производительностью в Room SQLite Wrapper, которая приводила к чрезмерному количеству вызовов JNI и значительному снижению производительности при итерации по курсору.
Версия 2.8.2
8 октября 2025 г.
Данные "androidx.room:room-*:2.8.2" опубликованы. Версия 2.8.2 содержит эти коммиты.
Исправление ошибок
- Исправлена взаимная блокировка, которая могла возникать при повторном открытии автоматически закрытой базы данных из Flow emission (b/446643789).
Версия 2.8.1
24 сентября 2025 г.
Данные "androidx.room:room-*:2.8.1" опубликованы. Версия 2.8.1 содержит эти коммиты.
Исправление ошибок
- Исправлен сбой процессора, который происходил при обработке функции DAO с приостановленной лямбда-функцией. (b/442220723).
- Исправлено состояние гонки, из-за которого Flows не получал последние обновления.
Версия 2.8.0
10 сентября 2025 г.
Данные "androidx.room:room-*:2.8.0" опубликованы. Версия 2.8.0 содержит эти коммиты.
Важные изменения по сравнению с версией 2.7.0:
- Добавлен новый артефакт
androidx.room:room-sqlite-wrapper, который содержит API для получения оболочкиSupportSQLiteDatabaseизRoomDatabaseс настроеннымSQLiteDriver. Чтобы получить оболочку, используйте новую функцию расширенияRoomDatabase.getSupportWrapper(). Это артефакт совместимости, который позволяет использоватьSupportSQLiteDatabase, обычно получаемый изroomDatabase.openHelper.writableDatabase, даже если база данных Room настроена с помощьюSQLiteDriver. Эта оболочка полезна для постепенного переноса баз кода, в которых нужно использовать API SQLiteDriver, но при этом активно применяются API SupportSQLite, и при этом нужно использовать преимуществаBundledSQLiteDriver. Подробную информацию вы найдете в руководстве по переходу. - Добавлена поддержка целевых платформ Watch OS и Tv OS в KMP.
- Минимальная версия SDK для Android в библиотеке изменена с API 21 на API 23.
Версия 2.8.0-rc02
27 августа 2025 года
Данные "androidx.room:room-*:2.8.0-rc02" опубликованы. Версия 2.8.0-rc02 содержит эти коммиты.
Изменения в API
- Обновлен минимальный уровень API SDK – с 21 до 23 (Ibdfca, b/380448311, b/435705964, b/435705223).
- Минимальная версия плагина Android Gradle (AGP), совместимая с плагином Room Gradle, изменена с 8.1 на 8.4. (Ia0d28)
Исправление ошибок
- Исправлена ошибка, из-за которой выполнялся деструктивный перенос, даже если для предварительно упакованной базы данных был доступен путь переноса (b/432634197).
Версия 2.8.0-rc01
13 августа 2025 г.
Данные "androidx.room:room-*:2.8.0-rc01" опубликованы. Версия 2.8.0-rc01 содержит эти коммиты.
Изменения в API
Исправление ошибок
- Исправлено состояние гонки, при котором Room Flows не выдавал последний результат запроса в асинхронной ситуации с несколькими запросами/записями. (Ic9a3c)
Версия 2.8.0-beta01
1 августа 2025 г.
Данные "androidx.room:room-*:2.8.0-beta01" опубликованы. Версия 2.8.0-beta01 содержит эти коммиты.
Исправление ошибок
- Теперь названия таблиц и представлений экранируются правильно во время деструктивных переносов. (9e55f8, b/427095319)
Версия 2.8.0-alpha01
16 июля 2025 г.
Данные "androidx.room:room-*:2.8.0-alpha01" опубликованы. Версия 2.8.0-alpha01 содержит эти коммиты.
Новые функции
- Добавлен новый артефакт
androidx.room:room-sqlite-wrapper, который содержит API для получения оболочкиSupportSQLiteDatabaseдляRoomDatabaseс настроеннымSQLiteDriver. Чтобы получить оболочку, используйте новую функцию расширенияRoomDatabase.getSupportWrapper(). Это артефакт совместимости, который позволяет использоватьSupportSQLiteDatabase, обычно получаемый изRoomDatabase.openHelper.writableDatabase, даже если база данных Room настроена с помощьюSQLiteDriver. Эта оболочка полезна для постепенного переноса баз кода, которые хотят использоватьSQLiteDriver, но имеют обширное использование APISupportSQLite, но при этом хотят воспользоваться преимуществамиBundledSQLiteDriver. (Icf6ac) - Добавлены целевые платформы KMP для Watch OS и TV OS (I228f6, b/394238801).
Исправление ошибок
- Исправлена взаимоблокировка, которая могла иногда возникать при использовании приостановки транзакций и
AndroidSQLiteDriver. (b/415006268)
Версия 2.7
Версия 2.7.2
18 июня 2025 г.
Данные "androidx.room:room-*:2.7.2" опубликованы. Версия 2.7.2 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой значения аннотаций неправильно считывались при обработке нативных источников с помощью KSP, что иногда приводило к отсутствию экспорта схем. (b/416549580)
- Исправлена ошибка, из-за которой комментарии в начале SQL-запроса приводили к тому, что команды выполнялись как запросы, не предназначенные для чтения. (b/413061402)
- Исправлена ошибка, из-за которой не удавалось настроить плагин Gradle для библиотеки Room, если каталог схемы был пуст. (b/417823384)
- Если подключение занимает слишком много времени, больше не выдается ошибка
SQLiteException. Вместо этого библиотека отправляет сообщение в журнал. Ведение журнала вместо создания исключений позволяет обойти проблему с приостановкой циклов в iOS, из-за которой Room неправильно интерпретирует тайм-аут, возникающий в сопрограмме Kotlin при получении подключения. Это предотвращает создание исключения, когда приложение iOS переходит в фоновый режим, а затем возобновляет работу в середине операции с базой данных. (b/422448815)
Версия 2.7.1
23 апреля 2025 г.
Данные "androidx.room:room-*:2.7.1" опубликованы. Версия 2.7.1 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка
IndexOutOfBoundsException, возникавшая при проверке предоставленного конвертера типов. (b/409804755). - Поддержка
RoomDatabase.runInTransaction(), когдаSQLiteDriverнастроен с помощью Room. (b/408364828).
Версия 2.7.0
9 апреля 2025 г.
Данные "androidx.room:room-*:2.7.0" опубликованы. Версия 2.7.0 содержит эти коммиты.
Важные изменения с версии 2.6.0
- Поддержка Kotlin Multiplatform (KMP). В этом выпуске библиотека Room была переработана для поддержки Kotlin Multiplatform (KMP). В настоящее время поддерживаются следующие платформы: Android, iOS, JVM (компьютеры), Mac и Linux. Дополнительную информацию о том, как начать работу с Room KMP, можно найти в официальной документации. В рамках поддержки KMP в Room также можно настроить
SQLiteDriver. Информацию о том, как перенести существующее приложение на API драйверов и Room KMP, можно найти в документации по переносу. - Генерация кода Kotlin в KSP включена по умолчанию, если обработка выполняется через KSP. Для проектов, использующих только KAPT или Java, Room по-прежнему будет генерировать исходный код Java.
- Kotlin 2.0 и KSP2. Теперь Room ориентируется на язык Kotlin 2.0. Проекты также должны компилироваться с Kotlin 2.0 или более поздней версией языка. Также добавлена поддержка KSP2, которая рекомендуется при использовании Room с Kotlin 2.0 или более поздней версии.
Версия 2.7.0-rc03
26 марта 2025 г.
Данные "androidx.room:room-*:2.7.0-rc03" опубликованы. Версия 2.7.0-rc03 содержит эти коммиты.
Исправление ошибок
InterruptedExceptionбольше не выбрасывается, когда поток прерывается во время выполнения блокирующих API Room, включая блокирующие функции DAO (b/400584611).- Повторно реализован пул подключений Room, чтобы устранить ошибку
SQLException: Error code: 5, message: Timed out attempting to acquire a reader connection.и подобные проблемы (b/380088809).
Версия 2.7.0-rc02
12 марта 2025 г.
Данные "androidx.room:room-*:2.7.0-rc02" опубликованы. Версия 2.7.0-rc02 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой автоматический перенос неправильно обрабатывал новый столбец в таблице FTS. (b/348227770, Ic53f3)
- Исправлен сбой компилятора Room, вызванный ошибкой
NullPointerExceptionпри обработке источников, не относящихся к JVM, через KSP. (b/396607230, I693c9) - Исправлена ошибка, из-за которой Room не аннулировал таблицы в конце использования подключения для записи. (b/340606803, I73ef6)
Версия 2.7.0-rc01
26 февраля 2025 г.
Данные "androidx.room:room-*:2.7.0-rc01" опубликованы. Версия 2.7.0-rc01 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой библиотека Room не устанавливала
busy_timeoutпри первоначальном подключении к базе данных, что приводило к проблемам сSQLException: Error code: 5, message: database is locked(I93208, b/380088809). - Исправлена ошибка в компиляторе Room, из-за которой процессор KSP аварийно завершал работу при обработке наборов исходных файлов (например, iOS) в Kotlin 2.1.x и KSP1 (I883b8, b/396607230).
Версия 2.7.0-beta01
12 февраля 2025 г.
Данные "androidx.room:room-*:2.7.0-beta01" опубликованы. Версия 2.7.0-beta01 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой
RoomDatabase.inTransaction()открывал закрытую базу данных, когда этого не требовалось, и быстро возвращал значение false, если база данных была закрыта (b/325432967). - Исправлен сбой (
IllegalArgumentException: not a valid name) в компиляторе Room при обработке функций DAO со встроенными классами Kotlin и классами значений (b/388299754). - Включите правила Proguard в артефакт JVM
room-runtime, чтобы конструктор по умолчанию для сгенерированной реализации базы данных не удалялся, поскольку он используется при инициализации Room по умолчанию с помощью рефлексии (b/392657750).
Версия 2.7.0-alpha13
29 января 2025 г.
Данные "androidx.room:room-*:2.7.0-alpha13" опубликованы. Версия 2.7.0-alpha13 содержит эти коммиты.
Изменения в API
- Теперь Room ориентируется на язык Kotlin 2.0. Проекты также должны компилироваться с Kotlin 2.0 или эквивалентной или более поздней версией языка. (I8efb0, b/315461431, b/384600605)
Исправление ошибок
- Исправлена ошибка в конструкторе баз данных Room KMP, когда в Android использовалось простое имя вместо пути и путь к файлу базы данных не находился в каталоге данных приложения. (I83315, b/377830104)
- Исправлена ошибка в плагине Room Gradle, из-за которой настройка входных и выходных данных схемы вызывала проблему в проектах Android:
property 'inputDirectory' is final and cannot be changed any further.(1dbb4c, b/376071291). - Добавлена поддержка KSP2 в плагине Room Gradle, что устраняет проблему, из-за которой каталог схемы не настраивался плагином должным образом. (Iec3c4, b/379159770)
Внешний вклад
- Исправлена проблема с интеграцией разбиения на страницы
Room, из-за которой интерфейс прыгал, когда начальный ключ для обновления находился слишком близко к концу списка. Спасибо Еве! (I2abbe, b/389729367)
Версия 2.7.0-alpha12
11 декабря 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha12" опубликованы. Версия 2.7.0-alpha12 содержит эти коммиты.
Изменения в API
- Добавлен экспериментальный API
RoomDatabase.Builder.setInMemoryTrackingMode(), позволяющий указать, будет ли Room использовать таблицу в памяти для отслеживания недействительности. (I2a9b2, b/185414040)
Исправление ошибок
- При деструктивных переносах теперь удаляются представления, чтобы обеспечить их повторное создание. Это позволяет согласовать поведение, когда параметр
allowDestructiveMigrationForAllTablesвключен (по умолчанию в KMP), с существующим поведением, когда он отключен. (0a3e83, b/381518941)
Версия 2.7.0-alpha11
30 октября 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha11" опубликованы. Версия 2.7.0-alpha11 содержит эти коммиты.
Изменения в API
- Измените сигнатуру нового метода
convertRows(), чтобы он стал функцией приостановки, которая получаетRawRoomQueryдля разбивки на страницы в Room. (Ie57b5, b/369136627)
Исправление ошибок
- Исправлена ошибка в room-paging, из-за которой при использовании
@Relationвместе сPagingSourceгенерировался недопустимый код.
Версия 2.7.0-alpha10
16 октября 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha10" опубликованы. Версия 2.7.0-alpha10 содержит эти коммиты.
Изменения в API
- Создайте внутренний класс
ByteArrayWrapperдля поддержки отношений сByteBufferна платформах, отличных от Android и JVM. (I75543, b/367205685) - Добавьте
SQLiteStatement.getColumnType()вместе с различными константами результатовSQLITE_DATA_*, чтобы включить получение типа данных столбца. (I1985c, b/369636251)
Версия 2.7.0-alpha09
2 октября 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha09" опубликованы. Версия 2.7.0-alpha09 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка в реализации KMP для
room-paging, которая вызывалаError code: 8, message: attempt to write a readonly databaseиз-за запуска транзакции записи в подключении для чтения. (b/368380988)
Версия 2.7.0-alpha08
18 сентября 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha08" опубликованы. Версия 2.7.0-alpha08 содержит эти коммиты.
Новые функции
- Артефакты
room-pagingбыли перенесены для совместимости с KMP. (Ib8756, b/339934824) - API
invalidationTrackerFlow()был обобщен как собственный APIInvalidationTracker.createFlow()и теперь доступен для наборов исходных файлов, не относящихся к Android, в проектах KMP. (I1fbfa, I8fb29, b/329291639, b/329315924)
Изменения в API
- Все предупреждения и сообщения об ошибках в Room, в которых используется слово
Cursor, были удалены или заменены, посколькуCursorбольше не является точным общим термином для использования в KMP-версии Room. (Id8cd9, b/334087492)
Исправление ошибок
- Исправлена ошибка, из-за которой Room KMP пытался генерировать код с помощью
UUIDдля платформ, отличных от JVM. (b/362994709) - Исправлена ошибка в плагине Room Gradle, из-за которой при использовании в проекте KMP с Compose Multiplatform возникала ошибка "Невозможно изменить атрибуты конфигурации… после того, как она была заблокирована для изменения". (b/343408758)
Версия 2.7.0-alpha07
21 августа 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha07" опубликованы. Версия 2.7.0-alpha07 содержит эти коммиты.
Новые функции
- Плагин Room Gradle теперь будет автоматически добавлять экспортированные схемы в источники ресурсов инструментальных тестов Android, чтобы их можно было использовать в
MigrationTestHelper.
Исправление ошибок
- Исправлена ошибка, из-за которой в сгенерированном actual-классе
RoomDatabaseConstructorотсутствовал модификатор actual в функцииinitialize, если эта функция также была переопределена в expect-декларации. (359631627) - Исправлена ошибка, из-за которой сгенерированное фактическое значение
RoomDatabaseConstructorне соответствовало видимости ожидаемого объявления. (358138953)
Версия 2.7.0-alpha06
7 августа 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha06" опубликованы. Версия 2.7.0-alpha06 содержит эти коммиты.
Изменения в API
- Измените настройки создания экземпляра для
RoomDatabaseв проекте KMP.
Из-за модели компиляции Kotlin 2.0 стратегия ссылки на функцию, которая будет сгенерирована, с именем instantiateImpl() больше не работает. Вместо стратегии instantiateImpl() вводятся два новых API: @ConstructedBy и RoomDatabaseConstructor. Новая стратегия выглядит следующим образом:
Определите объект expect, который реализует
RoomDatabaseConstructor.expect object MyDatabaseCtor : RoomDatabaseConstructor<MyDatabase>Свяжите объект с объявлением
@Database, используя@ConstructedBy.@Database(...) @ConstructedBy(MyDatabaseCtor::class) // NEW abstract class MyDatabase : RoomDatabaseСоздайте новый экземпляр базы данных, не передавая аргумент фабрики.
fun createNewDatabase(path: String) = Room.databaseBuilder<AppDatabase>(name = path) .setDriver(BundledSQLiteDriver()) .setQueryCoroutineContext(Dispatchers.IO) .build()
Исправлены ошибки b/316978491, b/338446862 и b/342905180.
- Поддержка
@RawQueryв Room KMP за счет добавления нового APIRoomRawQuery, который похож наSupportSQLiteQueryв плане хранения необработанной строки SQL и функции для привязки аргументов к оператору. Функции с аннотацией@RawQueryтеперь могут приниматьRoomRawQueryв качестве единственного параметра. (Iea844, b/330586815) - Добавьте перегрузку
setQueryCallback(), которая принимаетCoroutineContext. (Id66ff, b/309996304) - Добавлена поддержка целевых платформ Kotlin Multiplatform:
linuxArm64(I139d3, b/338268719).
Исправление ошибок
- Исправлена ошибка, из-за которой библиотека Room неправильно генерировала вызов
recursiveFetchArrayMapв целевых объектах, не относящихся к Android. (710c36, b/352482325) - Исправлена ошибка, из-за которой библиотека Room иногда выдавала исключение "Превышено время ожидания подключения" в проекте KMP. (fa72d0, b/347737870)
- Исправлена ошибка, из-за которой при автоматическом переносе внешние ключи проверялись до того, как схемы других таблиц были изменены в соответствии с новыми внешними ключами. (7672c0, b/352085724)
Версия 2.7.0-alpha05
10 июля 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha05" опубликованы. Версия 2.7.0-alpha05 содержит эти коммиты.
Изменения в API
- Название
SQLiteKtизменено наSQLite, аBundledSQLiteKt– наBundledSQLite. (I8b501)
Исправление ошибок
- Исправлена ошибка, из-за которой
RoomDatabaseзависал или выдавал ошибку тайм-аута подключения при использованииAndroidSQLiteDriver.
Версия 2.7.0-alpha04
12 июня 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha04" опубликованы. Версия 2.7.0-alpha04 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой инструмент обработки аннотаций библиотеки Room генерировал несовместимый код KMP, когда в DAO был определен тип возвращаемого значения multimap. (b/340983093)
- Исправлена ошибка, из-за которой Room не удавалось найти сгенерированную реализацию базы данных, если у класса с аннотацией
@Databaseне было пакета. (b/342097292) - Исправлена ошибка, из-за которой при включении автоматического закрытия и аннулирования многооконного режима иногда возникала ошибка
ConcurrentModificationException, когда база данных автоматически закрывалась из-за бездействия.
Версия 2.7.0-alpha03
29 мая 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha03" опубликованы. Версия 2.7.0-alpha03 содержит эти коммиты.
Исправление ошибок
- Исправлены различные проблемы, связанные с Kotlin 2.0 и KSP 2.0. Обратите внимание, что Kotlin 2.0 с поддержкой KSP 2 ещё не готов. Команда работает над различными API и изменениями в поведении нового компилятора. (b/314151707)
Версия 2.7.0-alpha02
14 мая 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha02" опубликованы. Версия 2.7.0-alpha02 содержит эти коммиты.
Исправление ошибок
- Исправлены различные проблемы с KSP.
Версия 2.7.0-alpha01
1 мая 2024 г.
Данные "androidx.room:room-*:2.7.0-alpha01" опубликованы. Версия 2.7.0-alpha01 содержит эти коммиты.
Новые функции
- Поддержка Kotlin Multiplatform (KMP). В этом выпуске библиотека Room была переработана и стала библиотекой Kotlin Multiplatform (KMP). Хотя нам ещё есть над чем поработать, в этом выпуске представлена новая версия Room, в которой большая часть функций была "обобщена" (сделана мультиплатформенной). В настоящее время поддерживаются следующие платформы: Android, iOS, JVM (компьютеры), Mac и Linux. Недостающие функции будут добавлены в будущих выпусках Room.
Дополнительную информацию о том, как начать работу с Room KMP, можно найти в официальной документации.
- Генерация кода Kotlin в KSP включена по умолчанию, если обработка выполняется через KSP. Для проектов, использующих только KAPT или Java, Room по-прежнему будет генерировать исходный код Java.
Изменения в API
- Добавлена перегрузка
Room.databaseBuilder(), которая принимает лямбда-параметр, предназначенный для использования с функцией, сгенерированной Room, чтобы избежать использования отражения при создании экземпляра сгенерированной реализацииRoomDatabase. Пример использования:
Room.databaseBuilder<MyDatabase>(
context = appContext,
name = dbFilePath,
factory = { MyDatabase::class.instantiateImpl() }
)
- В конструктор добавлен API для настройки комнаты с помощью
CoroutineContext:RoomDatabase.Builder.setQueryCoroutineContext. Обратите внимание, чтоRoomDatabaseможно настроить только с помощью исполнителей, использующихsetQueryExecutor, или с помощью контекста Coroutine, но не обоих. - Добавлен API для настройки Room с драйвером
SQLite:RoomDatabase.Builder.setDriver(). Дополнительную информацию оSQLiteDriver API можно найти в документации по SQLite KMP. - Добавлены API для доступа к базовому
SQLiteConnectionиз API драйверов:RoomDatabase.useReaderConnectionиRoomDatabase.useWriterConnection. - Для некоторых обратных вызовов, связанных с комнатами, теперь есть перегруженная версия, которая получает
SQLiteConnectionвместоSupportSQLiteDatabase. Они предназначены для переопределения при переходе на проект KMP. Дополнительную информацию о переносе использования Room в приложении Android в общий модуль KMP можно найти в руководстве по переносу. Доступны следующие обратные вызовы:Migration.migrate(SQLiteConnection)AutoMigrationSpec.onPostMigrate(SQLiteConnection)RoomDatabase.Callback.onCreate(SQLiteConnection)RoomDatabase.Callback.onDestructiveMigration(SQLiteConnection)RoomDatabase.Callback.onOpen(SQLiteConnection)
- Артефакт KTX
androidx.room:room-ktxбыл объединен сandroidx.room:room-runtimeвместе со всеми его API. Теперь артефакт пуст. Удалите его из списка зависимостей.
Версия 2.6
Версия 2.6.1
29 ноября 2023 г.
Данные "androidx.room:room-*:2.6.1" опубликованы. Версия 2.6.1 содержит эти коммиты.
Исправление ошибок
- Устранена проблема в сгенерированном коде, из-за которой значение по умолчанию для столбцов Double в
EntityCursorConverterустанавливалось равным 0 вместо 0.0. Также добавлено потенциальное исправление для аналогичного пограничного случая для столбцов с типом данных Float. (Id75f5, b/304584179) - Исключения, возникающие при загрузке
PagingSource, теперь будут распространяться какLoadStateUpdateизLoadResult.Error, содержащего Throwable. Это состояние ошибки можно наблюдать черезPagingDataAdapter.loadStateFlow(Views)илиLazyPagingItems.loadState(Compose). Обратите внимание, что это означает изменение поведения, когда в прошлых ошибках загрузки будет всплывать исключение, создаваемое методом dao, который инициировал загрузку. (I93887, b/302708983)
Версия 2.6.0
18 октября 2023 г.
Данные "androidx.room:room-*:2.6.0" опубликованы. Версия 2.6.0 содержит эти коммиты.
Важные изменения, внесенные после версии 2.5.0
- В Room KSP теперь можно включить генерацию кода Kotlin (Kotlin CodeGen). (4297ec0). Чтобы включить Kotlin CodeGen в Room, добавьте название параметра
room.generateKotlinв параметры процессора для KSP. Подробную информацию о том, как передавать параметры процессора для KSP, можно найти в документации по KSP.
Примечание. При использовании Kotlin CodeGen важно учитывать, что были добавлены дополнительные ограничения. Абстрактные свойства в качестве геттеров или запросов DAO в Kotlin CodeGen запрещены. Их нужно переписать как функции, чтобы избежать ложного представления о том, что значение свойства неизменяемо и имеет фиксированный сохраненный результат. Ещё одно ограничение, которое было добавлено, заключается в том, что типы возвращаемых значений коллекции, допускающие значение NULL, больше не разрешены в Room для Kotlin CodeGen.
Предупреждение. При использовании Kotlin CodeGen вы можете обнаружить, что ваши проекты более строги с точки зрения допустимости значений NULL. В Kotlin CodeGen допустимость значения NULL для аргументов типа важна, а в Java она в основном игнорируется. Например, у вас есть тип возвращаемого значения `Flow<foo\>`, а таблица пуста. В Java CodeGen это не вызовет проблем, но в Kotlin CodeGen вы получите ошибку. Чтобы избежать этого, используйте `Flow<foo?\>`, если возвращается значение null. </foo?\></foo\>
- В Room добавлен новый артефакт для плагина Room Gradle с идентификатором
androidx.room. Он решает различные проблемы, связанные с входными и выходными данными схем, которые передаются через параметры инструмента обработки аннотаций Gradle. Подробную информацию можно найти в примечаниях к выпуску Room 2.6.0-alpha02. - Классы значений в объектах Room теперь поддерживаются для KSP. (4194095)
- В Room теперь поддерживаются вложенные типы возвращаемых значений Map в функциях DAO. (I13f48, 203008711)
Версия 2.6.0-rc01
20 сентября 2023 г.
Данные "androidx.room:room-*:2.6.0-rc01" опубликованы. Версия 2.6.0-rc01 содержит эти коммиты.
Версия 2.6.0-beta01
23 августа 2023 г.
Данные "androidx.room:room-*:2.6.0-beta01" опубликованы. Версия 2.6.0-beta01 содержит эти коммиты.
Исправление ошибок
- Обработка исключения
SQLiteв особом случае во время операции upsert. Если во время операции upsert возникает исключение2067 SQLITE_CONSTRAINT_UNIQUE, операция upsert должна выполнить обновление. (If2849, b/243039555)
Версия 2.6.0-alpha03
9 августа 2023 г.
Данные "androidx.room:room-*:2.6.0-alpha03" опубликованы. Версия 2.6.0-alpha03 содержит эти коммиты.
Новые функции
- В Room теперь поддерживаются вложенные типы возвращаемых значений Map в функциях DAO. (I13f48, 203008711)
Изменения в API
- Вместо устаревшего типа аннотации
@MapInfoсоздан новый –@MapColumn. Для каждого названия столбца (keyColumnName,valueColumnNameили обоих), указанного в аннотации@MapInfo, необходимо объявить аннотацию@MapColumnтолько сcolumnNameи использовать ее для конкретного аргумента типа, на который ссылается (ключ или значение Map) в типе возвращаемого значения функции DAO. Это связано с тем, что аннотация@MapColumnиспользуется непосредственно в аргументе типа в типе возвращаемого значения функции DAO, а не в самой функции, как@MapInfo. Подробную информацию можно найти в документации по@MapColumn. (Ib0305, b/203008711) - Обновлены файлы API для аннотирования подавления совместимости (I8e87a, b/287516207).
- API плагина Room Gradle были обновлены, чтобы не требовать конфигурации для каждого варианта. Это означает, что плагин может принимать глобальное местоположение для всех вариантов без создания нескольких каталогов, что обеспечивает более плавную миграцию, но также достаточно гибок, чтобы вручную настраивать разновидности или создавать схемы типов, сохраняя при этом преимущества плагина (воспроизводимые и кэшируемые сборки). (I09d6f, b/278266663)
Исправление ошибок
- Устранена уязвимость, связанная с потенциальной утечкой памяти в
QueryInterceptorStatement. (I193d1) - Исправлена ошибка в работе функции
QueryInterceptorDatabase execSQL(). (Iefdc8)
Версия 2.6.0-alpha02
21 июня 2023 г.
Данные "androidx.room:room-*:2.6.0-alpha02" опубликованы. Версия 2.6.0-alpha02 содержит эти коммиты.
Плагин Room Gradle
В этом выпуске добавлен новый артефакт для плагина Room Gradle с идентификатором androidx.room, который решает различные проблемы в Room, связанные с входными и выходными данными схем, передаваемыми через параметры инструмента обработки аннотаций Gradle. Плагин Room Gradle настраивает проект так, чтобы сгенерированные схемы, которые используются для автоматических миграций и являются результатом задач компиляции, были правильно настроены для воспроизводимых и кэшируемых сборок. Плагин предлагает DSL для настройки местоположения базовой схемы:
room {
schemaDirectory("$projectDir/schemas/")
}
Затем плагин настроит компилятор Room, различные задачи компиляции и их серверные части (javac, KAPT, KSP) для вывода файлов схемы в папки, например schemas/flavorOneDebug/com.package.MyDatabase/1.json. Как обычно, эти файлы регистрируются в репозитории для использования при проверке и автоматическом переносе. При переходе на использование плагина вместо параметров процессора аннотаций существующие файлы схемы необходимо скопировать в сгенерированные каталоги вариантов, созданные плагином. Это одноразовая операция миграции, которую необходимо выполнить вручную. Документация по схеме на сайте developers.android.com будет обновлена, когда мы обработаем отзывы и плагин станет стабильным. Попробуйте его.
Изменения в API
RoomDatabase.QueryCallback– это функциональный интерфейс, позволяющий использовать преобразования SAM. (Iab8ea, b/281008549)
Исправление ошибок
- Устранена проблема, возникавшая при создании экземпляра базы данных в Robolectric после переноса источников Room из Java в Kotlin. (Ic053c, b/274924903)
Версия 2.6.0-alpha01
22 марта 2023 г.
Данные "androidx.room:room-*:2.6.0-alpha01" опубликованы. Версия 2.6.0-alpha01 содержит эти коммиты.
Новые функции
- Поддержка классов значений в Room для KSP. Библиотека Room теперь поддерживает классы значений в объектах. (4194095)
- В Room теперь можно включить генерацию кода Kotlin (4297ec0). Чтобы включить Kotlin CodeGen в Room, добавьте название параметра
room.generateKotlinв параметры процессора для KSP. Подробную информацию о том, как передавать параметры процессора для KSP, можно найти в документации по KSP.
Примечание. При использовании Kotlin CodeGen важно учитывать, что были добавлены дополнительные ограничения. Абстрактные свойства в качестве геттеров или запросов DAO в Kotlin CodeGen запрещены. Их нужно переписать как функции, чтобы избежать ложного представления о том, что значение свойства неизменяемо и имеет фиксированный сохраненный результат. Ещё одно ограничение, которое было добавлено, заключается в том, что типы возвращаемых значений коллекции, допускающие значение NULL, больше не разрешены в Room для Kotlin CodeGen.
Предупреждение. При использовании Kotlin CodeGen вы можете обнаружить, что ваши проекты более строги с точки зрения допустимости значений NULL. В Kotlin CodeGen допустимость значения NULL для аргументов типа важна, а в Java она в основном игнорируется. Например, у вас есть тип возвращаемого значения `Flow<foo\>`, а таблица пуста. В Java CodeGen это не вызовет проблем, но в Kotlin CodeGen вы получите ошибку. Чтобы избежать этого, используйте `Flow<foo?\>`, если возвращается значение null. </foo?\></foo\>
Изменения в API
- Защита от бессмысленного использования коллекций, допускающих значение NULL, в типах возвращаемых значений методов DAO. (I777dc, b/253271782, b/259426907)
- Добавлен API для создания потока, который передает изменения трекера недействительности. API полезен для создания потоков, которые должны реагировать на изменения в базе данных. (I8c790, b/252899305)
Исправление ошибок
- Запретите абстрактные свойства в качестве геттеров DAO или запросов DAO в генераторе кода Kotlin. Вместо этого их следует переписать как функции, чтобы избежать ложного представления о том, что значение свойства неизменяемо и имеет фиксированный сохраненный результат. (If6a13, b/127483380, b/257967987)
Версия 2.5.2
Версия 2.5.2
21 июня 2023 г.
Данные "androidx.room:room-*:2.5.2" опубликованы. Версия 2.5.2 содержит эти коммиты.
Исправление ошибок
- Исправлена проблема несовместимости с kotlinx-metadata-jvm. (386d5c)
- Исправлена ошибка, из-за которой библиотека Room выдавала ошибку при использовании в тесте Robolectric. (f79bea, b/274924903)
Версия 2.5.1
Версия 2.5.1
22 марта 2023 г.
Данные "androidx.room:room-*:2.5.1" опубликованы. Версия 2.5.1 содержит эти коммиты.
Исправление ошибок
- Не проверяйте родительский каталог базы данных в
FrameworkSQLiteHelper, если база данных уже открыта. (5de86b8) - При проверке того, открыта ли база данных, используйте
isOpenInternal. (e91fb35) - Улучшена обработка реентерабельного случая в
acquireTransactionThread()изRoom. (219f98b). Во время приостановки транзакции Room использует поток из исполнителя транзакции, запускает в нем цикл событий и отправляет ему приостановку операций с базой данных, чтобы все они были инкапсулированы в сопрограмме транзакции. Обычно поток транзакции отличается от потока, который ее запускает, но в некоторых случаях они совпадают. Чтобы справиться с такими случаями повторного входа, мы провели рефакторингwithTransaction(). Теперь он не зависит от управляющего задания, а выполняет приостанавливающий блок транзакции изrunBlockingв потоке транзакции.
Версия 2.5.0
Версия 2.5.0
22 февраля 2023 г.
Выпущены androidx.room:room-paging-guava:2.5.0, androidx.room:room-paging-rxjava2:2.5.0 и androidx.room:room-paging-rxjava3:2.5.0. Версия 2.5.0 содержит эти коммиты.
Версия 2.5.0
11 января 2023 г.
Данные "androidx.room:room-*:2.5.0" опубликованы. Версия 2.5.0 содержит эти коммиты.
Важные изменения, внесенные в версию 2.4.0
- Все источники (
room-runtime) преобразованы из Java в Kotlin. Обратите внимание, что если ваш код написан на Kotlin, то из-за преобразования библиотеки в Kotlin могут возникнуть проблемы с совместимостью исходного кода. Например, вInvalidationTrackerвам нужно будет объявитьonInvalidate()вObserver, чтобы получить параметр типаSet, а неMutableSet. Кроме того, некоторые методы получения были преобразованы в свойства, требующие синтаксиса доступа к свойствам в файлах Kotlin. Если вы обнаружите серьезные проблемы с совместимостью, сообщите о них. - Добавлена новая аннотация ярлыка
@Upsert, которая пытается вставить объект, если нет конфликта уникальности, или обновить объект, если конфликт есть. (I7aaab, b/241964353) - Добавлены новые артефакты Room Paging:
room-paging-rxjava2,room-paging-rxjava3иroom-paging-guava. - Добавлены API для предоставления названий таблиц ключей и значений для устранения неоднозначности в
@MapInfo(Icc4b5).
Версия 2.5.0-rc01
7 декабря 2022 г.
Данные "androidx.room:room-*:2.5.0-rc01" опубликованы. Версия 2.5.0-rc01 содержит эти коммиты.
- Этот выпуск идентичен выпуску
2.5.0-beta02.
Версия 2.5.0-beta02
9 ноября 2022 г.
Данные "androidx.room:room-*:2.5.0-beta02" опубликованы. Версия 2.5.0-beta02 содержит эти коммиты.
Изменения в API
- Исправлены различные API, которые принимают аргументы запроса от инвариантных (
Array<Any?>) до контравариантных (Array<out Any?>), чтобы соответствовать поведению массива Java. (b/253531073)
Версия 2.5.0-beta01
5 октября 2022 г.
Данные "androidx.room:room-*:2.5.0-beta01" опубликованы. Версия 2.5.0-beta01 содержит эти коммиты.
Изменения в API
- Укажите, что минимальная версия, поддерживающая
@Upsert, – это API 16. Это связано с тем, что в более старых API невозможно определить конфликт ограничений первичного ключа. (I5f67f, b/243039555)
Исправление ошибок
- Исправлена ошибка, из-за которой теневые таблицы неправильно экспортировались в файлы схемы
.json, что приводило к их повреждению. (I4f83b, b/246751839)
Версия 2.5.0-alpha03
24 августа 2022 г.
Данные "androidx.room:room-*:2.5.0-alpha03" опубликованы. Версия 2.5.0-alpha03 содержит эти коммиты.
Новые функции
- Добавлена новая аннотация ярлыка
@Upsert, которая пытается вставить объект, если нет конфликта уникальности, или обновить объект, если конфликт есть. (I7aaab, b/241964353)
Исправление ошибок
- Теперь при проверке ограничений внешнего ключа во время автоматического переноса Room будет выдавать ошибку
SQLiteConstraintExceptionвместоIllegalStateException. (I328dd) - Исправлена несовместимость исходного кода Kotlin для геттеров и свойств
getOpenHelper,getQueryExecutorиgetTransactionExecutor. (Iad0ac)
Версия 2.5.0-alpha02
1 июня 2022 г.
Данные "androidx.room:room-*:2.5.0-alpha02" опубликованы. Версия 2.5.0-alpha02 содержит эти коммиты.
Новые функции
- Добавлены новые артефакты
room-pagingroom-paging-rxjava2,room-paging-rxjava3иroom-paging-guavaдля поддержки Room Paging (41a1d4, b/203666906),(eb6098, b/203666906),(1b9ae4, b/203666906).
Изменения в API
- Все файлы
room-runtimeбыли преобразованы из Java в Kotlin. (If2069, b/206859668),(Ie4b55, b/206859668), (I697ee, b/206859668), (I96c25, b/206859668)Примечание. Из-за преобразования библиотеки в Kotlin могут возникнуть проблемы с несовместимостью источников. Если ваш код был написан на Kotlin и вызывал старую версию библиотеки Room, то в новой версии нужно будет обработать эти случаи. Например, в
InvalidationTrackerвам нужно будет объявитьonInvalidate()вObserver, чтобы получить параметр типаSet, а неMutableSet. - Добавлены API для предоставления названий таблиц ключей и значений для устранения неоднозначности в
@MapInfo(Icc4b5). - Исправлена проблема совместимости исходного кода, чтобы снова разрешить
@Ignoreв методах получения свойств. (Ifc2fb)
Исправление ошибок
- Эвристический алгоритм разрешения повторяющихся столбцов. Теперь Room будет пытаться разрешить неоднозначные столбцы в запросе multimap. Это позволяет правильно сопоставить JOIN с таблицами, содержащими таблицы с одинаковыми именами, с результирующим объектом данных. (I4b444, b/201306012, b/212279118)
Версия 2.5.0-alpha01
23 февраля 2022 г.
Данные "androidx.room:room-*:2.5.0-alpha01" опубликованы. Версия 2.5.0-alpha01 содержит эти коммиты.
Изменения в API
- Исправлена ошибка, из-за которой использование Room
@IntDefне применялось в источниках Kotlin. (I75f41, b/217951311) - Исправлена проблема совместимости с источником, чтобы снова разрешить
@Queryв геттерах свойств. (I0a09b) - Библиотека room-common переведена с Java на Kotlin. (I69c48, b/206858235)
Примечание. Вы можете столкнуться с проблемами несовместимости исходного кода, поскольку некоторые свойства были перемещены в сопутствующие объекты во время преобразования библиотеки в Kotlin. Если ваш код был написан на Kotlin и вызывал старую версию Room, то в новой версии при доступе к этим свойствам потребуется суффикс .Companion.
- Перенос Room переведен с Java на Kotlin. (I2724b, b/206858622)
- Преобразовано файлов, связанных с
paging, вroom-runtimeс Java на Kotlin. (I82fc8, b/206859668) - Добавлен API для блокировки и использования нескольких процессов на уровне FrameworkSQLite*, чтобы защитить создание и перенос базы данных при первом запуске нескольких процессов. (Ied267, b/193182592)
Исправление ошибок
- Добавлена поддержка внутренних свойств в источниках Kotlin.
Это небольшое изменение в поведении Room, где он будет использовать исходное имя функций, сопоставляя их со свойствами как геттеры/сеттеры (ранее он использовал имя функции JVM, которое отличается для внутренних функций/свойств).
Если вы используете специальные аннотации
@JvmNameдля сопоставления методов получения и установки с частными свойствами, проверьте сгенерированный код после обновления (If6531, b/205289020).
Версия 2.4.3
Версия 2.4.3
27 июля 2022 г.
Данные "androidx.room:room-*:2.4.3" опубликованы. Версия 2.4.3 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой Room не распознавал функции приостановки в Kotlin 1.7 (b/236612358).
Версия 2.4.2
Версия 2.4.2
23 февраля 2022 г.
Данные "androidx.room:room-*:2.4.2" опубликованы. Версия 2.4.2 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой при компиляции с помощью
-Xjvm-default=allили эквивалентного инструмента генерировался код для функции приостановки Dao@Transactionс телом, генерирующим метод интерфейса по умолчанию. (Ia4ce5) - Исправлена ошибка, из-за которой библиотека Room генерировала код для метода запроса с типом возвращаемого значения
Array<ByteArray>. (If086e, b/213789489)
Версия 2.4.1
Версия 2.4.1
12 января 2022 г.
Данные "androidx.room:room-*:2.4.1" опубликованы. Версия 2.4.1 содержит эти коммиты.
Исправление ошибок
- Добавлена поддержка внутренних свойств в источниках Kotlin.
Это небольшое изменение в поведении Room, где он будет использовать исходное имя функций, сопоставляя их со свойствами как геттеры/сеттеры (ранее он использовал имя функции JVM, которое отличается для внутренних функций/свойств).
Если вы используете специальные аннотации
@JvmNameдля сопоставления методов получения и установки с частными свойствами, проверьте сгенерированный код после обновления (If6531, b/205289020).
Версия 2.4.0
Версия 2.4.0
15 декабря 2021 г.
Данные "androidx.room:room-*:2.4.0" опубликованы. Версия 2.4.0 содержит эти коммиты.
Важные изменения, внесенные в версию 2.3.0
- Автоматический перенос. Теперь в Room есть API для автоматического переноса, если схемы экспортированы. Чтобы сообщить Room, что нужно сгенерировать автоматический перенос, можно использовать новое свойство
@Database#autoMigrations, в котором объявляются версии, между которыми выполняется перенос. Если библиотеке Room требуется дополнительная информация о переименовании или удалении таблиц и столбцов, аннотация@AutoMigrationможет объявить класс спецификации, содержащий такие входные данные. Подробная информация приведена в документации по@AutoMigration. - Внедрение зависимостей в автоматических переносах.
@ProvidedAutoMigrationSpec– это новый API, который позволяет объявить, чтоAutoMigrationSpecбудет предоставляться во время выполнения черезRoomDatabase.Builder#addAutoMigrationSpec(). Это позволяет фреймворку внедрения зависимостей предоставлять такие спецификации, когда им нужны сложные зависимости. - Поддержка автоматических переносов в Migration Test Helper. Класс
MigrationTestHelperв Room был обновлен для поддержки автоматических переносов. Для этого был добавлен новый API конструктора, который получает тестируемый класс базы данных. Это позволит помощнику автоматически добавлять автоматические переносы таким же образом во времяrunMigrationsAndValidate. - Поддержка разбивки на страницы в Room. Выпущена библиотека
androidx.room:room-paging, которая обеспечивает встроенную поддержку Paging 3.0 для запросов Room, возвращающихandroidx.paging.PagingSource. - Методы реляционных запросов. Теперь Room поддерживает типы возвращаемых значений multimap
@Dao, которые полезны для операторов JOIN. Поддерживаются следующие типы мультиотображений:Map,SparseArray,LongSparseArray, а такжеImmutableMap,ImmutableSetMultimapиImmutableListMultimapиз библиотеки Guava.
Версия 2.4.0-rc01
1 декабря 2021 г.
Данные "androidx.room:room-*:2.4.0-rc01" опубликованы. Версия 2.4.0-rc01 содержит эти коммиты.
Новые функции
- Обновите зависимость Room от KSP до версии
1.6.0-1.0.1, чтобы обеспечить поддержку Kotlin 1.6.
Версия 2.4.0-beta02
17 ноября 2021 г.
Данные "androidx.room:room-*:2.4.0-beta02" опубликованы. Версия 2.4.0-beta02 содержит эти коммиты.
Новые функции
- Добавлена поддержка SparseArray и LongSparseArray в @MapInfo. (Ic91a2b/138910317)
Исправление ошибок
- Мы добавили новый анализатор TypeConverter, который учитывает информацию о допустимости значения NULL в типах. Поскольку эта информация доступна только в KSP, она по умолчанию включена только в KSP. Если это вызывает проблемы, вы можете отключить эту функцию, передав room.useNullAwareTypeAnalysis=false в инструмент обработки аннотаций. Если это произойдет, сообщите об ошибке, так как в будущем этот параметр будет удален. С новым анализатором TypeConverter рекомендуется предоставлять только TypeConverter, не допускающие значения null, поскольку новый анализатор может обернуть их проверкой на null. Обратите внимание, что это не влияет на пользователей, использующих KAPT или Java в качестве инструментов обработки аннотаций, поскольку они, в отличие от KSP, не содержат информацию о допустимости значения NULL в типах. (Ia88f9, b/193437407)
- Исправлена ошибка, из-за которой Room не компилировался с ошибкой SQL, когда объект FTS объявлял об использовании токенизатора ICU. (I00db9, b/201753224)
- Исправлена проблема с автоматическим переносом, связанная с новым столбцом, добавленным во встроенную сущность между версиями. (I5fcb1b/193798291)
- Мы устранили проблему с типами возвращаемых значений для метода реляционных запросов в запросах LEFT JOIN. В результате этих изменений, если присутствует сопоставление "один ко многим", коллекция, возвращаемая для ключа, не будет включать недопустимый объект значения, если он не найден в курсоре. Если допустимых значений не найдено, ключ будет сопоставлен с пустой коллекцией. (Id5552b/201946438)
- Исправлена ошибка автоматического переноса, из-за которой ключевые слова SQLite не экранировались в названиях столбцов. (Idbed4b/197133152)
Версия 2.4.0-beta01
13 октября 2021 г.
Данные "androidx.room:room-*:2.4.0-beta01" опубликованы. Версия 2.4.0-beta01 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой при автоматическом переносе не добавлялись новые столбцы, если в другой таблице в том же переносе был новый столбец с таким же названием. (Ia5db5, b/200818663)
- Реализация PagingSource, созданная room-paging, теперь использует
queryExecutor, переданный черезRoomDatabase.Builder, поэтому его можно переопределить вместоDispatchers.IO. (Iae259)
Версия 2.4.0-alpha05
29 сентября 2021 г.
Данные "androidx.room:room-*:2.4.0-alpha05" опубликованы. Версия 2.4.0-alpha05 содержит эти коммиты.
Новые функции
- Добавлен встроенный конвертер типов для UUID. (I671e8, b/73132006)
Изменения в API
В аннотацию TypeConverters добавлено новое свойство, позволяющее разработчикам отключать встроенные конвертеры Enum и UUID. По умолчанию эти конвертеры включены, но вы можете отключить их для определенной области или для всей базы данных. Подробную информацию можно найти в документации по TypeConverters. (36ae9e, b/195413406)
Поддержка ключей и значений, не относящихся к POJO, для типов возвращаемых значений Multimap в DAO с помощью аннотации
@MapInfo. (I4d704)
@MapInfo потребуется, если столбец ключа или значения карты состоит из одного столбца. Пример:
@MapInfo(valueColumn = "songCount")
@Query("""
SELECT *, COUNT(mSongId) as songCount
FROM Artist JOIN Song ON Artist.artistName = Song.artist
GROUP BY artistName
""")
fun getArtistAndSongCounts(): Map<Artist, Integer>
- Сделайте
room-pagingобязательным артефактом при использовании Paging3 с Room. (Ieaffe)
Исправление ошибок
- Исправлена ошибка, из-за которой результаты запросов multimap не упорядочивались правильно, если запрос содержал предложение ORDER BY для столбца из ключа карты. (I6b887)
Внешний вклад
- Добавлен новый API для указания порядка индекса в @Index. Благодарим Никиту Желонкина. (I033fc)
Версия 2.4.0-alpha04
21 июля 2021 г.
Данные "androidx.room:room-*:2.4.0-alpha04" опубликованы. Версия 2.4.0-alpha04 содержит эти коммиты.
Новые функции
Теперь Room поддерживает типы возвращаемых значений multimap в методах
@Dao, что полезно для операторов JOIN. Поддерживаемые типы мультиотображений:Map, а такжеImmutableMap,ImmutableSetMultimapиImmutableListMultimapиз Guava.Ниже приведены примеры запросов с несколькими картами.
Карта отношений "один к одному"
@Query("SELECT * FROM Song JOIN Artist ON Song.artistId = Artist.artistId") fun getSongAndArtist(): Map<Song, Artist>Карта отношений "один ко многим" (стандартная мульти-карта)
@Query("SELECT * FROM Artist JOIN Album ON Artist.id = Album.artistId") fun getArtistAndAlbums(): Map<Artist, List<Album>>Результат multimap также можно упаковать в поддерживаемые асинхронные типы возвращаемых значений, такие как
LiveData,ObservableRx или сопрограммыFlow.
Room-Paging
Выпущена версия
androidx.room:room-paging, в которой добавлена встроенная поддержка Paging 3.0 для запросов Room, возвращающихandroidx.paging.PagingSource.@Dao interface UserDao { @Query("SELECT * FROM users ORDER BY id ASC") fun loadUsers(): PagingSource<Int, User> }Этот артефакт заменяет реализацию
androidx.paging.PagingSource, созданную библиотекой Room, на реализацию, созданную на основе API Paging 3.0. Новая реализация PagingSource по-другому анализирует ключи, поэтому любой ключ, вручную предоставленный PagingSource библиотеки Room, должен учитывать это изменение поведения, включая initialKey, переданный через конструктор Pager. Страницы начнут загружаться сKey, аKeyбудет первым загруженным элементом. Это отличается от существующего поведения, когдаLoadParams.Refresh.Keyрассматривается как позиция прокрутки пользователя, а элементы загружаются как до, так и после ключа.Артефакт необязателен, и отказ от него приведет к возврату к существующей поддержке Paging 3.0, которая была представлена в Room 2.3. Однако в будущих выпусках этот артефакт станет обязательным для тех, кто использует Room с Paging 3.0. Чтобы включить эту функцию, добавьте новый артефакт room-paging в путь к классам. Если вы используете Gradle, добавьте в файл build.gradle следующий фрагмент кода:
dependency { implementation("androidx.room:room-paging:2.4.0-alpha04") }
Исправление ошибок
- Исправлена проблема с обработкой нарушений внешнего ключа при автоматическом переносе. (b/190113935)
Версия 2.4.0-alpha03
16 июня 2021 г.
Данные "androidx.room:room-*:2.4.0-alpha03" опубликованы. Версия 2.4.0-alpha03 содержит эти коммиты.
Изменения в API
- Обновите
MigrationTestHelperбиблиотеки Room, чтобы поддерживать автоматический перенос. Для этого предоставьте новый API конструктора, который получает тестируемый класс базы данных. Это позволит помощнику автоматически добавлять автоматические переносы таким же образом во времяrunMigrationsAndValidate.
Исправление ошибок
Исправлена проблема с нативной библиотекой SQLite в Room, чтобы обеспечить поддержку чипов Apple M1. (b/174695268
Исправлена ошибка, из-за которой Room не выдавала ошибку, когда типом возвращаемого значения функции @Transaction был Flow (I56ddd, b/190075899).
Исправлена проблема с индексами при автоматическом переносе. b/177673291
Обновления зависимостей
- Поддержка KSP в Room теперь зависит от KSP
1.5.10-1.0.0-beta01. (1ecb11, b/160322705)
Версия 2.4.0-alpha02
5 мая 2021 г.
Данные "androidx.room:room-*:2.4.0-alpha02" опубликованы. Версия 2.4.0-alpha02 содержит эти коммиты.
Изменения в API
@ProvidedAutoMigrationSpec– это новый API, который позволяет объявить, чтоAutoMigrationSpecбудет предоставляться во время выполнения черезRoomDatabase.Builder#addAutoMigrationSpec(). Это позволяет фреймворку внедрения зависимостей предоставлять такие спецификации, когда им нужны сложные зависимости.
Исправление ошибок
- Исправлена ошибка, из-за которой при автоматическом переносе
@DatabaseViewне создавались заново.
Внешний вклад
- Исправлена ошибка в
JournalMode.TRUNCATEбиблиотеки Room, из-за которой обратный вызовInvalidationTrackerиногда выполнялся неправильно, слишком поздно или не выполнялся вообще. БлагодаримUli Bubenheimer | bubenheimer@users.noreply.github.com(b/154040286).
Версия 2.4.0-alpha01
21 апреля 2021 г.
Данные "androidx.room:room-*:2.4.0-alpha01" опубликованы. Версия 2.4.0-alpha01 содержит эти коммиты.
Новые функции
- Автоматический перенос. Теперь в Room есть API для автоматического переноса, если схемы экспортированы. Чтобы сообщить Room, что нужно сгенерировать автоматический перенос, можно использовать новое свойство
@Database#autoMigrations, в котором объявляются версии, между которыми выполняется перенос. Если библиотеке Room требуется дополнительная информация о переименовании или удалении таблиц и столбцов, аннотация@AutoMigrationможет объявить класс спецификации, содержащий такие входные данные. Подробная информация приведена в документации по@AutoMigration.
Исправление ошибок
- Исправлена ошибка, из-за которой
defaultValueс дополнительными скобками неправильно проверялись при валидации схемы Room. b/182284899
Версия 2.3.0
Версия 2.3.0
21 апреля 2021 г.
Данные "androidx.room:room-*:2.3.0" опубликованы. Версия 2.3.0 содержит эти коммиты.
Важные изменения, внесенные в версию 2.2.0
- Встроенная поддержка Enum. Если не указан конвертер типов, Room по умолчанию будет использовать конвертер Enum в String и наоборот. Если конвертер типов для перечисления уже существует, Room будет использовать его вместо стандартного.
- Обратный вызов запроса. Теперь в Room есть общий API обратного вызова RoomDatabase.QueryCallback, который срабатывает перед выполнением запросов. Это может быть полезно для ведения журнала в отладочных сборках. Обратный вызов можно настроить с помощью
RoomDatabase.Builder#setQueryCallback(). - Улучшение готовых баз данных. В Room теперь есть API для создания базы данных на основе готовой базы данных, считанной из входного потока. Это позволяет использовать такие случаи, как когда база данных предварительного пакета заархивирована.
- Предоставленные преобразователи типов. В Room теперь есть API для предоставления экземпляров преобразователей типов, чтобы приложение могло управлять их инициализацией. Чтобы отметить преобразователь типов, который будет предоставлен Room, используйте новую аннотацию @ProvidedTypeConverter.
- Поддержка RxJava3. Room теперь поддерживает типы RxJava3. Как и в RxJava2, вы можете объявить методы DAO, типом возвращаемого значения которых являются Flowable, Single, Maybe и Completable. Кроме того, для поддержки RxJava3 доступен новый артефакт
androidx.room:room-rxjava3. - Поддержка Paging 3.0. Теперь Room поддерживает создание реализаций для методов с аннотацией
@Query, тип возвращаемого значения которых –androidx.paging.PagingSource.
Версия 2.3.0-rc01
24 марта 2021 г.
Данные "androidx.room:room-*:2.3.0-rc01" опубликованы. Версия 2.3.0-rc01 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой запросы Coroutine Flow, созданные Room, не могли использоваться в приостанавливающем блоке
withTransaction. (I797bf)
Версия 2.3.0-beta03
10 марта 2021 г.
Данные "androidx.room:room-*:2.3.0-beta03" опубликованы. Версия 2.3.0-beta03 содержит эти коммиты.
Новые функции
- Добавлена поддержка инкрементной компиляции для KSP. (I031c1, b/176453350)
Исправление ошибок
- Исправлена ошибка, из-за которой создание PagingSource в основном потоке могло вызвать ошибку ANR. (I42b74, b/181221318)
- Исправлена видимость
@ExperimentalRoomApi: теперь она общедоступна, а не ограничена пакетом. (b/181356119)
Внешний вклад
- Разрешить Room принимать тип возвращаемого значения POJO в методе DAO с аннотацией
@Query, если он также аннотирован с помощью@SkipQueryVerification. Библиотека Room попытается преобразовать результат запроса в тип возвращаемого значения POJO так же, как это делается для метода DAO с аннотацией@RawQuery. Благодарим Маркуса Ригеля (Markus Riegel, hey@marcorei.com). (I45acb)
Версия 2.3.0-beta02
18 февраля 2021 г.
Данные "androidx.room:room-*:2.3.0-beta02" опубликованы. Версия 2.3.0-beta02 содержит эти коммиты.
Новые функции
В Room добавлена экспериментальная поддержка обработки символов Kotlin (KSP).
KSP – это замена KAPT для запуска инструментов обработки аннотаций в компиляторе Kotlin, которая значительно сокращает время сборки.
Чтобы использовать Room с KSP, примените плагин KSP Gradle и замените конфигурацию
kaptв файле сборки наksp. Например, вместоkapt 'androidx.room:room-compiler:2.3.0-beta02'используйтеksp 'androidx.room:room-compiler:2.3.0-beta02'. Подробная информация приведена в документации по KSP.Поскольку KSP – экспериментальный инструмент, для рабочего кода рекомендуется использовать KAPT. Сокращение времени сборки применимо только в том случае, если нет других процессоров, использующих KAPT. Известные проблемы описаны в статье b/160322705.
Версия 2.3.0-beta01
27 января 2021 г.
Данные "androidx.room:room-*:2.3.0-beta01" опубликованы. Версия 2.3.0-beta01 содержит эти коммиты.
Новые функции
- Автоматически закрываемые базы данных. Теперь Room может закрывать базы данных, к которым не обращались в течение определенного времени. Это экспериментальная функция, которую можно включить с помощью метода
RoomDatabase.Builder#setAutoCloseTimeout(). Эта функция полезна для приложений с несколькими базами данных.
Исправление ошибок
- Исправлена ошибка, из-за которой методы Dao с несколькими методами
@Updateили@Deleteс разными стратегиями разрешения конфликтов генерировали код только с одной из стратегий, фактически игнорируя определенную. (/I0b90d, b/176138543)
Версия 2.3.0-alpha04
16 декабря 2020 г.
Данные "androidx.room:room-*:2.3.0-alpha04" опубликованы. Версия 2.3.0-alpha04 содержит эти коммиты.
Новые функции
- В Room теперь есть общий callback API
RoomDatabase.QueryCallback, который срабатывает перед выполнением запросов. Это может быть полезно для ведения журналов в отладочных сборках. Обратный вызов можно настроить с помощьюRoomDatabase.Builder#setQueryCallback(). (Iaa513, b/174478034, b/74877608) - Теперь Room по умолчанию будет использовать конвертер типов Enum в String и наоборот, если он не указан. Если конвертер типов для перечисления уже существует, Room будет использовать его вместо стандартного. (b/73132006)
Известная проблема
- Если для Enum уже существует односторонний конвертер типов для чтения, Room может случайно использовать встроенный конвертер String в Enum, что может быть нежелательно. Это известная проблема, которую можно решить, сделав конвертер двусторонним. См. b/175707691.
Исправление ошибок
- Исправлена ошибка, из-за которой Room неправильно отключал инкрементную обработку аннотаций в более новых версиях JDK. (b/171387388)
- Исправлена ошибка, из-за которой Room не находил сгенерированный класс при использовании нескольких загрузчиков классов. Благодарим Serendipity (892449346@qq.com) за исправление (b/170141113).
- Исправлена ошибка, из-за которой библиотека Room генерировала неправильный код, когда у Kotlin
@Daoбыл базовый класс, чьи универсальные шаблоны являются примитивами в JVM. (b/160258066)
Внешний вклад
- Теперь Room будет по умолчанию использовать
beginTransactionNonExclusive, если включен режим WAL и используется API версии 16 или выше. Благодарим Ахмеда И. Khalil | ahmedibrahimkhali@gmail.com’! (b/126258791)
Версия 2.3.0-alpha03
14 октября 2020 г.
Данные "androidx.room:room-*:2.3.0-alpha03" опубликованы. Версия 2.3.0-alpha03 содержит эти коммиты.
Новые функции
В Room теперь есть API для предоставления экземпляров преобразователей типов, чтобы приложение могло управлять их инициализацией. Чтобы отметить конвертер типов, который будет предоставлен Room, используйте новую аннотацию
@ProvidedTypeConverter. Благодарим mzgreen (yairobbe@gmail.com). (Ie4fa5, b/121067210)В Room теперь есть API для создания базы данных с помощью предварительно упакованной базы данных, считанной из входного потока. Это позволяет использовать такие случаи, как когда база данных предварительного пакета заархивирована. Благодарим Ахмеда Эль-Хельва (Ahmed El-Helw, ahmedre@gmail.com) за вклад в исправление ошибки 3e6792 (b/146911060).
Изменения в API
Добавлена отсутствующая цель для аннотации
@ForeignKey, чтобы предотвратить ее использование за пределами аннотации@Entity. (Iced1e)Поле
mCallbacksв таблицеRoomDatabase.javaтеперь скрыто. (d576cb, b/76109329)
Исправление ошибок
В документацию по TypeConverters добавлено уточнение о том, что TypeConverters можно использовать только для преобразования столбцов и полей, но не строк. (I07c56, b/77307836)
Обновлен DaoProcessor, чтобы исправить ошибку компилятора в Dao с общим супертипом с "примитивами" Kotlin. (Ice6bb, b/160258066)
Обновлена документация по методам добавления и удаления наблюдателей, чтобы уточнить работу с потоками (Ifd1d9, b/153948821).
Исправлена ошибка, из-за которой библиотека Room неправильно проверяла таблицы FTS, в которых был объявлен столбец rowid. (d62ebc, b/145858914)
Внешние взносы
Исправлены проблемы с верхним и нижним регистром в турецком языке (5746e3), b/68159494.
Замените
ConcurrentHashMapвRoomDatabaseнаCollections.synchronizedMap(), чтобы избежать проблем с Android Lollipop (d1cfc7, b/162431855).Добавьте обратный вызов onOpenPrepackagedDatabase для копирования предварительно упакованной базы данных. (I1ba74, b/148934423)
Версия 2.3.0-alpha02
22 июля 2020 г.
Данные "androidx.room:room-*:2.3.0-alpha02" опубликованы. Версия 2.3.0-alpha02 содержит эти коммиты.
Новые функции
- Поддержка RxJava3. Room теперь поддерживает типы RxJava3. Как и в RxJava2, вы можете объявить методы DAO, типом возвращаемого значения которых являются Flowable, Single, Maybe и Completable. Кроме того, для поддержки RxJava3 доступен новый артефакт
androidx.room:room-rxjava3. (b/152427884)
Изменения в API
- Теперь поддерживается объявление
@TypeConverterв классе Kotlin Object. (b/151110764) - Параметр инкрементной обработки аннотаций
Roomтеперь включен по умолчанию. (b/112110217)
Версия 2.3.0-alpha01
10 июня 2020 г.
Данные "androidx.room:room-*:2.3.0-alpha01" опубликованы. Версия 2.3.0-alpha01 содержит эти коммиты.
Новые функции
Поддержка Paging 3.0. Теперь Room поддерживает создание реализаций для методов с аннотацией
@Query, тип возвращаемого значения которых –androidx.paging.PagingSource.@Dao interface UserDao { @Query("SELECT * FROM users ORDER BY id ASC") fun pagingSource(): PagingSource<Int, User> }
Изменения в API
@RewriteQueriesToDropUnusedColumns– это новая удобная аннотация, которая заставляет Room переписать проекцию "*" в запросе, чтобы удалить неиспользуемые столбцы в результате.- Параметр обработчика
room.expandProjectionбольше не поддерживается. Используйте@RewriteQueriesToDropUnusedColumnsвместо Room, чтобы оптимизировать запросы с проекциями со звездочкой. Обратите внимание, что@RewriteQueriesToDropUnusedColumnsне заменяет решениеroom.expandProjectionдля конфликта столбцов, которое предлагается для типов возвращаемых значений, содержащих поля@Embedded.
Исправление ошибок
- Исправлена ошибка, из-за которой библиотека Room неверно определяла версию JDK, используемую для включения инкрементального инструмента обработки аннотаций. Благодарим Блаза Солара (me@blaz.solar) (b/155215201).
- Теперь Room встраивает зависимость ANTLR с инструментом обработки аннотаций, чтобы избежать конфликтов версий с другими инструментами, которые также используют ANTLR. (b/150106190)
Версия 2.2.6
Версия 2.2.6
16 декабря 2020 г.
Данные "androidx.room:room-*:2.2.6" опубликованы. Версия 2.2.6 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой Room неправильно отключал инкрементную обработку аннотаций в более новых версиях JDK. (b/171387388)
Версия 2.2.5
Версия 2.2.5
18 марта 2020 г.
Данные "androidx.room:room-*:2.2.5" опубликованы. Версия 2.2.5 содержит эти коммиты.
Исправление ошибок
- Добавьте в
MultiInstanceInvalidationServiceатрибут directBootAware. Благодарим Mygod (contact-git@mygod.be, b/148240967). - Исправлена ошибка, которая приводила к сбою, когда была включена инвалидация многооконного режима и база данных содержала объект FTS. (b/148969394)
- Исправлена ошибка, из-за которой при загрузке нативных библиотек SQLite в обработчике аннотаций Room происходил сбой компилятора из-за параллельных компиляций. (b/146217083)
Версия 2.2.4
Версия 2.2.4
19 февраля 2020 г.
Выпущены androidx.room:room-common:2.2.4, androidx.room:room-compiler:2.2.4, androidx.room:room-guava:2.2.4, androidx.room:room-ktx:2.2.4, androidx.room:room-migration:2.2.4, androidx.room:room-runtime:2.2.4, androidx.room:room-rxjava2:2.2.4 и androidx.room:room-testing:2.2.4. Версия 2.2.4 содержит эти коммиты.
Исправление ошибок
- Исправлена проблема с приостановкой транзакций, из-за которой они блокировались, если сопрограмма отменялась до фактического начала транзакции. (b/148181325)
- Исправлена ошибка, из-за которой аннотация @Generated неправильно использовалась при сборке с JDK 9. (b/146538330)
- Исправлена ошибка, из-за которой библиотека Room генерировала неправильный код, если интерфейс DAO в Kotlin содержал конкретную функцию. (b/146825845)
Версия 2.2.3
Версия 2.2.3
18 декабря 2019 г.
Данные "androidx.room:room-*:2.2.3" опубликованы. Версия 2.2.3 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой библиотека Room не могла проверить базу данных, которая не была перенесена и содержала устаревший хеш с индексами в схеме. (b/139306173)
Версия 2.2.2
Версия 2.2.2
20 ноября 2019 г.
Данные "androidx.room:room-*:2.2.2" опубликованы. Версия 2.2.2 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой при сборе данных об отношении "один к одному" с более чем 999 строками библиотека Room возвращала нулевые связанные элементы. (b/143105450)
Версия 2.2.1
Версия 2.2.1
23 октября 2019 г.
Данные "androidx.room:room-*:2.2.1" опубликованы. Версия 2.2.1 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой библиотека Room неправильно предупреждала о
CURSOR_MISMATCH, когда параметр компилятораexpandProjectionбыл включен. (b/140759491) - Добавлен механизм повторных попыток для обработки отсутствующей нативной библиотеки, используемой для проверки запросов во время компиляции.
Версия 2.2.0
Версия 2.2.0
9 октября 2019 г.
Данные "androidx.room:room-*:2.2.0" опубликованы. Коммиты, вошедшие в версию 2.2.0
Важные изменения, начиная с версии 2.1.0
- Предварительно упакованная база данных. В
RoomDatabase.Builderтеперь доступны два новых API для созданияRoomDatabaseна основе уже заполненного файла базы данных.createFromAsset()используется, когда файл предварительно заполненной базы данных находится в папке assets APK-файла, аcreateFromFile()– когда файл находится в произвольном месте. Использование этих API меняет поведение деструктивных переносов. При резервном переносе Room попытается повторно скопировать предварительно заполненную базу данных, если она доступна. В противном случае будут удалены и заново созданы все таблицы. b/62185732 - Значения по умолчанию в схеме. В
@ColumnInfoпоявилось новое свойствоdefaultValue, которое можно использовать для указания значения по умолчанию в столбце. Значения по умолчанию являются частью схемы базы данных и будут проверяться во время переноса, если они указаны. b/64088772 - Отношения "многие ко многим". В
@Relationдобавлено новое свойствоassociateBy, которое принимает новую аннотацию@Junction, используемую для объявления отношения, которое должно быть удовлетворено через таблицу соединений. b/69201917 - Отношения "один к одному". Снято ограничение, согласно которому поля POJO, аннотированные с помощью
@Relation, должны иметь типListилиSet. Это позволяет представлять отношения с одним значением. b/62905145 - Целевой объект. В аннотациях DAO
@Insert,@Updateи@Deleteтеперь есть новое свойствоtargetEntity, которое позволяет указать целевую таблицу, на которую должен воздействовать метод DAO. Это позволяет использовать в качестве параметров методов DAO произвольные POJO, которые будут интерпретироваться как частичные сущности. На практике это позволяет частично вставлять, удалять и обновлять данные. b/127549506 - Coroutines Flow. Теперь методы DAO могут иметь тип возвращаемого значения
@Query.Flow<T>Возвращенный поток повторно выдаст новый набор значений, если наблюдаемые таблицы в запросе недействительны. Объявление функции DAO с типом возвращаемого значенияChannel<T>является ошибкой. Вместо этого Room рекомендует использоватьFlow, а затем использовать соседние функции для преобразованияFlowвChannel. b/130428884 - Инкрементный инструмент обработки аннотаций Gradle. Теперь Room – это изолирующий инструмент обработки аннотаций Gradle. Инкрементность можно включить с помощью параметра
room.incremental. Подробнее о параметрах компилятора Room… Если у вас возникнут проблемы, сообщите нам о них. Мы планируем включить инкрементальность по умолчанию в будущей стабильной версии. b/112110217 - Расширение проекций. Добавлен новый экспериментальный параметр компилятора
room.expandProjection, который заставляет библиотеку Room переписывать запрос со звездной проекцией, чтобы он содержал только столбцы в типе возвращаемого значения POJO. Например, для метода DAO с@Query("SELECT * FROM Song"), который возвращаетSongIdAndTitleтолько с двумя полями. Затем Room перепишет запрос вSELECT id, title FROM Song, чтобы получить минимальный набор столбцов, удовлетворяющий типу возвращаемого значения. Это позволяет избежать предупрежденияCURSOR_MISMATCH, которое появляется, когда запрос возвращает дополнительные столбцы, не соответствующие ни одному полю в возвращаемом типе POJO.
Версия 2.2.0-rc01
5 сентября 2019 г.
Данные "androidx.room:room:2.2.0-rc01" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.
Нет общедоступных изменений с версии Room 2.2.0-beta01.
Версия 2.2.0-beta01
22 августа 2019 г.
Данные "androidx.room:room-*:2.2.0-beta01" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.
Исправление ошибок
- Исправлена ошибка, из-за которой запрос Coroutine Flow переставал повторно выдавать новые значения по истечении определенного времени. (b/139175786)
- Исправлена ошибка, из-за которой библиотека Room не принимала хеш-код устаревшей схемы при открытии базы данных, которая не переносилась с момента выхода Room 1.0. Это приводило к сбою во время выполнения из-за недопустимой схемы. (b/139306173)
Версия 2.2.0-alpha02
7 августа 2019 г.
Данные "androidx.room:room-*:2.2.0-alpha02" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.
Новые функции
- Coroutines Flow. Теперь методы DAO могут иметь тип возвращаемого значения
@Query.Flow<T>Возвращенный поток повторно выдаст новый набор значений, если наблюдаемые таблицы в запросе недействительны. Объявление функции DAO с типом возвращаемого значенияChannel<T>является ошибкой. Вместо этого Room рекомендует использоватьFlow, а затем использовать соседние функции для преобразованияFlowвChannel. b/130428884 - Расширение проекций. Добавлен новый экспериментальный параметр компилятора
room.expandProjection, который заставляет библиотеку Room переписывать запрос со звездной проекцией, чтобы он содержал только столбцы в типе возвращаемого значения POJO. Например, для метода DAO с@Query("SELECT * FROM Song"), который возвращаетSongIdAndTitleтолько с двумя полями. Затем Room перепишет запрос вSELECT id, title FROM Song, чтобы получить минимальный набор столбцов, удовлетворяющий типу возвращаемого значения. Это позволяет избежать предупрежденияCURSOR_MISMATCH, которое появляется, когда запрос возвращает дополнительные столбцы, не соответствующие ни одному полю в возвращаемом типе POJO. onDestructiveMigrate– новый callback API, добавленный вRoomDatabase.Callbackдля случаев, когда Room выполняет деструктивную миграцию базы данных. b/79962330
Исправление ошибок
- Исправлена ошибка, из-за которой библиотека Room генерировала неправильный код, используя метод в качестве сеттера поля, когда поле защищено. b/136194628
- Исправлена ошибка, из-за которой InvalidationTracker выдавал NPE во втором процессе, когда была включена аннуляция нескольких экземпляров и сервис аннуляции был отключен. b/137454915
- Исправлена ошибка, из-за которой библиотека Room неверно определяла тип возвращаемого значения унаследованной функции приостановки, помеченной аннотацией
@RawQuery. b/137878827 - Обновлен сгенерированный код для
@Relation, когда связанный ключ имеет тип BLOB, чтобы использовать сопоставимыйByteBuffer. b/137881998 - Исправлена ошибка, из-за которой библиотека Room сообщала об отсутствии сеттеров в POJO, используемых в качестве параметров частичных объектов
@Insert,@Updateи@Delete. b/138664463 - Исправлена ошибка, из-за которой библиотека Room сообщала об отсутствии методов получения и установки для столбца, игнорируемого с помощью
@Entity, когда класс сущности использовался в определенных методах DAO. b/138238182 - Исправлена ошибка, из-за которой библиотека Room неправильно преобразовывала именованные аргументы привязки в позиционные аргументы, что приводило к исключению во время выполнения при выполнении запроса с повторно используемыми параметрами. b/137254857
Версия 2.2.0-alpha01
10 июля 2019 г.
Новые функции
- Предварительно упакованная база данных. В
RoomDatabase.Builderтеперь доступны два новых API для созданияRoomDatabaseна основе уже заполненного файла базы данных.createFromAsset()используется, когда файл предварительно заполненной базы данных находится в папке assets APK-файла, аcreateFromFile()– когда файл находится в произвольном месте. Использование этих API меняет поведение деструктивных переносов. При резервном переносе Room попытается повторно скопировать предварительно заполненную базу данных, если она доступна. В противном случае будут удалены и заново созданы все таблицы. b/62185732 - Значения по умолчанию в схеме. В
@ColumnInfoпоявилось новое свойствоdefaultValue, которое можно использовать для указания значения по умолчанию в столбце. Значения по умолчанию являются частью схемы базы данных и будут проверяться во время переноса, если они указаны. b/64088772Примечание. Если в схеме базы данных уже есть значения по умолчанию, например добавленные с помощью
ALTER TABLE x ADD COLUMN y INTEGER NOTNULL DEFAULT z, и вы решите задать значения по умолчанию для тех же столбцов с помощью@ColumnInfo, вам может потребоваться выполнить миграцию, чтобы проверить неучтенные значения по умолчанию. Подробнее о переносе баз данных Room… - Отношения "многие ко многим". В
@Relationдобавлено новое свойствоassociateBy, которое принимает новую аннотацию@Junction, используемую для объявления отношения, которое должно быть удовлетворено через таблицу соединений. b/69201917 - Отношения "один к одному". Снято ограничение, согласно которому поля POJO, аннотированные с помощью
@Relation, должны иметь типListилиSet. Это позволяет представлять отношения с одним значением. b/62905145 - Целевой объект. В аннотациях DAO
@Insert,@Updateи@Deleteтеперь есть новое свойствоtargetEntity, которое позволяет указать целевую таблицу, на которую должен воздействовать метод DAO. Это позволяет использовать в качестве параметров методов DAO произвольные POJO, которые будут интерпретироваться как частичные сущности. На практике это позволяет частично вставлять, удалять и обновлять данные. b/127549506 - Инкрементный инструмент обработки аннотаций Gradle. Теперь Room – это изолирующий инструмент обработки аннотаций Gradle. Инкрементность можно включить с помощью параметра
room.incremental. Подробнее о параметрах компилятора Room… Если у вас возникнут проблемы, сообщите нам о них. Мы планируем включить инкрементальность по умолчанию в будущей стабильной версии. b/112110217
Исправление ошибок
- Библиотека Room больше не будет передавать
EmptySetResultExceptionглобальному обработчику ошибок, если поток Rx запроса был удален до завершения запроса. b/130257475 - Исправлена ошибка, из-за которой библиотека Room показывала неверное сообщение об ошибке, когда у функции приостановки DAO, аннотированной с помощью
@RawQuery, не было типа возвращаемого значения. b/134303897 - Библиотека Room больше не будет генерировать адаптеры DAO с необработанными типами. b/135747255
Версия 2.1.0
Версия 2.1.0
13 июня 2019 г.
Выпущена библиотека Room 2.1.0 без изменений по сравнению с версией 2.1.0-rc01. Коммиты, включенные в версию, можно найти здесь.
Важные изменения, внесенные в версию 2.0.0
- FTS. Room теперь поддерживает объекты с таблицей сопоставления FTS3 или FTS4. Классы, аннотированные с помощью
@Entity, теперь можно дополнительно аннотировать с помощью@Fts3или@Fts4, чтобы объявить класс с таблицей сопоставления полнотекстового поиска. Дополнительные параметры FTS для дальнейшей настройки доступны через методы аннотации. - Представления. Теперь Room поддерживает объявление класса как сохраненного запроса, также известного как представление, с помощью аннотации
@DatabaseView. - Сопрограммы. Методы DAO теперь могут быть функциями приостановки. Чтобы воспользоваться этой функцией, добавьте
room-ktxв зависимости. Артефакт ktx также предоставляет функцию расширенияRoomDatabase.withTransactionдля выполнения транзакций базы данных в сопрограмме. - Auto Value. Теперь Room поддерживает объявление классов с аннотацией AutoValue как сущностей и POJO. Аннотации Room
@PrimaryKey,@ColumnInfo,@Embeddedи@Relationтеперь можно объявлять в абстрактных методах класса с аннотацией AutoValue. Обратите внимание, что эти аннотации также должны сопровождаться@CopyAnnotations, чтобы Room правильно их понимал. - Дополнительная поддержка асинхронных операций. Методы DAO, аннотированные с помощью
@Insert,@Deleteили@Update, а также@Query, содержащие операторыINSERT,DELETEилиUPDATE, теперь поддерживают типы возвращаемых значений RxCompletable,Single,Maybeи тип возвращаемого значения GuavaListenableFuture. Они также могут быть функциями приостановки. enableMultiInstanceInvalidation– это новый API вRoomDatabase.Builder, который позволяет аннулировать данные в нескольких экземплярах RoomDatabase, использующих один и тот же файл базы данных.fallbackToDestructiveMigrationOnDowngrade– это новый API вRoomDatabase.Builder, который автоматически воссоздает базу данных в случае понижения версии.ignoredColumns– это новый API в аннотации@Entity, который можно использовать для перечисления игнорируемых полей по имени.- Теперь Room будет правильно использовать основной конструктор Kotlin в классах данных, поэтому не нужно объявлять свойства как
vars.
Версия 2.1.0-rc01
29 мая 2019 г.
Исправление ошибок
- Исправлена ошибка инициализации Room, которая могла возникать из-за уже настроенной конфигурации temp_store. b/132602198
- Исправлено предупреждение об использовании двойных кавычек для пользователей SQLite 3.27.0 и более поздних версий. b/131712640
- Исправлена ошибка, из-за которой InvalidationTracker вызывал сбой, когда параллельно выполнялось несколько проверок недействительности. b/133457594
Версия 2.1.0-beta01
7 мая 2019 г.
Версия androidx.room 2.1.0-beta01 выпущена без изменений по сравнению с 2.1.0-alpha07. Фиксации, включенные в эту версию, можно найти здесь.
Версия 2.1.0-alpha07
25 апреля 2019 г.
Изменения в API и поведении
- Функция расширения
RoomDatabase.withTransactionбольше не принимает блок функции сCoroutineScopeв качестве получателя. Это позволяет избежать пропуска дополнительной оболочкиcoroutineScope { }, необходимой для одновременного выполнения операций в блоке транзакции.
Исправление ошибок
- Исправлена ошибка, из-за которой библиотека Room не могла сопоставить TypeConverter с функцией DAO Kotlin, содержащей параметр типа Collection. b/122066791
Версия 2.1.0-alpha06
22 марта 2019 г.
Изменения в API и поведении
- Асинхронные запросы транзакций теперь сериализуются, поэтому Room не будет использовать более одного потока для выполнения транзакций базы данных.
Добавлен метод
RoomDatabase.Builder.setTransactionExecutor(Executor), позволяющий настраивать исполнителя для транзакций. RoomDatabase.runInTransaction(Callable)больше не будет упаковывать проверяемые исключения в RuntimeExceptions. b/128623748
Исправление ошибок
- Исправлена ошибка, из-за которой трекер недействительности переставал отслеживать таблицу контента, если были добавлены наблюдатели как для таблицы контента, так и для таблицы FTS внешнего контента. b/128508917
- Обновлена грамматика SQLite в
Room, чтобы она соответствовала SQLite 3.24.0. b/110883668
Версия 2.1.0-alpha05
13 марта 2019 г.
Новые функции
- Функция расширения
RoomDatabase.withTransactionпозволяет безопасно выполнять транзакции базы данных в сопрограмме. Функции расширения Room и поддержка сопрограмм доступны в артефактеroom-ktx. - Неабстрактные методы DAO, аннотированные с помощью
@Transaction, теперь могут быть функциями приостановки. b/120241587
Изменения в API и поведении
- Артефакт
room-coroutinesпереименован вroom-ktxв соответствии с другими артефактами androidx. beginTransaction,setTransactionSuccessfulиendTransactionвRoomDatabaseбольше не поддерживаются. Вместо них используйтеrunInTransactionи функцию расширенияroom-ktxwithTransaction.
Исправление ошибок
- Исправлена ошибка, из-за которой аргументы токенизатора отбрасывались, если использовался токенизатор SIMPLE. b/125427014
- Исправлена ошибка, из-за которой библиотека Room не могла правильно идентифицировать приостанавливающие функции с параметрами, тип которых был внутренним классом. b/123767877
- Исправлена ошибка, из-за которой отложенный метод DAO
@Queryс операторамиINSERT,UPDATEилиDELETEактивно подготавливал запрос в основном потоке. b/123695593 - Исправлены ошибки, из-за которых библиотека Room генерировала неправильный код для некоторых функций приостановки. b/123466702 и b/123457323
- Исправлена ошибка, из-за которой устаревшие методы не подавлялись в сгенерированном коде. b/117602586
- Зависимость Room от androidx.sqlite обновлена до версии 1.0.2, в которой исправлена обработка поврежденных баз данных. b/124476912
Известные проблемы
- Библиотека Room 2.1.0-alpha05 зависит от артефакта
kotlinx-metadata-jvm, который сейчас недоступен в центральном репозитории Maven (KT-27991). Чтобы устранить эту зависимость, добавьтеmaven { url "https://kotlin.bintray.com/kotlinx/" }в хранилища проекта.
Версия 2.1.0-alpha04
25 января 2019 г.
Новые функции
- Методы DAO, аннотированные с помощью
@Queryи содержащие операторыINSERT,UPDATEилиDELETE, теперь могут возвращать асинхронные типыSingle,Mayble,CompletableиListenableFuture. Кроме того, они могут быть функциями приостановки. b/120227284
Изменения в API и поведении
- Теперь Room будет выдавать ошибку, если неабстрактный метод DAO, аннотированный с помощью
@Transaction, возвращает асинхронный тип, напримерSingle,Mayble,Completable,LiveDataилиListenableFuture. Поскольку транзакции ограничены потоком, в настоящее время Room не может начать и завершить транзакцию вокруг функции, которая может выполнять запросы в разных потоках. b/120109336 OnConflictStrategy.FAILиOnConflictStrategy.ROLLBACKбыли@Deprecated, поскольку они не работают должным образом с текущими привязками SQLite в Android. b/117266738
Исправление ошибок
- Исправлена ошибка, из-за которой библиотека Room не могла правильно использовать TypeConverter типа возвращаемого значения, если метод DAO был функцией приостановки. b/122988159
- Исправлена ошибка, из-за которой библиотека Room неправильно определяла унаследованные функции приостановки как функции без приостановки. b/122902595
- Исправлена ошибка, из-за которой библиотека Room генерировала неправильный код, когда поле
@Embeddedнаходилось в родительском классе и использовалось в нескольких дочерних классах. b/121099048 - Исправлена ошибка, из-за которой база данных блокировалась при вызове функций приостановки DAO между
beginTransaction()иendTransaction(). b/120854786
Версия 2.1.0-alpha03
4 декабря 2018 г.
Изменения в API
- Теперь FTS
tokenizerв@Fts3/@Fts4принимает строку вместо перечисления. Это позволяет использовать специальные токенизаторы в Room. Встроенные токенизаторы по-прежнему определяются вFtsOptionsкак строковые константы. b/119234881
Новые функции
- Сопрограммы. Методы DAO теперь могут быть функциями приостановки. Для поддержки функций приостановки в Room был выпущен новый артефакт
room-coroutines. b/69474692 - Методы DAO, аннотированные с помощью
@Insert,@Deleteили@Update, теперь поддерживаютListenableFutureв качестве типа возвращаемого значения. b/119418331
Исправление ошибок
- Исправлена ошибка, из-за которой библиотека Room пыталась найти конструктор со столбцами в свойстве
ignoredColumnsкласса@Entity. b/119830714 - Исправлена ошибка, из-за которой библиотека Room не помечала параметры метода DAO как final в сгенерированной реализации. b/118015483
- Исправлена ошибка, из-за которой процессор
Roomаварийно завершал работу при сообщении об ошибке в запросе со специальными символами. b/119520136 - Исправлена ошибка, из-за которой библиотека Room отклоняла различные реализации
Collectionв качестве аргументов выраженияIN. b/119884035 - Исправлена ошибка, из-за которой LiveData, возвращенные из Room, собирались как мусор при постоянном наблюдении, что приводило к прекращению передачи новых данных. b/74477406
- Обновлена блокировка закрытия
RoomDatabase, чтобы уменьшить конкуренцию за блокировку. b/117900450
Версия 2.1.0-alpha02
30 октября 2018 г.
Новые функции
- Добавлена поддержка ссылок на
@DatabaseViewв@Relation. b/117680932
Исправление ошибок
- Исправлена ошибка, из-за которой библиотека Room выполняла операции I/O на диске в основном потоке при подписке и удалении из типа возвращаемого значения Rx. b/117201279
- Исправлена ошибка, из-за которой Room не удавалось найти подходящий преобразователь типов для поля в классе сущности Kotlin. b/111404868
- Исправлена ошибка, из-за которой библиотека Room генерировала неверный код для реализации интерфейса
DAO, содержащего метод Kotlin по умолчанию без аргументов. b/117527454 - Обновлен синтаксический анализатор грамматики SQLite
Room. Исправлена проблема производительности, которая приводила к увеличению времени сборки. b/117401230
Версия 2.1.0-alpha01
8 октября 2018 г.
Новые функции
- FTS. Теперь Room поддерживает объекты с таблицей сопоставления FTS3 или FTS4. Классы, аннотированные с помощью
@Entity, теперь можно дополнительно аннотировать с помощью@Fts3или@Fts4, чтобы объявить класс с таблицей сопоставления полнотекстового поиска. Дополнительные настройки полнотекстового поиска доступны в методах аннотации. b/62356416 - Представления. Теперь Room поддерживает объявление класса как сохраненного запроса, также известного как представление, с помощью аннотации @DatabaseView. b/67033276
- Auto Value. Теперь Room поддерживает объявление классов с аннотацией AutoValue как объектов и POJO. Аннотации Room
@PrimaryKey,@ColumnInfo,@Embeddedи@Relationтеперь можно объявлять в абстрактных методах класса с аннотацией AutoValue. Обратите внимание, что эти аннотации также должны сопровождаться@CopyAnnotations, чтобы Room правильно их понимал. b/62408420 - Дополнительная поддержка типов возвращаемых значений Rx. Методы DAO, аннотированные с помощью
@Insert,@Deleteили@Update, теперь поддерживают типы возвращаемых значений RxCompletable,Single<T>иMaybe<T>. b/63317956 - Неизменяемые типы с
@Relation. Ранее библиотека Room требовала, чтобы поля с аннотацией@Relationбыли настраиваемыми, но теперь они могут быть параметрами конструктора. enableMultiInstanceInvalidation– новый API вRoomDatabase.Builder, который позволяет аннулировать несколько экземпляров RoomDatabase, использующих один и тот же файл базы данных. Этот механизм аннулирования нескольких экземпляров также работает в нескольких процессах. b/62334005fallbackToDestructiveMigrationOnDowngrade– новый API вRoomDatabase.Builder, который автоматически воссоздает базу данных при понижении версии. b/110416954ignoredColumns– новый API в аннотации@Entity, который можно использовать для перечисления игнорируемых полей по названию. Полезно для игнорирования унаследованных полей в объекте. b/63522075
Изменения в API и поведении
mCallbackиmDatabaseвRoomDatabaseтеперь называются@Deprecatedи будут удалены в следующей основной версии Room. b/76109329
Исправление ошибок
- Исправлены две ошибки, из-за которых библиотека Room не могла восстановить данные из поврежденной базы данных или после неудачного переноса во время инициализации. b/111504749 и b/111519144
- Теперь Room будет правильно использовать основной конструктор Kotlin в классах данных, поэтому объявлять поля как
varsне нужно. b/105769985
Версия 2.0.0
Версия 2.0.0
1 октября 2018 г.
Версия androidx.room 2.0.0 выпущена без изменений по сравнению с 2.0.0-rc01.
Версия 2.0.0-rc01
20 сентября 2018 г.
Версия androidx.room 2.0.0-rc01 выпущена без изменений по сравнению с 2.0.0-beta01.
Версия 2.0.0-beta01
2 июля 2018 г.
Изменения в API и поведении
- Добавлено поле
RoomDatabase.Builder.setQueryExecutor(), позволяющее настраивать место выполнения запросов. - Добавлена поддержка RxJava2
Observable. - Сгенерированные реализации DAO и базы данных теперь являются окончательными.
Исправление ошибок
- Укажите название класса/поля в ошибке "cannot find getter for field" b/73334503
- Исправлена обратная совместимость RoomOpenHelper с более старыми версиями Room b/110197391.
Зависимости до AndroidX
Для версий Room до AndroidX включите следующие зависимости:
dependencies {
def room_version = "1.1.1"
implementation "android.arch.persistence.room:runtime:$room_version"
annotationProcessor "android.arch.persistence.room:compiler:$room_version" // For Kotlin use kapt instead of annotationProcessor
// optional - RxJava support for Room
implementation "android.arch.persistence.room:rxjava2:$room_version"
// optional - Guava support for Room, including Optional and ListenableFuture
implementation "android.arch.persistence.room:guava:$room_version"
// Test helpers
testImplementation "android.arch.persistence.room:testing:$room_version"
}
Версия 1.1.1
Версия 1.1.1
19 июня 2018 г.
Комната 1.1.1 идентична комнате 1.1.1-rc1.
Версия 1.1.1-rc1
16 мая 2018 г.
Если вы используете миграции, настоятельно рекомендуем перейти с Room 1.1.0 на Room 1.1.1-rc1.
Исправлена ошибка, из-за которой библиотека Room не могла правильно выполнить инициализацию после переноса b/79362399.
Версия 1.1.0
Версия 1.1.0-beta3
19 апреля 2018 г.
Исправление ошибок
- Исправлена ошибка компиляции, возникавшая, когда POJO-класс Kotlin ссылался на объект отношения, определенный в Java b/78199923.
Версия 1.1.0-beta2
5 апреля 2018 г.
Исправление ошибок
Исправлена критическая ошибка в реализациях
RoomRxSingleиMaybe, из-за которой запрос перезапускался раньше времени, что приводило к проблемам при добавлении более одного наблюдателя к возвращенным экземплярамSingleилиMaybe. b/76031240[RoomDatabase.clearAllTables][ref-clearAllTables] не будет
VACUUMбазу данных, если вызывается внутри транзакции. b/77235565
Версия 1.1.0-beta1
21 марта 2018 г.
Изменения в API
- На основе отзывов о проверке API
@RawQueryбольше не принимаетStringв качестве параметра запроса. Вам нужно использовать [SupportSQLiteQuery][ref-SupportSQLiteQuery]. (см. [SimpleSQLiteQuery][ref-SimpleSQLiteQuery], чтобы легко создать экземпляр [SupportSQLiteQuery][ref-SupportSQLiteQuery] с поддержкой аргументов). - Метод [fallbackToDestructiveMigrationFrom][ref-fallbackToDestructiveMigrationFrom] класса RoomDatabase.Builder теперь принимает
vararg intвместоvararg Integer.
Исправление ошибок
- [RoomDatabase.clearAllTables][ref-clearAllTables] теперь пытается вернуть пространство операционной системе, устанавливая контрольную точку WAL и
VACUUMбазу данных. - [
@RawQuery][ref-RawQuery] теперь принимает любой Pojo для свойстваobservedEntities, если Pojo ссылается на один или несколько объектов через свои поляEmbeddedилиRelation. b/74041772 - Разбиение на страницы. Реализация DataSource в Room теперь корректно обрабатывает зависимости между несколькими таблицами (например, отношения и соединения). Ранее такие запросы не возвращали новые результаты или не компилировались. b/74128314
Версия 1.1.0-alpha1
22 января 2018 г.
Новые функции
RawQuery. Этот новый API позволяет методам@Daoполучать SQL в качестве параметра запроса. b/62103290, b/71458963fallBackToDestructiveMigrationsFrom– новый API вRoomDatabase.Builder, который позволяет точнее контролировать, с каких начальных версий схемы разрешены деструктивные переносы (по сравнению с fallbackToDestructiveMigration). b/64989640- Библиотека Room теперь поддерживает только новые API Paging (alpha-4+). Поддержка устаревшего API
LivePagedListProviderпрекращена. Чтобы использовать новую альфа-версию Room, вам понадобится библиотека Paging версииalpha-4или выше. Если вы ещё не перешли сLivePagedListProviderнаLivePagedListBuilder, сделайте это.
Исправление ошибок
- Улучшена поддержка типов Kotlin Kapt. b/69164099
- Порядок полей больше не влияет на действительность схемы. b/64290754