Savedstate

כתיבת רכיבים שניתן להוסיף למערכת, ששומרים את מצב ממשק המשתמש כשמתרחש כשל בתהליך, ומשחזרים אותו כשהתהליך מופעל מחדש.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫23 בספטמבר 2026 1.5.0 - - ‎1.6.0-alpha04

הצהרה על יחסי תלות

כדי להוסיף תלות ב-SavedState, צריך להוסיף את מאגר Maven של Google לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

מגניב

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

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.6

גרסה ‎1.6.0-alpha04

‫23 בספטמבר 2026

‫androidx.savedstate:savedstate-*:1.6.0-alpha04 מופץ. גרסה ‎1.6.0-alpha04 מכילה את השמירות האלה.

תיקוני באגים

  • התלות ב-androidx.lifecycle:lifecycle-runtime עודכנה ל-2.10.0. הגרסה הזו נדרשת כדי להריץ בדיקות lint של זמן ריצה של מחזור חיים בחבילה עם AGP בגרסה 9.5.0-alpha04 ואילך. (I99bfd, ‏ b/556807521)

גרסה ‎1.6.0-alpha03

‫9 בספטמבר 2026

‫androidx.savedstate:savedstate-*:1.6.0-alpha03 מופץ. גרסה ‎1.6.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

  • מותר להשתמש במצב התחלתי של null בבונה SavedStateRegistry. (I76006)

גרסה ‎1.6.0-alpha02

‫26 באוגוסט 2026

‫androidx.savedstate:savedstate-*:1.6.0-alpha02 מופץ. גרסה ‎1.6.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

  • נוספו constructors ציבוריים ל-SavedStateRegistry ו-SavedStateRegistry הוגדר כך שיטמיע את SavedStateProvider ואת SavedStateRestorer. (I3c696)
  • נוסף ממשק SavedStateProvider ברמה העליונה. (I20f9d)
  • הוספנו ממשק SavedStateRestorer ברמה העליונה עם restoreState(savedState: SavedState?) והסרנו את SavedStateRegistry.SavedStateConsumer שלא פורסם. (Idc01d)
  • האפשרויות AutoRecreated ו-runOnNextRecreation הוצאו משימוש לטובת SavedStateProvider ו-SavedStateRestorer. (Iadc00)
  • הצגת הממשק של SavedStateConsumer ב-SavedStateRegistry. מאפשר לספקים רשומים לקבל באופן אוטומטי את המצב המשוחזר ולהשתמש בו במהלך השחזור, או מיד לאחר הרישום אם המצב כבר שוחזר. (I9a378)

גרסה ‎1.6.0-alpha01

‫12 באוגוסט 2026

‫androidx.savedstate:savedstate-*:1.6.0-alpha01 מופץ. גרסה ‎1.6.0-alpha01 מכילה את השמירות האלה.

תיקוני באגים

  • כדי להשתמש ב-LocalSavedStateRegistryOwner, צריך גרסה 1.8.0 ואילך של Compose UI. הפעולה הזו מסירה חלופות פנימיות של רפלקציה, משפרת את הביצועים אבל מחייבת שדרוג קפדני של התלות עבור לקוחות. (I16fb0)

גירסה 1.5

גרסה 1.5.0

‫19 במאי 2026

‫androidx.savedstate:savedstate-*:1.5.0 מופץ. גרסה 1.5.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.4.0:

  • הפעלת סריאליזציה גנרית לאובייקטים מסוג SavedState, כדי לאפשר קידוד ופענוח שלהם באמצעות פורמטים סטנדרטיים כמו CBOR או JSON בכל הפלטפורמות. ‫(Iafda4, ‏ b/425919375)
  • הוספנו פונקציות הרחבה putKotlinSerializable ו-getKotlinSerializable ל-SavedStateWriter ול-SavedStateReader כדי לאפשר אחסון ואחזור ישירים של אובייקטים מסוג Kotlin Serializable באמצעות מפתחות, וכך לייעל את השילוב עם ממשקי SavedState API. (Iba02e)
  • הוספת פונקציות ליצירת אובייקטים עבור LifecycleOwner, ViewModelStoreOwner ו-SavedStateRegistryOwner כדי לצמצם את קוד ה-boilerplate כשיוצרים רכיבי בעלים בהתאמה אישית. (I9682c)
  • הפעלת השמירה והשחזור של SnapshotStateSet (שנוצר באמצעות mutableStateSetOf()) באמצעות rememberSerializable. עכשיו אפשר להשתמש ב-SnapshotStateSet ב-rememberSerializable בלי שנדרש שומר מסך בהתאמה אישית. ‫(I9a4ed, b/449498367)

גרסה ‎1.5.0-rc01

