Savedstate

Menuliskan komponen pluggable yang menyimpan status UI saat proses berhenti, dan memulihkannya saat proses dimulai ulang.
Update Terbaru Rilis Stabil Saat Ini Kandidat Rilis Berikutnya Rilis Beta Rilis Alfa
10 Februari 2021 1.1.0 - - -

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada SavedState, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

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")
}

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Versi 1.1.0

Versi 1.1.0

10 Februari 2021

androidx.savedstate:savedstate:1.1.0 dan androidx.savedstate:savedstate-ktx:1.1.0 dirilis. Versi 1.1.0 berisi commit berikut.

Perubahan utama sejak versi 1.0.0

  • ViewTreeSavedStateRegistryOwner API: ViewTreeSavedStateRegistryOwner.get(View) API yang baru memungkinkan Anda mengambil instance View yang berisi SavedStateRegistry. Anda harus melakukan upgrade ke Activity 1.2.0, Fragment 1.3.0, dan AppCompat 1.3.0-alpha01 atau yang lebih tinggi untuk mengisi ini dengan benar.
  • Artefak savedstate-ktx: Artefak savedstate-ktx baru telah ditambahkan dengan ekstensi Kotlin findViewTreeSavedStateRegistryOwner() untuk digunakan dengan ViewTreeSavedStateRegistryOwner.

Versi 1.1.0-rc01

16 Desember 2020

androidx.savedstate:savedstate:1.1.0-rc01 dan androidx.savedstate:savedstate-ktx:1.1.0-rc01 dirilis tanpa perubahan sejak 1.1.0-beta01. Versi 1.1.0-rc01 berisi commit berikut.

Versi 1.1.0-beta01

1 Oktober 2020

androidx.savedstate:savedstate:1.1.0-beta01 dan androidx.savedstate:savedstate-ktx:1.1.0-beta01 dirilis tanpa perubahan sejak 1.1.0-alpha01. Versi 1.0.0-beta01 berisi commit berikut.

Versi 1.1.0-alpha01

20 Mei 2020

androidx.savedstate:savedstate:1.1.0-alpha01 dan androidx.savedstate:savedstate-ktx:1.1.0-alpha01 dirilis. Versi 1.1.0-alpha01 berisi commit berikut.

Fitur Baru

  • ViewTreeSavedStateRegistryOwner.get(View) API yang baru memungkinkan Anda mengambil instance View berisi SavedStateRegistry. Anda harus melakukan upgrade ke Activity 1.2.0-alpha05, Fragment 1.3.0-alpha05, dan AppCompat 1.3.0-alpha01 untuk mengisi ini dengan benar. (aosp/1298679)
  • Artefak savedstate-ktx baru telah ditambahkan dengan ekstensi Kotlin findViewTreeSavedStateRegistryOwner() untuk digunakan dengan ViewTreeSavedStateRegistryOwner. (aosp/1299434)

Versi 1.0.0

Versi 1.0.0

5 September 2019

androidx.savedstate:savedstate:1.0.0 dirilis. Commit yang disertakan dalam versi ini dapat dilihat di sini.

Fitur utama SavedState 1.0.0

androidx.savedstate lulus ke rilis stabil. Ini adalah sekumpulan API yang memungkinkan developer memasukkan komponen ke proses restore/saveInstanceState. Titik masuk utama API ini adalah SavedStateRegistry, yang menyediakan cara untuk mengambil status yang telah disimpan sebelumnya menggunakan consumeRestoredStateForKey dan mendaftarkan callback ke registerSavedStateProvider untuk memberikan status tersimpan saat sistem memintanya.

Versi 1.0.0-rc01

2 Juli 2019

androidx.savedstate:savedstate:1.0.0-rc01 dirilis. Commit yang disertakan dalam versi ini dapat dilihat di sini.

Perbaikan bug

  • Memperbaiki aturan proguard yang salah. (b/132655499)

Versi 1.0.0-beta01

7 Mei 2019

androidx.savedstate:savedstate:1.0.0-beta01 dirilis. Commit yang disertakan dalam versi ini dapat dilihat di sini.

Versi 1.0.0-alpha02

13 Maret 2019

androidx.savedstate:savedstate:1.0.0-alpha02 dirilis. androidx.savedstate:savedstate menggabungkan artefak androidx.savedstate:savedstate-bundle dan androidx.savedstate:savedstate-common menjadi satu artefak, karena perlunya menyederhanakan infrastruktur savedstate dan menghapus generik dari SavedStateRegistry. Dengan demikian, modul terpisah tidak diperlukan.

Daftar lengkap commit yang disertakan dalam versi ini dapat ditemukan di sini.

Fitur baru

  • SavedStateRegistry.runOnNextRecreaction(Class<? extends AutoRecreated> clazz ) ditambahkan. Instance class yang ditentukan akan dibuat dan metode AutoRecreated.onRecreated akan dijalankan saat komponen yang memilikinya dimulai ulang.

Perubahan API

  • Generik dihapus dari SavedStateRegistry<T>
  • AbstractSavedStateRegistry & BundlableSavedStateRegistry dihapus, sebagai gantinya, gunakan SavedStateRegistry sederhana
  • BundleSavedStateRegistryOwner diganti nama menjadi SavedStateRegistryOwner

Versi 1.0.0-alpha01

17 Desember 2018

Ini adalah rilis pertama SavedState.

Fitur baru

androidx.savedstate adalah sekumpulan API alfa baru yang memungkinkan developer memasukkan komponen ke proses restore/saveInstanceState. Titik masuk utama API ini adalah SavedStateRegistry<T>, yang menyediakan cara untuk mengambil savedstate sebelumnya menggunakan consumeRestoredStateForKey dan mendaftarkan callback ke registerSavedStateProvider untuk memberikan savedstate saat sistem memintanya.