Savedstate

Crie componentes conectáveis que salvam o estado da IU quando um processo é encerrado e o restaura quando o processo é reiniciado.
Atualização mais recente Versão estável atual Próximo candidato a lançamento Versão Beta Versão Alfa
10 de fevereiro de 2021 1.1.0 - - -

Declarar dependências

Para adicionar uma dependência ao SavedState, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários no arquivo build.gradle para seu app ou módulo:

Groovy

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

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

Kotlin

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

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

Para ver mais informações sobre dependências, consulte Adicionar dependências de compilação.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas existentes (link em inglês) nesta biblioteca antes de criar um novo. Adicione seu voto a um problema existente clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.1.0

Versão 1.1.0

10 de fevereiro de 2021

Lançamento de androidx.savedstate:savedstate:1.1.0 e androidx.savedstate:savedstate-ktx:1.1.0. A versão 1.1.0 contém essas confirmações.

Principais mudanças desde a versão 1.0.0

  • API ViewTreeSavedStateRegistryOwner: uma nova API ViewTreeSavedStateRegistryOwner.get(View) permite que você recupere o SavedStateRegistry contido de uma instância View. Você precisa fazer upgrade para a Activity 1.2.0, Fragment 1.3.0 e AppCompat 1.3.0-alpha01 ou mais recente para preencher corretamente.
  • Artefato savedstate-ktx: o novo artefato savedstate-ktx foi adicionado com uma extensão Kotlin findViewTreeSavedStateRegistryOwner() para trabalhar com ViewTreeSavedStateRegistryOwner.

Versão 1.1.0-rc01

16 de dezembro de 2020

Lançamento de androidx.savedstate:savedstate:1.1.0-rc01 e androidx.savedstate:savedstate-ktx:1.1.0-rc01, sem mudanças desde a 1.1.0-beta01. A versão 1.1.0-rc01 contém essas confirmações.

Versão 1.1.0-beta01

1º de outubro de 2020

Lançamento de androidx.savedstate:savedstate:1.1.0-beta01 e androidx.savedstate:savedstate-ktx:1.1.0-beta01, sem mudanças desde a 1.1.0-alpha01. A versão 1.0.0-beta01 contém essas confirmações (link em inglês).

Versão 1.1.0-alpha01

20 de maio de 2020

Lançamento de androidx.savedstate:savedstate:1.1.0-alpha01 e androidx.savedstate:savedstate-ktx:1.1.0-alpha01. A versão 1.1.0-alpha01 contém essas confirmações (link em inglês).

Novos recursos

  • Uma nova API ViewTreeSavedStateRegistryOwner.get(View) permite que você recupere o SavedStateRegistry cheio diante de uma instância View. É necessário fazer upgrade para Atividade 1.2.0-alpha05, Fragmento 1.3.0-alpha05 e AppCompat 1.3.0-alpha01 para preencher corretamente. (aosp/1298679).
  • O novo artefato savedstate-ktx foi adicionado com uma extensão Kotlin findViewTreeSavedStateRegistryOwner() para trabalhar com ViewTreeSavedStateRegistryOwner (aosp/1299434, link em inglês).

Versão 1.0.0

Versão 1.0.0

5 de setembro de 2019

androidx.savedstate:savedstate:1.0.0 é lançado. As confirmações incluídas nessa versão podem ser encontradas neste link (link em inglês).

Principais recursos do SavedState 1.0.0

androidx.savedstate se tornou uma versão estável. Este é um conjunto de APIs que permite aos desenvolvedores conectar componentes de plug-in no processo restore / saveInstanceState. O ponto de entrada principal da API é SavedStateRegistry, que traz uma maneira de recuperar estados salvos anteriormente usando consumeRestoredStateForKey e registrar um callback para registerSavedStateProvider para disponibilizar um estado salvo quando o sistema o solicitar.

Versão 1.0.0-rc01

2 de julho de 2019

androidx.savedstate:savedstate:1.0.0-rc01 é lançado. As confirmações incluídas nessa versão podem ser encontradas aqui (link em inglês).

Correções de bugs

  • Correção de uma regra incorreta do Proguard (b/132655499)

Versão 1.0.0-beta01

7 de maio de 2019

androidx.savedstate:savedstate:1.0.0-beta01 é lançado. As confirmações incluídas nessa versão podem ser encontradas aqui (link em inglês).

Versão 1.0.0-alpha02

13 de março de 2019

Lançamento de androidx.savedstate:savedstate:1.0.0-alpha02. androidx.savedstate:savedstate combina androidx.savedstate:savedstate-bundle e androidx.savedstate:savedstate-common em um único artefato, porque foi decidido simplificar a infraestrutura do savedstate e remover os genéricos do SavedStateRegistry. Portanto, não é necessário ter módulos diferentes.

A lista completa das confirmações inclusas nessa versão pode ser encontrada clicando aqui.

Novos recursos

  • Adição de SavedStateRegistry.runOnNextRecreaction(Class<? extends AutoRecreated> clazz ). A classe determinada será instanciada e o método AutoRecreated.onRecreated será executado quando o componente proprietário for reiniciado.

Mudanças na API

  • Genéricos removidos de SavedStateRegistry<T>.
  • AbstractSavedStateRegistry e BundlableSavedStateRegistry foram removidos. Use SavedStateRegistry.
  • BundleSavedStateRegistryOwner foi renomeado como SavedStateRegistryOwner.

Versão 1.0.0-alpha01

17 de dezembro de 2018

Essa é a primeira versão do SavedState.

Novos recursos

androidx.savedstate é um novo conjunto de APIs alfa que permite que os desenvolvedores façam o plug-in de componentes para o processo restore / saveInstanceState. O ponto de entrada principal da API é SavedStateRegistry<T>, que traz uma maneira de recuperar o savedstate anterior via consumeRestoredStateForKey e registrar um callback para registerSavedStateProvider para disponibilizar um savedstate quando o sistema o solicitar.