מקטע (fragment)

פילוח האפליקציה למספר מסכים עצמאיים שמתארחים בתוך Activity.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫1 ביולי 2026 1.8.9 - - ‎1.9.0-alpha02

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

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

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

Groovy

dependencies {
    def fragment_version = "1.8.9"

    // Java language implementation
    implementation "androidx.fragment:fragment:$fragment_version"
    // Kotlin
    implementation "androidx.fragment:fragment-ktx:$fragment_version"
    // Compose
    implementation "androidx.fragment:fragment-compose:$fragment_version"
    // Testing Fragments in Isolation
    debugImplementation "androidx.fragment:fragment-testing-manifest:$fragment_version"
    androidTestImplementation "androidx.fragment:fragment-testing:$fragment_version"
}

Kotlin

dependencies {
    val fragment_version = "1.8.9"

    // Java language implementation
    implementation("androidx.fragment:fragment:$fragment_version")
    // Kotlin
    implementation("androidx.fragment:fragment-ktx:$fragment_version")
    // Compose
    implementation("androidx.fragment:fragment-compose:$fragment_version")
    // Testing Fragments in Isolation
    debugImplementation("androidx.fragment:fragment-testing:$fragment_version")
}

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

משוב

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

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

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

גרסה 1.9

גרסה ‎1.9.0-alpha02

‫1 ביולי 2026

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

שינויים ב-API

  • מוסיפים פרמטר maxLifecycle ל-AndroidFragment composable. כך תוכלו להגביל את מצב מחזור החיים של Fragment המוטמע, ולקבל שליטה מדויקת יותר בהתנהגות שלו בהגדרות מורכבות של ממשק משתמש, כמו רכיבי החלפה בין דפים או כרטיסיות. (Ie99b5, b/526109804)
  • ספריית Fragment תומכת עכשיו במעקב אחר אירועי מחזור החיים באמצעות Jetpack Tracing. (Ibc63b, ‏ b/112161409)

גרסה ‎1.9.0-alpha01

‫17 ביוני 2026

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

שינויים ב-API

  • ה-Fragment מטמיע עכשיו את הממשק ContextAware ואפשר להשתמש בו כדי להריץ קוד כשה-Fragment מצורף. (I38019, ‏ b/477255355)

תיקוני באגים

  • תוקן קראש ב-Fragment שנגרם כששולחים את הפעילות לרקע במהלך תנועת חזרה ניבויית. (I55734, b/389589678)
  • הכלי UnsafeFragmentLifecycleObserverDetector לא פועל יותר בהרכב. (Ic4176, b/501504696)
  • ‫[From Fragment 1.8.9] תוקנה הבעיה שבה ביטול של תנועת ניווט חזוי אחורה שגורמת להפעלת פעולת הסתרה יגרום לכך שהתנועה הבאה לא תונפש בצורה תקינה כשמשתמשים באנימטורים. ‫(I0a400, ‏ b/384765586)
  • ‫[From Fragment 1.8.9] Fixed an error where a combination of setMaxLifecycle and popBackStack could fail to move the top fragment to RESUMED. ‫(I3448b, ‏ b/406127576)
  • ‫[From Fragment 1.8.8] תוקנה בעיה שבה FragmentManager היה קורס בניסיון לשמור את המצב של Fragments שנוספו באמצעות setMaxLifecycle(Lifecycle.State.INITIALIZED). הקטעים האלה, שלא עברו דרך onCreate(), כבר לא כוללים מצב שמור או קריאה של onSaveInstanceState(). ‫(I6e37a, ‏ b/408163315)
  • ‫[From Fragment 1.8.7] Fixed an issue with FragmentManager no being in the proper state after pop and replace operations in the same frame that could cause a crash in conjunction with predictive back. ‫(I50ad1, ‏ b/380288461)
  • ‫[From Fragment 1.8.6] ‫FragmentContainerView's setOnApplyWindowInsetsListener override now takes a null listener. ‫(I575f0, ‏ b/282790626)
  • ‫[From Fragment 1.8.5] Fixed an IllegalStateException triggered by saveBackStack only after a Predictive Back gesture was cancelled or interrupted. (I3387d, b/342419080)
  • ‫[From Fragment 1.8.4] Fixed an UninitializedPropertyAccessException in AndroidFragment when dynamically swapping out the Class your AndroidFragment instance is using. (I12dea, ‏ b/365578408)
  • ‫[From Fragment 1.8.4] תוקנה בעיה שבה לחיצה מהירה על לחצן החזרה של המערכת או ביצוע תנועת חזרה מהירה גורמים לקריסת רכיבי Fragment. (Ibc038, ‏ b/364804225, ‏ b/364914301)
  • ‫[From Fragment 1.8.4] Fixed an issue in fragments where interrupting a predictive back gesture would send the fragment manager into an undefined state and even up showing the wrong fragment. (If82e2, ‏ b/338624457)
  • ‫[From Fragment 1.8.3] ‫AndroidFragment no longer crashes if it is added to composition while the containing activity/fragment's state is already saved. (I985e9, b/356643968)
  • ‫[From Fragment 1.8.2] הפעלת חזרה למערכת בזמן של-FragmentManager יש פעולות בהמתנה כבר לא תגרום לחריגה מחוץ לתחום. (I9ba32, ‏ b/342316801)
  • ‫[From Fragment 1.8.2] ‫AndroidFragment now properly handles cases where the parent fragment is put on the Fragment back stack, avoiding 'No view found for id' issues when popping back to that fragment. (I94608, ‏ b/347706985)
  • ‫[From Fragment 1.8.2] Fragments added via the FragmentTransaction.add method that takes a ViewGroup now wait for onContainerAvailable before progressing to onStart(). השינוי הזה משפיע על משתמשים ב-API הזה, כמו AndroidFragment, שעכשיו מחכה ש-AndroidFragment ייכנס מחדש לחיבור לפני שהוא מעביר אותו דרך onStart(). (I94608, ‏ b/347706985)
  • ‫[From Fragment 1.8.1] תוקנה בעיה שבה קטע ללא מאגר הושמד באופן מיידי כשמתחילים תנועת חזרה עם חיזוי. (If6b83, b/345244539)

חישוב צריכת הנתונים

  • מיזוג fragment-ktx לספריית fragment. כל התוספים של Kotlin הם עכשיו חלק מארטיפקט הפרגמנט הראשי. fragment-ktx הוא עכשיו ארטיפקט ריק לצורך תאימות. תודה, Jake Wharton! (Idabaa)

גרסה 1.8

גרסה 1.8.9

‫13 באוגוסט 2025

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

תיקוני באגים

  • תוקנה הבעיה שבה ביטול של תנועת ניווט חזוי אחורה שפותחת פעולת הסתרה גורם לכך שהתנועה הבאה לא מונפשת בצורה תקינה כשמשתמשים באנימטורים. ‫(I0a400, ‏ b/384765586)
  • תוקנה שגיאה שבה שילוב של setMaxLifecycle ו-popBackStack עלול לגרום לכך שהקטע העליון לא יועבר למצב RESUMED. ‫(I3448b, ‏ b/406127576)

גרסה 1.8.8

‫4 ביוני 2025

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

תיקוני באגים

  • תוקנה הבעיה שגרמה לקריסה של FragmentManager בניסיון לשמור את המצב של רכיבי Fragment שנוספו באמצעות setMaxLifecycle(Lifecycle.State.INITIALIZED). הפרגמנטים האלה, שלא עברו אף פעם onCreate(), כבר לא כוללים מצב שמור או onSaveInstanceState(). (I6e37a)

גרסה 1.8.7

‫20 במאי 2025

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

תיקוני באגים

  • תוקנה בעיה שגרמה לכך ש-FragmentManager לא היה במצב המתאים אחרי פעולות של שליפה והחלפה באותו פריים, שיכולה לגרום לקריסה בשילוב עם שליפה של היסטוריית הדפים באמצעות popBackStack או תנועת הניווט החזוי אחורה. (I50ad1)
  • תוקנה קריסת מערכת שנגרמה משימוש ב-AndroidX Transitions ומכניסה למצב שבו ניסיונות מהירים רצופים של טרנזקציות של פרגמנטים מבטלים מעבר שלא התחיל, וספריית AndroidX Transition לא מנקה את מצב המעבר כמו שצריך. (ראו b/414612221). (Ib5235)

גרסה 1.8.6

‫12 בפברואר 2025

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

תיקוני באגים

  • ההחלפה של FragmentContainerView ב-setOnApplyWindowInsetsListener מקבלת עכשיו מאזין null, בהתאם למה שהמסגרת מאפשרת. ‫(I575f0, ‏ b/282790626)

גרסה 1.8.5

‫30 באוקטובר 2024

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

תיקוני באגים

  • תוקנה בעיה IllegalStateException שנגרמה על ידי saveBackStack רק אחרי שבוטלה או הופסקה תנועת החלקה לניווט חזוי. (I3387d, b/342419080)

גרסה 1.8.4

‫2 באוקטובר 2024

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

תיקוני באגים

  • תוקנה בעיה שבה לחיצה מהירה על לחצן החזרה של המערכת או ביצוע מהיר של תנועת החזרה גורמים לקריסת רכיבי Fragments כשמשתמשים במעברים של Androidx. (Ibc038, ‏ b/364804225)
  • תוקנה בעיה בקטעי קוד שבה הפרעה לתנועת חזרה ניבויית גרמה למנהל קטעי הקוד להיכנס למצב לא מוגדר, ואפילו להציג את קטע הקוד הלא נכון. (If82e2, ‏ b/338624457)
  • תוקן באג UninitializedPropertyAccessException ב-AndroidFragment כשמחליפים באופן דינמי את המחלקה שמופע AndroidFragment משתמש בה. (I12dea)

גרסה 1.8.3

‫4 בספטמבר 2024

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

תיקוני באגים

  • ‫FragmentManager עכשיו מביא בחשבון בצורה נכונה פעולות בהמתנה כשמבצעים את תנועת הניווט החזוי. הפעולה הזו אמורה להבטיח שגיבוי המערכת לא יגרום יותר לIndexOutOfBoundsException. (I9ba32, ‏ b/342316801)
  • AndroidFragment לא קורס יותר אם הוא מתווסף לקומפוזיציה בזמן שהמצב של הפעילות או הפרגמנט שמכילים אותו כבר נשמר. (I985e9, b/356643968)

גרסה 1.8.2

‫24 ביולי 2024

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

תיקוני באגים

  • ‫AndroidFragment מטפל עכשיו כמו שצריך במקרים שבהם קטע האב מועבר אל ערימת החזרה של Fragment, וכך נמנעות בעיות מסוג 'לא נמצאה תצוגה למזהה' כשחוזרים לקטע הזה. (I94608)
  • קטעים שנוספו באמצעות השיטה FragmentTransaction.add שמקבלת ViewGroup, ממתינים עכשיו ל-onContainerAvailable לפני שהם עוברים ל-onStart(). השינוי הזה משפיע על משתמשים ב-API הזה, כמו AndroidFragment, שצריך לחכות עכשיו ש-AndroidFragment יחזור להרכבה לפני שהוא מעביר אותו דרך onStart(). (I94608)

גרסה 1.8.1

‫26 ביוני 2024

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

תיקוני באגים

  • תוקנה הבעיה שבה פרגמנטים ללא מאגר תגים נסגרו באופן מיידי DESTROYED כשמתחילים תנועת חזרה עם חיזוי. עכשיו הן מוחזקות במצב CREATED עד לסיום התנועה. (If6b83, b/345244539)

גרסה 1.8.0

‫12 ביוני 2024

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

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

  • ארטיפקט fragment-compose מכיל עכשיו AndroidFragment Composable שמאפשר להוסיף מקטעים להיררכיית Compose באמצעות שם המחלקה של המקטע. הוא מטפל אוטומטית בשמירה ובשחזור של מצב ה-Fragment. השיטה הזו אמורה לשמש כתחליף ישיר לגישה המומלצת הקודמת של שימוש ב-AndroidViewBinding כדי להרחיב Fragment.
  • הקריאה החוזרת (callback) של onBackStackChangeCancelled בממשק OnBackStackChangedListener של FragmentManager מופעלת עכשיו כחלק מהפעלת פעולות ב-FragmentManager, וכך היא מתקרבת לתזמון של הקריאה החוזרת (callback) של onBackStackChangeCommitted.

גרסה ‎1.8.0-rc01

‫29 במאי 2024

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

תיקוני באגים

  • הקריאה החוזרת (callback) של onBackStackChangeCancelled בממשק FragmentManagers OnBackStackChangedListener מופעלת עכשיו כחלק מהפעלת פעולות ב-FragmentManager, ולכן היא מתבצעת בזמן שקרוב יותר לזמן של הקריאה החוזרת (callback) של onBackStackChangeCommitted. (I5ebfb, ‏ b/332916112)

גרסה ‎1.8.0-beta01

‫14 במאי 2024

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

תיקוני באגים

  • מתוך Fragment 1.7.1: מעכשיו, התכונה 'חזרה עם אנימציה' תפעל רק בעסקאות שבהן לכל הפרגמנטים יש Animator או Seekable Androidx Transition. תוקנה בעיה שבה ביטול של עסקה שאפשרה חיפוש חלקי גרם להצגת מסך שחור. (I43037, b/339169168)

גרסה ‎1.8.0-alpha02

‫17 באפריל 2024

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

תיקוני באגים

  • מתוך Fragment 1.7.0-rc02: נוספו יומנים שמציינים למה הגדרה של sharedElement בלי מעברים אחרים לא תפעל. (Iec48e)
  • מ-Fragment 1.7.0-rc02: תוקן באג שגרם לקריסה אם נוסף רכיב משותף שלא ניתן להעברה לעסקאות שכל המעברים האחרים בהן ניתנים להעברה. עכשיו הטרנזקציה תיחשב כטרנזקציה שלא ניתן לחפש בה. (I18ccd)

גרסה ‎1.8.0-alpha01

‫3 באפריל 2024

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

תכונות חדשות

  • התג החדש AndroidFragment Composable מאפשר להוסיף קטעים להיררכיית הכתיבה באמצעות שם המחלקה של הקטע. הוא מטפל אוטומטית בשמירה ובשחזור של מצב ה-Fragment. אפשר להשתמש ב-API הזה כתחליף ישיר ל-AndroidViewBinding Composable.(b/312895363, Icf841)

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

  • עדכנו את התיעוד של ממשקי ה-API של OnBackStackChangedListener כדי לציין מתי מתבצעת קריאה לממשקי ה-API האלה ואיך צריך להשתמש בהם. (I0bfd9)

עדכון תלות

גרסה 1.7

גרסה 1.7.1

‫14 במאי 2024

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

תיקוני באגים

  • מעכשיו, התכונה 'חזרה עם חיזוי' תפעל רק בעסקאות שבהן לכל המקטעים יש Animator או Seekable Androidx Transition. העדכון הזה פותר בעיה שבה ביטול של עסקה שאפשרה דילוג חלקי גרם למסך ריק. (I43037, b/339169168)

גרסה 1.7.0

‫1 במאי 2024

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

תמיכה בתנועת חזרה עם חיזוי

  • מעכשיו, רכיבי Fragment תומכים בתכונה 'חזרה לאחור באפליקציה עם אנימציה מקדימה' כשמשתמשים ב-Animator או כשמשתמשים ב-AndroidX Transition 1.5.0. כך המשתמשים יכולים להשתמש בתנועת החזרה כדי לראות את הקטע הקודם על ידי חיפוש ב-Animator/Transition לפני שהם מחליטים אם לאשר את העסקה באמצעות השלמת התנועה או ביטול.
מערכת מעבר מקור מידע בפורמט XML תמיכה בחיזוי החזרה
Animation R.anim לא
Animator R.animator כן
‫Framework Transition R.transition לא
‫AndroidX Transition עם Transition 1.4.1 או גרסה קודמת R.transition לא
‫AndroidX Transition עם Transition 1.5.0 R.transition כן

אם נתקלתם בבעיות בתמיכה בתנועת החזרה החזויה ב-Fragments אחרי שהפעלתם את תנועת החזרה החזויה, אתם מוזמנים לדווח על בעיה ב-Fragment ולצרף פרויקט לדוגמה שבו הבעיה משתחזרת. אפשר להשבית את התכונה 'חזרה חזויה' באמצעות FragmentManager.enabledPredictiveBack(false) בonCreate() של הפעילות.

‫FragmentManager.OnBackStackChangedListener() מספק עכשיו את onBackStackChangeProgressed() ואת onBackStackChangeCancelled() כדי לקבל אירועים של התקדמות אחורה וביטול בהתאמה.

Fragment Compose Artifact

נוצר ארטיפקט חדש של fragment-compose שמתמקד בתמיכה באפליקציות שנמצאות בתהליך מעבר מארכיטקטורה שמבוססת על Fragment לארכיטקטורה שמבוססת באופן מלא על Compose.

התכונה הראשונה שזמינה בארטיפקט החדש הזה היא content שיטת הרחבה ב-Fragment, שמטרתה להקל על השימוש בפיתוח נייטיב לממשק המשתמש של Fragment מסוים. השיטה יוצרת בשבילכם ComposeView ומגדירה את ViewCompositionStrategy הנכון.

  class ExampleFragment : Fragment() {

      override fun onCreateView(
          inflater: LayoutInflater,
          container: ViewGroup?,
          savedInstanceState: Bundle?
      ) = content {
          // Write your @Composable content here
          val viewModel: ExampleViewModel = viewModel()

          // or extract it into a separate, testable method
          ExampleComposable(viewModel)
      }
  }

גרסה ‎1.7.0-rc02

‫17 באפריל 2024

‫androidx.fragment:fragment-*:1.7.0-rc02 מופץ. גרסה ‎1.7.0-rc02 מכילה את השמירות האלה.

תיקוני באגים

  • נוספו יומנים שמציינים למה הגדרה של sharedElement בלי מעברים אחרים לא תפעל. (Iec48e)
  • תוקן באג שגרם לקריסה אם נוסף רכיב משותף שלא ניתן להעברה לעסקאות שכל המעברים האחרים בהן ניתנים להעברה. עכשיו הטרנזקציה תיחשב כטרנזקציה שלא ניתן לחפש בה. (I18ccd)

גרסה ‎1.7.0-rc01

‫3 באפריל 2024

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

עדכון תלות

גרסה ‎1.7.0-beta01

‫20 במרץ 2024

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

שינויים ב-API

  • הפונקציה FragmentHostCallback נכתבת עכשיו ב-Kotlin, כך שהמאפיין המציין אם ערך יכול להיות ריק (nullability) של הסוג הגנרי של Host זהה למאפיין המציין אם ערך יכול להיות ריק של סוג ההחזרה של onGetHost(). (I40af5)

תיקוני באגים

  • תוקנה בעיה שבה כשמבצעים תנועת חזרה עם חיזוי במקטע שלא נמצא במאגר, המקטע הזה אף פעם לא נמחק. הקטע יועבר עכשיו באופן מיידי למצב הסופי. (Ida0d9)
  • תוקנה בעיה ב-Fragments שבה הפרעה למעברים נכנסים באמצעות תנועת חזרה עם חיזוי גרמה להרס התצוגה הנכנסת ולהצגת מסך ריק. (Id3f22, b/319531491)

גרסה ‎1.7.0-alpha10

‫7 בפברואר 2024

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

תיקוני באגים

  • תוקנה הבעיה הידועה בגרסה הקודמת של Fragment, שבה שימוש בתמיכה של Fragment בחיזוי חזרה ל-Animator או ב-AndroidX Transition, Fragments היה מציג NullPointerException מ-handleOnBackProgressed אם אף פעם לא נוסף FragmentManager.OnBackStackChangedListener באמצעות addOnBackStackChangedListener. (I7c835)

גרסה ‎1.7.0-alpha09

‫24 בינואר 2024

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

Fragment Compose Artifact

נוצר ארטיפקט חדש של fragment-compose שמתמקד בתמיכה באפליקציות שנמצאות בתהליך מעבר מארכיטקטורה שמבוססת על Fragment לארכיטקטורה שמבוססת באופן מלא על Compose.

התכונה הראשונה שזמינה בארטיפקט החדש הזה היא content שיטת הרחבה ב-Fragment, שמטרתה להקל על השימוש בפיתוח נייטיב לממשק המשתמש של Fragment מסוים. השיטה יוצרת בשבילכם ComposeView ומגדירה את ViewCompositionStrategy הנכון. (561cb7, ‏ b/258046948)

class ExampleFragment : Fragment() {

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ) = content {
        // Write your @Composable content here
        val viewModel: ExampleViewModel = viewModel()

        // or extract it into a separate, testable method
        ExampleComposable(viewModel)
    }
}

תכונות חדשות

  • ‫FragmentManager.OnBackStackChangedListener() מספק עכשיו את onBackStackChangeProgressed() ואת onBackStackChangeCancelled() כדי לקבל אירועים של התקדמות אחורה וביטול בהתאמה. (214b87)

בעיה ידועה

  • כשמשתמשים בתמיכה של Fragment בחיזוי חזרה ל-Animator או ב-AndroidX Transition, ‏ Fragments יפעיל NullPointerException מ-handleOnBackProgressed אם אף פעם לא נוסף FragmentManager.OnBackStackChangedListener באמצעות addOnBackStackChangedListener. הוספה ידנית של מאזין תפתור את הבעיה. התיקון יהיה זמין בגרסה הבאה של Fragments.

