Комната

Библиотека персистентности Room предоставляет уровень абстракции над SQLite, который позволяет более надежно обращаться к базе данных, используя все возможности SQLite.
Последнее обновление Основная версия Релиз-кандидат Бета-версия Альфа-версия
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, избегая переходов между потоками и сохраняя то же поведение блокировки, что и у API SupportSQLiteDatabase. (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

  • Удалены устаревшие аннотации @RequiresApi(21) (Ic4792, I9103b).

Исправление ошибок

  • Исправлено состояние гонки, при котором Room Flows не выдавал последний результат запроса в асинхронной ситуации с несколькими запросами/записями. (Ic9a3c)

Версия 2.8.0-beta01

1 августа 2025 г.

Данные "androidx.room:room-*:2.8.0-beta01" опубликованы. Версия 2.8.0-beta01 содержит эти коммиты.

Исправление ошибок

  • Теперь названия таблиц и представлений экранируются правильно во время деструктивных переносов. (9e55f8, b/427095319)

Версия 2.8.0-alpha01

16 июля 2025 г.

Данные "androidx.room:room-*:2.8.0-alpha01" опубликованы. Версия 2.8.0-alpha01 содержит эти коммиты.

Новые функции

  • Добавлен новый артефакт androidx.room:room-sqlite-wrapper, который содержит API для получения оболочки SupportSQLiteDatabase для RoomDatabase с настроенным SQLiteDriver. Чтобы получить оболочку, используйте новую функцию расширения RoomDatabase.getSupportWrapper(). Это артефакт совместимости, который позволяет использовать SupportSQLiteDatabase, обычно получаемый из RoomDatabase.openHelper.writableDatabase, даже если база данных Room настроена с помощью SQLiteDriver. Эта оболочка полезна для постепенного переноса баз кода, которые хотят использовать SQLiteDriver, но имеют обширное использование API SupportSQLite, но при этом хотят воспользоваться преимуществами BundledSQLiteDriver. (Icf6ac)
  • Добавлены целевые платформы KMP для Watch OS и TV OS (I228f6, b/394238801).

Исправление ошибок

  • Исправлена взаимоблокировка, которая могла иногда возникать при использовании приостановки транзакций и AndroidSQLiteDriver. (b/415006268)

Версия 2.7

Версия 2.7.2

18 июня 2025 г.

Данные "androidx.room:room-*:2.7.2" опубликованы. Версия 2.7.2 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой значения аннотаций неправильно считывались при обработке нативных источников с помощью KSP, что иногда приводило к отсутствию экспорта схем. (b/416549580)
  • Исправлена ошибка, из-за которой комментарии в начале SQL-запроса приводили к тому, что команды выполнялись как запросы, не предназначенные для чтения. (b/413061402)
  • Исправлена ошибка, из-за которой не удавалось настроить плагин Gradle для библиотеки Room, если каталог схемы был пуст. (b/417823384)
  • Если подключение занимает слишком много времени, больше не выдается ошибка SQLiteException. Вместо этого библиотека отправляет сообщение в журнал. Ведение журнала вместо создания исключений позволяет обойти проблему с приостановкой циклов в iOS, из-за которой 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() был обобщен как собственный API InvalidationTracker.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. Новая стратегия выглядит следующим образом:

  1. Определите объект expect, который реализует RoomDatabaseConstructor.

      expect object MyDatabaseCtor : RoomDatabaseConstructor<MyDatabase>
    
  2. Свяжите объект с объявлением @Database, используя @ConstructedBy.

      @Database(...)
      @ConstructedBy(MyDatabaseCtor::class) // NEW
      abstract class MyDatabase : RoomDatabase
    
  3. Создайте новый экземпляр базы данных, не передавая аргумент фабрики.

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

Исправлены ошибки b/316978491, b/338446862 и b/342905180.

  • Поддержка @RawQuery в Room KMP за счет добавления нового API RoomRawQuery, который похож на SupportSQLiteQuery в плане хранения необработанной строки SQL и функции для привязки аргументов к оператору. Функции с аннотацией @RawQuery теперь могут принимать RoomRawQuery в качестве единственного параметра. (Iea844, b/330586815)
  • Добавьте перегрузку setQueryCallback(), которая принимает CoroutineContext. (Id66ff, b/309996304)
  • Добавлена поддержка целевых платформ Kotlin Multiplatform: linuxArm64 (I139d3, b/338268719).

Исправление ошибок

  • Исправлена ошибка, из-за которой библиотека Room неправильно генерировала вызов recursiveFetchArrayMap в целевых объектах, не относящихся к Android. (710c36, b/352482325)
  • Исправлена ошибка, из-за которой библиотека Room иногда выдавала исключение "Превышено время ожидания подключения" в проекте KMP. (fa72d0, b/347737870)
  • Исправлена ошибка, из-за которой при автоматическом переносе внешние ключи проверялись до того, как схемы других таблиц были изменены в соответствии с новыми внешними ключами. (7672c0, b/352085724)

Версия 2.7.0-alpha05

10 июля 2024 г.

Данные "androidx.room:room-*:2.7.0-alpha05" опубликованы. Версия 2.7.0-alpha05 содержит эти коммиты.

Изменения в API

  • Название SQLiteKt изменено на SQLite, а BundledSQLiteKt – на BundledSQLite. (I8b501)

Исправление ошибок

  • Исправлена ошибка, из-за которой RoomDatabase зависал или выдавал ошибку тайм-аута подключения при использовании AndroidSQLiteDriver.

Версия 2.7.0-alpha04

12 июня 2024 г.

Данные "androidx.room:room-*:2.7.0-alpha04" опубликованы. Версия 2.7.0-alpha04 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой инструмент обработки аннотаций библиотеки Room генерировал несовместимый код KMP, когда в 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(). Дополнительную информацию о SQLite Driver 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 содержит эти коммиты.

Новые функции

Изменения в 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, Observable Rx или сопрограммы 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, теперь поддерживают типы возвращаемых значений Rx Completable, Single, Maybe и тип возвращаемого значения Guava ListenableFuture. Они также могут быть функциями приостановки.
  • 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-ktx withTransaction.

Исправление ошибок

  • Исправлена ошибка, из-за которой аргументы токенизатора отбрасывались, если использовался токенизатор 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, теперь поддерживают типы возвращаемых значений Rx Completable, Single<T> и Maybe<T>. b/63317956
  • Неизменяемые типы с @Relation. Ранее библиотека Room требовала, чтобы поля с аннотацией @Relation были настраиваемыми, но теперь они могут быть параметрами конструктора.
  • enableMultiInstanceInvalidation – новый API в RoomDatabase.Builder, который позволяет аннулировать несколько экземпляров RoomDatabase, использующих один и тот же файл базы данных. Этот механизм аннулирования нескольких экземпляров также работает в нескольких процессах. b/62334005
  • fallbackToDestructiveMigrationOnDowngrade – новый API в RoomDatabase.Builder, который автоматически воссоздает базу данных при понижении версии. b/110416954
  • ignoredColumns – новый API в аннотации @Entity, который можно использовать для перечисления игнорируемых полей по названию. Полезно для игнорирования унаследованных полей в объекте. b/63522075

Изменения в API и поведении

  • mCallback и mDatabase в RoomDatabase теперь называются @Deprecated и будут удалены в следующей основной версии Room. b/76109329

Исправление ошибок

  • Исправлены две ошибки, из-за которых библиотека 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 г.

Исправление ошибок

  • Исправлена критическая ошибка в реализациях Room Rx Single и 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/71458963
  • fallBackToDestructiveMigrationsFrom – новый 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