ترقيم الصفحات

تسهّل عليك مكتبة Paging Library تحميل البيانات تدريجيًا وبسلاسة ضمن RecyclerView في تطبيقك.

يسرد هذا الجدول جميع العناصر في مجموعة "androidx.paging".

العناصر الإصدار المستقر إصدار محتمل الإصدار التجريبي الإصدار الأولي
paging-* 3.5.3 - - 3.6.0-alpha01
paging-compose 3.5.3 - - 3.6.0-alpha01
تاريخ آخر تعديل لهذه المكتبة: 18 نوفمبر 2026

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

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

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

Groovy

dependencies {
  def paging_version = "3.5.3"

  implementation "androidx.paging:paging-runtime:$paging_version"

  // alternatively - without Android dependencies for tests
  testImplementation "androidx.paging:paging-common:$paging_version"

  // optional - RxJava2 support
  implementation "androidx.paging:paging-rxjava2:$paging_version"

  // optional - RxJava3 support
  implementation "androidx.paging:paging-rxjava3:$paging_version"

  // optional - Guava ListenableFuture support
  implementation "androidx.paging:paging-guava:$paging_version"

  // optional - Jetpack Compose integration
  implementation "androidx.paging:paging-compose:3.5.3"
}

Kotlin

dependencies {
  val paging_version = "3.5.3"

  implementation("androidx.paging:paging-runtime:$paging_version")

  // alternatively - without Android dependencies for tests
  testImplementation("androidx.paging:paging-common:$paging_version")

  // optional - RxJava2 support
  implementation("androidx.paging:paging-rxjava2:$paging_version")

  // optional - RxJava3 support
  implementation("androidx.paging:paging-rxjava3:$paging_version")

  // optional - Guava ListenableFuture support
  implementation("androidx.paging:paging-guava:$paging_version")

  // optional - Jetpack Compose integration
  implementation("androidx.paging:paging-compose:3.5.3")
}

للحصول على معلومات حول استخدام إضافات Kotlin، يُرجى الاطّلاع على مستندات ktx.

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

الملاحظات

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

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

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

الإصدار 3.6

الإصدار ‎3.6.0-alpha01

‫18 نوفمبر 2026

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

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

  • تمت إضافة ItemSnapshotList إضافة لـ Lazy foundations. يمكنك الآن استدعاء ItemSnapshotList#itemKey وItemSnapshotList#itemContentType لإنشاء itemKey وcontentType تلقائيًا لـ Lazy foundation. (I73455، b/560754841)

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

  • شكرًا لك يا كمال على إضافة الإضافات ItemSnapshotList.

الإصدار 3.5

الإصدار 3.5.3

‫12 أكتوبر 2026

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

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

  • لن يعرض ItemSnapshotListFlow الخطأ IllegalArgumentException بعد الآن عندما يصل RemoteMediator إلى نهاية التقسيم إلى صفحات في أي من الاتجاهين ويتم تحويل الرأس أو التذييل إلى فاصل نهائي. (I821c7، b/566336825)
  • عندما تتجاوز الصفحات التي تم تحميلها PagingConfig.maxSize، لن تنخفض الصفحات التي تم تحميلها إلى أقل من صفحتَين لضمان ملء إطار العرض بالبيانات بشكل صحيح. (I037a0، b/565835910)

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

نشكر إيغور على إرسال إصلاح الخطأ b/565835910

الإصدار 3.5.2

‫7 أكتوبر 2026

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

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

  • لن تؤدي طلبات Pager.append() قبل اكتمال عملية إعادة التحميل الأولية إلى ظهور الخطأ NoSuchElementException. لن يتم تنفيذ طلب الإضافة. (Ide387، b/556780796)

الإصدار 3.5.1

‫12 أغسطس 2026

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

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

  • تم إصلاح مشكلة تقديم PagingSource.getRefreshKey لـ anchorPosition غير صحيح كبير جدًا عند إعادة تحميل صفحة تحتوي على فواصل أثناء الانتقال إلى العناصر النائبة. (I475f0، b/516565503)

الإصدار 3.5.0

‫6 مايو 2026

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

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

  • تمت إضافة عامل التشغيل Flow<PagingData>.asItemSnapshotListFlow لتحويل Flow<PagingData> إلى Flow<ItemSnapshotList>. يعني ذلك أنّه يمكن الآن الوصول إلى البيانات المحمَّلة خارج طبقة واجهة المستخدم، ما يتيح لك دمج Flow<ItemSnapshotList> مع مصادر بيانات أخرى، وتخزين البيانات المُقسَّمة إلى صفحات مؤقتًا وتعديلها على الجهاز، أو عرض البيانات المُقسَّمة إلى صفحات كجزء من حالة واجهة المستخدم، وغير ذلك.

  • تمت إضافة دالتي الإضافة Pager.append وPager.prepend لتحميل المزيد من البيانات يدويًا بدون الانتقال للأسفل.

  • تمت إضافة دالّتَي الإضافة Pager.refresh وPaging.retry للتعافي من أخطاء التحميل عند استخدام واجهة برمجة التطبيقات asItemSnapshotListFlow.

الإصدار 3.5.0-rc01

‫22 أبريل 2026

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

لا تغييرات

  • ما مِن تغييرات ملحوظة مقارنةً بالإصدار 3.5.0-beta01.

الإصدار ‎3.5.0-beta01

‫8 أبريل 2026

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

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

  • تمت إعادة تسمية واجهة برمجة التطبيقات Flow<PagingData>.asState إلى Flow<PagingData>.asItemSnapshotListFlow (I0dc11، b/496548025)

الإصدار 3.5.0-alpha01

‫11 مارس 2026

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

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

  • يحتوي العنصر paging-common الآن على عامل تشغيل تدفق asState جديد على Flow<PagingData> لتحويله إلى Flow<ItemSnapshotList>. يتيح ذلك إمكانات مثل:

    • دمج بيانات Flow of ItemSnapshotList مع مصادر بيانات أخرى
    • مشاركة المسار مع عدة جامعي بيانات بدون cachedIn
    • تخزين بيانات الصفحات مؤقتًا على الجهاز
    • تعديل البيانات المقسّمة إلى صفحات في الذاكرة
    • عرض البيانات المقسّمة إلى صفحات كجزء من حالة واجهة المستخدم
    // In your ViewModel
    val pager = Pager(pagingConfig, pagingSourceFactory)
    val pagerFlow = pager.flow.asState()
    
    // alterantively convert the flow to a SharedFlow
    val pagerFlow = pager.flow.asState().stateIn()
    
    // In presenter layer
    val snapshotFlow = viewModel.pagerFlow.collectAsStateWithLifecycle(initialList)
    val snapshot = itemsFlow.value
    
    LazyColumn {
    items(items = snapshot.items) { ... }
    }
    
  • أضافت أداة paging-common أيضًا واجهتَي برمجة التطبيقات Pager.append وPager.prepend لتشغيل عمليات التحميل يدويًا في أي من طرفَي العناصر المحمَّلة.

    • عند استخدامها مع paging-runtime أو paging-compose، توفّر بديلاً لتحميل المزيد من البيانات إلى جانب الانتقال للأسفل
    • عند استخدام هذه السمة مع واجهة برمجة التطبيقات الجديدة asState، تكون الطريقة الوحيدة لتحميل المزيد من البيانات
    LazyColumn {
    item {
           /**
           * Load more items when users scroll near the top of loaded items.
           */
           LaunchedEffect(viewModel) { viewModel.prepend() }
        }
    items(snapshot.items) { item -> Text("Item: $item") }
    item {
            /**
            * Load more items when users scroll near the bottom of loaded items.
            */
          LaunchedEffect(viewModel) { viewModel.append() }
      }
    }
    
  • تمت إضافة Pager.refresh وPager.retry للتعافي من أخطاء التحميل عند استخدام واجهة برمجة التطبيقات asState. يمكنك الاطّلاع على هذا المستند لمزيد من نماذج استخدام واجهات برمجة التطبيقات الجديدة. (I1e1e9، If3c87، Idbd48، Id1e1d، I816fe)

الإصدار 3.4

الإصدار 3.4.2

‫11 مارس 2026

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

لا تغييرات

  • لا يتضمّن هذا الإصدار أي تغيير في واجهة برمجة التطبيقات أو السلوك مقارنةً بالإصدار 3.4.1.

الإصدار 3.4.1

‫11 فبراير 2026

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

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

  • تم تحديث اعتمادية guava في paging-guava من الإصدار 31.1 إلى 32.0.1.

الإصدار 3.4.0

‫28 يناير 2026

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

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

  • تمّت إضافة المزيد من أهداف KMP إلى paging-common وpaging-testing وpaging-compose. أصبحت جميعها متوافقة مع JVM (Android وDesktop)، وNative (Linux وiOS وwatchOS وtvOS وmacOS وMinGW)، والويب (JavaScript وWasmJS)
  • تمت إزالة إمكانية استخدام macosX64 وiosX64 وwatchosX64 وtvosX64 في paging-common وpaging-testing وpaging-compose للتوافق مع إيقاف Jetbrains لأهداف macosX64 نهائيًا.
  • تمت إضافة واجهة برمجة تطبيقات PagingState جديدة closestItemAroundPosition لاسترداد العنصر الذي تم تحميله والأقرب إلى الموضع المستهدَف ويتطابق مع دالة الإدخال. يمكن استخدام هذه السمة لإنشاء مفاتيح إعادة تحميل مستندة إلى العناصر عندما يكون العنصر المثالي القابل للتثبيت قريبًا من موضع الاستهداف الدقيق ولكن ليس فيه.

الإصدار 3.4.0-rc01

‫14 يناير 2026

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

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

الإصدار ‎3.4.0-beta01

‫17 ديسمبر 2025

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

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

  • إصلاح مشكلة السباق بين عمليات تحميل RecyclerView وRefresh التي تؤدي إلى IndexOutOfBoundsException في RecyclerView يمكن أن تؤدي تحديثات واجهة المستخدم التي تمت مقاطعتها بسبب عمليات تحميل Refresh المستمرة إلى إلغاء مزامنة حالة "تقسيم الصفحات" مع RecyclerView. ويمكن حلّ هذه المشكلة من خلال إعادة ضبط ميزة "تقسيم المحتوى إلى صفحات" على حالتها السابقة قبل إعادة التحميل في حال مقاطعة عملية إعادة التحميل (أي من خلال تحميل Refresh متتالي). (I771b0، b/409809768)

الإصدار 3.4.0-alpha04

‫10 سبتمبر 2025

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

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

  • تمت إضافة واجهة برمجة تطبيقات PagingState جديدة closestItemAroundPosition لاسترداد العنصر الذي تم تحميله والأقرب إلى الموضع المستهدَف ويتطابق مع دالة الإدخال. يمكن استخدام هذه السمة لإنشاء مفاتيح إعادة تحميل مستندة إلى العناصر عندما يكون العنصر المثالي القابل للتثبيت قريبًا من موضع الاستهداف الدقيق ولكن ليس فيه. (I96e5c، b/440187139)

الإصدار 3.4.0-alpha03

‫27 أغسطس 2025

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

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

  • تمّت إضافة أجهزة الكمبيوتر المكتبي كهدف جديد من Kotlin Multiplatform (KMP) في Paging-common. يتوافق الآن مع JVM (Android وDesktop)، وNative (Linux وiOS وwatchOS وtvOS وmacOS وMinGW)، والويب (JavaScript وWasmJS). (Id2483، b/436884811)
  • تمّت إضافة أهداف جديدة من Kotlin Multiplatform (KMP) إلى اختبارات Paging. يتوافق الآن مع JVM (Android وDesktop)، وNative (Linux وiOS وwatchOS وtvOS وmacOS وMinGW)، والويب (JavaScript وWasmJS). (I0c543، b/435014650)
  • تمّت إضافة أهداف جديدة من Kotlin Multiplatform (KMP) إلى Paging-compose. يتوافق الآن مع JVM (Android وDesktop)، وNative (Linux وiOS وwatchOS وtvOS وmacOS وMinGW)، والويب (JavaScript وWasmJS). (I70d44، b/436884801)

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

  • نقل الحد الأدنى التلقائي لإصدار حزمة تطوير البرامج (SDK) من المستوى 21 إلى المستوى 23 (Ibdfca وb/380448311 وb/435705964 وb/435705223)

الإصدار ‎3.4.0-alpha02

‫30 يوليو 2025

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

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

  • تسمح سياسة PagingData.from الآن بضبط placeholdersBefore وplaceholdersAfter. يُرجى العِلم أنّ التنقّل بين هذه العناصر النائبة لا يؤدي إلى تحميلها. (I06983)