גרסה ‎1.7.0-alpha08

‫10 בינואר 2024

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

פינוי נפח

גרסה ‎1.7.0-alpha07

‫29 בנובמבר 2023

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

תיקוני באגים

  • תוקן באג NullPointerException שנגרם כתוצאה מהגדרת מעבר של רכיב משותף בלי להגדיר גם enter/exitTransition. (I8472b)
  • מתוך Fragment 1.6.2: כשמבצעים ניפוח של Fragment של FragmentContainerView, המצבים שלו כמו FragmentManager, Host ו-id נגישים עכשיו בקריאה החוזרת onInflate. (I1e44c, ‏ b/307427423)
  • מתוך Fragment 1.6.2: כשמשתמשים ב-clearBackStack כדי להסיר קבוצה של Fragment, כל Fragment מוטמע ViewModel ינוקה עכשיו כשמנקים את ViewModels של ה-Fragment ברמה העליונה. (I6d83c, ‏ b/296173018)

גרסה ‎1.7.0-alpha06

‫4 באוקטובר 2023

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

עדכון תלות

גרסה ‎1.7.0-alpha05

‫20 בספטמבר 2023

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

תכונות חדשות

  • מעכשיו, כשמשתמשים במעברים של Androidx, יש תמיכה ב-Fragments בתכונה 'חזרה עם חיזוי'. כך אפשר להשתמש בתנועת החלקה אחורה כדי לעבור לקטע הקודם עם המעבר המותאם אישית של Androidx לפני שמחליטים אם לאשר או לבטל את העסקה באמצעות התנועה שהושלמה. כדי להפעיל את התכונה הזו, צריך להסתמך על מהדורת המעבר 1.5.0-alpha03. (Ib49b4, b/285175724)

בעיות מוכרות

  • יש כרגע בעיה שבה אחרי שמבטלים תנועת חזרה עם מעבר פעם אחת, בפעם הבאה שמבצעים את תנועת החזרה המעבר לא יפעל, ויוצג מסך ריק. יכול להיות שהסיבה לכך היא בעיה בספריית המעברים. (b/300157785). אם הבעיה הזו מופיעה, צריך לדווח על בעיה ב-Fragment ולצרף פרויקט לדוגמה שבו הבעיה משתחזרת. אפשר להשבית את התכונה 'חזרה חזויה' באמצעות FragmentManager.enabledPredictiveBack(false) בonCreate() של הפעילות.

גרסה ‎1.7.0-alpha04

‫6 בספטמבר 2023

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

תיקוני באגים

  • תוקנה בעיה שבה ביטול של תנועת חזרה חזויה גרם לכך שקטעי קוד לא הגיעו למצב הנכון במחזור החיים. (I7cffe, ‏ b/297379023)
  • תוקנה רגרסיה שבה אנימציות הורשו לפעול עם מעברים. (I59f36)
  • תוקנה בעיה בשימוש בתכונה 'חזרה עם חיזוי' עם קטעים, שבה ניסיון לחזור פעמיים ברצף מהיר בקטע השני מהסוף במחסנית החזרה גרם לקריסה. (Ifa1a4)

גרסה ‎1.7.0-alpha03

‫23 באוגוסט 2023

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

תיקוני באגים

  • תוקנה בעיה שקשורה ל-Fragments כשמשתמשים בתכונה 'הקודם עם אנימציה'. הבעיה גרמה לכך שהמערכת דילגה על ה-Fragment הראשון במחסנית האחורית של מנהל ה-Fragment, והפעילות הסתיימה כשמשתמשים בתכונה 'הקודם' של המערכת באמצעות ניווט עם 3 לחצנים או באמצעות תנועת 'הקודם עם אנימציה'. ‫(I0664b, ‏ b/295231788)

גרסה ‎1.7.0-alpha02

‫9 באוגוסט 2023

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

תיקוני באגים

  • כשמשתמשים ב-Fragments עם תנועות ניווט חזויות אחורה מ-API 34, אם משתמשים במערכת מעברים שלא תומכת בחיפוש (Animations, Transitions) או שלא תומכת במעברים בכלל, Fragments ימתין עכשיו עד שהתנועה תושלם לפני ביצוע הפעולה 'חזרה'. (I8100c)

גרסה ‎1.7.0-alpha01

‫7 ביוני 2023

‫androidx.fragment:fragment-*:1.7.0-alpha01 מופץ. הגרסה הזו פותחה בענף פנימי.

תכונות חדשות

  • כשמשתמשים ב-Animator, רכיבי Fragment תומכים עכשיו בתכונה 'חיזוי תנועת החזרה' באפליקציה. כך תוכלו להשתמש בתנועת החזרה כדי לראות את הקטע הקודם עם האנימטור המותאם אישית שלכם, לפני שתחליטו אם לאשר את העסקה באמצעות התנועה שהושלמה או לבטל אותה. אפשר גם להשבית את ההתנהגות החדשה הזו באמצעות הניסוי enablePredictiveBack() ולהעביר את false.

גרסה 1.6

גרסה 1.6.2

1 בנובמבר 2023

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

תיקוני באגים

  • כשמנפחים את ה-Fragment של FragmentContainerView, המצבים שלו כמו FragmentManager, Host ו-id נגישים עכשיו בקריאה החוזרת onInflate. (I1e44c, ‏ b/307427423)
  • כשמשתמשים ב-clearBackStack כדי להסיר קבוצה של רכיבי Fragment, הערכים של ViewModel של רכיבי Fragment מוטמעים ינוקו עכשיו כשערכי ViewModels של רכיב ה-Fragment הראשי ינוקו. (I6d83c, ‏ b/296173018)

גרסה 1.6.1

26 ביולי 2023

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

תיקוני באגים

  • תוקנה בעיה שגרמה לכך שהמצב השמור שנשמר כשהפעילות הופסקה אבל לא נהרסה נשמר במטמון באופן שגוי גם אחרי שמופע השבר הועבר חזרה למצב RESUMED. אם מופעל ה-API של כמה מחסניות חזרה כדי לשמור את הפרגמנט הזה ולשחזר אותו, המצב שנשמר במטמון ישמש שוב אם מופעלת מופע הפרגמנט הזה במחסנית החזרה. (I71288, ‏ b/246289075)

עדכון תלות

  • ה-Fragment תלוי עכשיו ב-Activity 1.7.2. התיקון הזה פותר בעיה שבה משתמשי Kotlin לא יכלו להרחיב את ComponentDialog בלי תלות מפורשת ב-Activity. (b/287509323)

גרסה 1.6.0

‫7 ביוני 2023

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

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

  • המצב השמור של Fragments פוצל לחלוטין בין מצב הספרייה הפרטית (מחלקות Parcelable בהתאמה אישית) לבין מצב שסופק על ידי המפתח, שמאוחסן עכשיו תמיד ב-Bundle שמאפשר לקבוע בדיוק מאיפה מגיע המצב של fragment.
  • הממשק FragmentManager.OnBackStackChangedListener הורחב עם שתי קריאות חוזרות נוספות של onBackStackChangeStarted ו-onBackStackChangeCommitted שמופעלות עם כל Fragment מיד לפני שהן מתווספות או מוסרות ממחסנית החלקים הקודמים, ומיד אחרי שהטרנזקציה מאושרת, בהתאמה.
  • ‫FragmentStrictMode נוסף WrongNestedHierarchyViolation חדש שמזהה מתי שבר צאצא מוטמע בהיררכיית התצוגה של ההורה, אבל לא נוסף ל-childFragmentManager של ההורה.
  • ממשקי ה-API‏ Fragment ו-FragmentManager שמקבלים Intent או IntentSender מתויגים עכשיו בצורה נכונה באמצעות @NonNull כדי למנוע העברה של ערך null, כי ערך null תמיד יגרום לקריסה מיידית של ממשקי ה-API המתאימים של Android framework שהשיטות האלה קוראות להם.
  • ‫DialogFragment API מאפשר עכשיו גישה ל-ComponentDialog הבסיסי באמצעות requireComponentDialog() API.
  • הקטע תלוי עכשיו ב-Lifecycle 2.6.1.
  • ה-Fragment תלוי עכשיו ב-SavedState 1.2.1.
  • ‫Fragment תלוי עכשיו ב-ProfileInstaller 1.3.0.

  • הארטיפקט fragment-testing-manifest מפריד את רשומות המניפסט משאר רכיבי הבדיקה של הפרגמנט. כלומר, אתם יכולים:

    debugImplementation("androidx.fragment:fragment-testing-manifest:X.Y.Z")
androidTestImplementation("androidx.fragment:fragment-testing:X.Y.Z")

    כך נמנעות התנגשויות בגלל הבדלים בין הגרסאות של fragment-testing ושל androidx.test

גרסה ‎1.6.0-rc01

‫10 במאי 2023

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

תיקוני באגים

  • תוקנה בעיה שגרמה לשליחת ActivityResult עם קוד בקשה שגוי כשבוצעו כמה בקשות startActivityForResult ברצף. (If0b9d, b/249519359)
  • תוקנה בעיה שבה קריאות החזרה (callbacks) של onBackStackChangeListener נשלחו לעסקאות שלא שינו בפועל את מחסנית החזרה, אם הן שולבו עם עסקאות שכן שינו אותה. (I0eb5c, b/279306628)

גרסה ‎1.6.0-beta01

‫19 באפריל 2023

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

תיקוני באגים

  • שימוש ב-postponeEnterTransition עם פסק זמן והחלפת הפרגמנט שנדחה כבר לא גורם לדליפה של הפרגמנט שנדחה. (I2ec7d, b/276375110)
  • הקריאות החוזרות (callback) החדשות onBackStackChangeStarted ו-onBackStackChangeCommitted ישלחו עכשיו רכיב רק פעם אחת, גם אם כמה עסקאות מכילות את אותו רכיב. (Ic6b69)

גרסה ‎1.6.0-alpha09

‫5 באפריל 2023

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

שינויים ב-API

  • ‫DialogFragment API מאפשר עכשיו גישה ל-ComponentDialog הבסיסי באמצעות requireComponentDialog() API. ‫(I022e3, ‏ b/234274777)
  • הוספנו הערות ל-API של commitNow(), executePendingTransactions() ו-popBackStackImmediate() עם @MainThread, כלומר עכשיו הם יחזירו שגיאות בנייה אם לא יתבצעו קריאות ל-API מהשרשור הראשי, במקום להמתין עד לכישלון בזמן הריצה. ‫(Ic9665, ‏ b/236538905)

תיקוני באגים

  • תוקן באג ב-FragmentManager שבו שמירה ושחזור באותו פריים עלולים לגרום לקריסה. (Ib36af, ‏ b/246519668)
  • הפונקציות OnBackStackChangedListener onBackStackChangeStarted ו-onBackStackChangeCommitted של קריאות חוזרות מופעלות עכשיו רק כשמבצעים שינוי במחסנית האחורית FragmentManager. (I66055, b/274788957)

גרסה ‎1.6.0-alpha08

‫22 במרץ 2023

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

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

  • התזמון של OnBackStackChangedListener.onBackStackChangeCommited callback שונה כך שהוא יופעל לפני הפעלת פעולות של fragment. כך אפשר לוודא שהקריאה החוזרת אף פעם לא תעביר קטע שנותק. (I66a76, b/273568280)

תיקוני באגים

  • ‫Fragment 1.5.6: תוקנה בעיה שבה קריאה ל-clearFragmentResultListener בתוך setFragmentResultListener לא פעלה אם Lifecycle כבר היה STARTED ותוצאה כבר הייתה זמינה. (If7458)

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

גרסה ‎1.6.0-alpha07

‫8 במרץ 2023

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

תיקוני באגים

  • מתוך Fragment 1.5.6: תוקנה בעיה שבה הסרה של Fragment כלשהו, בין אם נוספו לו פריטים בתפריט ובין אם לא, הייתה מבטלת את התוקף של התפריט של הפעילות. (50f098, b/244336571)

גרסה ‎1.6.0-alpha06

‫22 בפברואר 2023

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

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

  • הקריאה החוזרת (callback) החדשה onBackStackChangedStarted ב-FragmentManager של onBackStackChangedListener תופעל עכשיו לפני שהפרגמנטים יתחילו לעבור למצבי היעד שלהם. (I34726)

גרסה ‎1.6.0-alpha05

‫8 בפברואר 2023

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

תכונות חדשות

  • ממשק FragmentManager.OnBackStackChagnedListener כולל עכשיו שתי פונקציות קריאה חוזרת נוספות, onBackStackChangeStarted ו-onBackStackChangeCommitted, שמאפשרות לקבל מידע נוסף ולשלוט יותר בשינויים שמתרחשים במחסנית החזרה FragmentManager. (Ib7ce5, ‏ b/238686802)

שינויים ב-API

  • ממשקי ה-API‏ Fragment ו-FragmentManager שמקבלים Intent או IntentSender מסומנים עכשיו בצורה נכונה באמצעות @NonNull כדי למנוע העברה של ערך null, כי ערך null תמיד יגרום לקריסה מיידית של ממשקי ה-API המתאימים של Android framework שהשיטות האלה קוראות להם. (I06fd4)

גרסה ‎1.6.0-alpha04

‫7 בדצמבר 2022

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

תכונות חדשות

  • ‫FragmentStrictMode נוסף WrongNestedHierarchyViolation חדש שמזהה מתי שבר צאצא מוטמע בהיררכיית התצוגה של ההורה, אבל לא נוסף ל-childFragmentManager של ההורה. ‫(I72521, b/249299268)

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

  • מקטעים משחזרים עכשיו את המצב שלהם SavedStateRegistry לפני onAttach(), כדי להבטיח שהוא זמין מכל שיטות מחזור החיים כלפי מעלה. (I1e2b1)

שינויים ב-API

  • ‫fragment-testing-manifest artifact מפריד את רשומות המניפסט משאר רכיבי הבדיקה של הפרגמנט. כלומר, אתם יכולים:
debugImplementation("androidx.fragment:fragment-testing-manifest:X.Y.Z")
androidTestImplementation("androidx.fragment:fragment-testing:X.Y.Z")

כך נמנעות התנגשויות בגלל הבדלים בגרסאות בין fragment-testing לבין androidx.test.(I8e534, b/128612536)

תיקוני באגים

  • מתוך Fragment 1.5.5: מעכשיו, כששומרים את המצב של תצוגת הרישום, המצב של ViewModel לא יישמר יותר באופן שגוי כחלק מהמצב השמור של תצוגת הרישום. (I10d2b, b/253546214)

גרסה ‎1.6.0-alpha03

‫5 באוקטובר 2022

התכונות androidx.fragment:fragment:1.6.0-alpha03, androidx.fragment:fragment-ktx:1.6.0-alpha03 וגם androidx.fragment:fragment-testing:1.6.0-alpha03 מושקות. גרסה ‎1.6.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

  • בכיתות שמרחיבות את DialogFragment, עכשיו נדרש להפעיל את הפונקציה super בביטולי ברירת המחדל של onDismiss(). (I14798, b/238928865)

תיקוני באגים

  • תוקנו רגרסיות שנגרמו כתוצאה מהשילוב של ממשקי ה-callback החדשים של הספק (OnConfigurationChangedProvider, ‏ OnMultiWindowModeChangedProvider, ‏ OnTrimMemoryProvider, ‏ OnPictureInPictureModeChangedProvider) כדי להבטיח שהפרגמנטים תמיד יקבלו את ה-callbacks המתאימים. ‫(I9b380,I34581, (I8dfe6, b/242570955),If9d6b,Id0096,I690b3,I2cba2)

גרסה ‎1.6.0-alpha02

‫24 באוגוסט 2022

התכונות androidx.fragment:fragment:1.6.0-alpha02, androidx.fragment:fragment-ktx:1.6.0-alpha02 וגם androidx.fragment:fragment-testing:1.6.0-alpha02 מושקות. גרסה ‎1.6.0-alpha02 מכילה את השמירות האלה.

תיקוני באגים

  • ‫Fragment 1.5.2: תוקנה בעיה שבה הפעלה של טרנזקציות popBackStack() ו-replace() בו-זמנית עלולה לגרום להפעלת Animation/Animator שגויים ב-fragments שיוצאים. (Ib1c07, ‏ b/214835303)

גרסה ‎1.6.0-alpha01

‫27 ביולי 2022

התכונות androidx.fragment:fragment:1.6.0-alpha01, androidx.fragment:fragment-ktx:1.6.0-alpha01 וגם androidx.fragment:fragment-testing:1.6.0-alpha01 מושקות. גרסה ‎1.6.0-alpha01 מכילה את השמירות האלה.

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

  • המצב השמור של Fragments פוצל לחלוטין בין מצב הספרייה הפרטית (מחלקות Parcelable בהתאמה אישית) לבין מצב שסופק על ידי המפתח, שמאוחסן עכשיו תמיד ב-Bundle שמאפשר לקבוע בדיוק מאיפה מגיע המצב של fragment. (b/207158202)

תיקוני באגים

  • ‫מ-Fragment 1.5.1: תוקנה רגרסיה ב-DialogFragmentCallbacksDetector שבה שימוש בגרסת ה-lint שצורפה ל-AGP 7.4 גרם לקריסה של lint. (b/237567009)

עדכון תלות

גירסה 1.5

גרסה 1.5.7

‫19 באפריל 2023

התכונות androidx.fragment:fragment:1.5.7, androidx.fragment:fragment-ktx:1.5.7 וגם androidx.fragment:fragment-testing:1.5.7 מושקות. גרסה 1.5.7 מכילה את השמירות האלה.

תיקוני באגים

  • שימוש ב-postponeEnterTransition עם פסק זמן והחלפת הפרגמנט שנדחה כבר לא גורם לדליפה של הפרגמנט שנדחה. (I2ec7d, b/276375110)

גרסה 1.5.6

‫22 במרץ 2023

התכונות androidx.fragment:fragment:1.5.6, androidx.fragment:fragment-ktx:1.5.6 וגם androidx.fragment:fragment-testing:1.5.6 מושקות. גרסה 1.5.6 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה הבעיה שבה הסרה של Fragment כלשהו, גם אם הוא הוסיף פריטים לתפריט וגם אם לא, ביטלה את התפריט של הפעילות. (50f098, b/244336571)
  • תוקנה בעיה שבה קריאה ל-clearFragmentResultListener בתוך setFragmentResultListener לא פעלה אם Lifecycle כבר היה STARTED והתוצאה כבר הייתה זמינה. (If7458)

גרסה 1.5.5

‫7 בדצמבר 2022

התכונות androidx.fragment:fragment:1.5.5, androidx.fragment:fragment-ktx:1.5.5 וגם androidx.fragment:fragment-testing:1.5.5 מושקות. גרסה 1.5.5 מכילה את השמירות האלה.

תיקוני באגים

  • הקטעים כבר לא ישמרו את המצב ViewModel בצורה שגויה כחלק מהמצב השמור של רישום התצוגה. (I10d2b, b/253546214)

גרסה 1.5.4

24 באוקטובר 2022

התכונות androidx.fragment:fragment:1.5.4, androidx.fragment:fragment-ktx:1.5.4 וגם androidx.fragment:fragment-testing:1.5.4 מושקות. גרסה 1.5.4 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה שגיאה שבה שימוש ב-FragmentController בהתאמה אישית עם מארח שלא מטמיע ממשק קריאה חוזרת של ספק (OnConfigurationChangedProvider,‏ OnMultiWindowModeChangedProvider,‏ OnTrimMemoryProvider,‏ OnPictureInPictureModeChangedProvider) וקריאה לפונקציית השליחה שהוצאה משימוש, לא יגרמו לשליחה לשברי צאצא. (I9b380)

גרסה 1.5.3

‫21 בספטמבר 2022

התכונות androidx.fragment:fragment:1.5.3, androidx.fragment:fragment-ktx:1.5.3 וגם androidx.fragment:fragment-testing:1.5.3 מושקות. גרסה 1.5.3 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה שגיאה שגרמה לכך שרכיבים במחסנית האחורית קיבלו קריאות חוזרות (callback) של onMultiWindowModeChanged(),‏ onPictureInPictureModeChanged(),‏ onLowMemory() ו-onConfigurationChanged(). (I34581, ‏ I8dfe6, ‏ b/242570955)
  • פרגמנטים של צאצאים מוטמעים כבר לא יקבלו כמה קריאות חוזרות (callback) של onMultiWindowModeChanged(), onPictureInPictureModeChanged(), onLowMemory() או onConfigurationChanged(). (I690b3, ‏ Id0096, ‏ If9d6b, ‏ I2cba2)

גרסה 1.5.2

‫10 באוגוסט 2022

התכונות androidx.fragment:fragment:1.5.2, androidx.fragment:fragment-ktx:1.5.2 וגם androidx.fragment:fragment-testing:1.5.2 מושקות. גרסה 1.5.2 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה בעיה שבה הפעלה של טרנזקציה מסוג popBackStack() וטרנזקציה מסוג replace() בו-זמנית עלולה לגרום להפעלת Animation/Animator שגויים של פרגמנטים יוצאים. (Ib1c07, ‏ b/214835303)

גירסה 1.5.1

‫27 ביולי 2022

התכונות androidx.fragment:fragment:1.5.1, androidx.fragment:fragment-ktx:1.5.1 וגם androidx.fragment:fragment-testing:1.5.1 מושקות. גרסה 1.5.1 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה רגרסיה ב-DialogFragmentCallbacksDetector שבה שימוש בגרסת ה-lint שצורפה ל-AGP 7.4 גרם לקריסת ה-lint. (b/237567009)

