Savedstate

Écrivez des composants enfichables qui enregistrent l'état de l'interface utilisateur à la fin d'un processus, puis restaurez-les au redémarrage du processus.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
18 novembre 2026 1.5.0 - - 1.6.0-alpha06

Déclarer des dépendances

Pour ajouter une dépendance sur SavedState, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

Groovy

dependencies {
    // Java language implementation
    implementation "androidx.savedstate:savedstate:1.5.0"

    // Kotlin
    implementation "androidx.savedstate:savedstate-ktx:1.5.0"
}

Kotlin

dependencies {
    // Java language implementation
    implementation("androidx.savedstate:savedstate:1.5.0")

    // Kotlin
    implementation("androidx.savedstate:savedstate-ktx:1.5.0")
}

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Version 1.6

Version 1.6.0-alpha06

18 novembre 2026

Publication d'androidx.savedstate:savedstate-*:1.6.0-alpha06. Liste des commits de la version 1.6.0-alpha06

Modifications apportées à l'API

  • Migrez LocalSavedStateRegistryOwner pour utiliser compositionLocalWithHostDefaultOf et SavedStateRegistryOwnerHostDefaultKey en le détachant de la récupération directe dans l'arborescence de vues en dehors d'Android. (I6768f)

Version 1.6.0-alpha05

21 octobre 2026

Publication d'androidx.savedstate:savedstate-*:1.6.0-alpha05. Liste des commits de la version 1.6.0-alpha05

Modifications apportées à l'API

  • Introduction d'une nouvelle API SavedStateContainer servant de base d'implémentation commune pour SaveableStateRegistry, SavedStateHandle et SavedStateRegisty. (I1da6d)
  • Ajout de asContainer() et getOrCreateContainer() à SavedStateRegistry pour permettre la création de conteneurs enfants à partir d'un SavedStateRegistry. (Icb709)

Version 1.6.0-alpha04

23 septembre 2026

Publication d'androidx.savedstate:savedstate-*:1.6.0-alpha04. Liste des commits de la version 1.6.0-alpha04

Correction de bugs

  • La dépendance androidx.lifecycle:lifecycle-runtime a été mise à jour vers la version 2.10.0. Cette version est requise pour que les vérifications lint de l'environnement d'exécution du cycle de vie groupé s'exécutent avec AGP 9.5.0-alpha04 ou une version ultérieure. (I99bfd, b/556807521)

Version 1.6.0-alpha03

9 septembre 2026

Publication d'androidx.savedstate:savedstate-*:1.6.0-alpha03. Liste des commits de la version 1.6.0-alpha03

Modifications apportées à l'API

  • Autorisation d'un état initial nul dans le constructeur SavedStateRegistry. (I76006)

Version 1.6.0-alpha02

26 août 2026

Publication d'androidx.savedstate:savedstate-*:1.6.0-alpha02. Liste des commits de la version 1.6.0-alpha02

Modifications apportées à l'API

  • Ajout de constructeurs publics à SavedStateRegistry et implémentation de SavedStateProvider et SavedStateRestorer par SavedStateRegistry. (I3c696)
  • Ajout de l'interface SavedStateProvider de premier niveau. (I20f9d)
  • Ajout de l'interface SavedStateRestorer de premier niveau avec restoreState(savedState: SavedState?) et suppression de l'interface SavedStateRegistry.SavedStateConsumer non publiée. (Idc01d)
  • Abandon de AutoRecreated et de runOnNextRecreation, remplacées par SavedStateProvider et SavedStateRestorer. (Iadc00)
  • Introduction de l'interface SavedStateConsumer sur SavedStateRegistry. Permet aux fournisseurs enregistrés de recevoir et d'utiliser automatiquement l'état restauré lors de la restauration, ou immédiatement après l'enregistrement si l'état est déjà restauré. (I9a378)

Version 1.6.0-alpha01

12 août 2026

Publication d'androidx.savedstate:savedstate-*:1.6.0-alpha01. Liste des commits de la version 1.6.0-alpha01

Correction de bugs

  • Nécessite Compose UI 1.8.0 ou version ultérieure pour utiliser LocalSavedStateRegistryOwner. Cela supprime les solutions de remplacement de réflexion interne, ce qui améliore les performances, mais impose une mise à niveau stricte des dépendances pour les clients. (I16fb0)

Version 1.5

Version 1.5.0

19 mai 2026

Publication d'androidx.savedstate:savedstate-*:1.5.0. Liste des commits de la version 1.5.0

