Savedstate

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

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

כדי להוסיף תלות ב-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-alpha06

‫18 בנובמבר 2026

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

שינויים ב-API

  • מעבירים את LocalSavedStateRegistryOwner לשימוש ב-compositionLocalWithHostDefaultOf וב-SavedStateRegistryOwnerHostDefaultKey, ומנתקים אותו מהאחזור הישיר כחלק מעץ התצוגה מחוץ ל-Android. (I6768f)

גרסה 1.6.0-alpha05

‫21 באוקטובר 2026

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

שינויים ב-API

  • הוספנו ממשק API חדש של SavedStateContainer שישמש כבסיס ההטמעה הנפוץ של SaveableStateRegistry,‏ SavedStateHandle ו-SavedStateRegisty. (I1da6d)
  • הוספנו את asContainer(), getOrCreateContainer() ל-SavedStateRegistry כדי לאפשר יצירת מאגרים צאצאים מ-SavedStateRegistry. (Icb709)

גרסה 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 ב-constructor של 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, צריך את Compose UI בגרסה 1.8.0 ואילך. השינוי הזה מסיר את ברירות המחדל של ההשתקפות הפנימית, משפר את הביצועים אבל אוכף שדרוג תלות קפדני ללקוחות. (I16fb0)

גירסה 1.5

גרסה 1.5.0

