الجزء

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

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

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

dependencies {
    def fragment_version = "1.8.9"

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

dependencies {
    val fragment_version = "1.8.9"

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

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

الملاحظات

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

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

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

الإصدار 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)

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

• يعتمد Fragment الآن على Profile Installer 1.3.1.

الإصدار 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 قبل اتخاذ قرار إما بتنفيذ المعاملة من خلال إكمال الإيماءة أو إلغائها.

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

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

Fragment Compose Artifact

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

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

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

• يعتمد Fragment الآن على Profile Installer 1.3.1.

الإصدار ‎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 السابق والتي كانت تتسبّب في ظهور الخطأ 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 لواجهة مستخدم جزء معيّن من خلال إنشاء 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 هذه التعديلات.

إخلاء مساحة

• تمت إزالة الحلّ البديل لمكتبة Transition الذي تم إصلاحه في Transition 1.5.0-alpha06. (I04356)

الإصدار 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 وHost والمعرّف، في دالة الاستدعاء 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 Transitions. يتيح لك ذلك استخدام إيماءة الرجوع للبحث عن الجزء السابق باستخدام 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.
• تعتمد الحزمة الآن على ProfileInstaller 1.3.0.

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

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

  يؤدي ذلك إلى تجنُّب حدوث تعارضات بسبب اختلاف الإصدار بين fragment-testing وandroidx.test

الإصدار 1.6.0-rc01

‫10 مايو 2023

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

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

• تم إصلاح مشكلة كانت تؤدي إلى إرسال ActivityResult مع رمز الطلب غير الصحيح عند تقديم طلبات startActivityForResult متعددة على التوالي. (If0b9d، b/249519359)
• تم إصلاح مشكلة كان يتم فيها إرسال عمليات معاودة الاتصال 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)

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

• يعتمد Fragment الآن على Lifecycle 2.6.1. (586fe7)
• يعتمد Fragment الآن على SavedState 1.2.1. (078e4e)
• تعتمد الحزمة الآن على ProfileInstaller 1.3.0. (3fc05b)

الإصدار ‎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)

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

• من Fragment 1.5.1: تم إصلاح مشكلة تراجع في DialogFragmentCallbacksDetector حيث كان استخدام إصدار lint المُضمَّن مع الإصدار 7.4 من "المكوّن الإضافي لنظام Android Gradle" يؤدي إلى تعطُّل lint. (b/237567009)

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

• من Fragment 1.5.1: تعتمد مكتبة Fragment الآن على Lifecycle 2.5.1. (Id204c)
• من Fragment 1.5.1: تعتمد مكتبة Fragment الآن على Activity 1.5.1. (I10f07)

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

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

• تم إصلاح المشكلة التي كانت تؤدي إلى تشغيل Animation/Animator غير صحيح عند تنفيذ عملية popBackStack() وعملية replace() في الوقت نفسه. (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)

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

• تعتمد مكتبة Fragment الآن على Lifecycle 2.5.1. (Id204c)
• تعتمد مكتبة Fragment الآن على Activity 1.5.1. (I10f07)

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

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

• يتم الآن حفظ الحالة المرتبطة بكل جزء على حدة بشكل منفصل عن الحالة الداخلية لـ FragmentManager، ما يتيح لك ربط مقدار الحالة المحفوظة المرتبطة بجزء فردي بمعرّفات فريدة مضمّنة في تسجيل تصحيح الأخطاء في الجزء. (a153e0، b/207158202)

الإصدار ‎1.5.0-beta01

‫20 أبريل 2022

تم طرح ميزات androidx.fragment:fragment:1.5.0-beta01 وandroidx.fragment:fragment-ktx:1.5.0-beta01 وandroidx.fragment:fragment-testing:1.5.0-beta01. يتضمّن الإصدار 1.5.0-beta01 هذه التعديلات.

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

• أضافت 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 هذه التعديلات.

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

• تم إيقاف setHasOptionsMenu() الخاص بـ "Fragment" نهائيًا. لإدارة القوائم وعناصرها، يجب استخدام واجهات برمجة التطبيقات الجديدة للقوائم بدلاً من ذلك وفقًا لملاحظات إصدار 1.5.0-alpha04 Fragment. (I7b4b4، b/226438239)

