الجزء

قسِّم تطبيقك إلى شاشات متعددة ومستقلة مستضافة ضمن نشاط.
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
‫23 سبتمبر 2026 1.9.1 - - -

تحديد الاعتماديات

لإضافة اعتمادية على Fragment، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

Groovy

dependencies {
    def fragment_version = "1.9.1"

    // 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.9.1"

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

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات الإصدار.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.9

الإصدار 1.9.1

‫23 سبتمبر 2026

تم طرح androidx.fragment:fragment-*:1.9.1. يتضمّن الإصدار 1.9.1 هذه التعديلات.

الإصدار 1.9.0

‫12 أغسطس 2026

تم طرح androidx.fragment:fragment-*:1.9.0. يتضمّن الإصدار 1.9.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.8.0:

  • تنفِّذ Fragment الآن واجهة ContextAware ويمكن استخدامها لتنفيذ الرمز البرمجي عند ربط الجزء.
  • تقبل الدالة المركّبة AndroidFragment الآن المَعلمة maxLifecycle التي تتيح لك تحديد الحد الأقصى لحالة مراحل النشاط للدالة المركّبة Fragment المضمّنة.
  • تتيح مكتبة Fragment الآن تتبُّع النظام لأحداث يتم في مراحل النشاط من خلال Jetpack Tracing.

الإصدار ‎1.9.0-rc01

‫29 يوليو 2026

تم طرح androidx.fragment:fragment-*:1.9.0-rc01. يتضمّن الإصدار 1.9.0-rc01 هذه التعديلات.

إصلاح الأخطاء

  • عند استخدام FragmentScenario.launchInContainer، سيصبح الجزء قيد الاختبار داخل FragmentContainerView. (Ia6273، b/531550353)

الإصدار ‎1.9.0-alpha02

‫01 يوليو 2026

تم طرح androidx.fragment:fragment-*:1.9.0-alpha02. يتضمّن الإصدار 1.9.0-alpha02 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • أضِف المَعلمة maxLifecycle إلى العنصر القابل للإنشاء AndroidFragment. يتيح لك ذلك تحديد الحد الأقصى لحالة دورة حياة 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 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • تنفّذ الفئة Fragment الآن الواجهة ContextAware ويمكن استخدامها لتنفيذ الرمز البرمجي عند ربط الجزء. (I38019، b/477255355)

إصلاح الأخطاء

  • تم إصلاح عُطل في Fragment حدث عندما تم إرسال النشاط إلى الخلفية أثناء استخدام إيماءة الرجوع التوقّعية. (I55734، b/389589678)
  • لم يعُد UnsafeFragmentLifecycleObserverDetector يعمل ضمن التركيب. (Ic4176، b/501504696)
  • [من Fragment 1.8.9] تم إصلاح مشكلة كانت تتسبّب في عدم تحرّك الإيماءة اللاحقة بشكل صحيح عند استخدام أدوات إنشاء الرسوم المتحركة، وذلك عند إلغاء إيماءة إظهار شاشة الرجوع التي تؤدي إلى إيقاف عملية إخفاء. (I0a400، b/384765586)
  • [من الإصدار 1.8.9 من Fragment] تم إصلاح الخطأ الذي كان يحدث عند استخدام مجموعة من setMaxLifecycle وpopBackStack، ما كان يؤدي إلى تعذُّر نقل الجزء العلوي من الشاشة إلى الحالة RESUMED. (I3448b، b/406127576)
  • [من Fragment 1.8.8] تم إصلاح مشكلة كانت تؤدي إلى تعذُّر عمل FragmentManager أثناء محاولة حفظ حالة الأجزاء التي تمت إضافتها باستخدام setMaxLifecycle(Lifecycle.State.INITIALIZED). وبما أنّ هذه الأجزاء لم يتم عرضها مطلقًاonCreate()، لم يعُد لديها أي حالة محفوظة أو أي وظيفة onSaveInstanceState() تم استدعاؤها. (I6e37a، b/408163315)
  • [من الإصدار 1.8.7 من Fragment] تم إصلاح مشكلة عدم توفّر FragmentManager في الحالة المناسبة بعد عمليات pop وreplace في الإطار نفسه، ما قد يؤدي إلى حدوث عُطل بالتزامن مع ميزة "إيماءة إظهار شاشة الرجوع". (I50ad1، b/380288461)
  • [من Fragment 1.8.6] يمكن الآن أن يتلقّى الإجراء setOnApplyWindowInsetsListener override في FragmentContainerView قيمة فارغة للمستمع. (I575f0، b/282790626)
  • [من Fragment 1.8.5] تم إصلاح خطأ IllegalStateException تم تشغيله بواسطة saveBackStack فقط بعد إلغاء إيماءة إظهار شاشة الرجوع أو مقاطعتها. (I3387d، b/342419080)
  • [من Fragment 1.8.4] تم إصلاح خطأ UninitializedPropertyAccessException في AndroidFragment عند استبدال الفئة التي يستخدمها مثيل AndroidFragment بشكل ديناميكي. (I12dea، b/365578408)
  • [من Fragment 1.8.4] تم إصلاح مشكلة تؤدي إلى تعطُّل "التقسيمات" عند الضغط بسرعة على زر الرجوع في النظام أو تنفيذ إيماءة الرجوع السريع. (Ibc038، b/364804225، b/364914301)
  • [من Fragment 1.8.4] تم إصلاح مشكلة في الأجزاء حيث يؤدي إيقاف إيماءة الرجوع التوقّعية إلى وضع مدير الأجزاء في حالة غير محدّدة، بل ويؤدي إلى عرض الجزء غير الصحيح. (If82e2، b/338624457)
  • [من Fragment 1.8.3] لم يعُد AndroidFragment يتعطّل إذا تمت إضافته إلى التركيب بينما تكون حالة النشاط أو الجزء الذي يحتوي عليهما قد تم حفظها. (I985e9، b/356643968)
  • [من Fragment 1.8.2] لن يؤدي تفعيل الرجوع إلى الخلف في النظام أثناء تنفيذ عمليات معلّقة في FragmentManager إلى حدوث خطأ خارج النطاق. (I9ba32، b/342316801)
  • [من Fragment 1.8.2] يتعامل AndroidFragment الآن بشكل صحيح مع الحالات التي يتم فيها وضع الجزء الرئيسي في سجلّ الرجوع للأجزاء، ما يمنع حدوث مشاكل "لم يتم العثور على طريقة عرض لمعرّف" عند الرجوع إلى هذا الجزء. (I94608، b/347706985)
  • [من Fragment 1.8.2] تنتظر الأجزاء التي تمت إضافتها باستخدام الطريقة FragmentTransaction.add التي تأخذ ViewGroup اكتمال onContainerAvailable قبل الانتقال إلى onStart(). يؤثّر ذلك في مستخدمي واجهة برمجة التطبيقات هذه، مثل AndroidFragment، الذي ينتظر الآن إعادة إدخال AndroidFragment في التركيب قبل نقله عبر onStart(). (I94608، b/347706985)
  • [من Fragment 1.8.1] تم إصلاح مشكلة كانت تؤدي إلى إيقاف جزء بدون حاوية على الفور عند بدء إيماءة الرجوع التوقّعي. (If6b83، b/345244539)

المساهمة الخارجية

  • دمج fragment-ktx في مكتبة fragment أصبحت جميع إضافات Kotlin جزءًا من العنصر الرئيسي لإنشاء الأجزاء. وأصبح fragment-ktx الآن عنصرًا فارغًا لتحقيق التوافق. شكرًا "جيك وارتون". (Idabaa)

الإصدار 1.8

الإصدار 1.8.9

‫13 أغسطس 2025

تم طرح androidx.fragment:fragment-*:1.8.9. يتضمّن الإصدار 1.8.9 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح مشكلة كانت تؤدي إلى عدم تحرُّك الإيماءة اللاحقة بشكلٍ صحيح عند استخدام أدوات إنشاء الرسوم المتحركة، وذلك عند إلغاء إيماءة إظهار شاشة الرجوع التي تؤدي إلى ظهور عملية إخفاء. (I0a400، b/384765586)
  • تم إصلاح الخطأ الذي كان يتسبب في تعذُّر نقل الجزء العلوي إلى الحالة RESUMED عند استخدام مزيج من setMaxLifecycle وpopBackStack. (I3448b، b/406127576)

الإصدار 1.8.8

‫4 يونيو 2025

تم طرح androidx.fragment:fragment-*:1.8.8. يتضمّن الإصدار 1.8.8 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح مشكلة كانت تؤدي إلى تعطُّل FragmentManager عند محاولة حفظ حالة "القصاصات" التي تمت إضافتها باستخدام 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 هذه التعديلات.

إصلاح الأخطاء

  • يستقبل خيار إلغاء setOnApplyWindowInsetsListener في FragmentContainerView الآن أداة معالجة فارغة، ما يتوافق مع ما يسمح به إطار العمل. (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 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح مشكلة تعطل "التقسيمات" عند استخدام "عمليات الانتقال" في 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 الآن بشكل صحيح مع الحالات التي يتم فيها وضع الجزء الرئيسي في سجلّ الأنشطة السابقة للجزء، ما يؤدي إلى تجنُّب مشاكل "لم يتم العثور على طريقة عرض لمعرّف" عند الرجوع إلى هذا الجزء. (I94608)
  • تنتظر الأجزاء المُضافة باستخدام الطريقة FragmentTransaction.add التي تستخدم ViewGroup الآن onContainerAvailable قبل الانتقال إلى onStart(). يؤثر ذلك في مستخدمي واجهة برمجة التطبيقات هذه، مثل 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.
  • يتم الآن تشغيل وظيفة ردّ الاتصال onBackStackChangeCancelled في واجهة OnBackStackChangedListener الخاصة بـ FragmentManager كجزء من تنفيذ العمليات في FragmentManager، ما يجعلها أقرب إلى توقيت وظيفة ردّ الاتصال onBackStackChangeCommitted.

الإصدار ‎1.8.0-rc01

‫29 مايو 2024

تم طرح androidx.fragment:fragment-*:1.8.0-rc01. يتضمّن الإصدار 1.8.0-rc01 هذه التعديلات.

إصلاح الأخطاء

  • يتم الآن تشغيل دالة رد الاتصال onBackStackChangeCancelled في واجهة FragmentManagers OnBackStackChangedListener كجزء من تنفيذ العمليات في FragmentManager، ما يجعلها أقرب إلى توقيت دالة رد الاتصال 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 هذه التعديلات.

إصلاح الأخطاء

  • من الجزء 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 إضافة أجزاء إلى التسلسل الهرمي لـ Compose من خلال اسم فئة الجزء. تتولّى هذه الفئة تلقائيًا عملية حفظ حالة Fragment واستعادتها. يمكن استخدام هذا الخيار كبديل مباشر لربط عرض Android Composable.(b/312895363، Icf841)

التغييرات في المستندات

  • عدّلنا المستندات الخاصة بواجهات برمجة التطبيقات OnBackStackChangedListener لتوضيح الحالات التي يتم فيها طلب البيانات وكيفية استخدامها. (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 هذه التعديلات.

إتاحة إيماءة إظهار شاشة الرجوع

  • توفّر الآن "اللقطات" إمكانية استخدام ميزة "الرجوع التوقّعي داخل التطبيق" عند استخدام Animator أو عند استخدام AndroidX Transition 1.5.0. يتيح ذلك للمستخدمين استخدام إيماءة الرجوع لرؤية الجزء السابق من خلال البحث في Animator/Transition قبل اتّخاذ قرار إما بإكمال المعاملة من خلال إكمال الإيماءة أو إلغائها.
نظام الانتقال مورد XML التوافق مع ميزة "إيماءة إظهار شاشة الرجوع"
Animation R.anim لا
Animator R.animator نعم
إطار العمل Transition R.transition لا
‫AndroidX Transition مع Transition 1.4.1 أو إصدار أقدم R.transition لا
‫AndroidX Transition مع Transition 1.5.0 R.transition نعم

إذا واجهت أي مشاكل في توافق ميزة "الرجوع التوقّعي" مع "اللقطات" بعد تفعيل إيماءة الرجوع التوقّعي، يُرجى إبلاغ فريق Fragment عن المشكلة مع تقديم نموذج مشروع يعيد إنتاج المشكلة. يمكنك إيقاف إيماءة إظهار شاشة الرجوع باستخدام FragmentManager.enabledPredictiveBack(false) في onCreate() من النشاط.

توفّر السمة FragmentManager.OnBackStackChangedListener() الآن السمتَين onBackStackChangeProgressed() وonBackStackChangeCancelled() لتلقّي أحداث إلغاء وإحراز تقدّم في ميزة "إيماءة إظهار شاشة الرجوع" على التوالي.

حزمة Fragment Compose

تم إنشاء أداة fragment-compose جديدة تركّز على دعم التطبيقات التي بصدد الانتقال من بنية مستندة إلى Fragment إلى بنية مستندة إلى Compose بالكامل.

الميزة الأولى المتاحة في هذا العنصر الجديد هي طريقة content الإضافية في Fragment التي تسعى إلى تسهيل استخدام Compose لواجهة المستخدم الخاصة بأحد 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 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • تمت إعادة كتابة FragmentHostCallback بلغة Kotlin لكي تتطابق إمكانية قبول القيم الفارغة للنوع العام من Host مع إمكانية قبول القيم الفارغة لنوع القيمة التي تم إرجاعها في onGetHost(). (I40af5)

إصلاح الأخطاء

  • تم إصلاح مشكلة عدم إيقاف جزء نهائيًا عند تنفيذ إيماءة "الرجوع التوقّعي" على جزء غير موجود في حاوية. سيتم الآن نقل Fragment على الفور إلى الحالة النهائية. (Ida0d9)
  • تم إصلاح مشكلة في "اللقطات" حيث يؤدي مقاطعة عمليات الانتقال الواردة بإيماءة "الرجوع التوقّعي" إلى إتلاف طريقة العرض التي يتم الانتقال إليها، وترك شاشة فارغة. (Id3f22، b/319531491)

الإصدار ‎1.7.0-alpha10

‫7 فبراير 2024

تم طرح androidx.fragment:fragment-*:1.7.0-alpha10. يتضمّن الإصدار 1.7.0-alpha10 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح المشكلة المعروفة في إصدار Fragment السابق والتي كانت تتسبّب في عرض Fragment لخطأ NullPointerException من handleOnBackProgressed عند استخدام ميزة "الرجوع التوقّعي" في Fragment مع Animator أو AndroidX Transition، وذلك في حال عدم إضافة أي 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 التي تسعى إلى تسهيل استخدام Compose لواجهة المستخدم الخاصة بأحد 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)
  • من الجزء 1.6.2: عند تضخيم جزء من FragmentContainerView، يمكن الآن الوصول إلى حالاته، مثل FragmentManager والمضيف والمعرّف، في دالة معاودة الاتصال onInflate. (I1e44c، b/307427423)
  • من Fragment 1.6.2: عند استخدام clearBackStack لإزالة مجموعة من الأجزاء، سيتم الآن محو أي ViewModel في Fragment متداخل عند محو ViewModels في الجزء الرئيسي. (I6d83c، b/296173018)

الإصدار 1.7.0-alpha06

‫4 أكتوبر 2023

تم طرح androidx.fragment:fragment-*:1.7.0-alpha06. يتضمّن الإصدار 1.7.0-alpha06 هذه التعديلات.

تحديث الاعتمادية

  • تم تعديل "اللقطات" لتعتمد على واجهة برمجة التطبيقات الجديدة animateToStart التي تمت إضافتها في Transition 1.5.0-alpha04.

الإصدار ‎1.7.0-alpha05

‫20 سبتمبر 2023

تم طرح androidx.fragment:fragment-*:1.7.0-alpha05. يتضمّن الإصدار 1.7.0-alpha05 هذه التعديلات.

الميزات الجديدة

  • تتيح الآن "اللقطات" إمكانية استخدام ميزة "إيماءة إظهار شاشة الرجوع" عند استخدام "عمليات الانتقال" في Androidx. يتيح لك ذلك استخدام إيماءة الرجوع للبحث عن الجزء السابق باستخدام Androidx Transition المخصّص قبل اتّخاذ قرار بتنفيذ المعاملة أو إلغائها من خلال الإيماءة المكتملة. يجب الاعتماد على إصدار Transition 1.5.0-alpha03 لتفعيل هذه الميزة. (Ib49b4، b/285175724)

المشاكل المعروفة

  • هناك حاليًا مشكلة تتمثل في أنّه بعد إلغاء إيماءة الرجوع باستخدام انتقال مرة واحدة، سيتعذّر تشغيل الانتقال في المرة التالية التي تبدأ فيها إيماءة الرجوع، ما يؤدي إلى ظهور شاشة فارغة. قد يكون السبب هو مشكلة في مكتبة Transition. (b/300157785). إذا ظهرت لك هذه المشكلة، يُرجى إبلاغ فريق Fragment عن المشكلة مع تقديم نموذج مشروع يعيد إنتاج المشكلة. يمكنك إيقاف إيماءة إظهار شاشة الرجوع باستخدام FragmentManager.enabledPredictiveBack(false) في onCreate() من النشاط.

الإصدار ‎1.7.0-alpha04

‫6 سبتمبر 2023

تم طرح androidx.fragment:fragment-*:1.7.0-alpha04. يتضمّن الإصدار 1.7.0-alpha04 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح مشكلة عند إلغاء إيماءة الرجوع التوقّعي، حيث تعذّر على الأجزاء الوصول إلى حالة Lifecycle الصحيحة. (I7cffe، b/297379023)
  • تم إصلاح مشكلة تراجع حيث كان يُسمح بتشغيل الرسوم المتحركة مع عمليات الانتقال. (I59f36)
  • تم إصلاح مشكلة عند استخدام "الرجوع التوقّعي" مع الأجزاء، حيث كانت محاولة الرجوع مرتين على التوالي بسرعة في الجزء قبل الأخير في حزمة الخلفية تؤدي إلى حدوث عُطل. (Ifa1a4)

الإصدار ‎1.7.0-alpha03

‫23 أغسطس 2023

تم طرح androidx.fragment:fragment-*:1.7.0-alpha03. يتضمّن الإصدار 1.7.0-alpha03 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح مشكلة في "اللقطات" عند استخدام ميزة "إيماءة إظهار شاشة الرجوع"، حيث كان يتم تخطّي اللقطة الأولى في سجلّ الرجوع الخاص بأداة إدارة اللقطات، كما كان يتم إنهاء النشاط عند استخدام زر الرجوع في النظام من خلال التنقّل باستخدام ثلاثة أزرار أو إيماءة "إظهار شاشة الرجوع". (I0664b، b/295231788)

الإصدار ‎1.7.0-alpha02

‫9 أغسطس 2023

تم طرح androidx.fragment:fragment-*:1.7.0-alpha02. يتضمّن الإصدار 1.7.0-alpha02 هذه التعديلات.

إصلاح الأخطاء

  • عند استخدام "اللقطات" مع "إيماءات الرجوع التوقّعية" من الإصدار 34 من واجهة برمجة التطبيقات، إذا كنت تستخدم نظام انتقال لا يتيح البحث (Animations أو Transitions) أو لا تستخدم أي عمليات انتقال على الإطلاق، ستنتظر "اللقطات" الآن إلى أن تكتمل الإيماءة قبل تنفيذ إجراء الرجوع. (I8100c)

الإصدار 1.7.0-alpha01

‫7 يونيو 2023

تم طرح androidx.fragment:fragment-*:1.7.0-alpha01. تم تطوير هذا الإصدار في فرع داخلي.

الميزات الجديدة

  • توفّر الآن "اللقطات" إمكانية استخدام ميزة "الرجوع التوقّعي داخل التطبيق" عند استخدام Animator. يتيح لك ذلك استخدام إيماءة الرجوع لعرض الجزء السابق مع أداة Animator المخصّصة قبل اتّخاذ قرار إما بتنفيذ المعاملة من خلال الإيماءة المكتملة أو إلغائها. يمكنك أيضًا إيقاف هذا السلوك الجديد باستخدام العلامة التجريبية enablePredictiveBack() وإدخال false.

الإصدار 1.6

الإصدار 1.6.2

1 تشرين الثاني (نوفمبر) 2023

تم طرح androidx.fragment:fragment-*:1.6.2. يتضمّن الإصدار 1.6.2 هذه التعديلات.

إصلاح الأخطاء

  • عندما يتم تضخيم جزء من FragmentContainerView، يمكن الآن الوصول إلى حالاته، مثل FragmentManager وHost والمعرّف، في معاودة الاتصال onInflate. (I1e44c، b/307427423)
  • عند استخدام clearBackStack لإزالة مجموعة من الأجزاء، سيتم الآن محو أي ViewModel متداخل في Fragment عند محو ViewModels الجزء الرئيسي. (I6d83c، b/296173018)

الإصدار 1.6.1

‏26 تموز (يوليو) 2023

تم طرح androidx.fragment:fragment-*:1.6.1. يتضمّن الإصدار 1.6.1 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح مشكلة التخزين المؤقت غير الصحيح للحالة المحفوظة التي تم تخزينها عند إيقاف النشاط بدون إيقافه نهائيًا، حتى بعد نقل مثيل الجزء مرة أخرى إلى الحالة RESUMED. سيؤدي ذلك إلى إعادة استخدام الحالة المخزّنة مؤقتًا إذا كان مثيل الجزء هذا في سجلّ الأنشطة السابقة عند استخدام واجهة برمجة التطبيقات الخاصة بسجلات الأنشطة السابقة المتعددة لحفظ هذا الجزء واستعادته. (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

  • تم تقسيم الحالة المحفوظة لعناصر Fragment بالكامل بين حالة المكتبة الخاصة (فئات Parcelable المخصّصة) والحالة التي يوفّرها المطوّر، والتي يتم تخزينها الآن دائمًا في Bundle يتيح تحديد مصدر حالة جزء معيّن بدقة.
  • تمت إضافة دالتَي ردّ نداء إضافيتَين إلى واجهة FragmentManager.OnBackStackChangedListener، وهما onBackStackChangeStarted وonBackStackChangeCommitted، يتم استدعاؤهما مع كل Fragment قبل إضافتها/إزالتها من حزمة الخلفية للجزء وبعد إتمام المعاملة مباشرةً، على التوالي.
  • أضافت السمة FragmentStrictMode WrongNestedHierarchyViolation جديدة ترصد متى يتم تضمين جزء ثانوي في هيكلية طرق العرض للجزء الرئيسي، ولكن لا تتم إضافته إلى childFragmentManager للجزء الرئيسي.
  • تم الآن وضع التعليقات التوضيحية المناسبة على واجهتَي برمجة التطبيقات Fragment وFragmentManager اللتين تقبلان Intent أو IntentSender باستخدام @NonNull لمنع تمرير قيمة فارغة، لأنّ القيمة الفارغة ستؤدي دائمًا إلى تعطُّل واجهات برمجة التطبيقات المعنية في إطار عمل Android التي تستدعيها هذه الطرق على الفور.
  • تتيح خدمة DialogFragment الآن الوصول إلى ComponentDialog الأساسية من خلال واجهة برمجة التطبيقات requireComponentDialog().
  • يعتمد Fragment الآن على 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 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح مشكلة كانت تؤدي إلى إرسال ActivityResults مع رمز الطلب غير الصحيح عند تقديم طلبات startActivityForResult متعددة على التوالي. (If0b9d، b/249519359)
  • تم إصلاح المشكلة التي كانت تؤدي إلى إرسال عمليات معاودة الاتصال 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)
  • لن يتم الآن إرسال جزء من البيانات إلا مرة واحدة باستخدام وظيفتَي معاودة الاتصال الجديدتَين onBackStackChangeStarted وonBackStackChangeCommitted، حتى إذا كانت عدّة معاملات تتضمّن الجزء نفسه. (Ic6b69)

الإصدار 1.6.0-alpha09

‫5 أبريل 2023

تم طرح androidx.fragment:fragment-*:1.6.0-alpha09. يتضمّن الإصدار 1.6.0-alpha09 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • تتيح خدمة DialogFragment الآن الوصول إلى ComponentDialog الأساسية من خلال واجهة برمجة التطبيقات requireComponentDialog(). (I022e3، b/234274777)
  • تمت إضافة التعليق التوضيحي @MainThread إلى واجهات برمجة التطبيقات الخاصة بالأجزاء commitNow() وexecutePendingTransactions() وpopBackStackImmediate()، ما يعني أنّها ستطرح الآن جميعًا أخطاء في الإصدار عند عدم استدعائها من سلسلة التعليمات الرئيسية بدلاً من انتظار حدوث خطأ أثناء وقت التشغيل. (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 ليتم تنفيذه قبل تنفيذ عمليات الأجزاء. يضمن ذلك عدم تمرير جزء منفصل إلى دالة الرجوع. (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 هذه التعديلات.

تغيير السلوك

  • سيتم الآن تنفيذ وظيفة 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)

التغييرات في واجهة برمجة التطبيقات

  • تم الآن وضع التعليقات التوضيحية المناسبة على واجهتَي برمجة التطبيقات Fragment وFragmentManager اللتين تقبلان Intent أو IntentSender باستخدام @NonNull لمنع تمرير قيمة فارغة، لأنّ القيمة الفارغة ستؤدي دائمًا إلى تعطُّل واجهات برمجة التطبيقات المعنية لإطار عمل Android التي تستدعيها هذه الطرق على الفور. (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)

التغييرات في واجهة برمجة التطبيقات

  • يفصل العنصر fragment-testing-manifest إدخالات البيان عن بقية مكوّنات اختبار الأجزاء. هذا يعني أنّه يمكنك إجراء ما يلي:
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 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • سيكون على الفئات التي توسّع DialogFragment الآن استدعاء super في عمليات الإلغاء onDismiss(). (I14798، b/238928865)

إصلاح الأخطاء

  • تم إصلاح المشاكل التي حدثت بسبب دمج واجهات معاودة الاتصال الجديدة الخاصة بموفّر الخدمة (OnConfigurationChangedProvider وOnMultiWindowModeChangedProvider وOnTrimMemoryProvider وOnPictureInPictureModeChangedProvider) لضمان حصول الأجزاء دائمًا على عمليات معاودة الاتصال المناسبة. (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 غير صحيح في الأجزاء التي يتم الخروج منها. (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 هذه التعديلات.

التغييرات في السلوك

  • تم تقسيم الحالة المحفوظة لعناصر Fragment بالكامل بين حالة المكتبة الخاصة (فئات Parcelable المخصّصة) والحالة التي يوفّرها المطوّر، والتي يتم تخزينها الآن دائمًا في Bundle تتيح تحديد مصدر حالة جزء معيّن بدقة. (b/207158202)

إصلاح الأخطاء

  • من الجزرة 1.5.1: تم إصلاح مشكلة تراجع في DialogFragmentCallbacksDetector حيث كان استخدام إصدار lint المُضمَّن مع الإصدار 7.4 من "المكوّن الإضافي لنظام Android Gradle" يؤدي إلى تعطُّل 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 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح خطأ كان يتسبّب في تلقّي الأجزاء في سجلّ الأنشطة السابقة عمليات معاودة الاتصال onMultiWindowModeChanged() وonPictureInPictureModeChanged() وonLowMemory() وonConfigurationChanged(). (I34581 وI8dfe6 وb/242570955)
  • لن تتلقّى الأجزاء الفرعية المتداخلة بعد الآن عمليات إعادة استدعاء متعددة من 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 المُضمَّن مع الإصدار 7.4 من "مكوّن Android الإضافي لبرنامج Gradle" يؤدي إلى تعطُّل 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 بدون حالة من خلال CreationExtras في Lifecycle 2.5.0.
  • دمج مربّع حوار المكوّن: يستخدم DialogFragment الآن ComponentDialog من خلال النشاط 1.5.0 كمربّع الحوار التلقائي الذي يعرضه onCreateDialog().
  • إعادة تصميم حالة المثيل المحفوظة: بدأت الأجزاء في تغيير طريقة حفظ حالة المثيل. هذا جهد يهدف إلى المساعدة في تحديد الحالة التي تم حفظها في الجزء ومصدر الحالة بوضوح. تشمل التغييرات الحالية ما يلي:
    • يحفظ FragmentManager الآن حالة مثيله المحفوظة في Bundle بدلاً من حفظها مباشرةً في Parcelable مخصّص.
    • يتم الآن حفظ مجموعة النتائج التي تم ضبطها من خلال Fragment Result APIs ولم يتم تسليمها بعد بشكل منفصل عن الحالة الداخلية لـ FragmentManager.
    • يتم الآن حفظ الحالة المرتبطة بكل جزء على حدة بشكل منفصل عن الحالة الداخلية لـ FragmentManager، ما يتيح لك ربط مقدار الحالة المحفوظة المرتبطة بجزء فردي بمعرّفات فريدة متوفّرة في سجلّ تصحيح الأخطاء Fragment.

تغييرات أخرى

  • تتيح السمة FragmentStrictMode الآن إمكانية تجاوز عقوبات انتهاك معيّنة في الأجزاء الخاصة التابعة لجهات خارجية من خلال استخدام allowViolation() مع اسم الفئة.
  • تم إيقاف واجهات برمجة التطبيقات Fragment التي توفّر قائمة ActionBar لنشاطك. توفّر واجهتا برمجة التطبيقات MenuHost وMenuProvider اللتان تمت إضافتهما في Activity 1.4.0 مساحة مكافئة لواجهة برمجة التطبيقات يمكن اختبارها وتتضمّن مراحل النشاط، ويجب أن تستخدمها الفِقرات.

الإصدار 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 هذه التعديلات.

إعادة تصميم حالة المثيل المحفوظة

الإصدار ‎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 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • أضافت DialogFragment طريقة dismissNow جديدة تستخدم commitNow لتحقيق التكافؤ مع الدالة showNow. يُرجى العِلم أنّ هذا الإجراء لن يؤدي إلى إغلاق Dialog على الفور، بل سيؤدي فقط إلى تعديل حالة FragmentManager بشكل متزامن. (I15c36، b/72644830)

إعادة تصميم حالة المثيل المحفوظة

  • يحفظ FragmentManager الآن حالة الآلة الافتراضية المحفوظة في Bundle بدلاً من حفظها مباشرةً في Parcelable مخصّص. هذه هي الخطوة الأولى نحو توفير المزيد من الشفافية بشأن ما يتم حفظه فعليًا من خلال "اللقطات". (I93807، b/207158202)
  • يتم الآن حفظ النتائج التي تم ضبطها من خلال واجهات برمجة التطبيقات لنتائج الأجزاء ولم يتم عرضها بعد بشكل منفصل عن الحالة الداخلية لـ 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 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

الإصدار ‎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 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • تم إيقاف واجهات برمجة التطبيقات الخاصة بـ Fragment نهائيًا لتوفير قائمة في ActionBar لنشاطك، لأنّها تربط الجزء بنشاطك بشكل وثيق ولا يمكن اختبارها بشكل مستقل. توفّر واجهتا برمجة التطبيقات MenuHost وMenuProvider اللتان تمت إضافتهما في Activity 1.4.0-alpha01 مساحة مكافئة لواجهة برمجة التطبيقات يمكن اختبارها وتتضمّن مراحل النشاط، ويجب أن تستخدمها الفِقرات. (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 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • يمكنك الآن تمرير CreationExtras إلى الدالتَين by viewModels() وby activityViewModels(). (Ibefe7، b/217601110)

التغييرات في السلوك

الإصدار ‎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 مخصّصة بدلاً من استخدام مصنع الجزء دائمًا. (I56170، b/214106513)
  • تم إصلاح عُطل عند الوصول إلى ViewModel للمرة الأولى من معاودة الاتصال 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 مخصّص بدلاً من استخدام مصنع الجزء دائمًا. (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

  • توفّر واجهات برمجة التطبيقات FragmentStrictMode عمليات تحقّق أثناء وقت التشغيل تتيح لك التأكّد من أنّ تطبيقك أو المكتبات التي تعتمد عليها لا تستدعي واجهات برمجة تطبيقات الأجزاء المتوقّفة نهائيًا. عند رصد انتهاك، يمكنك اختيار طباعة رسالة سجلّ أو تفعيل أداة معالجة مخصّصة أو إيقاف تطبيقك. يمكن ضبط FragmentStrictMode.Policy الذي يتحكّم في عمليات التحقّق المفعَّلة و"العقوبات" التي يتم تفعيلها على FragmentManager من خلال طريقة setStrictModePolicy() الجديدة. تنطبق هذه السياسة على FragmentManager، كما تنطبق بشكل متعدٍّ على أي مدراء أجزاء فرعية لا يضبطون سياسة فريدة خاصة بهم. يمكنك الاطّلاع على StrictMode for fragments.

  • توفّر FragmentContainerView الآن طريقة getFragment() تعرض الجزء الذي تمت إضافته مؤخرًا إلى الحاوية. يستخدم هذا الإجراء المنطق نفسه المستخدَم مع findFragmentById() مع معرّف FragmentContainerView، ولكنّه يسمح بتسلسل المكالمة.

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

  • تتضمّن FragmentScenario الآن Closeable، ما يتيح لك استخدامها مع طريقة use في Kotlin أو try-with-resources.

  • تمت إضافة FragmentTransaction#TRANSIT_FRAGMENT_MATCH_ACTIVITY_{OPEN, CLOSE} لتحديد ما إذا كان سيتم تفعيل الحركة العادية للانتقال بين الأنشطة المستخدَمة من المظهر في عملية الانتقال بين الأجزاء.

  • تمت إزالة واجهة برمجة التطبيقات التجريبية الخاصة بـ FragmentManager.enableNewStateManager(boolean)، وأصبح مدير الحالة الجديد هو الخيار الوحيد المتاح.

حِزم خلفية متعددة

تحتفظ FragmentManager بسجلّ للأنشطة السابقة يتألف من معاملات الأجزاء التي استخدمت addToBackStack(). يتيح لك ذلك إيقاف هذه المعاملات والرجوع إلى الحالة السابقة، وذلك باستخدام آليات حفظ الحالة باستخدام الأجزاء للسماح للأجزاء باستعادة حالتها بشكلٍ مناسب.

يوسّع هذا الإصدار نطاق هذه الآليات من خلال توفير ثلاث واجهات برمجة تطبيقات جديدة FragmentManager: saveBackStack(String name) وrestoreBackStack(String name) وclearBackStack(String name). تستخدم واجهات برمجة التطبيقات هذه name نفسها التي تستخدمها addToBackStack() لحفظ حالة FragmentTransaction وحالة كل جزء تمت إضافته في هذه المعاملات، وتتيح لك استعادة هذه المعاملات وأجزائها لاحقًا مع الحفاظ على حالتها. يتيح لك ذلك "التبديل" بفعالية بين الأنشطة السابقة المتعددة من خلال حفظ الأنشطة السابقة الحالية واستعادة الأنشطة السابقة المحفوظة.

تعمل saveBackStack() بشكل مشابه للرمز popBackStack() من حيث أنّها غير متزامنة وتؤدي إلى عكس جميع معاملات الأجزاء التي تحمل هذا الاسم تحديدًا (أي إزالتها) وإتلاف أي أجزاء تمت إضافتها وإزالتها، ولكنها تختلف في بعض الجوانب المهمة:

  • saveBackStack() شاملة دائمًا.
  • على عكس popBackStack() التي ستعرض جميع المعاملات في سجلّ الرجوع إذا لم يتم العثور على الاسم المحدّد في سجلّ الرجوع أو إذا تم تقديم اسم فارغ، لا تنفّذ saveBackStack() أي إجراء إذا لم يسبق لك تنفيذ معاملة جزء باستخدام addToBackStack() مع هذا الاسم المحدد غير الفارغ.
  • يتم حفظ حالة جميع الأجزاء المضافة من هذه المعاملات. وهذا يعني أنّه يتم تخزين حالة العرض لكل جزء، ويتم استدعاء onSaveInstanceState() لكل جزء واستعادة هذه الحالة، ويتم الاحتفاظ بأي مثيلات ViewModel مرتبطة بهذه الأجزاء (onCleared() لا يتم استدعاؤها عليها).

يجب أن تستوفي معاملات الأجزاء التي يمكن استخدامها مع saveBackStack() معايير معيّنة:

  • يجب أن تستخدم كل معاملة جزء setReorderingAllowed(true) لضمان إمكانية استعادة المعاملات كعملية واحدة غير قابلة للتجزئة.
  • يجب أن تكون مجموعة المعاملات المحفوظة مكتفية ذاتيًا (أي يجب ألا تشير صراحةً إلى أي أجزاء خارج مجموعة المعاملات هذه) لضمان إمكانية استعادتها في أي وقت لاحق، بغض النظر عن التغييرات التي تم إجراؤها على سجلّ الرجوع خلال الفترة الفاصلة.
  • لا يمكن أن يكون أيّ جزء محفوظ جزءًا محتفظًا به أو أن يتضمّن مجموعة متعدية من الأجزاء الفرعية المحتفظ بها لضمان عدم عرض FragmentManager أي مراجع للأجزاء المحفوظة بعد حفظ الأنشطة السابقة.

على غرار saveBackStack() وrestoreBackStack() وclearBackStack()، التي تستعيد الأنشطة السابقة المحفوظة سابقًا أو تمحوها، على التوالي، لا يؤدي أي منهما إلى أي إجراء إذا لم يسبق لك استدعاء saveBackStack() بالاسم نفسه.

لمزيد من المعلومات، يُرجى الاطّلاع على حِزم السجلّ الخلفي المتعددة: نظرة تفصيلية.

الإصدار 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)
  • تمت إضافة خطأ FragmentAddMenuProvider lint لتصحيح استخدامات "دورة حياة Fragment" إلى "دورة حياة عرض Fragment" عند استخدام واجهة برمجة التطبيقات addMenuProvider في MenuHost. (aosp/1830457 وb/200326272)

تعديلات على المستندات

  • تمت إضافة المزيد من التفاصيل إلى رسالة الإيقاف النهائي لواجهات برمجة التطبيقات التي تتعامل معها الآن واجهات برمجة التطبيقات الخاصة بنتائج الأنشطة، وهي 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)

التغييرات في واجهة برمجة التطبيقات

  • تمت إعادة كتابة الفئة FragmentContainerView بلغة Kotlin لضمان أنّ الدالة getFragment ستراعي إمكانية القيم الفارغة بشكل صحيح. (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 check للتعامل بشكل أفضل مع الأقواس الزائدة. (I2d865)
  • تم تحسين UseGetLayoutInflater Lint check للتعامل مع حالات حدودية إضافية. (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 الآن دائمًا الحالة المحفوظة كأول عملية في عمليات معاودة الاتصال بدورة الحياة التي يتم تجاهلها. (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 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • يستخدم FragmentManager الآن SavedStateRegistry في الخلفية لحفظ حالته. تم أيضًا إيقاف الطريقتَين saveAllState() وrestoreSavedState() نهائيًا في FragmentController. إذا كنت تستخدم FragmentController لاستضافة أجزاء خارج FragmentActivity، يجب أن تنفّذ FragmentHostCallbacks SavedStateRegistryOwner. (Iba68e، b/188734238)

إصلاح الأخطاء

  • تم إصلاح المشكلة التي كانت تؤدي إلى تعذُّر استدعاء saveBackStack() كجزء من إتاحة عدة حِزم احتياطية عند تنفيذها في الوقت نفسه مع تنفيذ FragmentTransaction التي تستخدم replace(). (I73137)
  • تم إصلاح NullPointerException كان يحدث بعد استعادة حزمة الأنشطة السابقة المحفوظة يدويًا التي تحتوي على معاملات متعددة عند استخدام واجهة برمجة التطبيقات 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)

إصلاح الأخطاء

  • من Fragment 1.3.5: تم إصلاح مشكلة تراجع في عمليات نقل العناصر المشتركة تم تقديمها في Fragment 1.3.4 من خلال aosp/1679887. تتعامل الآن الفِراغات بشكل صحيح مع مجموعات الانتقالات (إما يتم ضبطها مباشرةً من خلال transitionGroup="true" أو بشكل غير مباشر من خلال transitionName أو background)، ولن تعرض العناصر المشترَكة بعد الآن أخطاء IndexOutOfBoundsException. (I16484، b/188679569، b/188969304)
  • لن يتعطّل التطبيق FragmentManager بعد الآن عند محاولة إخفاء جزء تتم إزالته. (I573dd، b/183634730)
  • لن يؤدي فحص 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. يجب أن تتعامل كل طريقة عرض لجزء فردي مع الحواف الداخلية. (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 الآن طريقة getFragment() تعرض الجزء الذي تمت إضافته مؤخرًا إلى الحاوية. يستخدم هذا الإجراء المنطق نفسه المستخدَم مع findFragmentById() مع معرّف FragmentContainerView، ولكنّه يسمح بتسلسل المكالمة. (Ife17a، b/162527857)

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

  • تمت إضافة FragmentTransaction#TRANSIT_FRAGMENT_MATCH_ACTIVITY_{OPEN, CLOSE} لتحديد ما إذا كان سيتم تفعيل الرسوم المتحركة العادية لانتقال النشاط من المظهر في عملية انتقال "اللقطات". (I46652)

حِزم خلفية متعددة

تحتفظ FragmentManager بسجلّ للأنشطة السابقة يتألف من معاملات الأجزاء التي استخدمت addToBackStack(). يتيح لك ذلك إيقاف هذه المعاملات والرجوع إلى الحالة السابقة، وذلك باستخدام آليات حفظ الحالة باستخدام الأجزاء للسماح للأجزاء باستعادة حالتها بشكلٍ مناسب.

يوسّع هذا الإصدار نطاق آليات الحماية هذه من خلال توفير واجهتَي برمجة تطبيقات جديدتَين FragmentManager: saveBackStack(String name) وrestoreBackStack(String name). تستخدم واجهات برمجة التطبيقات هذه name نفسها المستخدَمة في addToBackStack() لحفظ حالة FragmentTransaction وحالة كل جزء تمت إضافته في هذه المعاملات، وتتيح لك بعد ذلك استعادة هذه المعاملات وأجزائها مع الحفاظ على حالتها. يتيح لك ذلك "التبديل" بفعالية بين الأنشطة السابقة المتعددة من خلال حفظ الأنشطة السابقة الحالية واستعادة الأنشطة السابقة المحفوظة.

تعمل saveBackStack() بشكل مشابه لـ popBackStack() من حيث أنّها غير متزامنة وتؤدي إلى عكس جميع معاملات الأجزاء التي تحمل هذا الاسم تحديدًا (أي إزالتها من الخلف) وإتلاف أي أجزاء تمت إضافتها وإزالتها، ولكنها تختلف في بعض الجوانب المهمة:

  • saveBackStack() شاملة دائمًا.
  • على عكس popBackStack() التي ستعرض جميع المعاملات في سجلّ الرجوع إذا لم يتم العثور على الاسم المحدّد في سجلّ الرجوع أو إذا تم تقديم اسم فارغ، لا تنفّذ saveBackStack() أي إجراء إذا لم يسبق لك تنفيذ معاملة جزء باستخدام addToBackStack() مع هذا الاسم المحدد غير الفارغ.
  • يتم حفظ حالة جميع الأجزاء المضافة من هذه المعاملات. وهذا يعني أنّه يتم تخزين حالة العرض لكل جزء، ويتم استدعاء onSaveInstanceState() لكل جزء واستعادة هذه الحالة، ويتم الاحتفاظ بأي مثيلات ViewModel مرتبطة بهذه الأجزاء (onCleared() لا يتم استدعاؤها عليها).

يجب أن تستوفي معاملات الأجزاء التي يمكن استخدامها مع saveBackStack() معايير معيّنة:

  • يجب أن تستخدم كل معاملة جزء setReorderingAllowed(true) لضمان إمكانية استعادة المعاملات كعملية واحدة غير قابلة للتجزئة.
  • يجب أن تكون مجموعة المعاملات المحفوظة مكتفية ذاتيًا (أي يجب ألا تشير صراحةً إلى أي أجزاء خارج مجموعة المعاملات هذه) لضمان إمكانية استعادتها في أي وقت لاحق، بغض النظر عن التغييرات التي تم إجراؤها على سجلّ الرجوع خلال الفترة الفاصلة.
  • لا يمكن أن يكون أي جزء محفوظ جزءًا محتفظًا به أو أن يتضمّن جزءًا محتفظًا به في مجموعة الأجزاء الفرعية المتعدية لضمان عدم عرض FragmentManager أي مراجع لأجزاء محفوظة بعد حفظ سجلّ الرجوع.

على غرار saveBackStack()، لا تنفّذ الدالة restoreBackStack() أي إجراء إذا لم يسبق لك استدعاء الدالة saveBackStack() بالاسم نفسه. (b/80029773)

Fragment StrictMode

توفّر واجهات برمجة التطبيقات FragmentStrictMode عمليات تحقّق أثناء وقت التشغيل تتيح لك التأكّد من أنّ تطبيقك أو المكتبات التي تعتمد عليها لا تستدعي واجهات برمجة تطبيقات الأجزاء المتوقّفة نهائيًا. عند رصد انتهاك، يمكنك اختيار طباعة رسالة سجلّ أو تفعيل أداة معالجة مخصّصة أو إيقاف تطبيقك. يمكن ضبط 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 كحاوية للأجزاء في التصميم. (#146، b/181137036)
  • ترصد detectRetainInstanceUsage() الحالات التي تستخدم فيها واجهات برمجة التطبيقات المتوقّفة نهائيًا setRetainInstance() أو getRetainInstance(). (#140، b/153737954)
  • ترصد detectSetUserVisibleHint() الحالات التي تستخدم فيها واجهة برمجة التطبيقات setUserVisibleHint() المتوقّفة نهائيًا. (#136، b/153738974)
  • ترصد detectTargetFragmentUsage() الحالات التي تستخدم فيها واجهات برمجة التطبيقات المتوقّفة نهائيًا setTargetFragment() أو getTargetFragment() أو getTargetRequestCode(). (#139، b/153737745)

التغييرات في واجهة برمجة التطبيقات

  • تمت إزالة واجهة برمجة التطبيقات التجريبية الخاصة بـ FragmentManager.enableNewStateManager(boolean)، وأصبح مدير الحالة الجديد هو الخيار الوحيد المتاح. (I90036، b/162776418)
  • تتيح FragmentScenario الآن استخدام Closeable، ما يسمح لك باستخدامه مع طريقة use في Kotlin أو try-with-resources. (#121، b/143774122)

عمليات فحص Lint الجديدة

  • يحذّر UseGetLayoutInflater Lint check الآن عند استخدام LayoutInflater.from(Context) داخل DialogFragment، ويجب استخدام طريقة getLayoutInflater() الخاصة بـ للحصول على LayoutInflater المناسب دائمًا. (#156، b/170781346)
  • يُصدر DialogFragmentCallbacksDetector Lint check الآن تحذيرًا عند استدعاء setOnCancelListener أو setOnDismissListener في طريقة onCreateDialog() من DialogFragment، إذ يملك DialogFragment أدوات معالجة الأحداث هذه، وعليك إلغاء onCancel() وonDismiss() لتلقّي عمليات معاودة الاتصال هذه. (#171، b/181780047، b/187524311)

إصلاح الأخطاء

  • من الإصدار 1.3.4 من Fragment: تم إصلاح خطأ برمجي تم تقديمه في الإصدار 1.3.3 من Fragment عند استخدام واجهة برمجة التطبيقات ViewTreeViewModelStoreOwner.get() مع ViewModelProvider أو طريقة Jetpack Compose الخاصة بـ viewModel() داخل Fragment. تستخدم حالات الاستخدام هذه الآن ViewModelProvider.Factory المقدَّمة من Fragment بشكل صحيح إذا كانت تتجاوز getDefaultViewModelProviderFactory() (كما تفعل Fragments التي تمّت إضافة التعليقات التوضيحية إليها باستخدام @AndroidEntryPoint عند استخدام Hilt). إذا لم يتم إلغاء هذا الإجراء، سيتم إنشاء SavedStateViewModelFactory يحفظ حالته ويستعيدها إلى جانب طريقة العرض الخاصة بـ Fragment كإعداد تلقائي للمصنع. (I5cbfa، b/186097368)
  • من Fragment 1.3.4: عند استخدام FragmentContainerView على الإصدار 29 من واجهة برمجة التطبيقات، لن يتم إرسال الحواف الداخلية إلى أجل غير مسمى، ما يؤدي إلى حل المشاكل في مثيلات BottomNavigationBar وFloatingActionButton. (I1bb78، b/186012452)
  • من الإصدار 1.3.4 من Fragment: يمكنك الآن استرداد Parcelable من حزمة نتائج الجزء بعد إيقاف العملية. (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 بعد الآن عند محاولة إخفاء جزء تتم إزالته. (I573dd، b/183634730)
  • تم الآن ضبط طريقة عرض Fragment بشكل صحيح على GONE عند استخدام hide() عندما يكون قد تم ضبط transitionGroup=”true” في طريقة العرض الجذر. (aosp/1766655 وb/193603427)
  • تفتح FragmentActivity الآن دائمًا الحالة المحفوظة كأول عملية في عمليات إلغاء معاودة الاتصال بدورة الحياة. (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 عند استخدام واجهة برمجة التطبيقات ViewTreeViewModelStoreOwner.get() مع ViewModelProvider أو طريقة Jetpack Compose الخاصة بـ viewModel() داخل Fragment عند استخدام Hilt. تستخدم حالات الاستخدام هذه الآن ViewModelProvider.Factory المقدَّمة من Fragment بشكل صحيح إذا كانت تتجاوز getDefaultViewModelProviderFactory() (كما تفعل Fragments التي تمّت إضافة التعليقات التوضيحية إليها باستخدام @AndroidEntryPoint). إذا لم يتم إلغاء هذا الإجراء، سيتم إنشاء SavedStateViewModelFactory يحفظ حالته ويعيدها مع طريقة العرض الخاصة بـ Fragment كإعداد تلقائي. (I5cbfa، b/186097368)
  • عند استخدام FragmentContainerView على الإصدار 29 من واجهة برمجة التطبيقات، لن يتم إرسال عمليات الإدخال إلى أجل غير مسمى، ما يؤدي إلى حلّ المشاكل في مثيلات BottomNavigationBar وFloatingActionButton. (I1bb78، b/186012452)
  • يمكنك الآن استرداد Parcelable من حزمة نتائج الجزء بعد إيقاف العملية. (I65932، b/187443158)
  • عند إجراء انتقال عنصر مشترك على ViewGroup، إذا تم ضبط transitionGroup على false في ViewGroup، سيتم الآن إجراء الانتقال بشكل صحيح. (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() مع طريقة العرض الخاصة بالجزء. (I21acf، b/181577191)

إصلاح الأخطاء

  • تم إصلاح مشكلة تراجع تم رصدها في Fragment 1.3.2، ما كان يؤدي إلى عدم تشغيل الصور المتحركة popEnter عند إغلاق FragmentTransaction يتضمّن عملية setPrimaryNavFragment، مثل العمليات التي تستخدمها NavHostFragment. (I38c87، b/183877426)
  • تضمن FragmentContainerView الآن إرسال مجموعة جديدة من WindowInsets إلى كل Fragment، ما يضمن إمكانية استخدام كل جزء للحواف الداخلية بشكل مستقل. (I63f68، b/172153900)
  • تعالج السمة DialogFragment الآن بشكلٍ سليم الحالات التي تتم فيها إضافة جزء فرعي إلى حاوية لها المعرّف نفسه الخاص بحاوية في فئة Dialog المخصّصة، ما يؤدي إلى حلّ مشاكل هيكلية طرق العرض عند إعادة استخدام المعرّفات المستخدَمة داخليًا من خلال مربّعات الحوار، مثل BottomSheetDialog. (Ie6279، b/180021387)
  • تعمل السمة FragmentManager.dump() الآن على إضافة مسافة بادئة بشكلٍ سليم إلى الجزء الأول في قائمة الأجزاء النشطة. (If5c33، b/183705451)

إصلاحات أخطاء في New 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 هذه التعديلات.

إصلاحات أخطاء في New State Manager

  • عند تنفيذ عمليتَي popBackStack() وcommit() معًا، ستحدّد العملية الأخيرة الآن اتجاه جميع الحركات بدلاً من تنفيذ بعض الحركات المنبثقة وبعض حركات الدخول. (I7072e، b/181142246)
  • لن يتم بعد ذلك محو اسم الانتقال الخاص بالعناصر المشتركة عند إجراء انتقال بين عناصر مشتركة في التسلسل الهرمي للعناصر المشتركة. (I4d4a6، b/179934757)

تحديثات الاعتماديات

  • يعتمد Fragment الآن على Activity 1.2.2، ما يؤدي إلى إصلاح مشكلة في عملية فحص InvalidFragmentVersionForActivityResult lint في Activity عند استخدام الإصدار 1.3.1 من Fragment أو إصدار أحدث.
  • يعتمد 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).

إصلاحات أخطاء في New State Manager

  • تم إصلاح تسرب الذاكرة في الأجزاء بسبب mFocusedView (Ib4e9e، b/179925887)
  • تستدعي الآن الأجزاء الدالة onCreateOptionsMenu بشكل صحيح عند استخدام معاملات العرض/الإخفاء (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

  • إدارة الحالة الجديدة: أدّى إعادة كتابة كبيرة للأجزاء الداخلية من FragmentManager إلى حلّ العديد من المشاكل المتعلّقة بإرسال أحداث مراحل النشاط والرسوم المتحركة وعمليات الانتقال وطريقة التعامل مع الأجزاء المؤجّلة.

  • دمج Activity Result API: تمت إضافة إمكانية استخدام واجهة برمجة التطبيقات ActivityResultRegistry التي تم طرحها في Activity 1.2.0 للتعامل مع عمليات startActivityForResult()+onActivityResult() بالإضافة إلى عمليات requestPermissions()+onRequestPermissionsResult() بدون إلغاء الطرق في Fragment، فضلاً عن توفير نقاط ربط لاختبار هذه العمليات. اطّلِع على الحصول على نتيجة من نشاط المعدَّل.

    • يحلّ هذا الإصدار عددًا من المشاكل المتعلّقة برموز الطلبات غير الصالحة وإرسال طلبات الأذونات التي تمنع عمل Activity Result API على الإصدارات السابقة من FragmentActivity. يجب الترقية إلى الإصدار 1.3.0 من Fragment لاستخدام واجهات برمجة التطبيقات الخاصة بنتائج الأنشطة في FragmentActivity أو AppCompatActivity.

  • Fragment Result API: تمت إضافة إمكانية تمرير النتائج بين جزأين من خلال واجهات برمجة تطبيقات جديدة على FragmentManager. يعمل ذلك مع الأجزاء الهرمية (الأصل/التابع) وDialogFragment والأجزاء في Navigation، ويضمن إرسال النتائج إلى الجزء فقط عندما يكون في الحالة STARTED على الأقل. تم إيقاف واجهات برمجة التطبيقات المستهدَفة للتقسيم نهائيًا لصالح واجهات برمجة التطبيقات الجديدة هذه. يمكنك الاطّلاع على الحصول على النتائج باستخدام Fragment Result API.

  • ‫FragmentOnAttachListener: تم إيقاف معاودة الاتصال onAttachFragment() نهائيًا على FragmentActivity وFragment. تمت إضافة FragmentOnAttachListener جديد لتوفير بديل أكثر مرونة، ما يتيح تفويض onAttachFragment() إلى أدوات معالجة منفصلة وقابلة للاختبار، وإتاحة إضافة أداة معالجة إلى FragmentManagers غير FragmentManager الفرعي المباشر.

  • FragmentScenario تحسينات: تمت إعادة كتابة الفئة FragmentScenario من العنصر fragment-testing في Kotlin، وتم إجراء عدد من التحسينات عليها:

    • تستخدم السمة FragmentScenario الآن setMaxLifecycle() لتنفيذ moveToState()، ما يضمن سلوكًا متسقًا على جميع مستويات واجهة برمجة التطبيقات وفصل حالة Fragment عن النشاط الأساسي.
    • تتيح السمة FragmentScenario الآن ضبط Lifecycle.State أولي للمساعدة في تأكيد حالة الجزء قبل الانتقال إلى كل Lifecycle.State للمرة الأولى.
    • يتوفّر الآن بديل لواجهة برمجة التطبيقات FragmentScenario الخاصة بـ onFragment في شكل طريقة الإضافة withFragment التي تمّت إعادة تصنيفها في Kotlin، والتي تتيح لك عرض قيمة. والجدير بالذكر أنّه يعيد طرح الاستثناءات التي تم إنشاؤها في الكتلة المحدّدة.

  • ViewTree Support: تتوافق السمة Fragment الآن مع واجهات برمجة التطبيقات ViewTreeLifecycleOwner.get(View) وViewTreeViewModelStoreOwner.get(View) وViewTreeSavedStateRegistryOwner التي تمت إضافتها في Lifecycle 2.3.0 وSavedState 1.1.0، ما يتيح عرض Fragment كـ ViewModelStoreOwner، بالإضافة إلى SavedStateRegistryOwner وLifecycleOwner المرتبطَين بدورة حياة العرض في الجزء عند استخدام View ضمن Fragment.

  • تغييرات في الصور المتحركة TRANSIT_: تستخدم الآن التأثيرات التلقائية للقطعة، TRANSIT_FRAGMENT_OPEN وTRANSIT_FRAGMENT_CLOSE وTRANSIT_FRAGMENT_FADE، Animator بدلاً من Animation. أصبحت المصادر المستخدَمة لإنشاء هذه الصور المتحركة خاصة الآن.

  • إيقاف setRetainInstance() نهائيًا: تم إيقاف طريقة setRetainInstance() نهائيًا في "التقسيمات". مع طرح ViewModels، أصبح لدى المطوّرين واجهة برمجة تطبيقات محدّدة للاحتفاظ بالحالة التي يمكن ربطها بالأنشطة واللقطات ورسوم بيانية للتنقّل. يتيح ذلك للمطوّرين استخدام 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)

إصلاحات أخطاء في New State Manager

  • تعالج الآن طريقة العرض الخاصة بالجزء Lifecycle بشكل صحيح الحالات التي يتم فيها إتلاف طريقة العرض الخاصة بالجزء قبل أن تصل Lifecycle إلى CREATED، ما يؤدي إلى تجنُّب الاستثناءات التي تنص على "عدم توفّر حدث من 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)

إصلاحات أخطاء في New State Manager

  • تم إصلاح مشكلة تسريب الذاكرة والتشوّه المرئي عند إضافة جزء يحتوي على Animation إلى FragmentContainerView ثم إيقاف عملية الإضافة هذه من خلال عملية إزالة. (I952d8)
  • تم إصلاح مشكلة بقاء عرض الجزء في التسلسل الهرمي للعرض إذا تم استبداله أثناء تنفيذ الطريقتَين onCreate() أو onViewCreated(). (I8a7d5)
  • يتم الآن استعادة التركيز بشكل صحيح إلى طرق عرض جذر Fragment عند استئنافها. (Ifc84b)
  • سيؤدي الجمع بين عمليات pop وreplace في معاملة جزء واحدة إلى عرض الصور المتحركة المناسبة (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 التي لا تضخّم جزءًا باستخدام السمة class أو android:name خارج FragmentActivity. (Id4397، b/172266337)
  • سيؤدي الآن محاولة ضبط الحد الأقصى لمراحل نشاط جزء على DESTROYED إلى طرح الخطأ IllegalArgumentException (Ie7651، b/170765622).
  • سيؤدي الآن تهيئة FragmentScenario باستخدام حالة DESTROYED إلى طرح IllegalArgumentException (I73590، b/170765622)

إصلاحات أخطاء في New 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 المختلفة. شكرًا "سيمون شيلر"! (#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)

التغييرات في واجهة برمجة التطبيقات

التغييرات في السلوك

  • تم ضبط ملفات موارد الأجزاء على "خاصة" بشكلٍ صحيح. (aosp/1425237)

إصلاح الأخطاء

  • ستنتظر الآن الأجزاء التي تم تضخيمها باستخدام العلامة <fragment> بشكل صحيح إلى أن تتم إضافة طرق العرض الخاصة بها إلى حاوية قبل الانتقال إلى الحالة STARTED (I02f4c).
  • تعمل الآن بشكل صحيح تأثيرات الخروج الخاصة بالمقاطع التي تكون مرئية ثم تنتقل من setMaxLifecycle() إلى CREATED. (b/165822335)
  • لم تعُد إزالة جزء منفصل لم تتم إضافته إلى سجلّ الرجوع إلى الخلف تؤدي إلى حدوث تسرُّب للذاكرة. شكرًا لـ "نيكلاس أنسمان غيرتز" على هذه الصورة. (b/166489383)
  • ستتضمّن الآن الأجزاء النشطة دائمًا قيمة FragmentManager غير فارغة، وسيتم دائمًا اعتبار الأجزاء التي تتضمّن قيمة FragmentManager غير فارغة نشطة. (aosp/1422346)
  • تستخدم التأثيرات التلقائية للأجزاء، TRANSIT_FRAGMENT_OPEN وTRANSIT_FRAGMENT_CLOSE وTRANSIT_FRAGMENT_FADE، الآن Animator بدلاً من Animation. (b/166155034)

إصلاحات أخطاء في New State Manager

  • تعمل الآن "اللقطات" على استعادة حالة تركيز العرض بشكل صحيح من قبل بدء الحركة مباشرةً. (Icc256)
  • تكتمل الآن بشكل صحيح التأثيرات الخاصة للأجزاء التي تتضمّن انتقال عنصر مشترك فقط، ما يعني أنّها تنتقل فعليًا إلى حالتها النهائية (Iaebc7، b/166658128).
  • تتم الآن دائمًا إزالة طرق عرض الأجزاء من الحاوية قبل إيقافها. (Id5876)
  • يزيل مدير الحالة الجديد الآن بشكل متّسق طريقة عرض الجزء الذي سيتم إغلاقه قبل إضافة الجزء الذي سيتم فتحه. (I41a6e)
  • يتم الآن احترام التغييرات الصريحة في إعدادات عرض جزء من الشاشة من خلال أداة إدارة الحالة الجديدة. وهذا يعني أنّه في حال ضبطت طريقة عرض جزء الدخول على INVISIBLE قبل بدء الصورة المتحركة، سيظل الجزء غير مرئي. (b/164481490)
  • تمنح الأجزاء الآن الأولوية 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)

  • يمكن استخدام واجهة برمجة تطبيقات تجريبية في FragmentManager.enableNewStateManager(boolean) للتحكّم في ما إذا كان FragmentManager يستخدم أداة إدارة الحالة الجديدة. (I7b6ee)

لا يتم إصلاح المشاكل التالية إلا عند استخدام أداة إدارة الحالة الجديدة:

  • يتم الآن إيقاف الجزء السابق من عملية replace بشكل صحيح قبل بدء الجزء الجديد. (b/161654580)
  • تمنع الآن "اللقطات" تشغيل عدة رسوم متحركة متنافسة على اللقطات نفسها، ما يجنّب الحالات التي قد يؤدي فيها Animation إلى إلغاء جميع تأثيرات Transition أو تشغيل Animator وTransition على لقطة فردية. (b/149569323)
  • يتم الآن تنفيذ enterTransition وexitTranstion لجميع الأجزاء التي يتم إدخالها وإخراجها كلها، بدلاً من تنفيذها فقط للجزء الأخير الذي يتم إدخاله والجزء الأول الذي يتم إخراجه. (b/149344150)
  • لم تعُد الأجزاء المؤجّلة عالقة في الحالة CREATED، بل انتقلت إلى الحالة STARTED مع الأجزاء الأخرى. (b/129035555)
  • تم إصلاح مشكلة كانت تؤدي إلى تنفيذ عمليات FragmentManager بترتيب غير صحيح عند الجمع بين عملية مؤجّلة تم إعادة ترتيبها وعملية لم تتم إعادة ترتيبها. (b/147297731)
  • لن يؤدي عرض أجزاء متعددة في الوقت نفسه إلى ظهور الأجزاء الوسيطة مؤقتًا عند تأجيل الأجزاء. (b/37140383)
  • تعرض الدالة FragmentManager الآن الأجزاء الصحيحة عند استدعاء findFragmentById() أو findFragmentByTag() من داخل الدالة onAttachFragment(). (b/153082833)
  • لم يعُد يتم استدعاء onCreateView() في الأجزاء التي يتم إتلافها عندما يتم تأجيل الجزء الذي يحل محلها. (b/143915710)
  • تتضمّن رسالة الخطأ التي تظهر عند محاولة دمج مثيلات إطار العمل Transition وAndroidX Transition الآن الإشارة إلى الجزء الذي يتضمّن الانتقال غير الصالح. (b/155574969)

التغييرات في السلوك

  • يمكنك الآن استدعاء launch() في ActivityResultLauncher ضمن طريقة دورة الحياة onCreate() لأحد الأجزاء. (b/161464278)
  • سيؤدي استدعاء registerForActivityResult() بعد onCreate() الآن إلى عرض استثناء يشير إلى أنّه غير مسموح بذلك بدلاً من عدم عرض النتائج بدون إشعار بعد تغيير الإعدادات. (b/162255449)
  • يستخدم FragmentActivity الآن واجهة برمجة التطبيقات OnContextAvailableListener التي تم تقديمها في Activity 1.2.0-alpha08 لاستعادة حالة FragmentManager. سيتم تنفيذ أي مستمعين تمت إضافتهم إلى فئات فرعية من FragmentActivity بعد هذا المستمع. (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)
  • تمت إضافة بديل لواجهة برمجة التطبيقات FragmentScenario الخاصة بـ onFragment في شكل طريقة إضافة Kotlin reified withFragment التي تتيح لك عرض قيمة. والجدير بالذكر أنّه يعيد طرح الاستثناءات التي تم إنشاؤها في الكتلة المحدّدة. (b/158697631)

التغييرات في السلوك

  • تستخدم FragmentScenario الآن setMaxLifecycle() لتنفيذ moveToState()، ما يضمن سلوكًا متسقًا على جميع مستويات واجهة برمجة التطبيقات وفصل حالة Fragment عن النشاط الأساسي. (b/156527405)
  • إنّ SavedStateRegistryOwner الذي تعرضه الدالة ViewTreeSavedStateRegistryOwner مرتبط الآن بدورة حياة عرض الجزء. ويضمن ذلك حفظ حالته واستعادتها في الوقت نفسه الذي يتم فيه استعادة طريقة عرض الجزء. (b/158503763)

إصلاح الأخطاء

  • تنتظر الأجزاء الآن إلى أن يتم ربط طريقة عرض الجزء قبل طلب ViewCompat.requestApplyInsets()، ما يمنع حدوث حالات يتم فيها إسقاط طلب المساحة الداخلية. (b/158095749)
  • تعمل الدالة Calling clearFragmentResultListener الآن على محو مراقب دورة الحياة بشكل صحيح. (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 هذه التعديلات.

الميزات الجديدة

  • تم إيقاف معاودة الاتصال 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 هذه التعديلات.

الميزات الجديدة

التغييرات في واجهة برمجة التطبيقات

  • تتطلّب واجهتا برمجة التطبيقات setFragmentResult() وsetFragmentResultListener() الآن قيمتَين غير فارغتين Bundle وFragmentResultListener على التوالي. لمحو نتيجة أو أداة معالجة تم ضبطها سابقًا بشكلٍ صريح، استخدِم الطريقتَين الجديدتَين clearFragmentResult() وclearFragmentResultListener(). (b/155416778)
  • تم الآن وضع العلامة inline على إضافات setFragmentResultListener() Kotlin التي تستخدم تعبير lambda. (b/155323404)

التغييرات في السلوك

  • إنّ startActivityForResult() وstartIntentSenderForResult() وrequestPermissions المتوقّفة نهائيًا سابقًا على Fragment تستخدم الآن ActivityResultRegistry داخليًا، ما يؤدي إلى إزالة القيود المفروضة على استخدام الأجزاء الأقل (أقل من 0xFFFF) فقط لرموز الطلبات عند استخدام واجهات برمجة التطبيقات هذه. (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َين من خلال واجهات برمجة تطبيقات جديدة في FragmentManager. يعمل ذلك مع أجزاء التسلسل الهرمي (العنصر الرئيسي/العنصر التابع) وDialogFragment والأجزاء في Navigation، ويضمن إرسال النتائج إلى الجزء فقط عندما يكون في الحالة STARTED على الأقل. (b/149787344)

التغييرات في واجهة برمجة التطبيقات

  • تم إيقاف واجهات برمجة التطبيقات الخاصة بالتقسيم المستهدَف نهائيًا. لنقل البيانات بين الأجزاء، يجب استخدام واجهات برمجة التطبيقات الجديدة Fragment Result APIs بدلاً من ذلك. (b/149787344)
  • تم إيقاف واجهتَي برمجة التطبيقات startActivityForResult()/onActivityResult() وrequestPermissions()/onRequestPermissionsResult() نهائيًا في Fragment. يُرجى استخدام واجهات برمجة التطبيقات لنتائج الأنشطة. (aosp/1290887)
  • تغيير غير متوافق من النشاط 1.2.0-alpha04: تم تغيير اسم الطريقة prepareCall() إلى registerForActivityResult(). (aosp/1278717)

إصلاح الأخطاء

  • يتم الآن إيقاف getViewLifecycleOwner() للجزء قبل استدعاء onSaveInstanceState()، ما يعكس سلوك دورة حياة الجزء. (b/154645875)
  • يؤدي استدعاء setMenuVisibility(false) على جزء الآن إلى تغيير مستوى ظهور القوائم التي توفّرها الأجزاء الفرعية بشكل صحيح. (b/153593580)
  • تم إصلاح illegalStateException عند إضافة جزء إلى هيكلية طرق عرض DialogFragment باستخدام FragmentContainerView. (b/154366601)
  • لم يعُد يتم إيقاف الطريقة getDefaultViewModelProviderFactory() في الأجزاء بشكل غير متوقّع عند استضافة الأجزاء خارج أحد الأنشطة. (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 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • أصبحت طرق prepareCall على Fragment الآن final. (b/152439361)

إصلاح الأخطاء

  • تم إصلاح مشكلة تراجع في الأداء تم رصدها في Fragment 1.3.0-alpha02 عند استخدام BottomSheetDialogFragment. (b/151652127 وaosp/1263328 وaosp/1265163)
  • تم إصلاح عُطل عند استخدام prepareCall من جزء بعد تغيير الإعدادات. (b/152137004)
  • تم إصلاح مشكلة تجاهل العناصر المشترَكة وعمليات الانتقال عند الخروج عند استخدام setTargetFragment(). (b/152023196)
  • من Fragment 1.2.4: تم تعديل قواعد Fragment ProGuard للسماح بتشفير الأجزاء التي تم الاحتفاظ بها. (b/151605338)
  • من Fragment 1.2.4: تم إيقاف قاعدة FragmentLiveDataObserve Lint في فئات DialogFragment لأنّ دورة حياتها ودورة حياة العرض متزامنتان دائمًا، ما يجعل من الآمن استخدام this أو viewLifecycleOwner عند استدعاء observe. (b/151765086)

التغييرات في الاعتماديات

  • تعتمد الأجزاء على Activity 1.2.0-alpha03، الذي تم إجراء تحسينات كبيرة عليه في Activity 1.2.0-alpha02 من خلال واجهة برمجة التطبيقات Activity Result API.

الإصدار 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 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة إمكانية استخدام واجهة برمجة التطبيقات ActivityResultRegistry التي تم تقديمها في Activity 1.2.0-alpha02 للتعامل مع مسارات startActivityForResult()+onActivityResult() بالإضافة إلى مسارات requestPermissions()+onRequestPermissionsResult() بدون إلغاء الطرق في Fragment، بالإضافة إلى توفير نقاط ربط لاختبار هذه المسارات. اطّلِع على الحصول على نتيجة من نشاط المعدَّل. (b/125158199)

التغييرات في واجهة برمجة التطبيقات

  • توفّر 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: تم إصلاح النتائج الإيجابية الخاطئة في عملية فحص UseRequireInsteadOfGet Lint عند استخدام اسم متغير محلي يحجب اسم السمة في 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 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة إمكانية استخدام واجهة برمجة التطبيقات ViewTreeLifecycleOwner.get(View) التي تمت إضافتها في Lifecycle 2.3.0-alpha01، وذلك لكي تعرض viewLifecycleOwner الخاص بـ Fragment كـ LifecycleOwner لأي عروض يتم عرضها من خلال onCreateView(). (aosp/1182955)

التغييرات في واجهة برمجة التطبيقات

  • تم إيقاف الطريقة setRetainInstance() في الفئات Fragments نهائيًا. مع طرح ViewModels، أصبح لدى المطوّرين واجهة برمجة تطبيقات محدّدة للاحتفاظ بالحالة التي يمكن ربطها بالأنشطة واللقطات ورسوم بيانية للتنقّل. يتيح ذلك للمطوّرين استخدام 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". (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 هذه التعديلات.

إصلاح الأخطاء

  • تم تعديل قواعد Fragment ProGuard للسماح بتشفير الأجزاء المحفوظة. (b/151605338)
  • تم إيقاف قاعدة FragmentLiveDataObserve Lint في فئات 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)
  • تقترح الأجزاء الآن استخدام طرق require___() المرتبطة بها للحصول على رسائل خطأ أكثر وصفًا بدلاً من checkNotNull(get___()) أو requireNonNull(get___()) أو get___()!! لجميع واجهات Fragment API التي تتضمّن كلاً من get وrequire. (aosp/1202883)

إصلاح الأخطاء

  • تم إصلاح ملفات Fragment ProGuard لتجنُّب تحذيرات R8 (b/148963981)
  • تم تحسين عملية التحقّق الحالية من Lint التي تقترح استخدام viewLifecycleOwner عند استخدام observe للتعامل أيضًا مع إصدار طريقة الإضافة livedata-ktx من observe. (b/148996309)
  • تم إصلاح التنسيق الخاص بالعديد من عمليات التحقّق من أداة Lint (aosp/1157012)

المساهمات الخارجية

  • نشكر Zac Sweers على المساهمة في require___() عمليات التحقّق من Lint نيابةً عن 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 الآن ببرنامج الإنشاء التلقائي للأجزاء التي تتم إضافتها باستخدام الطريقتَين add وreplace اللتَين تستخدمان مثيلاً من Class (أو إصدارات Kotlin reified). (b/148181315)
  • لم يعُد FragmentStatePagerAdapter وFragmentPagerAdapter يرصدان الاستثناءات التي يعرضها FragmentManager عند تنفيذ finishUpdate(). (aosp/1208711)
  • تم إصلاح مشكلة عدم عمل FragmentManager.findFragment() مع الأجزاء المضافة من خلال العلامة <fragment>. (b/147784323)
  • تتلقّى الآن الأجزاء التي تم توسيعها باستخدام العلامة <fragment> دائمًا طلبًا إلى onInflate() قبل onCreate() عندما تكون في التصميم. (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 هي الحاوية التي يُنصح بشدة باستخدامها لإضافة "التقسيمات" ديناميكيًا، ما يحلّ محل استخدام FrameLayout أو غيرها من التصاميم. تتوافق هذه العلامة أيضًا مع class وandroid:name وandroid:tag الاختيارية نفسها التي تتوافق مع العلامة <fragment>، ولكنّها تستخدم FragmentTransaction عاديًا لإضافة هذا الجزء الأوّلي، بدلاً من مسار الرمز المخصّص الذي تستخدمه العلامة <fragment>.
  • onDestroyView() التوقيت: تنتظر الآن "اللقطات" إلى أن تكتمل حركات الخروج والعمليات الانتقالية لإطار عمل الخروج والعمليات الانتقالية في AndroidX (عند استخدام Transition 1.3.0) قبل استدعاء onDestroyView().
  • استنادًا إلى الفئة add() وreplace(): تمت إضافة عمليات تحميل زائدة جديدة من add() وreplace() على FragmentTransaction التي تأخذ Class<? extends Fragment> وBundle اختيارية من الوسيطات. تستخدم هذه الطرق FragmentFactory لإنشاء مثيل من Fragment المراد إضافته. تمت أيضًا إضافة إضافات Kotlin التي تستخدم أنواعًا مجسّدة (أي fragmentTransaction.replace<YourFragment>(R.id.container)) إلى fragment-ktx.
  • عملية دمج SavedState مع Lifecycle ViewModel: أصبح SavedStateViewModelFactory الآن المصنع التلقائي المستخدَم عند استخدام by viewModels() أو by activityViewModels() أو الدالة الإنشائية ViewModelProvider أو ViewModelProviders.of() مع Fragment.
  • عمليات فحص Lint الجديدة: تمت إضافة عملية فحص Lint جديدة تضمن استخدام getViewLifecycleOwner() عند مراقبة LiveData من onCreateView() أو onViewCreated() أو onActivityCreated().
  • الإيقاف النهائي لـ getFragmentManager(): تم إيقاف الطريقتَين getFragmentManager() وrequireFragmentManager() نهائيًا في Fragment واستبدالهما بالطريقة getParentFragmentManager() الفردية التي تعرض FragmentManager غير الفارغ الذي تمت إضافة Fragment إليه (يمكنك استخدام isAdded() لتحديد ما إذا كان من الآمن طلبها).
  • إيقاف FragmentManager.enableDebugLogging() نهائيًا: تم إيقاف الإجراء الثابت FragmentManager.enableDebugLogging نهائيًا. يتوافق FragmentManager الآن مع Log.isLoggable() للعلامة FragmentManager، ما يتيح لك تفعيل تسجيل DEBUG أو VERBOSE بدون إعادة تجميع تطبيقك.

المشاكل المعروفة

  • لا يحتفظ ProGuard تلقائيًا بالقصاصات التي تتم الإشارة إليها فقط من خلال السمة class أو android:name في FragmentContainerView، ما يتطلّب منك إضافة قاعدة keep يدويًا لكل فئة قصاصة. (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 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح تغيير غير مقصود في السلوك، حيث كان يتم عرض الأجزاء التي تمت إزالتها من خلال findFragmentById() / findFragmentByTag() أثناء تشغيل الرسوم المتحركة/عمليات الانتقال للخروج. (b/143982969 وaosp/1167585)
  • يتم الآن إيقاف الأجزاء الفرعية للطفل بشكل صحيح قبل الأجزاء الرئيسية عند استدعاء النشاط الذي يحتوي على onSaveInstanceState(). (b/144380645)
  • تم إصلاح المشكلة التي كانت تؤدي إلى وضع العلامة INVISIBLE بشكل غير صحيح على "طرق العرض" بعد إظهار جزء مخفي. (b/70793925)
  • تتعامل الآن عمليات الانتقال بين العناصر المشترَكة في الأجزاء مع "طرق العرض" التي تم تدويرها أو تغيير حجمها أو غير ذلك (b/142835261).

تعديلات على المستندات

  • تم توضيح مستندات الإيقاف النهائي حول setUserVisibleHint(). (b/143897055)
  • تم تحسين المستندات حول setFragmentFactory() وgetFragmentFactory() للإشارة بشكل أفضل إلى أنّ ضبط FragmentFactory سيؤثر أيضًا في FragmentManager الفرعية. (aosp/1170095)

التغييرات في الاعتماديات

  • تعتمد الآن الفئات Fragment على 2.2.0-rc03 Lifecycle و1.0.0-rc03 Lifecycle ViewModel SavedState و1.1.0-rc03 Activity.

الإصدار 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، تستخدم أداة LintFix الآن صيغة الوصول إلى السمة في Kotlin viewLifecycleOwner بدلاً من getViewLifecycleOwner() عند مراقبة LiveData من onCreateView() أو onViewCreated() أو onActivityCreated() (تم تقديمها في Fragment 1.2.0-rc01).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)

إصلاح الأخطاء

  • تضمن الآن عمليات معاودة الاتصال onDismiss وonCancel في DialogFragment أنّ قيمة DialogInterface التي تم تمريرها إليها ليست فارغة وأنّ getDialog() تعرض قيمة غير فارغة عند تنفيذها. (b/141974033)
  • تضيف السمة FragmentContainerView الآن Fragment الذي تحدّده السمة class أو android:name كجزء من عملية الإنشاء، ما يضمن عمل السمتَين findFragmentById() وfindFragmentByTag() مباشرةً بعد ذلك. (b/142520327)
  • تم إصلاح IllegalStateException في FragmentContainerView بسبب حفظ الحالة. (b/142580713)
  • تم إصلاح UnsupportedOperationException في FragmentContainerView عندما يكون صف FragmentContainerView مشوّشًا. (b/142657034)

المشاكل المعروفة

  • لا يحتفظ ProGuard تلقائيًا بالقصاصات التي تتم الإشارة إليها فقط من خلال السمة class أو android:name في FragmentContainerView، ما يتطلّب منك إضافة قاعدة keep يدويًا لكل فئة قصاصة. لقد أوقفنا قاعدة 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 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح مشكلة عدم تلقّي onInflate() في Fragment للسمات المناسبة من 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)
  • تحتوي الآن الفِقرات على تحذير Lint يقدّم حلاً سريعًا لاستبدال <fragment> بـ FragmentContainerView. (b/139830056)

إصلاح الأخطاء

  • تم إصلاح ClassCastException عند استخدام androidx.transition. (b/140680619)
  • عند استخدام Transition 1.3.0-beta01، تنتظر الآن الفئات androidx.transition إلى أن تنتهي عمليات الانتقال (بالإضافة إلى عمليات الانتقال والرسوم المتحركة في إطار العمل، والتي تم إصلاحها في Fragment 1.2.0-alpha03 وFragment 1.2.0-alpha02 على التوالي) قبل إرسال onDestroyView(). (aosp/1119841)
  • عند استخدام الانتقال 1.3.0-beta01، تلغي الآن "اللقطات" عمليات الانتقال androidx.transition بشكل صحيح قبل بدء عمليات انتقال أو رسوم متحركة جديدة على الحاوية نفسها. (aosp/1119841)
  • تم إصلاح مشكلة في الإصدار 17 من واجهة برمجة التطبيقات والإصدارات الأقدم عند استخدام انتقالات androidx.transition في العرض الجذر لـ Fragment عند استخدام FragmentContainerView. (b/140361893)
  • تعتمد حزمة fragment-testing الآن على 1.2.0 AndroidX Test، ما يحلّ مشكلة عدم التوافق مع أحدث إصدار من Espresso 3.2.0. (b/139100149)
  • تمت إزالة استخدام Log.w في FragmentManager. (aosp/1126468)

المشاكل المعروفة

  • لا تتلقّى onInflate() الأجزاء سمات مناسبة من FragmentContainerView، ما يؤدي إلى حدوث مشاكل مثل 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تم إيقاف الطريقتَين getFragmentManager() وrequireFragmentManager() في Fragment نهائيًا واستبدالهما بالطريقة getParentFragmentManager() الفردية التي تعرض قيمة FragmentManager غير الفارغة التي تمت إضافة Fragment إليها (يمكنك استخدام isAdded() لتحديد ما إذا كان من الآمن طلبها). (b/140574496)
  • تم إيقاف طريقة FragmentManager.enableDebugLogging الثابتة نهائيًا. تتيح FragmentManager الآن استخدام Log.isLoggable() للعلامة FragmentManager، ما يسمح لك بتفعيل تسجيل DEBUG أو VERBOSE بدون إعادة تجميع تطبيقك. (aosp/1116591)

إصلاح الأخطاء

  • يتم الآن إيقاف الأجزاء بشكل صحيح أثناء تشغيل الرسوم المتحركة للخروج على الأجزاء الأخرى. (b/140574199)
  • تم إصلاح مشكلة كانت تؤدي إلى أن تستدعي الفئات 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. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

تغييرات واجهة برمجة التطبيقات

  • ‫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)

تغييرات واجهة برمجة التطبيقات

  • يقدّم FragmentContainerView كحاوية يُنصح بشدة باستخدامها لإضافة "اللقطات" بشكل ديناميكي، ما يحلّ محل استخدام FrameLayout وما إلى ذلك، لأنّه يحلّ مشاكل ترتيب z للرسوم المتحركة وإرسال هوامش النافذة إلى "اللقطات". (b/37036000 وaosp/985243 وb/136494650)
  • تمت إضافة طريقة FragmentManager.findFragment(View) ثابتة لاسترداد Fragment الذي يحتوي على طريقة عرض تم إنشاؤها من خلال Fragment. تتوفّر أيضًا إضافة Kotlin باللغة fragment-ktx. (aosp/1090757)
  • تمت إضافة عمليات تحميل زائد جديدة للدالتَين add() وreplace() في FragmentTransaction التي تتضمّن Class<? extends Fragment> وBundle اختيارية من الوسيطات. تستخدم هذه الطرق FragmentFactory لإنشاء مثيل من Fragment المراد إضافته. تمت أيضًا إضافة إضافة Kotlin التي تستخدم أنواعًا مجسّمة (أي fragmentTransaction.replace<YourFragment>(R.id.container)) إلى fragment-ktx. (b/126124987)
  • تمت إضافة التعليقات التوضيحية @MainThread إلى عمليات معاودة الاتصال بدورة حياة Fragment. (b/127272564)
  • تم إيقاف واجهات برمجة التطبيقات نهائيًا التي تتناول عناوين مسارات التنقّل على FragmentTransaction وFragmentManager.BackStackEntry. (b/138252944)
  • تم إيقاف طريقة setTransitionStyle نهائيًا في FragmentTransaction. (aosp/1011537)
  • لم يعُد العديد من الطرق في FragmentManager abstract. يظل FragmentManager abstract ويجب عدم إنشاء مثيل له أو توسيعه مباشرةً، بل يجب مواصلة الحصول على مثيل حالي من getSupportFragmentManager() أو getChildFragmentManager() أو غير ذلك.

إصلاح الأخطاء

  • من Fragment 1.1.0-rc04: تلغي الآن Fragments عمليات الانتقال المؤجّلة بشكل صحيح عند إغلاقها. (b/138251858)
  • من Fragment 1.1.0-rc03: تم إصلاح مشكلة عدم إلغاء المهلات السابقة عند استدعاء postponeEnterTransition() مع مهلة أكثر من مرة. (b/137797118)
  • من Fragment 1.1.0-rc02: تم إصلاح عُطل في FragmentPagerAdapter وFragmentStatePagerAdapter عند إزالة العنصر الحالي. (b/137209870)
  • تنتظر الآن الأجزاء اكتمال الصور المتحركة قبل إرسال onDestroyView(). (b/136110528)
  • يتم الآن التعامل بشكل صحيح مع الرسوم المتحركة للأجزاء من الأجزاء الفرعية والعناصر التابعة لها عند تحريك الجزء الرئيسي. (b/116675313)
  • تم إصلاح NullPointerException عند استخدام عمليات الانتقال بين العناصر المشترَكة والجمع بين عملية إضافة وعملية إغلاق. (b/120507394)
  • تمت إضافة حلّ بديل لـ IllegalStateException عند استخدام 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 لاختبار جزء بشكل مستقل. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات اختبار أجزاء تطبيقك.
  • FragmentFactory: يمكنك الآن ضبط FragmentFactory على FragmentManager لإدارة إنشاء مثيلات الأجزاء، ما يزيل الشرط الصارم بضرورة توفُّر دالة إنشاء بدون وسيطة.
  • مفوّضات سمات Kotlin لـ ViewModels: يحتوي العنصر fragment-ktx الآن على مفوّضتَين لسمات Kotlin: by viewModels() للوصول إلى ViewModels المرتبطة بالجزء الفردي وby activityViewModels() للوصول إلى ViewModels النطاقية في النشاط.
  • Max Lifecycle: يمكنك الآن ضبط الحد الأقصى لحالة Lifecycle الخاصة بـ Fragment من خلال استدعاء setMaxLifecycle() على FragmentTransaction. يحلّ هذا الإصدار محلّ setUserVisibleHint() الذي تم إيقافه نهائيًا. يحتوي كل من FragmentPagerAdapter وFragmentStatePagerAdapter على دالة إنشاء جديدة تتيح لك التبديل إلى السلوك الجديد.
  • دالة إنشاء FragmentActivity LayoutId: يمكن الآن لفئات FragmentActivity الفرعية استدعاء دالة إنشاء في FragmentActivity تقبل معرّف R.layout، ما يشير إلى التصميم الذي يجب ضبطه كطريقة عرض المحتوى كبديل لاستدعاء setContentView() في onCreate(). لا يغيّر ذلك شرط أن يكون لفئتك الفرعية دالة إنشاء بدون وسيطات.
  • دالة إنشاء Fragment LayoutId: يمكن الآن للفئات الفرعية من Fragment استدعاء دالة إنشاء بشكل اختياري في 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 (المرتبطة تحديدًا بـ STARTED وRESUMED وPAUSED وSTOPPED وDESTROYED) لـ "التقسيمات" المضمّنة مضمّنة بشكلٍ صحيح. (b/133497591)
  • تأخذ مثيلات OnBackPressedCallback المسجّلة في onCreate() ضمن Fragment الآن الأولوية بشكلٍ صحيح على FragmentManager الفرعي. (b/133175997)
  • لم تعُد يتم تحريك أجزاء الطفل عندما يتم استبدال جزء الوالد. (b/121017790)
  • يتم الآن تجاهل الرسوم المتحركة والانتقالات في الأجزاء عند استخدام animateLayoutChanges="true"، ما يؤدي إلى حلّ مشكلة عدم إيقاف الأجزاء بشكل صحيح. (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. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

تغييرات واجهة برمجة التطبيقات

  • تتلقّى الآن الأجزاء ردّ اتصال إلى طريقة onPrimaryNavigationFragmentChanged(boolean) جديدة عند تغيير جزء التنقّل الأساسي. aosp/960857

إصلاح الأخطاء

  • تتم الآن إزالة عناصر القائمة التي تم توسيعها بواسطة جزء فرعي بشكل صحيح عند إزالة الجزء الرئيسي. 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. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

هذا الإصدار غير متوافق مع الإصدارات من 1.1.0-alpha01 إلى 1.1.0-alpha04 من Preferences. يُرجى الترقية إلى الإصدار 1.1.0-alpha05 من Preferences عند استخدام هذا الإصدار من Fragments.

الميزات الجديدة

  • تمت إضافة تحميل زائد جديد للوظيفة postponeEnterTransition() يستغرق مهلة زمنية، وبعدها سيستدعي Fragment تلقائيًا الوظيفة startPostponedEnterTransition() b/120803208

تغييرات واجهة برمجة التطبيقات

  • تغيير غير متوافق: تمت إزالة الطريقة 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)، سيتم إيقاف عرض "اللقطات" بشكل صحيح. 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. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

الميزات الجديدة

  • يمكنك الآن ضبط الحدّ الأقصى لحالة Lifecycle الخاصة بـ Fragment من خلال استدعاء setMaxLifecycle() على FragmentTransaction. يحلّ هذا الإصدار محلّ setUserVisibleHint() الذي تم إيقافه نهائيًا. يحتوي كل من FragmentPagerAdapter وFragmentStatePagerAdapter على دالة إنشاء جديدة تتيح لك التبديل إلى السلوك الجديد. (b/129780800)

التغييرات في واجهة برمجة التطبيقات

  • يمكن الآن طلب moveToState(STARTED) على FragmentScenario فقط على الأجهزة التي تعمل بالإصدار 24 من واجهة برمجة التطبيقات والإصدارات الأحدث. (b/129880016)

التغييرات في السلوك

  • نتيجةً لذلك (b/129907905)، لن تتلقّى الأجزاء في سجلّ الأنشطة السابقة رد اتصال إلى onCreateView() عند إعادة إنشاء النشاط المضيف. لن يتم استدعاء onCreateView() إلا عندما يصبح الجزء مرئيًا (أي عند إزالة آخر عنصر من حزمة الخلف).

إصلاح الأخطاء

  • تم إصلاح مشكلة عند استخدام العلامة <fragment> في XML ومنشئ contentLayoutId الخاص بـ FragmentActivity أو AppCompatActivity. (b/129907905)
  • تم إصلاح مشكلة عدم نقل الأجزاء في حزمة الخلف إلى CREATED على الأقل بعد تغيير الإعدادات، ما يؤدي إلى عدم التخلص من ViewModels والأجزاء الفرعية المحفوظة بشكلٍ صحيح. (b/129593351)
  • تم إصلاح عُطل في restoreSaveState ناتج عن عدم مزامنة الأجزاء المحفوظة بعد حفظ حالة المثيل. (b/130433793) (aosp/947824)
  • تم إصلاح المشاكل التي لم يتم فيها استدعاء OnBackPressedCallback تمت إضافته باستخدام مراحل نشاط جزء إذا كان FragmentManager يحتوي على الأنشطة السابقة. لمزيد من التفاصيل، يمكنك الاطّلاع على androidx.activity 1.0.0-alpha07. (aosp/948209)
  • لم تعُد الأجزاء تفرض LAYER_TYPE_HARDWARE على الصور المتحركة. إذا كنت بحاجة إلى صورة متحركة على مستوى الأجهزة، يُرجى ضبطها كجزء من الصورة المتحركة. (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)

التغييرات في واجهة برمجة التطبيقات

  • يحتوي كل من Fragment وFragmentActivity الآن على دالة إنشاء ثانية تأخذ @LayoutRes int، ما يحلّ محل السلوك السابق المتمثل في إضافة تعليقات توضيحية إلى صفك باستخدام @ContentView. يعمل هذا الأسلوب في كلّ من وحدات التطبيق والمكتبة. (b/128352521)
  • تم الآن وضع علامة @CallSuper بشكل صحيح على onActivityResult() في FragmentActivity. (b/127971684)
  • تم إيقاف الطريقة instantiate في FragmentFactory التي تقبل حزمة وسيطة، ويجب أن تستخدم التطبيقات الطريقة الجديدة instantiate التي لا تقبل حزمة. (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. يمكنك الاطّلاع على القائمة الكاملة للتعديلات في هذا الإصدار هنا.

الميزات الجديدة

  • تم الآن تخزين عمليات البحث عن التعليقات التوضيحية @ContentView مؤقتًا (b/123709449)

التغييرات في السلوك

  • عند استدعاء remove() وhide() وshow() وdetach() وsetPrimaryNavigationFragment() مع ربط جزء بـ FragmentManager مختلف، سيتم الآن عرض الخطأ IllegalStateException بدلاً من حدوث خطأ بدون إشعار (aosp/904301).

إصلاح الأخطاء

  • تم الآن وضع علامة @CallSuper بشكل صحيح على onNewIntent مقابل FragmentActivity (b/124120586)
  • تم إصلاح مشكلة كان يمكن فيها استدعاء onDismiss() في DialogFragment مرّتين عند استخدام 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 الآن على الإصدار الثابت 1.1.0 من androidx.test:core-ktx (b/121209673)
  • يمكنك الآن استخدام openActionBarOverflowOrOptionsMenu مع FragmentScenario لاختبار قوائم الخيارات المستضافة في Fragment (b/121126668).

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة طريقة requireArguments() تعرض @NonNull Bundle أو تُطلق IllegalStateException (b/121196360)
  • تمت إضافة ملاحظة تفيد بأنّه يجب عدم تجاهل getLifecycle() وgetViewLifecycleOwner() وgetViewLifecycleOwnerLiveData()، وسيتم إتاحتها بشكل نهائي في إصدار مستقبلي. يُرجى تقديم طلب ميزة إذا كنت تتجاهل هذه الطريقة حاليًا. (aosp/880714)
  • تمت إضافة ملاحظة تفيد بأنّه يجب عدم تجاهل getViewModelStore() وسيتم إتاحتها بشكل نهائي في إصدار مستقبلي. يُرجى تقديم طلب ميزة إذا كنت تتجاهل هذه الطريقة حاليًا. (aosp/880713)
  • تم إصلاح مشكلة متعلّقة بتوافق الرمز الثنائي مع الإصدارات السابقة من Fragments. (aosp/887877) (aosp/889834)

إصلاح الأخطاء

  • يتم محو الأجزاء المستهدَفة بشكل صحيح عند تمرير null إلى setTargetFragment(). (aosp/849969)
  • تم إصلاح مشكلة عدم توفّر "اللقطات" المستهدَفة أحيانًا في onDestroy() أو بعده. (b/122312935)
  • يتم الآن استدعاء onDismiss()‎ في DialogFragment قبل onDestroy(). (aosp/874133) (aosp/890734)

الإصدار ‎1.1.0-alpha03

‫17 كانون الأول (ديسمبر) 2018

الميزات الجديدة

  • تتضمّن الفئة Fragment الآن BundleSavedStateRegistryOwner وتعتمد على مكتبة SavedState التي تم إصدارها حديثًا [aosp/824380]
  • تمت إضافة by activityViewModels مفوّض موقع Kotlin لاسترداد ViewModels المرتبطة بـ Activity التي تحتوي عليها [b/119050253]
  • تم توسيع نطاق by viewModels Kotlin property delegate ليشمل طريقة lambda اختيارية للحصول على ViewModelStoreOwner، ما يتيح لك تمرير Fragment الرئيسي أو ViewModelStoreOwner مخصّص آخر باستخدام رمز مثل val viewModel: MyViewModel by viewModels(::requireParentFragment) [b/119050253]

تغييرات واجهة برمجة التطبيقات

  • تتيح لك FragmentScenario الآن تحديد مظهر مثل Theme.AppCompat [b/119054431]. هذا تغيير قد يؤدي إلى عطل.
  • تمت إضافة طريقة requireView() تعرض @NonNull View أو تُطلق IllegalStateException [b/120241368]
  • تمت إضافة طريقة requireParentFragment() تعرض @NonNull Fragment أو تُطلق IllegalStateException [b/112103783]

إصلاح الأخطاء

  • تم إصلاح IllegalStateException: تعذُّر حفظ الحالة b/120814739
  • ستتلقّى الآن الأجزاء التي تتم استعادتها من حالة المثيل المحفوظة دائمًا قيمة غير فارغة Bundle [b/119794496]
  • لم تعُد "اللقطات" التي تمت إزالتها تعيد استخدام كائن Lifecycle الخاص بها في حال إعادة إضافتها [b/118880674]

الإصدار ‎1.1.0-alpha02

‫3 كانون الأول (ديسمبر) 2018

الميزات الجديدة

  • تتيح لك إضافات Kotlin الخاصة بفئة FragmentScenario الآن استخدام تعبير lambda لإنشاء Fragment كبديل لتمرير مثيل FragmentFactory. (aosp/812913)

إصلاح الأخطاء

  • تم إصلاح IllegalStateException عند استخدام أجزاء متداخلة في سجلّ الرجوع (b/119256498)
  • تم إصلاح عُطل عند استخدام FragmentScenario.recreate() مع FragmentFactory (aosp/820540)
  • تم إصلاح مشكلة عدم إمكانية الوصول إلى أجزاء مستهدَفة بعد إزالة الجزء (aosp/807634)

الإصدار ‎1.1.0-alpha01

‫5 نوفمبر 2018

هذا هو الإصدار الأول من العنصر fragment-testing وFragmentScenario الذي تم إنشاؤه استنادًا إلى واجهات برمجة التطبيقات androidx.test:core. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات اختبار الأجزاء.

الميزات الجديدة

  • فئة FragmentScenario الجديدة لاختبار "اللقطات" بشكل منفصل
  • يمكنك الآن ضبط FragmentFactory على أي FragmentManager للتحكّم في طريقة إنشاء مثيلات Fragment الجديدة.
  • تمت إضافة تفويض جديد لسمة by viewModels() Kotlin من أجل استرداد ViewModels من Fragment.
  • يتم الآن إلغاء أحداث الإدخال المعلّقة (مثل النقرات) في onStop() لأحد التطبيقات.

تغييرات واجهة برمجة التطبيقات

  • تم توسيع نطاق التعليقات التوضيحية الخاصة بإمكانية قبول القيم الفارغة بشكل كبير على مستوى مساحة عرض 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 الصحيح.