Stanza
| Ultimo aggiornamento | Release stabile | Candidato per la release | Release beta | Release alpha |
|---|---|---|---|---|
| 9 settembre 2026 | 2.8.5 | - | - | - |
Dichiara le dipendenze
Per aggiungere una dipendenza da Room, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.
Le dipendenze per Room includono test delle migrazioni di Room e Room RxJava
Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per
la tua app o il tuo modulo:
Kotlin
dependencies { val room_version = "2.8.5" implementation("androidx.room:room-runtime:$room_version") // If this project uses any Kotlin source, use Kotlin Symbol Processing (KSP) // See Add the KSP plugin to your project ksp("androidx.room:room-compiler:$room_version") // If this project only uses Java source, use the Java annotationProcessor // No additional plugins are necessary annotationProcessor("androidx.room:room-compiler:$room_version") // optional - Kotlin Extensions and Coroutines support for Room implementation("androidx.room:room-ktx:$room_version") // optional - RxJava2 support for Room implementation("androidx.room:room-rxjava2:$room_version") // optional - RxJava3 support for Room implementation("androidx.room:room-rxjava3:$room_version") // optional - Guava support for Room, including Optional and ListenableFuture implementation("androidx.room:room-guava:$room_version") // optional - Test helpers testImplementation("androidx.room:room-testing:$room_version") // optional - Paging 3 Integration implementation("androidx.room:room-paging:$room_version") }
Groovy
dependencies { def room_version = "2.8.5" implementation "androidx.room:room-runtime:$room_version" // If this project uses any Kotlin source, use Kotlin Symbol Processing (KSP) // See KSP Quickstart to add KSP to your build ksp "androidx.room:room-compiler:$room_version" // If this project only uses Java source, use the Java annotationProcessor // No additional plugins are necessary annotationProcessor "androidx.room:room-compiler:$room_version" // optional - RxJava2 support for Room implementation "androidx.room:room-rxjava2:$room_version" // optional - RxJava3 support for Room implementation "androidx.room:room-rxjava3:$room_version" // optional - Guava support for Room, including Optional and ListenableFuture implementation "androidx.room:room-guava:$room_version" // optional - Test helpers testImplementation "androidx.room:room-testing:$room_version" // optional - Paging 3 Integration implementation "androidx.room:room-paging:$room_version" }
Per informazioni sull'utilizzo del plug-in KAPT, consulta la documentazione di KAPT.
Per informazioni sull'utilizzo del plug-in KSP, consulta la documentazione della guida rapida di KSP.
Per informazioni sull'utilizzo delle estensioni Kotlin, consulta la documentazione di ktx.
Per saperne di più sulle dipendenze, consulta Aggiungi dipendenze di build.
Facoltativamente, per le librerie non Android (ad es. moduli Gradle solo Java o Kotlin)
puoi fare affidamento su androidx.room:room-common per utilizzare le annotazioni Room.
Configurazione delle opzioni del compilatore
Room ha le seguenti opzioni del processore di annotazioni.
room.schemaLocation |
directory
Consente di esportare gli schemi del database in file JSON nella directory specificata. Per saperne di più, consulta Migrazioni delle stanze. |
room.incremental |
boolean
Abilita il processore di annotazioni incrementali di Gradle. Il valore predefinito è true.
|
room.generateKotlin |
boolean
Genera file di origine Kotlin anziché Java. Richiede KSP. Il valore predefinito è true a partire dalla versione 2.7.0.
Per ulteriori dettagli, consulta le note sulla versione 2.6.0, quando è stata introdotta.
|
Utilizza il plug-in Room Gradle
Con Room versione 2.6.0 e successive, puoi utilizzare il plug-in Gradle di Room per configurare le opzioni per il compilatore Room. Il plug-in configura il progetto in modo che gli schemi generati (che sono un output delle attività di compilazione e vengono utilizzati per le migrazioni automatiche) siano configurati correttamente per avere build riproducibili e memorizzabili nella cache.
Per aggiungere il plug-in, definisci il plug-in e la relativa versione nel file di build Gradle di primo livello.
Alla moda
plugins { id 'androidx.room' version "$room_version" apply false }
Kotlin
plugins { id("androidx.room") version "$room_version" apply false }
Nel file di build Gradle a livello di modulo, applica il plug-in e utilizza l'estensione room.
Alla moda
plugins { id 'androidx.room' } android { ... room { schemaDirectory "$projectDir/schemas" } }
Kotlin
plugins { id("androidx.room") } android { ... room { schemaDirectory("$projectDir/schemas") } }
L'impostazione di un schemaDirectory è obbligatoria quando utilizzi il plug-in Room Gradle. In questo modo, il compilatore Room, le varie attività di compilazione e i relativi backend (javac, KAPT, KSP) verranno configurati per l'output dei file di schema in cartelle con flavor, ad esempio schemas/flavorOneDebug/com.package.MyDatabase/1.json. Questi file devono essere archiviati nel repository per essere utilizzati per la convalida e le migrazioni automatiche.
Alcune opzioni non possono essere configurate in tutte le versioni del plug-in Room Gradle, anche se sono supportate dal compilatore Room. La tabella seguente elenca ogni opzione e mostra la versione del plug-in Gradle Room che ha aggiunto il supporto per la configurazione di questa opzione utilizzando l'estensione room. Se la tua versione è precedente o se l'opzione non è ancora supportata, puoi utilizzare le opzioni del processore di annotazioni.
| Opzione | Dalla versione |
|---|---|
room.schemaLocation (campo obbligatorio) |
2.6.0 |
room.incremental |
- |
room.generateKotlin |
- |
Utilizza le opzioni del processore di annotazioni
Se non utilizzi il plug-in Room Gradle o se l'opzione che ti interessa non è supportata dalla tua versione del plug-in, puoi configurare Room utilizzando le opzioni del processore di annotazioni, come descritto in Aggiungi dipendenze di build. Il modo in cui specifichi le opzioni di annotazione dipende dall'utilizzo di KSP o KAPT per Room.
Alla moda
// 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... ) } } } }
Poiché room.schemaLocation è una directory e non un tipo primitivo, è necessario utilizzare un CommandLineArgumentsProvider quando si aggiunge questa opzione, in modo che Gradle conosca questa directory durante i controlli di aggiornamento.
Esegui la migrazione del database Room
mostra un'implementazione completa di CommandLineArgumentsProvider che fornisce
la posizione dello schema.
Feedback
Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.
Per saperne di più, consulta la documentazione di Issue Tracker.
Versione 2.8
Versione 2.8.5
9 settembre 2026
androidx.room:room-*:2.8.5 è stato rilasciato. La versione 2.8.5 contiene questi commit.
Correzioni di bug
- Le query di sospensione di Room e le operazioni del tracker di annullamento della convalida ora generano un'eccezione
IllegalStateExceptionquando vengono chiamate dopo la chiusura del database. (Ic0166, b/543076356)
Versione 2.8.4
19 novembre 2025
androidx.room:room-*:2.8.4 è stato rilasciato. La versione 2.8.4 contiene questi commit.
Correzioni di bug
- È stata aggiunta una cache delle istruzioni preparate al pool di connessioni di Room quando si utilizza un
SQLiteDriverche non dispone internamente di un pool, ad esempioBundledSQLiteDriver. In questo modo, le prestazioni migliorano in caso di esecuzione ripetuta della stessa istruzione SQL. (5f43bc, b/319653917) - Risolto un problema per cui il messaggio di errore effettivo/previsto sulla convalida dello schema non conteneva informazioni. (8b23da, b/454531083)
- È stato risolto un problema relativo alla generazione di codice Kotlin di Room in cui mancavano le funzioni DAO
@Transactioncon variabili di tipo. (a8365d, b/251316420) - Migliora le prestazioni del wrapper
SupportSQLitedi Room evitando i salti di thread e mantenendo lo stesso comportamento di blocco delle APISupportSQLiteDatabase. (fc70e4)
Versione 2.8.3
22 ottobre 2025
androidx.room:room-*:2.8.3 è stato rilasciato. La versione 2.8.3 contiene questi commit.
Correzioni di bug
- Risolto un problema di prestazioni con il wrapper SQLite di Room che causava chiamate JNI eccessive e un peggioramento significativo delle prestazioni durante l'iterazione su un cursore.
Versione 2.8.2
8 ottobre 2025
androidx.room:room-*:2.8.2 è stato rilasciato. La versione 2.8.2 contiene questi commit.
Correzioni di bug
- È stato corretto un deadlock che poteva verificarsi quando si riapriva un database chiuso automaticamente da un'emissione di Flow (b/446643789).
Versione 2.8.1
24 settembre 2025
androidx.room:room-*:2.8.1 è stato rilasciato. La versione 2.8.1 contiene questi commit.
Correzioni di bug
- Risolto un arresto anomalo del processore che si verificava durante l'elaborazione di una funzione DAO con una funzione lambda di sospensione. (b/442220723).
- Risolto un problema di race condition che impediva a Flows di ricevere l'ultimo aggiornamento.
Versione 2.8.0
10 settembre 2025
androidx.room:room-*:2.8.0 è stato rilasciato. La versione 2.8.0 contiene questi commit.
Modifiche importanti dalla versione 2.7.0:
- È stato aggiunto un nuovo artefatto
androidx.room:room-sqlite-wrapperche contiene API per ottenere un wrapperSupportSQLiteDatabaseda unRoomDatabasecon unSQLiteDriverconfigurato. Per ottenere il wrapper, utilizza la nuova funzione di estensioneRoomDatabase.getSupportWrapper(). Si tratta di un artefatto di compatibilità per mantenere gli utilizzi diSupportSQLiteDatabase, solitamente ottenuti daroomDatabase.openHelper.writableDatabase, anche se il database Room è configurato con unSQLiteDriver. Questo wrapper è utile per la migrazione incrementale di codebase che vogliono adottare le API SQLiteDriver, ma hanno un utilizzo esteso delle API SupportSQLite e vogliono comunque sfruttareBundledSQLiteDriver. Per saperne di più, consulta la guida alla migrazione. - Aggiunto il supporto per i target KMP Watch OS e Tv OS.
- Aggiornamento del minSDK Android della libreria dall'API 21 all'API 23
Versione 2.8.0-rc02
27 agosto 2025
androidx.room:room-*:2.8.0-rc02 è stato rilasciato. La versione 2.8.0-rc02 contiene questi commit.
Modifiche alle API
- Aggiorna minSDK dall'API 21 all'API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)
- Aggiorna la versione minima del plug-in Android per Gradle (AGP) compatibile con il plug-in Room per Gradle dalla versione 8.1 alla 8.4. (Ia0d28)
Correzioni di bug
- Risolto un problema per cui veniva eseguita una migrazione distruttiva anche se era disponibile un percorso di migrazione per un database pre-pacchettizzato (b/432634197).
Versione 2.8.0-rc01
13 agosto 2025
androidx.room:room-*:2.8.0-rc01 è stato rilasciato. La versione 2.8.0-rc01 contiene questi commit.
Modifiche alle API
Correzioni di bug
- Risolto un problema di race condition per cui i flussi di Room non emettevano il risultato della query più recente in una situazione di scrittura/multi-query asincrona. (Ic9a3c)
Versione 2.8.0-beta01
1° agosto 2025
androidx.room:room-*:2.8.0-beta01 è stato rilasciato. La versione 2.8.0-beta01 contiene questi commit.
Correzioni di bug
- I nomi di tabelle e viste ora vengono sottoposti correttamente a escape durante le migrazioni distruttive. (9e55f8, b/427095319)
Versione 2.8.0-alpha01
16 luglio 2025
androidx.room:room-*:2.8.0-alpha01 è stato rilasciato. La versione 2.8.0-alpha01 contiene questi commit.
Nuove funzionalità
- È stato aggiunto un nuovo artefatto
androidx.room:room-sqlite-wrapperche contiene API per ottenere un wrapperSupportSQLiteDatabasediRoomDatabasecon unSQLiteDriverconfigurato. Per ottenere il wrapper, utilizza la nuova funzione di estensioneRoomDatabase.getSupportWrapper(). Si tratta di un artefatto di compatibilità per mantenere gli utilizzi diSupportSQLiteDatabase, solitamente ottenuti daRoomDatabase.openHelper.writableDatabase, anche se il database Room è configurato con unSQLiteDriver. Questo wrapper è utile per la migrazione incrementale di codebase che vogliono adottareSQLiteDriver, ma hanno un utilizzo esteso delle APISupportSQLitee vogliono comunque sfruttareBundledSQLiteDriver. (Icf6ac) - Aggiungi target KMP per Watch OS e TV OS (I228f6, b/394238801)
Correzioni di bug
- È stato corretto un deadlock che poteva verificarsi occasionalmente quando si utilizzavano transazioni di sospensione e
AndroidSQLiteDriver. (b/415006268)
Versione 2.7
Versione 2.7.2
18 giugno 2025
androidx.room:room-*:2.7.2 è stato rilasciato. La versione 2.7.2 contiene questi commit.
Correzioni di bug
- Risolto un problema per cui i valori delle annotazioni venivano letti in modo errato durante l'elaborazione delle origini native con KSP, a volte con la mancata esportazione dello schema. (b/416549580)
- È stato corretto un bug per cui i commenti iniziali in un SQL causavano l'esecuzione delle istruzioni come se fossero query non di lettura. (b/413061402)
- Risolto un problema per cui la configurazione del plug-in Gradle di Room non andava a buon fine perché la directory dello schema era vuota. (b/417823384)
- Non generano più un errore
SQLiteExceptionquando l'ottenimento di una connessione richiede troppo tempo. Al suo posto, la libreria invierà un messaggio di log. La registrazione anziché l'attivazione funziona con i looper di sospensione di iOS, che fanno sì che Room interpreti erroneamente il timeout che si verifica nella coroutine Kotlin che acquisisce la connessione, impedendo così l'attivazione dell'eccezione quando un'app per iOS viene messa in background e successivamente ripresa nel mezzo di un'operazione del database. (b/422448815)
Versione 2.7.1
23 aprile 2025
androidx.room:room-*:2.7.1 è stato rilasciato. La versione 2.7.1 contiene questi commit.
Correzioni di bug
- Correzione del bug
IndexOutOfBoundsExceptiondurante la convalida del convertitore di tipi fornito. (b/409804755). - Supporto di
RoomDatabase.runInTransaction()quando unSQLiteDriverè configurato con Room. (b/408364828).
Versione 2.7.0
9 aprile 2025
androidx.room:room-*:2.7.0 è stato rilasciato. La versione 2.7.0 contiene questi commit.
Modifiche importanti dalla versione 2.6.0
- Supporto di Kotlin Multiplatform (KMP): in questa release, Room è stata rifattorizzata per diventare una libreria Kotlin Multiplatform (KMP). Le piattaforme attualmente supportate sono Android, iOS, JVM (desktop), Mac nativo e Linux nativo. Per saperne di più su come iniziare a utilizzare Room KMP, consulta la documentazione ufficiale di Room KMP. Nell'ambito del supporto di KMP, Room può anche essere configurato con un
SQLiteDriver. Per informazioni su come eseguire la migrazione di un'app esistente alle API del driver e a Room KMP, consulta la documentazione sulla migrazione. - La generazione di codice Kotlin su KSP è stata attivata per impostazione predefinita se l'elaborazione viene eseguita tramite KSP. Per i progetti solo KAPT o Java, Room continuerà a generare origini Java.
- Kotlin 2.0 e KSP2: Room ora ha come target il linguaggio Kotlin 2.0 e richiede che i progetti vengano compilati anche con Kotlin 2.0 e una versione del linguaggio equivalente o successiva. È stato aggiunto anche il supporto di KSP2, che è consigliato quando si utilizza Room con Kotlin 2.0 o versioni successive.
Versione 2.7.0-rc03
26 marzo 2025
androidx.room:room-*:2.7.0-rc03 è stato rilasciato. La versione 2.7.0-rc03 contiene questi commit.
Correzioni di bug
- Non viene più generato
InterruptedExceptionquando un thread viene interrotto durante l'esecuzione delle API di blocco di Room, incluse le funzioni DAO di blocco (b/400584611). - Implementa nuovamente il pool di connessioni di Room nel tentativo di alleviare
SQLException: Error code: 5, message: Timed out attempting to acquire a reader connection.e problemi simili (b/380088809).
Versione 2.7.0-rc02
12 marzo 2025
androidx.room:room-*:2.7.0-rc02 è stato rilasciato. La versione 2.7.0-rc02 contiene questi commit.
Correzioni di bug
- Risolto il problema relativo alla gestione errata di una nuova colonna in una tabella FTS da parte delle migrazioni automatiche. (b/348227770, Ic53f3)
- Risolto un arresto anomalo del compilatore di stanze dovuto a un
NullPointerExceptiondurante l'elaborazione di origini non JVM tramite KSP. (b/396607230, I693c9) - Risolto un problema per cui Room non invalidava le tabelle al termine dell'utilizzo della connessione di scrittura. (b/340606803, I73ef6)
Versione 2.7.0-rc01
26 febbraio 2025
androidx.room:room-*:2.7.0-rc01 è stato rilasciato. La versione 2.7.0-rc01 contiene questi commit.
Correzioni di bug
- Risolto un problema per cui Room non impostava
busy_timeoutnella connessione iniziale al database, il che causava problemi diSQLException: Error code: 5, message: database is locked(I93208, b/380088809). - Risolto un problema nel compilatore di Room che causava l'arresto anomalo del processore KSP durante l'elaborazione di set di risorse nativi (come iOS) su Kotlin 2.1.x e KSP1 (I883b8, b/396607230).
Versione 2.7.0-beta01
12 febbraio 2025
androidx.room:room-*:2.7.0-beta01 è stato rilasciato. La versione 2.7.0-beta01 contiene questi commit.
Correzioni di bug
- Risolto un problema per cui
RoomDatabase.inTransaction()apriva un database chiuso quando non avrebbe dovuto e restituiva rapidamente false se il database era chiuso (b/325432967). - È stato corretto un arresto anomalo (
IllegalArgumentException: not a valid name) nel compilatore di Room durante l'elaborazione delle funzioni DAO con classi inline/valore Kotlin (b/388299754). - Includi le regole di Proguard nell'artefatto JVM di
room-runtimein modo che il costruttore predefinito dell'implementazione del database generata non venga rimosso, poiché viene utilizzato dall'inizializzazione predefinita di Room che utilizza la riflessione (b/392657750).
Versione 2.7.0-alpha13
29 gennaio 2025
androidx.room:room-*:2.7.0-alpha13 è stato rilasciato. La versione 2.7.0-alpha13 contiene questi commit.
Modifiche alle API
- Room ora ha come target il linguaggio Kotlin 2.0 e richiederà che i progetti vengano compilati anche con Kotlin 2.0 e una versione del linguaggio equivalente o superiore. (I8efb0, b/315461431, b/384600605)
Correzioni di bug
- È stato risolto un problema nel generatore di database Room KMP quando in Android veniva utilizzato un nome semplice anziché un percorso e il percorso risolto del file del database non si trovava nella directory dei dati dell'app. (I83315, b/377830104)
- Risolto un problema relativo al plug-in Room Gradle per cui la configurazione degli input e dell'output dello schema causava un problema nei progetti Android:
property 'inputDirectory' is final and cannot be changed any further.(1dbb4c, b/376071291) - Aggiunto il supporto di KSP2 nel plug-in Room Gradle, risolvendo un problema per cui la directory dello schema non veniva configurata correttamente dal plug-in. (Iec3c4, b/379159770)
Contributo esterno
- Risolto un problema relativo all'integrazione della paginazione di
Roomche causava salti della UI quando la chiave iniziale da aggiornare era troppo vicina alla fine dell'elenco. Grazie a Eva! (I2abbe, b/389729367)
Versione 2.7.0-alpha12
11 dicembre 2024
androidx.room:room-*:2.7.0-alpha12 è stato rilasciato. La versione 2.7.0-alpha12 contiene questi commit.
Modifiche alle API
- Aggiunta l'API sperimentale
RoomDatabase.Builder.setInMemoryTrackingMode()per configurare se Room utilizzerà o meno una tabella in memoria per il monitoraggio dell'annullamento della convalida. (I2a9b2, b/185414040)
Correzioni di bug
- Le migrazioni distruttive ora eliminano le visualizzazioni per garantire che vengano ricreate, allineando il comportamento quando
allowDestructiveMigrationForAllTablesè ON (impostazione predefinita di KMP) con il comportamento esistente quando è OFF. (0a3e83, b/381518941)
Versione 2.7.0-alpha11
30 ottobre 2024
androidx.room:room-*:2.7.0-alpha11 è stato rilasciato. La versione 2.7.0-alpha11 contiene questi commit.
Modifiche alle API
- Rivedi la firma del metodo
convertRows()appena aggiunto in modo che sia una funzione di sospensione che riceve unRawRoomQueryper l'impaginazione della stanza. (Ie57b5, b/369136627)
Correzioni di bug
- Risolto il problema relativo alla paginazione delle stanze per cui veniva generato un codice non valido quando si utilizzava
@Relationinsieme aPagingSource.
Versione 2.7.0-alpha10
16 ottobre 2024
androidx.room:room-*:2.7.0-alpha10 è stato rilasciato. La versione 2.7.0-alpha10 contiene questi commit.
Modifiche alle API
- Crea una classe
ByteArrayWrapperinterna per supportare le relazioni conByteBufferin piattaforme non Android e non JVM. (I75543, b/367205685) - Aggiungi
SQLiteStatement.getColumnType()insieme alle varie costanti dei risultatiSQLITE_DATA_*per consentire il recupero del tipo di dati di una colonna. (I1985c, b/369636251)
Versione 2.7.0-alpha09
2 ottobre 2024
androidx.room:room-*:2.7.0-alpha09 è stato rilasciato. La versione 2.7.0-alpha09 contiene questi commit.
Correzioni di bug
- Risolto un problema relativo all'implementazione KMP di
room-pagingche causava unError code: 8, message: attempt to write a readonly databasea causa dell'avvio di una transazione di scrittura su una connessione di lettura. (b/368380988)
Versione 2.7.0-alpha08
18 settembre 2024
androidx.room:room-*:2.7.0-alpha08 è stato rilasciato. La versione 2.7.0-alpha08 contiene questi commit.
Nuove funzionalità
- È stata eseguita la migrazione degli artefatti
room-pagingper renderli compatibili con KMP. (Ib8756, b/339934824) - L'API
invalidationTrackerFlow()è stata resa comune come API proprietaria comeInvalidationTracker.createFlow()ed è ora disponibile per i set di risorse non Android nei progetti KMP. (I1fbfa, (I8fb29), b/329291639, b/329315924)
Modifiche alle API
- Tutti gli avvisi e i messaggi di errore in Room che utilizzano la parola
Cursorsono stati rimossi o sostituiti, poichéCursornon è più un termine generale accurato da utilizzare nella versione KMP di Room. (Id8cd9, b/334087492)
Correzioni di bug
- È stato risolto un problema per cui Room KMP tentava di emettere codice utilizzando
UUIDper piattaforme non JVM. (b/362994709) - È stato risolto un problema relativo al plug-in Room Gradle che causava un errore come "Impossibile modificare gli attributi della configurazione… dopo che è stata bloccata per la mutazione" se utilizzato in un progetto KMP con Compose Multiplatform. (b/343408758)
Versione 2.7.0-alpha07
21 agosto 2024
androidx.room:room-*:2.7.0-alpha07 è stato rilasciato. La versione 2.7.0-alpha07 contiene questi commit.
Nuove funzionalità
- Il plug-in Room Gradle ora aggiungerà automaticamente gli schemi esportati alle origini delle risorse del test di instrumentazione Android, in modo che possano essere utilizzati da
MigrationTestHelper.
Correzioni di bug
- È stato risolto un problema relativo all'elemento "actual" generato di
RoomDatabaseConstructorin cui mancava il modificatore "actual" nella funzioneinitializese questa funzione veniva sottoposta a override anche nella dichiarazione "expect". (359631627) - Risolto un problema per cui l'elemento "actual" generato di
RoomDatabaseConstructornon corrispondeva alla visibilità della dichiarazione "expect". (358138953)
Versione 2.7.0-alpha06
7 agosto 2024
androidx.room:room-*:2.7.0-alpha06 è stato rilasciato. La versione 2.7.0-alpha06 contiene questi commit.
Modifiche alle API
- Modifica la configurazione di istanziazione per un
RoomDatabasein un progetto KMP.
A causa del modello di compilazione di Kotlin 2.0, la strategia di fare riferimento a una funzione da generare, denominata instantiateImpl(), non è più valida. Vengono introdotte due nuove API, @ConstructedBy e RoomDatabaseConstructor, che sostituiscono la strategia instantiateImpl(). La nuova strategia è la seguente:
Definisci un oggetto expect che implementa
RoomDatabaseConstructorexpect object MyDatabaseCtor : RoomDatabaseConstructor<MyDatabase>Collega l'oggetto alla dichiarazione
@Databaseutilizzando@ConstructedBy@Database(...) @ConstructedBy(MyDatabaseCtor::class) // NEW abstract class MyDatabase : RoomDatabaseCrea una nuova istanza di database, ma senza passare un argomento factory
fun createNewDatabase(path: String) = Room.databaseBuilder<AppDatabase>(name = path) .setDriver(BundledSQLiteDriver()) .setQueryCoroutineContext(Dispatchers.IO) .build()
Correzioni di b/316978491, b/338446862 e b/342905180
- Supporto di
@RawQueryin Room KMP tramite l'aggiunta di una nuova API denominataRoomRawQuery, simile aSupportSQLiteQueryin termini di conservazione della stringa SQL non elaborata e di una funzione per associare gli argomenti a un'istruzione. Le funzioni annotate@RawQueryora possono accettare unRoomRawQuerycome unico parametro. (Iea844, b/330586815) - Aggiungi un overload di
setQueryCallback()che accetta unCoroutineContext. (Id66ff, b/309996304) - È stato aggiunto il supporto delle destinazioni Kotlin Multiplatform
linuxArm64(I139d3, b/338268719)
Correzioni di bug
- Risolto un problema per cui Room generava erroneamente una chiamata a
recursiveFetchArrayMapin target non Android. (710c36, b/352482325) - È stato risolto un problema per cui a volte Room generava un'eccezione relativa al timeout del tentativo di connessione in un progetto KMP. (fa72d0, b/347737870)
- Risolto un problema relativo alle migrazioni automatiche che controllava le chiavi esterne troppo presto, prima che altre tabelle modificassero i propri schemi per conformarsi alle nuove chiavi esterne. (7672c0, b/352085724)
Versione 2.7.0-alpha05
10 luglio 2024
androidx.room:room-*:2.7.0-alpha05 è stato rilasciato. La versione 2.7.0-alpha05 contiene questi commit.
Modifiche alle API
SQLiteKtrinominato inSQLiteeBundledSQLiteKtinBundledSQLite. (I8b501)
Correzioni di bug
- Risolto un bug per cui un
RoomDatabasesi bloccava o generava un errore di timeout della connessione quando utilizzavaAndroidSQLiteDriver.
Versione 2.7.0-alpha04
12 giugno 2024
androidx.room:room-*:2.7.0-alpha04 è stato rilasciato. La versione 2.7.0-alpha04 contiene questi commit.
Correzioni di bug
- Risolto un problema per cui il processore di annotazioni di Room generava codice KMP incompatibile quando un tipo restituito multi-mappa veniva definito in un DAO. (b/340983093)
- Risolto un problema per cui Room non riusciva a trovare l'implementazione del database generata se la classe annotata
@Databasenon aveva un pacchetto. (b/342097292) - È stato risolto un problema per cui l'attivazione della chiusura automatica e dell'annullamento della convalida multi-istanza a volte causava un
ConcurrentModificationExceptionquando il database veniva chiuso automaticamente perché inattivo.
Versione 2.7.0-alpha03
29 maggio 2024
androidx.room:room-*:2.7.0-alpha03 è stato rilasciato. La versione 2.7.0-alpha03 contiene questi commit.
Correzioni di bug
- Sono stati risolti vari problemi relativi a Kotlin 2.0 e KSP 2.0. Tieni presente che il supporto di Kotlin 2.0 con KSP 2 non è completo e il team sta lavorando alle varie API e alle modifiche del comportamento nel nuovo compilatore. (b/314151707)
Versione 2.7.0-alpha02
14 maggio 2024
androidx.room:room-*:2.7.0-alpha02 è stato rilasciato. La versione 2.7.0-alpha02 contiene questi commit.
Correzioni di bug
- Risolti vari problemi relativi a KSP.
Versione 2.7.0-alpha01
1° maggio 2024
androidx.room:room-*:2.7.0-alpha01 è stato rilasciato. La versione 2.7.0-alpha01 contiene questi commit.
Nuove funzionalità
- Supporto di Kotlin Multiplatform (KMP): in questa release, Room è stato rifattorizzato per diventare una libreria Kotlin Multiplatform (KMP). Sebbene ci sia ancora del lavoro da fare, questa release introduce una nuova versione di Room in cui la maggior parte delle funzionalità è stata "comunizzata" (resa multipiattaforma). Le piattaforme attualmente supportate sono Android, iOS, JVM (desktop), Mac nativo e Linux nativo. Tutte le funzionalità mancanti nelle piattaforme appena supportate verranno rese "complete" nelle prossime release di Room.
Per saperne di più su come iniziare a utilizzare Room KMP, consulta la documentazione ufficiale di Room KMP.
- La generazione di codice Kotlin su KSP è stata attivata per impostazione predefinita se l'elaborazione viene eseguita tramite KSP. Per i progetti solo KAPT o Java, Room continuerà a generare origini Java.
Modifiche alle API
- È stato aggiunto un overload di
Room.databaseBuilder()che accetta un parametro lambda destinato a essere utilizzato con una funzione generata da Room per evitare di utilizzare la riflessione durante la creazione di un'istanza dell'implementazioneRoomDatabasegenerata. Esempio di utilizzo:
Room.databaseBuilder<MyDatabase>(
context = appContext,
name = dbFilePath,
factory = { MyDatabase::class.instantiateImpl() }
)
- È stata aggiunta un'API per configurare una stanza con un
CoroutineContextal builder:RoomDatabase.Builder.setQueryCoroutineContext. Tieni presente che unRoomDatabasepuò essere configurato solo con esecutori che utilizzanosetQueryExecutoro con un contesto di coroutine, ma non con entrambi. - È stata aggiunta un'API per configurare Room con un driver
SQLite:RoomDatabase.Builder.setDriver(). Per saperne di più sull'API DriverSQLite, consulta la documentazione di SQLite KMP - Sono state aggiunte API per accedere al
SQLiteConnectionsottostante dalle API del driver:RoomDatabase.useReaderConnectioneRoomDatabase.useWriterConnection. - Diversi callback relativi a Room ora hanno una versione sovraccaricata che riceve
SQLiteConnectionanzichéSupportSQLiteDatabase. Questi valori devono essere sostituiti durante la migrazione a un progetto KMP. Per saperne di più sulla migrazione degli utilizzi di Room in un'app per Android a un modulo KMP comune, consulta la guida alla migrazione. I callback sono:Migration.migrate(SQLiteConnection)AutoMigrationSpec.onPostMigrate(SQLiteConnection)RoomDatabase.Callback.onCreate(SQLiteConnection)RoomDatabase.Callback.onDestructiveMigration(SQLiteConnection)RoomDatabase.Callback.onOpen(SQLiteConnection)
- L'artefatto KTX
androidx.room:room-ktxè stato unito aandroidx.room:room-runtimeinsieme a tutte le sue API. L'artefatto è ora vuoto. Rimuovila dall'elenco delle dipendenze.
Versione 2.6
Versione 2.6.1
29 novembre 2023
androidx.room:room-*:2.6.1 è stato rilasciato. La versione 2.6.1 contiene questi commit.
Correzioni di bug
- Risolto il problema nel codice generato per cui il valore predefinito per le colonne Double in
EntityCursorConverterveniva impostato su 0 anziché su 0.0. È stata inclusa anche una potenziale correzione per un caso limite simile per le colonne tipizzate di tipo Float. (Id75f5, b/304584179) - Le eccezioni generate dai caricamenti di
PagingSourceverranno ora propagate comeLoadStateUpdatediLoadResult.Errorcontenente l'oggetto Throwable. Questo stato di errore è osservabile tramitePagingDataAdapter.loadStateFlow(Views)oLazyPagingItems.loadState(Compose). Tieni presente che questo segna un cambiamento di comportamento, in quanto in passato gli errori di caricamento venivano visualizzati come un'eccezione generata dal metodo dao che ha attivato il caricamento. (I93887, b/302708983)
Versione 2.6.0
18 ottobre 2023
androidx.room:room-*:2.6.0 è stato rilasciato. La versione 2.6.0 contiene questi commit.
Modifiche importanti dalla versione 2.5.0
- L'opzione per attivare la generazione di codice Kotlin (o "Kotlin CodeGen") è ora disponibile in Room KSP. (4297ec0). Per attivare Kotlin CodeGen in Room, aggiungi il nome dell'opzione
room.generateKotlinalle opzioni del processore per KSP. Per maggiori dettagli su come passare le opzioni del processore per KSP, consulta la documentazione di KSP.
Nota: quando utilizzi Kotlin CodeGen, è importante tenere presente che sono state aggiunte ulteriori limitazioni. Le proprietà astratte come getter DAO o query DAO in Kotlin CodeGen non sono consentite e devono essere riscritte come funzioni per evitare l'idea errata che il valore della proprietà sia immutabile e abbia un risultato memorizzato fisso. Un'altra limitazione aggiunta è che i tipi restituiti di raccolte nullable non sono più consentiti in Room per Kotlin CodeGen.
Attenzione: potresti notare che i tuoi progetti sono più rigidi in termini di supporto di valori null quando utilizzi Kotlin CodeGen. In Kotlin CodeGen, la possibilità di valori null degli argomenti di tipo è importante, mentre in Java viene per lo più ignorata. Ad esempio, supponiamo che tu abbia un tipo restituito "Flow<foo\>" e che la tabella sia vuota. In Java CodeGen, questo non causerà problemi, ma in Kotlin CodeGen verrà visualizzato un errore. Per evitare questo problema, dovrai utilizzare "Flow<foo?\>", supponendo che venga emesso un valore null. </foo?\></foo\>
- Il nuovo artefatto per il plug-in Gradle di Room è stato aggiunto a Room con l'ID
androidx.room, che risolve vari problemi esistenti in Room relativi alla presenza di input e output di schemi tramite le opzioni del processore di annotazioni Gradle. Per maggiori dettagli, consulta le note di rilascio di Room versione 2.6.0-alpha02. - Le classi di valori nelle entità Room sono ora supportate per KSP. (4194095)
- I tipi restituiti Map nidificati nelle funzioni DAO sono ora supportati in Room. (I13f48, 203008711)
Versione 2.6.0-rc01
20 settembre 2023
androidx.room:room-*:2.6.0-rc01 è stato rilasciato. La versione 2.6.0-rc01 contiene questi commit.
Versione 2.6.0-beta01
23 agosto 2023
androidx.room:room-*:2.6.0-beta01 è stato rilasciato. La versione 2.6.0-beta01 contiene questi commit.
Correzioni di bug
- Gestione dell'eccezione
SQLitedel caso speciale durante l'upsert rilevata quando viene generata l'eccezione2067 SQLITE_CONSTRAINT_UNIQUEdurante un upsert, l'upsert deve eseguire un aggiornamento. (If2849, b/243039555)
Versione 2.6.0-alpha03
9 agosto 2023
androidx.room:room-*:2.6.0-alpha03 è stato rilasciato. La versione 2.6.0-alpha03 contiene questi commit.
Nuove funzionalità
- I tipi restituiti Map nidificati nelle funzioni DAO sono ora supportati in Room. (I13f48, 203008711)
Modifiche alle API
- È stata creata una nuova annotazione di tipo denominata
@MapColumnper sostituire@MapInfo, che ora è deprecata. Per ogni nome di colonna (keyColumnName,valueColumnNameo entrambi) fornito in un'annotazione@MapInfo, dovrai dichiarare un'annotazione@MapColumncon solocolumnNamee utilizzare l'annotazione sull'argomento del tipo specifico a cui viene fatto riferimento (la chiave o il valore della mappa) nel tipo restituito della funzione DAO. Questo perché l'annotazione@MapColumnviene utilizzata direttamente sull'argomento del tipo all'interno del tipo restituito di una funzione DAO, anziché sulla funzione stessa come@MapInfo. Per saperne di più, consulta la documentazione di@MapColumn. (Ib0305, b/203008711) - Sono stati aggiornati i file API per annotare la soppressione della compatibilità (I8e87a, b/287516207)
- Le API del plug-in Gradle Room sono state aggiornate in modo da non richiedere sempre configurazioni per variante. Ciò significa che il plug-in può accettare una posizione globale per tutte le varianti senza creare più directory, consentendo migrazioni più fluide, ma è anche abbastanza flessibile da configurare manualmente gli schemi dei flavor o dei tipi di build, mantenendo comunque i vantaggi del plug-in (build riproducibili e memorizzabili nella cache). (I09d6f, b/278266663)
Correzioni di bug
- Risolta una potenziale vulnerabilità di perdita di memoria in
QueryInterceptorStatement. (I193d1) - È stato corretto un comportamento errato nella funzione
QueryInterceptorDatabase execSQL(). (Iefdc8)
Versione 2.6.0-alpha02
21 giu 2023
androidx.room:room-*:2.6.0-alpha02 è stato rilasciato. La versione 2.6.0-alpha02 contiene questi commit.
Plug-in Gradle Room
Questa nuova release contiene un nuovo artefatto per il plug-in Gradle di Room con ID androidx.room, che risolve vari problemi esistenti in Room relativi alla presenza di input e output di schemi tramite le opzioni del processore di annotazioni Gradle. Il plug-in Gradle di Room configura il progetto in modo che gli schemi generati, utilizzati per le migrazioni automatiche e prodotti dalle attività di compilazione, siano configurati correttamente per avere build riproducibili e memorizzabili nella cache. Il plug-in offre un DSL per configurare la posizione dello schema di base:
room {
schemaDirectory("$projectDir/schemas/")
}
Il plug-in configurerà quindi il compilatore Room e le varie attività di compilazione e i relativi backend (javac, KAPT, KSP) per l'output dei file di schema in cartelle con flavor, ovvero schemas/flavorOneDebug/com.package.MyDatabase/1.json. Come di consueto, questi file vengono archiviati nel repository per essere utilizzati per la convalida e le migrazioni automatiche. Dopo aver eseguito la migrazione all'utilizzo del plug-in anziché delle opzioni del processore di annotazioni, i file di schema esistenti devono essere copiati nelle directory delle versioni generate create dal plug-in. Si tratta di un'operazione di migrazione una tantum che deve essere eseguita manualmente. La documentazione dello schema su developers.android.com verrà aggiornata in futuro una volta che i feedback saranno stati presi in considerazione e il plug-in avrà raggiunto la versione stabile, quindi provalo.
Modifiche alle API
RoomDatabase.QueryCallbackè stata definita come un'interfaccia funzionale per consentire l'utilizzo della conversione SAM. (Iab8ea, b/281008549)
Correzioni di bug
- Risoluzione del problema che si verifica durante la creazione di un'istanza del database in Robolectric dopo la migrazione delle origini Room da Java a Kotlin. (Ic053c, b/274924903)
Versione 2.6.0-alpha01
22 marzo 2023
androidx.room:room-*:2.6.0-alpha01 è stato rilasciato. La versione 2.6.0-alpha01 contiene questi commit.
Nuove funzionalità
- Supporto delle classi di valore in Room per KSP. Room è ora in grado di supportare le classi di valori nelle entità. (4194095)
- La generazione di codice Kotlin (o "Kotlin CodeGen") ora può essere attivata in Room (4297ec0). Per attivare Kotlin CodeGen in Room, aggiungi il nome dell'opzione
room.generateKotlinalle opzioni del processore per KSP. Per maggiori dettagli su come passare le opzioni del processore per KSP, consulta la documentazione di KSP.
Nota: quando utilizzi Kotlin CodeGen, è importante tenere presente che sono state aggiunte ulteriori limitazioni. Le proprietà astratte come getter DAO o query DAO in Kotlin CodeGen non sono consentite e devono essere riscritte come funzioni per evitare l'idea errata che il valore della proprietà sia immutabile e abbia un risultato memorizzato fisso. Un'altra limitazione aggiunta è che i tipi restituiti di raccolte nullable non sono più consentiti in Room per Kotlin CodeGen.
Attenzione: potresti notare che i tuoi progetti sono più rigidi in termini di supporto di valori null quando utilizzi Kotlin CodeGen. In Kotlin CodeGen, la possibilità di valori null degli argomenti di tipo è importante, mentre in Java viene per lo più ignorata. Ad esempio, supponiamo che tu abbia un tipo restituito "Flow<foo\>" e che la tabella sia vuota. In Java CodeGen, questo non causerà problemi, ma in Kotlin CodeGen verrà visualizzato un errore. Per evitare questo problema, dovrai utilizzare "Flow<foo?\>", supponendo che venga emesso un valore null. </foo?\></foo\>
Modifiche alle API
- Protezione dall'utilizzo non significativo di raccolte che ammettono valori null nei tipi restituiti dei metodi DAO. (I777dc, b/253271782, b/259426907)
- Aggiunta un'API per la creazione di un flusso che genera modifiche al tracker di invalidazione. L'API è utile per creare stream che devono reagire alle modifiche del database. (I8c790, b/252899305)
Correzioni di bug
- Non consentire le proprietà astratte come getter DAO o query DAO in Kotlin codegen, ma riscriverle come funzioni per evitare l'idea errata che il valore della proprietà sia immutabile e abbia un risultato archiviato fisso. (If6a13, b/127483380, b/257967987)
Versione 2.5.2
Versione 2.5.2
21 giu 2023
androidx.room:room-*:2.5.2 è stato rilasciato. La versione 2.5.2 contiene questi commit.
Correzioni di bug
- Risolto un problema di incompatibilità con kotlinx-metadata-jvm. (386d5c)
- Risolvi un problema che causa la generazione di un errore da parte di Room quando viene utilizzato in un test Robolectric. (f79bea, b/274924903)
Versione 2.5.1
Versione 2.5.1
22 marzo 2023
androidx.room:room-*:2.5.1 è stato rilasciato. La versione 2.5.1 contiene questi commit.
Correzioni di bug
- Evita di controllare la directory principale del database in
FrameworkSQLiteHelperse il database è già aperto. (5de86b8) - Utilizza un controllo
isOpenInternalper verificare se il database è già aperto. (e91fb35) - Ora è disponibile una migliore gestione del caso rientrante in
acquireTransactionThread()diRoom. (219f98b). Durante una transazione di sospensione, Room utilizza un thread dell'esecutore della transazione, avvia un loop di eventi al suo interno e gli invia le operazioni di sospensione del database in modo che siano tutte incapsulate nella coroutine della transazione. In genere, si prevede che il thread della transazione sia diverso da quello che avvia la transazione, ma in alcuni casi sono uguali. Per gestire questi casi di rientro,withTransaction()è stato rifattorizzato in modo da non fare più affidamento su un job di controllo, ma eseguire il blocco della transazione di sospensione dall'interno dirunBlockingnel thread della transazione.
Versione 2.5.0
Versione 2.5.0
22 febbraio 2023
androidx.room:room-paging-guava:2.5.0, androidx.room:room-paging-rxjava2:2.5.0 e androidx.room:room-paging-rxjava3:2.5.0 sono stati rilasciati. La versione 2.5.0 contiene questi commit.
Versione 2.5.0
11 gennaio 2023
androidx.room:room-*:2.5.0 è stato rilasciato. La versione 2.5.0 contiene questi commit.
Modifiche importanti dalla versione 2.4.0
- Tutte le fonti di
room-runtimesono state convertite da Java a Kotlin. Tieni presente che potresti riscontrare problemi di incompatibilità dell'origine se il tuo codice è in Kotlin a causa della conversione della libreria in Kotlin. Ad esempio, una modifica incompatibile con l'origine nota è che inInvalidationTrackerora dovrai dichiarareonInvalidate()inObserverper avere un parametro di tipoSete nonMutableSet. Inoltre, alcuni metodi getter sono stati convertiti in proprietà che richiedono la sintassi di accesso alle proprietà nei file Kotlin. Segnala un bug se sono presenti incompatibilità significative. - È stata aggiunta una nuova annotazione di scorciatoia,
@Upsert, che tenta di inserire un'entità quando non esiste un conflitto di unicità o di aggiornare l'entità se esiste un conflitto. (I7aaab, b/241964353) - Sono stati aggiunti i nuovi artefatti di Room Paging
room-paging-rxjava2,room-paging-rxjava3eroom-paging-guavaper il supporto in Room Paging. - Sono state aggiunte API per fornire i nomi delle tabelle di chiavi e valori per la disambiguazione in
@MapInfo(Icc4b5)
Versione 2.5.0-rc01
7 dicembre 2022
androidx.room:room-*:2.5.0-rc01 è stato rilasciato. La versione 2.5.0-rc01 contiene questi commit.
- Questa release è identica a
2.5.0-beta02.
Versione 2.5.0-beta02
9 novembre 2022
androidx.room:room-*:2.5.0-beta02 è stato rilasciato. La versione 2.5.0-beta02 contiene questi commit.
Modifiche alle API
- Correzione di varie API che accettano argomenti di query da invarianti (
Array<Any?>) a controvarianti (Array<out Any?>) per corrispondere al comportamento degli array di Java. (b/253531073)
Versione 2.5.0-beta01
5 ottobre 2022
androidx.room:room-*:2.5.0-beta01 è stato rilasciato. La versione 2.5.0-beta01 contiene questi commit.
Modifiche alle API
- Limita la versione minima che supporta
@Upsertall'API 16. Ciò è dovuto all'impossibilità di identificare un conflitto di vincoli della chiave primaria nelle API meno recenti. (I5f67f, b/243039555)
Correzioni di bug
- Risolto un problema per cui le tabelle shadow venivano esportate in modo errato nei file dello schema
.json, danneggiandoli. (I4f83b, b/246751839)
Versione 2.5.0-alpha03
24 agosto 2022
androidx.room:room-*:2.5.0-alpha03 è stato rilasciato. La versione 2.5.0-alpha03 contiene questi commit.
Nuove funzionalità
- È stata aggiunta una nuova annotazione di scorciatoia,
@Upsert, che tenta di inserire un'entità quando non esiste un conflitto di unicità o di aggiornare l'entità se esiste un conflitto. (I7aaab, b/241964353)
Correzioni di bug
- Room ora genera un'eccezione
SQLiteConstraintExceptionanzichéIllegalStateExceptiondurante un controllo del vincolo di chiave esterna della migrazione automatica. (I328dd) - È stata corretta una modifica incompatibile con l'origine Kotlin per i getter/le proprietà di
getOpenHelper,getQueryExecutoregetTransactionExecutor. (Iad0ac)
Versione 2.5.0-alpha02
1° giugno 2022
androidx.room:room-*:2.5.0-alpha02 è stato rilasciato. La versione 2.5.0-alpha02 contiene questi commit.
Nuove funzionalità
- Sono stati aggiunti i nuovi artefatti
room-pagingroom-paging-rxjava2,room-paging-rxjava3eroom-paging-guavaper il supporto della paginazione di Room.(41a1d4,b/203666906),(eb6098,b/203666906),(1b9ae4,b/203666906)
Modifiche alle API
- Tutto il codice di
room-runtimeè stato convertito da Java a Kotlin. (If2069, b/206859668),(Ie4b55, b/206859668), (I697ee, b/206859668), (I96c25, b/206859668)Nota: potresti riscontrare problemi di incompatibilità dell'origine a causa della conversione della libreria in Kotlin. Se il codice era in Kotlin e chiamava la versione precedente di Room, la nuova versione dovrà gestire questi casi. Ad esempio, una modifica incompatibile con l'origine nota è che in
InvalidationTrackerora dovrai dichiarareonInvalidate()inObserverper avere un parametro di tipoSete nonMutableSet. - Sono state aggiunte API per fornire i nomi delle tabelle di chiavi e valori per la disambiguazione in
@MapInfo(Icc4b5) - Risolto un problema di compatibilità dei sorgenti per consentire nuovamente
@Ignorenei getter delle proprietà. (Ifc2fb)
Correzioni di bug
- Algoritmo euristico di risoluzione delle colonne duplicate. Room ora tenterà di risolvere le colonne ambigue in una query multimappa. In questo modo, le JOIN con tabelle contenenti tabelle con lo stesso nome vengono mappate correttamente a un oggetto dati dei risultati. (I4b444, b/201306012, b/212279118)
Versione 2.5.0-alpha01
23 febbraio 2022
androidx.room:room-*:2.5.0-alpha01 è stato rilasciato. La versione 2.5.0-alpha01 contiene questi commit.
Modifiche alle API
- È stato risolto un problema per cui l'utilizzo di Room
@IntDefnon veniva applicato nelle origini Kotlin. (I75f41, b/217951311) - Risolto un problema di compatibilità dell'origine per consentire nuovamente
@Querynei getter delle proprietà. (I0a09b) - È stata eseguita la conversione di room-common da Java a Kotlin. (I69c48, b/206858235)
Nota: potresti riscontrare problemi di incompatibilità con l'origine, poiché alcune proprietà sono state spostate in oggetti companion durante la conversione della libreria in Kotlin. Se il codice era in Kotlin e chiamava la versione precedente di Room, la nuova versione richiederà il suffisso ".Companion" per accedere a queste proprietà.
- Conversione della migrazione della stanza virtuale da Java a Kotlin. (I2724b, b/206858622)
- Conversione di
pagingfile correlati inroom-runtimeda Java a Kotlin. (I82fc8, b/206859668) - È stata aggiunta l'API per il blocco e l'utilizzo multiprocesso a livello di FrameworkSQLite* per proteggere la creazione e le migrazioni dei database per la prima volta in più processi. (Ied267, b/193182592)
Correzioni di bug
- È stato aggiunto il supporto per le proprietà interne nelle origini Kotlin.
Si tratta di una leggera modifica del comportamento in Room, che utilizzerà il nome
di origine delle funzioni durante l'abbinamento alle proprietà come getter/setter
(in precedenza, utilizzava il nome JVM della funzione, che è diverso
per le funzioni/proprietà interne).
Se utilizzi annotazioni
@JvmNamepersonalizzate per abbinare getter/setter alle proprietà private, verifica il codice generato dopo l'aggiornamento (If6531, b/205289020)
Versione 2.4.3
Versione 2.4.3
27 luglio 2022
androidx.room:room-*:2.4.3 è stato rilasciato. La versione 2.4.3 contiene questi commit.
Correzioni di bug
- Risolto un problema per cui Room non riconosceva le funzioni di sospensione in Kotlin 1.7 (b/236612358)
Versione 2.4.2
Versione 2.4.2
23 febbraio 2022
androidx.room:room-*:2.4.2 è stato rilasciato. La versione 2.4.2 contiene questi commit.
Correzioni di bug
- È stato risolto un problema relativo alla generazione del codice per una funzione di sospensione Dao
@Transactioncon un corpo che genera un metodo di interfaccia predefinito a causa della compilazione con-Xjvm-default=allo equivalente. (Ia4ce5) - Risoluzione di un bug per cui Room genera codice per un metodo di query con tipo restituito
Array<ByteArray>. (If086e, b/213789489)
Versione 2.4.1
Versione 2.4.1
12 gennaio 2022
androidx.room:room-*:2.4.1 è stato rilasciato. La versione 2.4.1 contiene questi commit.
Correzioni di bug
- È stato aggiunto il supporto per le proprietà interne nelle origini Kotlin.
Si tratta di una leggera modifica del comportamento in Room, che utilizzerà il nome
di origine delle funzioni durante l'abbinamento alle proprietà come getter/setter
(in precedenza, utilizzava il nome JVM della funzione, che è diverso
per le funzioni/proprietà interne).
Se utilizzi annotazioni
@JvmNamepersonalizzate per abbinare getter/setter alle proprietà private, verifica il codice generato dopo l'aggiornamento (If6531, b/205289020)
Versione 2.4.0
Versione 2.4.0
15 dicembre 2021
androidx.room:room-*:2.4.0 è stato rilasciato. La versione 2.4.0 contiene questi commit.
Modifiche importanti dalla versione 2.3.0
- Migrazioni automatiche: Room ora offre un'API per generare automaticamente le migrazioni, purché gli schemi vengano esportati. Per comunicare a Room che deve generare una migrazione automatica, è possibile utilizzare una nuova proprietà
@Database#autoMigrationsper dichiarare le versioni da e verso cui eseguire la migrazione automatica. Quando Room ha bisogno di ulteriori informazioni sulle ridenominazioni o sulle eliminazioni di tabelle e colonne, l'annotazione@AutoMigrationpuò dichiarare una classe di specifica contenente questi input. Per ulteriori dettagli, consulta la documentazione di@AutoMigration. - Dependency Injection nelle migrazioni automatiche:
@ProvidedAutoMigrationSpecè una nuova API per dichiarare che unAutoMigrationSpecverrà fornito in fase di runtime tramiteRoomDatabase.Builder#addAutoMigrationSpec(). In questo modo, un framework di dependency injection può fornire queste specifiche quando sono necessarie dipendenze complesse. - Supporto dell'assistente per i test di migrazione per le migrazioni automatiche:
MigrationTestHelperdi Room è stato aggiornato per supportare le migrazioni automatiche fornendo una nuova API del costruttore che riceve la classe del database in fase di test. In questo modo, l'assistente può aggiungere automaticamente le migrazioni automatiche nello stesso modo duranterunMigrationsAndValidate. - Supporto di Room-Paging: è stato rilasciato
androidx.room:room-paging, che fornisce il supporto nativo di Paging 3.0 per le query di Room che restituisconoandroidx.paging.PagingSource. - Metodi di query relazionali: Room ora supporta i metodi
@Daocon tipi restituiti multimap, utili per le istruzioni JOIN. I tipi di multimappe supportati sonoMap,SparseArray,LongSparseArray, oltre aImmutableMap,ImmutableSetMultimapeImmutableListMultimapdi Guava.
Versione 2.4.0-rc01
1° dicembre 2021
androidx.room:room-*:2.4.0-rc01 è stato rilasciato. La versione 2.4.0-rc01 contiene questi commit.
Nuove funzionalità
- Aggiorna la dipendenza di Room da KSP alla versione
1.6.0-1.0.1per supportare Kotlin 1.6
Versione 2.4.0-beta02
17 novembre 2021
androidx.room:room-*:2.4.0-beta02 è stato rilasciato. La versione 2.4.0-beta02 contiene questi commit.
Nuove funzionalità
- Abbiamo aggiunto il supporto per SparseArray e LongSparseArray in @MapInfo. (Ic91a2b/138910317)
Correzioni di bug
- Abbiamo aggiunto un nuovo analizzatore TypeConverter che tiene conto delle informazioni sul supporto di valori null nei tipi. Poiché queste informazioni sono disponibili solo in KSP, sono attivate per impostazione predefinita solo in KSP. Se causa problemi, puoi disattivarla passando room.useNullAwareTypeAnalysis=false al processore di annotazioni. In questo caso, segnala un bug, poiché questo flag verrà rimosso in futuro. Con questo nuovo analizzatore TypeConverter, è consigliabile fornire solo TypeConverter di ricezione non null, poiché il nuovo analizzatore è in grado di eseguirne il wrapping con un controllo null. Tieni presente che questo non ha alcun impatto sugli utenti che utilizzano KAPT o Java come processori di annotazioni (a differenza di KSP), non hanno informazioni sulla nullabilità nei tipi. (Ia88f9, b/193437407)
- È stato corretto un bug per cui la compilazione di Room non andava a buon fine con un errore SQL quando un'entità FTS dichiarava di utilizzare il tokenizzatore ICU. (I00db9, b/201753224)
- Risolto un problema relativo alle migrazioni automatiche riguardante una nuova colonna aggiunta a un'entità incorporata tra le versioni. (I5fcb1b/193798291)
- Abbiamo risolto un problema relativo ai tipi restituiti dal metodo di query relazionale nelle query LEFT JOIN. Con queste modifiche, nel caso in cui sia presente una mappatura 1-molti, la raccolta restituita per una chiave non includerà l'oggetto del valore non valido se non viene trovato nel cursore. Se non vengono trovati valori validi, una chiave verrà mappata a una raccolta vuota. (Id5552b/201946438)
- Risolto il problema di migrazione automatica per cui non veniva eseguito l'escape delle parole chiave SQLite nei nomi delle colonne. (Idbed4b/197133152)
Versione 2.4.0-beta01
13 ottobre 2021
androidx.room:room-*:2.4.0-beta01 è stato rilasciato. La versione 2.4.0-beta01 contiene questi commit.
Correzioni di bug
- È stato risolto un problema relativo alle migrazioni automatiche che non aggiungevano nuove colonne quando un'altra tabella nella stessa migrazione automatica aveva anche una nuova colonna con lo stesso nome. (Ia5db5, b/200818663)
- L'implementazione di PagingSource generata da room-paging ora utilizza
queryExecutorpassato tramiteRoomDatabase.Builder, quindi può essere sostituito, anzichéDispatchers.IOcome in precedenza. (Iae259)
Versione 2.4.0-alpha05
29 settembre 2021
androidx.room:room-*:2.4.0-alpha05 è stato rilasciato. La versione 2.4.0-alpha05 contiene questi commit.
Nuove funzionalità
- È stato aggiunto un convertitore di tipo integrato per UUID. (I671e8, b/73132006)
Modifiche alle API
È stata aggiunta una nuova proprietà all'annotazione TypeConverters per consentire agli sviluppatori di disattivare i convertitori Enum e UUID integrati. Per impostazione predefinita, questi convertitori sono attivi, ma puoi disattivarli per un determinato ambito o per l'intero database. Per maggiori dettagli, consulta la documentazione di TypeConverters. (36ae9e, b/195413406)
Supporto di chiavi/valori non POJO per i tipi restituiti Multimap nei DAO tramite l'annotazione
@MapInfo. (I4d704)
@MapInfo sarà obbligatorio quando la colonna della chiave o del valore della mappa proviene da una singola colonna. Vedi l'esempio:
@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>
- Rendi
room-pagingun artefatto obbligatorio quando utilizzi Paging3 con Room. (Ieaffe)
Correzioni di bug
- Risolto un problema per cui i risultati delle query multimappa non venivano ordinati correttamente quando la query conteneva una clausola ORDER BY di una colonna della chiave della mappa. (I6b887)
Contributo esterno
- È stata aggiunta una nuova API per specificare l'ordine dell'indice in @Index. Grazie a Nikita Zhelonkin. (I033fc)
Versione 2.4.0-alpha04
21 luglio 2021
androidx.room:room-*:2.4.0-alpha04 è stato rilasciato. La versione 2.4.0-alpha04 contiene questi commit.
Nuove funzionalità
Room ora supporta i tipi restituiti multimappa per i metodi
@Dao, utili per le istruzioni JOIN. I tipi di multimappe supportati sonoMap, oltre aImmutableMap,ImmutableSetMultimapeImmutableListMultimapdi Guava.Di seguito sono riportati alcuni esempi di query multimappa:
Mappa delle relazioni uno a uno
@Query("SELECT * FROM Song JOIN Artist ON Song.artistId = Artist.artistId") fun getSongAndArtist(): Map<Song, Artist>Mappa delle relazioni one-to-many (multimappa standard)
@Query("SELECT * FROM Artist JOIN Album ON Artist.id = Album.artistId") fun getArtistAndAlbums(): Map<Artist, List<Album>>Il risultato della multimappa può anche essere inserito nei tipi restituiti asincroni supportati, come
LiveData,Observabledi Rx o coroutineFlow.
Room-Paging
Viene rilasciata la versione
androidx.room:room-paging, che fornisce il supporto nativo di Paging 3.0 per le query di Room che restituisconoandroidx.paging.PagingSource.@Dao interface UserDao { @Query("SELECT * FROM users ORDER BY id ASC") fun loadUsers(): PagingSource<Int, User> }Questo artefatto sostituisce l'implementazione di
androidx.paging.PagingSourcegenerata da Room con una basata sulle API Paging 3.0. La nuova implementazione di PagingSource analizza le chiavi in modo diverso, quindi qualsiasi chiave fornita manualmente a PagingSource di Room deve tenere conto di questa modifica del comportamento, inclusa la chiave initialKey passata tramite il costruttore di Pager. Le pagine inizieranno a essere caricate daKey, conKeycome primo elemento caricato. Questo comportamento si discosta da quello esistente, in cuiLoadParams.Refresh.Keyviene trattato come la posizione di scorrimento dell'utente e gli elementi vengono caricati sia prima che dopo la chiave.L'artefatto è facoltativo e la disattivazione comporterà il ritorno al supporto esistente per Paging 3.0 introdotto in Room 2.3. Tuttavia, questo artefatto diventerà obbligatorio in una release futura per chi utilizza Room con Paging 3.0. Per attivare questa funzionalità, aggiungi il nuovo artefatto room-paging al tuo classpath. Se utilizzi Gradle, puoi aggiungere il seguente snippet al file build.gradle:
dependency { implementation("androidx.room:room-paging:2.4.0-alpha04") }
Correzioni di bug
- Risolto un problema relativo alla gestione delle violazioni delle chiavi esterne nelle migrazioni automatiche. (b/190113935)
Versione 2.4.0-alpha03
16 giugno 2021
androidx.room:room-*:2.4.0-alpha03 è stato rilasciato. La versione 2.4.0-alpha03 contiene questi commit.
Modifiche alle API
- Aggiorna
MigrationTestHelperdi Room per supportare le migrazioni automatiche fornendo una nuova API del costruttore che riceve la classe del database in fase di test. In questo modo, l'assistente può aggiungere automaticamente le migrazioni automatiche nello stesso modo duranterunMigrationsAndValidate.
Correzioni di bug
È stato risolto un problema relativo alla libreria nativa SQLite di Room per supportare i chip M1 di Apple. (b/174695268
È stato risolto un problema per cui Room non generava un errore quando il tipo restituito di una funzione @Transaction era un Flow (I56ddd, b/190075899)
Risolto un problema relativo agli indici nelle migrazioni automatiche. b/177673291
Aggiornamenti delle dipendenze
- Il supporto di KSP da parte di Room ora dipende da KSP
1.5.10-1.0.0-beta01. (1ecb11, b/160322705)
Versione 2.4.0-alpha02
5 maggio 2021
androidx.room:room-*:2.4.0-alpha02 è stato rilasciato. La versione 2.4.0-alpha02 contiene questi commit.
Modifiche alle API
@ProvidedAutoMigrationSpecè una nuova API per dichiarare che unAutoMigrationSpecverrà fornito in fase di runtime tramiteRoomDatabase.Builder#addAutoMigrationSpec(). In questo modo, un framework di dependency injection può fornire queste specifiche quando sono necessarie dipendenze complesse.
Correzioni di bug
- Risolto un problema relativo alle migrazioni automatiche per cui i
@DatabaseViewnon venivano ricreati correttamente.
Contributo esterno
- È stato risolto un problema nella versione
JournalMode.TRUNCATEdi Room per cui a volte il callbackInvalidationTrackerveniva richiamato in modo non valido, troppo tardi o non veniva richiamato affatto. Grazie aUli Bubenheimer | bubenheimer@users.noreply.github.com(b/154040286)
Versione 2.4.0-alpha01
21 aprile 2021
androidx.room:room-*:2.4.0-alpha01 è stato rilasciato. La versione 2.4.0-alpha01 contiene questi commit.
Nuove funzionalità
- Migrazioni automatiche: Room ora offre un'API per generare automaticamente le migrazioni, purché gli schemi vengano esportati. Per comunicare a Room che deve generare una migrazione automatica, è possibile utilizzare una nuova proprietà
@Database#autoMigrationsper dichiarare le versioni da e verso cui eseguire la migrazione automatica. Quando Room ha bisogno di ulteriori informazioni sulle ridenominazioni o sulle eliminazioni di tabelle e colonne, l'annotazione@AutoMigrationpuò dichiarare una classe di specifica contenente questi input. Per ulteriori dettagli, consulta la documentazione di@AutoMigration.
Correzioni di bug
- Risolto un problema per cui
defaultValuecon parentesi aggiuntive veniva convalidato in modo errato dalla convalida dello schema di Room. b/182284899
Versione 2.3.0
Versione 2.3.0
21 aprile 2021
androidx.room:room-*:2.3.0 è stato rilasciato. La versione 2.3.0 contiene questi commit.
Modifiche importanti dalla versione 2.2.0
- Supporto integrato per Enum: Room ora utilizzerà per impostazione predefinita un convertitore di tipo da Enum a String e viceversa, se non ne viene fornito uno. Se esiste già un convertitore di tipo per un enum, Room darà la priorità al suo utilizzo rispetto a quello predefinito.
- Callback di query: Room ora offre un'API callback generale RoomDatabase.QueryCallback, per quando le query stanno per essere eseguite, il che può essere utile per l'accesso alle build di debug. Il callback può essere impostato tramite
RoomDatabase.Builder#setQueryCallback(). - Miglioramento preconfigurato: Room ora dispone di API per la creazione di un database utilizzando un database preconfigurato letto da un flusso di input. In questo modo è possibile gestire casi come quello in cui il database pre-pacchetto è compresso con gzip.
- Convertitori di tipi forniti: Room ora dispone di API per fornire istanze di convertitori di tipi in modo che l'app possa controllarne l'inizializzazione. Per contrassegnare un convertitore di tipo che verrà fornito a Room, utilizza la nuova annotazione @ProvidedTypeConverter.
- Supporto di RxJava3: Room ora supporta i tipi RxJava3. Analogamente a RxJava2, puoi dichiarare metodi DAO il cui tipo restituito è Flowable, Single, Maybe e Completable. Inoltre, è disponibile un nuovo artefatto
androidx.room:room-rxjava3per supportare RxJava3. - Supporto di Paging 3.0: Room ora supporta la generazione di implementazioni per i metodi annotati
@Queryil cui tipo restituito èandroidx.paging.PagingSource.
Versione 2.3.0-rc01
24 marzo 2021
androidx.room:room-*:2.3.0-rc01 è stato rilasciato. La versione 2.3.0-rc01 contiene questi commit.
Correzioni di bug
- Risolto un problema che impediva l'utilizzo delle query Coroutine Flow create da Room in un blocco
withTransactiondi sospensione. (I797bf)
Versione 2.3.0-beta03
10 marzo 2021
androidx.room:room-*:2.3.0-beta03 è stato rilasciato. La versione 2.3.0-beta03 contiene questi commit.
Nuove funzionalità
- È stato aggiunto il supporto della compilazione incrementale per KSP. (I031c1, b/176453350)
Correzioni di bug
- È stato risolto un bug per cui la creazione di PagingSource sul thread principale poteva attivare un errore ANR. (I42b74, b/181221318)
- Risolto il problema della visibilità di
@ExperimentalRoomApi, che ora è pubblica anziché privata per il pacchetto. (b/181356119)
Contributo esterno
- Consenti a Room di accettare un tipo restituito POJO in un metodo DAO annotato con
@Queryquando è annotato anche con@SkipQueryVerification. Room farà del suo meglio per convertire il risultato della query nel tipo restituito POJO, nello stesso modo in cui viene eseguito per un metodo DAO annotato@RawQuery. Grazie a "Markus Riegel | hey@marcorei.com". (I45acb)
Versione 2.3.0-beta02
18 febbraio 2021
androidx.room:room-*:2.3.0-beta02 è stato rilasciato. La versione 2.3.0-beta02 contiene questi commit.
Nuove funzionalità
Room ora supporta in via sperimentale Kotlin Symbol Processing KSP.
KSP è un sostituto di KAPT per eseguire i processori di annotazioni in modo nativo sul compilatore Kotlin, riducendo notevolmente i tempi di compilazione.
Per utilizzare Room con KSP, puoi applicare il plug-in Gradle KSP e sostituire la configurazione
kaptnel file di build conksp. Ad esempio, invece dikapt 'androidx.room:room-compiler:2.3.0-beta02'utilizzaksp 'androidx.room:room-compiler:2.3.0-beta02'. Per ulteriori dettagli, consulta la documentazione di KSP.Tieni presente che, poiché KSP è sperimentale, è consigliabile continuare a utilizzare KAPT per il codice di produzione. La riduzione dei tempi di build è applicabile solo se non sono presenti altri processori che utilizzano KAPT. Consulta b/160322705 per i problemi noti.
Versione 2.3.0-beta01
27 gennaio 2021
androidx.room:room-*:2.3.0-beta01 è stato rilasciato. La versione 2.3.0-beta01 contiene questi commit.
Nuove funzionalità
- Database con chiusura automatica: Room ora è in grado di chiudere i database a cui non viene eseguito l'accesso dopo un determinato periodo di tempo. Questa è una funzionalità sperimentale e può essere attivata chiamando
RoomDatabase.Builder#setAutoCloseTimeout(). Questa funzionalità è utile per le applicazioni con più database.
Correzioni di bug
- È stato risolto un problema per cui i metodi Dao con più metodi
@Updateo@Deletecon strategie di conflitto diverse generavano codice con una sola delle strategie, ignorando di fatto quella definita. (/I0b90d, b/176138543)
Versione 2.3.0-alpha04
16 dicembre 2020
androidx.room:room-*:2.3.0-alpha04 è stato rilasciato. La versione 2.3.0-alpha04 contiene questi commit.
Nuove funzionalità
- Room ora offre un'API callback generale
RoomDatabase.QueryCallback, per quando le query stanno per essere eseguite, che può essere utile per il logging nelle build di debug. Il callback può essere impostato tramiteRoomDatabase.Builder#setQueryCallback(). (Iaa513, b/174478034, b/74877608) - Room ora utilizzerà per impostazione predefinita un convertitore di tipo da Enum a String e viceversa, se non ne viene fornito uno. Se esiste già un convertitore di tipo per un enum, Room darà la priorità al suo utilizzo rispetto a quello predefinito. (b/73132006)
Problema noto
- Se esiste già un convertitore di tipo unidirezionale per la lettura dell'Enum, Room potrebbe utilizzare accidentalmente il convertitore integrato da String a Enum, il che potrebbe non essere l'ideale. Si tratta di un problema noto che può essere risolto rendendolo un convertitore bidirezionale. Vedi: b/175707691
Correzioni di bug
- Risolto un problema per cui Room disattivava erroneamente l'elaborazione incrementale delle annotazioni nelle versioni più recenti di JDK. (b/171387388)
- Risolto un problema per cui Room trovava la classe generata quando venivano utilizzati più caricatori di classi. Grazie per la correzione "Serendipity | 892449346@qq.com". (b/170141113)
- Risolto un problema per cui Room generava un codice errato quando un
@DaoKotlin aveva una classe base i cui generici sono primitivi nella JVM. (b/160258066)
Contributo esterno
- Room ora utilizzerà
beginTransactionNonExclusiveper impostazione predefinita se la modalità WAL è abilitata e l'API è 16 o superiore. Grazie ad "Ahmed I. Khalil | ahmedibrahimkhali@gmail.com’! (b/126258791)
Versione 2.3.0-alpha03
14 ottobre 2020
androidx.room:room-*:2.3.0-alpha03 è stato rilasciato. La versione 2.3.0-alpha03 contiene questi commit.
Nuove funzionalità
Room ora dispone di API per fornire istanze di convertitori di tipo in modo che l'app possa controllarne l'inizializzazione. Per contrassegnare un convertitore di tipo che verrà fornito a Room, utilizza la nuova annotazione
@ProvidedTypeConverter. Grazie a "mzgreen yairobbe@gmail.com". (Ie4fa5, b/121067210)Room ora dispone di API per la creazione di un database utilizzando un database pacchettizzato letto da uno stream di input. In questo modo è possibile gestire casi come quello in cui il database pre-pacchetto è compresso con gzip. Grazie ad "Ahmed El-Helw ahmedre@gmail.com" (3e6792, b/146911060)
Modifiche alle API
È stato aggiunto il target mancante all'annotazione
@ForeignKey, impedendone l'utilizzo al di fuori dell'annotazione@Entity. (Iced1e)Il campo
mCallbacksinRoomDatabase.javaè ora nascosto. (d576cb, b/76109329)
Correzioni di bug
Aggiornamento della documentazione di TypeConverters per chiarire che TypeConverters può essere utilizzato solo per convertire colonne/campi e non righe. (I07c56, b/77307836)
Aggiornamento di DaoProcessor per correggere l'errore del compilatore su Dao con un supertipo generico con "primitive" Kotlin. (Ice6bb, b/160258066)
Aggiornamento della documentazione dei metodi di aggiunta/rimozione degli osservatori per chiarire il threading (Ifd1d9, b/153948821)
Risolto un problema per cui Room convalidava in modo errato le tabelle FTS che dichiaravano la colonna rowid. (d62ebc, b/145858914)
Contributi esterni
Risolti i problemi relativi alle impostazioni internazionali per maiuscole/minuscole in turco (5746e3), b/68159494
Sostituisci
ConcurrentHashMapall'interno diRoomDatabaseconCollections.synchronizedMap()per evitare problemi su Android Lollipop (d1cfc7, b/162431855)Aggiungi un callback onOpenPrepackagedDatabase per quando viene copiato un DB predefinito. (I1ba74, b/148934423)
Versione 2.3.0-alpha02
22 luglio 2020
androidx.room:room-*:2.3.0-alpha02 è stato rilasciato. La versione 2.3.0-alpha02 contiene questi commit.
Nuove funzionalità
- Supporto di RxJava3: Room ora supporta i tipi RxJava3. Analogamente a RxJava2, puoi dichiarare metodi DAO il cui tipo restituito è Flowable, Single, Maybe e Completable. Inoltre, è disponibile un nuovo artefatto
androidx.room:room-rxjava3per supportare RxJava3. (b/152427884)
Modifiche alle API
- La dichiarazione di un
@TypeConverternella classe Object di Kotlin è ora supportata. (b/151110764) - L'opzione di elaborazione delle annotazioni incrementali
Roomè ora attiva per impostazione predefinita. (b/112110217)
Versione 2.3.0-alpha01
10 giugno 2020
androidx.room:room-*:2.3.0-alpha01 è stato rilasciato. La versione 2.3.0-alpha01 contiene questi commit.
Nuove funzionalità
Supporto di Paging 3.0: Room ora supporta la generazione di implementazioni per i metodi annotati
@Queryil cui tipo restituito èandroidx.paging.PagingSource.@Dao interface UserDao { @Query("SELECT * FROM users ORDER BY id ASC") fun pagingSource(): PagingSource<Int, User> }
Modifiche alle API
@RewriteQueriesToDropUnusedColumnsè una nuova annotazione pratica che consente a Room di riscrivere la proiezione "*" in una query in modo che le colonne inutilizzate nel risultato vengano rimosse.- L'opzione del processore
room.expandProjectionè ora deprecata. Utilizza@RewriteQueriesToDropUnusedColumnscome sostituto di Room per ottimizzare le query con proiezioni a stella. Tieni presente che@RewriteQueriesToDropUnusedColumnsnon sostituisce la soluzione ai conflitti tra colonneroom.expandProjectionofferta per i tipi restituiti che contenevano campi@Embedded.
Correzioni di bug
- Risolto un bug per cui Room non rilevava correttamente la versione del JDK utilizzata per attivare il processore di annotazioni incrementale. Grazie a Blaz Solar (me@blaz.solar) (b/155215201)
- Room ora incorpora la sua dipendenza ANTLR con il processore di annotazioni per evitare conflitti di versione con altri processori che utilizzano anche ANTLR. (b/150106190)
Versione 2.2.6
Versione 2.2.6
16 dicembre 2020
androidx.room:room-*:2.2.6 è stato rilasciato. La versione 2.2.6 contiene questi commit.
Correzioni di bug
- Risolto un problema per cui Room disattivava erroneamente l'elaborazione incrementale delle annotazioni nelle versioni più recenti di JDK. (b/171387388)
Versione 2.2.5
Versione 2.2.5
18 marzo 2020
androidx.room:room-*:2.2.5 è stato rilasciato. La versione 2.2.5 contiene questi commit.
Correzioni di bug
- Imposta
MultiInstanceInvalidationServicecome directBootAware. Grazie a "Mygod contact-git@mygod.be" (b/148240967) - Risolto un bug che causava un arresto anomalo quando l'annullamento della convalida multi-istanza era abilitato e il database conteneva un'entità FTS. (b/148969394)
- Risolto un problema durante il caricamento delle librerie native SQLite nel processore di annotazioni Room che causava l'arresto anomalo del compilatore a causa di compilazioni parallele. (b/146217083)
Versione 2.2.4
Versione 2.2.4
19 febbraio 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 e androidx.room:room-testing:2.2.4 sono stati rilasciati. La versione 2.2.4 contiene questi commit.
Correzioni di bug
- Risolto un problema relativo alla sospensione delle transazioni che causava un deadlock se la coroutine veniva annullata rapidamente prima dell'avvio effettivo della transazione. (b/148181325)
- È stato risolto un problema relativo all'utilizzo errato di @Generated durante la creazione con JDK 9. (b/146538330)
- È stato risolto un problema per cui Room generava un codice errato quando un'interfaccia DAO in Kotlin aveva una funzione concreta. (b/146825845)
Versione 2.2.3
Versione 2.2.3
18 dicembre 2019
androidx.room:room-*:2.2.3 è stato rilasciato. La versione 2.2.3 contiene questi commit.
Correzioni di bug
- È stato corretto un bug per cui Room non riusciva a convalidare un database che non era stato sottoposto a migrazione e conteneva un hash precedente con indici nel relativo schema. (b/139306173)
Versione 2.2.2
Versione 2.2.2
20 novembre 2019
androidx.room:room-*:2.2.2 è stato rilasciato. La versione 2.2.2 contiene questi commit.
Correzioni di bug
- Risolto un bug per cui la raccolta di una relazione uno a uno con più di 999 righe causava la restituzione di elementi correlati nulli da parte di Room. (b/143105450)
Versione 2.2.1
Versione 2.2.1
23 ottobre 2019
androidx.room:room-*:2.2.1 è stato rilasciato. La versione 2.2.1 contiene questi commit.
Correzioni di bug
- È stato corretto un bug per cui Room avvisava erroneamente di
CURSOR_MISMATCHcon l'opzione del compilatoreexpandProjectionattivata. (b/140759491) - È stato aggiunto un meccanismo di ripetizione per gestire la libreria nativa mancante utilizzata per verificare le query durante il tempo di compilazione.
Versione 2.2.0
Versione 2.2.0
9 ottobre 2019
androidx.room:room-*:2.2.0 è stato rilasciato. La versione 2.2.0 contiene questi commit.
Modifiche importanti rispetto alla versione 2.1.0
- Database predefinito: sono ora disponibili due nuove API in
RoomDatabase.Builderper creare unRoomDatabasedato un file di database già compilato.createFromAsset()viene utilizzato quando il file di database precompilato si trova nella cartella degli asset dell'APK, mentrecreateFromFile()viene utilizzato quando il file si trova in una posizione arbitraria. Gli utilizzi di queste API modificano il comportamento delle migrazioni distruttive in modo che, durante una migrazione di riserva, Room tenti di ricopiare il database precompilato, se disponibile, altrimenti ricorre semplicemente all'eliminazione e alla ricreazione di tutte le tabelle. b/62185732 - Valori predefiniti dello schema:
@ColumnInfoora ha una nuova proprietàdefaultValueche può essere utilizzata per specificare il valore predefinito di una colonna. I valori predefiniti fanno parte di uno schema di database e, se specificati, verranno convalidati durante le migrazioni. b/64088772 - Relazioni many-to-many:
@Relationora ha una nuova proprietàassociateBy, che accetta una nuova annotazione@Junction, utilizzata per dichiarare una relazione che deve essere soddisfatta tramite una tabella di giunzione (nota anche come tabella di join). b/69201917 - Relazioni uno a uno: la limitazione nei campi POJO annotati con
@Relationper essere di tipoListoSetè stata rimossa, consentendo di fatto la rappresentazione di relazioni con un singolo valore. b/62905145 - Target Entity: le annotazioni DAO
@Insert,@Updatee@Deleteora hanno una nuova proprietàtargetEntity, che consente di specificare la tabella di destinazione su cui deve agire il metodo DAO. In questo modo, i parametri di questi metodi DAO possono essere POJO arbitrari che verranno interpretati come entità parziali. In pratica, ciò consente inserimenti, eliminazioni e aggiornamenti parziali. b/127549506 - Flusso di coroutine: i metodi DAO
@Queryora possono essere di tipo restituitoFlow<T>. Il flusso restituito emetterà nuovamente un nuovo insieme di valori se le tabelle di osservazione nella query non sono valide. La dichiarazione di una funzione DAO con un tipo restituitoChannel<T>è un errore. Room ti incoraggia invece a utilizzareFlowe poi le funzioni adiacenti per convertireFlowinChannel. b/130428884 - Processore di annotazioni incrementali Gradle: Room è ora un processore di annotazioni di isolamento Gradle e l'incrementabilità può essere attivata tramite l'opzione del processore
room.incremental. Per saperne di più, consulta Opzioni del compilatore Room. In caso di problemi, segnala un bug qui. Abbiamo in programma di attivare l'incrementabilità per impostazione predefinita in una versione stabile futura. b/112110217 - Espansione delle proiezioni: è stata aggiunta una nuova opzione sperimentale del compilatore
room.expandProjectionche fa sì che Room riscriva una query con una proiezione a stella in modo che contenga solo le colonne nel POJO del tipo restituito. Ad esempio, per un metodo DAO con@Query("SELECT * FROM Song")che restituisce un POJO denominatoSongIdAndTitlecon solo due campi. Room riscriverà la query inSELECT id, title FROM Songin modo che venga recuperato l'insieme minimo di colonne per soddisfare il tipo restituito. In questo modo, l'avvisoCURSOR_MISMATCHche viene visualizzato quando la query restituisce colonne aggiuntive che non corrispondono ad alcun campo nel tipo POJO restituito viene eliminato.
Versione 2.2.0-rc01
5 settembre 2019
androidx.room:room:2.2.0-rc01 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.
Nessuna modifica pubblica dalla versione Room 2.2.0-beta01.
Versione 2.2.0-beta01
22 agosto 2019
androidx.room:room-*:2.2.0-beta01 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.
Correzioni di bug
- È stato corretto un bug per cui una query Coroutine Flow interrompeva la riemissione di nuovi valori dopo un determinato periodo di tempo. (b/139175786)
- È stato corretto un bug per cui Room non accettava un codice hash dello schema precedente durante l'apertura di un database di cui non era stata eseguita la migrazione da Room 1.0, causando un arresto anomalo in fase di runtime a causa di uno schema non valido. (b/139306173)
Versione 2.2.0-alpha02
7 agosto 2019
androidx.room:room-*:2.2.0-alpha02 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.
Nuove funzionalità
- Flusso di coroutine: i metodi DAO
@Queryora possono essere di tipo restituitoFlow<T>. Il flusso restituito emetterà nuovamente un nuovo insieme di valori se le tabelle di osservazione nella query non sono valide. La dichiarazione di una funzione DAO con un tipo restituitoChannel<T>è un errore. Room ti incoraggia invece a utilizzareFlowe poi le funzioni adiacenti per convertireFlowinChannel. b/130428884 - Espansione delle proiezioni: è stata aggiunta una nuova opzione sperimentale del compilatore
room.expandProjectionche fa sì che Room riscriva una query con una proiezione a stella in modo che contenga solo le colonne nel POJO del tipo restituito. Ad esempio, per un metodo DAO con@Query("SELECT * FROM Song")che restituisce un POJO denominatoSongIdAndTitlecon solo due campi. Room riscriverà la query inSELECT id, title FROM Songin modo che venga recuperato l'insieme minimo di colonne per soddisfare il tipo restituito. In questo modo, l'avvisoCURSOR_MISMATCHche viene visualizzato quando la query restituisce colonne aggiuntive che non corrispondono ad alcun campo nel tipo POJO restituito viene eliminato. onDestructiveMigrateè una nuova API callback aggiunta aRoomDatabase.Callbackper quando Room esegue la migrazione distruttiva di un database. b/79962330
Correzioni di bug
- È stato corretto un bug per cui Room generava un codice errato utilizzando un metodo come setter di campo quando il campo è protetto. b/136194628
- È stato corretto un bug che causava la generazione di un'eccezione NPE da parte di InvalidationTracker in un secondo processo quando l'annullamento della convalida multi-istanza era abilitato e il servizio di annullamento della convalida veniva terminato. b/137454915
- Risolto un bug per cui Room non identificava correttamente il tipo restituito di una funzione di sospensione ereditata annotata con
@RawQuery. b/137878827 - Aggiornato il codice generato per
@Relationquando la chiave correlata è di tipo BLOB per utilizzare unByteBufferconfrontabile. b/137881998 - È stato corretto un bug per cui Room segnalava la mancanza di setter nei POJO utilizzati come parametri di entità parziali di
@Insert,@Updatee@Delete. b/138664463 - È stato corretto un bug per cui Room segnalava la mancanza di getter e setter per una colonna ignorata tramite
@Entityquando la classe di entità veniva utilizzata in determinati metodi DAO. b/138238182 - È stato corretto un bug per cui Room non convertiva correttamente gli argomenti di associazione denominati in argomenti posizionali, causando un'eccezione di runtime durante l'esecuzione di una query con parametri riutilizzati. b/137254857
Versione 2.2.0-alpha01
10 luglio 2019
Nuove funzionalità
- Database predefinito: sono ora disponibili due nuove API in
RoomDatabase.Builderper creare unRoomDatabasedato un file di database già compilato.createFromAsset()viene utilizzato quando il file di database precompilato si trova nella cartella degli asset dell'APK, mentrecreateFromFile()viene utilizzato quando il file si trova in una posizione arbitraria. Gli utilizzi di queste API modificano il comportamento delle migrazioni distruttive in modo che, durante una migrazione di riserva, Room tenti di ricopiare il database precompilato, se disponibile, altrimenti ricorre semplicemente all'eliminazione e alla ricreazione di tutte le tabelle. b/62185732 - Valori predefiniti dello schema:
@ColumnInfoora ha una nuova proprietàdefaultValueche può essere utilizzata per specificare il valore predefinito di una colonna. I valori predefiniti fanno parte di uno schema di database e, se specificati, verranno convalidati durante le migrazioni. b/64088772Nota: se lo schema del database ha già valori predefiniti, ad esempio quelli aggiunti tramite
ALTER TABLE x ADD COLUMN y INTEGER NOTNULL DEFAULT z, e decidi di definire valori predefiniti tramite@ColumnInfoper le stesse colonne, potresti dover eseguire una migrazione per convalidare i valori predefiniti non considerati. Per saperne di più, consulta Migrazioni delle stanze. - Relazioni many-to-many:
@Relationora ha una nuova proprietàassociateBy, che accetta una nuova annotazione@Junction, utilizzata per dichiarare una relazione che deve essere soddisfatta tramite una tabella di giunzione (nota anche come tabella di join). b/69201917 - Relazioni uno a uno: la limitazione nei campi POJO annotati con
@Relationper essere di tipoListoSetè stata rimossa, consentendo di fatto la rappresentazione di relazioni con un singolo valore. b/62905145 - Target Entity: le annotazioni DAO
@Insert,@Updatee@Deleteora hanno una nuova proprietàtargetEntity, che consente di specificare la tabella di destinazione su cui deve agire il metodo DAO. In questo modo, i parametri di questi metodi DAO possono essere POJO arbitrari che verranno interpretati come entità parziali. In pratica, ciò consente inserimenti, eliminazioni e aggiornamenti parziali. b/127549506 - Processore di annotazioni incrementali Gradle: Room è ora un processore di annotazioni di isolamento Gradle e l'incrementabilità può essere attivata tramite l'opzione del processore
room.incremental. Per saperne di più, consulta Opzioni del compilatore Room. In caso di problemi, segnala un bug qui. Abbiamo in programma di attivare l'incrementabilità per impostazione predefinita in una versione stabile futura. b/112110217
Correzioni di bug
- Room non propagherà più
EmptySetResultExceptional gestore degli errori globale quando lo stream Rx di una query è stato eliminato prima del completamento della query. b/130257475 - È stato corretto un bug per cui Room mostrava un messaggio di errore errato quando una funzione DAO di sospensione annotata con
@RawQuerynon aveva un tipo restituito. b/134303897 - Room non genererà più adattatori DAO con tipi non elaborati. b/135747255
Versione 2.1.0
Versione 2.1.0
13 giugno 2019
La versione 2.1.0 di Room è stata rilasciata senza modifiche rispetto alla versione 2.1.0-rc01. I commit inclusi nella versione sono disponibili qui.
Modifiche importanti dalla versione 2.0.0
- FTS: Room ora supporta le entità con una tabella di mappatura FTS3 o FTS4. Le classi annotate con
@Entityora possono essere annotate anche con@Fts3o@Fts4per dichiarare una classe con una tabella di ricerca a testo intero di mappatura. Le opzioni FTS per un'ulteriore personalizzazione sono disponibili tramite i metodi dell'annotazione. - Viste: Room ora supporta la dichiarazione di una classe come query archiviata, nota anche come vista, utilizzando l'annotazione
@DatabaseView. - Coroutine: i metodi DAO ora possono essere funzioni di sospensione. Includi
room-ktxnelle tue dipendenze per usufruire di questa funzionalità. L'artefatto ktx fornisce anche la funzione di estensioneRoomDatabase.withTransactionper eseguire transazioni di database all'interno di una coroutine. - AutoValue: Room ora supporta la dichiarazione di classi annotate AutoValue come entità e POJO. Le annotazioni Room
@PrimaryKey,@ColumnInfo,@Embeddede@Relationora possono essere dichiarate nei metodi astratti di una classe annotata con AutoValue. Tieni presente che queste annotazioni devono essere accompagnate anche da@CopyAnnotationsaffinché Room le comprenda correttamente. - Supporto asincrono aggiuntivo: i metodi DAO annotati con
@Insert,@Deleteo@Update, insieme a@Querycontenente istruzioniINSERT,DELETEoUPDATE, ora supportano i tipi restituiti RxCompletable,Single,Maybee il tipo restituito di GuavaListenableFuture, e possono anche essere funzioni di sospensione. enableMultiInstanceInvalidationè una nuova API inRoomDatabase.Builderper attivare l'annullamento della convalida in più istanze di RoomDatabase utilizzando lo stesso file di database.fallbackToDestructiveMigrationOnDowngradeè una nuova API inRoomDatabase.Builderper ricreare automaticamente il database se si verifica un downgrade.ignoredColumnsè una nuova API nell'annotazione@Entityche può essere utilizzata per elencare i campi ignorati per nome.- Room ora utilizzerà correttamente il costruttore principale di Kotlin nelle classi di dati, evitando di dover dichiarare le proprietà come
vars.
Versione 2.1.0-rc01
29 maggio 2019
Correzioni di bug
- Risolto un errore di inizializzazione di Room che potrebbe verificarsi a causa di una configurazione temp_store già impostata. b/132602198
- Risolto un avviso relativo all'utilizzo delle virgolette doppie per gli utenti con SQLite 3.27.0 e versioni successive. b/131712640
- Risolto un bug per cui InvalidationTracker causava un arresto anomalo quando si verificavano più controlli di annullamento della convalida in parallelo. b/133457594
Versione 2.1.0-beta01
7 maggio 2019
androidx.room 2.1.0-beta01 viene rilasciata senza modifiche rispetto alla versione 2.1.0-alpha07. I commit inclusi in questa versione sono disponibili qui.
Versione 2.1.0-alpha07
25 aprile 2019
Modifiche alle API/al comportamento
- La funzione di estensione
RoomDatabase.withTransactionè stata modificata in modo da non accettare più un blocco di funzioni con unCoroutineScopecome ricevitore. In questo modo, non viene saltato il wrappercoroutineScope { }aggiuntivo richiesto per eseguire contemporaneamente gli elementi nel blocco della transazione.
Correzioni di bug
- È stato corretto un bug per cui Room non riusciva ad abbinare un TypeConverter per una funzione DAO Kotlin contenente un parametro di tipo Collection. b/122066791
Versione 2.1.0-alpha06
22 marzo 2019
Modifiche alle API/al comportamento
- Le query di transazione asincrone sono ora serializzate in modo che Room non utilizzi più di un thread per l'esecuzione delle transazioni del database.
È stato aggiunto
RoomDatabase.Builder.setTransactionExecutor(Executor)per consentire la configurazione dell'esecutore da utilizzare per le transazioni. RoomDatabase.runInTransaction(Callable)non aggregherà più le eccezioni controllate in RuntimeExceptions. b/128623748
Correzioni di bug
- Risolto un bug per cui il tracker di annullamento della convalida interrompeva l'osservazione di una tabella di contenuti se venivano aggiunti osservatori sia per la tabella di contenuti sia per una tabella FTS di contenuti esterni. b/128508917
- Aggiornata la grammatica SQLite
Roomin modo che corrisponda a SQLite 3.24.0. b/110883668
Versione 2.1.0-alpha05
13 marzo 2019
Nuove funzionalità
- La funzione di estensione
RoomDatabase.withTransactionti consente di eseguire in sicurezza le transazioni del database all'interno di una coroutine. Le funzioni di estensione di Room e il supporto delle coroutine sono disponibili nell'artefattoroom-ktx. - I metodi DAO non astratti annotati con
@Transactionora possono essere funzioni di sospensione. b/120241587
Modifiche alle API/al comportamento
- L'artefatto
room-coroutinesè stato rinominato inroom-ktxseguendo la stessa denominazione degli altri artefatti androidx. beginTransaction,setTransactionSuccessfuleendTransactioninRoomDatabasesono stati ritirati a favore dirunInTransactione della funzione di estensioneroom-ktxwithTransaction.
Correzioni di bug
- Risolto un bug per cui gli argomenti del tokenizer venivano ignorati se il tokenizer utilizzato era SIMPLE. b/125427014
- È stato corretto un bug per cui Room non riusciva a identificare correttamente le funzioni di sospensione con parametri il cui tipo era una classe interna. b/123767877
- Risolto un bug per cui il metodo DAO
@Querydifferito con istruzioniINSERT,UPDATEoDELETEpreparava la query in modo eager nel thread principale. b/123695593 - Sono stati corretti vari bug per cui Room generava un codice errato per determinate funzioni di sospensione. b/123466702 e b/123457323
- Risolto un bug per cui l'utilizzo deprecato dei metodi non veniva soppresso correttamente nel codice generato. b/117602586
- È stata aggiornata la dipendenza Room di androidx.sqlite alla versione 1.0.2, che contiene correzioni per la gestione corretta dei database danneggiati. b/124476912
Problemi noti
- Room 2.1.0-alpha05 dipende dall'artefatto
kotlinx-metadata-jvm, che al momento non è disponibile in Maven Central (KT-27991). Questa dipendenza può essere risolta aggiungendomaven { url "https://kotlin.bintray.com/kotlinx/" }ai repository del progetto.
Versione 2.1.0-alpha04
25 gennaio 2019
Nuove funzionalità
- I metodi DAO annotati con
@Querycontenenti istruzioniINSERT,UPDATEoDELETEora possono restituire i tipi asincroniSingle,Mayble,CompletableeListenableFuture. Inoltre, possono anche essere funzioni di sospensione. b/120227284
Modifiche alle API/al comportamento
- Room ora genera un errore se un metodo DAO non astratto annotato con
@Transactionrestituisce un tipo asincrono comeSingle,Mayble,Completable,LiveDataoListenableFuture. Poiché le transazioni sono limitate ai thread, al momento è impossibile per Room iniziare e terminare una transazione attorno a una funzione che potrebbe eseguire query in thread diversi. b/120109336 OnConflictStrategy.FAILeOnConflictStrategy.ROLLBACKsono stati@Deprecatedperché non si comportano come previsto con le attuali associazioni SQLite di Android. b/117266738
Correzioni di bug
- È stato corretto un bug per cui Room non utilizzava correttamente il TypeConverter di un tipo restituito se il metodo DAO era una funzione di sospensione. b/122988159
- Risolto un bug per cui Room identificava erroneamente le funzioni di sospensione ereditate come non di sospensione. b/122902595
- È stato corretto un bug per cui Room generava un codice errato quando un campo
@Embeddedsi trovava in una classe principale e veniva utilizzato in più classi secondarie. b/121099048 - È stato risolto un problema per cui il database si bloccava quando venivano richiamate le funzioni di sospensione DAO tra un
beginTransaction()e unendTransaction(). b/120854786
Versione 2.1.0-alpha03
4 dicembre 2018
Modifiche alle API
- La funzionalità FTS
tokenizerin@Fts3/@Fts4ora accetta una stringa anziché un enum. In questo modo, Room può utilizzare tokenizer personalizzati. I tokenizzatori integrati sono ancora definiti inFtsOptionscome costanti di stringa. b/119234881
Nuove funzionalità
- Coroutine: i metodi DAO ora possono essere funzioni di sospensione. Per supportare le funzioni di sospensione in Room, è stato rilasciato un nuovo artefatto,
room-coroutines. b/69474692 - I metodi DAO annotati con
@Insert,@Deleteo@Updateora supportanoListenableFuturecome tipo restituito. b/119418331
Correzioni di bug
- È stato corretto un bug per cui Room tentava erroneamente di trovare un costruttore con colonne nella proprietà
ignoredColumnsdi@Entity. b/119830714 - Risolto un bug per cui Room non contrassegnava i parametri del metodo DAO come finali nella relativa implementazione generata. b/118015483
- Risolto un bug per cui il processore
Roomsi arrestava in modo anomalo quando segnalava un errore in una query con simboli speciali. b/119520136 - Risolto un bug per cui Room rifiutava altre varie implementazioni di
Collectioncome argomenti di un'espressioneIN. b/119884035 - È stato corretto un bug per cui LiveData restituito da Room veniva sottoposto a garbage collection quando veniva osservato per sempre, causando l'interruzione dell'emissione di nuovi dati. b/74477406
- Aggiornato il blocco di chiusura di
RoomDatabaseper ridurre la contesa del blocco. b/117900450
Versione 2.1.0-alpha02
30 ottobre 2018
Nuove funzionalità
- È stato aggiunto il supporto per fare riferimento a un
@DatabaseViewin un@Relation. b/117680932
Correzioni di bug
- È stato corretto un bug per cui Room eseguiva l'I/O del disco nel thread principale durante la sottoscrizione e l'eliminazione da un tipo restituito Rx. b/117201279
- È stato corretto un bug per cui Room non riusciva a trovare un convertitore di tipo appropriato per un campo in una classe di entità Kotlin. b/111404868
- È stato corretto un bug per cui Room generava un codice errato per un'implementazione dell'interfaccia
DAOcontenente un metodo predefinito Kotlin senza argomenti. b/117527454 - Aggiornato il parser grammaticale SQLite
Room, risolvendo un problema di prestazioni che causava tempi di build lunghi. b/117401230
Versione 2.1.0-alpha01
8 ottobre 2018
Nuove funzionalità
- FTS: Room ora supporta le entità con una tabella di mappatura FTS3 o FTS4. Le classi annotate con
@Entityora possono essere annotate anche con@Fts3o@Fts4per dichiarare una classe con una tabella di ricerca a testo intero di mappatura. Le opzioni FTS per un'ulteriore personalizzazione sono disponibili tramite i metodi dell'annotazione. b/62356416 - Viste: Room ora supporta la dichiarazione di una classe come query archiviata, nota anche come vista, utilizzando l'annotazione @DatabaseView. b/67033276
- AutoValue: Room ora supporta la dichiarazione di classi annotate AutoValue come entità e POJO. Le annotazioni Room
@PrimaryKey,@ColumnInfo,@Embeddede@Relationora possono essere dichiarate nei metodi astratti di una classe annotata con valore automatico. Tieni presente che queste annotazioni devono essere accompagnate anche da@CopyAnnotationsaffinché Room le comprenda correttamente. b/62408420 - Supporto di altri tipi restituiti Rx: i metodi DAO annotati con
@Insert,@Deleteo@Updateora supportano i tipi restituiti RxCompletable,Single<T>eMaybe<T>. b/63317956 - Tipi immutabili con
@Relation: in precedenza, Room richiedeva che i campi annotati con@Relationfossero impostabili, ma ora possono essere parametri del costruttore. enableMultiInstanceInvalidation: è una nuova API inRoomDatabase.Builderper attivare l'annullamento della convalida in più istanze di RoomDatabase utilizzando lo stesso file di database. Questo meccanismo di invalidazione multi-istanza funziona anche su più processi. b/62334005fallbackToDestructiveMigrationOnDowngrade: è una nuova API inRoomDatabase.Builderper ricreare automaticamente il database se si verifica un downgrade. b/110416954ignoredColumns: È una nuova API nel@EntityAnnotazione che può essere utilizzata per elencare i campi ignorati in base al nome. Utile per ignorare i campi ereditati su un'entità. b/63522075
Modifiche alle API/al comportamento
mCallbackemDatabaseinRoomDatabasesono ora@Deprecatede verranno rimossi nella prossima versione principale di Room. b/76109329
Correzioni di bug
- Risolti due problemi per cui Room non si ripristinava correttamente da un database danneggiato o da una migrazione non riuscita durante l'inizializzazione. b/111504749 e b/111519144
- Room ora utilizzerà correttamente il costruttore principale di Kotlin nelle classi di dati, evitando di dover dichiarare i campi come
vars. b/105769985
Versione 2.0.0
Versione 2.0.0
1° ottobre 2018
androidx.room 2.0.0 viene rilasciata senza modifiche rispetto alla versione 2.0.0-rc01.
Versione 2.0.0-rc01
20 settembre 2018
androidx.room 2.0.0-rc01 viene rilasciata senza modifiche rispetto alla versione 2.0.0-beta01.
Versione 2.0.0-beta01
2 luglio 2018
Modifiche alle API/al comportamento
- Aggiunta di
RoomDatabase.Builder.setQueryExecutor()per consentire la personalizzazione della posizione in cui vengono eseguite le query - Aggiunto il supporto di RxJava2
Observable - Le implementazioni DAO e Database generate sono ora definitive
Correzioni di bug
- Specifica il nome della classe/del campo nell'errore "Impossibile trovare il getter per il campo" b/73334503
- Risolto il problema di compatibilità con le versioni precedenti di RoomOpenHelper con le versioni precedenti di Room b/110197391
Dipendenze pre-AndroidX
Per le versioni di Room precedenti ad AndroidX, includi queste dipendenze:
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"
}
Versione 1.1.1
Versione 1.1.1
19 giugno 2018
La stanza 1.1.1 è identica alla stanza 1.1.1-rc1.
Versione 1.1.1-rc1
16 maggio 2018
Se utilizzi le migrazioni, ti consigliamo vivamente di utilizzare Room 1.1.1-rc1 anziché 1.1.0.
Risolto un bug per cui Room non gestiva correttamente l'inizializzazione post-migrazione b/79362399
Versione 1.1.0
Versione 1.1.0-beta3
19 aprile 2018
Correzioni di bug
- Correzione dell'errore di compilazione quando un POJO Kotlin fa riferimento a un'entità di relazione definita in Java b/78199923
Versione 1.1.0-beta2
5 aprile 2018
Correzioni di bug
Risolto un bug critico nelle implementazioni di
RoomRxSingleeMaybein cui la query veniva riciclata in anticipo, causando problemi se aggiungevi più di un osservatore alle istanzeSingleoMayberestituite. b/76031240[RoomDatabase.clearAllTables][ref-clearAllTables] non
VACUUMil database se viene chiamato all'interno di una transazione. b/77235565
Versione 1.1.0-beta1
21 marzo 2018
Modifiche alle API
- In base al feedback della revisione dell'API,
@RawQuerynon accetta più il passaggio di unStringcome parametro di query. Devi utilizzare [SupportSQLiteQuery][ref-SupportSQLiteQuery]. (vedi [SimpleSQLiteQuery][ref-SimpleSQLiteQuery] per creare facilmente un'istanza di [SupportSQLiteQuery][ref-SupportSQLiteQuery] con supporto degli argomenti). - Il metodo [fallbackToDestructiveMigrationFrom][ref-fallbackToDestructiveMigrationFrom] di RoomDatabase.Builder ora accetta
vararg intanzichévararg Integer.
Correzioni di bug
- [RoomDatabase.clearAllTables][ref-clearAllTables] ora tenta di restituire spazio al sistema operativo impostando un checkpoint WAL e
VACUUMing il database. - [
@RawQuery][ref-RawQuery] ora accetta qualsiasi Pojo per la proprietàobservedEntities, purché il Pojo faccia riferimento a una o più entità tramite i relativi campiEmbeddedoRelation. b/74041772 - Paging: l'implementazione di DataSource di Room ora gestisce correttamente le dipendenze di più tabelle (ad esempio relazioni e join). In precedenza, queste operazioni non attivavano nuovi risultati o non venivano compilate. b/74128314
Versione 1.1.0-alpha1
22 gennaio 2018
Nuove funzionalità
RawQuery: questa nuova API consente ai metodi@Daodi ricevere l'SQL come parametro di query b/62103290, b/71458963fallBackToDestructiveMigrationsFrom: questa nuova API inRoomDatabase.Builderconsente un controllo più granulare sulle versioni dello schema di partenza da cui sono consentite le migrazioni distruttive (rispetto a fallbackToDestructiveMigration) b/64989640- Room ora supporta solo le API Paging più recenti (alpha-4+), abbandonando il supporto per l'elemento deprecato
LivePagedListProvider. Per utilizzare la nuova versione alpha di Room, devi utilizzare la versionealpha-4o una versione successiva di Paging e passare daLivePagedListProvideraLivePagedListBuilder, se non l'hai ancora fatto.
Correzioni di bug
- Miglioramento del supporto per i tipi Kotlin Kapt. b/69164099
- L'ordine dei campi non invalida più lo schema. b/64290754