‫6 במאי 2026

‫androidx.savedstate:savedstate-*:1.5.0-rc01 מופץ. גרסה ‎1.5.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.5.0-beta01

‫22 באפריל 2026

‫androidx.savedstate:savedstate-*:1.5.0-beta01 מופץ. גרסה ‎1.5.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.5.0-alpha02

‫25 במרץ 2026

‫androidx.savedstate:savedstate-*:1.5.0-alpha02 מופץ. גרסה ‎1.5.0-alpha02 מכילה את השמירות האלה.

גרסה ‎1.5.0-alpha01

‫11 במרץ 2026

‫androidx.savedstate:savedstate-*:1.5.0-alpha01 מופץ. גרסה ‎1.5.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • הפעלת סריאליזציה גנרית לאובייקטים מסוג SavedState, כדי לאפשר קידוד ופענוח שלהם באמצעות פורמטים סטנדרטיים כמו CBOR או JSON בכל הפלטפורמות. ‫(Iafda4, ‏ b/425919375)

שינויים ב-API

  • הוספנו פונקציות הרחבה putKotlinSerializable ו-getKotlinSerializable ל-SavedStateWriter ול-SavedStateReader כדי לאפשר אחסון ואחזור ישירים של אובייקטים מסוג Kotlin Serializable באמצעות מפתחות, וכך לייעל את השילוב עם ממשקי API של SavedState. (Iba02e)
  • הוספת פונקציות ליצירת אובייקטים עבור LifecycleOwner, ViewModelStoreOwner ו-SavedStateRegistryOwner כדי לצמצם את קוד ה-boilerplate כשיוצרים רכיבי בעלים בהתאמה אישית. (I9682c)
  • הפעלת השמירה והשחזור של SnapshotStateSet (שנוצר באמצעות mutableStateSetOf()) באמצעות rememberSerializable. עכשיו אפשר להשתמש ב-SnapshotStateSet ב-rememberSerializable בלי שנדרש שומר מסך בהתאמה אישית. ‫(I9a4ed, ‏ b/449498367)

גרסה 1.4

גרסה 1.4.0

‫5 בנובמבר 2025

‫androidx.savedstate:savedstate-*:1.4.0 מופץ. גרסה 1.4.0 מכילה את השמירות האלה.

גרסה ‎1.4.0-rc01

‫22 באוקטובר 2025

‫androidx.savedstate:savedstate-*:1.4.0-rc01 יוצא ללא שינויים מאז גרסה 1.4.0-beta01. גרסה ‎1.4.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.4.0-beta01

‫8 באוקטובר 2025

הגרסה androidx.savedstate:savedstate-*:1.4.0-beta01 הושקה ללא שינויים משמעותיים מאז גרסת האלפא האחרונה. גרסה ‎1.4.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.4.0-alpha03

‫27 באוגוסט 2025

‫androidx.savedstate:savedstate-*:1.4.0-alpha03 מופץ. גרסה ‎1.4.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו תמיכה בסוגים שניתן להגדיר כ-nullable ב-encodeToSavedState וב-decodeFromSavedState. (I79062, ‏ b/439527454)
  • עדכון של Compose לגרסה 1.9.0. (I2b9de)

גרסה ‎1.4.0-alpha02

‫13 באוגוסט 2025

‫androidx.savedstate:savedstate-*:1.4.0-alpha02 מופץ. גרסה ‎1.4.0-alpha02 מכילה את השמירות האלה.

גרסה ‎1.4.0-alpha01

‫30 ביולי 2025

‫androidx.savedstate:savedstate-*:1.4.0-alpha01 מופץ. גרסה ‎1.4.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו תמיכה מובנית בסוגים שניתן להגדיר כ-nullable ב-SavedStateRegistryOwner.saved, כדי לפשט את השמירה והשחזור של מאפיינים שניתן להגדיר כ-nullable. ‫(Ia632, ‏ b/421325690)

גרסה 1.3

גרסה 1.3.3

‫17 בספטמבר 2025

‫androidx.savedstate:savedstate-*:1.3.3 מופץ. גרסה 1.3.3 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה שגיאה שגרמה לכך שהתוסף Compose Compiler לא הוחל, ולכן ארטיפקטים של SavedState KMP היו פגומים. (Id2290, ‏ b/443965665)

גרסה 1.3.2

‫27 באוגוסט 2025

‫androidx.savedstate:savedstate-*:1.3.2 מופץ. גרסה 1.3.2 מכילה את השמירות האלה.