עדכון תלות

גרסה 1.5.0

29 ביוני 2022

התכונות androidx.fragment:fragment:1.5.0, androidx.fragment:fragment-ktx:1.5.0 וגם androidx.fragment:fragment-testing:1.5.0 מושקות. גרסה 1.5.0 מכילה את השמירות האלה.

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

  • שילוב CreationExtras – ל-Fragment יש עכשיו אפשרות לספק ViewModelProvider.Factory ללא מצב דרך Lifecycle 2.5.0’s CreationExtras.
  • שילוב של רכיבי דיאלוג – מעכשיו, DialogFragment משתמש ב-ComponentDialog דרך Activity 1.5.0 בתור תיבת הדו-שיח שמוחזרת כברירת מחדל על ידי onCreateDialog().
  • שינוי מבנה של מצב שמור של מופע – התחילו שינויים באופן שבו רכיבי Fragment שומרים את מצב המופע שלהם. המטרה היא לעזור לכם לזהות בבירור את המצב שנשמר בקטע ואת המקור של המצב. השינויים הנוכחיים כוללים:
    • ‫FragmentManager שומר עכשיו את מצב המופע השמור שלו ב-Bundle במקום ישירות ב-Parcelable בהתאמה אישית.
    • תוצאות שמוגדרות באמצעות Fragment Result APIs ועדיין לא נמסרו נשמרות עכשיו בנפרד מהמצב הפנימי של FragmentManager.
    • המצב שמשויך לכל פרגמנט נשמר עכשיו בנפרד מהמצב הפנימי של FragmentManager, וכך אפשר לקשר בין כמות המצב השמור שמשויכת לפרגמנט לבין המזהים הייחודיים שמופיעים ביומן הניפוי באגים של Fragment.

שינויים אחרים

  • ב-FragmentStrictMode יש עכשיו אפשרות לעקוף קנסות ספציפיים על הפרות של כללים באמצעות allowViolation() עם שם המחלקה.
  • ממשקי ה-API של Fragment שנועדו לספק תפריט ל-ActionBar של הפעילות הוצאו משימוש. ממשקי ה-API‏ MenuHost ו-MenuProvider שנוספו ב-Activity 1.4.0 מספקים משטח API שניתן לבדיקה ומודע למחזור החיים, שצריך להשתמש בו בשברים.

גרסה ‎1.5.0-rc01

‫11 במאי 2022

התכונות androidx.fragment:fragment:1.5.0-rc01, androidx.fragment:fragment-ktx:1.5.0-rc01 וגם androidx.fragment:fragment-testing:1.5.0-rc01 מושקות. גרסה ‎1.5.0-rc01 מכילה את השמירות האלה.

שינוי מבנה של מצב מופע שמור

  • המצב שמשויך לכל פרגמנט בודד נשמר עכשיו בנפרד מהמצב הפנימי של FragmentManager, וכך אפשר לקשר בין כמות המצב השמור שמשויכת לפרגמנט בודד לבין המזהים הייחודיים שמופיעים ביומן ניפוי הבאגים של הפרגמנט. (a153e0, b/207158202)

גרסה ‎1.5.0-beta01

‫20 באפריל 2022

התכונות androidx.fragment:fragment:1.5.0-beta01, androidx.fragment:fragment-ktx:1.5.0-beta01 וגם androidx.fragment:fragment-testing:1.5.0-beta01 מושקות. גרסה ‎1.5.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

  • ‫DialogFragment הוסיפה method חדש dismissNow שמשתמש ב-commitNow כדי להשיג שוויון עם הפונקציה showNow. הערה: הפעולה הזו לא תגרום להסרת Dialog באופן מיידי, אלא רק תעדכן באופן סינכרוני את המצב של FragmentManager. (I15c36, b/72644830)

Saved Instance State Refactoring

  • ‫FragmentManager שומר עכשיו את מצב המופע השמור שלו ב-Bundle במקום ישירות ב-Parcelable בהתאמה אישית. זה השלב הראשון בהגברת השקיפות לגבי מה שנשמר בפועל על ידי Fragments. ‫(I93807, b/207158202)
  • תוצאות שמוגדרות באמצעות ממשקי ה-API של Fragment Result ושעדיין לא נמסרו נשמרות עכשיו בנפרד מהמצב הפנימי של FragmentManager. כך תוכלו לקבל שקיפות נוספת לגבי התוצאות שנשמרות כחלק ממצב המופע השמור. ‫(I6ea12, ‏ b/207158202)

גרסה ‎1.5.0-alpha05

‫6 באפריל 2022

התכונות androidx.fragment:fragment:1.5.0-alpha05, androidx.fragment:fragment-ktx:1.5.0-alpha05 וגם androidx.fragment:fragment-testing:1.5.0-alpha05 מושקות. גרסה ‎1.5.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

גרסה ‎1.5.0-alpha04

‫23 במרץ 2022

התכונות androidx.fragment:fragment:1.5.0-alpha04, androidx.fragment:fragment-ktx:1.5.0-alpha04 וגם androidx.fragment:fragment-testing:1.5.0-alpha04 מושקות. גרסה ‎1.5.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

  • הוצאנו משימוש את ממשקי ה-API של Fragment שנועדו לספק תפריט ל-ActionBar של הפעילות, כי הם יוצרים קשר הדוק בין ה-Fragment לבין הפעילות, ואי אפשר לבדוק אותם בנפרד. ממשקי ה-API‏ MenuHost ו-MenuProvider שנוספו ב-Activity 1.4.0-alpha01 מספקים משטח API שניתן לבדיקה ומודע למחזור החיים, שצריך להשתמש בו בשברים. (I50a59, I20758)

תיקוני באגים

  • מעכשיו אפשר להשתמש ב-SavedStateViewFactory ב-CreationExtras גם אם הוא אותחל באמצעות SavedStateRegistryOwner. אם מספקים תוספים, המערכת מתעלמת מהארגומנטים שמוגדרים בהפעלה. ‫(I6c43b, ‏ b/224844583)

גרסה ‎1.5.0-alpha03

23 בפברואר 2022

התכונות androidx.fragment:fragment:1.5.0-alpha03, androidx.fragment:fragment-ktx:1.5.0-alpha03 וגם androidx.fragment:fragment-testing:1.5.0-alpha03 מושקות. גרסה ‎1.5.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

  • עכשיו אפשר להעביר את CreationExtras לפונקציות by viewModels() ו-by activityViewModels(). ‫(Ibefe7, ‏ b/217601110)

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

  • הבית DialogFragment משתמש עכשיו ב-ComponentDialog כברירת המחדל בתיבת הדו-שיח שמוחזרת על ידי onCreateDialog(). (If3784, b/217618170)

גרסה ‎1.5.0-alpha02

‫9 בפברואר 2022

התכונות androidx.fragment:fragment:1.5.0-alpha02, androidx.fragment:fragment-ktx:1.5.0-alpha02 וגם androidx.fragment:fragment-testing:1.5.0-alpha02 מושקות. גרסה ‎1.5.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

  • ב-FragmentStrictMode יש עכשיו אפשרות לעקוף קנסות ספציפיים על הפרות של כללים באמצעות allowViolation() עם שם המחלקה. (I8f678)

גרסה ‎1.5.0-alpha01

‫26 בינואר 2022

התכונות androidx.fragment:fragment:1.5.0-alpha01, androidx.fragment:fragment-ktx:1.5.0-alpha01 וגם androidx.fragment:fragment-testing:1.5.0-alpha01 מושקות. גרסה ‎1.5.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

תיקוני באגים

  • מ-Fragment 1.4.1: FragmentContainerView לא מוצגות יותר חריגות של מצב לא חוקי כשמזהי תצוגות שנוצרו מ-XML כוללים ערכים שליליים. (Ic185b, ‏ b/213086140)
  • מ-Fragment 1.4.1: כשמשתמשים ב-lambda מותאם אישית ownerProducer עם הפונקציה העצלנית by viewModels(), המערכת תשתמש עכשיו ב-defaultViewModelProviderFactory מהבעלים הזה אם לא סופק ViewModelProvider.Factory מותאם אישית, במקום להשתמש תמיד במפעל של ה-fragment. ‫(I56170, b/214106513)
  • תוקנה קריסה שהתרחשה כשניגשים אל ViewModel בפעם הראשונה מתוך קריאה חוזרת (callback) של registerForActivityResult() של Fragment. (Iea2b3)

גרסה 1.4

גרסה 1.4.1

‫26 בינואר 2022

התכונות androidx.fragment:fragment:1.4.1, androidx.fragment:fragment-ktx:1.4.1 וגם androidx.fragment:fragment-testing:1.4.1 מושקות. גרסה 1.4.1 מכילה את השמירות האלה.

תיקוני באגים

  • הפונקציה FragmentContainerView לא זורקת יותר חריגה של מצב לא חוקי כשמזהי תצוגה שנוצרו מ-XML כוללים ערכים שליליים. (Ic185b, ‏ b/213086140)
  • כשמשתמשים ב-lambda מותאם אישית ownerProducer עם הפונקציה העצלנית by viewModels(), המערכת תשתמש עכשיו ב-defaultViewModelProviderFactory מהבעלים הזה אם לא סופק ViewModelProvider.Factory מותאם אישית, במקום להשתמש תמיד ב-factory של הפראגמנט. ‫(I56170, b/214106513)

גרסה 1.4.0

17 בנובמבר 2021

התכונות androidx.fragment:fragment:1.4.0, androidx.fragment:fragment-ktx:1.4.0 וגם androidx.fragment:fragment-testing:1.4.0 מושקות. גרסה 1.4.0 מכילה את השמירות האלה.

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

  • ממשקי ה-API‏ FragmentStrictMode מספקים בדיקות בזמן ריצה שמאפשרות לכם לוודא שהאפליקציה או הספריות שאתם מסתמכים עליהן לא קוראות לממשקי API של קטעים שהוצאו משימוש. כשמזוהה הפרה, אפשר לבחור להדפיס הודעת יומן, להפעיל מאזין מותאם אישית משלכם או להקריס את האפליקציה. אפשר להגדיר את FragmentStrictMode.Policy ששולט באילו בדיקות מופעלות ובאילו 'עונשים' מופעלים ב-FragmentManager באמצעות השיטה החדשה setStrictModePolicy(). המדיניות הזו חלה על FragmentManager וגם על כל מנהלי קטעי הילדים שלא מגדירים מדיניות ייחודית משלהם. מידע נוסף זמין במאמר בנושא StrictMode למקטעים.

  • ‫FragmentContainerView מספק עכשיו method‏ getFragment() שמחזירה את הפריט שהתווסף לאחרונה למאגר. השיטה הזו משתמשת באותה לוגיקה כמו findFragmentById() עם המזהה של FragmentContainerView, אבל מאפשרת לשרשר את הקריאה.

    val navController = binding.container.getFragment<NavHostFragment>().navController

  • ‫FragmentScenario מטמיע עכשיו את Closeable, כך שאפשר להשתמש בו עם ה-method ‏use של Kotlin או עם try-with-resources.

  • נוספה האפשרות FragmentTransaction#TRANSIT_FRAGMENT_MATCH_ACTIVITY_{OPEN, CLOSE} לציין אם להפעיל את אנימציית המעבר הרגילה של הפעילות שנלקחה מהעיצוב במעבר של Fragments.

  • ה-API הניסיוני של FragmentManager.enableNewStateManager(boolean) הוסר, והכלי החדש לניהול מצבים הוא עכשיו האפשרות היחידה שזמינה.

Multiple back stacks

‫FragmentManager שומרת מחסנית של עסקאות fragment שהשתמשו ב-addToBackStack(). כך אפשר להוציא את העסקאות האלה ולהחזיר את המצב הקודם, באמצעות המנגנונים של שמירת מצב באמצעות רכיבי Fragment כדי לאפשר לרכיבי ה-Fragment לשחזר את המצב שלהם בצורה מתאימה.

בגרסה הזו הרחבנו את המנגנונים האלה והוספנו שלושה ממשקי API חדשים: FragmentManager,‏ saveBackStack(String name) ו-restoreBackStack(String name).clearBackStack(String name) ממשקי ה-API האלה משתמשים באותו name כמו addToBackStack() כדי לשמור את המצב של FragmentTransaction ואת המצב של כל מקטע שנוסף בעסקאות האלה, וכדי לאפשר לכם לשחזר מאוחר יותר את העסקאות האלה ואת המקטעים שלהן עם המצב שלהם. כך אפשר 'להחליף' בין כמה מחסני חזרה על ידי שמירת מחסן החזרה הנוכחי ושחזור מחסן חזרה שמור.

‫saveBackStack() פועלת באופן דומה ל-popBackStack() בכך שהיא אסינכרונית וגורמת לכל העסקאות של המקטעים שקשורות לשם הספציפי הזה להתבטל ('popped') ולכל המקטעים שנוספו להימחק ולהיפטר מהם, אבל יש כמה הבדלים חשובים:

  • הערך saveBackStack() תמיד כולל.
  • בניגוד ל-popBackStack(), שיוציא את כל העסקאות במחסנית האחורית אם השם שצוין לא נמצא במחסנית האחורית או אם צוין שם null, הפונקציה saveBackStack() לא תעשה כלום אם לא ביצעתם בעבר עסקת פרגמנט באמצעות addToBackStack() עם אותו שם מדויק שאינו null.
  • המצב של כל הפרגמנטים שנוספו מהעסקאות האלה נשמר. כלומר, מצב התצוגה של כל פרגמנט מאוחסן, הפונקציה onSaveInstanceState() של כל פרגמנט נקראת והמצב משוחזר, וכל מופע של ViewModel שמשויך לפרגמנטים האלה נשמר (והפונקציה onCleared() לא נקראת לגביהם).

עסקאות חלקיות שאפשר להשתמש בהן עם saveBackStack() צריכות לעמוד בקריטריונים מסוימים:

  • כל עסקה של שבר חייבת להשתמש ב-setReorderingAllowed(true) כדי להבטיח שאפשר יהיה לשחזר את העסקאות כפעולה אטומית אחת.
  • כדי להבטיח שאפשר יהיה לשחזר את קבוצת העסקאות בכל שלב מאוחר יותר, בלי קשר לשינויים שבוצעו במצבור הפעולות שניתן לבטל בזמן שחלף, קבוצת העסקאות שנשמרת צריכה להיות עצמאית (כלומר, לא יכולה להיות הפניה מפורשת לשברים מחוץ לקבוצת העסקאות הזו).
  • כדי לוודא ש-FragmentManager לא מחזיר הפניות לשברים שנשמרו אחרי שערמת החזרה נשמרת, אף שבר שנשמר לא יכול להיות שבר שנשמר או לכלול שבר שנשמר בקבוצת השברים הנגזרת של שברי הצאצא שלו.

בדומה ל-saveBackStack(), ל-restoreBackStack() ול-clearBackStack(), שמשחזרים או מוחקים בהתאמה את היסטוריית הפעולות שנשמרה, גם הפונקציות האלה לא עושות כלום אם לא קראתם קודם ל-saveBackStack() עם אותו שם.

מידע נוסף זמין במאמר Multiple back stacks: A deep dive (מספר ערימות של היסטוריית חזרה: ניתוח מעמיק).

גרסה ‎1.4.0-rc01

3 בנובמבר 2021

‫androidx.fragment:fragment:1.4.0-rc01 פורסמה ללא שינויים מ-Fragment 1.4.0-beta01. גרסה ‎1.4.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.4.0-beta01

‫27 באוקטובר 2021

התכונות androidx.fragment:fragment:1.4.0-beta01, androidx.fragment:fragment-ktx:1.4.0-beta01 וגם androidx.fragment:fragment-testing:1.4.0-beta01 מושקות. גרסה ‎1.4.0-beta01 מכילה את השמירות האלה.

תיקוני באגים

  • עכשיו, קטעי האב ישלחו את onHiddenChanged() למטה בכל ההיררכיה שלהם לפני הפעלת הקריאה החוזרת שלהם. ‫(Iedc20, ‏ b/77504618)
  • המקלדת תיסגר עכשיו באופן אוטומטי כשעוברים מקטע עם מקלדת פתוחה לקטע עם תצוגת רשימה. ‫(I8b842, ‏ b/196852211)
  • ‫DialogFragment משתמש עכשיו ב-setReorderingAllowed(true) לכל העסקאות שהוא יוצר כשמתקשרים אל show(),‏ showNow() או dismiss(). (Ie2c14)
  • האזהרה הארוכה מאוד של Lint‏ DetachAndAttachFragmentInSameFragmentTransaction קוצרה ל-DetachAndAttachSameFragment. (e9eca3)

גרסה ‎1.4.0-alpha10

‫29 בספטמבר 2021

התכונות androidx.fragment:fragment:1.4.0-alpha10, androidx.fragment:fragment-ktx:1.4.0-alpha10 וגם androidx.fragment:fragment-testing:1.4.0-alpha10 מושקות. גרסה ‎1.4.0-alpha10 מכילה את השמירות האלה.

Lint

  • נוספה DetachAndAttachFragmentInSameFragmentTransaction אזהרת lint לזיהוי קריאה ל-detach() ול-attach() באותו Fragment באותו FragmentTransaction – מכיוון שהפעולות המשלימות האלה מבטלות זו את זו כשהן מתבצעות באותה עסקה, צריך לפצל אותן לעסקאות נפרדות כדי שהן יבצעו פעולה כלשהי. (aosp/1832956, ‏ b/200867930)
  • נוספה שגיאת ה-lint‏ FragmentAddMenuProvider לתיקון השימוש במחזור החיים של Fragment במחזור החיים של תצוגת Fragment כשמשתמשים ב-API‏ addMenuProvider של MenuHost. (aosp/1830457, b/200326272)

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

  • הודעת הוצאה משימוש של ממשקי API שעכשיו מטופלים על ידי Activity Result APIs, כלומר startActivityForResult,‏ startIntentSenderForResult,‏ onActivityResult,‏ requestPermissions ו-onRequestPermissionsResult, הורחבה עם פרטים נוספים. (cce80f)
  • הודעת ההוצאה משימוש של onActivityCreated() עבור Fragment וגם עבור DialogFragment הורחבה וכוללת פרטים נוספים. (224db4)

גרסה ‎1.4.0-alpha09

‫15 בספטמבר 2021

התכונות androidx.fragment:fragment:1.4.0-alpha09, androidx.fragment:fragment-ktx:1.4.0-alpha09 וגם androidx.fragment:fragment-testing:1.4.0-alpha09 מושקות. גרסה ‎1.4.0-alpha09 מכילה את השמירות האלה.

תכונות חדשות

  • עכשיו אפשר להתקשר אל clearBackStack(name) כדי למחוק כל מצב שנשמר קודם באמצעות saveBackStack(name). (I70cd7)

שינויים ב-API

  • הכיתה FragmentContainerView נכתבה מחדש ב-Kotlin כדי להבטיח שהפונקציה getFragment תכבד את האפשרות של ערך null. (If694a, ‏ b/189629145)
  • ‫FragmentStrictMode נכתב עכשיו ב-Kotlin (‏I11767, ‏ b/199183506)

תיקוני באגים

  • תוקנה בעיה שבה מצב של Fragment שנוסף באמצעות setReorderingAllowed(true) ואז הוסר מיד לפני ביצוע עסקאות בהמתנה לא נוקה כראוי. (I8ccb8)

גרסה ‎1.4.0-alpha08

‫1 בספטמבר 2021

התכונות androidx.fragment:fragment:1.4.0-alpha08, androidx.fragment:fragment-ktx:1.4.0-alpha08 וגם androidx.fragment:fragment-testing:1.4.0-alpha08 מושקות. גרסה ‎1.4.0-alpha08 מכילה את השמירות האלה.

תיקוני באגים

  • שיפרנו את UseRequireInsteadOfGet בדיקת ה-Lint כדי לטפל טוב יותר בסוגריים מיותרים. (I2d865)
  • שיפרנו את UseGetLayoutInflater בדיקת Lint כדי לטפל במקרים נוספים של קצה. (Ie5423)

גרסה ‎1.4.0-alpha07

‫18 באוגוסט 2021

הגרסאות androidx.fragment:fragment:1.4.0-alpha07, androidx.fragment:fragment-ktx:1.4.0-alpha07 ו-androidx.fragment:fragment-testing:1.4.0-alpha07 יצאו ללא שינויים משמעותיים. גרסה ‎1.4.0-alpha07 מכילה את השמירות האלה.

גרסה ‎1.4.0-alpha06

4 באוגוסט 2021

התכונות androidx.fragment:fragment:1.4.0-alpha06, androidx.fragment:fragment-ktx:1.4.0-alpha06 וגם androidx.fragment:fragment-testing:1.4.0-alpha06 מושקות. גרסה ‎1.4.0-alpha06 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה בעיה שקשורה למספר מחסניות חזרה כשעוברים במהירות בין מחסניות חזרה, שמופיעה כ-IllegalStateException בזמן שחזור של FragmentTransaction או כעותק שני של קטע שמופיע. (I9039f)
  • תוקנה בעיה שבה FragmentManager שמר עותק של מצב שנשמר בעבר באמצעות saveBackStack() גם אחרי שהמצב הזה שוחזר. (Ied212)
  • השיטה dismissAllowingStateLoss() של DialogFragment כבר לא קורסת כשמפעילים אותה אחרי שהסטטוס נשמר, כשמוסיפים את DialogFragment באמצעות השיטה show(FragmentTransaction, String). (I84422)

