DataStore

Memorizza i dati in modo asincrono, coerente e transazionale, superando alcuni degli svantaggi di SharedPreferences
Ultimo aggiornamento Release stabile Candidato per la release Versione beta Versione alpha
20 maggio 2025 1.1.7 - - 1.2.0-alpha02

Dichiarazione delle dipendenze

Per aggiungere una dipendenza a DataStore, devi aggiungere il repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il repository Maven di Google.

Esistono due implementazioni di DataStore: Preferences e Proto. Scegli una o l'altra opzione. Puoi anche aggiungere dipendenze non Android a entrambe le implementazioni.

Aggiungi le dipendenze per l'implementazione necessaria nel file build.gradle per la tua app o il tuo modulo:

Datastore delle preferenze

Groovy

    // Preferences DataStore (SharedPreferences like APIs)
    dependencies {
        implementation "androidx.datastore:datastore-preferences:1.1.7"

        // optional - RxJava2 support
        implementation "androidx.datastore:datastore-preferences-rxjava2:1.1.7"

        // optional - RxJava3 support
        implementation "androidx.datastore:datastore-preferences-rxjava3:1.1.7"
    }

    // Alternatively - use the following artifact without an Android dependency.
    dependencies {
        implementation "androidx.datastore:datastore-preferences-core:1.1.7"
    }

Kotlin

    // Preferences DataStore (SharedPreferences like APIs)
    dependencies {
        implementation("androidx.datastore:datastore-preferences:1.1.7")

        // optional - RxJava2 support
        implementation("androidx.datastore:datastore-preferences-rxjava2:1.1.7")

        // optional - RxJava3 support
        implementation("androidx.datastore:datastore-preferences-rxjava3:1.1.7")
    }

    // Alternatively - use the following artifact without an Android dependency.
    dependencies {
        implementation("androidx.datastore:datastore-preferences-core:1.1.7")
    }

Proto DataStore

Groovy

    // Typed DataStore (Typed API surface, such as Proto)
    dependencies {
        implementation "androidx.datastore:datastore:1.1.7"

        // optional - RxJava2 support
        implementation "androidx.datastore:datastore-rxjava2:1.1.7"

        // optional - RxJava3 support
        implementation "androidx.datastore:datastore-rxjava3:1.1.7"
    }

    // Alternatively - use the following artifact without an Android dependency.
    dependencies {
        implementation "androidx.datastore:datastore-core:1.1.7"
    }

Kotlin

    // Typed DataStore (Typed API surface, such as Proto)
    dependencies {
        implementation("androidx.datastore:datastore:1.1.7")

        // optional - RxJava2 support
        implementation("androidx.datastore:datastore-rxjava2:1.1.7")

        // optional - RxJava3 support
        implementation("androidx.datastore:datastore-rxjava3:1.1.7")
    }

    // Alternatively - use the following artifact without an Android dependency.
    dependencies {
        implementation("androidx.datastore:datastore-core:1.1.7")
    }

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di crearne uno nuovo, 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.

Creare un nuovo problema

Per ulteriori informazioni, consulta la documentazione del Tracker dei problemi.

Versione 1.2

Versione 1.2.0-alpha02

7 maggio 2025

androidx.datastore:datastore-*:1.2.0-alpha02 viene rilasciato. La versione 1.2.0-alpha02 contiene questi commit.

Modifiche all'API

  • È stato aggiunto il supporto multiprocesso in GuavaDataStore. (e0d608a).
  • È stato aggiunto un metodo di assistenza per creare un GuavaDataStore da un DataStore. (9af26f4)
  • I progetti rilasciati con Kotlin 2.0 richiedono KGP 2.0.0 o versioni successive per essere utilizzati. (Idb6b5)
  • Sostituisci l'overload datastore esistente con un metodo delegato per inizializzare un DataStore da utilizzare durante l'avvio diretto. (If71b9)

Versione 1.2.0-alpha01

26 marzo 2025

androidx.datastore:datastore-*:1.2.0-alpha01 viene rilasciato. La versione 1.2.0-alpha01 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto il modulo datastore-guava per esporre API compatibili con gli utenti di Java e Guava ListenableFuture tramite GuavaDataStore. (Iadd5e0)
  • L'utilizzo di DataStore durante la modalità DirectBoot è ora supportato. Per creare un data store da utilizzare durante la modalità di avvio diretto, devi crearlo all'interno dello spazio di archiviazione protetto del dispositivo. Questo risultato può essere ottenuto utilizzando le seguenti nuove API DataStore: createInDeviceProtectedStorage() in DataStoreFactory e deviceProtectedDataStore() in DataStoreDelegate. (Ib90e56)

