ترقيم الصفحات
يسرد هذا الجدول جميع العناصر في مجموعة "androidx.paging".
| العناصر | الإصدار المستقر | إصدار محتمل | الإصدار التجريبي | الإصدار الأولي |
|---|---|---|---|---|
| paging-* | 3.5.3 | - | - | 3.6.0-alpha01 |
| paging-compose | 3.5.3 | - | - | 3.6.0-alpha01 |
تحديد الاعتماديات
لإضافة اعتمادية على 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) { ... } }- دمج بيانات Flow of
أضافت أداة
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 هذه التعديلات.
الميزات الجديدة
- تمت إزالة التوافق مع منصات KMP التالية:
macosX64وiosX64وwatchosX64وtvosX64ليتوافق ذلك مع إيقاف Jetbrains النهائي لأهداف macosX64. (7cb9a4)
الإصدار 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 هذه التعديلات.
الميزات الجديدة
- أضافت ميزة "تقسيم الصفحات" أهداف KMP التالية: watchos وtvos وmingwX64 وwatchosDeviceArm64 وlinuxArm64. (I237dd، Ia62b3، b/368046982، Icf15d، b/364652024، I139d3، b/338268719)
إصلاح الأخطاء
- لن تظهر أخطاء من
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 جاهزًا.
مساهمة خارجية
الإصدار 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)
مساهمة خارجية
- نشكر veyndan من Cash App على المساعدة في نقل Paging إلى Kotlin Multiplatform (#560 و#561 و#562 و#573 و#576 و#577 و#578 و#579 و#580 و#581 و#583 و#584 و#586 و#609)
الإصدار 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 هذه التعديلات.
مساهمة خارجية
الإصدار 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 Compose1.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)
التغييرات في السلوك
- لم يعُد المُرسِل الرئيسي مطلوبًا لتشغيل اختبارات
asSnapshotPaging. ولن يؤدي ضبطه إلى إجراء أي تغييرات على سلوك الاختبار. (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)
المساهمات الخارجية
- نشكر Veyndan على مساهمته في نقل Paging بعيدًا عن تفاصيل Android/JVM. (#525، #523، #520، #519، #507، #506، #505، #499، #497، #496، #493)
الإصدار 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.ويتم ذلك من خلال إضافة
asSnapshotKotlin علىFlow<PagingData<Value>>، والتي تترجمFlow<PagingData<Value>>إلىList<Value>مباشرةً. تتيح لك دالة lambdaasSnapshotمحاكاة واجهة المستخدم في تطبيقك من خلال واجهات برمجة التطبيقات، مثل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 shelladb 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لـ RemoteMediatorREFRESH، ولكن ليس لـ 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). ويعني هذا أنّ:- سيتم دائمًا ملء حالات الوسيط إذا كنت تستخدم RemoteMediator.
- لن يؤدي تسجيل مستمع 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.getRefreshKeyis 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 }
إصلاح الأخطاء
- يتم الآن نشر 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)
إصلاح الأخطاء
PositionalDataSourceconverted intoPagingSourceviatoPagingSourceFactoryhelper, includingPagingSourcegenerated 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
- دعم من الدرجة الأولى لـ Kotlin coroutines وFlow
- إتاحة التحميل غير المتزامن باستخدام وظائف تعليق الكوروتين أو RxJava Single أو Guava ListenableFuture
- إشارات مدمجة لحالة التحميل والأخطاء لتصميم واجهة مستخدم متجاوبة، بما في ذلك وظائف إعادة المحاولة وإعادة التحميل
- تحسينات على طبقة المستودع
- واجهة مبسّطة لمصدر البيانات
- تقسيم الشبكة وقاعدة البيانات إلى صفحات بشكل مبسّط
- الدعم في حالات الإلغاء
- تحسينات على طبقة العرض
المشاكل المعروفة
- لا تتوفّر مستندات 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