תכונות חדשות

  • הוספת יעדים חדשים של Kotlin Multiplatform‏ (KMP) לארטיפקט *-compose SavedState. מעכשיו יש תמיכה במחזור החיים בפלטפורמות הבאות: JVM (Android ומחשבים), Native (Linux,‏ iOS,‏ watchOS,‏ macOS,‏ MinGW) ואינטרנט (JavaScript,‏ WasmJS). (/Idcf26)

גרסה 1.3.1

‫16 ביולי 2025

‫androidx.savedstate:savedstate-*:1.3.1 מופץ. גרסה 1.3.1 מכילה את השמירות האלה.

תיקוני באגים

  • הוספת כל יעדי ה-KMP שנתמכים על ידי הערות ל-SavedState artifacts.
  • נוספו יעדים חדשים של Kotlin Multiplatform‏ (KMP) ל-SavedState artifacts. SavedState תומך עכשיו בפלטפורמות הבאות: JVM (Android ומחשב), Native (Linux,‏ iOS,‏ watchOS,‏ macOS,‏ MinGW) ו-Web (JavaScript,‏ WasmJS). שימו לב שלא נוספו יעדי KMP חדשים לארטיפקטים של *-compose, כי זה תלוי בגרסה היציבה של Compose 1.9. ‫(I062f4).

גרסה 1.3.0

‫7 במאי 2025

‫androidx.savedstate:savedstate-*:1.3.0 מופץ. גרסה 1.3.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.2.0

  • הפונקציה LocalSavedStateRegistryOwner הועברה מממשק המשתמש של Compose למודול החדש savedstate-compose, כדי שאפשר יהיה להשתמש בממשקי העזר של ה-API שמבוססים על Compose מחוץ לממשק המשתמש של Compose. תמיד צריך להשתמש בזה כשמשתמשים ב-Compose UI 1.9.0-alpha02 ומעלה, אבל יש תאימות לאחור כך שאפשר להשתמש בזה בכל הגרסאות של Compose.
  • התוספים savedstate-ktx kotlin הועברו עכשיו למודול הבסיסי savedstate.
  • עכשיו אפשר לפתור מקרים של SavedStateRegistryOwner שאוחזרו באמצעות findViewTreeSavedStateRegistryOwner דרך הורים מנותקים של תצוגה, כמו ViewOverlay. מידע נוסף על הורים של תצוגות מנותקות מופיע בהערות הגרסה של Core או במסמכי התיעוד בכתובת ViewTree.setViewTreeDisjointParent.

‫Kotlin Multiplatform

  • מודול SavedState תואם עכשיו ל-KMP. הפלטפורמות הנתמכות כוללות עכשיו סביבות שולחן עבודה של Android,‏ iOS,‏ Linux,‏ Mac ו-JVM.

  • הוספנו את סוג הנתונים SavedState opaque כהפשטה כדי לספק דרך עקבית לשמירה ולשחזור של מצב האפליקציה ב-KMP. הוא כולל SavedStateReader וSavedStateWriter לשינוי המצב שיירשם. ב-Android, ‏ SavedState הוא כינוי סוג ל-Bundle, שמבטיח תאימות בינארית ומקל על העברת ממשקי API קיימים לקבוצת מקור משותפת. בפלטפורמות אחרות, SavedState הוא מופע של 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")
  }