Modifiche all'API

  • È stato aggiunto PreferencesFileSerializer che implementa l'interfaccia androidx.datastore.core.Serializer per l'utilizzo con FileStorage. (I4c71f3)

Correzioni di bug

  • È stato risolto il problema FileNotFoundException in OkioStorage all'avvio aggiungendo un secondo tentativo di lettura dei dati in caso di condizione di gara. (I43b3fb, b/337870543)
  • È stato definito il costruttore predefinito per ReplaceFileCorruptionHandler per l'utilizzo comune del codice. (I795b05, b/358138957)

Versione 1.1

Versione 1.1.7

20 maggio 2025

androidx.datastore:datastore-*:1.1.7 viene rilasciato. La versione 1.1.7 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema relativo alle regole Proguard mancanti nell'artifact Android di datastore-preferences-core. (3f3f6e, b/413078297)

Versione 1.1.6

7 maggio 2025

androidx.datastore:datastore-*:1.1.6 viene rilasciato. La versione 1.1.6 contiene questi commit.

Correzioni di bug

  • È stato risolto un problema relativo alla mancata elaborazione dei metadati di Gradle nella versione 1.1.5. Questo problema è stato causato da un bug nel nuovo DSL del plug-in KMP di AGP che impediva l'inclusione automatica dei metadati per tutte le piattaforme di destinazione. Il bug fa sì che alcuni metodi Android di DataStore non siano più visibili nelle build dei client. La correzione prevede l'utilizzo del DSL android precedente in build.gradle anziché in androidLibrary. (7801abf)

Versione 1.1.5

23 aprile 2025

androidx.datastore:datastore-*:1.1.5 viene rilasciato. La versione 1.1.5 contiene questi commit.

Correzioni di bug

  • Per ridurre i problemi relativi a CorruptionException in PreferencesDataStore, lo spazio di archiviazione predefinito è stato modificato da OkioStorage a FileStorage. Questa modifica è stata implementata introducendo un PreferencesFileSerializer. b/346197747

Versione 1.1.4

26 marzo 2025

androidx.datastore:datastore-*:1.1.4 viene rilasciato. La versione 1.1.4 contiene questi commit.

Correzioni di bug

  • Sostituisci lo spazio di archiviazione predefinito da OkioStorage a FileStorage per migliorare l'affidabilità riducendo CorruptionException. (I71181, b/346197747)

Versione 1.1.3

26 febbraio 2025

androidx.datastore:datastore-*:1.1.3 viene rilasciato. La versione 1.1.3 contiene questi commit.

Correzioni di bug

  • È stato risolto un problema di FileNotFoundException in OkioStorage riscontrato all'avvio dell'app. Se il tentativo iniziale di lettura del file non va a buon fine, verrà effettuato un secondo tentativo nel caso in cui si sia verificata una condizione di gara a causa della creazione del file da parte di un processo diverso durante la lettura iniziale. (I43b3f, b/337870543)

Versione 1.1.2

15 gennaio 2025

androidx.datastore:datastore-*:1.1.2 viene rilasciato. La versione 1.1.2 contiene questi commit.

Correzioni di bug

  • Migliora la latenza di lettura a caldo (DataStore.data.first()) di otto volte. (22b8a40)
  • ReplaceFileCorruptionHandler può essere creato dal codice comune KMP. (7632e839)

Versione 1.1.1

1° maggio 2024

androidx.datastore:datastore-*:1.1.1 viene rilasciato. La versione 1.1.1 contiene questi commit.

Correzioni di bug

  • È stato mitigato il falso allarme Linux relativo all'errore "Si verificherebbe un deadlock della risorsa" in un caso limite in cui più istanze di DataStore tentano di scrivere da processi diversi facendo indietreggiare il blocco del file.

Versione 1.1.0

17 aprile 2024

androidx.datastore:datastore-*:1.1.0 viene rilasciato. La versione 1.1.0 contiene questi commit.

Modifiche principali dalla versione 1.0.0

Per ulteriori informazioni, consulta le note di rilascio delle versioni alpha e beta di 1.1.0. Ecco alcuni dei principali aggiornamenti della versione 1.1.0:

  • DataStore ora supporta più processi che accedono allo stesso file, con il supporto dell'osservabilità tra i processi.
  • La nuova interfaccia di archiviazione ti consente di personalizzare la modalità di archiviazione o serializzazione dei modelli di dati.
  • Ora puoi utilizzare DataStore nei progetti Kotlin multipiattaforma.