גרסה ‎1.4.0-alpha05

21 ביולי 2021

התכונות androidx.fragment:fragment:1.4.0-alpha05, androidx.fragment:fragment-ktx:1.4.0-alpha05 וגם androidx.fragment:fragment-testing:1.4.0-alpha05 מושקות. גרסה ‎1.4.0-alpha05 מכילה את השמירות האלה.

תיקוני באגים

  • מתוך Fragment 1.3.6: התצוגה של Fragment מוגדרת עכשיו כ-GONE כשמשתמשים ב-hide() כשהתצוגה הבסיסית מוגדרת כ-transitionGroup=”true”. (aosp/1766655, b/193603427)
  • מ-Fragment 1.3.6: FragmentActivity עכשיו תמיד מבטל את הנעילה של המצב השמור כפעולה הראשונה שלו ב-lifecycle callbacks שהוא מבטל. (I6db7a)

עדכון תלות

גרסה ‎1.4.0-alpha04

‫30 ביוני 2021

התכונות androidx.fragment:fragment:1.4.0-alpha04, androidx.fragment:fragment-ktx:1.4.0-alpha04 וגם androidx.fragment:fragment-testing:1.4.0-alpha04 מושקות. גרסה ‎1.4.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

  • ‫FragmentManager משתמש עכשיו ב-SavedStateRegistry מאחורי הקלעים כדי לשמור את המצב שלו. גם ה-methods‏ saveAllState() ו-restoreSavedState() הוצאו משימוש ב-FragmentController. אם אתם משתמשים ב-FragmentController כדי לארח רכיבים מחוץ ל-FragmentActivity, אתם צריכים להטמיע את SavedStateRegistryOwner ב-FragmentHostCallbacks. ‫(Iba68e, ‏ b/188734238)

תיקוני באגים

  • תוקנה בעיה שבה הקריאה אל saveBackStack() כחלק מהתמיכה בכמה ערימות חזרה נכשלת כשמבצעים אותה בו-זמנית עם הפעלת FragmentTransaction שמשתמש ב-replace(). (I73137)
  • תוקנה בעיה NullPointerException שהתרחשה אחרי ששחזרו באופן ידני ערימה של פעולות שבוצעו לאחור שנשמרה והכילה כמה טרנזקציות, כשנעשה שימוש ב-API‏ restoreBackStack() לתמיכה בכמה ערימות של פעולות שבוצעו לאחור. בנוסף, תוקנה בעיה שבה לא בוצעה בדיקה של setReorderingAllowed(true) לכל העסקאות. (I8c593)
  • תוקנה בעיה שבה FragmentManager המשיך לשחזר באופן שגוי את המצב השמור הקודם של קטעים גם אחרי שהקטעים האלה הוסרו מ-FragmentManager, וכך המצב השמור גדל כל הזמן. (I1fb8e)

גרסה ‎1.4.0-alpha03

‫16 ביוני 2021

התכונות androidx.fragment:fragment:1.4.0-alpha03, androidx.fragment:fragment-ktx:1.4.0-alpha03 וגם androidx.fragment:fragment-testing:1.4.0-alpha03 מושקות. גרסה ‎1.4.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

  • כל המחלקות של Fragment StrictMode‏ Violation עודכנו עם הודעות שגיאה מפורטות יותר שמסבירות את פרטי ההפרה. (b/187871638)
    • FragmentTagUsageViolation מכיל עכשיו הודעת שגיאה מפורטת יותר שכוללת את מאגר האב שאליו אמור היה להתווסף הקטע. (Ic33a7)
    • WrongFragmentContainerViolation כולל עכשיו הודעת שגיאה מפורטת יותר, שכוללת את מאגר התגים שאליו נוסף קטע הקוד. (Ib55f8)
    • במקרים של הפרות, הודעות השגיאה של מחלקות תרחישי השימוש של TargetFragmentUsageViolation עכשיו מפורטות יותר וכוללות את הקטע שגרם להפרה וכל מידע אחר שכלול בהן. (Icc6ac)
    • המחלקות שמרחיבות את RetainInstanceUsageViolation כוללות עכשיו הודעות שגיאה מפורטות יותר, שכוללות את המקטע שגורם להפרה. (I6bd55)
    • מעכשיו, FragmentReuseViolation כולל הודעת שגיאה מפורטת יותר, שכוללת את המזהה הקודם של הקטע. (I28ce2)
    • SetUserVisibleHintViolation כולל עכשיו הודעת שגיאה מפורטת יותר, שכוללת את הרמז שגלוי למשתמש שהוגדר. (Ib2d5f)

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

  • הסרנו את ההגבלה על התקשרות אל fitsSystemWindows ב-FragmentContainerView – האפליקציה לא קורסת יותר. (6b8ddd, b/190622202)

תיקוני באגים

  • ‫From Fragment 1.3.5: Fixed a regression in shared element transitions introduced in Fragment 1.3.4 by aosp/1679887. מעכשיו, קטעי קוד מטפלים נכון בקבוצות מעבר (שמוגדרות ישירות באמצעות transitionGroup="true" או בעקיפין באמצעות transitionName או background), ורכיבים משותפים לא יגרמו יותר לשגיאות IndexOutOfBoundsException. (I16484, ‏ b/188679569, ‏ b/188969304)
  • האפליקציה FragmentManager לא תקרוס יותר כשמנסים להסתיר קטע שמוסר. (I573dd, b/183634730)
  • בדיקת ה-lint‏ OnCreateDialogIncorrectCallback לא תקרוס יותר כשמעריכים משתנה ברמה העליונה. (0a9efa, b/189967522)

גרסה ‎1.4.0-alpha02

‫2 ביוני 2021

התכונות androidx.fragment:fragment:1.4.0-alpha02, androidx.fragment:fragment-ktx:1.4.0-alpha02 וגם androidx.fragment:fragment-testing:1.4.0-alpha02 מושקות. גרסה ‎1.4.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

  • FragmentStrictMode תמיד יתעד הפרות אם הרישום מופעל באמצעות FragmentManager, ללא קשר למדיניות הנוכחית של המצב הקפדני שבה נעשה שימוש. (I02df6, b/187872638)

  • ‫FragmentStrictMode תומך עכשיו בהחרגת שיעורים מסוימים של Fragment משימוש במצב קפדני Violation, כך שהשיעור הזה לא יחויב בקנסות. ‫(Ib4e5d, ‏ b/184786736)

  • הרחבנו את המחלקה FragmentStrictMode Violation כדי להוסיף מידע על המבנה בהתאם לכל הפרה. כך תוכלו לראות בדיוק מה גרם להפרה, יחד עם המקטע המפר (If5118,‏ b/187871150). כל Violation מכיל את הפרטים הבאים:

    • ‫WrongFragmentContainerViolation כולל עכשיו את ViewGroup שניסית להוסיף ל-Fragment. (I83c75, b/187871150)
    • TargetFragmentUsageViolation הורחב ל-SetTargetFragmentUsageViolation,‏ GetTargetFragmentUsageViolation ו-GetTargetFragmentRequestCodeUsageViolation, כאשר SetTargetFragmentUsageViolation מכיל את קטע היעד ואת קוד הבקשה. (I741b4, ‏ b/187871150)
    • ‫SetUserVisibleHintViolation מכיל עכשיו את הערך הבוליאני שהועבר אל setUserVisibleHint(). (I00585, ‏ b/187871150)
    • ‫FragmentTagUsageViolation מכיל עכשיו את ViewGroup שהתג <fragment> ניסה להרחיב לתוכו קטע.(I5dbbc, ‏ b/187871150)
    • ‫FragmentReuseViolation מכיל עכשיו את המזהה הייחודי של המופע הקודם של Fragment שגרם להפרה. ‫(I0544d, ‏ b/187871150)
    • ‫RetainInstanceUsageViolation הוא עכשיו מופשט ויש לו שני תת-סוגים, SetRetainInstanceUsageViolation ו-GetRetainInstanceUsageViolation, שמייצגים את שני המקרים של סוג ההפרה. (Ic81e5, b/187871150)

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

  • ‫FragmentContainerView מעכשיו, ניסיון לשנות את המאפיין fitsSystemWindow באופן פרוגרמטי או באמצעות XML יגרום לחריגה. צריך לטפל בתוספות באמצעות התצוגה של כל רכיב Fragment בנפרד. (Ie6651, b/187304502)

גרסה ‎1.4.0-alpha01

‫18 במאי 2021

התכונות androidx.fragment:fragment:1.4.0-alpha01, androidx.fragment:fragment-ktx:1.4.0-alpha01 וגם androidx.fragment:fragment-testing:1.4.0-alpha01 מושקות. גרסה ‎1.4.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • ‫FragmentContainerView מספק עכשיו method‏ getFragment() שמחזירה את הפריט שהתווסף לאחרונה למאגר. השיטה הזו משתמשת באותה לוגיקה כמו findFragmentById() עם המזהה של FragmentContainerView, אבל מאפשרת לשרשר את הקריאה. ‫(Ife17a, ‏ b/162527857)

    val navController = binding.container.getFragment<NavHostFragment>().navController

  • נוספה האפשרות FragmentTransaction#TRANSIT_FRAGMENT_MATCH_ACTIVITY_{OPEN, CLOSE} לציין אם להפעיל את אנימציית המעבר הרגילה של הפעילות שנלקחה מהעיצוב במעבר של Fragments. (I46652)

Multiple back stacks

‫FragmentManager שומר על ערימת חזרה שמורכבת מעסקאות של קטעי קוד שהשתמשו ב-addToBackStack(). כך תוכלו להוציא את העסקאות האלה מהמחסנית ולחזור למצב הקודם, באמצעות המנגנונים של שמירת מצב באמצעות פרגמנטים כדי לאפשר לפרגמנטים לשחזר את המצב שלהם בצורה מתאימה.

בגרסה הזו הרחבנו את המנגנונים האלה והוספנו שני ממשקי API חדשים: FragmentManager ו-saveBackStack(String name) ו-restoreBackStack(String name). ממשקי ה-API האלה משתמשים באותו name כמו addToBackStack() כדי לשמור את המצב של FragmentTransaction ואת המצב של כל מקטע שנוסף בעסקאות האלה, וכדי לאפשר לכם לשחזר מאוחר יותר את העסקאות האלה ואת המקטעים שלהן עם המצב שלהם. כך אפשר 'להחליף' בין כמה מחסני חזרה על ידי שמירת מחסן החזרה הנוכחי ושחזור מחסן חזרה שמור.

‫saveBackStack() פועלת באופן דומה ל-popBackStack() בכך שהיא אסינכרונית וגורמת לכל העסקאות של המקטעים שקשורות לשם הספציפי הזה להתבטל ('popped') ולכל המקטעים שנוספו להימחק ולהיפטר מהם, אבל יש כמה הבדלים חשובים:

  • הערך saveBackStack() תמיד כולל.
  • בניגוד ל-popBackStack(), שיוציא את כל העסקאות במחסנית האחורית אם השם שצוין לא נמצא במחסנית האחורית או אם צוין שם null, הפונקציה saveBackStack() לא תעשה כלום אם לא ביצעתם בעבר עסקת פרגמנט באמצעות addToBackStack() עם אותו שם מדויק שאינו null.
  • המצב של כל הפרגמנטים שנוספו מהעסקאות האלה נשמר. כלומר, מצב התצוגה של כל פרגמנט מאוחסן, הפונקציה onSaveInstanceState() של כל פרגמנט נקראת והמצב משוחזר, וכל מופע של ViewModel שמשויך לפרגמנטים האלה נשמר (והפונקציה onCleared() לא נקראת לגביהם).

עסקאות חלקיות שאפשר להשתמש בהן עם saveBackStack() צריכות לעמוד בקריטריונים מסוימים:

  • כל עסקה של שבר חייבת להשתמש ב-setReorderingAllowed(true) כדי להבטיח שאפשר יהיה לשחזר את העסקאות כפעולה אטומית אחת.
  • כדי להבטיח שאפשר יהיה לשחזר את קבוצת העסקאות בכל שלב מאוחר יותר, בלי קשר לשינויים שבוצעו במצבור הפעולות שניתן לבטל בזמן שחלף, קבוצת העסקאות שנשמרת צריכה להיות עצמאית (כלומר, לא יכולה להיות הפניה מפורשת לשברים מחוץ לקבוצת העסקאות הזו).
  • כדי לוודא ש-FragmentManager לא מחזיר הפניות לשברירים שנשמרו אחרי שערמת החזרה נשמרה, אף שבריר שנשמר לא יכול להיות שבריר שנשמר או לכלול שבריר שנשמר בקבוצת השברירים הנגזרת שלו.

בדומה ל-saveBackStack(), הפונקציה restoreBackStack() לא עושה כלום אם לא קראתם קודם ל-saveBackStack() עם אותו שם. (b/80029773)

Fragment StrictMode