Changements importants depuis la version 1.4.0 :

  • Activez la sérialisation générique pour les objets SavedState, ce qui permet de les encoder et de les décoder à l'aide de formats standards tels que CBOR ou JSON sur toutes les plates-formes. (Iafda4, b/425919375)
  • Ajout des fonctions d'extension putKotlinSerializable et getKotlinSerializable à SavedStateWriter et SavedStateReader pour permettre le stockage et la récupération directs d'objets Kotlin sérialisables à l'aide de clés, ce qui simplifie l'intégration aux API SavedState. (Iba02e)
  • Ajout de fonctions de fabrique pour LifecycleOwner, ViewModelStoreOwner et SavedStateRegistryOwner afin de réduire le code récurrent lors de la composition de composants propriétaires personnalisés. (I9682c)
  • Activez l'enregistrement et la restauration de SnapshotStateSet (créé via mutableStateSetOf()) avec rememberSerializable. Vous pouvez désormais utiliser SnapshotStateSet dans rememberSerializable sans avoir besoin d'un économiseur personnalisé. (I9a4ed, b/449498367)

Version 1.5.0-rc01

6 mai 2026

Publication d'androidx.savedstate:savedstate-*:1.5.0-rc01. Liste des commits de la version 1.5.0-rc01

Version 1.5.0-beta01

22 avril 2026

Publication d'androidx.savedstate:savedstate-*:1.5.0-beta01. La version 1.5.0-beta01 contient ces commits.

Version 1.5.0-alpha02

25 mars 2026

Publication d'androidx.savedstate:savedstate-*:1.5.0-alpha02. Liste des commits de la version 1.5.0-alpha02

Version 1.5.0-alpha01

11 mars 2026

Publication d'androidx.savedstate:savedstate-*:1.5.0-alpha01. Liste des commits de la version 1.5.0-alpha01

Nouvelles fonctionnalités

  • Activez la sérialisation générique pour les objets SavedState, ce qui permet de les encoder et de les décoder à l'aide de formats standards tels que CBOR ou JSON sur toutes les plates-formes. (Iafda4, b/425919375)

Modifications apportées à l'API

  • Ajout des fonctions d'extension putKotlinSerializable et getKotlinSerializable à SavedStateWriter et SavedStateReader pour permettre le stockage et la récupération directs d'objets Kotlin sérialisables à l'aide de clés, ce qui simplifie l'intégration aux API SavedState. (Iba02e)
  • Ajout de fonctions de fabrique pour LifecycleOwner, ViewModelStoreOwner et SavedStateRegistryOwner afin de réduire le code récurrent lors de la composition de composants propriétaires personnalisés. (I9682c)
  • Activez l'enregistrement et la restauration de SnapshotStateSet (créé via mutableStateSetOf()) avec rememberSerializable. Vous pouvez désormais utiliser SnapshotStateSet dans rememberSerializable sans avoir besoin d'un économiseur personnalisé. (I9a4ed, b/449498367)

Version 1.4

Version 1.4.0

5 novembre 2025

Publication d'androidx.savedstate:savedstate-*:1.4.0. Liste des commits de la version 1.4.0

Version 1.4.0-rc01

22 octobre 2025

androidx.savedstate:savedstate-*:1.4.0-rc01 est publié sans modification depuis la version 1.4.0-beta01. Liste des commits de la version 1.4.0-rc01

Version 1.4.0-beta01

8 octobre 2025

Publication d'androidx.savedstate:savedstate-*:1.4.0-beta01 sans modification notable par rapport à la dernière version alpha. La version 1.4.0-beta01 contient ces commits.

Version 1.4.0-alpha03

27 août 2025

Publication d'androidx.savedstate:savedstate-*:1.4.0-alpha03. La version 1.4.0-alpha03 contient ces commits.

Modifications apportées à l'API

  • Ajout de la prise en charge des types pouvant être nuls dans encodeToSavedState et decodeFromSavedState. (I79062, b/439527454)
  • Mise à jour de Compose vers la version 1.9.0. (I2b9de)

Version 1.4.0-alpha02

13 août 2025

Publication d'androidx.savedstate:savedstate-*:1.4.0-alpha02. Liste des commits de la version 1.4.0-alpha02

Version 1.4.0-alpha01

30 juillet 2025

Publication d'androidx.savedstate:savedstate-*:1.4.0-alpha01. La version 1.4.0-alpha01 contient ces commits.

Modifications apportées à l'API

  • Ajout de la compatibilité native avec les types pouvant être nuls dans SavedStateRegistryOwner.saved, ce qui simplifie l'enregistrement et la restauration des propriétés pouvant être nulles. (Ia632, b/421325690)

Version 1.3

Version 1.3.3

17 septembre 2025

