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) של
SavedStateKMP. (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 UI1.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הוא עצלן ולא יקרא ל-lambdainitאו ישמור משהו ב-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שנוסף ב-Lifecycle2.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 מכילה את השמירות האלה.
תכונות חדשות
-
SavedStateKMP תומך עכשיו ב-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הוא עצלן ולא יקרא ל-lambdainitאו ישמור משהו ב-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שנוסף ב-Lifecycle2.9.0-alpha07.
שינויים ב-API
- הוספת
toMapאלSavedState, כדי לאפשר המרה של כלSavedStateל-Mapרגיל (עותק שטחי). (I487b9, b/334076622) -
SavedStateKMP תומך עכשיו במערכים. (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 כוללת את השינויים האלה.
עדכוני תלויות
-
SavedStateתלוי עכשיו ב-Lifecycle2.6.1. (c1f621)
גרסה 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. כדי לאכלס את הנתונים האלה בצורה נכונה, צריך לשדרג ל-Activity1.2.0-alpha05, ל-Fragment1.3.0-alpha05ול-AppCompat1.3.0-alpha01. (aosp/1298679) - התוצר החדש
savedstate-ktxנוסף עם תוסף KotlinfindViewTreeSavedStateRegistryOwner()לעבודה עם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 מופץ. כאן אפשר למצוא את השמירות שנכללות בגרסה הזו.
תיקוני באגים
- תוקן כלל 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. לכן, אין צורך במודולים נפרדים.
כאן מופיעה הרשימה המלאה של השינויים שנכללים בגרסה הזו.
תכונות חדשות
- הוספת את
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 כדי לספק מצב שנשמר ברגע שהמערכת מבקשת אותו.