Versione 1.1.0-rc01

3 aprile 2024

androidx.datastore:datastore-*:1.1.0-rc01 viene rilasciato. La versione 1.1.0-rc01 contiene questi commit.

Correzioni di bug

  • È stato corretto il degrado delle prestazioni in cui le chiamate updateData non erano ottimizzate per le scritture su disco se i nuovi dati erano uguali a quelli vecchi (d64cfb5)
  • È stata corretta una condizione di gara in cui MultiProcess DataStore potrebbe non rilevare le invalidazioni durante l'inizializzazione. ((b/326141553),(094c2dd))

Versione 1.1.0-beta02

6 marzo 2024

androidx.datastore:datastore-*:1.1.0-beta02 viene rilasciato. La versione 1.1.0-beta02 contiene questi commit.

Correzioni di bug

  • Il miglioramento del rendimento su DataStore raccoglie le notifiche di aggiornamento solo quando viene osservato. (b/267792241)
    • Tieni presente che questa modifica potrebbe attivare UncompletedCoroutinesError nei test se utilizzi la libreria di test delle coroutine. Per evitare questo problema, assicurati di passare TestScope.backgroundScope durante l'inizializzazione di DataStore nei test.
  • ​È stato risolto il problema relativo al deadlock delle chiamate updateData nidificate nella stessa istanza. (b/241760537)
  • DataStore non genera più IOExceptions se non riesce a eliminare SharedPreferences durante la migrazione. (b/195553816)
  • È stato risolto il problema per cui la ridenominazione dei file non riesce durante updateData in ambienti JVM non Android. (b/203087070)
  • È stato risolto il problema per cui CorruptionException non viene gestito dopo l'inizializzazione di DataStore. (b/289582516)

Versione 1.1.0-beta01

10 gennaio 2024

androidx.datastore:datastore-*:1.1.0-beta01 viene rilasciato senza modifiche dal giorno 1.1.0-alpha07. La versione 1.1.0-beta01 contiene questi commit.

Versione 1.1.0-alpha07

29 novembre 2023

androidx.datastore:datastore-*:1.1.0-alpha07 viene rilasciato. La versione 1.1.0-alpha07 contiene questi commit.

Modifiche all'API

  • I metodi MultiProcessDataStoreFactory non sono più sperimentali.L'annotazione @ExperimentalMultiProcessDataStore è stata rimossa completamente. (Ieee54, I8e607)

Correzioni di bug

  • Implementazione della rimozione delle annotazioni @ExperimentalMultiProcessDataStore nella versione 1.1.0-alpha07. (I8e607)

Versione 1.1.0-alpha06

1° novembre 2023

androidx.datastore:datastore-*:1.1.0-alpha06 viene rilasciato. La versione 1.1.0-alpha06 contiene questi commit.

Modifiche all'API

  • Il metodo di fabbrica createSingleProcessCoordinator ora riceve un percorso file (String, java.io.File e okio.Path) per essere coerente con createMultiProcessCoordinator. (I211c8, b/305755935)

Versione 1.1.0-alpha05

6 settembre 2023

androidx.datastore:datastore-*:1.1.0-alpha05 viene rilasciato. La versione 1.1.0-alpha05 contiene questi commit.

Modifiche all'API

  • Il datastore FileStorage è ora disponibile pubblicamente, quindi i client possono fornire parametri personalizzati. (Icb985)
  • È stato modificato il costruttore OkioStorage in modo che accetti un InterProcessCoordinator in modo da poter essere utilizzato su Android con MultiProcessCoordinator. (Iecea3)

Correzioni di bug

  • Correzione del problema MultiProcessCoordinator: impossibile monitorare più file nella stessa directory.
  • È stato corretto il problema di rilevamento dei file duplicati se i percorsi dei file non sono normalizzati.
  • Correggi i valori errati restituiti da RxDataStore#isDisposed.
  • Correggi la configurazione di ProGuard mancante per l'artefatto datstore-preferences-core.

Versione 1.1.0-alpha04

5 aprile 2023

androidx.datastore:datastore-*:1.1.0-alpha04 viene rilasciato. La versione 1.1.0-alpha04 contiene questi commit.

Correzioni di bug

  • Migliora l'implementazione interna per evitare una condizione di gara in cui il flusso di dati di DataStore potrebbe emettere un valore precedente dopo un aggiornamento.