תמיכה ב-KotlinX Serialization

  • ב-SavedState יש עכשיו תמיכה ב-KotlinX Serialization. אפשר להמיר מחלקה עם הערה @Serializable ל-SavedState באמצעות השיטות encodeToSavedState ו-decodeFromSavedState. הערך SavedState שמוחזר הוא Bundle רגיל ב-Android, ואפשר להשתמש בו בכל API שמקבל 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)
}

  • רוב הסוגים (כמו סוגים פרימיטיביים) נתמכים ישירות בלי צורך בהגדרה, אבל אפשר למצוא סדרות נוספות שאפשר להשתמש בהן עם @Serializable(with = ___:class) בחבילה androidx.savedstate.serialization.serializers במודול savedstate ובחבילה androidx.savedstate.compose.serialization.serializers במודול savedstate-compose.

  • הוספנו גם את saved, נציג מאפיינים עצלן, כדי לאפשר אחסון קל של מחלקות @Serializable ב-SavedStateRegistryOwner (לדוגמה, ComponentActivity,‏ Fragment וכו') ולשחזר את המחלקות האלה באופן אוטומטי אחרי שהתהליך מסתיים ונוצר מחדש. חשוב לזכור שהפונקציה saved delegate היא עצלה ולא תפעיל את פונקציית ה-lambda‏ init או תשמור משהו ב-SavedStateRegistry עד שתהיה אליה גישה.

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

  • יש נציג נכס דומה saved עבור SavedStateHandle שנוסף ב-Lifecycle 2.9.0.

גרסה ‎1.3.0-rc01

‫23 באפריל 2025

‫androidx.savedstate:savedstate-*:1.3.0-rc01 מופץ. גרסה ‎1.3.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.3.0-beta01

‫9 באפריל 2025

‫androidx.savedstate:savedstate-*:1.3.0-beta01 מופץ. גרסה ‎1.3.0-beta01 מכילה את השמירות האלה.

עדכונים של יחסי תלות

  • הספרייה הזו מטרגטת עכשיו את רמת השפה Kotlin 2.0 ונדרשת KGP 2.0.0 או גרסה חדשה יותר. (Idb6b5)

גרסה ‎1.3.0-alpha11

‫26 במרץ 2025

הגרסה androidx.savedstate:savedstate-*:1.3.0-alpha11 יוצאת ללא שינויים משמעותיים שגלויים לציבור. גרסה ‎1.3.0-alpha11 מכילה את השמירות האלה.

גרסה ‎1.3.0-alpha10

‫12 במרץ 2025

‫androidx.savedstate:savedstate-*:1.3.0-alpha10 מופץ. גרסה ‎1.3.0-alpha10 מכילה את השמירות האלה.

תכונות חדשות

  • הוספת וריאציות של שיטות לא מוחשיות לאוספי get ב-SavedStateReader. ‫(I0b641, ‏ b/399820614)
  • הוספת encodeDefaults ל-SavedStateConfiguration, כדי לאפשר התאמה אישית של קידוד מאפיינים עם ערכי ברירת מחדל. (I893cc, ‏ b/395104517)
  • הוספת SnapshotStateMapSerializer לתמיכה mutableStateMapOf. (Ie6f19, b/378895074)
  • הוספת SnapshotStateListSerializer לתמיכה mutableStateListOf. (I4d888, b/378895074)
  • הוספת getOrNull שיטות חלופיות לוריאציות של SavedStateReader.get. השיטות האלה יבצעו המרה אוטומטית של ערכים פרימיטיביים. (I6228c, ‏ b/399820614)

שינויים ב-API

  • הסרת getOrElse מהחשבון SavedStateReader לטובת getOrNull() ?: else(). (I87317, ‏ b/399820614)
  • הסרת ה-modifier‏ inline מהשיטות SavedStateReader ו-SavedStateWriter. (If2a02, b/399820614)
  • הסרה של סדרות (serializers) מובנות של רשימות ומערכים ספציפיים ל-Android מ-API ציבורי (Ida293)
  • מחליפים את SparseParcelableArraySerializer ב-SparseArraySerializer (I91de8)
  • התאמה של כל SavedStateReader.get כך שיתנהגו באופן עקבי על ידי הפעלה של throw כשסוג הערך לא תואם לסוג ההחזרה (I78c4a, b/399317598)
  • שינוי השם של SavedState*Delegates לSavedState*Delegate. (I8589b, ‏ b/399629301)
  • שינוי השם של SavedStateConfig לSavedStateConfiguration. ‫(I043a5, ‏ b/399629301)

גרסה ‎1.3.0-alpha09

‫26 בפברואר 2025

‫androidx.savedstate:savedstate-*:1.3.0-alpha09 מופץ. גרסה ‎1.3.0-alpha09 מכילה את השמירות האלה.

תכונות חדשות

  • הוספת חזרה לערך ברירת מחדל עבור סוגים מובנים, כדי להבטיח שכל הסוגים שנתמכים על ידי Bundle יוכלו לשמש עם encodeAsSavedState/decodeFromSavedState כברירת מחדל, או עבור מאפיינים במחלקות @Serializable, באמצעות ההערה @Contextual. (Ic01d2)
  • כולל תמיכה ב-classDiscriminator וב-classDiscriminatorMode ב-SavedStateConfig. ‫(I69b66, ‏ b/395104517)

שינויים ב-API

  • הוספת הפרמטר SavedStateConfig לנציגי saved() (I39b3a)
  • הופך סדרות מובנות לאובייקטים מסוג singleton ‏ (Ifeee4)
  • מאפייני SavedStateConfig הם עכשיו ציבוריים, כך שמודולים אחרים יכולים להשתמש בהגדרות האלה. ‫(Ie5f49, ‏ b/378897438)
  • תמיכה ב-@Serializer(with = ...) ל-MutableStateFlowSerializer ול-MutableStateSerializer (I90953)
  • הוספת contentDeepToString אל SavedStateReader (I14d10)

גרסה ‎1.3.0-alpha08

‫12 בפברואר 2025

‫androidx.savedstate:savedstate-*:1.3.0-alpha08 מופץ. גרסה ‎1.3.0-alpha08 מכילה את השמירות האלה.

תכונות חדשות

  • העברה של MutableStateSerializer אל savedstate-compose מתוך lifecycle-viewmodel-compose, כדי לאפשר לכם להשתמש בממשקי ה-API של SavedState Serialization עם MutableState של Compose. (I4f690, b/378895074)

שינויים ב-API

  • מוסיפים פונקציית factory כדי ליצור SavedState מSavedState קיים. (I39f9a)
  • הוספנו תמיכה ב-Array<SavedState> וב-List<SavedState> ב-androidx.savedstate. (Idd8a5)
  • הוספת פרמטר אופציונלי SavedStateConfig לקידוד ולפענוח של SavedState (I6c4c0)

גרסה ‎1.3.0-alpha07

‫29 בינואר 2025

‫androidx.savedstate:savedstate-*:1.3.0-alpha07 מופץ. גרסה ‎1.3.0-alpha07 מכילה את השמירות האלה.

תכונות חדשות

  • מוסיפים MutableStateFlowSerializer כדי ליצור סדרות של kotlinx.coroutines.flow.MutableStateFlow. (I6a892, b/378895070)

שינויים ב-API

  • החלפת פונקציות מואצלות בעלות עומס יתר SavedStateRegistryOwner.saved() בפרמטרים שמוגדרים כברירת מחדל (Icd1c1)
  • יצירת תקציר של JavaSerializableSerializer ושל ParcelableSerializer (I268f6)
  • הסרת מילת המפתח הגנרית T : CharSequence מהקמפיין CharSequenceSerializer (Ib40bd)

גרסה ‎1.3.0-alpha06

‫11 בדצמבר 2024

‫androidx.savedstate:savedstate-*:1.3.0-alpha06 מופץ. גרסה ‎1.3.0-alpha06 מכילה את השמירות האלה.

תכונות חדשות

  • SavedState KMP תומך עכשיו ב: IBinder, Size, SizeF, Array<Parcelable>, SparseArray<Parcelable> ו-Serializable (Android). ‫(I1ba94, ‏ b/334076622)
  • מוסיפים מופעים של KSerializer שאפשר להשתמש בהם כדי לקודד/לפענח סוגים של Java ו-Android שנתמכים על ידי Bundle, על ידי סימון השדה הרלוונטי בכיתה באמצעות @Serializable(with = ParcelableSerializer::class). (I8c10f, ‏ I28caf, ‏ b/376026712)
  • עכשיו אפשר לפתור מקרים של SavedStateRegistryOwner שאוחזרו באמצעות findViewTreeSavedStateRegistryOwner דרך הורים מנותקים של תצוגה, כמו ViewOverlay. מידע נוסף על הורים של תצוגות מנותקות מופיע בהערות הגרסה של Core או במסמכי התיעוד בכתובת ViewTree.setViewTreeDisjointParent. (Iccb33)

שינויים ב-API

  • השמות והארגון של החבילות יהיו עקביים יותר עם SavedStateRegistryOwnerDelegate (I8c135, ‏ b/376026744)

גרסה ‎1.3.0-alpha05

‫13 בנובמבר 2024

‫androidx.savedstate:savedstate-*:1.3.0-alpha05 מופץ. גרסה ‎1.3.0-alpha05 מכילה את השמירות האלה.

תמיכה ב-KotlinX Serialization

  • ב-SavedState יש עכשיו תמיכה ב-KotlinX Serialization. אפשר להמיר מחלקה עם הערה @Serializable ל-SavedState באמצעות השיטות encodeToSavedState ו-decodeFromSavedState. הערך SavedState שמוחזר הוא Bundle רגיל ב-Android, ואפשר להשתמש בו בכל API שמקבל 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)
}

  • הוספנו גם את saved, נציג מאפיינים עצלן, כדי לאחסן בקלות מחלקות @Serializable ב-SavedStateRegistryOwner (לדוגמה, ComponentActivity,‏ Fragment וכו') ולשחזר את המחלקות האלה באופן אוטומטי אחרי שהתהליך נסגר ונוצר מחדש. חשוב לזכור שהפונקציה saved delegate היא עצלה ולא תפעיל את פונקציית ה-lambda‏ init או תשמור משהו ב-SavedStateRegistry עד שתהיה אליה גישה. ‫(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")
    }
}

  • יש נציג נכס דומה saved עבור SavedStateHandle שנוסף ב-Lifecycle 2.9.0-alpha07.