Publication d'androidx.savedstate:savedstate-*:1.3.3. Liste des commits de la version 1.3.3

Correction de bugs

  • Correction d'une erreur liée à l'absence d'application du plug-in du compilateur Compose, qui entraînait l'endommagement des artefacts KMP SavedState. (Id2290, b/443965665)

Version 1.3.2

27 août 2025

Publication d'androidx.savedstate:savedstate-*:1.3.2. Liste des commits de la version 1.3.2

Nouvelles fonctionnalités

  • Ajout de nouvelles cibles Kotlin Multiplatform (KMP) à l'artefact SavedState *-compose. Lifecycle est désormais compatible avec les plates-formes suivantes : JVM (Android et ordinateur), Native (Linux, iOS, watchOS, macOS, MinGW) et Web (JavaScript, WasmJS). (/Idcf26)

Version 1.3.1

16 juillet 2025

Publication d'androidx.savedstate:savedstate-*:1.3.1. Liste des commits de la version 1.3.1

Correction de bugs

  • Ajoutez toutes les cibles KMP compatibles avec les annotations aux artefacts SavedState.
  • Ajout de nouvelles cibles Kotlin Multiplatform (KMP) aux artefacts SavedState. SavedState est désormais compatible avec les plates-formes suivantes : JVM (Android et ordinateur), Native (Linux, iOS, watchOS, macOS, MinGW) et Web (JavaScript, WasmJS). Notez qu'aucune nouvelle cible KMP n'a été ajoutée aux artefacts *-compose, car cela dépend de la version stable de Compose 1.9. (I062f4).

Version 1.3.0

7 mai 2025

Publication d'androidx.savedstate:savedstate-*:1.3.0. Liste des commits de la version 1.3.0

Changements importants depuis la version 1.2.0

  • LocalSavedStateRegistryOwner a été déplacé de l'UI Compose vers le nouveau module savedstate-compose afin que ses API d'assistance basées sur Compose puissent être utilisées en dehors de l'UI Compose. Il doit toujours être utilisé avec Compose UI 1.9.0-alpha02 et les versions ultérieures, mais il est rétrocompatible et peut donc être utilisé avec toutes les versions de Compose.
  • Les extensions Kotlin savedstate-ktx ont été déplacées vers le module savedstate de base.
  • Les instances SavedStateRegistryOwner récupérées via findViewTreeSavedStateRegistryOwner peuvent désormais être résolues via des parents disjoints d'une vue, comme un ViewOverlay. Pour en savoir plus sur les parents de vues disjointes, consultez les notes de version de Core ou la documentation dans ViewTree.setViewTreeDisjointParent.

Kotlin Multiplatform

  • Le module SavedState est désormais compatible avec KMP. Les plates-formes compatibles incluent désormais les environnements de bureau Android, iOS, Linux, Mac et JVM.
  • Introduction du type opaque SavedState en tant qu'abstraction pour fournir un moyen cohérent d'enregistrer et de restaurer l'état de l'application dans KMP. Il inclut un SavedStateReader et un SavedStateWriter pour modifier l'état à enregistrer. Sur Android, SavedState est un alias de type pour Bundle, ce qui garantit la compatibilité binaire et facilite la migration des API existantes vers un ensemble de sources commun. Sur les autres plates-formes, SavedState est une instance Map<String, Any>.

      // Create a new SavedState object using the savedState DSL:
      val savedState = savedState {
        putInt("currentPage", 1)
        putString("filter", "favorites")
      }
    
      // Read from a SavedState object
      val currentPage = savedState.read { getInt("currentPage") }
    
      // Edit an existing SavedState object
      savedState.write {
        remove("currentPage")
      }
    

Compatibilité avec la sérialisation KotlinX

  • SavedState inclut désormais la compatibilité avec la sérialisation KotlinX. Vous pouvez convertir une classe annotée avec @Serializable en SavedState à l'aide des méthodes encodeToSavedState et decodeFromSavedState. Le SavedState renvoyé est un Bundle standard sur Android et peut être utilisé par n'importe quelle API qui accepte un Bundle.

    @Serializable
    data class Person(val firstName: String, val lastName: String)
    
    fun main() {
        val person = Person("John", "Doe")
        val encoded: SavedState = encodeToSavedState(person)
        val decoded: Person = decodeFromSavedState(encoded)
    }
    
  • Bien que la plupart des types (comme les types primitifs) soient directement compatibles sans aucune configuration, vous trouverez des sérialiseurs supplémentaires pouvant être utilisés avec @Serializable(with = ___:class) dans le package androidx.savedstate.serialization.serializers du module savedstate et le package androidx.savedstate.compose.serialization.serializers du module savedstate-compose.

  • Nous avons également inclus saved, un délégué de propriété différé, pour faciliter le stockage des classes @Serializable dans un SavedStateRegistryOwner (par exemple, ComponentActivity, Fragment, etc.) et pour que ces classes soient automatiquement restaurées en cas d'arrêt et de recréation du processus. Veuillez noter que le délégué saved est différé et n'appellera pas l'expression lambda init ni n'enregistrera quoi que ce soit dans SavedStateRegistry tant qu'il n'y aura pas accès.

    @Serializable
    data class Person(val firstName: String, val lastName: String)
    
    class MyActivity : ComponentActivity() {
        var person by saved { Person("John", "Doe") }
    
        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            this.person = Person("Jane", "Doe")
        }
    }
    
  • Il existe un délégué de propriété saved similaire pour SavedStateHandle ajouté dans Lifecycle 2.9.0.