Versione 1.1.0-alpha03

24 marzo 2023

androidx.datastore:datastore-*:1.1.0-alpha03 viene rilasciato.

Correzioni di bug

  • Sono stati rimossi i vincoli di dipendenza dagli elementi Maven per aggirare un problema di compilazione nei target Kotlin Native (b/274786186, KT-57531).

Versione 1.1.0-alpha02

22 marzo 2023

androidx.datastore:datastore-*:1.1.0-alpha02 viene rilasciato. La versione 1.1.0-alpha02 contiene questi commit.

Note

Tieni presente che questa versione include un importante refactoring interno che unisce le implementazioni per DataStore a processo singolo e multi processo. Tieni d'occhio eventuali modifiche indesiderate del comportamento (ad es. i tempi di notifica degli aggiornamenti). Puoi utilizzare il componente Tracker dei problemi per segnalare queste modifiche.

Nuove funzionalità

  • Ora puoi utilizzare DataStore nei progetti KMM. Tieni presente che i target non Android di DataStore sono ancora sperimentali, ma abbiamo deciso di unire le versioni per semplificarne la prova da parte degli sviluppatori.
  • Le funzionalità di più processi vengono spostate da androidx.datastore.multiprocess a androidx.datastore.core.
  • Aggiungi un nuovo metodo di fabbrica in androidx.datastore.core.MultiProcessDataStoreFactory per creare istanze Datastore con oggetti Storage per le operazioni sui file.
  • Aggiungi una nuova interfaccia InterProcessCoordinator che consente a più istanze DataStore di comunicare tra i processi. Tieni presente che l'implementazione multiprocesso di InterProcessCoordinator è disponibile solo su Android.

Modifiche all'API

  • Aggiungere InterProcessCoordinator a StorageConnection nell'interfaccia datastore-core (I555bb)
  • Modifica le API in datastore-core MultiProcessDataStoreFactory per utilizzare Storage. (Iac02f)
  • Spostare le API pubbliche in datastore-multiprocess in datastore-core (I76d7c)
  • PreferencesSerializer esposto da datastore-preferences-core (I4b788)
  • Aggiunta di un'annotazione @JvmDefaultWithCompatibility (I8f206)

Versione 1.1.0-alpha01

9 novembre 2022

androidx.datastore:datastore-*:1.1.0-alpha01 viene rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Supporta i casi d'uso multiprocesso in cui la coerenza dei dati è garantita tra le istanze DataStore in tutti i processi. Aggiungi MultiProcessDataStoreFactory#create per creare queste istanze DataStore.
  • Nuova interfaccia di archiviazione che consente di sostituire il meccanismo di archiviazione sottostante per Datastore. Sono fornite implementazioni per java.io e okio. Le fabbriche DataStore hanno nuovi metodi che accettano questo oggetto Storage.

Modifiche all'API

  • Modifica le API in datastore-core MultiProcessDataStoreFactory per utilizzare Storage. (Iac02f)
  • Spostare le API pubbliche in datastore-multiprocess in datastore-core (I76d7c)
  • PreferencesSerializer esposto da datastore-preferences-core (I4b788)

Versione 1.0.0

Versione 1.0.0

4 agosto 2021

androidx.datastore:datastore-*:1.0.0 viene rilasciato. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

Jetpack DataStore è una soluzione di archiviazione dei dati che ti consente di archiviare coppie chiave/valore o oggetti con tipi con buffer di protocollo. DataStore utilizza le coroutine Kotlin e Flow per archiviare i dati in modo asincrono, coerente e transazionale.

Versione 1.0.0-rc02

21 luglio 2021

androidx.datastore:datastore-*:1.0.0-rc02 viene rilasciato. La versione 1.0.0-rc02 contiene questi commit.

Correzioni di bug

  • Chiarire che SharedPreferencesMigration non viene eseguito se non sono presenti chiavi. (Icfa32, b/192824325)
  • È stato corretto un bug per cui SharedPreferencesMigration creato con MIGRATE_ALL_KEYS generava un'eccezione se la chiave richiesta non esisteva ancora. (Ie318a, b/192824325)

Versione 1.0.0-rc01

30 giugno 2021

androidx.datastore:datastore-*:1.0.0-rc01 viene rilasciato. La versione 1.0.0-rc01 contiene questi commit.

Correzioni di bug

  • Corregge il bug in cui il file .java è stato aggiunto inavvertitamente al file jar finale (I65d96, b/188985637)

Versione 1.0.0-beta02

16 giugno 2021