שינויים ב-API

  • הוספת toMap אל SavedState, כך שכל SavedState יוכל להפוך לMap רגיל (עותק שטחי). (I487b9, ‏ b/334076622)
  • SavedState KMP תומך עכשיו במערכים. ‫(Ic0552, ‏ b/334076622)

גרסה ‎1.3.0-alpha04

‫30 באוקטובר 2024

‫androidx.savedstate:savedstate-*:1.3.0-alpha04 מופץ. גרסה ‎1.3.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

  • ספריית SavedState KMP תומכת עכשיו ב-Char. ‫(I9ac2f, ‏ b/334076622)
  • הוספת putNull ו-isNull ל-SavedState KMP. ‫(Iea71d, ‏ b/334076622)
  • הוספת פרמטרים נוספים של savedState factory שתומכים ב-Map<String, Any> ראשוני (I9b37d, ‏ b/334076622)
  • ספריית SavedState KMP תומכת עכשיו בהשוואה של contentDeepEquals. ‫(Ia515c, ‏ b/334076622)
  • ‫SavedState KMP תומך עכשיו ב-Long. (I4c180, b/334076622)

גרסה ‎1.3.0-alpha03

‫16 באוקטובר 2024

‫androidx.savedstate:savedstate-*:1.3.0-alpha03 יוצא ללא שינויים משמעותיים. גרסה ‎1.3.0-alpha03 מכילה את השמירות האלה.