Version 1.3.0-rc01

23 avril 2025

Publication d'androidx.savedstate:savedstate-*:1.3.0-rc01. Liste des commits de la version 1.3.0-rc01

Version 1.3.0-beta01

9 avril 2025

Publication d'androidx.savedstate:savedstate-*:1.3.0-beta01. La version 1.3.0-beta01 contient ces commits.

Mises à jour des dépendances

  • Cette bibliothèque cible désormais le langage Kotlin 2.0 et nécessite KGP 2.0.0 ou une version ultérieure. (Idb6b5)

Version 1.3.0-alpha11

26 mars 2025

Publication d'androidx.savedstate:savedstate-*:1.3.0-alpha11 sans aucune modification publique notable. Liste des commits de la version 1.3.0-alpha11

Version 1.3.0-alpha10

12 mars 2025

Publication d'androidx.savedstate:savedstate-*:1.3.0-alpha10. Liste des commits de la version 1.3.0-alpha10

Nouvelles fonctionnalités

  • Ajout de variantes de méthode non réifiées pour les collections get dans SavedStateReader. (I0b641, b/399820614)
  • Ajout de encodeDefaults à SavedStateConfiguration, ce qui permet de personnaliser l'encodage des propriétés avec des valeurs par défaut. (I893cc, b/395104517)
  • Ajoutez SnapshotStateMapSerializer pour prendre en charge mutableStateMapOf. (Ie6f19, b/378895074)
  • Ajoutez SnapshotStateListSerializer pour prendre en charge mutableStateListOf. (I4d888, b/378895074)
  • Ajout de méthodes alternatives getOrNull pour les variantes SavedStateReader.get. Ces méthodes effectuent un auto-boxing des valeurs primitives. (I6228c, b/399820614)

Modifications apportées à l'API

  • Suppression de getOrElse de SavedStateReader au profit de getOrNull() ?: else(). (I87317, b/399820614)
  • Suppression du modificateur inline des méthodes SavedStateReader et SavedStateWriter. (If2a02, b/399820614)
  • Suppression des sérialiseurs de listes et de tableaux intégrés spécifiques à Android de l'API publique (Ida293)
  • Remplacement de SparseParcelableArraySerializer par SparseArraySerializer (I91de8)
  • Faire en sorte que tous les SavedStateReader.get se comportent de manière cohérente en générant une exception lorsque le type de valeur ne correspond pas au type renvoyé (I78c4a, b/399317598)
  • SavedState*Delegates a été renommé SavedState*Delegate. (I8589b, b/399629301)
  • SavedStateConfig a été renommé SavedStateConfiguration. (I043a5, b/399629301)

Version 1.3.0-alpha09

26 février 2025

Publication d'androidx.savedstate:savedstate-*:1.3.0-alpha09. Liste des commits de la version 1.3.0-alpha09

Nouvelles fonctionnalités

  • Ajout d'un remplacement pour les types intégrés, afin de s'assurer que tous les types compatibles avec Bundle peuvent être utilisés avec encodeAsSavedState/decodeFromSavedState par défaut ou, pour les propriétés des classes @Serializable, via l'annotation @Contextual. (Ic01d2)
  • Incluez la prise en charge de classDiscriminator et classDiscriminatorMode sur SavedStateConfig. (I69b66, b/395104517)

Modifications apportées à l'API

  • Ajout du paramètre SavedStateConfig aux délégués saved() (I39b3a)
  • Les sérialiseurs intégrés sont désormais des objets singleton (Ifeee4).
  • Les propriétés SavedStateConfig sont désormais publiques, ce qui permet à d'autres modules d'utiliser ces configurations. (Ie5f49, b/378897438)
  • Prise en charge de @Serializer(with = ...) pour MutableStateFlowSerializer et MutableStateSerializer (I90953)
  • Ajout de contentDeepToString à SavedStateReader (I14d10).