androidx.datastore:datastore-*:1.0.0-beta02 viene rilasciato. La versione 1.0.0-beta02 contiene questi commit.

Correzioni di bug

Versione 1.0.0-beta01

21 aprile 2021

androidx.datastore:datastore-*:1.0.0-beta01 viene rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Modifiche all'API

  • Rimuovere le sovraccariche JVM per i metodi solo kotlin (I2adc7)

Correzioni di bug

  • È stato corretto un bug per cui i delegati del datastore potevano causare perdite di contesto (Ie96fc, b/184415662)

Versione 1.0.0-alpha08

10 marzo 2021

androidx.datastore:datastore-*:1.0.0-alpha08 viene rilasciato. La versione 1.0.0-alpha08 contiene questi commit.

Modifiche all'API

  • Ora puoi aggiungere una migrazione che dipende dal contesto al tuo proprietario della proprietà dataStore e preferencesDataStore. (I4ef69, b/173726702)
  • Aggiunge funzioni di assistenza per ottenere il nome del file se non utilizzi più il delegato del datastore o context.createDataStore (I60f9a)
  • writeTo e readFrom di Serializer sono ora in sospensione. Se hai implementato un serializzatore, dovrai aggiornare le funzioni in modo che siano funzioni di sospensione. (I1e58e)
  • Sono stati aggiunti delegati della proprietà per gli utenti di RxDataStore. (Ied768, b/173726702)

Correzioni di bug

  • Applicare limitazioni all'utilizzo pubblico delle API sperimentali (I6aa29, b/174531520)

Versione 1.0.0-alpha07

24 febbraio 2021

androidx.datastore:datastore-*:1.0.0-alpha07 viene rilasciato. La versione 1.0.0-alpha07 contiene questi commit.

Modifiche all'API

  • La funzione di estensione Context.createDataStore è stata rimossa e sostituita dal delegato della proprietà globalDataStore. Chiama globalDataStore una volta a livello superiore nel file kotlin. Ad esempio:

    val Context.myDataStore by dataStore(...)

    Inserisci questo codice al livello superiore del file kotlin in modo che ne esista una sola istanza. (I57215, b/173726702)

  • Le funzioni RxDataStore ora si trovano in una classe RxDataStore anziché in funzioni di estensione su DataStore. (Idccdb, b/177691248)

  • Se vuoi eseguire la migrazione di EncryptedSharedPreferences (o SharedPreferences di avvio diretto) in DataStore, ora puoi farlo con il nuovo costruttore SharedPreferencesMigration che ti consente di iniettare SharedPreferences. (I8e04e, b/177278510)

Correzioni di bug

  • Ora DataStore genera un'eccezione se sono presenti più DataStore attivi per lo stesso file. Se non gestivi Datastore come un singleton o non garantivi che non siano attive contemporaneamente due istanze di Datastore per un file, ora potresti visualizzare eccezioni durante la lettura o la scrittura in Datastore. Questi problemi possono essere risolti gestendo il DataStore come un singleton. (Ib43f4, b/177691248)
  • Correggere il comportamento di annullamento quando l'ambito dell'autore della chiamata viene annullato. (I2c7b3)

Versione 1.0.0-alpha06

13 gennaio 2021

androidx.datastore:datastore-*:1.0.0-alpha06 viene rilasciato. La versione 1.0.0-alpha06 contiene questi commit.

Nuove funzionalità

  • Sono stati aggiunti wrapper RxJava per DataStore. Gli elementi datastore-rxjava2/3 contengono i wrapper per le API DataStore di base (RxDataStore, RxDataStoreBuilder e RxDataMigration). Gli elementi datastore-preferences-rxjava2/3 contengono un generatore per creare un DataStore delle preferenze.

Modifiche all'API

  • Nascondere l'interfaccia CorruptionHandler. Non c'era motivo che fosse pubblico perché la fabbrica DataStore accetta solo un ReplaceFileCorruptionHandler. (I0b3b3, b/176032264)
  • Il metodo preferencesKey<T>(name: String): Key<T> è stato rimosso e sostituito con metodi specifici per ogni tipo supportato, ad esempio preferencesKey<Int>("int") ora è intPreferencesKey("int") (Ibcfac, b/170311106)

Correzioni di bug

  • Corregge la documentazione su DataStoreFactory, che non menziona il fatto che il file del datastore viene creato nella sottodirectory "datastore/". (Ica222)

Versione 1.0.0-alpha05

2 dicembre 2020