גרסה ‎1.3.0-alpha02

‫2 באוקטובר 2024

‫androidx.savedstate:savedstate-*:1.3.0-alpha02 מופץ. גרסה ‎1.3.0-alpha02 מכילה את השמירות האלה.

‫Kotlin Multiplatform

  • מודול SavedState תואם עכשיו ל-KMP. הפלטפורמות הנתמכות כוללות עכשיו סביבות עבודה למחשב ב-Android,‏ iOS,‏ Linux,‏ Mac ו-JVM. (I26305, b/334076622)

תכונות חדשות

  • הוספנו את סוג הנתונים SavedState opaque כהפשטה כדי לספק דרך עקבית לשמירה ולשחזור של מצב האפליקציה ב-KMP. הוא כולל SavedStateReader ו-SavedStateWriter לשינוי המצב שצריך לשמור. ב-Android, ‏ SavedState הוא כינוי סוג ל-Bundle, שמבטיח תאימות בינארית ומקל על העברה של ממשקי API קיימים לקבוצת מקור משותפת. בפלטפורמות אחרות, SavedState הוא מופע של 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")
  }

שינויים ב-API

  • ‫SavedStateRegistry ו-SavedStateRegistryController תואמים עכשיו ל-KMP. (Id7bb8, b/334076622)
  • האפליקציות SavedState, SavedStateWriter וגם SavedStateReader תואמות עכשיו ל-KMP. (I26305, b/334076622)

גרסה ‎1.3.0-alpha01

‫7 באוגוסט 2024

‫androidx.savedstate:savedstate:1.3.0-alpha01 וגם androidx.savedstate:savedstate-ktx:1.3.0-alpha01 מופצים. גרסה ‎1.3.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

  • התוספים savedstate-ktx kotlin הועברו עכשיו למודול הבסיסי savedstate. (I1cc18, ‏ b/274803094)

הערה

  • עדכון compileSdk ל-35 (5dc41be)

גרסה 1.2.1

גרסה 1.2.1

‫22 במרץ 2023

‫androidx.savedstate:savedstate:1.2.1 וגם androidx.savedstate:savedstate-ktx:1.2.1 מופצים. גרסה 1.2.1 מכילה את השמירות האלה.

עדכונים של יחסי תלות

גרסה 1.2.0

גרסה 1.2.0

29 ביוני 2022

‫androidx.savedstate:savedstate:1.2.0 וגם androidx.savedstate:savedstate-ktx:1.2.0 מופצים. גרסה 1.2.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.1.0

  • מעכשיו אפשר לצרף את SavedStateRegistry מוקדם יותר ב-SavedStateRegistryController באמצעות performAttach().
  • עכשיו אפשר לאחזר SavedStateProvider שנרשם בעבר מSavedStateRegistry דרך getSavedStateProvider().
  • הספרייה SavedState נכתבה מחדש ב-Kotlin.
    • ב-SavedStateRegistryOwner, זהו שינוי שגורם לאי-תאימות למקור עבור המחלקות שנכתבו ב-Kotlin – עכשיו צריך לבטל את ברירת המחדל של המאפיין savedStateRegistry במקום להטמיע את הפונקציה getSavedStateRegistry() הקודמת.
    • במקרה של ViewTreeSavedStateRegistryOwner, זהו שינוי שגורם לאי-תאימות למקור עבור המחלקות שנכתבו ב-Kotlin. עכשיו צריך לייבא ישירות את שיטות ההרחבה של Kotlin ב-View של androidx.savedstate.setViewTreeSavedStateRegistryOwner ו-androidx.savedstate.findViewTreeSavedStateRegistryOwner ולהשתמש בהן כדי להגדיר ולמצוא בעלים שהוגדר בעבר. ה-API הזה מחליף את savedstate-ktx API של findViewTreeSavedStateRegistryOwner.