Version 1.3.0-alpha08

12 février 2025

Publication d'androidx.savedstate:savedstate-*:1.3.0-alpha08. Liste des commits de la version 1.3.0-alpha08

Nouvelles fonctionnalités

  • Déplacement de MutableStateSerializer vers savedstate-compose depuis lifecycle-viewmodel-compose, ce qui vous permet d'utiliser les API de sérialisation SavedState avec MutableState de Compose. (I4f690, b/378895074)

Modifications apportées à l'API

  • Ajoutez une fonction de fabrique pour créer un SavedState à partir d'un SavedState existant. (I39f9a)
  • Ajout de la compatibilité avec Array<SavedState> et List<SavedState> dans androidx.savedstate. (Idd8a5)
  • Ajout du paramètre facultatif SavedStateConfig à l'encodage/au décodage SavedState (I6c4c0)

Version 1.3.0-alpha07

29 janvier 2025

Publication d'androidx.savedstate:savedstate-*:1.3.0-alpha07. La version 1.3.0-alpha07 contient ces commits.

Nouvelles fonctionnalités

  • Ajout de MutableStateFlowSerializer pour sérialiser kotlinx.coroutines.flow.MutableStateFlow. (I6a892, b/378895070)

Modifications apportées à l'API

  • Remplacement des fonctions de délégué SavedStateRegistryOwner.saved() surchargées par des paramètres par défaut (Icd1c1)
  • Rendre JavaSerializableSerializer et ParcelableSerializer abstraits (I268f6)
  • Suppression de T : CharSequence générique de CharSequenceSerializer (Ib40bd)

Version 1.3.0-alpha06

11 décembre 2024

Publication d'androidx.savedstate:savedstate-*:1.3.0-alpha06. Liste des commits de la version 1.3.0-alpha06

Nouvelles fonctionnalités

  • SavedState KMP est désormais compatible avec : IBinder, Size, SizeF, Array<Parcelable>, SparseArray<Parcelable> et Serializable (Android). (I1ba94, b/334076622)
  • Ajoutez des instances KSerializer qui peuvent être utilisées pour encoder/décoder les types Java et Android compatibles avec Bundle en marquant le champ pertinent de votre classe avec @Serializable(with = ParcelableSerializer::class). (I8c10f, I28caf, b/376026712)
  • Les instances SavedStateRegistryOwner récupérées via findViewTreeSavedStateRegistryOwner peuvent désormais être résolues via des parents disjoints d'une vue, comme un ViewOverlay. Pour en savoir plus sur les parents de vues disjointes, consultez les notes de version de Core ou la documentation dans ViewTree.setViewTreeDisjointParent. (Iccb33)

Modifications apportées à l'API

  • Amélioration de la cohérence des noms et de l'organisation des packages avec SavedStateRegistryOwnerDelegate (I8c135, b/376026744)

Version 1.3.0-alpha05

13 novembre 2024

Publication d'androidx.savedstate:savedstate-*:1.3.0-alpha05. La version 1.3.0-alpha05 contient ces commits.

Compatibilité avec la sérialisation KotlinX

  • SavedState inclut désormais la compatibilité avec la sérialisation KotlinX. Vous pouvez convertir une classe annotée avec @Serializable en SavedState à l'aide des méthodes encodeToSavedState et decodeFromSavedState. Le SavedState renvoyé est un Bundle standard sur Android et peut être utilisé par n'importe quelle API qui accepte un Bundle. (I6f59f, b/374102924)

    @Serializable
    data class Person(val firstName: String, val lastName: String)
    
    fun main() {
        val person = Person("John", "Doe")
        val encoded: SavedState = encodeToSavedState(person)
        val decoded: Person = decodeFromSavedState(encoded)
    }
    
  • Nous avons également inclus saved, un délégué de propriété différé, pour faciliter le stockage des classes @Serializable dans un SavedStateRegistryOwner (par exemple, ComponentActivity, Fragment, etc.) et pour que ces classes soient automatiquement restaurées en cas d'arrêt et de recréation du processus. Veuillez noter que le délégué saved est différé et n'appellera pas l'expression lambda init ni n'enregistrera quoi que ce soit dans SavedStateRegistry tant qu'il n'y aura pas accès. (I66739, b/376027806)

    @Serializable
    data class Person(val firstName: String, val lastName: String)
    
    class MyActivity : ComponentActivity() {
        var person by saved { Person("John", "Doe") }
    
        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            this.person = Person("Jane", "Doe")
        }
    }
    
  • Il existe un délégué de propriété saved similaire pour SavedStateHandle ajouté dans Lifecycle 2.9.0-alpha07.