‫19 במאי 2026

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

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

  • הפעלת סריאליזציה גנרית לאובייקטים מסוג SavedState, שמאפשרת לקודד ולפענח אותם באמצעות פורמטים סטנדרטיים כמו CBOR או JSON בכל הפלטפורמות. (Iafda4, b/425919375)
  • הוספת פונקציות ההרחבה putKotlinSerializable ו-getKotlinSerializable ל-SavedStateWriter ול-SavedStateReader כדי לאפשר אחסון ואחזור ישירים של אובייקטים מסוג Kotlin Serializable באמצעות מפתחות, וכך לייעל את השילוב עם ממשקי SavedState API. (Iba02e)
  • הוספת פונקציות של מפעל ל-LifecycleOwner, ל-ViewModelStoreOwner ול-SavedStateRegistryOwner כדי לצמצם את הקוד החוזר כשיוצרים רכיבים מותאמים אישית של בעלים. (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 כדי לצמצם את הקוד החוזר כשיוצרים רכיבים מותאמים אישית של בעלים. (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 מכילה את ה-commits האלה.

גרסה ‎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 מכילה את ה-commits האלה.

שינויים ב-API

  • הוספת תמיכה בסוגים שניתנים לאיפוס ב-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

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

גרסה 1.3

גרסה 1.3.3

‫17 בספטמבר 2025

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

תיקוני באגים

  • תוקנה שגיאה שבה הפלאגין של Compose Compiler לא הופעל, מה שגרם לשבירה של פריטי מידע שנוצרו בתהליך הפיתוח (artifacts) של SavedState KMP. (Id2290, b/443965665)

גרסה 1.3.2

‫27 באוגוסט 2025

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

תכונות חדשות

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

גרסה 1.3.1

‫16 ביולי 2025

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

תיקוני באגים

  • מוסיפים את כל יעדי ה-KMP שנתמכים על ידי הערות לקובצי ה-Artifact של SavedState.
  • נוספו יעדים חדשים של Kotlin Multiplatform‏ (KMP) לקובצי ה-Artifact של SavedState. ‫SavedState תומך עכשיו בפלטפורמות הבאות: JVM (Android ו-Desktop),‏ Native (Linux,‏ iOS,‏ watchOS,‏ macOS,‏ MinGW) ו-Web (JavaScript,‏ WasmJS). חשוב לציין שלא נוספו יעדי KMP חדשים לקובצי ה-Artifact של *-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.
  • תוספי Kotlin של savedstate-ktx הועברו עכשיו למודול הבסיסי של savedstate.
  • עכשיו אפשר לפתור מופעים של SavedStateRegistryOwner שאוחזרו באמצעות findViewTreeSavedStateRegistryOwner דרך הורים נפרדים של תצוגה, כמו ViewOverlay. מידע נוסף על תצוגות הורה לא רציפות זמין בהערות הגרסה של הליבה או במסמכי התיעוד בכתובת ViewTree.setViewTreeDisjointParent.

Kotlin Multiplatform

  • המודול SavedState תואם עכשיו ל-KMP. הפלטפורמות הנתמכות כוללות עכשיו את Android, ‏iOS, ‏Linux, ‏Mac וסביבות שולחן עבודה של JVM.
  • הוספת סוג אטום של SavedState כהפשטה כדי לספק דרך עקבית לשמור ולשחזר את מצב האפליקציה ב-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 הוא עצלן ולא יקרא ל-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 מכילה את ה-commits האלה.

עדכוני תלויות

  • הספרייה הזו מטרגטת עכשיו את רמת השפה של 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)
  • מסירים את המשתנה inline מהשיטות SavedStateReader ו-SavedStateWriter. (If2a02, b/399820614)
  • הסרת סדרנים מובנים של רשימות ומערכים ספציפיים ל-Android מ-API ציבורי (Ida293)
  • החלפת SparseParcelableArraySerializer ב-SparseArraySerializer (I91de8)
  • כל SavedStateReader.get יתנהגו באופן עקבי על ידי זריקה כשסוג הערך לא תואם לסוג ההחזרה (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 כברירת מחדל, או באמצעות ההערה @Contextual למאפיינים במחלקות @Serializable. (Ic01d2)
  • כולל תמיכה ב-classDiscriminator וב-classDiscriminatorMode ב-SavedStateConfig. (I69b66,‏ b/395104517)

שינויים ב-API

  • הוספת הפרמטר SavedStateConfig ל-saved() נציגים (I39b3a)
  • הפיכת אובייקטים של סינגלטון לסדרתיים מובנים (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

  • הוספת פונקציית מפעל ליצירת 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 מכילה את ה-commits האלה.

תכונות חדשות

  • צריך להוסיף את MutableStateFlowSerializer כדי להפוך את kotlinx.coroutines.flow.MutableStateFlow לסדרה. (I6a892, b/378895070)

שינויים ב-API

  • החלפת פונקציות נציג (delegate) של 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. מידע נוסף על תצוגות הורה לא רציפות זמין בהערות הגרסה של הליבה או במסמכי התיעוד בכתובת 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 הוא עצלן ולא יקרא ל-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 מכילה את ה-commits האלה.

שינויים ב-API

  • ‫SavedState KMP תומך עכשיו ב-Char. (I9ac2f, b/334076622)
  • מוסיפים את putNull ו-isNull ל-SavedState KMP. (Iea71d, b/334076622)
  • הוספת פרמטרים נוספים של מפעל savedState שתומכים ב-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 כהפשטה כדי לספק דרך עקבית לשמור ולשחזר את מצב האפליקציה ב-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

  • תוספי Kotlin של savedstate-ktx הועברו עכשיו למודול הבסיסי של 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 הזה מחליף את ה-API של savedstate-ktx ב-findViewTreeSavedStateRegistryOwner.

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

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

גרסה ‎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 מכילה את השינויים האלה.

שינויים במסמכי התיעוד

  • ה-Kdocs של SavedStateRegistryOwner עודכנו כדי להבהיר את תחומי האחריות והחוזה של הבעלים לגבי אופן ההטמעה של הממשק או מתי צריך להפעיל את ה-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 הזה מחליף את ה-API של savedstate-ktx ב-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 מכילה את השינויים האלה.

תכונות חדשות

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

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

  • ‫SavedStateRegistry לא שומר יותר Bundle ריק אם אין מצב לשמור. (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

  • ‫API של ViewTreeSavedStateRegistryOwner: ממשק API חדש של ViewTreeSavedStateRegistryOwner.get(View) מאפשר לאחזר את ה-SavedStateRegistry שמכיל את המופע של View. כדי לאכלס את הנתונים האלה בצורה נכונה, צריך לשדרג לגרסה 1.3.0-alpha01 של AppCompat, לגרסה 1.3.0 של Fragment ולגרסה 1.2.0 של Activity או לגרסאות חדשות יותר.
  • פריט מידע שנוצר בתהליך הפיתוח (Artifact) של savedstate-ktx: פריט המידע החדש של savedstate-ktx נוסף עם תוסף Kotlin של findViewTreeSavedStateRegistryOwner() לעבודה עם 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 שמאפשרים למפתחים להוסיף רכיבים לתהליך השחזור או לתהליך saveInstanceState. נקודת הכניסה הראשית של ה-API היא SavedStateRegistry, שמאפשרת לאחזר מצבים שנשמרו בעבר באמצעות consumeRestoredStateForKey ולרשום קריאה חוזרת (callback) אל registerSavedStateProvider כדי לספק מצב שמור כשהמערכת מבקשת אותו.

גרסה ‎1.0.0-rc01

‫2 ביולי 2019

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

תיקוני באגים

גרסה 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. לכן, אין צורך במודולים נפרדים.

כאן מופיעה הרשימה המלאה של השינויים שנכללים בגרסה הזו.

תכונות חדשות

  • הוספת את 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 בגרסת אלפא שמאפשרים למפתחים להוסיף רכיבי פלאגין לתהליך השחזור או לתהליך saveInstanceState. נקודת הכניסה הראשית של ה-API היא SavedStateRegistry<T>, שמאפשרת לאחזר מצב שנשמר בעבר באמצעות consumeRestoredStateForKey ולרשום קריאה חוזרת (callback) אל registerSavedStateProvider כדי לספק מצב שנשמר ברגע שהמערכת מבקשת אותו.