الإصدار ‎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)

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

• يستخدم DialogFragment الآن ComponentDialog كحوار تلقائي يتم عرضه من خلال onCreateDialog(). (If3784، b/217618170)

الإصدار ‎1.5.0-alpha02

‫9 فبراير 2022

تم طرح ميزات androidx.fragment:fragment:1.5.0-alpha02 وandroidx.fragment:fragment-ktx:1.5.0-alpha02 وandroidx.fragment:fragment-testing:1.5.0-alpha02. يتضمّن الإصدار 1.5.0-alpha02 هذه التعديلات.

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

• تتيح السمة FragmentStrictMode الآن إمكانية تجاوز عقوبات انتهاك معيّنة في المقاطع الخاصة التابعة لجهات خارجية من خلال استخدام allowViolation() مع اسم الفئة. (I8f678)

الإصدار ‎1.5.0-alpha01

‫26 يناير 2022

تم إصدار androidx.fragment:fragment:1.5.0-alpha01 وandroidx.fragment:fragment-ktx:1.5.0-alpha01 وandroidx.fragment:fragment-testing:1.5.0-alpha01. يتضمّن الإصدار 1.5.0-alpha01 هذه التعديلات.

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

• يتكامل Fragment الآن مع ViewModel CreationExtras، الذي تم تقديمه كجزء من Lifecycle 2.5.0-alpha01. (I3060b، b/207012585)

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

• من 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 بدون أي تغييرات منذ الإصدار 1.4.0-beta01 من Fragment. يتضمّن الإصدار 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 للتعامل بشكل أفضل مع الأقواس الزائدة. (I2d865)
• تم تحسين UseGetLayoutInflater فحص Lint للتعامل مع حالات حدودية إضافية. (Ie5423)

الإصدار 1.4.0-alpha07

‫18 أغسطس 2021

تم إصدار androidx.fragment:fragment:1.4.0-alpha07 وandroidx.fragment:fragment-ktx:1.4.0-alpha07 وandroidx.fragment:fragment-testing:1.4.0-alpha07 بدون أي تغييرات ملحوظة. يتضمّن الإصدار 1.4.0-alpha07 هذه التعديلات.

الإصدار ‎1.4.0-alpha06

‫4 أغسطس 2021

تم طرح ميزات androidx.fragment:fragment:1.4.0-alpha06 وandroidx.fragment:fragment-ktx:1.4.0-alpha06 وandroidx.fragment:fragment-testing:1.4.0-alpha06. يتضمّن الإصدار 1.4.0-alpha06 هذه التعديلات.

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

• تم إصلاح مشكلة تتعلّق بمجموعات متعددة من سجلّات الرجوع عند التبديل بسرعة بين سجلّات الرجوع، والتي كانت تظهر على شكل IllegalStateException عند استعادة FragmentTransaction أو على شكل نسخة ثانية من جزء يظهر. (I9039f)
• تم إصلاح مشكلة كانت تتسبب في احتفاظ FragmentManager بنسخة من الحالة التي تم حفظها سابقًا باستخدام saveBackStack() حتى بعد استعادة هذه الحالة. (Ied212)
• لم يعُد يتعطّل التطبيق عند استخدام الطريقة dismissAllowingStateLoss() في DialogFragment بعد حفظ الحالة عند إضافة DialogFragment تحديدًا باستخدام الطريقة show(FragmentTransaction, String). (I84422)

الإصدار ‎1.4.0-alpha05

‫21 تموز (يوليو) 2021

تم طرح ميزات androidx.fragment:fragment:1.4.0-alpha05 وandroidx.fragment:fragment-ktx:1.4.0-alpha05 وandroidx.fragment:fragment-testing:1.4.0-alpha05. يتضمّن الإصدار 1.4.0-alpha05 هذه التعديلات.

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