Modifications apportées à l'API

  • Ajout de toMap à SavedState, ce qui permet de convertir n'importe quel SavedState en Map standard (copie superficielle). (I487b9, b/334076622)
  • SavedState KMP est désormais compatible avec les tableaux. (Ic0552, b/334076622)

Version 1.3.0-alpha04

30 octobre 2024

Publication d'androidx.savedstate:savedstate-*:1.3.0-alpha04. Liste des commits de la version 1.3.0-alpha04

Modifications apportées à l'API

  • SavedState KMP est désormais compatible avec Char. (I9ac2f, b/334076622)
  • Ajout de putNull et de isNull à SavedState KMP. (Iea71d, b/334076622)
  • Ajout de paramètres d'usine savedState supplémentaires compatibles avec un Map<String, Any> initial (I9b37d, b/334076622)
  • SavedState KMP est désormais compatible avec la comparaison contentDeepEquals. (Ia515c, b/334076622)
  • SavedState KMP est désormais compatible avec Long. (I4c180, b/334076622)

Version 1.3.0-alpha03

16 octobre 2024

Publication d'androidx.savedstate:savedstate-*:1.3.0-alpha03 sans modification notable. La version 1.3.0-alpha03 contient ces commits.

Version 1.3.0-alpha02

2 octobre 2024

Publication d'androidx.savedstate:savedstate-*:1.3.0-alpha02. Liste des commits de la version 1.3.0-alpha02

Kotlin Multiplatform

  • Le module SavedState est désormais compatible avec KMP. Les plates-formes compatibles incluent désormais les environnements de bureau Android, iOS, Linux, Mac et JVM. (I26305, b/334076622)

Nouvelles fonctionnalités

  • Introduction du type opaque SavedState en tant qu'abstraction pour fournir un moyen cohérent d'enregistrer et de restaurer l'état de l'application dans KMP. Il inclut un SavedStateReader et un SavedStateWriter pour modifier l'état à enregistrer. Sur Android, SavedState est un alias de type pour Bundle, ce qui garantit la compatibilité binaire et facilite la migration des API existantes vers un ensemble de sources commun. Sur les autres plates-formes, SavedState est une instance Map<String, Any>. (I18575, b/334076622)
  // Create a new SavedState object using the savedState DSL:
  val savedState = savedState {
    putInt("currentPage", 1)
    putString("filter", "favorites")
  }

  // Read from a SavedState object
  val currentPage = savedState.read { getInt("currentPage") }

  // Edit an existing SavedState object
  savedState.write {
    remove("currentPage")
  }

Modifications apportées à l'API

  • SavedStateRegistry et SavedStateRegistryController sont désormais compatibles avec KMP. (Id7bb8, b/334076622)
  • SavedState, SavedStateWriter et SavedStateReader sont désormais compatibles avec KMP. (I26305, b/334076622)

Version 1.3.0-alpha01

7 août 2024

Publication d'androidx.savedstate:savedstate:1.3.0-alpha01 et d'androidx.savedstate:savedstate-ktx:1.3.0-alpha01. La version 1.3.0-alpha01 contient ces commits.

Modifications apportées à l'API

  • Les extensions Kotlin savedstate-ktx ont été déplacées vers le module savedstate de base. (I1cc18, b/274803094)

Remarque

  • Mise à jour de compileSdk vers la version 35 (5dc41be)

Version 1.2.1

Version 1.2.1

22 mars 2023

Publication d'androidx.savedstate:savedstate:1.2.1 et d'androidx.savedstate:savedstate-ktx:1.2.1. Liste des commits de la version 1.2.1

Mises à jour des dépendances

Version 1.2.0

Version 1.2.0

29 juin 2022

Publication d'androidx.savedstate:savedstate:1.2.0 et androidx.savedstate:savedstate-ktx:1.2.0. Liste des commits de la version 1.2.0

Changements importants depuis la version 1.1.0

  • SavedStateRegistryController autorise désormais l'association anticipée de SavedStateRegistry via performAttach().
  • Vous pouvez maintenant récupérer un SavedStateProvider enregistré précédemment à partir d'un SavedStateRegistry via getSavedStateProvider().
  • La bibliothèque SavedState a été réécrite en Kotlin.
    • Pour SavedStateRegistryOwner, il s'agit d'une modification incompatible avec la source pour les classes écrites en Kotlin. Vous devez maintenant remplacer la propriété savedStateRegistry au lieu d'implémenter la fonction getSavedStateRegistry() précédente.
    • Pour ViewTreeSavedStateRegistryOwner, il s'agit d'une modification incompatible avec la source pour les classes écrites en Kotlin. Vous devez désormais importer et utiliser directement les méthodes d'extension Kotlin sur View de androidx.savedstate.setViewTreeSavedStateRegistryOwner et androidx.savedstate.findViewTreeSavedStateRegistryOwner pour définir et rechercher un propriétaire défini précédemment. Cette action remplace l'API savedstate-ktx de findViewTreeSavedStateRegistryOwner.

