Savedstate

כותבים רכיבים נשלפים ששומרים את מצב ממשק המשתמש כשתהליך מסוים מסתיים, ומשחזרים אותו כשהתהליך מופעל מחדש.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
7 במאי 2025 1.3.0 - - -

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

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

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

Groovy

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

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

Kotlin

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

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

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

משוב

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

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

גרסה 1.3

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

  • 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 הוא עצלן, והוא לא יבצע קריאה לפונקציית הלמה 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 שנוספה במחזור חיים 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, ונדרשת לה גרסה 2.0.0 ואילך של KGP. (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 כברירת מחדל, או, במקרה של נכסים בקטגוריות @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 עם 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 מכילה את ההוספות האלה.

תכונות חדשות

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

  • 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 הוא עצלן, והוא לא יבצע קריאה לפונקציית הלמה 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 שנוספה במחזור חיים 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

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

  • התוספים של 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

  • SavedStateRegistryController מאפשר עכשיו לצרף מוקדם את SavedStateRegistry דרך 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 לא שומר יותר חבילה ריקה אם אין מצב שצריך לשמור.

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

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

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

גרסה 1.0.0-rc01

2 ביולי 2019

androidx.savedstate:savedstate:1.0.0-rc01 משוחרר. ההתחייבויות (commits) שכלולות בגרסה הזו מפורטות כאן.

תיקוני באגים

גרסה 1.0.0-beta01

7 במאי 2019

androidx.savedstate:savedstate:1.0.0-beta01 משוחרר. ההתחייבויות (commits) שכלולות בגרסה הזו מפורטות כאן.

גרסה 1.0.0-alpha02

13 במרץ 2019

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