• من Fragment 1.3.6: يتم الآن ضبط طريقة عرض Fragment بشكل صحيح على GONE عند استخدام hide() عندما يتم ضبط طريقة العرض الجذر على transitionGroup=”true”. (aosp/1766655 وb/193603427)
• من Fragment 1.3.6: يتيح FragmentActivity الآن دائمًا فتح الحالة المحفوظة كأول عملية في عمليات معاودة الاتصال بدورة الحياة التي يتم تجاهلها. (I6db7a)

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

• من الجزء 1.3.6: أصبحت الأجزاء تعتمد الآن على النشاط 1.2.4 (I3a66c)

الإصدار 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() الخاصة بـ DialogFragment للحصول على LayoutInflater المناسب. (#156، b/170781346)
• يحذّرك فحص DialogFragmentCallbacksDetector Lint الآن عند استدعاء 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)
• من الإصدار 1.3.4 من Fragment: عند استخدام FragmentContainerView على الإصدار 29 من واجهة برمجة التطبيقات، لن يتم إرسال الحواف الداخلية إلى أجل غير مسمى، ما يؤدي إلى حل المشاكل المتعلقة بمثيلَي BottomNavigationBar وFloatingActionButton. (I1bb78، b/186012452)
• بدءًا من الإصدار 1.3.4 من Fragment: يمكنك الآن استرداد العنصر Parcelable من حزمة نتائج الجزء بعد إيقاف العملية نهائيًا. (I65932، b/187443158)
• من Fragment 1.3.4: عند إجراء انتقال عنصر مشترك على ViewGroup، إذا تم ضبط transitionGroup على القيمة false في ViewGroup، سيتم الآن الانتقال بشكل صحيح. (I99675)

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