Nouveaux comportements

  • SavedStateRegistry n'enregistre plus un groupe vide s'il n'y a pas d'état à enregistrer.

Version 1.2.0-rc01

11 mai 2022

Publication d'androidx.savedstate:savedstate:1.2.0-rc01 et androidx.savedstate:savedstate-ktx:1.2.0-rc01. Liste des commits de la version 1.2.0-rc01

Modifications de la documentation

  • Les Kdocs de SavedStateRegistryOwner ont été mis à jour pour clarifier les responsabilités et le contrat du propriétaire concernant l'implémentation de l'interface ou l'appel des méthodes sur SavedStateRegistryController. (Iefc95, b/228887344)

Version 1.2.0-beta01

20 avril 2022

Publication d'androidx.savedstate:savedstate:1.2.0-beta01 et androidx.savedstate:savedstate-ktx:1.2.0-beta01. Liste des commits de la version 1.2.0-beta01

Modifications apportées à l'API

  • Les classes SavedStateRegistry et ViewTreeSavedStateRegistryOwner ont été réécrites en Kotlin. Pour ViewTreeSavedStateRegistryOwner, il s'agit d'une modification incompatible avec la source pour les classes écrites en Kotlin. Vous devez désormais importer et utiliser directement les méthodes d'extension Kotlin sur View d'androidx.savedstate.setViewTreeSavedStateRegistryOwner et androidx.savedstate.findViewTreeSavedStateRegistryOwner pour définir et rechercher un propriétaire défini précédemment. Cette action remplace l'API savedstate-ktx de findViewTreeSavedStateRegistryOwner. Cette fonctionnalité est compatible avec le binaire et reste compatible avec la source pour les implémentations écrites en langage de programmation Java. (b/220191285)

Version 1.2.0-alpha02

6 avril 2022

Publication d'androidx.savedstate:savedstate:1.2.0-alpha02 et androidx.savedstate:savedstate-ktx:1.2.0-alpha02. Liste des commits de la version 1.2.0-alpha02.

Nouvelles fonctionnalités

  • Vous pouvez maintenant récupérer un SavedStateProvider enregistré précédemment à partir d'un SavedStateRegistry via getSavedStateProvider(). (I7ea47, b/215406268)

Modifications apportées à l'API

  • Les classes SavedStateRegistryOwner, SavedStateRegistryController et Recreator ont été réécrites en Kotlin. Pour SavedStateRegistryOwner, il s'agit d'une modification incompatible avec la source pour les classes écrites en Kotlin. Vous devez maintenant remplacer la propriété savedStateRegistry au lieu d'implémenter la fonction getSavedStateRegistry() précédente. Cette fonctionnalité est compatible avec le binaire et la source pour les implémentations écrites en langage de programmation Java. (b/220191285)

Version 1.2.0-alpha01

26 janvier 2022

Publication d'androidx.savedstate:savedstate:1.2.0-alpha01 et androidx.savedstate:savedstate-ktx:1.2.0-alpha01. Liste des commits de la version 1.2.0-alpha01

Nouvelles fonctionnalités

  • SavedStateRegistryController autorise désormais l'association anticipée de SavedStateRegistry via performAttach(). (Ice4bf)

Nouveaux comportements

  • SavedStateRegistry n'enregistre plus un groupe vide s'il n'y a pas d'état à enregistrer. (aosp/1896865, b/203457956)

Version 1.1.0

Version 1.1.0

10 février 2021

Publication d'androidx.savedstate:savedstate:1.1.0 et androidx.savedstate:savedstate-ktx:1.1.0. Liste des commits de la version 1.1.0

Principales modifications depuis la version 1.0.0

  • API ViewTreeSavedStateRegistryOwner : Une nouvelle API ViewTreeSavedStateRegistryOwner.get(View) vous permet de récupérer le conteneur SavedStateRegistry en fonction d'une instance View. Vous devez passer à Activity 1.2.0, Fragment 1.3.0 et AppCompat 1.3.0-alpha01 ou version ultérieure pour renseigner correctement ce champ.
  • Artefact savedstate-ktx : le nouvel artefact savedstate-ktx a été ajouté avec une extension Kotlin findViewTreeSavedStateRegistryOwner() pour travailler avec ViewTreeSavedStateRegistryOwner.