ממשקי ה-API‏ FragmentStrictMode מספקים בדיקות בזמן ריצה שמאפשרות לכם לוודא שהאפליקציה או הספריות שאתם מסתמכים עליהן לא קוראות לממשקי API של קטעים שהוצאו משימוש. כשמזוהה הפרה, אפשר לבחור להדפיס הודעת יומן, להפעיל מאזין מותאם אישית משלכם או לגרום לקריסת האפליקציה. אפשר להגדיר את FragmentStrictMode.Policy ששולט באילו בדיקות מופעלות ובאילו 'עונשים' מופעלים ב-FragmentManager באמצעות השיטה החדשה setStrictModePolicy(). המדיניות הזו חלה על FragmentManager וגם על כל מנהלי קטעי הילדים שלא מגדירים מדיניות ייחודית משלהם. ‫(#123, #131, #150, b/143774122)

  • ‫detectFragmentReuse() בודק אם מופע Fragment שהוסר בעבר מתווסף מחדש ל-FragmentManager. אסור לכם ליצור אינטראקציה עם מופע של Fragment או לשמור הפניה אליו אחרי שהוא נמחק והוסר מ-FragmentManager. (מס' 142, b/153738653)
  • המערכת של detectFragmentTagUsage() מזהה מתי אתם משתמשים בתג <fragment> בפריסת ה-XML. תמיד צריך להשתמש ב-FragmentContainerView כשמנפחים פרגמנטים כחלק מהפריסה. (#141, ‏ b/153738235)
  • ‫detectWrongFragmentContainer() מזהה מתי מוסיפים פרגמנט למאגר שהוא לא FragmentContainerView. תמיד צריך להשתמש ב-FragmentContainerView כמאגר לרכיבי Fragment בפריסה. (מס' 146, ‏ b/181137036)
  • ‫detectRetainInstanceUsage() מזהה מתי אתם משתמשים בממשקי ה-API ‏setRetainInstance() או getRetainInstance() שהוצאו משימוש. (מס' 140, b/153737954)
  • ‫detectSetUserVisibleHint() זיהוי השימוש ב-API ‏setUserVisibleHint() שהוצא משימוש. (מס' 136, b/153738974)
  • ‫detectTargetFragmentUsage() מזהה מתי אתם משתמשים בממשקי ה-API שהוצאו משימוש: setTargetFragment(), ‏ getTargetFragment() או getTargetRequestCode(). (מס' 139, b/153737745)

שינויים ב-API

בדיקות Lint חדשות

  • UseGetLayoutInflater הבדיקה של Lint מציגה עכשיו אזהרה כשמשתמשים ב-LayoutInflater.from(Context) בתוך DialogFragment – תמיד צריך להשתמש בשיטה getLayoutInflater() של קטע הדיאלוג כדי לקבל את הערך המתאים ל-LayoutInflater. (#156, b/170781346)
  • בדיקת DialogFragmentCallbacksDetector Lint מציגה עכשיו אזהרה כשקוראים ל-setOnCancelListener או ל-setOnDismissListener ב-method‏ onCreateDialog() של DialogFragment – הבעלות על מאזינים כאלה היא של DialogFragment עצמו, ועליכם להחליף את onCancel() ואת onDismiss() כדי לקבל את הקריאות החוזרות האלה. ‫(#171, ‏ b/181780047, ‏ b/187524311)

תיקוני באגים

  • ‫מ-Fragment 1.3.4: תוקנה רגרסיה שהוצגה ב-Fragment 1.3.3 כשמשתמשים ב-API‏ ViewTreeViewModelStoreOwner.get() עם ViewModelProvider או בשיטת Jetpack Compose‏ viewModel() בתוך Fragment. בתרחישי השימוש האלה, המערכת משתמשת עכשיו בצורה נכונה ב-ViewModelProvider.Factory שסופק על ידי Fragment אם הוא מבטל את getDefaultViewModelProviderFactory() (כמו במקרה של Fragments עם הערה @AndroidEntryPoint כשמשתמשים ב-Hilt). אם לא מבטלים את השיטה הזו, נוצרת SavedStateViewModelFactory ששומרת את המצב שלה ומחזירה אותו לצד התצוגה של Fragment, כברירת מחדל. (I5cbfa, ‏ b/186097368)
  • מ-Fragment 1.3.4: כשמשתמשים ב-FragmentContainerView ב-API 29, המרווחים הפנימיים לא נשלחים יותר ללא הגבלה, וכך נפתרות בעיות שקשורות למופעים של BottomNavigationBar ו-FloatingActionButton. (I1bb78, b/186012452)
  • מגרסה Fragment 1.3.4: עכשיו אפשר לאחזר את ה-Parcelable מ-bundle של תוצאת הפרגמנט אחרי שהתהליך הסתיים. (I65932, ‏ b/187443158)
  • מ-Fragment 1.3.4: כשמבצעים מעבר של רכיב משותף ב-ViewGroup, אם הערך של transitionGroup מוגדר כ-false ב-ViewGroup, המעבר יתבצע עכשיו בצורה תקינה. (I99675)

חישוב צריכת הנתונים

גרסה 1.3

גרסה 1.3.6

21 ביולי 2021

התכונות androidx.fragment:fragment:1.3.6, androidx.fragment:fragment-ktx:1.3.6 וגם androidx.fragment:fragment-testing:1.3.6 מושקות. גרסה 1.3.6 מכילה את השמירות האלה.

תיקוני באגים

  • מ-Fragment 1.4.0-alpha03: האפליקציה FragmentManager לא תקרוס יותר כשמנסים להסתיר fragment שמוסר. (I573dd, b/183634730)
  • התצוגה של Fragment מוגדרת עכשיו בצורה נכונה ל-GONE כשמשתמשים ב-hide() כשתצוגת הבסיס מוגדרת ל-transitionGroup=”true”. (aosp/1766655, b/193603427)
  • ‫FragmentActivity תמיד מבטל את הנעילה של המצב השמור כפעולה הראשונה שלו ב-callbacks של מחזור החיים שהוא מחליף. (I6db7a)

עדכון תלות

גרסה 1.3.5

‫16 ביוני 2021

התכונות androidx.fragment:fragment:1.3.5, androidx.fragment:fragment-ktx:1.3.5 וגם androidx.fragment:fragment-testing:1.3.5 מושקות. גרסה 1.3.5 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה רגרסיה במעברים של רכיבים משותפים שהוצגה ב-Fragment 1.3.4 על ידי aosp/1679887. מעכשיו, קטעי קוד מטפלים נכון בקבוצות מעבר (שמוגדרות ישירות באמצעות transitionGroup="true" או בעקיפין באמצעות transitionName או background), ורכיבים משותפים לא יגרמו יותר לשגיאות IndexOutOfBoundsException. (I16484, ‏ b/188679569, ‏ b/188969304)

גרסה 1.3.4

‫18 במאי 2021

התכונות androidx.fragment:fragment:1.3.4, androidx.fragment:fragment-ktx:1.3.4 וגם androidx.fragment:fragment-testing:1.3.4 מושקות. גרסה 1.3.4 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה רגרסיה שהוצגה ב-Fragment 1.3.3 כשמשתמשים ב-API ‏ViewTreeViewModelStoreOwner.get() עם ViewModelProvider או בשיטת Jetpack Compose ‏viewModel() בתוך Fragment כשמשתמשים ב-Hilt. בתרחישי השימוש האלה נעשה עכשיו שימוש נכון ב-ViewModelProvider.Factory שסופק על ידי Fragment אם הוא מחליף את getDefaultViewModelProviderFactory() (כמו במקרה של Fragments עם הערה @AndroidEntryPoint). אם לא מבטלים את השיטה הזו, נוצרת SavedStateViewModelFactory ששומרת את המצב שלה ומחזירה אותו לצד התצוגה של Fragment, כברירת מחדל. (I5cbfa, ‏ b/186097368)
  • כשמשתמשים ב-FragmentContainerView ב-API 29, לא מתבצע יותר שיגור ללא הגבלה של insets, וכך נפתרות בעיות שקשורות למופעים של BottomNavigationBar ושל FloatingActionButton. (I1bb78, b/186012452)
  • עכשיו אפשר לאחזר את ה-Parcelable מחבילת התוצאות של ה-Fragment אחרי שהתהליך הסתיים. (I65932, ‏ b/187443158)
  • כשמבצעים מעבר של אלמנט משותף ב-ViewGroup, אם הערך של transitionGroup מוגדר כ-false, המעבר יתבצע עכשיו בצורה תקינה. (I99675)

גרסה 1.3.3

21 באפריל 2021

התכונות androidx.fragment:fragment:1.3.3, androidx.fragment:fragment-ktx:1.3.3 וגם androidx.fragment:fragment-testing:1.3.3 מושקות. גרסה 1.3.3 מכילה את השמירות האלה.

תכונות חדשות

  • השימוש ב-SavedStateViewModelFactory פועל עכשיו כשמשתמשים בו עם SavedStateRegistryOwner שמוחזר על ידי שימוש ב-ViewTreeSavedStateRegistryOwner.get() עם התצוגה של Fragment. (I21acf, ‏ b/181577191)

תיקוני באגים

  • תוקנה רגרסיה שהוצגה ב-Fragment 1.3.2 וגרמה לכך שאנימציות של popEnter לא פעלו כשבוצעה פעולת setPrimaryNavFragment ב-FragmentTransaction, כמו אלה שמשמשות את NavHostFragment. (I38c87, b/183877426)
  • מעכשיו, FragmentContainerView מוודא שכל Fragment מקבל קבוצה חדשה של WindowInsets, כך שכל פרגמנט יכול לצרוך את השוליים באופן עצמאי. (I63f68, ‏ b/172153900)
  • ‫DialogFragment מטפל עכשיו בצורה נכונה במקרים שבהם נוסף רכיב צאצא למאגר שיש לו אותו מזהה כמו מאגר במחלקה המותאמת אישית Dialog, וכך פותר בעיות בהיררכיית התצוגה כשמשתמשים מחדש במזהים שנמצאים בשימוש פנימי בתיבות דו-שיח כמו BottomSheetDialog. (Ie6279, b/180021387)
  • ‫FragmentManager.dump() now properly indents the first fragment in the list of active fragments. (If5c33, b/183705451)

תיקוני באגים חדשים ב-State Manager

  • מנהל המצב החדש של קטעי קוד מטפל עכשיו בצורה תקינה במעברי יציאה באמצעות פעולות הסתרה. ‫(I9e4de, ‏ b/184830265)

גרסה 1.3.2

‫24 במרץ 2021

התכונות androidx.fragment:fragment:1.3.2, androidx.fragment:fragment-ktx:1.3.2 וגם androidx.fragment:fragment-testing:1.3.2 מושקות. גרסה 1.3.2 מכילה את השמירות האלה.

תיקוני באגים חדשים ב-State Manager

  • כשמריצים פעולות של popBackStack() ושל commit() ביחד, הפעולה האחרונה תגדיר עכשיו את הכיוון של כל האנימציות, במקום להריץ חלק מהאנימציות של פתיחת חלון וחלק מהאנימציות של כניסה. (I7072e, ‏ b/181142246)
  • התצוגות בהיררכיית רכיבים משותפים לא ינקו יותר את שם המעבר שלהן כשמבצעים מעבר של רכיב משותף. (I4d4a6, b/179934757)

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

  • ה-Fragment תלוי עכשיו ב-Activity 1.2.2, ומתקן בעיה בבדיקת ה-lint של Activity כשמשתמשים ב-Fragment 1.3.1 ומעלה.InvalidFragmentVersionForActivityResult
  • ה-Fragment תלוי עכשיו ב-Lifecycle 2.3.1.

גרסה 1.3.1

10 במרץ 2021

התכונות androidx.fragment:fragment:1.3.1, androidx.fragment:fragment-ktx:1.3.1 וגם androidx.fragment:fragment-testing:1.3.1 מושקות. גרסה 1.3.1 מכילה את השמירות האלה.

תכונות חדשות

  • מעכשיו, לתיבות דו-שיח ב-DialogFragment יש גישה לבעלים של ViewTree דרך DecorView, וכך אפשר להשתמש ב-DialogFragment עם ComposeView. (Ib9290, ‏ b/180691023)

תיקוני באגים

  • פרגמנטים שנופחו לפעילות RESUMED קיימת באמצעות FragmentContainerView מוצגים עכשיו בצורה תקינה אחרי שינוי בהגדרות. ‫(Ie14c8, ‏ b/180538371)
  • אין יותר } נוסף בסוף המקטע toString() (I54705, ‏ b/177761088)
  • שיטות שהוחלפו ב-FragmentActivity יורשות עכשיו בצורה תקינה את ה-JavaDoc של שיטת הבסיס (I736ce, ‏ b/139548782)
  • המסמכים של setFragmentResult ושל setFragmentResultListener עודכנו כדי לשקף שהם כבר לא מקבלים ערכים שניתנים לאיפוס (I990ba, b/178348386)

תיקוני באגים חדשים ב-State Manager

  • תוקן דליפת זיכרון בשברים שנגרמה על ידי mFocusedView (Ib4e9e, b/179925887)
  • ‫Fragments (קטעי קוד) קוראים עכשיו ל-onCreateOptionsMenu בצורה תקינה כשמשתמשים בעסקאות show/hide (הצגה/הסתרה) (I8bce8, ‏ b/180255554)
  • קטעי צאצא עם מעברים שמתחילים לפני שהפריסה של הקטע מסתיימת, יגיעו עכשיו כמו שצריך אל RESUMED (Ic11e6,‏ b/180825150)
  • מעכשיו, פרגמנטים שנוצרו באמצעות התג <fragment> תמיד יגיעו אל RESUMED (I452ac, (I9fa49)

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

גרסה 1.3.0

‫10 בפברואר 2021

התכונות androidx.fragment:fragment:1.3.0, androidx.fragment:fragment-ktx:1.3.0 וגם androidx.fragment:fragment-testing:1.3.0 מושקות. גרסה 1.3.0 מכילה את השמירות האלה.

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

  • New State Manager: בוצע שכתוב משמעותי של הרכיבים הפנימיים של FragmentManager, ובעקבות זאת תוקנו בעיות רבות שקשורות לשליחה של אירועים במחזור החיים, לאנימציות ולמעברים, ולטיפול בקטעים שנדחו.

  • שילוב של Activity Result API: נוספה תמיכה ב-ActivityResultRegistry API שהוצג ב-Activity 1.2.0 כדי לטפל בתהליכי עבודה של startActivityForResult()+onActivityResult() וגם של requestPermissions()+onRequestPermissionsResult() בלי להחליף שיטות ב-Fragment, בנוסף לאספקת hooks לבדיקת תהליכי העבודה האלה. אפשר לעיין במאמר המעודכן בנושא קבלת תוצאה מפעילות.

    • במהדורה הזו תוקנו מספר בעיות שקשורות לקודי בקשות לא תקינים ולשליחת בקשות הרשאה שמונעות מ-Activity Result API לפעול בגרסאות קודמות של FragmentActivity. כדי להשתמש ב-Activity Result APIs ב-FragmentActivity או ב-AppCompatActivity, צריך לשדרג ל-Fragment 1.3.0.

  • ‫Fragment Result API: נוספה תמיכה בהעברת תוצאות בין שני רכיבי Fragment באמצעות ממשקי API חדשים ב-FragmentManager. השיטה הזו פועלת עבור קטעי היררכיה (הורה/צאצא), DialogFragment וקטעים ב-Navigation, ומבטיחה שהתוצאות יישלחו רק ל-Fragment בזמן שהוא לפחות STARTED. ממשקי ה-API של קטע היעד הוצאו משימוש, ועכשיו צריך להשתמש בממשקי ה-API החדשים האלה. איך מקבלים תוצאות באמצעות Fragment Result API

  • ‫FragmentOnAttachListener: הקריאה החוזרת (callback) onAttachFragment() ב-FragmentActivity וב-Fragment יצאה משימוש. נוסף FragmentOnAttachListener חדש כדי לספק חלופה גמישה יותר, שמאפשרת להעביר את onAttachFragment() למאזינים נפרדים שניתן לבדוק אותם, ותמיכה בהוספת מאזין ל-FragmentManagers שאינם FragmentManager ישיר שלכם.

  • ‫FragmentScenario שיפורים: המחלקה FragmentScenario מתוך ארטיפקט fragment-testing נכתבה מחדש ב-Kotlin ונוספו לה כמה שיפורים:

    • ‫FragmentScenario משתמשת עכשיו ב-setMaxLifecycle() כדי להטמיע את moveToState(), וכך מבטיחה התנהגות עקבית בכל רמות ה-API ומפרידה בין מצב ה-Fragment לבין הפעילות הבסיסית.
    • ‫FragmentScenario תומך עכשיו בהגדרת Lifecycle.State ראשוני כדי לתמוך בהצהרה על מצב הפרגמנט לפני המעבר לכל Lifecycle.State בפעם הראשונה.
    • יש עכשיו חלופה ל-API‏ FragmentScenario של onFragment בצורה של ה-method‏ withFragment של Kotlin reified extension, שמאפשרת להחזיר ערך. חשוב לציין שהיא מעלה מחדש חריגים שנוצרו בבלוק הנתון.

  • ‫ViewTree Support: Fragment תומך עכשיו בממשקי ה-API‏ ViewTreeLifecycleOwner.get(View), ‏ ViewTreeViewModelStoreOwner.get(View) ו-ViewTreeSavedStateRegistryOwner שנוספו ב-Lifecycle 2.3.0 וב-SavedState 1.1.0, כך שהוא יחזיר את ה-Fragment בתור ViewModelStoreOwner, ואת SavedStateRegistryOwner ו-LifecycleOwner שקשורים ל-view Lifecycle של ה-Fragment כשמשתמשים ב-View בתוך Fragment.

  • TRANSIT_ שינויים באנימציה: אפקטי ברירת המחדל של הפריטים, TRANSIT_FRAGMENT_OPEN, TRANSIT_FRAGMENT_CLOSE ו-TRANSIT_FRAGMENT_FADE, משתמשים עכשיו ב-Animator במקום ב-Animation. המקורות ששימשו ליצירת האנימטורים האלה הם עכשיו פרטיים.

  • הוצאה משימוש של setRetainInstance(): השיטה setRetainInstance() ב-Fragments הוצאה משימוש. עם ההשקה של ViewModels, למפתחים יש API ספציפי לשמירת מצב שאפשר לשייך לפעילויות, לקטעים ולתרשימי ניווט. כך מפתחים יכולים להשתמש ב-Fragment רגיל שלא נשמר, ולשמור את המצב הספציפי שהם רוצים לשמור בנפרד. כך הם נמנעים ממקור נפוץ של דליפות, ועדיין יכולים ליהנות מהיתרונות של יצירה והרס יחידים של המצב שנשמר (כלומר, הקונסטרוקטור של ViewModel והקריאה החוזרת onCleared() שהוא מקבל).

  • הוצאה משימוש של מתאם ViewPager 1: עם ההשקה של ViewPager2 1.0.0, הוצאו משימוש המחלקות FragmentPagerAdapter ו-FragmentStatePagerAdapter לאינטראקציה עם ViewPager. מידע נוסף על מעבר מ-ViewPager ל-ViewPager2

גרסה ‎1.3.0-rc02

‫27 בינואר 2021

התכונות androidx.fragment:fragment:1.3.0-rc02, androidx.fragment:fragment-ktx:1.3.0-rc02 וגם androidx.fragment:fragment-testing:1.3.0-rc02 מושקות. גרסה ‎1.3.0-rc02 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה בעיה שבה רכיב הורה DialogFragment הופיע מעל רכיב צאצא DialogFragment אחרי שינוי בהגדרות. עכשיו, רכיבי צאצא של תיבת דו-שיח תמיד מופיעים מעל רכיבי הורה של תיבת דו-שיח. (I30806, ‏ b/177439520)
  • תוקנה בעיה שבה ביצוע פעולה של hide עם Animation גרם להבהוב של קטע ההסתרה בסוף האנימציה. (I57e22, ‏ b/175417675)
  • קטעים עם מעברים שנוספו לפני שההיררכיה של התצוגה מצורפת מגיעים עכשיו כמו שצריך אל RESUMED. (I1fc1d, ‏ b/177154873)

תיקוני באגים חדשים ב-State Manager

  • התצוגה של Fragment Lifecycle מטפלת עכשיו בצורה נכונה במקרים שבהם התצוגה של Fragment נהרסת לפני ש-Lifecycle מגיע אל CREATED, וכך נמנעות חריגות שבהן מצוין 'no event down from INITIALIZED'. ‏(eda2bd, ‏ b/176138645)
  • קטעים שמשתמשים ב-Animator מופיעים עכשיו בסדר הנכון כשמשתמשים ב-FragmentContainerView. ‫(Id9aa3, ‏ b/176089197)

גרסה ‎1.3.0-rc01

‫16 בדצמבר 2020

התכונות androidx.fragment:fragment:1.3.0-rc01, androidx.fragment:fragment-ktx:1.3.0-rc01 וגם androidx.fragment:fragment-testing:1.3.0-rc01 מושקות. גרסה ‎1.3.0-rc01 מכילה את השמירות האלה.

תיקוני באגים

  • ‫onPrepareOptionsMenu() פועל עכשיו לפי אותה לוגיקה כמו onCreateOptionsMenu(), והוא לא מופעל יותר כשפרגמנט אב מפעיל את setMenuVisibility(false). (Id7de8, b/173203654)

תיקוני באגים חדשים ב-State Manager

  • תוקנו דליפה וארטיפקט ויזואלי שקרו כשמוסיפים fragment עם Animation ל-FragmentContainerView ואז מפסיקים את ההוספה הזו באמצעות פעולת pop. (I952d8)
  • תוקנה בעיה שבה התצוגה של הפראגמנט נשארה בהיררכיית התצוגה אם היא הוחלפה במהלך השיטות onCreate() או onViewCreated(). (I8a7d5)
  • המיקוד משוחזר עכשיו בצורה תקינה לתצוגות הבסיסיות של Fragment כשממשיכים אותן. (Ifc84b)
  • שילוב של פעולות pop ו-replace באותה טרנזקציה של fragment יציג עכשיו את האנימציות המתאימות (Ifd4e4, ‏ b/170328691)

גרסה ‎1.3.0-beta02

‫2 בדצמבר 2020

התכונות androidx.fragment:fragment:1.3.0-beta02, androidx.fragment:fragment-ktx:1.3.0-beta02 וגם androidx.fragment:fragment-testing:1.3.0-beta02 מושקות. גרסה ‎1.3.0-beta02 מכילה את השמירות האלה.

תכונות חדשות

  • ‫FragmentScenario הומר במלואו ל-Kotlin תוך שמירה על תאימות של קוד המקור והקובץ הבינארי באמצעות שימוש בממשקים פונקציונליים של Kotlin 1.4 עבור FragmentAction. (I19d31)

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

  • אפשר להשתמש עכשיו ב-FragmentContainerViews שלא מבצעים ניפוח של fragment באמצעות המאפיין class או android:name מחוץ ל-FragmentActivity. (Id4397, b/172266337)
  • ניסיון להגדיר את משך החיים המקסימלי של פרגמנט ל-DESTROYED יגרום עכשיו להפעלת IllegalArgumentException (Ie7651, ‏ b/170765622)
  • הפעלת FragmentScenario עם מצב DESTROYED תגרום עכשיו להפעלת IllegalArgumentException (I73590, ‏ b/170765622)

תיקוני באגים חדשים ב-State Manager

  • תוקנה הבעיה שבה התצוגה לא מגיעה למצב הסופי שלה אם קוטעים מעבר של קטע שהשתמש ב-Animator או באחת מהאפשרויות של TRANSIT_FRAGMENT_. ‫(I92426, ‏ b/169874632)
  • תוקנה בעיה שמנעה את ההרס התקין של פרגמנטים עם Animation יציאה. (I83d65)
  • יציאה מקטעים שהאפקטים שלהם הפוכים מבטלת אותם עכשיו כמו שצריך ומפעילה אותם מחדש עם אפקט הכניסה הנכון. (I62226, b/167092035)
  • תוקנה בעיה שבה היציאה Animator מhide() לא פעלה. (Id7ffe)
  • עכשיו, קטעי וידאו מופיעים כמו שצריך כשדוחים את ההפעלה שלהם ואז מתחילים אותם מיד. ‫(Ie713b, ‏ b/170022857)
  • אם קטע קוד מסיר את התצוגה הממוקדת שלו במהלך אנימציה, הוא לא ינסה יותר לשחזר את המיקוד בתצוגה המנותקת כשהוא יגיע אל RESUMED (I38c65, b/172925703)

חישוב צריכת הנתונים

  • ‫FragmentFactory מטמון של מחלקות פרגמנטים נשמר עכשיו בנפרד עבור מופעים שונים של ClassLoader. תודה, Simon Schiller! (#87, b/113886460)

גרסה ‎1.3.0-beta01

‫1 באוקטובר 2020

התכונות androidx.fragment:fragment:1.3.0-beta01, androidx.fragment:fragment-ktx:1.3.0-beta01 וגם androidx.fragment:fragment-testing:1.3.0-beta01 מושקות. גרסה ‎1.3.0-beta01 מכילה את השמירות האלה.

תכונות חדשות

  • ‫setMaxLifecycle() תומך עכשיו בהגדרת המצב של Lifecycle ל-INITIALIZING כל עוד הפריט לא הועבר אל CREATED. (b/159662173)

שינויים ב-API

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

  • קבצי משאבים של קטעים הוגדרו כפרטיים בצורה נכונה. (aosp/1425237)

תיקוני באגים

  • קטעי קוד שהורחבו באמצעות התג <fragment> ימתינו עכשיו בצורה תקינה עד שהתצוגות שלהם יתווספו למאגר לפני שיעברו למצב STARTED ‏ (I02f4c)
  • אפקטי היציאה של קטעים שגלויים ואז setMaxLifecycle() עד CREATED פועלים עכשיו כמו שצריך. (b/165822335)
  • הסרה של פרגמנט מנותק שלא נוסף למחסנית החזרה לא גורמת יותר לדליפת זיכרון. באדיבות ניקלאס אנסמן גירץ! (b/166489383)
  • מעכשיו, תמיד יהיה ערך שאינו null ל-FragmentManager של פרגמנטים פעילים, ופרגמנטים עם ערך שאינו null ל-FragmentManager תמיד ייחשבו כפעילים. (aosp/1422346)
  • אפקטים שמוגדרים כברירת מחדל בקטע, TRANSIT_FRAGMENT_OPEN, TRANSIT_FRAGMENT_CLOSE ו-TRANSIT_FRAGMENT_FADE, משתמשים עכשיו ב-Animator במקום ב-Animation. (b/166155034)

תיקוני באגים חדשים ב-State Manager

  • מעכשיו, כשמתחילים אנימציה של רכיב Fragment, המערכת משחזרת את מצב המיקוד של התצוגה שלו כמו שהיה רגע לפני תחילת האנימציה. (Icc256)
  • פרגמנטים שיש להם רק מעבר של רכיב משותף משלימים עכשיו את האפקטים המיוחדים שלהם בצורה תקינה, כלומר הם עוברים למצב הסופי שלהם (Iaebc7,‏ b/166658128)
  • תצוגות של קטע תמיד מוסרות מהמאגר לפני שהן מושמדות. (Id5876)
  • מנהל המצב החדש מסיר עכשיו באופן עקבי את תצוגת הפרגמנט היוצאת לפני שהוא מוסיף את תצוגת הפרגמנט הנכנסת. (I41a6e)
  • מנהל המצב החדש מכבד עכשיו שינויים מפורשים בחשיפה של תצוגת fragment. כלומר, אם תגדירו את התצוגה של פרגמנט כניסה ל-INVISIBLE לפני שהאנימציה מתחילה, הוא יישאר בלתי נראה. (b/164481490)
  • מעכשיו, המערכת נותנת עדיפות ל-Animators על פני Animations, כלומר אם יש גם Animators וגם Animations בקטע, רק Animator יופעל ו-Animation יתעלם. (b/167579557)
  • מנהל המצבים החדש לא גורם יותר להבהוב של קטעים כשמשתמשים באנימציות כניסה. (b/163084315)

בעיה ידועה

כשמשתמשים במנהל המצבים החדש, אם לוחצים על 'חזרה' במהלך כניסה של אפקט מיוחד במקום לחזור לקטע הקודם, קטע הקוד הישן לא מתווסף מחדש, וכתוצאה מכך מוצג מסך ריק. (b/167259187, b/167092035, b/168442830)

גרסה ‎1.3.0-alpha08

‫19 באוגוסט 2020

התכונות androidx.fragment:fragment:1.3.0-alpha08, androidx.fragment:fragment-ktx:1.3.0-alpha08 וגם androidx.fragment:fragment-testing:1.3.0-alpha08 מושקות. גרסה ‎1.3.0-alpha08 מכילה את השמירות האלה.

New State Manager

הגרסה הזו כוללת שינוי משמעותי במבנה של ניהול המצב הפנימי של FragmentManager, שמשפיע על השליחה של שיטות מחזור חיים, אנימציות ומעברים, ועל האופן שבו מתבצע טיפול בעסקאות שנדחו. ההגדרה הזו מוצגת בממשק כברירת מחדל. פרטים נוספים זמינים בפוסט הזה בבלוג בנושא מקטעים: בנייה מחדש של הפנימיות. (b/139536619, b/147749580)

  • אפשר להשתמש ב-API ניסיוני ב-FragmentManager.enableNewStateManager(boolean) כדי לקבוע אם FragmentManager ישתמש במנהל המצב החדש. (I7b6ee)

הבעיות הבאות נפתרות רק כשמשתמשים במנהל המצבים החדש:

  • הקטע הקודם של פעולת replace נעצר עכשיו בצורה נכונה לפני שהקטע החדש מתחיל. (b/161654580)
  • מעכשיו, רכיבי Fragment מונעים הפעלה של כמה אנימציות מתחרות באותם רכיבי Fragment, כדי למנוע מקרים שבהם Animation יבטל את כל האפקטים של Transition, או שגם Animator וגם Transition יפעלו ברכיב Fragment נפרד. (b/149569323)
  • הפונקציות enterTransition ו-exitTranstion של כל הפרגמנטים שנכנסים ויוצאים מופעלות עכשיו, ולא רק הפרגמנט האחרון שנכנס והפרגמנט הראשון שיוצא. (b/149344150)
  • פרגמנטים שההעברה שלהם נדחתה לא נתקעים יותר במצב CREATED, אלא עוברים למצב STARTED עם פרגמנטים אחרים. (b/129035555)
  • תוקנה הבעיה שבה FragmentManager ביצע פעולות לא לפי הסדר כששילב בין טרנזקציה שנדחתה וסודרה מחדש לבין טרנזקציה שלא סודרה מחדש. (b/147297731)
  • אם דוחים את הצגת הפרגמנטים, לא יוצגו יותר פרגמנטים ביניים באופן זמני כשמציגים כמה פרגמנטים בו-זמנית. (b/37140383)
  • הפונקציה FragmentManager מחזירה עכשיו את הפרגמנטים הנכונים כשמתקשרים אל findFragmentById() או אל findFragmentByTag() מתוך הקריאה החוזרת (callback) onAttachFragment(). (b/153082833)
  • כשדוחים את החלפת הפרגמנט, הפרגמנטים כבר לא קוראים ל-onCreateView() כשהפרגמנטים מושמדים. (b/143915710)
  • הודעת השגיאה שמוצגת כשמנסים לשלב בין מופעים של framework‏ Transition ו-AndroidX‏ Transition מציינת עכשיו את הפריט עם המעבר הלא תקין. (b/155574969)

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

  • עכשיו אפשר להתקשר אל launch() ב-ActivityResultLauncher בשיטת מחזור החיים onCreate() של מקטע. (b/161464278)
  • הפעלת registerForActivityResult() אחרי onCreate() מעכשיו תגרום להצגת חריגה שמציינת שזה לא מותר, במקום לגרום לכשל שקט באספקת התוצאות אחרי שינוי בהגדרה. (b/162255449)
  • ‫FragmentActivity משתמש עכשיו ב-OnContextAvailableListener API שהוצג ב-Activity 1.2.0-alpha08 כדי לשחזר את המצב של FragmentManager. כל listeners שנוספו לתת-מחלקות של FragmentActivity יפעלו אחרי ה-listener הזה. (I513da)

תיקוני באגים

  • הערכים של ActivityOptions שעוברים דרך startIntentSenderForResult() נשמרים עכשיו. (b/162247961)

בעיה ידועה

  • כשמשתמשים במנהל המצב החדש, הגדרה ישירה של הנראות של תצוגת הבסיס של הפראגמנט אחרי onViewCreated() ולפני onResume() גורמת לכך שהנראות שהגדרתם מוחלפת על ידי FragmentManager, ששולט בנראות של תצוגת הבסיס. כפתרון עקיף, תמיד צריך להשתמש בפעולות hide() ו-show() כדי לשנות את ההגדרה של החשיפה של המקטע. (b/164481490)

גרסה ‎1.3.0-alpha07

22 ביולי 2020

התכונות androidx.fragment:fragment:1.3.0-alpha07, androidx.fragment:fragment-ktx:1.3.0-alpha07 וגם androidx.fragment:fragment-testing:1.3.0-alpha07 מושקות. גרסה ‎1.3.0-alpha07 מכילה את השמירות האלה.

תכונות חדשות

  • ‫FragmentScenario תומך עכשיו בהגדרה של מצב מחזור חיים ראשוני של CREATED, ‏STARTED או RESUMED, במקום להעביר תמיד את ה-Fragment למצב RESUMED. (b/159662750)
  • נוספה חלופה ל-API‏ FragmentScenario של onFragment בצורה של שיטת ההרחבה המוחשית של Kotlin‏ withFragment שמאפשרת להחזיר ערך. חשוב לציין שהיא מעלה מחדש חריגים שנוצרו בבלוק הנתון. (b/158697631)

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

  • ‫FragmentScenario משתמשת עכשיו ב-setMaxLifecycle() כדי להטמיע את moveToState(), וכך מבטיחה התנהגות עקבית בכל רמות ה-API ומפרידה בין מצב ה-Fragment לבין הפעילות הבסיסית. (b/156527405)
  • ה-SavedStateRegistryOwner שמוחזר על ידי ViewTreeSavedStateRegistryOwner קשור עכשיו למחזור החיים של תצוגת המקטע. כך המצב שלו נשמר ומשוחזר בו-זמנית עם התצוגה של ה-Fragment. (b/158503763)

תיקוני באגים

  • הקטעים ממתינים עכשיו עד שהתצוגה של הקטע מצורפת לפני שהם קוראים ל-ViewCompat.requestApplyInsets(), וכך נמנעים מקרים שבהם בקשת השוליים נפסלה. (b/158095749)
  • התקשרות אל clearFragmentResultListener מנקה עכשיו את observer מחזור החיים בצורה תקינה. (b/159274993)

גרסה ‎1.3.0-alpha06

‫10 ביוני 2020

התכונות androidx.fragment:fragment:1.3.0-alpha06, androidx.fragment:fragment-ktx:1.3.0-alpha06 וגם androidx.fragment:fragment-testing:1.3.0-alpha06 מושקות. גרסה ‎1.3.0-alpha06 מכילה את השמירות האלה.

תכונות חדשות

  • הקריאה החוזרת (callback) onAttachFragment() ב-FragmentActivity וב-Fragment הוצאה משימוש. נוסף FragmentOnAttachListener חדש כדי לספק חלופה גמישה יותר, שמאפשרת להעביר onAttachFragment() למאזינים נפרדים שניתן לבדוק אותם, ותמיכה בהוספת מאזין ל-FragmentManagers שאינם FragmentManager ישיר שלכם. (I06d3d)

תיקוני באגים

  • עכשיו, מצב התצוגה של פרגמנטים של הורה משוחזר לפני הפרגמנטים של הילד, וכך נפתרה בעיה של סדר חזותי אחרי שינוי בהגדרה, כש-DialogFragment יציג DialogFragment אחר כפרגמנט של ילד. (b/157195715)
  • תוקנה בעיה שבה UseRequireInsteadOfGet Lint check לא טיפל נכון בשימושים משורשרים באופרטורים ?. ו-!!. (b/157677616)

גרסה ‎1.3.0-alpha05

20 במאי 2020

התכונות androidx.fragment:fragment:1.3.0-alpha05, androidx.fragment:fragment-ktx:1.3.0-alpha05 וגם androidx.fragment:fragment-testing:1.3.0-alpha05 מושקות. גרסה ‎1.3.0-alpha05 מכילה את השמירות האלה.

תכונות חדשות

שינויים ב-API

  • ב-setFragmentResult() API וב-setFragmentResultListener() API יש עכשיו Bundle ו-FragmentResultListener שאי אפשר להגדיר כ-null. כדי לנקות במפורש תוצאה או מאזין שהוגדרו קודם, משתמשים בשיטות החדשות clearFragmentResult() ו-clearFragmentResultListener(). (b/155416778)
  • תוספי Kotlin שמקבלים lambda מסומנים עכשיו בסימן setFragmentResultListener().inline (b/155323404)

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

  • ‫startActivityForResult(),‏ startIntentSenderForResult() ו-requestPermissions שהוצאו משימוש ב-Fragment משתמשים עכשיו באופן פנימי ב-ActivityResultRegistry, ולכן אין יותר הגבלה על שימוש רק בביטים הנמוכים (מתחת ל-0xFFFF) עבור קודי הבקשות כשמשתמשים בממשקי ה-API האלה. (b/155518741)

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

  • הרחבנו את התיעוד בנושא בנאי Fragment(@LayoutRes int) ובנאי DialogFragment(@LayoutRes int) כדי להבהיר שצריך לקרוא להם מבנאי ללא ארגומנטים של מחלקות המשנה כשמשתמשים ב-FragmentFactory שמוגדר כברירת מחדל. (b/153042497)

גרסה ‎1.3.0-alpha04

29 באפריל 2020

התכונות androidx.fragment:fragment:1.3.0-alpha04, androidx.fragment:fragment-ktx:1.3.0-alpha04 וגם androidx.fragment:fragment-testing:1.3.0-alpha04 מושקות. גרסה ‎1.3.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו תמיכה בהעברת תוצאות בין שני רכיבי Fragment באמצעות ממשקי API חדשים ב-FragmentManager. השיטה הזו פועלת עבור קטעי היררכיה (הורה/צאצא), DialogFragment וקטעים ב-Navigation, ומבטיחה שהתוצאות יישלחו רק ל-Fragment בזמן שהוא לפחות STARTED. (b/149787344)

שינויים ב-API

  • ממשקי ה-API של קטע היעד הוצאו משימוש. כדי להעביר נתונים בין פרגמנטים, צריך להשתמש בממשקי ה-API החדשים של Fragment Result. (b/149787344)
  • ממשקי ה-API ‏startActivityForResult()/onActivityResult() ו-requestPermissions()/onRequestPermissionsResult() ב-Fragment הוצאו משימוש. צריך להשתמש ב-Activity Result APIs. (aosp/1290887)
  • שינוי שעלול לשבור תאימות מ-Activity 1.2.0-alpha04: השם של השיטה prepareCall() שונה ל-registerForActivityResult(). (aosp/1278717)

תיקוני באגים

  • הפעולה getViewLifecycleOwner() של המקטע נעצרת עכשיו לפני הקריאה ל-onSaveInstanceState(), ומשקפת את ההתנהגות של מחזור החיים של המקטע. (b/154645875)
  • הקריאה ל-setMenuVisibility(false) בקטע משנה עכשיו בצורה נכונה את החשיפה של התפריטים שסופקו על ידי קטעי הצאצא שלו. (b/153593580)
  • תוקנה בעיה illegalStateException בהוספת פרגמנט להיררכיית התצוגה של DialogFragment באמצעות FragmentContainerView. (b/154366601)
  • השיטה getDefaultViewModelProviderFactory() ב-fragments כבר לא קורסת כשמארחים את ה-fragments מחוץ לפעילות. (b/153762914)

גרסה ‎1.3.0-alpha03

‫1 באפריל 2020

התכונות androidx.fragment:fragment:1.3.0-alpha03, androidx.fragment:fragment-ktx:1.3.0-alpha03 וגם androidx.fragment:fragment-testing:1.3.0-alpha03 מושקות. גרסה ‎1.3.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

  • ה-methods של prepareCall ב-Fragment הן עכשיו final. (b/152439361)

תיקוני באגים

  • תוקנה רגרסיה שהוצגה ב-Fragment 1.3.0-alpha02 כשמשתמשים ב-BottomSheetDialogFragment. (b/151652127, aosp/1263328, aosp/1265163)
  • תוקנה קריסה שהתרחשה כשמשתמשים ב-prepareCall מתוך fragment אחרי שינוי בהגדרות. (b/152137004)
  • תוקנה בעיה שגרמה לכך שהמערכת התעלמה ממעברים של רכיבים משותפים וממעברי יציאה כשנעשה שימוש ב-setTargetFragment(). (b/152023196)
  • מתוך Fragment 1.2.4: עודכנו כללי ProGuard של Fragment כדי לאפשר טשטוש של פרגמנטים שנשמרו. (b/151605338)
  • מ-Fragment 1.2.4: השבתנו את כלל Lint‏ FragmentLiveDataObserve במחלקות DialogFragment כי מחזור החיים שלהן ומחזור החיים של התצוגה שלהן תמיד מסונכרנים, ולכן אפשר להשתמש ב-this או ב-viewLifecycleOwner כשקוראים ל-observe. (b/151765086)

שינויים בתלות

  • הקטעים תלויים ב-Activity 1.2.0-alpha03, שבו בוצעו שיפורים משמעותיים ב-Activity Result API שהוצג ב-Activity 1.2.0-alpha02.

גרסה ‎1.3.0-alpha02

‫18 במרץ 2020

התכונות androidx.fragment:fragment:1.3.0-alpha02, androidx.fragment:fragment-ktx:1.3.0-alpha02 וגם androidx.fragment:fragment-testing:1.3.0-alpha02 מושקות. גרסה ‎1.3.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

  • נוספה תמיכה ב-API‏ ActivityResultRegistry שהוצג ב-Activity 1.2.0-alpha02 כדי לטפל בתהליכי העבודה של startActivityForResult()+onActivityResult() וגם של requestPermissions()+onRequestPermissionsResult() בלי להחליף שיטות ב-Fragment, בנוסף לאספקת hooks לבדיקת תהליכי העבודה האלה. אפשר לעיין במאמר המעודכן בנושא קבלת תוצאה מפעילות. (b/125158199)

שינויים ב-API

  • ‫DialogFragment עכשיו מספק בנאי שמקבל @LayoutRes שמציין את הפריסה ש-onCreateView() צריך לנפח כברירת מחדל. (b/150327080)
  • השיטה onActivityCreated() הוצאה משימוש. קוד שמשפיע על התצוגה של המקטע צריך להיות ב-onViewCreated() (שנקרא מיד לפני onActivityCreated()), וקוד אתחול אחר צריך להיות ב-onCreate(). כדי לקבל קריאה חוזרת ספציפית כשהפעילות onCreate() הושלמה, צריך לרשום LifeCycleObserver ב-Lifecycle של הפעילות ב-onAttach(), ולהסיר אותה אחרי שמתקבלת הקריאה החוזרת onCreate(). (b/144309266)

תיקוני באגים

  • ‫Fragment 1.2.3: תוקן באג ב-DialogFragment שגרם ל-StackOverflowError כשמתקשרים אל getLayoutInflater() מתוך onCreateDialog(). (b/117894767, ‏ aosp/1258664)
  • מ-Fragment 1.2.3: צמצמנו את היקף כללי ProGuard הכלולים ב-Fragment כדי להבטיח שאפשר יהיה להסיר מחלקות Fragment שלא נמצאות בשימוש. (b/149665169)
  • ‫Fragment 1.2.3: תוקנו תוצאות חיוביות כוזבות בבדיקת Lint‏ UseRequireInsteadOfGet כשמשתמשים בשם של משתנה מקומי שמוסתר על ידי שם המאפיין של Kotlin. (b/149891163)
  • מ-Fragment 1.2.3: FragmentContainerView לא זורק יותר UnsupportedOperationException על שימוש בבונה שגוי בתצוגה מקדימה של פריסה. (b/149707833)

בעיות מוכרות

  • BottomSheetDialogFragment לא ממקם יותר את תיבת הדו-שיח שלו בצורה תקינה על המסך. (b/151652127)

גרסה ‎1.3.0-alpha01

‫4 במרץ 2020

התכונות androidx.fragment:fragment:1.3.0-alpha01, androidx.fragment:fragment-ktx:1.3.0-alpha01 וגם androidx.fragment:fragment-testing:1.3.0-alpha01 מושקות. גרסה ‎1.3.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו תמיכה ב-API‏ ViewTreeLifecycleOwner.get(View) שנוסף ב-Lifecycle 2.3.0-alpha01, כך שהוא יחזיר את viewLifecycleOwner של ה-Fragment בתור LifecycleOwner לכל התצוגות שמוחזרות על ידי onCreateView(). (aosp/1182955)

שינויים ב-API

  • השיטה setRetainInstance() ב-Fragments הוצאה משימוש. עם ההשקה של ViewModels, למפתחים יש API ספציפי לשמירת מצב שאפשר לשייך לפעילויות, לקטעים ולתרשימי ניווט. כך מפתחים יכולים להשתמש ב-Fragment רגיל שלא נשמר, ולשמור את המצב הספציפי שהם רוצים לשמור בנפרד. כך הם נמנעים ממקור נפוץ של דליפות, ועדיין יכולים ליהנות מהיתרונות של יצירה והרס יחידים של המצב שנשמר (כלומר, הקונסטרוקטור של ViewModel והקריאה החוזרת onCleared() שהוא מקבל). (b/143911815)
  • עם ההשקה של ViewPager2 1.0.0, הוצאו משימוש המחלקות FragmentPagerAdapter ו-FragmentStatePagerAdapter ליצירת אינטראקציה עם ViewPager. מידע נוסף על מעבר מ-ViewPager ל-ViewPager2 (b/145132715)

תיקוני באגים

  • כללי Fragment ProGuard שומרים עכשיו רק על בנאי ברירת המחדל של מחלקות Fragment שנעשה בהן שימוש, ולא על כל המופעים של Fragment, וכך מתקנים באג שנוצר ב-Fragment 1.2.1. (b/149665169
  • require___() כללי ה-Lint שנוספו ב-Fragment 1.2.2 כבר לא מציגים תוצאות חיוביות שגויות לגבי משתנים מקומיים ששמותיהם זהים לשמות המאפיינים של Kotlin שמוסתרים (כלומר, view). (b/149891163)
  • ‫FragmentContainerView כבר לא יוצר חריגה UnsupportedOperationException כשמשתמשים בתצוגה המקדימה של הפריסה ב-Android Studio. (b/149707833)
  • תוקנה בעיה שגרמה לכך שפרגמנטים שנשמרו והתווספו אחרי שמצב נשמר לא נוצרו מחדש באופן רציף ואז נמחקו אחרי כל שינוי בהגדרות. (b/145832397)

גרסה 1.2.5

גרסה 1.2.5

‫10 ביוני 2020

התכונות androidx.fragment:fragment:1.2.5, androidx.fragment:fragment-ktx:1.2.5 וגם androidx.fragment:fragment-testing:1.2.5 מושקות. גרסה 1.2.5 מכילה את השמירות האלה.

תיקוני באגים

  • הפעולה getViewLifecycleOwner() של המקטע נעצרת עכשיו לפני הקריאה ל-onSaveInstanceState(), ומשקפת את ההתנהגות של מחזור החיים של המקטע. התכונה הזו הושקה בעבר ב-Fragment 1.3.0-alpha04. (b/154645875)
  • הקריאה ל-setMenuVisibility(false) בקטע משנה עכשיו בצורה נכונה את החשיפה של התפריטים שסופקו על ידי קטעי הצאצא שלו. התכונה הזו הושקה בעבר ב-Fragment 1.3.0-alpha04. (b/153593580)

גרסה 1.2.4

גרסה 1.2.4

‫1 באפריל 2020

התכונות androidx.fragment:fragment:1.2.4, androidx.fragment:fragment-ktx:1.2.4 וגם androidx.fragment:fragment-testing:1.2.4 מושקות. גרסה 1.2.4 מכילה את השמירות האלה.

תיקוני באגים

  • עודכנו כללי ProGuard של Fragment כדי לאפשר טשטוש של פרגמנטים שנשמרו. (b/151605338)
  • השבתנו את כלל Lint‏ FragmentLiveDataObserve במחלקות DialogFragment כי מחזור החיים שלהן ומחזור החיים של התצוגה שלהן תמיד מסונכרנים, ולכן אפשר להשתמש ב-this או ב-viewLifecycleOwner כשקוראים ל-observe. (b/151765086)

גרסה 1.2.3

גרסה 1.2.3

‫18 במרץ 2020

התכונות androidx.fragment:fragment:1.2.3, androidx.fragment:fragment-ktx:1.2.3 וגם androidx.fragment:fragment-testing:1.2.3 מושקות. גרסה 1.2.3 מכילה את השמירות האלה.

תיקוני באגים

  • תוקן באג ב-DialogFragment שגרם ל-StackOverflowError כשמתקשרים אל getLayoutInflater() מתוך onCreateDialog(). (b/117894767, ‏ aosp/1258665)
  • צמצמנו את היקף כללי ProGuard הכלולים של Fragment כדי לוודא שאפשר להסיר מחלקות Fragment שלא נעשה בהן שימוש. (b/149665169)
  • תוקנו תוצאות חיוביות שגויות בבדיקת UseRequireInsteadOfGet Lint כשמשתמשים בשם של משתנה מקומי שמוסתר על ידי שם המאפיין ב-Kotlin. (b/149891163)
  • ‫FragmentContainerView לא זורק יותר UnsupportedOperationException על שימוש בבונה שגוי בתצוגה מקדימה של פריסה. (b/149707833)

גרסה 1.2.2

גרסה 1.2.2

‫19 בפברואר 2020

התכונות androidx.fragment:fragment:1.2.2, androidx.fragment:fragment-ktx:1.2.2 וגם androidx.fragment:fragment-testing:1.2.2 מושקות. גרסה 1.2.2 מכילה את השמירות האלה.

בדיקות Lint חדשות

  • כלי Lint מציע להשתמש ב-viewLifecycleOwner כ-LifecycleOwner לשיחות אל OnBackPressedDispatcher ב-onCreateView(), ב-onViewCreated() וב-onActivityCreated(). (b/142117657)
  • נוסף בדיקת Lint חדשה שמאשרת שנעשה שימוש נכון ב-debugImplementation כשמשתמשים בארטיפקט fragment-testing. (b/141500106)
  • במקום checkNotNull(get___()), requireNonNull(get___()) או get___()!!, קטעי הקוד מציעים עכשיו להשתמש בשיטות המשויכות require___() כדי לקבל הודעות שגיאה תיאוריות יותר, בכל ממשקי ה-API של קטעי הקוד שכוללים גם get וגם מקבילה של require. (aosp/1202883)

תיקוני באגים

  • תוקנו קובצי Fragment ProGuard כדי למנוע אזהרות R8 (b/148963981)
  • שיפרנו את בדיקת ה-Lint הקיימת שמציעה להשתמש ב-viewLifecycleOwner כשמשתמשים ב-observe, כדי לטפל גם בגרסת ה-method של התוסף livedata-ktx של observe. (b/148996309)
  • תוקן העיצוב של הרבה בדיקות Lint (‏aosp/1157012)

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

  • תודה ל-Zac Sweers על תרומתו לבדיקות Lint של require___() בשם Slack. (aosp/1202883)

גרסה 1.2.1

גרסה 1.2.1

‫5 בפברואר 2020

התכונות androidx.fragment:fragment:1.2.1, androidx.fragment:fragment-ktx:1.2.1 וגם androidx.fragment:fragment-testing:1.2.1 מושקות. גרסה 1.2.1 מכילה את השמירות האלה.

תיקוני באגים

  • ‫ProGuard שומר עכשיו את בנאי ברירת המחדל של רכיבי Fragment שנוספו באמצעות השיטות add ו-replace שמקבלות מופע Class (או את הגרסאות המוחשיות של Kotlin). (b/148181315)
  • הפונקציות FragmentStatePagerAdapter ו-FragmentPagerAdapter כבר לא מאתרות חריגים שמוחזרים על ידי FragmentManager כשמריצים את finishUpdate(). (aosp/1208711)
  • תוקנה הבעיה שבה התג FragmentManager.findFragment() לא פעל עם פרגמנטים שנוספו באמצעות התג <fragment>. (b/147784323)
  • כשמשתמשים בתג <fragment> כדי להרחיב Fragments, תמיד מתבצעת קריאה ל-onInflate() לפני onCreate() כש-Fragments נמצאים בפריסה. (aosp/1215856)
  • התקשרות אל toString() במופע FragmentManager כבר לא גורמת לשגיאה NullPointerException כשהפעילות כבר הושמדה. (b/148189412)

שינויים בתלות

גרסה 1.2.0

גרסה 1.2.0

‫22 בינואר 2020

התכונות androidx.fragment:fragment:1.2.0, androidx.fragment:fragment-ktx:1.2.0 וגם androidx.fragment:fragment-testing:1.2.0 מושקות. גרסה 1.2.0 מכילה את השמירות האלה.

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

  • ‫FragmentContainerView: FragmentContainerView הוא הקונטיינר המומלץ מאוד להוספה דינמית של Fragments, והוא מחליף את השימוש ב-FrameLayout או בפריסות אחרות. הוא תומך גם באותם class, android:name ובאותו android:tag אופציונלי כמו תג <fragment>, אבל הוא משתמש ב-FragmentTransaction רגיל כדי להוסיף את הקטע הראשוני הזה, במקום בנתיב הקוד המותאם אישית שבו משתמש תג <fragment>.
  • onDestroyView() תזמון: עכשיו, רכיבי Fragment מחכים שאנימציות יציאה, מעברים של framework יציאה ומעברים של AndroidX יציאה (כשמשתמשים ב-Transition 1.3.0) יושלמו לפני שהם קוראים ל-onDestroyView().
  • מבוסס מחלקה add() ו-replace(): נוספו עומסים חדשים של add() ו-replace() ב-FragmentTransaction שמקבלים Class<? extends Fragment> ו-Bundle אופציונלי של ארגומנטים. השיטות האלה משתמשות ב-FragmentFactory כדי ליצור מופע של המקטע שרוצים להוסיף. בנוסף, נוספו ל-fragment-ktx תוספים של Kotlin שמשתמשים בסוגים מוחשיים (כלומר, fragmentTransaction.replace<YourFragment>(R.id.container)).
  • ‫Lifecycle ViewModel SavedState Integration: SavedStateViewModelFactory היא עכשיו הגדרת ברירת המחדל של factory שמשמשת כשמשתמשים ב-by viewModels(), ב-by activityViewModels(), ב-constructor של ViewModelProvider או ב-ViewModelProviders.of() עם Fragment.
  • בדיקות Lint חדשות: נוספה בדיקת Lint חדשה שמוודאת שאתם משתמשים ב-getViewLifecycleOwner() כשאתם צופים ב-LiveData מ-onCreateView(), מ-onViewCreated() או מ-onActivityCreated().
  • הוצאה משימוש של getFragmentManager(): השיטות getFragmentManager() ו-requireFragmentManager() ב-Fragment הוצאו משימוש והוחלפו בשיטה אחת, getParentFragmentManager(), שמחזירה את הערך שאינו null‏ FragmentManager שאליו נוסף ה-Fragment (אפשר להשתמש ב-isAdded() כדי לקבוע אם אפשר לבצע קריאה).
  • הוצאה משימוש של FragmentManager.enableDebugLogging(): השיטה הסטטית FragmentManager.enableDebugLogging הוצאה משימוש. החל מעכשיו, FragmentManager מכבד את Log.isLoggable() עבור התג FragmentManager, כך שאפשר להפעיל רישום ביומן של DEBUG או VERBOSE בלי לבצע קומפילציה מחדש של האפליקציה.

בעיות מוכרות

  • ‫ProGuard לא שומר באופן אוטומטי קטעי קוד שמפנים אליהם רק באמצעות המאפיין class או android:name ב-FragmentContainerView, ולכן צריך להוסיף ידנית כלל שמירה לכל מחלקה של קטע קוד. (b/142601969)
  • כשמוסיפים NavHostFragment באמצעות class או android:name ב-XML עם FragmentContainerView, אי אפשר להשתמש ב-findNavController() ב-onCreate() של הפעילות. (b/142847973)

גרסה ‎1.2.0-rc05

8 בינואר 2020

התכונות androidx.fragment:fragment:1.2.0-rc05, androidx.fragment:fragment-ktx:1.2.0-rc05 וגם androidx.fragment:fragment-testing:1.2.0-rc05 מושקות. גרסה ‎1.2.0-rc05 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה רגרסיה ב-Fragment 1.2.0-rc04 כשמשתמשים בתג <fragment> שגרמה לקריאה שגויה של onViewCreated() במהלך השמדה של פעילות. (b/146290333)
  • כשמוסיפים קטעי קוד באמצעות התג <fragment>, המערכת מנקה עכשיו את קטעי הקוד שלא מוגדרים גם אם הם מופיעים בפריסה רק לפעמים (כלומר, רק בפריסה לרוחב). כתוצאה מכך, המקטעים האלה מועברים עכשיו בצורה נכונה אל CREATED גם אם הם לא בפריסה, במקום ליצור מופע שלהם אבל אף פעם לא להעביר אותם דרך שיטות מחזור החיים. (b/145769287)

גרסה ‎1.2.0-rc04

18 בדצמבר 2019

התכונות androidx.fragment:fragment:1.2.0-rc04, androidx.fragment:fragment-ktx:1.2.0-rc04 וגם androidx.fragment:fragment-testing:1.2.0-rc04 מושקות. גרסה ‎1.2.0-rc04 מכילה את השמירות האלה.

תיקוני באגים

  • התאמנו את האנימציות של TRANSIT_FRAGMENT_OPEN, TRANSIT_FRAGMENT_CLOSE ו-TRANSIT_FRAGMENT_FADE כדי למנוע בעיות ויזואליות. (b/145468417)

גרסה ‎1.2.0-rc03

4 בדצמבר 2019

התכונות androidx.fragment:fragment:1.2.0-rc03, androidx.fragment:fragment-ktx:1.2.0-rc03 וגם androidx.fragment:fragment-testing:1.2.0-rc03 מושקות. גרסה ‎1.2.0-rc03 מכילה את השמירות האלה.

תיקוני באגים

  • תוקן שינוי התנהגות לא מכוון שבו רכיבי Fragment שהוסרו עדיין מוחזרים על ידי findFragmentById() / findFragmentByTag() בזמן הפעלת אנימציות או מעברים של יציאה. (b/143982969, ‏ aosp/1167585)
  • עכשיו, קטעי צאצא נעצרים בצורה נכונה לפני ההורים שלהם כשהפעילות שמכילה אותם קוראת ל-onSaveInstanceState(). (b/144380645)
  • תוקנה בעיה שבה תצוגות סומנו באופן שגוי INVISIBLE אחרי הצגה של Fragment מוסתר. (b/70793925)
  • מעברים של רכיבים משותפים של Fragment מטפלים עכשיו בתצוגות שהוזזו, שונו, וכו' (b/142835261)

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

  • הוספנו הבהרות לתיעוד בנושא הוצאה משימוש של setUserVisibleHint(). (b/143897055)
  • שיפרנו את התיעוד בנושא setFragmentFactory() ו-getFragmentFactory() כדי להבהיר שהגדרת FragmentFactory תשפיע גם על FragmentManager צאצא. (aosp/1170095)

שינויים בתלות

  • ה-Fragments תלויים עכשיו ב-Lifecycle 2.2.0-rc03, ב-Lifecycle ViewModel SavedState 1.0.0-rc03 וב-Activity 1.1.0-rc03.

גרסה ‎1.2.0-rc02

‫7 בנובמבר 2019

התכונות androidx.fragment:fragment:1.2.0-rc02, androidx.fragment:fragment-ktx:1.2.0-rc02 וגם androidx.fragment:fragment-testing:1.2.0-rc02 מושקות. גרסה ‎1.2.0-rc02 מכילה את השמירות האלה.

תיקוני באגים

  • ב-Kotlin, התיקון של Lint לשימוש ב-getViewLifecycleOwner() כשמבצעים מעקב אחרי LiveData מ-onCreateView(),‏ onViewCreated() או onActivityCreated() (הוצג ב-Fragment 1.2.0-rc01) משתמש עכשיו בתחביר של גישה למאפיינים ב-Kotlin‏ viewLifecycleOwner במקום ב-getViewLifecycleOwner(). (aosp/1143821)

גרסה ‎1.2.0-rc01

‫23 באוקטובר 2019

התכונות androidx.fragment:fragment:1.2.0-rc01, androidx.fragment:fragment-ktx:1.2.0-rc01 וגם androidx.fragment:fragment-testing:1.2.0-rc01 מושקות. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

תכונות חדשות

  • ‫FragmentContainerView תומך עכשיו במאפיין class בנוסף למאפיין android:name, ומשקף את הפונקציונליות של תג <fragment>. (b/142722242)
  • נוסף בדיקת Lint חדשה שמוודאת שמשתמשים ב-getViewLifecycleOwner() כשצופים ב-LiveData מ-onCreateView(), מ-onViewCreated() או מ-onActivityCreated(). (b/137122478)

תיקוני באגים

  • הקריאות החוזרות (callback) onDismiss ו-onCancel ב-DialogFragment מבטיחות עכשיו שהערך DialogInterface שמועבר אליהן לא יהיה null, ושהפונקציה getDialog() תחזיר ערך שאינו null כשהן מופעלות. (b/141974033)
  • ‫FragmentContainerView מוסיף עכשיו את ה-Fragment שהוגדר על ידי class או android:name כחלק מה-inflation, וכך מוודא ש-findFragmentById() ו-findFragmentByTag() יפעלו מיד לאחר מכן. (b/142520327)
  • תוקנה בעיה IllegalStateException ב-FragmentContainerView בגלל שהמצב נשמר. (b/142580713)
  • תוקנה בעיה UnsupportedOperationException ב-FragmentContainerView כשהכיתה FragmentContainerView עוברת טשטוש. (b/142657034)

בעיות מוכרות

  • ‫ProGuard לא שומר באופן אוטומטי קטעי קוד שמפנים אליהם רק באמצעות המאפיין class או android:name ב-FragmentContainerView, ולכן צריך להוסיף ידנית כלל שמירה לכל מחלקה של קטע קוד. השבתנו את כלל ה-Lint שמציע לעבור אל FragmentContainerView עד שהבעיה הזו תיפתר באמצעות aapt2. (b/142601969)

גרסה ‎1.2.0-beta02

‫11 באוקטובר 2019

התכונות androidx.fragment:fragment:1.2.0-beta02, androidx.fragment:fragment-ktx:1.2.0-beta02 וגם androidx.fragment:fragment-testing:1.2.0-beta02 מושקות. גרסה ‎1.2.0-beta02 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה בעיה שבה הרכיב Fragment's onInflate() לא קיבל מאפיינים מתאימים מ-FragmentContainerView, מה שגרם לבעיות במקרים כמו NavHostFragment. (b/142421837)

גרסה ‎1.2.0-beta01

‫9 באוקטובר 2019

התכונות androidx.fragment:fragment:1.2.0-beta01, androidx.fragment:fragment-ktx:1.2.0-beta01 וגם androidx.fragment:fragment-testing:1.2.0-beta01 מושקות. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

תכונות חדשות

  • ‫FragmentContainerView מוסיף תמיכה בהוספת מקטע ראשוני עם תמיכה נוספת במאפייני ה-XML‏ android:name והאופציונלי android:tag. בניגוד לתג <fragment>, התג FragmentContainerView משתמש ב-FragmentTransaction רגיל מתחת לפני השטח כדי להוסיף את הפרגמנט הראשוני, וכך מאפשר לבצע פעולות נוספות של FragmentTransaction על FragmentContainerView וגם להשתמש ב-View Binding עבור הפריסה. (b/139830628, b/141177981)
  • ב-Fragments יש עכשיו אזהרת Lint שמציעה תיקון מהיר להחלפת <fragment> ב-FragmentContainerView. (b/139830056)

תיקוני באגים

  • תוקנה בעיה ב-ClassCastException כשמשתמשים ב-androidx.transition. (b/140680619)
  • כשמשתמשים ב-Transition 1.3.0-beta01, רכיבי Fragment ממתינים עכשיו עד לסיום המעברים של androidx.transition (בנוסף למעברים ולאנימציות של framework, שתוקנו ב-Fragment 1.2.0-alpha03 וב-Fragment 1.2.0-alpha02, בהתאמה) לפני שליחת onDestroyView(). (aosp/1119841)
  • כשמשתמשים ב-Transition 1.3.0-beta01, המעברים של Fragments מבוטלים עכשיו בצורה תקינה androidx.transition לפני שמתחילים מעברים או אנימציות חדשים באותו מאגר. (aosp/1119841)
  • תוקנה בעיה ב-API 17 ובגרסאות קודמות, כשמשתמשים במעברים של androidx.transition בתצוגת הבסיס של Fragment כשמשתמשים ב-FragmentContainerView. (b/140361893)
  • הארטיפקט fragment-testing תלוי עכשיו ב-AndroidX Test 1.2.0, ומתקן חוסר תאימות לגרסה האחרונה של Espresso 3.2.0. (b/139100149)
  • השימוש ב-Log.w הוסר ב-FragmentManager. (aosp/1126468)

בעיות מוכרות

  • רכיבי onInflate() של Fragment לא מקבלים מאפיינים מתאימים מ-FragmentContainerView, ולכן יש מקרים שבהם לא ניתן להשתמש ב-Fragment, למשל NavHostFragment. (b/142421837)

גרסה ‎1.2.0-alpha04

‫18 בספטמבר 2019

התכונות androidx.fragment:fragment:1.2.0-alpha04, androidx.fragment-ktx:example:1.2.0-alpha04 וגם androidx.fragment:fragment-testing:1.2.0-alpha04 מושקות. גרסה ‎1.2.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

  • השיטות getFragmentManager() ו-requireFragmentManager() ב-Fragment הוצאו משימוש והוחלפו בשיטה אחת, getParentFragmentManager(), שמחזירה את הערך שאינו null‏ FragmentManager שאליו נוסף ה-Fragment (אפשר להשתמש ב-isAdded() כדי לקבוע אם אפשר לבצע קריאה בבטחה). (b/140574496)
  • השיטה הסטטית FragmentManager.enableDebugLogging הוצאה משימוש. ה-FragmentManager מכבד עכשיו את Log.isLoggable() עבור התג FragmentManager, ומאפשר להפעיל את הרישום ביומן DEBUG או VERBOSE בלי לקמפל מחדש את האפליקציה. (aosp/1116591)

תיקוני באגים

  • מעכשיו, קטעי קוד נהרסים בצורה תקינה בזמן שאנימציות יציאה פועלות בקטעי קוד אחרים. (b/140574199)
  • תוקנה בעיה שבה רכיבי Fragment קראו ל-Activity.findViewById(), כשקודם הם לא עשו זאת. (aosp/1116431)

גרסה ‎1.2.0-alpha03

‫5 בספטמבר 2019

התכונות androidx.fragment:fragment:1.2.0-alpha03, androidx.fragment:fragment-ktx:1.2.0-alpha03 וגם androidx.fragment:fragment-testing:1.2.0-alpha03 מושקות. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

שינויים ב-API

  • ‫FragmentContainerView נקרא עכשיו final. (b/140133091)

תיקוני באגים

  • הפונקציה FragmentContainerView הופכת עכשיו את סדר הציור בצורה נכונה כשמוציאים פרגמנטים מהמחסנית האחורית. (b/139104187)
  • תוקנה בעיה שבה האנימציה הלא נכונה הופעלה כשגם הוצאה של קטע וגם הוספה של קטע חדש בוצעו בו-זמנית. (b/111659726)
  • עכשיו, פרגמנטים ממתינים לסיום המעברים (בנוסף לאנימציות, שהבעיה בהן נפתרה בFragment 1.2.0-alpha02) לפני שליחת onDestroyView(). (b/138741697)

גרסה ‎1.2.0-alpha02

‫7 באוגוסט 2019

הגרסאות androidx.fragment:fragment:1.2.0-alpha02, androidx.fragment:fragment-ktx:1.2.0-alpha02 ו-androidx.fragment:fragment-testing:11.2.0-alpha02 יוצאות לאור. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תכונות חדשות

  • ‫SavedStateViewModelFactory היא עכשיו ברירת המחדל של המפעל שמשמש כשמשתמשים ב-by viewModels(), ב-by activityViewModels(), בבונה ViewModelProvider או ב-ViewModelProviders.of() עם Fragment. (b/135716331)
  • אנימציות ברירת המחדל כשמשתמשים ב-TRANSIT_FRAGMENT_OPEN, ‏ TRANSIT_FRAGMENT_CLOSE, ‏ TRANSIT_FRAGMENT_FADE עם setTransition ב-FragmentTransaction עודכנו כך שיתאימו לאנימציות שמשמשות פעילויות במכשירי Android 10. (aosp/1012812, aosp/1014730)

שינויים ב-API

  • המאמר מציג את FragmentContainerView כקונטיינר מומלץ מאוד להוספה דינמית של Fragments, במקום השימוש ב-FrameLayout וכו', כי הוא פותר בעיות של סדר Z באנימציה ושליחה של חלונות שוליים ל-Fragments. (b/37036000, ‏ aosp/985243, ‏ b/136494650)
  • נוספה method סטטית FragmentManager.findFragment(View) לאחזור ה-Fragment שמכיל תצוגה שהורחבה על ידי Fragment. תוסף Kotlin זמין גם ב-fragment-ktx. (aosp/1090757)
  • נוספו עומסים חדשים של add() ו-replace() ב-FragmentTransaction שמקבלים Class<? extends Fragment> ו-Bundle אופציונלי של ארגומנטים. השיטות האלה משתמשות ב-FragmentFactory כדי ליצור מופע של המקטע שרוצים להוסיף. בנוסף, נוסף ל-fragment-ktx תוסף Kotlin שמשתמש בסוגים מוחשיים (כלומר, fragmentTransaction.replace<YourFragment>(R.id.container)). (b/126124987)
  • נוספו הערות @MainThread ל-callbacks של מחזור החיים Fragment. (b/127272564)
  • ממשקי ה-API שקשורים לכותרת של נתיב הניווט ב-FragmentTransaction וב-FragmentManager.BackStackEntry הוצאו משימוש. (b/138252944)
  • השיטה setTransitionStyle ב-FragmentTransaction הוצאה משימוש. (aosp/1011537)
  • הרבה מהשיטות ב-FragmentManager כבר לא abstract. המחלקות FragmentManager עצמן נשארות abstract ואין ליצור מהן מופעים או להרחיב אותן ישירות. צריך להמשיך לקבל רק מופע קיים מ-getSupportFragmentManager(), מ-getChildFragmentManager() וכו'.

תיקוני באגים

  • מתוך Fragment 1.1.0-rc04: מעברים שנדחו ב-Fragments מבוטלים עכשיו בצורה נכונה אחרי ש-Fragments נסגרו. (b/138251858)
  • ‫Fragment 1.1.0-rc03: תוקנה בעיה שבה קריאה ל-postponeEnterTransition() עם הגדרת זמן קצוב לתפוגה יותר מפעם אחת לא ביטלה את הזמנים הקצובים הקודמים לתפוגה. (b/137797118)
  • מתוך Fragment 1.1.0-rc02: תוקן קריסה ב-FragmentPagerAdapter וב-FragmentStatePagerAdapter כשמסירים את הפריט הנוכחי. (b/137209870)
  • עכשיו, לפני שמתבצעת שליחה של onDestroyView(), המערכת מחכה שאנימציות יסתיימו. (b/136110528)
  • אנימציות של Fragment מתתי-Fragments ומהצאצאים שלהם מטופלות עכשיו בצורה תקינה כשמפעילים אנימציה של ה-Fragment הראשי. (b/116675313)
  • תוקנה בעיה NullPointerException כשמשתמשים במעברים של רכיבים משותפים ומשלבים פעולת פתיחה ופעולת הוספה. (b/120507394)
  • נוסף פתרון עקיף ל-IllegalStateExceptions כשמשתמשים ב-FragmentPagerAdapter וב-FragmentStatePagerAdapter בבדיקות Robolectric. (b/137201343)

גרסה ‎1.2.0-alpha01

‫2 ביולי 2019

התכונות androidx.fragment:fragment:1.2.0-alpha01, androidx.fragment:fragment-ktx:1.2.0-alpha01 וגם androidx.fragment:fragment-testing:1.2.0-alpha01 מושקות. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תכונות חדשות

  • השיטה FragmentManager קוראת עכשיו ל-requestApplyInsets() אחרי צירוף התצוגה של Fragment ולפני הקריאה ל-onViewCreated(), כדי להבטיח שהתצוגה תמיד תכלול את השוליים הנכונים. (b/135945162)

תיקוני באגים

  • תוקן NullPointerException כשפותחים חלון קופץ של FragmentTransaction שהשתמש ב-setPrimaryNavigationFragment() לפני replace(). (b/134673465)

גרסה 1.1.0

גרסה 1.1.0

‫5 בספטמבר 2019

התכונות androidx.fragment:fragment:1.1.0, androidx.fragment:fragment-ktx:1.1.0 וגם androidx.fragment:fragment-testing:1.1.0 מושקות. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

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

  • ‫fragment-testing: ארטיפקט fragment-testing מספק מחלקה FragmentScenario לבדיקת קטע קוד בבידוד. פרטים נוספים מופיעים במסמכים בנושא בדיקת רכיבי Fragment באפליקציה.
  • ‫FragmentFactory: עכשיו אפשר להגדיר FragmentFactory ב-FragmentManager כדי לנהל את היצירה של מופעי fragment, וכך לא נדרש יותר קונסטרוקטור ללא ארגומנטים.
  • ‫Kotlin Property Delegates for ViewModels: ארטיפקט fragment-ktx כולל עכשיו שני Kotlin property delegates: ‏ by viewModels() לגישה ל-ViewModels שמשויכים לפרגמנטים בודדים ו-by activityViewModels() לגישה ל-ViewModels שמוגדרים בהיקף הפעילות.
  • מחזור חיים מקסימלי: עכשיו אפשר להגדיר מצב מקסימלי של מחזור חיים בשביל Fragment באמצעות קריאה ל-setMaxLifecycle() ב-FragmentTransaction. הדוח הזה מחליף את הדוח setUserVisibleHint() שהוצא משימוש. ל-FragmentPagerAdapter ול-FragmentStatePagerAdapter יש constructor חדש שמאפשר לעבור להתנהגות החדשה.
  • ה-constructor‏ LayoutId של FragmentActivity: מחלקות משנה של FragmentActivity יכולות עכשיו לקרוא באופן אופציונלי ל-constructor ב-FragmentActivity שמקבל מזהה R.layout, שמציין את הפריסה שצריך להגדיר כתצוגת התוכן כחלופה לקריאה ל-setContentView() ב-onCreate(). הפעולה הזו לא משנה את הדרישה שלמחלקת המשנה יהיה בנאי ללא ארגומנטים.
  • ‫Fragment LayoutId constructor: מחלקות משנה של Fragment יכולות עכשיו לקרוא באופן אופציונלי ל-constructor ב-Fragment שמקבל מזהה R.layout, שמציין את הפריסה שצריך להשתמש בה בשבר הזה כחלופה לביטול של onCreateView(). אפשר להגדיר את הפריסה המורחבת ב-onViewCreated().
  • דחייה עם פסק זמן: נוספה שיטת עומס יתר חדשה, postponeEnterTransition(), שכוללת פסק זמן.

גרסה ‎1.1.0-rc04

‫7 באוגוסט 2019

הגרסאות androidx.fragment:fragment:1.1.0-rc04, androidx.fragment:fragment-ktx:1.1.0-rc04 ו-androidx.fragment:fragment-testing:1.1.0-rc04 יוצאות לאור. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תיקוני באגים

  • הקטעים מבטלים עכשיו בצורה נכונה את המעברים שנדחו בקטעים שהוצאו. (b/138251858)

גרסה ‎1.1.0-rc03

‫19 ביולי 2019

הגרסאות androidx.fragment:fragment:1.1.0-rc03, androidx.fragment:fragment-ktx:1.1.0-rc03 ו-androidx.fragment:fragment-testing:1.1.0-rc03 יוצאות לאור. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תיקוני באגים

  • תוקנה בעיה שבה קריאה ל-postponeEnterTransition() עם הגדרת זמן קצוב לתפוגה יותר מפעם אחת לא ביטלה את הזמנים הקצובים הקודמים לתפוגה. (b/137797118)

גרסה ‎1.1.0-rc02

‫17 ביולי 2019

התכונות androidx.fragment:fragment:1.1.0-rc02, androidx.fragment:fragment-ktx:1.1.0-rc02 וגם androidx.fragment-testing:fragment:1.1.0-rc02 מושקות. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תיקוני באגים

  • תוקנה קריסה ב-FragmentPagerAdapter וב-FragmentStatePagerAdapter בזמן הסרת הפריט הנוכחי. (b/137209870)

גרסה ‎1.1.0-rc01

‫2 ביולי 2019

התכונות androidx.fragment:fragment:1.1.0-rc01, androidx.fragment:fragment-ktx:1.1.0-rc01 וגם androidx.fragment:fragment-testing:1.1.0-rc01 מושקות. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תיקוני באגים

  • כשמשתמשים בפעולות show() או hide() בזמן שהמעבר פועל, קטעי התוכן מעדכנים עכשיו את הגדרת החשיפה שלהם בצורה תקינה. (b/133385058)
  • תוקן NullPointerException כשפותחים חלון קופץ של FragmentTransaction שהשתמש ב-setPrimaryNavigationFragment() לפני replace(). (b/134673465)

גרסה ‎1.1.0-beta01

‫5 ביוני 2019

התכונות androidx.fragment:fragment:1.1.0-beta01, androidx.fragment:fragment-ktx:1.1.0-beta01 וגם androidx.fragment:fragment-testing:1.1.0-beta01 מושקות. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תיקוני באגים

  • ‫androidx.lifecycle.Lifecycle callbacks (במיוחד אלה שקשורים ל-STARTED,‏ RESUMED,‏ PAUSED,‏ STOPPED ו-DESTROYED) עבור רכיבי Fragment מוטמעים מקוננים עכשיו בצורה נכונה. (b/133497591)
  • מופעים של OnBackPressedCallback שנרשמו ב-onCreate() של Fragment מקבלים עכשיו עדיפות על פני FragmentManager של צאצא. (b/133175997)
  • פרגמנטים של ילדים לא מונפשים יותר כשהפרגמנט של ההורה שלהם מוחלף. (b/121017790)
  • עכשיו המערכת מתעלמת מהנפשות וממעברים של Fragments כשמשתמשים ב-animateLayoutChanges="true", וכך נפתרה בעיה שבה Fragments לא נהרסו כמו שצריך. (b/116257087)

גרסה ‎1.1.0-alpha09

‫16 במאי 2019

התכונות androidx.fragment:fragment:1.1.0-alpha09, androidx.fragment:fragment-ktx:1.1.0-alpha09 וגם androidx.fragment:fragment-testing:1.1.0-alpha09 מושקות. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

שינויים ב-API

  • עכשיו, כשקטע הניווט הראשי משתנה, מתבצעת קריאה חוזרת (callback) לקטע חדש של onPrimaryNavigationFragmentChanged(boolean). aosp/960857

תיקוני באגים

  • פריטי תפריט שהורחבו על ידי Fragment צאצא מוסרים עכשיו בצורה תקינה כשמסירים את Fragment האב. b/131581013

גרסה ‎1.1.0-alpha08

‫7 במאי 2019

התכונות androidx.fragment:fragment:1.1.0-alpha08, androidx.fragment:fragment-ktx:1.1.0-alpha08 וגם androidx.fragment:fragment-testing:1.1.0-alpha08 מושקות. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

הגרסה הזו לא תואמת לגרסאות Preferences 1.1.0-alpha01 עד 1.1.0-alpha04. אם משתמשים בגרסה הזו של Fragments, צריך לשדרג לגרסה Preferences 1.1.0-alpha05.

תכונות חדשות

  • נוסף עומס יתר חדש של postponeEnterTransition() שמקבל פסק זמן, שאחריו Fragment יקרא אוטומטית ל-startPostponedEnterTransition() b/120803208

שינויים ב-API

  • שינוי שעלול לשבור תאימות: הוסרה השיטה FragmentFactory instantiate שהוצאה משימוש בעבר, שקיבלה Bundle. aosp/953856
  • שינוי שעלול לשבור את התאימות: השמות של הקבועים RESUME_ONLY_CURRENT_FRAGMENT ו-USE_SET_USER_VISIBLE_HINT ב-FragmentPagerAdapter וב-FragmentStatePagerAdapter שונו ל-BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT ול-BEHAVIOR_SET_USER_VISIBLE_HINT, בהתאמה. aosp/954782

תיקוני באגים

  • פרגמנטים שמחזור החיים שלהם הוגבל באמצעות setMaxLifecycle() לא יחזרו יותר לפעולה לפני שיגיעו למצב הסופי שלהם. b/131557151
  • כשמשתמשים ב-setMaxLifecycle(Lifecycle.State.CREATED), התצוגה של רכיבי Fragment תיהרס כמו שצריך. aosp/954180

גרסה ‎1.1.0-alpha07

25 באפריל 2019

התכונות androidx.fragment:fragment:1.1.0-alpha07, androidx.fragment:fragment-ktx:1.1.0-alpha07 וגם androidx.fragment:fragment-testing:1.1.0-alpha07 מושקות. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תכונות חדשות

  • עכשיו אפשר להגדיר מצב מחזור חיים מקסימלי ל-Fragment על ידי קריאה ל-setMaxLifecycle() ב-FragmentTransaction. הדוח הזה מחליף את הדוח setUserVisibleHint() שהוצא משימוש. ל-FragmentPagerAdapter ול-FragmentStatePagerAdapter יש constructor חדש שמאפשר לעבור להתנהגות החדשה. (b/129780800)

שינויים ב-API

  • הקריאה ל-API‏ moveToState(STARTED) ב-FragmentScenario אפשרית עכשיו רק במכשירים עם API בגרסה 24 ומעלה. (b/129880016)

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

  • כתוצאה מ-(b/129907905), לא מתקבל קריאה חוזרת (callback) אל onCreateView() לגבי פרגמנטים במחסנית האחורית, כשהפעילות המארחת נוצרת מחדש. מעכשיו, הפונקציה onCreateView() תופעל רק כשהקטע יהיה גלוי (כלומר, כשמבטלים את הפעולה האחרונה בערימת הפעולות הקודמות).

תיקוני באגים

  • תוקנה בעיה שמתרחשת כשמשתמשים בתג <fragment> ב-XML ובבונה contentLayoutId של FragmentActivity או AppCompatActivity. (b/129907905)
  • תוקנה בעיה שבה קטעים במחסנית הקודמת לא הועברו לפחות אל CREATED אחרי שינוי בהגדרה, ולכן לא בוצע סילוק תקין של ViewModels ושל קטעים משניים שנשמרו. (b/129593351)
  • תוקנה קריסה ב-restoreSaveState שנגרמה בגלל חוסר סנכרון של הפרגמנטים שנשמרו אחרי שמצב המופע נשמר. (b/130433793) (aosp/947824)
  • תוקנו בעיות שבהן קריאה ל-OnBackPressedCallback שנוסף עם מחזור חיים של fragment לא התבצעה אם ל-FragmentManager היה back stack. פרטים נוספים מופיעים במאמר androidx.activity 1.0.0-alpha07. (aosp/948209)
  • האילוץ של LAYER_TYPE_HARDWARE לאנימציות כבר לא חל על Fragments. אם אתם צריכים אנימציה של שכבת חומרה באופן ספציפי, עליכם להגדיר אותה כחלק מהאנימציה. (b/129486478)

גרסה ‎1.1.0-alpha06

‫3 באפריל 2019

התכונות androidx.fragment:fragment:1.1.0-alpha06, androidx.fragment:fragment-ktx:1.1.0-alpha06 וגם androidx.fragment:fragment-testing:1.1.0-alpha06 מושקות. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תכונות חדשות

  • החריגים שמוחזרים על ידי FragmentManager כוללים עכשיו את שם ה-Fragment בהודעה. (b/67759402)

שינויים ב-API

  • ‫Fragment ו-FragmentActivity מכילים עכשיו בנאי שני שמקבל @LayoutRes int, שמחליף את ההתנהגות הקודמת של הוספת הערה לכיתה באמצעות @ContentView. הגישה הזו פועלת גם במודולים של אפליקציות וגם במודולים של ספריות. (b/128352521)
  • הפונקציה onActivityResult() של FragmentActivity מסומנת עכשיו בצורה תקינה כ-@CallSuper. (b/127971684)
  • הוצאנו משימוש את השיטה instantiate של FragmentFactory שמקבלת ארגומנט Bundle, ואפליקציות צריכות להשתמש בעומס היתר החדש של instantiate שלא מקבל Bundle. (b/128836103)
  • השיטות FragmentScenario מסומנות עכשיו בצורה תקינה באמצעות @StyleRes. (aosp/924193)
  • המאפיין FragmentTabHost הוצא משימוש. (b/127971835)
  • הפונקציה getThemedContext() של FragmentActivity הוסרה. (aosp/934078)

תיקוני באגים

  • תוקנה רגרסיה בגרסה 1.1.0-alpha05 שגרמה להבהוב של Fragment נכנס במסך. (b/129405432)
  • תוקנה בעיה שבה קטע הניווט הראשי אבד אחרי סדרה של פעולות popBackStack+replace+popBackStack. (b/124332597)
  • תוקנה בעיה שקרתה כשמשתמשים בבוני @ContentView בפעילות כשמשחזרים את מצב ה-Fragment. (b/127313094)
  • תוקנה הלוגיקה של setTargetFragment() כשמחליפים מקטע יעד קיים במקטע שעדיין לא צורף ל-FragmentManager. (aosp/932156)

גרסה ‎1.1.0-alpha05

‫13 במרץ 2019

התכונות androidx.fragment:fragment:1.1.0-alpha05, androidx.fragment:fragment-ktx:1.1.0-alpha05 וגם androidx.fragment:fragment-testing:1.1.0-alpha05 מושקות. כאן אפשר לראות את הרשימה המלאה של פעולות ה-commit שנכללות בגרסה הזו.

תכונות חדשות

  • חיפושים של הערות @ContentView נשמרים עכשיו במטמון (b/123709449)

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

  • שיחה אל remove(), אל hide(), אל show(), אל detach() ואל setPrimaryNavigationFragment() עם Fragment שמצורף אל FragmentManager אחר, מובילה עכשיו ל-IllegalStateException במקום לכשל שקט (aosp/904301)

תיקוני באגים

  • הערך onNewIntent עבור FragmentActivity מסומן עכשיו בצורה נכונה עם @CallSuper (b/124120586)
  • תוקנה בעיה שבה אפשר היה לקרוא ל-DialogFragment של onDismiss() פעמיים כשמשתמשים ב-getDialog().dismiss() או ב-getDialog().cancel() (b/126563750)

גרסה ‎1.1.0-alpha04

‫7 בפברואר 2019

התכונות androidx.fragment:fragment 1.1.0-alpha04, androidx.fragment:fragment-ktx 1.1.0-alpha04 וגם androidx.fragment:fragment-testing 1.1.0-alpha04 מושקות.

תכונות חדשות

  • הוספנו תמיכה בהערת המחלקה @ContentView שמאפשרת לציין איזה קובץ XML של פריסה צריך להרחיב כחלופה לביטול של onCreateView(). מומלץ לצפות בעבודות שקשורות לנושא ב-onViewCreated(). (aosp/837619)
  • ‫fragment-testing now depends on androidx.test:core-ktx 1.1.0 stable (b/121209673)
  • עכשיו אפשר להשתמש ב-openActionBarOverflowOrOptionsMenu עם FragmentScenario כדי לבדוק תפריטי אפשרויות של Fragment hosted (b/121126668)

שינויים ב-API

  • נוספה שיטת requireArguments() שמחזירה @NonNull Bundle או יוצרת IllegalStateException (b/121196360)
  • הוספנו הערה שלפיה אין לבטל את ההגדרה של getLifecycle(), getViewLifecycleOwner() ו-getViewLifecycleOwnerLiveData(), והן יהפכו לסופיות בגרסה עתידית. אם אתם משתמשים כרגע בשיטה הזו, אתם יכולים לשלוח בקשה להוספת תכונה. (aosp/880714)
  • הוספנו הערה שלפיה אין לבטל את ההגדרה של getViewModelStore(), והיא תהפוך לסופית בגרסה עתידית. אם אתם משתמשים כרגע בשיטה הזו, אתם יכולים לשלוח בקשה להוספת תכונה. (aosp/880713)
  • תוקנה בעיה בתאימות בינארית לגרסאות קודמות של Fragments. (aosp/887877) (aosp/889834)

תיקוני באגים

  • כשמעבירים את null אל setTargetFragment(), קטעי היעד נמחקים בצורה נכונה. (aosp/849969)
  • תוקנה הבעיה שבה לפעמים לא היו זמינים Fragments של יעד ב-onDestroy() או אחריו. (b/122312935)
  • השיטה onDismiss()‎ של DialogFragment מופעלת עכשיו לפני onDestroy(). (aosp/874133) (aosp/890734)

גרסה ‎1.1.0-alpha03

‫17 בדצמבר 2018

תכונות חדשות

  • ה-Fragment כולל עכשיו את BundleSavedStateRegistryOwner ותלוי בספריית SavedState החדשה [aosp/824380]
  • נוסף נציג מאפיינים של Kotlin כדי לאחזר ViewModels שמשויכים לפעילות המכילה [b/119050253]by activityViewModels
  • ההרחבה של by viewModels Kotlin property delegate מאפשרת להשתמש בשיטת lambda אופציונלית כדי לקבל את ViewModelStoreOwner, וכך להעביר את Fragment האב או ViewModelStoreOwner מותאם אישית אחר באמצעות קוד כמו val viewModel: MyViewModel by viewModels(::requireParentFragment) [b/119050253]

שינויים ב-API

  • ‫FragmentScenario מאפשרת עכשיו לציין עיצוב כמו Theme.AppCompat [b/119054431]. זהו שינוי תוכנה שעלול לגרום לכשל.
  • נוספה שיטת requireView() שמחזירה @NonNull View או יוצרת IllegalStateException [b/120241368]
  • נוספה method‏ requireParentFragment() שמחזירה @NonNull Fragment או יוצרת IllegalStateException [b/112103783]

תיקוני באגים

  • תוקן IllegalStateException: כשל בשמירת המצב b/120814739
  • קטעי קוד שמשוחזרים ממצב מופע שנשמר תמיד יקבלו עכשיו Bundle [b/119794496]
  • אם מוסיפים מחדש קטעים שהוסרו, הם לא משתמשים יותר באובייקט Lifecycle שלהם [b/118880674]

גרסה ‎1.1.0-alpha02

‫3 בדצמבר 2018

תכונות חדשות

  • התוספים של Kotlin ל-FragmentScenario מאפשרים עכשיו להשתמש בביטוי למדא ליצירת Fragment, כחלופה להעברת מופע של FragmentFactory. (aosp/812913)

תיקוני באגים

  • תוקן IllegalStateException כשמשתמשים ב-Fragments מקוננים במחסנית הקודמת (b/119256498)
  • תוקנה קריסה שהתרחשה כשמשתמשים ב-FragmentScenario.recreate() עם FragmentFactory (aosp/820540)
  • תוקנה בעיה שגרמה לכך שלא הייתה גישה לרכיבי Fragment של היעד אחרי שהרכיב הוסר (aosp/807634)

גרסה ‎1.1.0-alpha01

‫5 בנובמבר 2018

זו הגרסה הראשונה של fragment-testing artifact ושל FragmentScenario שמבוססת על androidx.test:core APIs. פרטים נוספים זמינים במאמרי העזרה בנושא בדיקת קטעי קוד.

תכונות חדשות

  • מחלקת FragmentScenario חדשה לבדיקת רכיבי Fragment בבידוד.
  • עכשיו אפשר להגדיר FragmentFactory בכל FragmentManager כדי לשלוט באופן יצירת המופעים החדשים של Fragment.
  • נוסף נציג חדש של מאפיין Kotlin‏ by viewModels() לאחזור ViewModel מ-Fragment.
  • אירועי קלט בהמתנה (כמו קליקים) מבוטלים עכשיו ב-onStop() של Fragment.

שינויים ב-API

  • הרחבנו באופן משמעותי את ההערות לגבי אפשרות ההגדרה כ-null ב-Fragment API.

תיקוני באגים

  • תוקנה בעיה שגרמה לכשל בפעולות של Fragment מתוך LiveData (b/77944637)

בעיות מוכרות

  • אי אפשר לגשת אל Target Fragments אחרי שמסירים Fragment מ-FragmentManager.
  • ‫fragment-testing תלוי ב-androidx.test:core:1.0.0-beta01 במקום ב-androidx.test:core:1.0.0 הנכון.