• شكرًا simonschiller على تنفيذ Closeable في FragmentScenario. (#121، b/143774122)
• نشكر simonschiller على إضافة واجهة برمجة التطبيقات FragmentStrictMode بأكملها إلى هذا الإصدار. (#123 و#131 و#150 وb/143774122 و#142 وb/153738653 و#141 وb/153738235 و#146 وb/181137036 و#140 وb/153737954 و#136 وb/153738974 و#139 وb/153737745)
• شكرًا tatocaster على إضافة UseGetLayoutInflater Lint check. (#156، b/170781346)
• شكرًا tatocaster على إضافة DialogFragmentCallbacksDetector Lint check. (#171، b/181780047)

الإصدار 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.6: أصبحت الأجزاء تعتمد الآن على النشاط 1.2.4 (I3a66c)

الإصدار 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)

إصلاحات أخطاء في "مدير الحالة" الجديد

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

إصلاحات أخطاء في "مدير الحالة" الجديد

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

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

• يعتمد الجزء الآن على 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)

إصلاحات أخطاء في "مدير الحالة" الجديد

• تم إصلاح تسرب الذاكرة في الأجزاء بسبب mFocusedView (Ib4e9e، b/179925887)
• تستدعي الآن الأجزاء onCreateOptionsMenu بشكل صحيح عند استخدام معاملات العرض/الإخفاء (I8bce8، b/180255554)
• ستصل الآن الأجزاء الفرعية التي تتضمّن انتقالات تبدأ قبل عرض الجزء بشكل صحيح إلى RESUMED (Ic11e6، b/180825150).
• ستصل الآن الأجزاء التي تم تضخيمها باستخدام العلامة <fragment> دائمًا إلى RESUMED (I452ac، (I9fa49)

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

• يعتمد الإصدار 1.3.1 من Fragment على Activity 1.2.1. (I557b9)

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

إصلاحات أخطاء في "مدير الحالة" الجديد

• تعالج الآن طريقة العرض Lifecycle الخاصة بالفئة Fragment بشكل صحيح الحالات التي يتم فيها إتلاف طريقة العرض الخاصة بالفئة Fragment قبل أن يصل 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)

إصلاحات أخطاء في "مدير الحالة" الجديد

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

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

• يمكن الآن استخدام عناصر FragmentContainerView التي لا تضخّم جزءًا باستخدام السمة class أو android:name خارج FragmentActivity. (Id4397، b/172266337)
• سيؤدي الآن محاولة ضبط الحدّ الأقصى لمراحل نشاط جزء على DESTROYED إلى طرح الخطأ IllegalArgumentException (Ie7651، b/170765622).
• سيؤدي الآن إعداد FragmentScenario باستخدام الحالة DESTROYED إلى عرض IllegalArgumentException (I73590، b/170765622).

إصلاحات أخطاء في "مدير الحالة" الجديد

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

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

• ترقية androidx لاستخدام الإصدار 1.4 من Kotlin (Id6471 وb/165307851 وb/165300826)

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

• تمت إتاحة ملفات موارد الأجزاء بشكل خاص بشكلٍ صحيح. (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)

إصلاحات أخطاء في "مدير الحالة" الجديد

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

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

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

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

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

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

• تمت إضافة إمكانية استخدام ViewTreeViewModelStoreOwner من Lifecycle 2.3.0-alpha03 وViewTreeSavedStateRegistryOwner من SavedState 1.1.0-alpha01 عند استخدام View ضِمن Fragment. (aosp/1297993 وaosp/1300264)

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

• تتطلّب واجهتا برمجة التطبيقات 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 هذه التعديلات.

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

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

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

• تم إيقاف واجهات برمجة التطبيقات الخاصة بالجزء المستهدَف نهائيًا. لنقل البيانات بين الأجزاء، يجب استخدام واجهات برمجة التطبيقات الجديدة لنتائج الأجزاء بدلاً من ذلك. (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: تم تعديل قواعد ProGuard الخاصة بـ Fragment للسماح بتشفير الأجزاء المحفوظة. (b/151605338)
• من Fragment 1.2.4: تم إيقاف قاعدة FragmentLiveDataObserve Lint في فئات DialogFragment لأنّ دورة حياتها ودورة حياة العرض متزامنتان دائمًا، ما يجعل من الآمن استخدام this أو viewLifecycleOwner عند استدعاء observe. (b/151765086)

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

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

الإصدار 1.3.0-alpha02

‫18 مارس 2020

تم طرح ميزات androidx.fragment:fragment:1.3.0-alpha02 وandroidx.fragment:fragment-ktx:1.3.0-alpha02 وandroidx.fragment:fragment-testing:1.3.0-alpha02. يتضمّن الإصدار 1.3.0-alpha02 هذه التعديلات.

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

• تمت إضافة إمكانية استخدام واجهة برمجة التطبيقات ActivityResultRegistry التي تم طرحها في الإصدار 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)
• من تجزئة 1.2.3: تم تقليل نطاق قواعد ProGuard المضمّنة في التجزئة لضمان إمكانية إزالة فئات التجزئة غير المستخدَمة. (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() في "التقسيمات" نهائيًا. مع تقديم ViewModels، أصبح لدى المطوّرين واجهة برمجة تطبيقات محدّدة للاحتفاظ بالحالة التي يمكن ربطها بأنشطة وFragments ورسوم بيانية للتنقّل. يتيح ذلك للمطوّرين استخدام 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)
• لم يعُد يعرض الخطأ UnsupportedOperationException عند استخدام معاينة التصميم في "استوديو Android".FragmentContainerView (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.1 الآن على Lifecycle ViewModel SavedState 2.2.0.

الإصدار 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.
• عملية دمج Lifecycle ViewModel SavedState: أصبح 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، ما يتطلّب منك إضافة قاعدة الاحتفاظ يدويًا لكل فئة من الرموز. (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> بشكلٍ سليم حتى عندما تكون في التصميم أحيانًا فقط (أي في التصميم الأفقي فقط). نتيجةً لذلك، يتم الآن نقل هذه الفئات 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 على Lifecycle 2.2.0-rc03 وLifecycle ViewModel SavedState 1.0.0-rc03 وActivity 1.1.0-rc03.

الإصدار ‎1.2.0-rc02

‫7 نوفمبر 2019

تم طرح ميزات androidx.fragment:fragment:1.2.0-rc02 وandroidx.fragment:fragment-ktx:1.2.0-rc02 وandroidx.fragment:fragment-testing:1.2.0-rc02. يتضمّن الإصدار 1.2.0-rc02 هذه التعديلات.

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

• عند استخدام لغة Kotlin، تستخدم أداة 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 الآن الجزء الذي تحدّده class أو android:name كجزء من التضخّم، ما يضمن عمل findFragmentById() وfindFragmentByTag() مباشرةً بعد ذلك. (b/142520327)
• تم إصلاح IllegalStateException في FragmentContainerView بسبب حفظ الحالة. (b/142580713)
• تم إصلاح UnsupportedOperationException في FragmentContainerView عندما يكون صف FragmentContainerView مشوّشًا. (b/142657034)

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

• لا يحتفظ ProGuard تلقائيًا بالرموز التي تتم الإشارة إليها فقط من خلال السمة class أو android:name في FragmentContainerView، ما يتطلّب منك إضافة قاعدة الاحتفاظ يدويًا لكل فئة من الرموز. لقد أوقفنا قاعدة Lint التي تقترح الانتقال إلى FragmentContainerView إلى أن يتم حلّ هذه المشكلة من خلال aapt2. (b/142601969)

الإصدار ‎1.2.0-beta02

‫11 أكتوبر 2019

تم طرح ميزات androidx.fragment:fragment:1.2.0-beta02 وandroidx.fragment:fragment-ktx:1.2.0-beta02 وandroidx.fragment:fragment-testing:1.2.0-beta02. يتضمّن الإصدار 1.2.0-beta02 هذه التعديلات.

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

• تم إصلاح مشكلة عدم تلقّي 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 إمكانية إضافة جزء أولي مع إتاحة استخدام السمتَين android:name وandroid:tag الاختيارية في ملف XML. على عكس العلامة <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)
• عند استخدام Transition 1.3.0-beta01، تلغي الآن الفئات androidx.transition عمليات الانتقال بشكل صحيح قبل بدء عمليات انتقال أو رسوم متحركة جديدة على الحاوية نفسها. (aosp/1119841)
• تم إصلاح مشكلة في الإصدار 17 من واجهة برمجة التطبيقات والإصدارات الأقدم عند استخدام عمليات الانتقال androidx.transition في العرض الجذر لـ Fragment عند استخدام FragmentContainerView. (b/140361893)
• تعتمد حزمة fragment-testing الآن على حزمة AndroidX Test 1.2.0، ما يحلّ مشكلة عدم التوافق مع أحدث إصدار من Espresso 3.2.0. (b/139100149)
• تمت إزالة استخدام Log.w في FragmentManager. (aosp/1126468)

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

• لا تتلقّى onInflate() الخاصة بالجزء سمات مناسبة من 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 غير الفارغة التي تمت إضافة الجزء إليها (يمكنك استخدام 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() أو غير ذلك.

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

• من الجزء 1.1.0-rc04: تلغي الأجزاء الآن بشكل صحيح عمليات الانتقال المؤجّلة عند إغلاقها. (b/138251858)
• من Fragment 1.1.0-rc03: تم إصلاح مشكلة عدم إلغاء المهلات السابقة عند استدعاء postponeEnterTransition() مع مهلة أكثر من مرة. (b/137797118)
• من الجزء 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) لـ Fragments المضمّنة مضمّنة بشكلٍ صحيح. (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() عند استبدال Fragment مستهدَف حالي بـ Fragment لم يتم ربطه بعد بـ 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 ليشمل طريقة 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.

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

• تمت توسيع نطاق التعليقات التوضيحية الخاصة بإمكانية قبول القيم الفارغة بشكل كبير على مستوى واجهة برمجة التطبيقات Fragment.

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

• إصلاح مشكلة كانت تؤدي إلى تعذُّر تنفيذ عمليات Fragment من داخل LiveData (b/77944637)

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

• لا يمكن الوصول إلى Target Fragments بعد إزالة Fragment من FragmentManager.
• يعتمد fragment-testing على androidx.test:core:1.0.0-beta01 بدلاً من androidx.test:core:1.0.0 الصحيح.