שינויים בהתנהגות

  • ‫SavedStateRegistry לא שומר יותר חבילה ריקה אם אין מצב לשמירה.

גרסה ‎1.2.0-rc01

‫11 במאי 2022

‫androidx.savedstate:savedstate:1.2.0-rc01 וגם androidx.savedstate:savedstate-ktx:1.2.0-rc01 מופצים. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

שינויים במסמכי העזרה

  • המסמכים SavedStateRegistryOwner Kdocs עודכנו כדי להבהיר את האחריות והחוזה של הבעלים לגבי אופן ההטמעה של הממשק או מתי צריך להפעיל את ה-methods ב-SavedStateRegistryController. ‫(Iefc95, ‏ b/228887344)

גרסה ‎1.2.0-beta01

‫20 באפריל 2022

‫androidx.savedstate:savedstate:1.2.0-beta01 וגם androidx.savedstate:savedstate-ktx:1.2.0-beta01 מופצים. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

  • המחלקה SavedStateRegistry והמחלקה ViewTreeSavedStateRegistryOwner נכתבו מחדש ב-Kotlin. במקרה של ViewTreeSavedStateRegistryOwner, זהו שינוי שגורם לאי-תאימות למקור עבור המחלקות שנכתבו ב-Kotlin. עכשיו צריך לייבא ישירות את שיטות ההרחבה של Kotlin ב-View של androidx.savedstate.setViewTreeSavedStateRegistryOwner ו-androidx.savedstate.findViewTreeSavedStateRegistryOwner ולהשתמש בהן כדי להגדיר ולמצוא בעלים שהוגדר בעבר. ה-API הזה מחליף את savedstate-ktx API של findViewTreeSavedStateRegistryOwner. היא תואמת לבינאריות ונשארת תואמת למקורות להטמעות שנכתבו בשפת התכנות Java. (b/220191285)

גרסה ‎1.2.0-alpha02

‫6 באפריל 2022

‫androidx.savedstate:savedstate:1.2.0-alpha02 וגם androidx.savedstate:savedstate-ktx:1.2.0-alpha02 מופצים. גרסה ‎1.2.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

  • עכשיו אפשר לאחזר SavedStateProvider שנרשם בעבר מ-SavedStateRegistry דרך getSavedStateProvider(). ‫(I7ea47, ‏ b/215406268)

שינויים ב-API

  • המחלקות SavedStateRegistryOwner,‏ SavedStateRegistryController ו-Recreator נכתבו מחדש ב-Kotlin. ב-SavedStateRegistryOwner, זהו שינוי שגורם לאי-תאימות למקור עבור המחלקות שנכתבו ב-Kotlin – עכשיו צריך לבטל את ברירת המחדל של המאפיין savedStateRegistry במקום להטמיע את הפונקציה getSavedStateRegistry() הקודמת. הוא תואם לבינארי ולמקור ליישומים שנכתבו בשפת התכנות Java. (b/220191285)

גרסה ‎1.2.0-alpha01

‫26 בינואר 2022

‫androidx.savedstate:savedstate:1.2.0-alpha01 וגם androidx.savedstate:savedstate-ktx:1.2.0-alpha01 מופצים. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • SavedStateRegistryController מאפשר עכשיו לצרף את SavedStateRegistry מוקדם יותר דרך performAttach(). (Ice4bf)

שינויים בהתנהגות

  • ‫SavedStateRegistry לא שומר יותר חבילה ריקה אם אין מצב לשמירה. (aosp/1896865, ‏ b/203457956)

גרסה 1.1.0

גרסה 1.1.0

‫10 בפברואר 2021

‫androidx.savedstate:savedstate:1.1.0 וגם androidx.savedstate:savedstate-ktx:1.1.0 מופצים. גרסה 1.1.0 מכילה את השמירות האלה.

שינויים משמעותיים מאז גרסה 1.0.0

  • ‫ViewTreeSavedStateRegistryOwner API: ViewTreeSavedStateRegistryOwner.get(View) API חדש מאפשר לכם לאחזר את SavedStateRegistry שמכיל מופע של View. כדי שהנתונים יאוכלסו בצורה נכונה, צריך לשדרג לגרסה Activity 1.2.0, ‏ Fragment 1.3.0 ו-AppCompat 1.3.0-alpha01 ומעלה.
  • ‫savedstate-ktx artifact: נוסף savedstate-ktx artifact חדש עם תוסף findViewTreeSavedStateRegistryOwner() Kotlin לעבודה עם ViewTreeSavedStateRegistryOwner.