الإصدار 3.4.0-alpha01

‫2 يوليو 2025

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

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

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

  • لن تظهر أخطاء من PagingLogger في اختبارات Android Unit التي تستخدم الإصدار 3.3 من Paging أو الإصدارات الأحدث (Ia9400، b/331684448)
  • تم إصلاح الخطأ الذي تسبَّب في ظهور رسالة الخطأ IndexOutOfBoundsException في RecyclerView عندما ينتقل المستخدم للأعلى أو للأسفل أثناء تحديث RecyclerView (Id1f16، b/381024738)
  • تم إصلاح خلل كان يمنع التنقّل بين الصفحات من تحميل المزيد من المحتوى عند إعادة التحميل أثناء التمرير. (I60ca5، b/352586078)
  • تم إصلاح مشكلة تعطُّل التطبيق عند التمرير أثناء إعادة تحميل عناصر Paging. (I8c65a، b/347649763)

الإصدار 3.3

الإصدار 3.3.6

‫12 فبراير 2025

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

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

  • سيتم الآن تخزين إشارات إعادة التحميل وإعادة المحاولة التي يتم إرسالها أثناء عملية إعادة التحميل الأولية وإعادة إرسالها تلقائيًا عندما يصبح مقدّم العرض Paging جاهزًا.

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

  • نشكر إيفا على إرسال إصلاح الخطأ (#754)

الإصدار 3.3.5

‫11 ديسمبر 2024

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

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

  • تم إصلاح الخطأ الذي تسبَّب في ظهور رسالة الخطأ IndexOutOfBoundsException في RecyclerView عندما يتصفّح المستخدم أثناء تحديث RecyclerView. (Id1f16، b/381024738)

الإصدار 3.3.4

‫13 نوفمبر 2024

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

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

  • لن تظهر رسالة الخطأ Method isLoggable in android.util.Log not mocked بعد الآن في اختبارات وحدات Android التي تستخدم الإصدار 3.3 من Paging أو الإصدارات الأحدث. (Ia9400، b/331684448)

الإصدار 3.3.2

‫7 أغسطس 2024

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

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

  • تمّت إضافة أهداف جديدة من Kotlin-Multiplatform إلى paging-common وpaging-testing: watchos وtvos وlinuxArm64 (90c9768)، (53e0eca)

الإصدار 3.3.1

‫24 يوليو 2024

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

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

  • تم إصلاح مشكلة عدم قدرة AsyncPagingDataDiffer أو واجهات برمجة التطبيقات المستندة إليها، مثل PagingDataAdapter المستخدَمة مع RecyclerView، على بدء المزيد من عمليات التحميل عند إعادة تحميل مصدر البيانات الاحتياطي أثناء الانتقال للأعلى أو للأسفل. (I60ca5، b/352586078)
  • تم إصلاح عطل يحدث عند إزالة عناصر من مصدر البيانات الاحتياطي أثناء الانتقال في RecyclerView باستخدام PagingDataAdapter أو AsyncPagingDataDiffer. (I8c65a، b/347649763)

الإصدار 3.3.0

‫14 مايو 2024

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

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

  • أصبح الصف "PagingDataPresenter" الآن صفًا عامًا. يمكن الآن إنشاء مقدِّمي عروض متعدّدي المنصات على PagingDataPresenter بدلاً من طلب واجهات برمجة تطبيقات Paging داخلية أو AsyncPagingDataDiffer من paging-runtime.
  • تمت إضافة طريقتَي المساعدة الجديدتَين LoadStates وCombinedLoadStates في hasError وisIdle للتحقّق مما إذا كانت LoadStates في حالة خطأ أو حالة NotLoading على التوالي. تمت أيضًا إضافة طريقة جديدة لإضافة awaitNotLoading() Kotlin على Flow<CombinedLoadStates> تنتظر حتى يتم تحميل الإعلان إما في الحالة NotLoading أو في حالة الخطأ.
  • يرسل PagingData.empty() الآن حالات NotLoading تلقائيًا ما لم يتم تمرير LoadStates مخصّصة إلى الدالة الإنشائية. يختلف هذا عن السلوك الحالي الذي لا يرسل فيه LoadStates عند إرساله إلى PagingDataAdapter أو يرسل حالات التحميل عند جمعه كـ LazyPagingItems. عند جمعها كـ LazyPagingItems، ستعرض الآن أيضًا قائمة فارغة فورًا عند الإنشاء الأولي.

التوافق مع Kotlin Multiplatform

توفّر مكتبة Paging الآن عناصر متوافقة مع Kotlin Multiplatform، ويرجع الفضل في ذلك إلى حد كبير إلى العمل الذي تم إجراؤه في مشروع multiplatform-paging من CashApp.

  • نقلت paging-common جميع واجهات برمجة التطبيقات في Paging 3 إلى common، وأصبحت الآن متوافقة مع jvm وiOS بالإضافة إلى Android.
  • تم نقل رمز paging-testing إلى common، وأصبح متوافقًا الآن مع jvm وiOS بالإضافة إلى Android.
  • تم نقل رمز paging-compose إلى common، ويتم شحن عنصر Android يتوافق مع ميزة "التوافق مع الأنظمة الأساسية المتعددة" في androidx.compose.
  • ستبقى أجهزة paging-runtime وpaging-guava وpaging-rxjava2 وpaging-rxjava3 تعمل بنظام التشغيل Android فقط.

الإصدار 3.3.0-rc01

‫1 مايو 2024

تم إصدار androidx.paging:paging-*:3.3.0-rc01 بدون أي تغييرات في الإصدار التجريبي 3.3.0-beta01 من Paging. يتضمّن الإصدار 3.3.0-rc01 هذه التعديلات.

الإصدار ‎3.3.0-beta01

‫3 أبريل 2024

تم إصدار androidx.paging:paging-*:3.3.0-beta01 بدون أي تغييرات ملحوظة. يتضمّن الإصدار 3.3.0-beta01 هذه التعديلات.

الإصدار 3.3.0-alpha05

‫20 مارس 2024

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

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

  • تستخدم ميزة "تقسيم النتائج إلى صفحات" الآن التعليق التوضيحي @MainThread من AndroidX Annotation للرموز الشائعة. (I78f0d، b/327682438)

الإصدار ‎3.3.0-alpha04

‫6 آذار (مارس) 2024

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

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

  • تم إصلاح أخطاء بسيطة في المستندات تتعلّق بإضافة ميزة التوافق مع Kotlin Multiplatform. (aosp/2950785)

الإصدار 3.3.0-alpha03

‫7 فبراير 2024

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

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

  • أصبح الصف "PagingDataPresenter" الآن صفًا عامًا. يمكن الآن إنشاء مقدّمي عروض متعدّدي المنصات على PagingDataPresenter بدلاً من طلب واجهات برمجة تطبيقات Paging داخلية أو AsyncPagingDataDiffer من paging-runtime. (Id1f74، b/315214786)
  • تمت إضافة طريقتَي المساعدة الجديدتَين LoadStates وCombinedLoadStates للتحقّق مما إذا كان LoadStates في حالة خطأ أو في حالة NotLoading. تمت أيضًا إضافة واجهة برمجة تطبيقات جديدة تنتظر على LoadStateFlow حتى يتم تحميل البيانات في الحالة NotLoading أو حالة الخطأ. (Id6c67)

تغيير السلوك

  • يرسل PagingData.empty() الآن حالات NotLoading تلقائيًا ما لم يتم تمرير LoadStates مخصّصة إلى الدالة الإنشائية. يختلف هذا عن السلوك الحالي الذي لا يرسل فيه LoadStates عند إرساله إلى PagingDataAdapter أو يرسل حالات التحميل عند جمعه كـ LazyPagingItems. عند جمعها كـ LazyPagingItems، ستعرض الآن أيضًا قائمة فارغة فورًا عند الإنشاء الأولي. (I4d11d، b/301833847)

الإصدار ‎3.3.0-alpha02

‫20 سبتمبر 2023

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

التوافق مع Kotlin Multiplatform

توفّر مكتبة Paging الآن عناصر متوافقة مع Kotlin Multiplatform، ويرجع الفضل في ذلك إلى حد كبير إلى العمل الذي تم إجراؤه في مشروع multiplatform-paging من CashApp. سيسمح لنا ذلك بتجنب الاختلاف بين مستودعين والحفاظ على توافقهما.

  • نقلت paging-common جميع واجهات برمجة التطبيقات في Paging 3 إلى common، وأصبحت الآن متوافقة مع jvm وiOS بالإضافة إلى Android.
  • تم نقل رمز paging-testing إلى common، وأصبح متوافقًا الآن مع jvm وiOS بالإضافة إلى Android.
  • تم نقل رمز paging-compose إلى common، ويتم شحن عنصر Android يتوافق مع ميزة "التوافق مع الأنظمة الأساسية المتعددة" في androidx.compose.
  • ستبقى أجهزة paging-runtime وpaging-guava وpaging-rxjava2 وpaging-rxjava3 تعمل بنظام التشغيل Android فقط.

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

  • تم إيقاف واجهة Logger العامة التي كانت مخصّصة للاستخدام الداخلي فقط (I16e95، b/288623117)

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

الإصدار 3.3.0-alpha01

‫20 سبتمبر 2023

  • هذا هو الإصدار الأول المتوافق مع أنظمة أساسية متعددة من مكتبات androidx.paging. يحتوي هذا الإصدار على عناصر *-jvm و*-android فقط. بالنسبة إلى إصدارات macOS وiOS وLinux، استخدِم 3.3.0-alpha02.

الإصدار 3.2

الإصدار 3.2.1

‫6 سبتمبر 2023

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

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

  • تم إصلاح مشكلة توقُّف واجهة برمجة التطبيقات asSnapshot() في عنصر اختبار التقسيم إلى صفحات عند تمرير Flow تم إنشاؤه باستخدام PagingData.from(List) لأنّ asSnapshot() لن تتوفّر لديها أي معلومات عن وقت انتهاء التحميل (على عكس التحميل الزائد في PagingData.from(List, LoadStates)). لا يعمل هذا الحلّ البديل إلا مع Flows التي يمكن إكمالها (مثل flowOf(PagingData.from(...))). بالنسبة إلى Flows التي لا يمكن إكمالها (مثل MutableStateFlow)، استخدِم التحميل الزائد PagingData.from الذي يوفّر LoadStates. (I502c3)
  • تستخدم ميزة "تقسيم الصفحات" في Compose الآن AndroidUiDispatcher.Main داخليًا لضمان توفّر البيانات الجديدة في الإطار نفسه عند اكتمال التحميل. (Ia55af)

الإصدار 3.2.0

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

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

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

  • وصلت واجهة برمجة التطبيقات Paging Compose إلى مرحلة الاستقرار وتم دمجها مرة أخرى في بقية واجهات Paging، حيث يتطابق إصدارها الآن مع جميع عناصر Paging الأخرى. تشمل التغييرات منذ الإصدار 3.1.0 ما يلي:
    • يمكنك معاينة قائمة بالبيانات الزائفة من خلال إنشاء PagingData.from(fakeData) وتضمين PagingData في MutableStateFlow (مثلاً، MutableStateFlow(PagingData.from(listOf(1, 2, 3)))). مرِّر هذا التدفق إلى الدوال المركّبة @Preview كمستلِم لـ collectAsLazyPagingItems() من أجل المعاينة.
    • دعم جميع التنسيقات الكسولة، مثل LazyVerticalGrid وHorizontalPager، بالإضافة إلى المكوّنات الكسولة المخصّصة من مكتبات Wear وTV تم تحقيق ذلك من خلال طرق الإضافة الجديدة ذات المستوى الأدنى LazyPagingItems وitemKey وitemContentType، والتي تساعدك في تنفيذ المَعلمتَين key وcontentType في واجهات برمجة التطبيقات العادية items المتوفّرة حاليًا لـ LazyColumn وLazyVerticalGrid بالإضافة إلى ما يعادلها في واجهات برمجة التطبيقات مثل HorizontalPager.
    • تم إيقاف items(lazyPagingItems) وitemsIndexed(lazyPagingItems) نهائيًا، وهما يتوافقان مع LazyListScope فقط.
  • تمت إضافة عنصر paging-testing جديد يوفّر واجهات برمجة تطبيقات مصمّمة لاختبار وحدة كل طبقة من تطبيقك ودمجها مع ميزة "تقسيم الصفحات" بشكل منفصل. على سبيل المثال، يشمل ذلك
    • فئة TestPager التي تتيح لك التحقّق من سلوك عملية تنفيذ PagingSource المخصّصة بشكل مستقل عن التنقّل بين الصفحات وواجهة المستخدم الحقيقية.
    • ​​واجهات برمجة تطبيقات asPagingSourceFactory لتحويل Flow<List<Value>> أو List<Value> ثابت إلى PagingSourceFactory يمكن تمريره إلى "التنقّل بين الصفحات" في الاختبارات
    • إضافة Kotlin‏ asSnapshot في Flow<PagingData<Value>>، والتي تترجم Flow<PagingData<Value>> إلى List<Value> مباشرةً. تتيح لك واجهة asSnapshot lambda محاكاة واجهة المستخدم لتطبيقك من خلال واجهات برمجة التطبيقات، مثل scrollTo أو appendScrollWhile، لتتمكّن من التحقّق من صحة لقطة البيانات في أي نقطة في مجموعة البيانات المقسّمة إلى صفحات.
  • تمت إضافة سجلّات تلقائية لعرض معلومات تصحيح أخطاء Paging في مستويَين: VERBOSE وDEBUG. يمكن تفعيل السجلّات من خلال الأمر adb shell setprop log.tag.Paging [DEBUG|VERBOSE]. وينطبق ذلك على كل من "تقسيم الصفحات باستخدام طرق العرض" أو "تقسيم الصفحات باستخدام Compose".
  • تمت إضافة دوال إنشائية لـ PagingDataAdapter وAsyncPagingDataDiffer تقبل CoroutineContext بدلاً من CoroutineDispatcher.
  • تمت إضافة واجهة وظيفية جديدة PagingSourceFactory توفّر واجهة برمجة تطبيقات أكثر وضوحًا من دوال lambda السابقة () -> PagingSource. يمكن استخدام هذه الفئة لإنشاء مثيل من Pager.

الإصدار 3.2.0-rc01

‫21 حزيران (يونيو) 2023

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

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

  • نشكر Veyndan على مساهمته في نقل Paging بعيدًا عن تفاصيل Android/JVM. (#553 و#554 و#555 و#559)

الإصدار ‎3.2.0-beta01

‫7 يونيو 2023

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

Paging Compose

  • وصلت مكتبة Paging Compose رسميًا إلى مرحلة استقرار واجهة برمجة التطبيقات. لذلك، تم تعديل الإصدار من 1.0.0-alpha20 ليتطابق الآن مع إصدار جميع عناصر Paging الأخرى.

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

  • تمت إزالة واجهتَي برمجة التطبيقات items(LazyPagingItems) وitemsIndexed(LazyPagingItems) المتوقفتَين نهائيًا من Paging Compose. راجِع ملاحظات إصدار Paging Compose 1.0.0-alpha20 للاطّلاع على مثال على واجهات برمجة التطبيقات البديلة. (I9626e)

الإصدار 3.2.0-alpha06

‫24 مايو 2023

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

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

  • تمت إضافة واجهة وظيفية جديدة PagingSourceFactory توفّر سطح واجهة برمجة تطبيقات أكثر وضوحًا من دوال lambda الحالية () -> PagingSource. يمكن استخدام هذه الفئة لإنشاء مثيل Pager. (I33165، b/280655188)
  • تمت إضافة واجهة برمجة تطبيقات جديدة paging-testing من List<Value>.asPagingSourceFactory() للحصول على PagingSourceFactory يتم تحميله فقط من قائمة بيانات غير قابلة للتغيير. يجب مواصلة استخدام الإضافة الحالية على Flow<List<Value>> للاختبار مع أجيال متعددة من البيانات الثابتة. (Id34d1، b/280655188)

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

  • تم الآن إضافة تعليقات توضيحية إلى جميع واجهات برمجة التطبيقات العامة في paging-testing باستخدام @VisibleForTesting لضمان استخدام واجهات برمجة التطبيقات هذه في الاختبارات فقط. (I7db6e)
  • لم تعُد واجهة برمجة التطبيقات asSnapshot تتطلّب تمرير CoroutineScope. ويتم الآن تلقائيًا استخدام السياق المكتسَب من النطاق الرئيسي. (Id0a78، b/282240990)
  • تمت إعادة ترتيب مَعلمات الدالة الإنشائية TestPager لتتطابق بشكل بديهي مع ترتيب مَعلمات الدالة الإنشائية Pager الحقيقية (I6185a)
  • تم نقل استخدام paging-testing لنوع lambda‏ () -> PagingSource<Key, Value> إلى النوع PagingSourceFactory<Key, Value>. (I4a950، b/280655188)

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

  • لم يعُد المُرسِل الرئيسي مطلوبًا لتشغيل اختبارات asSnapshot Paging. ولن يؤدي ضبطه إلى إجراء أي تغييرات على سلوك الاختبار. (Ie56ea)

الإصدار 3.2.0-alpha05

‫3 مايو 2023

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

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

  • تستخدم واجهة Paging Testing API في asSnapshot الآن مَعلمة loadOperations كدالة lambda فارغة تلقائيًا. يتيح ذلك استدعاء asSnapshot بدون تمرير أي عمليات تحميل لاسترداد البيانات من عملية تحميل إعادة التحميل الأولية. (Ied354، b/277233770)

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

  • تم تعديل المستندات المتعلّقة بـ asPagingSourceFactory() لتوضيح أنّها طريقة إضافة في Flow تعرض مصنعًا قابلاً لإعادة الاستخدام لإنشاء نُسخ من PagingSource. (I5ff4f، I705b5)
  • تم تعديل المستندات المتعلّقة بدالة الإنشاء LoadResult.Page لتوضيح الحاجة إلى إلغاء itemsBefore وitemsAfter لإتاحة ميزة التخطّي. (Ied354)

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

الإصدار ‎3.2.0-alpha04

‫8 فبراير 2023

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

اختبار المناداة

  • يحتوي العنصر paging-testing الآن على طريقة asPagingSourceFactory لإنشاء pagingSourceFactory من Flow<List<Value>> ليتم توفيره إلى Pager. يمثّل كل List<Value>> يتم إصداره من Flow جيلًا من البيانات المُقسَّمة إلى صفحات. يسهّل ذلك إجراء اختبارات التنقّل بين الصفحات، على سبيل المثال، في عمليات تحويل PagingData من خلال تزييف مصدر بيانات ليجمع منه "التنقّل بين الصفحات". (I6f230، b/235528239)
  • تم توسيع نطاق العنصر paging-testing باستخدام واجهات برمجة تطبيقات جديدة مناسبة للتحقّق من صحة البيانات الواردة في Flow<PagingData<T>>. يمكن استخدام ذلك، على سبيل المثال، لتأكيد ناتج Flow<PagingData<T>> من طبقة ViewModel.

    ويتم ذلك من خلال إضافة asSnapshot Kotlin على Flow<PagingData<Value>>، والتي تترجم Flow<PagingData<Value>> إلى List<Value> مباشرةً. تتيح لك دالة lambda‏ asSnapshot محاكاة واجهة المستخدم في تطبيقك من خلال واجهات برمجة التطبيقات، مثل scrollTo أو appendScrollWhile، بطريقة قابلة للتكرار ومتسقة حتى تتمكّن من التحقّق من صحة لقطة البيانات في أي نقطة في مجموعة البيانات المقسّمة إلى صفحات.

    // Create your ViewModel instance
    val viewModel = …
    // Get the Flow of PagingData from the ViewModel
    val data< Flow<PagingData<String>> = viewModel.data
    val snapshot: List<String> = data.asSnapshot {
      // Each operation inside the lambda waits for the data to settle before continuing
      scrollTo(index = 50)
    
      // While you can’t view the items within the asSnapshot call,
      // you can continuously scroll in a direction while some condition is true
      // i.e., in this case until you hit a placeholder item
      appendScrollWhile {  item: String -> item != “Header 1” }
    }
    // With the asSnapshot complete, you can now verify that the snapshot
    // has the expected values
    

    ‫asSnapshot هي طريقة suspend من المتوقّع تشغيلها ضمن runTest. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة اختبار الكوروتينات في Kotlin على Android. (I55fd2، I5bd26، I7ce34، I51f4d، I2249f، Id6223، Ic4bab، Ib29b9، Ic1238، I96def، b/235528239)

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

  • تم الآن وضع علامة على طلبات واجهة المستخدم إلى getItem وpeek في AsyncPagingDataDiffer وPagingDataAdapter بشكل صحيح على أنّها قابلة للطلب فقط في سلسلة التعليمات الرئيسية. (I699b6)
  • تمت إزالة أحرف البدل من الأنواع العامة التي تستخدمها TestPager، ما يسهّل استخدام نتائج هذه الطرق في الرموز البرمجية المكتوبة بلغة Java. (I56c42)

الإصدار ‎3.2.0-alpha03

‫24 أكتوبر 2022

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

اختبار المناداة

يتضمّن هذا الإصدار عنصرًا جديدًا: paging-testing. يوفّر هذا العنصر واجهات برمجة تطبيقات مصمّمة لاختبار الوحدة لكل طبقة من تطبيقك ودمجها مع ميزة "تقسيم الصفحات" بشكل منفصل.

على سبيل المثال، يتضمّن هذا الإصدار الأول فئة TestPager تتيح لك التحقّق من سلوك تنفيذ PagingSource المخصّص بشكل مستقل عن Pager وواجهة المستخدم الحقيقية التي تحتاج إليها عادةً لمحاكاة عملية دمج Paging الشاملة.

يجب اعتبار TestPager مزيّفًا، أي نسخة اختبارية تعكس التنفيذ الحقيقي لـ Pager مع توفير واجهة برمجة تطبيقات مبسّطة لاختبار PagingSource. واجهات برمجة التطبيقات هذه هي واجهات suspend ويجب تشغيلها ضمن runTest كما هو موضّح في دليل اختبار الكوروتينات في Kotlin على Android.

يمكن العثور على مثال على واجهات برمجة التطبيقات هذه قيد الاستخدام في اختبارات room-paging التي تمت إعادة تصميمها لاستخدام TestPager.

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

  • تتيح هذه السياسة التكرار السهل على LoadResult.Page.data من خلال LoadResult.Page.iterator(). يتيح ذلك بشكل غير مباشر استخدام طريقة مكتبة Kotlin العادية flatten عند توفّر List<LoadResult.Page>، مثل سمة pages في PagingState التي يتم تمريرها إلى طريقة PagingSource.getRefreshKey. (Ie0718)

الإصدار 3.2.0-alpha02

‫10 أغسطس 2022

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

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

  • توفّر مكتبة Paging الآن سجلّات من خلال فئتَي AsyncPagingDataDiffer أو PagingDataAdapter لعرض معلومات تصحيح الأخطاء التي تم جمعها من PagingData.
  • يمكن تفعيل السجلّات من خلال الأمر adb shell adb shell setprop log.tag.Paging [DEBUG|VERBOSE].(b/235527159)

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

  • تم إصلاح خطأ عدم توفّر دالة الإنشاء PagingDataDiffer عند استخدام paging-common:3.2.0-alpha01 مع بيئة التشغيل paging-runtime:3.1.1 أو الإصدارات الأقدم.(b/235256201)

الإصدار ‎3.2.0-alpha01

‫1 حزيران (يونيو) 2022

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

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

  • تمت إضافة دوال إنشائية لـ PagingDataAdapter وAsyncPagingDataDiffer تقبل CoroutineContext بدلاً من CoroutineDispatcher. (Idc878)
  • بشكل تلقائي، لن يؤثر PagingData.from() وPagingData.empty() في CombinedLoadStates من جانب مقدّم العرض. تمت إضافة تحميل زائد جديد يسمح بتمرير sourceLoadStates وremoteLoadStates إلى هذه الدوال الإنشائية للحفاظ على السلوك الحالي المتمثل في ضبط LoadStates ليكون نهائيًا بالكامل (أي NotLoading(endOfPaginationReached = false))، مع خيار تضمين الولايات البعيدة أيضًا إذا لزم الأمر. في حال عدم تمرير LoadStates، سيتم الاحتفاظ بـ CombinedLoadStates السابقة في جانب المقدّم عند تلقّي PagingData الثابتة. (Ic3ce5، b/205344028)

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

  • يتم الآن إعطاء الأولوية لنتيجة PagingSource.getRefreshKey() بشكل صحيح على initialKey في الحالات التي تعرض فيها قيمة فارغة، ولكن تم ضبط قيمة initialKey غير فارغة. (Ic9542، b/230391606)

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

  • تم تعديل واجهة برمجة التطبيقات ‎ :compose:ui:ui-test (updateApi) بسبب نقل البيانات من test-coroutines-lib (I3366d)

الإصدار 3.1

الإصدار 3.1.1

9 آذار (مارس) 2022

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

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

  • تمت إزالة أحداث LoadState.NotLoading المتوسطة بين الأجيال التي تم إدراجها بشكل غير صحيح من قِبل .cachedIn(). يسهّل هذا التغيير التفاعل مع تغييرات LoadState من خلال إزالة أحداث LoadState.NotLoading المتكررة التي تم إنشاؤها بين إعادة محاولة عمليات التحميل التي تعذّر إجراؤها، أو عند إعادة التحميل أو أثناء الإبطال.

الإصدار 3.1.0

17 تشرين الثاني (نوفمبر) 2021

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

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

  • واجهتا برمجة التطبيقات Flow<PagingData>.observable وFlow<PagingData>.flowable لم تعودا تجريبيتين
  • التغييرات في سلوك LoadState:
    • أصبح "endOfPaginationReached" دائمًا "false" لـ "LoadType.REFRESH" لكل من "PagingSource" و"RemoteMediator"
    • تنتظر الآن LoadStates من Paging قيمًا صالحة من كل من PagingSource وRemoteMediator قبل إرسالها إلى المراحل اللاحقة. ستبدأ الآن الأجيال الجديدة من PagingData دائمًا بشكل صحيح باستخدام Loading لحالة إعادة التحميل بدلاً من إعادة الضبط على NotLoading بشكل غير صحيح في بعض الحالات.
    • لم يعُد .loadStateFlow و.addLoadStateListener في واجهات برمجة التطبيقات الخاصة بمقدِّمي العروض يرسلان بشكل متكرر CombinedLoadStates أوليًا يتم فيه دائمًا ضبط حالات الوسيط على null
  • يتم الآن إلغاء الأجيال السابقة بشكل فوري عند الإبطال أو إنشاء أجيال جديدة. من المفترض ألا يكون استخدام .collectLatest على Flow<PagingData> مطلوبًا بعد الآن، ولكن لا يزال من المستحسن القيام بذلك.
  • تمت إضافة PagingSource.LoadResult.Invalid كنوع جديد للقيمة التي تم إرجاعها من PagingSource.load، ما يؤدي إلى تجاهل Paging لأي طلبات تحميل معلّقة أو مستقبلية إلى PagingSource وإبطالها. تم تصميم نوع القيمة التي تم إرجاعها هذا للتعامل مع البيانات التي يُحتمل أن تكون غير صالحة أو قديمة والتي يمكن إرجاعها من قاعدة البيانات أو الشبكة.
  • تمت إضافة واجهتَي برمجة التطبيقات .onPagesPresented و.addOnPagesUpdatedListener للعرض، واللتين يتم تشغيلهما بشكل متزامن أثناء عرض الصفحات في واجهة المستخدم. يمكن أن تحدث تعديلات على الصفحة في الحالات التالية:
    • اكتمال التحميل الأولي لجيل جديد من PagingData، بغض النظر عمّا إذا كان الجيل الجديد يحتوي على أي تغييرات على العناصر المعروضة، أي: سيؤدي إنشاء جيل جديد يكمل التحميل الأولي بدون أي تعديلات لأنّ القائمة هي نفسها تمامًا إلى تفعيل هذه الدالة المرتجعة.
    • يتم إدراج صفحة، حتى إذا لم تكن الصفحة المدرَجة تحتوي على أي عناصر جديدة.
    • يتم إسقاط صفحة، حتى إذا كانت الصفحة التي تم إسقاطها فارغة.

الإصدار 3.1.0-rc01

‫3 نوفمبر 2021

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

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

  • تم إصلاح حالة السباق وتسريب الذاكرة في ‎ .cachedIn()‎ في الحالات التي يتم فيها إرسال أحداث تحميل متعددة من خلال Paging downstream في حال عدم وجود مراقبين أو بين وقت تبديل المراقب إلى PagingData جديد. (Ib682e)

الإصدار ‎3.1.0-beta01

‫13 أكتوبر 2021

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

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

  • تم إصلاح مشكلة كانت تؤدي إلى تجاهل العديد من العناصر التي يتم الوصول إليها بسرعة في prefetchDistance، ما يؤدي إلى توقُّف تحميل الصفحة. وتظهر هذه المشكلة بشكل خاص عندما يتم وضع العديد من العناصر في وقت واحد بترتيب يعطي الأولوية للتحميل في اتجاه معاكس لاتجاه تمرير المستخدم. يتم الآن تخزين عمليات الوصول إلى هذه العناصر مؤقتًا وتحديد أولوياتها بشكل متزامن لمنع إسقاطها. (aosp/1833273)

الإصدار 3.1.0-alpha04

‫29 سبتمبر 2021

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

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

  • لم تعُد واجهتا برمجة التطبيقات Flow<PagingData>.observable وFlow<PagingData>.flowable تجريبيتين. (Ie0bdd)

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

  • بالنسبة إلى LoadStates، أصبحت قيمة endOfPaginationReached دائمًا false لـ LoadType.REFRESH. في السابق، كان من الممكن أن تكون قيمة endOfPaginationReached هي true لـ RemoteMediator REFRESH، ولكن ليس لـ PagingSource. تم دمج هذا السلوك الآن ليعرض دائمًا false لأنّه من غير المنطقي أن يكون REFRESH نهائيًا، وتم توثيقه الآن كجزء من عقد واجهة برمجة التطبيقات في LoadStates. عند تحديد ما إذا كان سيتم إنهاء التقسيم إلى صفحات، يجب دائمًا إجراء ذلك في ما يتعلق باتجاهات APPEND أو PREPEND. (I047b6)
  • تنتظر LoadStates من Paging الآن القيم الصالحة من كل من PagingSource وRemoteMediator قبل إرسالها إلى المراحل اللاحقة بين الأجيال. يمنع هذا التعديل الأجيال الجديدة من PagingData من إرسال NotLoading في CombinedLoadStates.source.refresh إذا كانت في حالة Loading. ستبدأ الأجيال الجديدة من PagingData الآن دائمًا بشكل صحيح بحالة Loading لإعادة التحميل بدلاً من إعادة الضبط أولاً إلى NotLoading بشكل غير صحيح في بعض الحالات.

    Cancellation on past generations now happen eagerly on invalidation / new generations. من المفترض ألا يكون استخدام ‎ .collectLatest مطلوبًا بعد الآن في Flow<PagingData>، على الرغم من أنّه لا يزال يُنصح بشدة باستخدامه. (I0b2b5، b/177351336، b/195028524)

  • لم يعُد .loadStateFlow و.addLoadStateListener في واجهات برمجة التطبيقات الخاصة بمقدِّم العرض يرسلان بشكل متكرر CombinedLoadStates أوليًا يحتوي دائمًا على حالات وسيط تم ضبطها على null وحالات مصدر تم ضبطها على NotLoading(endOfPaginationReached = false). ويعني هذا أنّ:

    1. سيتم دائمًا ملء حالات الوسيط إذا كنت تستخدم RemoteMediator.
    2. لن يؤدي تسجيل مستمع loadState جديد أو جامع جديد على .loadStateFlow إلى إصدار القيمة الحالية على الفور إذا لم يتلقَّ CombinedLoadStates حقيقيًا من PagingData. يمكن أن يحدث ذلك إذا بدأ جامع أو مستمع قبل إرسال PagingData. (I1a748)

الإصدار ‎3.1.0-alpha03

‫21 يوليو 2021

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

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

  • تمت إضافة نوع ثالث من LoadResult وهو LoadResult.Invalid إلى PagingSource. عندما تعرض دالة PagingSource.load القيمة LoadResult.Invalid، سيتجاهل Paging البيانات التي تم تحميلها ويُبطل PagingSource. تم تصميم نوع القيمة التي تم إرجاعها هذا للتعامل مع البيانات التي يُحتمل أن تكون غير صالحة أو قديمة والتي يمكن إرجاعها من قاعدة البيانات أو الشبكة.

    على سبيل المثال، إذا تمّت الكتابة في قاعدة البيانات الأساسية ولكن لم يتم إلغاء صلاحية PagingSource في الوقت المناسب، قد يعرض نتائج غير متّسقة إذا كان تنفيذه يعتمد على عدم قابلية تغيير مجموعة البيانات الاحتياطية التي يتم تحميله منها (مثل عمليات تنفيذ قاعدة البيانات بأسلوب LIMIT OFFSET). في هذا السيناريو، يُنصح بالتحقّق من الإبطال بعد التحميل وعرض LoadResult.Invalid، ما يؤدي إلى تجاهل Paging لأي طلبات تحميل معلّقة أو مستقبلية إلى PagingSource وإبطالها.

    يتوافق نوع القيمة التي تم إرجاعها أيضًا مع واجهة برمجة التطبيقات Paging2 التي تستفيد من LivePagedList أو RxPagedList. عند استخدام PagingSource مع واجهات برمجة تطبيقات PagedList في Paging2، يتم فصل PagedList على الفور، ما يؤدي إلى إيقاف المحاولات الإضافية لتحميل البيانات على PagedList هذه وإبطال PagingSource.

    ‫LoadResult هي فئة مغلقة، ما يعني أنّ هذا التغيير غير متوافق مع المصدر، وبالتالي فإنّ حالات الاستخدام التي تستخدم نتائج PagingSource.load مباشرةً ستضطر إلى التعامل مع LoadResult.Invalid في وقت التجميع. على سبيل المثال، على مستخدمي Kotlin الذين يستفيدون من exhaustive-when للتحقّق من نوع القيمة التي تم إرجاعها إضافة عملية تحقّق من النوع غير الصالح. (Id6bd3، b/191806126، b/192013267)

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

  • يتم الآن تلقائيًا تفعيل عمليات الاستدعاء للإبطال التي تمت إضافتها من خلال PagingSource.registerInvalidatedCallback أو DataSource.addInvalidatedCallback في حال تسجيلها على PagingSource / DataSource غير صالح بالفعل. يؤدي ذلك إلى حلّ مشكلة حالة السباق التي تسبّبت في تجاهل Paging لإشارات الإبطال وتوقّفها عند توفير مصدر غير صالح أثناء التحميل الأوّلي. بالإضافة إلى ذلك، تتم الآن إزالة عمليات الاستدعاء غير الصالحة بشكل صحيح بعد تشغيلها لأنّه من المضمون استدعاؤها مرة واحدة على الأكثر. (I27e69)
  • لن يؤدي إرسال القيمة الأولية للعنصر النائب (InitialPagedList) من مصدر PagedList تم إنشاء مثيل له حديثًا، مثل LivePagedListBuilder أو RxPagedListBuilder، إلى محو البيانات التي تم تحميلها سابقًا.

الإصدار ‎3.1.0-alpha02

‫1 يوليو 2021

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

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

  • تمت إضافة واجهات برمجة التطبيقات onPagesPresented listener وflow presenter التي يتم تشغيلها فورًا بعد تعديل الصفحات المعروضة في واجهة المستخدم.

    بما أنّ هذه التعديلات متزامنة مع واجهة المستخدم، يمكنك استدعاء طرق المحوّل مثل ‎ .snapshot و‎.getItemCount لفحص الحالة بعد تطبيق التعديل. يُرجى العِلم أنّه تم ترك .snapshot() ليتم استدعاؤه بشكل صريح لأنّه قد يكون مكلفًا في كل تحديث.

    يمكن أن تحدث تعديلات على الصفحة في السيناريوهات التالية:

    • عند اكتمال التحميل الأولي لجيل جديد من PagingData، بغض النظر عما إذا كان الجيل الجديد يحتوي على أي تغييرات على العناصر المعروضة، أي سيظل الجيل الجديد الذي يكمل التحميل الأولي بدون تحديثات لأن القائمة هي نفسها تمامًا يؤدي إلى تشغيل رد الاتصال هذا.
    • يتم إدراج صفحة، حتى إذا كانت الصفحة المدرَجة لا تحتوي على عناصر جديدة
    • يتم إسقاط صفحة، حتى إذا كانت الصفحة التي تم إسقاطها فارغة (I272c9، b/189999634)

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

  • لن يؤدي الوصول إلى PagedList.dataSource من القيمة الأولية التي تم إنتاجها بواسطة LivePagedList أو RxPagedList إلى ظهور IllegalStateException بشكل غير صحيح (I96707)

الإصدار ‎3.1.0-alpha01

‫2 يونيو 2021

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

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

  • أصبحت الصفوف التي يوفّرها paging-rxjava3 الآن ضمن حزمة androidx.paging.rxjava3 لكي لا تتعارض مع paging-rxjava2 (Ifa7f6)

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

  • تم إصلاح مشكلة كانت تؤدي أحيانًا إلى إرسال أحداث no-op differ إلى RecyclerView، ما قد يؤدي إلى تفعيل بعض المستمعين مبكرًا. (Ic507f، b/182510751)

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

  • تمت إضافة واجهات برمجة التطبيقات المتوافقة مع PagedList التي تم إيقافها نهائيًا إلى عنصر rxjava3 ‏(Id1ce2، b/182497591)

الإصدار 1.0.0 من Paging Compose

الإصدار ‎1.0.0-alpha20

‫24 مايو 2023

تم طرح androidx.paging:paging-compose:1.0.0-alpha20. يتضمّن الإصدار 1.0.0-alpha20 هذه التعديلات.

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

  • تتيح ميزة Paging Compose الآن معاينة قائمة بالبيانات الزائفة من خلال إنشاء PagingData.from(fakeData) وتضمين PagingData في MutableStateFlow (مثلاً، MutableStateFlow(PagingData.from(listOf(1, 2, 3)))). باستخدام هذه البيانات كإدخال في @Preview، ستوفّر الطلبات إلى collectAsLazyPagingItems() LazyPagingItems قابلة للمعاينة. (I8a78d، b/194544557)

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

  • ستتوفّر الآن البيانات المخزّنة مؤقتًا من pager.flow.cachedIn والتي تم جمعها في LazyPagingItems فورًا بعد استعادة الحالة بدون الحاجة إلى جمعها بشكل غير متزامن. وهذا يعني أنّ البيانات المخزّنة مؤقتًا ستكون جاهزة للعرض فورًا عند الإنشاء الأولي بعد استعادة الحالة. (I97a60، b/177245496)

الإصدار ‎1.0.0-alpha19

‫3 مايو 2023

تم طرح androidx.paging:paging-compose:1.0.0-alpha19. يتضمّن الإصدار 1.0.0-alpha19 هذه التعديلات.

دعم جميع التنسيقات الكسولة

في السابق، كانت مكتبة Paging Compose توفّر إضافات items وitemsIndexed مخصّصة على LazyListScope، ما يعني أنّه لم يكن بإمكانك استخدام Paging Compose مع تنسيقات التحميل الكسول الأخرى، مثل LazyVerticalGrid أو HorizontalPager أو مكوّنات التحميل الكسول المخصّصة الأخرى التي توفّرها مكتبات Wear وTV. Addressing this inflexibility is the primary update for this release.

لإتاحة المزيد من التنسيقات الكسولة، كان علينا إنشاء واجهات برمجة تطبيقات في طبقة مختلفة، فبدلاً من توفير واجهة برمجة تطبيقات items مخصّصة لكل تنسيق كسول، توفّر Paging Compose الآن طرق إضافة ذات مستوى أقل قليلاً على LazyPagingItems في itemKey وitemContentType. تركّز واجهات برمجة التطبيقات هذه على مساعدتك في تنفيذ المَعلمتَين key وcontentType في واجهات برمجة التطبيقات العادية items المتوفّرة حاليًا لـ LazyColumn وLazyVerticalGrid، بالإضافة إلى ما يعادلها في واجهات برمجة التطبيقات مثل HorizontalPager. (Ifa13b، Ib04f0، b/259385813)

هذا يعني أنّ دعم LazyVerticalGrid سيظهر على النحو التالي:

// This part is unchanged
val lazyPagingItems = pager.collectAsLazyPagingItems()

LazyVerticalGrid(columns = GridCells.Fixed(2)) {
  // Here we use the standard items API
  items(
    count = lazyPagingItems.itemCount,
    // Here we use the new itemKey extension on LazyPagingItems to
    // handle placeholders automatically, ensuring you only need to provide
    // keys for real items
    key = lazyPagingItems.itemKey { it.uniqueId },
    // Similarly, itemContentType lets you set a custom content type for each item
    contentType = lazyPagingItems.itemContentType { "contentType" }
  ) { index ->
    // As the standard items call provides only the index, we get the item
    // directly from our lazyPagingItems
    val item = lazyPagingItems[index]
    PagingItem(item = item)
  }
}

لمزيد من الأمثلة على استخدام واجهات برمجة التطبيقات الجديدة هذه، يُرجى الاطّلاع على النماذج.

على الرغم من أنّ هذه التغييرات تجعل أمثلة LazyColumn وLazyRow أطول ببضعة أسطر، رأينا أنّ الاتساق في جميع التنسيقات الكسولة كان عاملاً مهمًا لمستخدمي Paging Compose في المستقبل. لهذا السبب، تم إيقاف الإضافات الحالية إلى LazyListScope نهائيًا. (I0c459، I92c8f، b/276989796)

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

  • لتسهيل عملية نقل البيانات إلى واجهات برمجة التطبيقات الجديدة، تتيح الآن دالتا الإضافة items وitemsIndexed في LazyListScope استخدام المَعلمة contentType، ما يعكس إمكانية استخدامها في واجهات برمجة التطبيقات الجديدة. (Ib1918، b/255283378)

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

  • عدَّلت مكتبة Paging Compose تبعيتها من الإصدار 1.0.5 من Compose إلى الإصدار 1.2.1 من Compose. (Ib1918، b/255283378)

الإصدار ‎1.0.0-alpha18

‫8 فبراير 2023

تم إصدار androidx.paging:paging-compose:1.0.0-alpha18 بدون أي تغييرات. يتضمّن الإصدار 1.0.0-alpha18 هذه التعديلات.

الإصدار ‎1.0.0-alpha17

‫24 أكتوبر 2022

تم طرح androidx.paging:paging-compose:1.0.0-alpha17. يتضمّن الإصدار 1.0.0-alpha17 هذه التعديلات.

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

  • أضِف إمكانية استخدام CoroutineContext مخصّص عند طلب collectLazyPagingItems. (I7a574، b/243182795، b/233783862)

الإصدار ‎1.0.0-alpha16

‫10 أغسطس 2022

تم طرح androidx.paging:paging-compose:1.0.0-alpha16. يتضمّن الإصدار 1.0.0-alpha16 هذه التعديلات.

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

  • توفّر مكتبة Paging الآن سجلّات من خلال فئة LazyPagingItems لعرض معلومات تصحيح الأخطاء التي تم جمعها من PagingData.
  • يمكن تفعيل السجلّات من خلال الأمر adb shell setprop log.tag.Paging [DEBUG|VERBOSE] في adb shell. ([b/235527159}(https://issuetracker.google.com/issues/235527159))

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

  • تم إصلاح خطأ عدم توفّر دالة الإنشاء PagingDataDiffer عند استخدام paging-compose:1.0.0-alpha15 مع الإصدار paging-common:3.1.1 أو إصدار أقدم.(b/235256201، b/239868768)

الإصدار ‎1.0.0-alpha15

‫1 حزيران (يونيو) 2022

تم طرح androidx.paging:paging-compose:1.0.0-alpha15. يتضمّن الإصدار 1.0.0-alpha15 هذه التعديلات.

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

  • تمت إضافة دوال إنشائية لـ PagingDataAdapter وAsyncPagingDataDiffer تقبل CoroutineContext بدلاً من CoroutineDispatcher. (Idc878)

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

  • يضبط LazyPagingItems الآن loadState الأولي ليتم تحديثه كل LoadState.Loading. (I55043، b/224855902)

الإصدار ‎1.0.0-alpha14

‫13 أكتوبر 2021

تم طرح androidx.paging:paging-compose:1.0.0-alpha14. يتضمّن الإصدار 1.0.0-alpha14 هذه التعديلات.

الإصدار ‎1.0.0-alpha13

‫29 سبتمبر 2021

تم طرح androidx.paging:paging-compose:1.0.0-alpha13. يتضمّن الإصدار 1.0.0-alpha13 هذه التعديلات.

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

  • تم استبدال الدالة LazyPagingItems.snapshot() بالسمة LazyPagingItems.itemSnapshotList (Ie2da8)
  • تمت إزالة LazyPagingItems.getAsState() المتوقفة نهائيًا (Ie65e4)

الإصدار ‎1.0.0-alpha12

‫21 يوليو 2021

تم طرح androidx.paging:paging-compose:1.0.0-alpha12. يتضمّن الإصدار 1.0.0-alpha12 هذه التعديلات.

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

  • أصبح بإمكان items(lazyPagingItems) وitemsIndexed(lazyPagingItems)، اللذين يُستخدمان لربط Paging بـ LazyColumn/Row، قبول مَعلمة مفتاح الخيار التي تتيح لك تحديد مفتاح ثابت يمثّل العنصر. يمكنك الاطّلاع على مزيد من المعلومات حول المفاتيح هنا. (I7986d)
  • تم إيقاف الدالة lazyPagingItems.getAsState(index) نهائيًا. يمكنك استخدام lazyPagingItems[index] كبديل. (I086cb، b/187339372)

الإصدار ‎1.0.0-alpha11

‫30 يونيو 2021

تم طرح androidx.paging:paging-compose:1.0.0-alpha11. يتضمّن الإصدار 1.0.0-alpha11 هذه التعديلات.

الإصدار ‎1.0.0-alpha10

‫2 يونيو 2021

تم طرح androidx.paging:paging-compose:1.0.0-alpha10. يتضمّن الإصدار 1.0.0-alpha10 هذه التعديلات.

الإصدار ‎1.0.0-alpha09

‫18 مايو 2021

تم طرح androidx.paging:paging-compose:1.0.0-alpha09. يتضمّن الإصدار 1.0.0-alpha09 هذه التعديلات.

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

  • أصبح من الممكن الآن تتبُّع itemCount وitem getter في LazyPagingItems، ما يسمح باستخدامهما مع LazyVerticalGrid أيضًا (Ie2446 وb/171872064 وb/168285687)

توافق Compose

  • لا يتوافق androidx.paging:paging-compose:1.0.0-alpha09 إلا مع الإصدار 1.0.0-beta07 من Compose والإصدارات الأحدث.

الإصدار ‎1.0.0-alpha08

‫24 فبراير 2021

تم طرح androidx.paging:paging-compose:1.0.0-alpha08. يتضمّن الإصدار 1.0.0-alpha08 هذه التعديلات.

تم تعديل هذا الإصدار ليتكامل مع الإصدار 1.0.0-beta01 من Compose.

الإصدار ‎1.0.0-alpha07

‫10 فبراير 2021

تم طرح androidx.paging:paging-compose:1.0.0-alpha07. يتضمّن الإصدار 1.0.0-alpha07 هذه التعديلات.

تم تعديلها لتتكامل مع الإصدار alpha12 من Compose.

الإصدار ‎1.0.0-alpha06

‫28 يناير 2021

تم طرح androidx.paging:paging-compose:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.

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

تم تعديل الإصدار ليعتمد على Compose 1.0.0-alpha11.

الإصدار ‎1.0.0-alpha05

‫13 يناير 2021

تم طرح androidx.paging:paging-compose:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.

تم تعديل الإصدار ليعتمد على Compose 1.0.0-alpha10.

الإصدار ‎1.0.0-alpha04

‫16 ديسمبر 2020

تم طرح androidx.paging:paging-compose:1.0.0-alpha04. يتضمّن الإصدار 1.0.0-alpha04 هذه التعديلات.

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

  • تم تعديل سمات الراحة، CombinedLoadStates.refresh وCombinedLoadStates.prepend وCombinedLoadStates.append للانتقال فقط من Loading إلى NotLoading بعد أن تصبح حالات تحميل الوسيط والمصدر NotLoading لضمان تطبيق التعديل عن بُعد. (I65619)

الإصدار ‎1.0.0-alpha03

‫2 ديسمبر 2020

تم طرح androidx.paging:paging-compose:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.

  • تم تعديلها لتتوافق مع الإصدار 1.0.0-alpha08 من Compose.

الإصدار ‎1.0.0-alpha02

11 تشرين الثاني (نوفمبر)، 2020

تم طرح androidx.paging:paging-compose:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.

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

  • تمت إضافة الطرق .peek() و.snapshot() و.retry() و.refresh() إلى LazyPagingItems التي تعرض الوظائف نفسها المتاحة في AsyncPagingDataDiffer / PagingDataAdapter (Iddfe8، b/172041660)

الإصدار ‎1.0.0-alpha01

‫28 أكتوبر 2020

تم طرح androidx.paging:paging-compose:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.

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

توفّر عناصر paging-compose إمكانية الدمج بين مكتبة Paging وJetpack Compose. مثال بسيط على الاستخدام:

  @Composable
  @OptIn(ExperimentalLazyDsl::class)
  fun ItemsDemo(flow: Flow<PagingData<String>>) {
      val lazyPagingItems = flow.collectAsLazyPagingItems()
      LazyColumn {
          items(lazyPagingItems) {
              Text("Item is $it")
          }
      }
  }

الإصدار 3.0.1

الإصدار 3.0.1

‫21 يوليو 2021

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

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

  • لن يؤدي الوصول إلى PagedList.dataSource من القيمة الأولية التي تم إنشاؤها بواسطة LivePagedList أو RxPagedList إلى ظهور خطأ IllegalStateException بشكل غير صحيح (I96707)

الإصدار 3.0.0

الإصدار 3.0.0

‫5 مايو 2021

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

الميزات الرئيسية في الإصدار 3.0.0

تم إيقاف معظم واجهات برمجة التطبيقات الحالية من Paging 2.x.x نهائيًا لصالح واجهات برمجة التطبيقات الجديدة في Paging 3 لإجراء التحسينات التالية:

  • دعم من الدرجة الأولى لـ Kotlin coroutines وFlow
  • الدعم في حال الإلغاء
  • إشارات مدمجة لحالة التحميل والخطأ
  • وظيفة إعادة المحاولة وإعادة التحميل
  • تم دمج جميع الفئات الفرعية الثلاث لـ DataSource في فئة PagingSource موحّدة
  • تحويلات مخصّصة للصفحات، بما في ذلك تحويل مدمج لإضافة فاصل أسفل الإعلانات
  • رؤوس وتذييلات حالة التحميل

الإصدار 3.0.0-rc01

‫21 أبريل 2021

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

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

  • تم إصلاح مشكلة كانت تؤدي أحيانًا إلى إرسال أحداث no-op differ إلى RecyclerView، ما قد يؤدي إلى تفعيل بعض المستمعين مبكرًا. (Ic507f، b/182510751)

الإصدار ‎3.0.0-beta03

‫24 مارس 2021

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

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

  • لقد عدّلنا طريقة التعامل مع العناصر النائبة عند إعادة تحميل القائمة لمنع حدوث قفزات غير متوقعة في RecyclerView. يُرجى الاطّلاع على NullPaddedDiffing.md لمزيد من التفاصيل. (If1490، b/170027529، b/177338149)
  • لم تعُد أدوات إنشاء PagedList المختلفة (مسار التوافق القديم) تستدعي DataSource.Factory.create() بشكل غير صحيح على سلسلة التعليمات الرئيسية عند استدعاء .build(). (b/182798948)

الإصدار ‎3.0.0-beta02

10 آذار (مارس) 2021

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

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

  • تنشر إضافات Rx3 الآن متطلبات الموافقة على @ExperimentalCoroutinesApi بشكل صحيح. في السابق، تم وضع علامة عليها في طريقة @get التي يتجاهلها برنامج تجميع Kotlin بسبب: https://youtrack.jetbrains.com/issue/KT-45227 (I5733c)

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

  • فرض قيود على الاستخدام العام لواجهات برمجة التطبيقات التجريبية (I6aa29، b/174531520)
  • تم إصلاح خلل كان يؤدي إلى أن تكون قيمة PagingState دائمًا null عند استدعاء إعادة التحميل عن بُعد.
  • تم إصلاح خطأ حيث يمكن أن تمنع الصفحات الفارغة التي يعرضها PagingSource ميزة "تقسيم النتائج على صفحات" من الجلب مرة أخرى لتنفيذ prefetchDistance، ما يؤدي إلى "توقّف" ميزة "تقسيم النتائج على صفحات".

الإصدار ‎3.0.0-beta01

‫10 فبراير 2021

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

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

  • تعرض الآن برامج تضمين Rx2 وRx3 التعليقات التوضيحية التجريبية التي تعتمد عليها. إذا كنت تستخدم برامج تضمين Rx compat في paging-rxjava2 أو paging-rxjava3، ستحتاج الآن إلى إضافة تعليقات توضيحية على الاستخدامات باستخدام @OptIn(ExperimentalCoroutinesApi::class) (Ib1f9d)

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

  • تم إصلاح الخطأ IndexOutOfBoundsException: Inconsistency detected الذي يظهر أحيانًا عند استخدام واجهات برمجة تطبيقات الإصدار 2 من DataSource من خلال مسارات التوافق
  • يتم الآن تشغيل طلب isInvalid أثناء إعداد DataSource عند استخدامه من خلال مسارات التوافق بشكل صحيح على fetchDispatcher بدلاً من سلسلة التعليمات الرئيسية. يؤدي ذلك إلى إصلاح IllegalStateException بسبب الوصول إلى قاعدة البيانات في سلسلة التعليمات الرئيسية عند استخدام تنفيذ PagingSource في Room.

الإصدار 3.0.0‎-alpha13

‫27 يناير 2021

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

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

  • PagingSource.getRefreshKey is no longer optional to implement, it is now an abstract function without a default implementation. يمكن للمستخدمين الذين ينقلون البيانات إما مواصلة عرض التنفيذ التلقائي الذي يعرض ببساطة null، ولكن يجب أن يكون لدى getRefreshKey() تنفيذ حقيقي يعرض مفتاحًا استنادًا إلى موضع الانتقال الحالي للمستخدم والذي يسمح لـ "تقسيم الصفحات" بمواصلة التحميل في منتصف إطار العرض من خلال PagingState.anchorPosition إن أمكن. (I4339a)
  • أصبحت السمة InvalidatingPagingSourceFactory الآن فئة نهائية (Ia3b0a)
  • Allow configuration of terminal separator (header / footer) behavior with an additional optional SeparatorType parameter. الخياران هما:
    • ‫FULLY_COMPLETE: السلوك الحالي، وهو الانتظار حتى يضع كل من PagingSource وRemoteMediator علامة endOfPaginationReached قبل إضافة الفواصل النهائية. في حال عدم استخدام RemoteMediator، يتم تجاهل loadState عن بُعد. يكون ذلك مفيدًا بشكل أساسي إذا أردت عرض فواصل الأقسام فقط عندما يتم تحميل القسم بالكامل، بما في ذلك الجلب من مصدر عن بُعد، مثل الشبكة.
    • SOURCE_COMPLETE - الانتظار فقط حتى يضع PagingSource علامة endOfPaginationReached حتى في حال استخدام RemoteMediator يتيح ذلك عرض الرؤوس والتذييلات بشكل متزامن مع التحميل الأولي، ما يمنع المستخدمين من الحاجة إلى التمرير لرؤية الفواصل النهائية. (Ibe993، b/174700218)

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

  • تم إصلاح مشكلة نادرة في تسرّب الذاكرة تحدث عندما يتم إبطال PagingSource قبل أن يتمكّن PageFetcher من بدء التحميل منه. (I9606b، b/174625633)

الإصدار 3.0.0‎-alpha12

‫13 يناير 2021

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

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

  • لم تعُد InvalidatingPagingSourceFactory فئة مجرّدة لأنّها لم تتضمّن أي طرق مجرّدة. (I4a8c4)
  • تمت إضافة تحميل زائد لـ ‎ .cachedIn()‎ يقبل ViewModel بدلاً من Lifecycle أو CoroutineScope لمستخدمي Java. (I97d81، b/175332619)
  • السماح لمتصلين Java باستخدام عمليات تحويل PagingData بطريقة غير متزامنة، من خلال قبول Executor في وسيطات عامل التحويل. تمت إزالة اللاحقة ‎-Sync من جميع عوامل تشغيل التحويل ‎-Sync، وسيحتاج مستخدمو Kotlin Coroutine إلى إزالة الغموض من خلال استدعاء دالة الإضافة التي تقبل كتلة تعليق بدلاً من ذلك. تم نقل جميع عوامل تشغيل تحويل PagingData إلى الإضافات ضمن فئة PagingDataTransforms الثابتة. على مستخدمي Java استدعاؤها من خلال دوال مساعدة ثابتة، مثل: PagingDataTransforms.map(pagingData, transform) بالنسبة إلى مستخدمي Kotlin، تكون البنية هي نفسها ولكن يجب استيراد الدالة. (If6885، b/172895919)

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

  • تم إصلاح خطأ كان يمنع استدعاء RemoteMediator.load() أثناء adapter.refresh() إذا تم الوصول إلى نهاية التقسيم على صفحات.

الإصدار 3.0.0-alpha11

‫16 ديسمبر 2020

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

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

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

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

  • PagingSource.getRefreshKey() أصبحت الآن واجهة برمجة تطبيقات ثابتة (I22f6f، b/173530980)
  • لم تعُد دالة PagingSource.invalidate مفتوحة. إذا كنت بحاجة إلى تلقّي إشعار عند حدوث الإبطال، يمكنك استدعاء طريقة registerInvalidatedCallback بدلاً من إلغاء invalidate. (I628d9، b/173029013، b/137971356)
  • يحتوي Pager الآن على دالة إنشائية تجريبية واحدة إلى جانب الدوال الإنشائية العادية، بدلاً من تسريب واجهات برمجة التطبيقات التجريبية إلى واجهة برمجة التطبيقات العامة غير التجريبية من خلال التعليق التوضيحي للموافقة. (I9dc61، b/174531520)
  • تم تعديل سمات الراحة، CombinedLoadStates.refresh وCombinedLoadStates.prepend وCombinedLoadStates.append للانتقال فقط من Loading إلى NotLoading بعد أن تصبح حالات تحميل الوسيط والمصدر NotLoading لضمان تطبيق التعديل عن بُعد. (I65619)
  • تمت إزالة LoadParams.pageSize (كانت متوقفة نهائيًا). ننصحك باستخدام LoadParams.loadSize في PagingSource.

    تكون قيمة LoadParams.loadSize مساوية دائمًا لقيمة PagingConfig.pageSize، باستثناء طلب التحميل الأوّلي حيث تكون قيمتها مساوية لقيمة PagingConfig.initialLoadSize.

    إذا كنت تختبر Paging2 DataSource بدون استخدام Pager أو PagedList، قد لا يتطابق pageSize مع PagingConfig.pageSize إذا كنت تضبط أيضًا initialLoadSize. إذا كان ذلك مهمًا لاختباراتك، حاوِل استخدام Pager/PagedList بدلاً من ذلك، ما سيؤدي إلى ضبط PageSize الصحيح داخليًا لطُرق تحميل DataSource. (I98ac7، b/149157296)

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

  • تم إصلاح عطل ناتج عن IllegalStateException عند استخدام الفواصل مع ضبط PagingConfig.maxSize. (I0ed33، b/174787528)
  • تم إصلاح خطأ يتعلّق بعدم تحديث حالة التحميل لـ PREPEND / APPEND إلى NotLoading(endOfPaginationReached = true) فورًا بعد التحميل الأولي في حال ضبط RemoteMediator‏ (I8cf5a)
  • تم إصلاح خلل يؤدي إلى عرض واجهات برمجة التطبيقات من جهة العارض، مثل ‎.snapshot()‎ و‎.peek()‎ وما إلى ذلك، القائمة السابقة (القديمة) ضمن تعديلات ListUpdateCallback.
  • تم إصلاح خلل كان يؤدي إلى عدم إضافة عوامل تشغيل الفواصل لرؤوس أو تذييلات الصفحات عند استخدامها مع RemoteMediator
  • تم إصلاح خطأ يتعلّق بتعديلات LoadState إلى NotLoading لـ RemoteMediator، حيث كانت تتوقف في حالة Loading
  • تم إصلاح خلل في واجهة برمجة التطبيقات .asPagingSourceFactory() المتوافقة مع Paging2.0، حيث كان من الممكن أن تؤدي إلى بدء تشغيل DataSource في CoroutineDispatcher غير صحيح. يؤدي ذلك إلى حلّ مشكلة تعطُّل التطبيق وحالات ANR المحتملة، خاصةً عند استخدام عملية التنفيذ الحالية لـ PagingSource في Room، والتي تستخدم مسار التوافق هذا.

الإصدار 3.0.0-alpha10

‫2 ديسمبر 2020

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

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

  • تمت إزالة واجهتَي برمجة التطبيقات dataRefreshFlow وdataRefreshListener المتوقفتَين نهائيًا لأنّهما زائدتان عن الحاجة مع تحديثات loadStateFlow / Listener. بالنسبة إلى المستخدمين الذين ينقلون البيانات، فإنّ loadStateFlow المكافئ هو:

    loadStateFlow.distinctUntilChangedBy { it.refresh }
        .filter { it.refresh is NotLoading }
    

    (Ib5570، b/173530908)

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

  • يتم الآن نشر endOfPaginationReached لـ RemoteMediator REFRESH بشكل صحيح في تحديثات LoadState ويمنع تشغيل APPEND وPREPEND عن بُعد. (I94a3f، b/155290248)
  • لن يؤدي عرض قائمة فارغة بسبب صفحة أولية فارغة أو فلترة مكثفة إلى منع Paging من بدء عمليات تحميل PREPEND أو APPEND. (I3e702، b/168169730)
  • تم إصلاح مشكلة عدم استدعاء getRefreshKey في الأجيال اللاحقة من PagingSource عند حدوث عمليات إبطال بسرعة. (I45460، b/170027530)

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

  • تمت إضافة فئة مجردة جديدة باسم InvalidatingPagingSourceFactory مع واجهة برمجة تطبيقات .invalidate() التي تعيد توجيه الإبطال إلى جميع مصادر PagingSources التي تصدرها. شكرًا لـ ‎@claraf3. (Ie71fc، b/160716447)

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

  • قد لا تظهر الرؤوس والتذييلات من عملية التحويل ‎ .insertSeparators()‎ على الفور عند استخدام RemoteMediator b/172254056
  • قد يؤدي استخدام RemoteMediator إلى توقّف LoadState عن بُعد إذا اكتمل الإبطال وPagingSource.load(LoadParams.Refresh(...)) قبل عرض RemoteMediator.load() b/173717820

الإصدار 3.0.0-alpha09

11 تشرين الثاني (نوفمبر)، 2020

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

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

  • Fully deprecate dataRefreshFlow / Listener methods with a replaceWith clause. (I6e2dd)

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

  • تم إصلاح مشكلة ظهور الخطأ IllegalArgumentException عند استخدام الفواصل مع RemoteMediator وتشغيل عملية إبطال أثناء تشغيل عملية تحميل عن بُعد من شأنها عرض endOfPagination‏ (I3a260)

الإصدار ‎3.0.0-alpha08

‫28 أكتوبر 2020

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

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

  • تم دمج صيغ Kotlin / Java من DataSource.InvalidatedCallback من خلال تفعيل تحويلات SAM في Kotlin عبر واجهة وظيفية (متوفّرة في Kotlin 1.4). يؤدي هذا أيضًا إلى إصلاح خطأ حيث لم يتم استدعاء متغير kotlin لعمليات الاستدعاء غير الصالحة بعد تحويله بواسطة .map أو .mapByPage. (I1f244، b/165313046)

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

  • تم تحسين تفاعل Paging مع ViewPager بشكل كبير. على وجه التحديد، لن تلغي مكتبة Paging بعد الآن طلب RemoteMediator#load بسبب إلغاء صلاحية الصفحة. ولن يرسل أيضًا طلب تحميل لإضافة محتوى إلى نهاية الصفحة أو بدايتها، إذا كان REFRESH مطلوبًا، إلى أن يكتمل طلب REFRESH بنجاح. (I6390b، b/162252536)
  • تم تفعيل فحص API lint لـ MissingGetterMatchingBuilder في androidx ‏(I4bbea، b/138602561)
  • تم إصلاح خطأ يتسبب في تعطُّل أدوات المساعدة .withLoadState* ConcatAdapter بسبب إرسال إشعارات إلى RecyclerView من سلسلة التعليمات في الخلفية (I18bb5، b/170988309)
  • تم إصلاح خلل كان يؤدي أحيانًا إلى منع ميزة الجلب المُسبق من بدء عمليات التحميل بشكل صحيح عند تحميل صفحة صغيرة جدًا غير فارغة.Iffda3 b/169259468

الإصدار ‎3.0.0-alpha07

‫1 أكتوبر 2020

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

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

  • تقبل الآن عوامل التشغيل المستندة إلى Guava في Async PagingData معلَمة Executor للتحكّم في سياق التنفيذ. (Id4372)

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

  • تم إصلاح استثناء IndexOutOfBounds الذي تم طرحه في RemoteMediator بسبب حالة السباق. (I00b7f، b/165821814)
  • تم إصلاح حالة سباق في تحويل DataSource -> PagingSource التي قد تؤدي إلى تجاهل PagingSource الناتجة لإشارات الإبطال من DataSource.
  • تم إصلاح مشكلة في منطق جلب الصفحات كانت تؤدي أحيانًا إلى تعذُّر التقاط أجيال جديدة من PagingSource إلى أن يتم استدعاء PagingDataAdapter.refresh()‎
  • تم إصلاح مشكلة تؤدي أحيانًا إلى فقدان موضع الانتقال عند استخدام DataSource تم تحويله إلى PagingSource (مثل الذي تم إنشاؤه بواسطة Room)، مع RemoteMediator

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

  • نشكر ‎ @simonschiller على إضافة عوامل تشغيل التحويل غير المتزامن المستندة إلى RxJava2 وRxJava3 وGuava لـ PagingData.

الإصدار 3.0.0-alpha06

‫2 سبتمبر 2020

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

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

  • UnsupportedOperationException مع رسائل أوضح حول عدم توفّر معرّفات ثابتة، يتم الآن عرضها كلما تم استدعاء PagingDataAdapter.setHasStableIds. (Ib3890، b/158801427)

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

  • لم تعُد دالة insertSeparators تستبعد الصفحات الفارغة، ما يسمح للعارض بالالتزام بمسافة الجلب المُسبَق حتى في الحالات التي يتم فيها إدراج العديد من الصفحات الفارغة. (I9cff6، b/162538908)

الإصدار ‎3.0.0-alpha05

‫19 أغسطس 2020

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

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

  • تجلب مكتبة Paging الآن الصفحات مسبقًا بشكل صحيح حتى عندما تتم فلترة البيانات المعروضة بشكل كبير
  • لم تعد إعادة LoadResult.Error إلى عملية تحميل تمت إعادة محاولتها تؤدي إلى إعادة تشغيل محاولة الوصول إلى العناصر بشكل غير صحيح

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

  • نشكر "كلارا ف" على مساعدتنا في تنظيم بعض الاختبارات. (549612)

الإصدار ‎3.0.0-alpha04

‫5 أغسطس 2020

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

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

  • تمت إضافة واجهة برمجة التطبيقات peek() إلى AsyncPagingDataDiffer وPagingDataAdapter للسماح بالوصول إلى البيانات المعروضة بدون تحميل صفحات المشغّلات. (I38898، b/159104197)
  • تمت إضافة واجهة برمجة تطبيقات snapshot() إلى PagingDataAdapter وAsyncPagingDataDiffer للسماح باسترداد العناصر المعروضة بدون تفعيل جلب الصفحة. (I566b6، b/159104197)
  • تمت إضافة دالة إنشاء PagingData.from(List<T>) للسماح بعرض القوائم الثابتة التي يمكن دمجها مع تدفق PagingData العام لعرض القوائم الثابتة في حالات معيّنة، على سبيل المثال، قبل انتهاء عملية إعادة التحميل الأولية أو ببساطة لاختبار عمليات التحويل. (Id134d)
  • تم إيقاف واجهات برمجة التطبيقات dataRefresh Flow / Listener نهائيًا لأنّها كانت تهدف إلى عرض حالة العناصر المعروضة في REFRESH، ولكن مع التحسينات التي تم إجراؤها على توقيت استدعاء loadState Flow / Listener وسمة itemCount، أصبحت هذه الواجهات زائدة عن الحاجة (Ia19f3)
  • تمت إضافة برامج تضمين متوافقة مع RxJava3 لكل من PagingSource وRemoteMediator (I49ef3، b/161480176)

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

  • PositionalDataSource converted into PagingSource via toPagingSourceFactory helper, including PagingSource generated by Room now correctly mark themselves to support jumping. (I3e84c، b/162161201)
  • تم إصلاح خطأ كان يؤدي أحيانًا إلى حدوث حالة سباق تؤدي إلى ClosedSendChannelException عند استخدام الصيغة المتزامنة من submitData (I4d702، b/160192222)

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

  • نشكر "زاك سويرز" على إضافة برامج تضمين متوافقة مع RxJava3 نيابةً عن Slack. (I49ef3، b/161480176)

الإصدار ‎3.0.0-alpha03

‫22 يوليو 2020

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

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

  • أصبحت دالة الإنشاء لـ PagingState متاحة للجميع الآن، ما يسهّل اختبار عمليات تنفيذ getRefreshKey()‎ ‏(I8bf15)
  • تم إخفاء خيارات دالة الخريطة DataSource kotlin من Java، لحلّ الالتباس بين الخيارات الأصلية وخيارات kotlin. (If7b23، b/161150011)
  • تم وضع علامة @JvmSynthetic على واجهات برمجة التطبيقات المكرّرة والمخصّصة لتسهيل الاستخدام لمستخدمي Kotlin (I56ae5)
  • تمت إضافة عمليات تحميل زائدة لدالة الإنشاء LoadResult.Page التي تضبط itemsBefore وitemsAfter تلقائيًا على COUNT_UNDEFINED (I47849)
  • تم تعديل عوامل تشغيل PagingData الحالية لتقبل طرق التعليق، وتم تقديم عوامل تشغيل جديدة غير معلّقة، وهي mapSync وflatMapSync وfilterSync، لمستخدمي Java. تم نقل طرق التحويل الحالية إلى دوال الإضافة، لذا سيحتاج مستخدمو Kotlin الآن إلى استيرادها. (I34239، b/159983232)

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

  • ستعرض الآن مصادر PagingSources في Room (وPositionalDataSource) فاصلاً رئيسيًا كجزء من الصفحة الأولى، حتى لا يحتاج المستخدم إلى التمرير للكشف عنه. (I6f747، b/160257628)
  • تؤدي الآن عمليات الوصول إلى العناصر في العناصر النائبة إلى تشغيل عمليات تحميل PagingSource بشكل صحيح إلى أن يتم عرض صفحة تفي بالفهرس المطلوب بعد تحويلها بواسطة PagingData.filter()‎ ‏(I95625، b/158763195)
  • تم إصلاح خطأ كان يمنع أحيانًا PagingDataAdapter.retry()‎ من إعادة المحاولة عند التمرير بعد ظهور خطأ في PagingSource. (I1084f، b/160194384)
  • تم إصلاح مشكلة احتمال عدم تحميل الصفحات عند الوصول إلى العناصر بعد إسقاط صفحة، على الرغم من أنّ الوصول إلى العناصر كان ضمن prefetchDistance (Ie95ae، b/160038730).
  • لم يعُد ضبط PagingConfig.maxSize يفعّل العناصر النائبة بعد حدث إسقاط (I2be29، b/159667766)

الإصدار ‎3.0.0-alpha02

‫24 يونيو 2020

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

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

  • تمّت إضافة وظائف زائدة لمنشئ PagingConfig باستخدام القيم التلقائية الشائعة (I39c50، b/158576040)
  • تمت إضافة عمليات تحميل زائدة لدوال الإنشاء PagingDataAdapter وAsyncPagingDataDiffer مع القيم التلقائية الشائعة (Ie91f5)
  • تُمرِّر واجهات برمجة التطبيقات الخاصة بالمحوِّل، dataRefreshFlow وdataRefreshListener، الآن قيمة منطقية للإشارة إلى ما إذا كان PagingData فارغًا (I6e37e، b/159054196)
  • تمت إضافة واجهات برمجة تطبيقات RxJava وGuava لـ RemoteMediator، وهما RxRemoteMediator وListenableFutureRemoteMediator
  • تمت إضافة أدوات مساعدة إلى PagingState للوصول إلى العناصر الشائعة، مثل isEmpty() وfirstItemOrNull() (I3b5b6، b/158892717)

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

  • يتحقّق Pager الآن من إعادة استخدام PagingSource في المصنع، وذلك لمنع إعادة استخدام PagingSources غير الصالحة عن طريق الخطأ، ما يؤدي إلى ظهور خطأ غير واضح (I99809، b/158486430)
  • لم تعُد حالات تعذُّر تحميل البيانات من RemoteMediator REFRESH تمنع PagingSource من التحميل (I38b1b، b/158892717)
  • لم يعُد الإصدار غير المعلّق من submitData يتسبب في حدوث عطل بسبب الجمع المتزامن في عدة PagingData عند استدعائه بعد الإصدار المعلّق من submitData. (I26358، b/158048877)
  • تم إصلاح استثناء "لا يمكن جمع البيانات مرتين من أداة التنقّل بين الصفحات" الذي قد يحدث بعد تغيير الإعدادات (I58bcc، b/158784811)

الإصدار ‎3.0.0-alpha01

‫10 يونيو 2020

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

تم تحديث مكتبة Paging إلى الإصدار 3.0 لتفعيل العديد من الميزات الجديدة الرئيسية.

الميزات الجديدة في الإصدار 3.0

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

  • لا تتوفّر مستندات JavaDocs الخاصة بمكتبة Paging 3 حتى الآن. في هذه الأثناء، يُرجى استخدام الأدلة المرتبطة أعلاه أو مستندات Kotlin. (b/158614050)

الإصدار 2.1.2

الإصدار 2.1.2

‫18 مارس 2020

تم طرح androidx.paging:paging:2.1.2. يتضمّن الإصدار 2.1.2 هذه التعديلات مقارنةً بالإصدار 2.1.0.

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

  • تم إصلاح مشكلة في IndexOutOfBoundsException في حالات نادرة عند تحويل موضع أثناء الإبطال.

حلّ المشكلة

  • تم طرح الإصدار 2.1.1 من Paging بشكل غير صحيح من فرع تم ضبطه بشكل خاطئ، ما أدى إلى الكشف عن واجهات برمجة تطبيقات ووظائف تم تنفيذها جزئيًا في إصدار مستقبلي.

  • يتضمّن الإصدار 2.1.2 من مكتبة Paging الإصلاح الخاص بتوسيط التحميل الذي تم طرحه في الأصل في الإصدار 2.1.1، ولكن هذه المرة تم اختياره بشكل صحيح فوق الإصدار 2.1.0. ننصح بشدة بالترقية إلى هذا الإصدار إذا كنت تستخدم حاليًا الإصدار 2.1.1.

الإصدار 2.1.1

الإصدار 2.1.1

‫18 ديسمبر 2019

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

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

  • أصبحت عمليات التحميل الأولية المتجاورة من PositionalDataSources تتمحور الآن حول آخر وصول عند إيقاف العناصر النائبة

الإصدار 2.1.0

الإصدار 2.1.0

‫25 يناير 2019

تم إصدار الإصدار 2.1.0 من مكتبة Paging بدون أي تغييرات عن الإصدار 2.1.0-rc01.

الإصدار 2.1.0-rc01

‫6 ديسمبر 2018

تم إصدار الإصدار 2.1.0-rc01 من مكتبة Paging بدون أي تغييرات عن الإصدار 2.1.0-beta01.

الإصدار ‎2.1.0-beta01

‫1 نوفمبر 2018

تم إصدار الإصدار 2.1.0-beta01 من مكتبة Paging بدون أي تغييرات عن الإصدار 2.1.0-alpha01.

الإصدار 2.1.0-alpha01

‫12 أكتوبر 2018

تتضمّن مكتبة Paging 2.1.0-alpha01 إضافتَين رئيسيتَين، وهما إسقاط الصفحات ومكتبات إضافات KTX لكل عنصر، بالإضافة إلى العديد من التغييرات الأخرى في واجهة برمجة التطبيقات وإصلاحات الأخطاء.

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

  • تمت إضافة PagedList.Config.Builder.setMaxSize() للحدّ من عدد العناصر المحمَّلة في الذاكرة.
  • تمت إضافة androidx.paging.Config() كبديل بلغة Kotlin لـ PagedList.Config.Builder
  • تمت إضافة androidx.paging.PagedList() كبديل بلغة Kotlin لـ PagedList.Builder
  • تمت إضافة DataSourceFactory.toLiveData() كبديل بلغة Kotlin لـ LivePagedListBuilder
  • تمت إضافة DataSourceFactory.toObservable() وtoFlowable() كبديلَين بلغة Kotlin لـ RxPagedListBuilder
  • تمت إضافة AsyncPagedListDiffer.addPagedListListener() للاستماع إليها عند تبديل PagedList. b/111698609
  • تمت إضافة صيغة PagedListAdapter.onCurrentListChanged() التي تمرّر القائمة القديمة والجديدة، وتم إيقاف الصيغة السابقة نهائيًا.
  • تمت إضافة صيغ PagedListAdapter/AsyncPagedListDiffer.submitList() التي تستخدم دالة رد اتصال إضافية يتم تشغيلها في حال/عند عرض pagedlist، بعد إجراء المقارنة. يتيح لك ذلك مزامنة تبديل PagedList مع تحديثات واجهة المستخدم الأخرى. b/73781068
  • تمت إضافة PagedList.getLoadedCount() لإعلامك بعدد العناصر المحفوظة في الذاكرة. يُرجى العِلم أنّ القيمة المعروضة تساوي دائمًا .size() في حال إيقاف العناصر النائبة.

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

  • تم إصلاح حالة السباق عند المقارنة في حال إعادة استخدام القوائم b/111591017
  • يُظهر PagedList.loadAround() الآن IndexOutOfBoundsException عندما يكون الفهرس غير صالح. في السابق، كان من الممكن أن يتعطّل التطبيق بسبب استثناء آخر غير واضح.
  • تم إصلاح مشكلة عدم تحميل المزيد من البيانات في حال كان حجم التحميل الأولي صغيرًا جدًا مع عدم تغيير البيانات b/113122599

الإصدار 2.0.0

الإصدار 2.0.0

‫1 أكتوبر 2018

تم إصدار Paging 2.0.0 مع إصلاح خطأ واحد.

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

  • تم إصلاح عطل قد يحدث عند الانتقال بسرعة كبيرة باستخدام PositionalDataSource والعناصر النائبة b/114635383.

الإصدار ‎2.0.0-beta01

‫2 يوليو 2018

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

  • تم إصلاح مشكلة اختفاء المحتوى في بعض حالات الإضافة في البداية (تم إيقاف العناصر النائبة، PositionalDataSource) b/80149146
  • (تم إصدارها في 1.0.1) تم إصلاح الأعطال التي تؤدي إلى تعذُّر إرسال إشارات أحداث النقل في PagedListAdapter وAsyncPagedListDiffer. b/110711937

التبعيات السابقة لنظام AndroidX

بالنسبة إلى إصدارات Paging السابقة لإصدار AndroidX، يجب تضمين التبعيات التالية:

dependencies {
    def paging_version = "1.0.0"

    implementation "android.arch.paging:runtime:$paging_version"

    // alternatively - without Android dependencies for testing
    testImplementation "android.arch.paging:common:$paging_version"

    // optional - RxJava support
    implementation "android.arch.paging:rxjava2:$paging_version"
}

الإصدار 1.0.1

الإصدار 1.0.1

‫26 يونيو 2018

تم طرح الإصدار 1.0.1 من Paging مع إصلاح خطأ واحد في runtime. ننصح بشدة باستخدام 1.0.1 لضمان الاستقرار. تم أيضًا إصدار الإصدار 1.0.1 من Paging RxJava2، وهو مطابق للإصدار 1.0.0-rc1.

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

  • تم إصلاح الأعطال التي تسبّبت في تعذُّر إرسال إشارات أحداث النقل من خلال PagedListAdapter وAsyncPagedListDiffer. b/110711937

الإصدار 1.0.0 من RxJava2

الإصدار 1.0.0-rc1 من RxJava2

‫16 مايو 2018

يتم نقل Paging RxJava2 1.0.0-rc1 إلى الإصدار المحتمل بدون أي تغييرات من الإصدار الأولي.

الإصدار 1.0.0

الإصدار 1.0.0-rc1

‫19 أبريل 2018 الإصدار المحتمل لمكتبة Paging

لا تتوفّر لدينا أي مشاكل معروفة أو ميزات جديدة مقرَّرة لإصدار Paging 1.0.0. يُرجى ترقية مشاريعك لاستخدام 1.0.0-rc1 ومساعدتنا في اختباره بشكل مكثّف لنتمكّن من إطلاق إصدار 1.0.0 قوي وموثوق.

لا يتضمّن هذا الإصدار أي تغييرات، فهو مماثل للإصدار 1.0.0-beta1.

الإصدار 1.0.0-beta1

‫5 أبريل 2018

ستكون مكتبة Paging في مرحلة تجريبية لفترة قصيرة قبل الانتقال إلى الإصدار المحتمل. لا نخطّط لإجراء أي تغييرات أخرى على واجهة برمجة التطبيقات في الإصدار Paging 1.0، كما أنّ معايير أي تغييرات على واجهة برمجة التطبيقات عالية جدًا.

تم إصدار الإصدار الأولي من RxJava2 المتوافق مع ميزة "تقسيم الصفحات" كوحدة اختيارية منفصلة (android.arch.paging:rxjava2:1.0.0-alpha1) وسيتم إصدارها مؤقتًا بشكل منفصل إلى أن تستقر.

توفّر هذه المكتبة الجديدة بديلاً لـ RxJava2 لـ LivePagedListBuilder، ويمكنها إنشاء Observable وFlowable، مع استخدام Scheduler بدلاً من Executor:

Kotlin

val pagedItems = RxPagedListBuilder(myDataSource, /* page size */ 50)
        .setFetchScheduler(myNetworkScheduler)
        .buildObservable()

Java

Observable<PagedList<Item>> pagedItems =
        RxPagedListBuilder(myDataSource, /* page size */ 50)
                .setFetchScheduler(myNetworkScheduler)
                .buildObservable();

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

  • تمت إضافة "RxPagedListBuilder" من خلال عنصر "android.arch.paging:rxjava2" الجديد.

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

  • تغييرات في واجهة برمجة التطبيقات لتوضيح دور المنفّذين في أدوات الإنشاء:

    • تمت إعادة تسمية "setBackgroundThreadExecutor()" إلى "setFetchExecutor()" (في "PagedList.Builder" و"LivePagedListBuilder")

    • تمت إعادة تسمية "setMainThreadExecutor()" إلى "setNotifyExecutor()" (في "PagedList.Builder").

  • تم إصلاح عضو واحد (PagedList.mCallbacks) ليكون خاصًا.

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

  • يؤدي استخدام LivePagedListBuilder إلى بدء تحميل PagedList الأولي على المنفِّذ المحدّد، بدلاً من مجموعة سلاسل عمليات الإدخال/الإخراج في مكوّنات Arch.

  • تم إصلاح سلوك الإبطال في برامج تضمين DataSource الداخلية (المستخدَمة لتنفيذ DataSource.map، بالإضافة إلى تحميل PositionalDataSource مع إيقاف العنصر النائب) b/77237534

الإصدار 1.0.0-alpha7

‫21 مارس 2018

تم طرح Paging 1.0.0-alpha7 مع Lifecycles 1.1.1. بما أنّ الإصدار alpha7 من Paging يعتمد على نقل فئة Function المذكورة أعلاه، عليك تعديل تبعية lifecycle:runtime إلى android.arch.lifecycle:runtime:1.1.1.

من المقرّر أن يكون الإصدار alpha7 من Paging هو الإصدار النهائي قبل إطلاق الإصدار التجريبي من Paging.

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

  • تحتوي كائنات DataSource.LoadParams الآن على دالة إنشائية عامة، وأصبحت كائنات DataSource.LoadCallback الآن مجرّدة. يتيح ذلك إمكانية التفاف DataSource أو اختبار DataSource مباشرةً باستخدام دالة رد اتصال وهمية. b/72600421
  • أدوات ربط لـ DataSource وDataSource.Factory
    • يتيح لك map(Function<IN,OUT>) تحويل النتائج التي تم تحميلها بواسطة DataSource أو التفافها أو تزيينها.
    • تتيح السمة mapByPage(<List<IN>,List<OUT>>) الإجراء نفسه للمعالجة على دفعات (على سبيل المثال، إذا كانت العناصر التي تم تحميلها من SQL تحتاج إلى الاستعلام عن قاعدة بيانات منفصلة، يمكن إجراء ذلك كدفعة).
  • PagedList#getDataSource() is added as a convenience method b/72611341
  • تمت إزالة جميع الفئات المتوقّفة نهائيًا من واجهة برمجة التطبيقات، بما في ذلك ما تبقى من حزمة recyclerview.extensions وLivePagedListProvider.
  • تم تغيير DataSource.Factory من واجهة إلى فئة مجرّدة لتفعيل وظيفة الخريطة.

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

  • تم تغيير Builders لتكون نهائية. b/70848565
  • تم إصلاح تنفيذ Room DataSource للتعامل مع طلبات البحث المتعددة الجداول، وهذا الإصلاح مضمّن في الإصدار Room 1.1.0-beta1، انظر أعلاه.
  • تم إصلاح خلل كان يؤدي إلى عدم استدعاء BoundaryCallback.onItemAtEndLoaded لـ PositionalDataSource في حال تفعيل العناصر النائبة وكان الحجم الإجمالي مضاعفًا دقيقًا لحجم الصفحة.

الإصدار 1.0.0-alpha5

‫22 يناير 2018

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

  • إصلاح مشكلة تحميل الصفحة عند إيقاف العناصر النائبة b/70573345
  • تسجيل إضافي لتتبُّع خطأ IllegalArgumentException b/70360195 (وإصلاح افتراضي من جهة Room)
  • إصلاحات الرموز النموذجية في Javadoc‏ b/70411933 وb/71467637