androidx.datastore:datastore-*:1.0.0-alpha05 viene rilasciato. La versione 1.0.0-alpha05 contiene questi commit.

Correzioni di bug

  • Aggiunta di una documentazione migliore ed eccezioni relative alle scritture simultanee dai datastore. (Ia98a2, b/173522155, b/173726702)
  • Ora consentiamo (ma non lo richiediamo) la chiusura dell'OutputStream passato a Serializer.writeTo(). (I5c9bf, b/173037611)

Versione 1.0.0-alpha04

17 novembre 2020

androidx.datastore:datastore-*:1.0.0-alpha04 viene rilasciato. La versione 1.0.0-alpha04 contiene questi commit.

Correzioni di bug

  • È stato risolto un problema di imballaggio che causa il seguente arresto anomalo in Preference Datastore 1.0.0-alpha03: java.lang.NoClassDefFoundError: Failed resolution of: Landroidx/datastore/preferences

Versione 1.0.0-alpha03

11 novembre 2020

androidx.datastore:datastore-*:1.0.0-alpha03 viene rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

  • Le preferenze ora supportano i valori doppi (utile se hai bisogno di una maggiore precisione rispetto ai valori float) (I5be8f, b/169471808)

Modifiche all'API

  • È stata creata una dipendenza Kotlin pura per il datastore per consentire una compilazione più rapida. androidx.datastore:datastore-core contiene le API di base solo Kotlin e androidx.datastore:datastore contiene le API che dipendono da Android (inclusi il costruttore SharedPreferencesMigration e Context.createDataStore).(I42d75, b/168512698)
  • Suddivisione dei target per l'archivio dati delle preferenze per una compilazione Kotlin più rapida (Ia3c19)

  • Ora i serializzatori richiedono una nuova proprietà per il valore predefinito che verrà utilizzato se non sono presenti dati sul disco. In questo modo, è più facile implementare i serializzatori personalizzati, in modo che gli utenti non debbano gestire in modo speciale gli stream di input vuoti (che non vengono analizzati con JSON).

    • Ora è presente anche un controllo per verificare che lo stream di output fornito a writeTo() non sia chiuso e, se è chiuso, vengono lanciate eccezioni (I16e29).

  • Rendere interno il costruttore di SharedPreferencesView. Inizialmente era pubblica per consentire i test. I test dovrebbero invece creare una SharedPreferencesMigration e testarla. (I93891)

Correzioni di bug

  • Il parametro produceFile in DataStoreFactory e PreferenceDataStoreFactory è ora l'ultimo parametro nell'elenco, quindi ti consente di utilizzare la sintassi lambda finale di Kotlin. (Ibe7f1, b/169425442)
  • In seguito ai nuovi requisiti API espliciti per Kotlin (I5ae1e)

Problemi noti

  • Datastore delle preferenze si arresta in modo anomalo con java.lang.NoClassDefFoundError. (b/173036843)

Versione 1.0.0-alpha02

14 ottobre 2020

androidx.datastore:datastore-core:1.0.0-alpha02 e androidx.datastore:datastore-preferences:1.0.0-alpha02 vengono rilasciati. La versione 1.0.0-alpha02 contiene questi commit.

Correzioni di bug

  • È stata aggiunta una salvaguardia contro le mutazioni in datastore-core. La mutazione interrompe l'utilizzo del datastore per gli utenti che utilizzano il datastore con tipi non proto/non preferenze (I6aa84)
  • È stato aggiunto un metodo toString a Preferences.kt per semplificare il debug dello stato corrente (I96006)
  • È stata aggiunta un'eccezione per proteggersi dall'uso improprio di DataStore.Preferences (I1134d)
  • È stato corretto un bug che causava l'arresto anomalo dell'app all'avvio (I69237, b/168580258)

Versione 1.0.0-alpha01

2 settembre 2020

androidx.datastore:datastore-core:1.0.0-alpha01 e androidx.datastore:datastore-preferences:1.0.0-alpha01 vengono rilasciati. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

Jetpack DataStore è una nuova e migliorata soluzione di archiviazione dei dati che ha lo scopo di sostituire SharedPreferences. Basato su coroutine e Flow di Kotlin, DataStore offre due implementazioni diverse:

  • Proto DataStore, che ti consente di archiviare oggetti con tipi (supportati da protocolli Buffers)
  • Preferences DataStore, che memorizza coppie chiave-valore

I dati vengono archiviati in modo asincrono, coerente e transazionale, superando la maggior parte degli svantaggi di SharedPreferences.