גרסה ‎1.1.0-rc01

‫16 בדצמבר 2020

הגרסאות androidx.savedstate:savedstate:1.1.0-rc01 ו-androidx.savedstate:savedstate-ktx:1.1.0-rc01 יצאו ללא שינויים מאז 1.1.0-beta01. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.1.0-beta01

‫1 באוקטובר 2020

הגרסאות androidx.savedstate:savedstate:1.1.0-beta01 ו-androidx.savedstate:savedstate-ktx:1.1.0-beta01 יצאו ללא שינויים מאז 1.1.0-alpha01. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.1.0-alpha01

20 במאי 2020

‫androidx.savedstate:savedstate:1.1.0-alpha01 וגם androidx.savedstate:savedstate-ktx:1.1.0-alpha01 מופצים. גרסה ‎1.1.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • ‫API חדש של ViewTreeSavedStateRegistryOwner.get(View) מאפשר לכם לאחזר את SavedStateRegistry שמכיל מופע של View. כדי שהנתונים יאוכלסו בצורה נכונה, צריך לשדרג ל-Activity 1.2.0-alpha05, ‏ Fragment 1.3.0-alpha05 ו-AppCompat 1.3.0-alpha01. (aosp/1298679)
  • נוסף ארטיפקט חדש savedstate-ktx עם הרחבת Kotlin findViewTreeSavedStateRegistryOwner() לעבודה עם ViewTreeSavedStateRegistryOwner. (aosp/1299434)

גרסה 1.0.0

גרסה 1.0.0

‫5 בספטמבר 2019

‫androidx.savedstate:savedstate:1.0.0 מופץ. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

התכונות העיקריות של SavedState 1.0.0

‫androidx.savedstate קודמה לגרסה יציבה. זהו סט של ממשקי API שמאפשרים למפתחים להוסיף רכיבים לתהליך השחזור או השמירה של מצב המופע. נקודת הכניסה הראשית של ה-API היא SavedStateRegistry, שמאפשרת לאחזר מצבים שנשמרו בעבר באמצעות consumeRestoredStateForKey ולרשום קריאה חוזרת (callback) ל-registerSavedStateProvider כדי לספק מצב שמור ברגע שהמערכת מבקשת אותו.

גרסה ‎1.0.0-rc01

‫2 ביולי 2019

‫androidx.savedstate:savedstate:1.0.0-rc01 מופץ. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תיקוני באגים

  • תוקן כלל שגוי של ProGuard ‏ (b/132655499)

גרסה ‎1.0.0-beta01

‫7 במאי 2019

‫androidx.savedstate:savedstate:1.0.0-beta01 מופץ. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

גרסה ‎1.0.0-alpha02

‫13 במרץ 2019

‫androidx.savedstate:savedstate:1.0.0-alpha02 מופץ. השדה androidx.savedstate:savedstate משלב את פריטי המידע שנוצרו בתהליך פיתוח (Artifact) androidx.savedstate:savedstate-bundle ו-androidx.savedstate:savedstate-common לפריט מידע אחד, כי הוחלט לפשט את התשתית של savedstate ולהסיר את הגנריות מ-SavedStateRegistry. לכן, אין צורך במודולים נפרדים.

כאן אפשר למצוא את הרשימה המלאה של פעולות ה-commit שכלולות בגרסה הזו.

תכונות חדשות

  • הוספנו את SavedStateRegistry.runOnNextRecreaction(Class<? extends AutoRecreated> clazz ). המחלקה שצוינה תופעל והשיטה AutoRecreated.onRecreated תופעל כשהרכיב הבעלים יופעל מחדש.

שינויים ב-API

  • הסרת גנריקה מ-SavedStateRegistry<T>
  • המחלקות AbstractSavedStateRegistry ו-BundlableSavedStateRegistry הוסרו. במקומן אפשר להשתמש ב-SavedStateRegistry.
  • השם של BundleSavedStateRegistryOwner השתנה ל-SavedStateRegistryOwner

גרסה ‎1.0.0-alpha01

‫17 בדצמבר 2018

זו הגרסה הראשונה של SavedState.

תכונות חדשות

‫androidx.savedstate הוא קבוצה חדשה של ממשקי API בגרסת אלפא, שמאפשרים למפתחים להוסיף רכיבים לתהליך השחזור או השמירה של מצב המופע. נקודת הכניסה הראשית של ה-API היא SavedStateRegistry<T>, שמאפשרת לאחזר מצב שנשמר בעבר באמצעות consumeRestoredStateForKey ולרשום קריאה חוזרת (callback) ל-registerSavedStateProvider כדי לספק מצב שנשמר ברגע שהמערכת מבקשת אותו.