Version 1.1.0-rc01

16 décembre 2020

Publication d'androidx.savedstate:savedstate:1.1.0-rc01 et d'androidx.savedstate:savedstate-ktx:1.1.0-rc01 sans modification par rapport à la version 1.1.0-beta01. Liste des commits de la version 1.1.0-rc01

Version 1.1.0-beta01

1er octobre 2020

Publication d'androidx.savedstate:savedstate:1.1.0-beta01 et d'androidx.savedstate:savedstate-ktx:1.1.0-beta01 sans modification par rapport à la version 1.1.0-alpha01. Liste des commits de la version 1.1.0-beta01

Version 1.1.0-alpha01

20 mai 2020

Publication d'androidx.savedstate:savedstate:1.1.0-alpha01 et androidx.savedstate:savedstate-ktx:1.1.0-alpha01. Liste des commits de la version 1.1.0-alpha01

Nouvelles fonctionnalités

  • Une nouvelle API ViewTreeSavedStateRegistryOwner.get(View) vous permet de récupérer le conteneur SavedStateRegistry en fonction d'une instance View. Vous devez passer à Activity 1.2.0-alpha05, Fragment 1.3.0-alpha05 et AppCompat 1.3.0-alpha01 pour renseigner ces éléments correctement. (aosp/1298679)
  • Le nouvel artefact savedstate-ktx a été ajouté avec une extension Kotlin findViewTreeSavedStateRegistryOwner() pour travailler avec ViewTreeSavedStateRegistryOwner. (aosp/1299434)

Version 1.0.0

Version 1.0.0

5 septembre 2019

Publication d'androidx.savedstate:savedstate:1.0.0. Les commits inclus dans cette version sont disponibles sur cette page.

Principales fonctionnalités de la version 1.0.0 de SavedState

androidx.savedstate est passé à une version stable. Il s'agit d'un ensemble d'API permettant aux développeurs d'insérer des composants dans le processus restore/saveInstanceState. Le principal point d'entrée de l'API est SavedStateRegistry, qui permet de récupérer les états précédemment enregistrés à l'aide de consumeRestoredStateForKey et d'enregistrer un rappel à registerSavedStateProvider pour fournir un état enregistré une fois que le système l'a demandé.

Version 1.0.0-rc01

2 juillet 2019

Publication d'androidx.savedstate:savedstate:1.0.0-rc01. Les commits inclus dans cette version sont disponibles sur cette page.

Correction de bugs

  • Correction d'une règle ProGuard incorrecte (b/132655499)

Version 1.0.0-beta01

7 mai 2019

Publication d'androidx.savedstate:savedstate:1.0.0-beta01. Les commits inclus dans cette version sont disponibles sur cette page.

Version 1.0.0-alpha02

13 mars 2019

Publication d'androidx.savedstate:savedstate:1.0.0-alpha02. androidx.savedstate:savedstate combine les artefacts androidx.savedstate:savedstate-bundle et androidx.savedstate:savedstate-common en un seul, car il a été décidé de simplifier l'infrastructure savedstate et de supprimer les éléments génériques de SavedStateRegistry. Il n'est donc pas nécessaire de créer des modules distincts.

La liste complète des commits inclus dans cette version est disponible sur cette page.

Nouvelles fonctionnalités

  • SavedStateRegistry.runOnNextRecreaction(Class<? extends AutoRecreated> clazz ) a été ajouté. La classe donnée sera instanciée et la méthode AutoRecreated.onRecreated sera exécutée lorsque le composant propriétaire aura redémarré.

Modifications apportées à l'API

  • Génériques supprimés de SavedStateRegistry<T>
  • Suppression d'AbstractSavedStateRegistry et de BundlableSavedStateRegistry. Utilisez simplement SavedStateRegistry à la place.
  • BundleSavedStateRegistryOwner a été renommé SavedStateRegistryOwner.

Version 1.0.0-alpha01

17 décembre 2018

Il s'agit de la première version de SavedState.

Nouvelles fonctionnalités

androidx.savedstate est un nouvel ensemble d'API alpha qui permet aux développeurs d'insérer des composants dans le processus restore/saveInstanceState. Le principal point d'entrée de l'API est SavedStateRegistry<T>, qui permet de récupérer l'état précédemment enregistré via consumeRestoredStateForKey et d'enregistrer un rappel à registerSavedStateProvider pour fournir un savedstate une fois que le système l'a demandé.