صفحهبندی
این جدول همه مصنوعات موجود در گروه androidx.paging را فهرست میکند.
| آرتیفکت | نسخه پایدار | نامزد انتشار | انتشار نسخه بتا | نسخه آلفا |
|---|---|---|---|---|
| paging-* | ۳.۵.۳ | - | - | 3.6.0-alpha01 |
| paging-compose | ۳.۵.۳ | - | - | 3.6.0-alpha01 |
اعلام وابستگیها
برای افزودن وابستگی به Paging، باید مخزن Google Maven را به پروژهتان اضافه کنید. برای اطلاعات بیشتر، مخزن Maven در Google را بخوانید.
وابستگیهای لازم برای مصنوعات موردنیازتان را در فایل build.gradle برای برنامه یا واحدتان اضافه کنید:
شیک
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" }
کاتلین
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.0-alpha01
۱۸ نوامبر ۲۰۲۶
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سپاسگزاریم.
نسخه ۳.۵
نسخه ۳.۵.۳
۱۲ اکتبر ۲۰۲۶
androidx.paging:paging-*:3.5.3 منتشر شده است. نسخه ۳.۵.۳ حاوی این ثبتها است.
رفع اشکالها
- وقتی
RemoteMediatorدر هر جهتی به انتهای صفحهبندی برسد و «سرصفحه» یا «پاصفحه» به جداکننده پایانی تبدیل شود،ItemSnapshotListFlowدیگرIllegalArgumentExceptionرا نشان نخواهد داد. (I821c7، b/566336825) - وقتی صفحه بارشده از
PagingConfig.maxSizeفراتر رود، صفحات بارشده به کمتر از دو صفحه کاهش نخواهند یافت تا اطمینان حاصل شود که نمای دید بهدرستی با دادهها پر شده است. (I037a0، b/565835910)
همیاری خارجی
از ایگور برای ارسال رفع اشکال b/565835910 سپاسگزاریم
نسخه ۳.۵.۲
۷ اکتبر ۲۰۲۶
androidx.paging:paging-*:3.5.2 منتشر شده است. نسخه ۳.۵.۲ حاوی این ثبتها است.
رفع اشکالها
Pager.append()calls before initial refresh completes will no longer throwNoSuchElementException. The append call will be no-op. (Ide387, b/556780796)
نسخه ۳.۵.۱
۱۲ اوت ۲۰۲۶
androidx.paging:paging-*:3.5.1 منتشر شده است. نسخه ۳.۵.۱ حاوی این commitها است.
رفع اشکالها
-
PagingSource.getRefreshKeyکهanchorPositionنادرستی را ارائه میکرد که هنگام بازآوری صفحه با جداکنندهها درحین پیمایش به جایبانها بسیار بزرگ بود، اصلاح شد. (I475f0، b/516565503)
نسخه ۳.۵.۰
۶ مه ۲۰۲۶
androidx.paging:paging-*:3.5.0 منتشر شده است. نسخه ۳.۵.۰ حاوی این ثبتها است.
تغییرات مهم از نسخه ۳.۴.۰:
عملگر
Flow<PagingData>.asItemSnapshotListFlowبرای تبدیلFlow<PagingData>بهFlow<ItemSnapshotList>اضافه شد. این یعنی اکنون میتوان به دادههای بارشده در خارج از لایه میانای کاربر دسترسی داشت، که به شما امکان میدهدFlow<ItemSnapshotList>را با منابع داده دیگر ترکیب کنید، دادههای صفحهبندیشده را بهصورت محلی ذخیره و اصلاح کنید، یا دادههای صفحهبندیشده را بهعنوان بخشی از وضعیت میانای کاربر و موارد دیگر نمایش دهید.توابع افزونه
Pager.appendوPager.prependبرای بار کردن دستی دادههای بیشتر بدون پیمایش اضافه شد.توابع افزونه
Pager.refreshوPaging.retryبرای بازیابی از خطاهای بارگیری هنگام استفاده ازasItemSnapshotListFlowAPI اضافه شد.
نسخه 3.5.0-rc01
۲۲ آوریل ۲۰۲۶
androidx.paging:paging-*:3.5.0-rc01 منتشر شده است. نسخه 3.5.0-rc01 حاوی این commitها است.
بدون تغییر
- تغییر قابلتوجهی نسبت به نسخه
3.5.0-beta01وجود ندارد.
نسخه 3.5.0-beta01
۸ آوریل ۲۰۲۶
androidx.paging:paging-*:3.5.0-beta01 منتشر شده است. نسخه 3.5.0-beta01 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
- نام
Flow<PagingData>.asStateAPI بهFlow<PagingData>.asItemSnapshotListFlowتغییر کرده است (I0dc11، b/496548025)
نسخه 3.5.0-alpha01
۱۱ مارس ۲۰۲۶
androidx.paging:paging-*:3.5.0-alpha01 منتشر شده است. نسخه 3.5.0-alpha01 حاوی این ارسالها است.
ویژگیهای جدید
ساخته
paging-commonاکنون حاوی یک اپراتور جریانasStateجدید درFlow<PagingData>است تا آن را بهFlow<ItemSnapshotList>تبدیل کند. این کار قابلیتهایی مثل موارد زیر را باز میکند:- ترکیب کردن جریان
ItemSnapshotListبا منابع داده دیگر - share flow with multiple collectors without
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استفاده شود، جایگزینی برای بار کردن دادههای بیشتر علاوهبر پیمایش ارائه میدهد - وقتی با
asStateAPI جدید استفاده میشود، تنها راه برای بار کردن دادههای بیشتر است
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)
نسخه ۳.۴
نسخه ۳.۴.۲
۱۱ مارس ۲۰۲۶
androidx.paging:paging-*:3.4.2 منتشر شده است. نسخه ۳.۴.۲ حاوی این ثبتها است.
بدون تغییر
- این نسخه هیچ تغییر رفتاری یا میانای برنامهسازی کاربردی نسبتبه نسخه ۳.۴.۱ ندارد.
نسخه ۳.۴.۱
۱۱ فوریه ۲۰۲۶
androidx.paging:paging-*:3.4.1 منتشر شده است. نسخه ۳.۴.۱ حاوی این ثبتها است.
بهروزرسانی وابستگی
- وابستگی guava در paging-guava از نسخه ۳۱.۱ به ۳۲.۰.۱ بهروز شد.
نسخه ۳.۴.۰
۲۸ ژانویه ۲۰۲۶
androidx.paging:paging-*:3.4.0 منتشر شده است. نسخه ۳.۴.۰ حاوی این ثبتها است.
تغییرات مهم از نسخه ۳.۳.۰:
- هدفهای KMP بیشتری به
paging-common،paging-testing، وpaging-composeاضافه شد. درمجموع، همه آنها اکنون از JVM (Android و رایانه)، Native (Linux، iOS، watchOS، tvOS، macOS، MinGW)، و Web (جاوا اسکریپت، WasmJS) پشتیبانی میکنند -
paging-common،paging-testing، وpaging-composeپشتیبانی ازmacosX64،iosX64،watchosX64، وtvosX64را برای همراستایی با منسوخ شدن هدفهای macosX64 توسط Jetbrains برداشته است. PagingStateAPIclosestItemAroundPositionجدیدی اضافه شد تا مورد بارشدهای را که به موقعیت هدف نزدیکتر است و با گزاره ورودی مطابقت دارد بازیابی کند. از این ویژگی میتوان برای تولید کلیدهای بازآوری مبتنی بر مورد استفاده کرد، جایی که مورد قابللنگر انداختن ایدهآل در اطراف موقعیت هدف دقیق قرار دارد اما دقیقاً در آن موقعیت نیست.
نسخه 3.4.0-rc01
۱۴ ژانویه ۲۰۲۶
androidx.paging:paging-*:3.4.0-rc01 منتشر شده است. نسخه 3.4.0-rc01 حاوی این موارد ثبت است.
ویژگیهای جدید
- پشتیبانی از پلاتفرمهای KMP زیر برداشته شد:
macosX64،iosX64،watchosX64، وtvosX64برای همراستا شدن با منسوخ شدن macosX64 targets توسط Jetbrains. (7cb9a4)
نسخه 3.4.0-beta01
۱۷ دسامبر ۲۰۲۵
androidx.paging:paging-*:3.4.0-beta01 منتشر شده است. نسخه 3.4.0-beta01 حاوی این ارسالها است.
رفع اشکالها
- Fix race between
RecyclerViewandRefreshloads leading toIndexOutOfBoundsExceptioninRecyclerView. بهروزرسانیهای منقطع میانای کاربر بهدلیل بارگیریهای مداومRefreshمیتواند باعث شود وضعیت «صفحهبندی» باRecyclerViewهمگامسازی نشود. این مشکل با بازنشانی «صفحهبندی» به وضعیت پیشاز «بازآوری» درصورت قطع شدن «بازآوری» (یعنی با بارگیری متوالیRefresh) برطرف میشود. (I771b0، b/409809768)
نسخه 3.4.0-alpha04
۱۰ سپتامبر ۲۰۲۵
androidx.paging:paging-*:3.4.0-alpha04 منتشر شده است. نسخه 3.4.0-alpha04 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
PagingStateAPIclosestItemAroundPositionجدیدی اضافه شد تا مورد بارشدهای را که به موقعیت هدف نزدیکتر است و با گزاره ورودی مطابقت دارد بازیابی کند. از این ویژگی میتوان برای تولید کلیدهای بازآوری مبتنی بر مورد استفاده کرد، جایی که مورد قابللنگر انداختن ایدهآل در اطراف موقعیت هدف دقیق قرار دارد اما دقیقاً در آن موقعیت نیست. (I96e5c، b/440187139)
نسخه 3.4.0-alpha03
۲۷ اوت ۲۰۲۵
androidx.paging:paging-*:3.4.0-alpha03 منتشر شده است. نسخه 3.4.0-alpha03 حاوی این ارسالها است.
ویژگیهای جدید
- Paging-common رایانه را بهعنوان هدف جدید Kotlin Multiplatform (KMP) اضافه کرده است. درمجموع، اکنون از JVM (Android و رایانه)، Native (Linux، iOS، watchOS، tvOS، macOS، MinGW)، و Web (جاوا اسکریپت، WasmJS) پشتیبانی میکند. (Id2483، b/436884811)
- Paging-testing هدفهای جدید Kotlin Multiplatform (KMP) را اضافه کرده است. درمجموع، اکنون از JVM (Android و رایانه)، Native (Linux، iOS، watchOS، tvOS، macOS، MinGW)، و Web (جاوا اسکریپت، WasmJS) پشتیبانی میکند. (I0c543، b/435014650)
- Paging-compose هدفهای جدید Kotlin Multiplatform (KMP) را اضافه کرده است. درمجموع، اکنون از JVM (Android و رایانه)، Native (Linux، iOS، watchOS، tvOS، macOS، MinGW)، و Web (جاوا اسکریپت، WasmJS) پشتیبانی میکند. (I70d44، b/436884801)
تغییرات میانای برنامهسازی کاربردی
- Moving the default minSdk from API 21 to API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)
نسخه 3.4.0-alpha02
۳۰ ژوئیه ۲۰۲۵
androidx.paging:paging-*:3.4.0-alpha02 منتشر شده است. نسخه 3.4.0-alpha02 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
PagingData.fromاکنون اجازه میدهدplaceholdersBeforeوplaceholdersAfterرا تنظیم کنید. توجه داشته باشید که پیمایش در این جایبانها باعث بارگیری نمیشود. (I06983)
نسخه 3.4.0-alpha01
۲ ژوئیه ۲۰۲۵
androidx.paging:paging-*:3.4.0-alpha01 منتشر شده است. نسخه 3.4.0-alpha01 حاوی این ارسالها است.
ویژگیهای جدید
- Paging اهداف KMP زیر را اضافه کرده است: watchos، tvos، mingwX64، watchosDeviceArm64، و linuxArm64. (I237dd، Ia62b3، b/368046982، Icf15d، b/364652024، I139d3، b/338268719)
رفع اشکالها
- آزمایشهای واحد Android که Paging 3.3 یا جدیدتر را وارد میکنند دیگر از
PagingLoggerپرتاب نمیکنند (Ia9400، b/331684448) - اشکالی که در آن
RecyclerViewهنگام پیمایش کاربر درحین بهروزرسانیRecyclerView،IndexOutOfBoundsExceptionرا برمیگرداند برطرف شد (Id1f16، b/381024738) - اشکالی که باعث میشد ورقزن نتواند هنگام بازآوری درحین پیمایش بارگیریهای بیشتری را راهاندازی کند برطرف شد. (I60ca5، b/352586078)
- مشکل ازکارافتادن هنگام پیمایش درحین بازآوری موارد «صفحهبندی» برطرف شد. (I8c65a، b/347649763)
نسخه ۳.۳
نسخه ۳.۳.۶
۱۲ فوریه ۲۰۲۵
androidx.paging:paging-*:3.3.6 منتشر شده است. نسخه ۳.۳.۶ حاوی این ثبتها است.
رفع اشکالها
- سیگنالهای بازآوری و تکرار ارسالشده درطول بازآوری اولیه اکنون ذخیره میشوند و بهمحض آماده شدن ارائهدهنده صفحهبندی، بهطور خودکار دوباره ارسال میشوند.
همیاری خارجی
نسخه ۳.۳.۵
۱۱ دسامبر ۲۰۲۴
androidx.paging:paging-*:3.3.5 منتشر شده است. نسخه ۳.۳.۵ حاوی این ثبتها است.
رفع اشکالها
- اشکالی که باعث میشد وقتی کاربر درحال بهروزرسانی
RecyclerViewپیمایش میکند،RecyclerViewخطایIndexOutOfBoundsExceptionرا نشان دهد برطرف شد. (Id1f16، b/381024738)
نسخه ۳.۳.۴
۱۳ نوامبر ۲۰۲۴
androidx.paging:paging-*:3.3.4 منتشر شده است. نسخه ۳.۳.۴ حاوی این ارسالها است.
رفع اشکالها
- آزمایشهای واحد Android که از Paging نسخه ۳.۳ یا بالاتر استفاده میکنند دیگر خطایی مانند
Method isLoggable in android.util.Log not mockedرا نشان نخواهند داد. (Ia9400، b/331684448)
نسخه ۳.۳.۲
۷ اوت ۲۰۲۴
androidx.paging:paging-*:3.3.2 منتشر شده است. نسخه ۳.۳.۲ حاوی این ثبتها است.
ویژگیهای جدید
-
paging-commonوpaging-testingهدفهای Kotlin-Multiplatform جدیدی اضافه کردهاند:watchos،tvos، وlinuxArm64(90c9768)، (53e0eca)
نسخه ۳.۳.۱
۲۴ ژوئیه ۲۰۲۴
androidx.paging:paging-*:3.3.1 منتشر شده است. نسخه ۳.۳.۱ حاوی این ثبتها است.
رفع اشکالها
- مشکلی برطرف شد که در آن
AsyncPagingDataDifferیا میاناهای برنامهسازی کاربردی ساختهشده روی آن، مانندPagingDataAdapterمورداستفاده باRecyclerView، نمیتوانستند هنگام پیمایش و بازآوری منبع داده پشتیبان، بارگیریهای بیشتری را راهاندازی کنند. (I60ca5، b/352586078) - رفع خرابیای که هنگام برداشتن موارد از منبع داده پشتیبان درحین پیمایش
RecyclerViewبااستفاده ازPagingDataAdapterیاAsyncPagingDataDifferرخ میدهد. (I8c65a، b/347649763)
نسخه ۳.۳.۰
۱۴ مه ۲۰۲۴
androidx.paging:paging-*:3.3.0 منتشر شده است. نسخه ۳.۳.۰ حاوی این ثبتها است.
تغییرات مهم از نسخه ۳.۲.۰
PagingDataPresenterاکنون کلاس عمومی است. اکنون میتوان ارائهدهندههای چندپلاتفرمی را بهجای نیاز به میاناهای برنامهسازی کاربردی صفحهبندی داخلی یاAsyncPagingDataDifferpaging-runtime، رویPagingDataPresenterساخت.- روشهای کمکی جدید
LoadStatesوCombinedLoadStatesدرhasErrorوisIdleاضافه شد تا بررسی شود که آیاLoadStatesبهترتیب در وضعیت «خطا» یاNotLoadingاست یا نه. همچنین روش افزونه Kotlin جدیدیawaitNotLoading()درFlow<CombinedLoadStates>اضافه شده است که تا زمانی که بارگذاری در حالتNotLoadingیا «خطا» قرار گیرد منتظر میماند. PagingData.empty()اکنون بهطور پیشفرض حالتهایNotLoadingرا ارسال میکند، مگراینکهLoadStatesسفارشی به سازنده آن ارسال شود. این با رفتار موجود متفاوت است که در آن وقتی بهPagingDataAdapterارسال میشود،LoadStatesرا ارسال نمیکند یا وقتی بهعنوانLazyPagingItemsجمعآوری میشود، حالتهای «درحال بار کردن» را ارسال میکند. وقتی بهعنوانLazyPagingItemsجمعآوری میشود، اکنون بلافاصله پساز ترکیببندی اولیه، فهرست خالی را نیز نمایش میدهد.
سازگاری Kotlin Multiplatform
اکنون Paging دستساختههای سازگار با Kotlin Multiplatform را ارائه میدهد که بخش عمده آن بهلطف کار بالادستی پروژه multiplatform-paging CashApp است.
-
paging-commonهمه میاناهای برنامهسازی کاربردی Paging 3 را بهcommonمنتقل کرده است و اکنون علاوهبر Android با jvm و iOS نیز سازگار است. paging-testingکد خود را بهcommonمنتقل کرده است و اکنون علاوهبر Android، با jvm و iOS نیز سازگار است.-
paging-composeکد خود را بهcommonمنتقل کرده است و یک آرتیفکت Android ارائه میدهد که با پشتیبانی چندپلاتفرمیandroidx.composeمطابقت دارد. -
paging-runtime،paging-guava،paging-rxjava2، وpaging-rxjava3فقط برای Android باقی خواهند ماند.
نسخه 3.3.0-rc01
۱ مه ۲۰۲۴
androidx.paging:paging-*:3.3.0-rc01 بدون تغییر در Paging 3.3.0-beta01 منتشر شده است. نسخه 3.3.0-rc01 حاوی این ارسالها است.
نسخه 3.3.0-beta01
۳ آوریل ۲۰۲۴
androidx.paging:paging-*:3.3.0-beta01 بدون تغییرات قابلتوجهی منتشر شده است. نسخه 3.3.0-beta01 حاوی این ارسالها است.
نسخه 3.3.0-alpha05
۲۰ مارس ۲۰۲۴
androidx.paging:paging-*:3.3.0-alpha05 منتشر شده است. نسخه 3.3.0-alpha05 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
- صفحهبندی اکنون از حاشیهنویسی AndroidX Annotation
@MainThreadبرای کد مشترک استفاده میکند. (I78f0d، b/327682438)
نسخه 3.3.0-alpha04
۶ مارس ۲۰۲۴
androidx.paging:paging-*:3.3.0-alpha04 منتشر شده است. نسخه 3.3.0-alpha04 حاوی این ارسالها است.
رفع اشکالها
- خطاهای جزئی مستندات مربوط به افزودن سازگاری چندپلتفرمی Kotlin برطرف شد. (aosp/2950785)
نسخه 3.3.0-alpha03
۷ فوریه ۲۰۲۴
androidx.paging:paging-*:3.3.0-alpha03 منتشر شده است. نسخه 3.3.0-alpha03 حاوی این commitها است.
ویژگیهای جدید
PagingDataPresenterاکنون کلاس عمومی است. اکنون میتوان ارائهدهندههای چندپلاتفرمی را بهجای نیاز به میاناهای برنامهسازی کاربردی صفحهبندی داخلی یاAsyncPagingDataDifferpaging-runtime، رویPagingDataPresenterساخت. (Id1f74، b/315214786)- روشهای کمکی جدید
LoadStatesوCombinedLoadStatesبرای بررسی اینکه آیاLoadStatesدر وضعیت «خطا» یاNotLoadingاست اضافه شد. همچنین میانای برنامهسازی کاربردی جدیدی اضافه شده است که درLoadStateFlowمنتظر میماند تا بارگیری در حالتNotLoadingیا «خطا» قرار گیرد. (Id6c67)
تغییر رفتار
PagingData.empty()اکنون بهطور پیشفرض حالتهایNotLoadingرا ارسال میکند، مگراینکهLoadStatesسفارشی به سازنده آن ارسال شود. این با رفتار موجود متفاوت است که در آن وقتی بهPagingDataAdapterارسال میشود،LoadStatesرا ارسال نمیکند یا وقتی بهعنوانLazyPagingItemsجمعآوری میشود، حالتهای «درحال بار کردن» را ارسال میکند. وقتی بهعنوانLazyPagingItemsجمعآوری میشود، اکنون بلافاصله پساز ترکیببندی اولیه، فهرست خالی را نیز نمایش میدهد. (I4d11d، b/301833847)
نسخه 3.3.0-alpha02
۲۰ سپتامبر ۲۰۲۳
androidx.paging:paging-*:3.3.0-alpha02 منتشر شده است. نسخه 3.3.0-alpha02 حاوی این ارسالها است.
سازگاری Kotlin Multiplatform
اکنون Paging مصنوعات سازگار با Kotlin Multiplatform را ارائه میدهد که بخش عمدهای از آن بهدلیل کار بالادستی پروژه multiplatform-paging CashApp است. این کار به ما کمک میکند از واگرایی بین دو مخزن جلوگیری کنیم و آنها را سازگار نگه داریم.
-
paging-commonهمه میاناهای برنامهسازی کاربردی Paging 3 را بهcommonمنتقل کرده است و اکنون علاوهبر Android با jvm و iOS نیز سازگار است. paging-testingکد خود را بهcommonمنتقل کرده است و اکنون علاوهبر Android، با jvm و iOS نیز سازگار است.-
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
۲۰ سپتامبر ۲۰۲۳
- این اولین نسخه چندپلتفرمی از کتابخانههای androidx.paging است. این نسخه فقط آرتیفکتهای
*-jvmو*-androidرا دارد. برای انواع macOS، iOS، و linux، از3.3.0-alpha02استفاده کنید.
نسخه ۳.۲
نسخه ۳.۲.۱
۶ سپتامبر ۲۰۲۳
androidx.paging:paging-*:3.2.1 منتشر شده است. نسخه ۳.۲.۱ حاوی این ثبتها است.
رفع اشکالها
- مشکلی برطرف شد که در آن،
asSnapshot()API از مصنوع Paging Testing هنگام ارسال Flow ساختهشده بااستفاده ازPagingData.from(List)متوقف میشد، زیراasSnapshot()هیچ اطلاعاتی درباره زمان پایان بارگیری نداشت (برخلاف سربارگذاریPagingData.from(List, LoadStates)). این راهکار فقط برای «جریانهای» تکمیلشدنی (مثلاًflowOf(PagingData.from(...))) کار میکند. برای «جریانهای» تکمیلنشدنی (مثلاًMutableStateFlow)، از سربارگذاریPagingData.fromکهLoadStatesرا ارائه میدهد استفاده کنید. (I502c3) - Paging Compose اکنون بهطور داخلی از
AndroidUiDispatcher.Mainاستفاده میکند تا مطمئن شود دادههای جدید در همان قاب تکمیل بارگیری دردسترس است. (Ia55af)
نسخه ۳.۲.۰
۲۶ ژوئیه ۲۰۲۳
androidx.paging:paging-*:3.2.0 منتشر شده است. نسخه ۳.۲.۰ حاوی این ثبتها است.
تغییرات مهم از نسخه ۳.۱.۰
- Paging Compose به پایداری API رسید و دوباره با بقیه Paging ادغام شد، جایی که نسخه آن اکنون با سایر مصنوعات Paging مطابقت دارد. تغییرات از نسخه ۳.۱.۰ شامل موارد زیر است:
- پشتیبانی از پیشنمایش فهرست دادههای جعلی با ایجاد
PagingData.from(fakeData)و قرار دادن آنPagingDataدرMutableStateFlow(مثلاًMutableStateFlow(PagingData.from(listOf(1, 2, 3)))). این جریان را به@Previewcomposables بهعنوان گیرنده برای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که میتواند در آزمایشها به «ورقزن» منتقل شود asSnapshotافزونه Kotlin درFlow<PagingData<Value>>، کهFlow<PagingData<Value>>را بهList<Value>مستقیم ترجمه میکند.asSnapshot lambdaبه شما امکان میدهد میانای کاربر برنامهتان را ازطریق میاناهای برنامهسازی کاربردی مثلscrollToیاappendScrollWhileتقلید کنید تا بتوانید درستی عکس آنی دادهها را در هر نقطهای از مجموعه دادههای صفحهبندیشدهتان تأیید کنید.
- گزارشهای پیشفرض برای نمایش اطلاعات اشکالزدایی «صفحهبندی» در دو سطح اضافه شد:
VERBOSEوDEBUG. گزارشها را میتوان ازطریق فرمانadb shell setprop log.tag.Paging [DEBUG|VERBOSE]فعال کرد. این موضوع هم برای «صفحهبندی با نماها» و هم برای «صفحهبندی با Compose» صدق میکند. - سازندههایی برای
PagingDataAdapterوAsyncPagingDataDifferاضافه شده است کهCoroutineContextرا بهجایCoroutineDispatcherمیپذیرند. - میانای کاربردی
PagingSourceFactoryجدیدی اضافه شده است که سطح میانای برنامهسازی کاربردی صریحتری نسبتبه لامبداهای () ->PagingSourceقبلی ارائه میدهد. This factory can be used to instantiate a Pager.
نسخه 3.2.0-rc01
۲۱ ژوئن ۲۰۲۳
androidx.paging:paging-*:3.2.0-rc01 منتشر شده است. نسخه 3.2.0-rc01 حاوی این commitها است.
همیاری خارجی
نسخه 3.2.0-beta01
۷ ژوئن ۲۰۲۳
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
۲۴ مه ۲۰۲۳
androidx.paging:paging-*:3.2.0-alpha06 منتشر شده است. نسخه 3.2.0-alpha06 شامل این commit-ها است.
ویژگیهای جدید
- میانای کاربردی جدید
PagingSourceFactoryاضافه شد که سطح API صریحتری نسبتبه لامبداهای() -> PagingSourceموجود ارائه میدهد. از این کارخانه میتوان برای نمونهسازیPagerاستفاده کرد. (I33165، b/280655188) paging-testingمیانای برنامهسازی کاربردی جدیدList<Value>.asPagingSourceFactory()اضافه شد تاPagingSourceFactoryدریافت شود که فقط از فهرست تغییرناپذیر دادهها بار میشود. افزونه موجود درFlow<List<Value>>همچنان باید برای آزمایش با چندین نسل از دادههای ایستا استفاده شود. (Id34d1، b/280655188)
تغییرات میانای برنامهسازی کاربردی
- اکنون همه میاناهای برنامهسازی کاربردی عمومی در paging-testing با
@VisibleForTestingحاشیهنویسی شدهاند تا اطمینان حاصل شود که این میاناهای برنامهسازی کاربردی فقط در آزمایشها استفاده میشوند. (I7db6e) asSnapshotAPI دیگر نیازی به ارسالCoroutineScopeندارد. اکنون بهطور پیشفرض از بافت بهارثرسیده از دامنه ولی خود استفاده میکند. (Id0a78، b/282240990)- پارامترهای سازنده
TestPagerدوباره مرتب شدند تا بهطور شهودی با ترتیب پارامترهای سازنده واقعیPagerمطابقت داشته باشند (I6185a) - Migrated paging-testing's use of lambda type
() -> PagingSource<Key, Value>to typePagingSourceFactory<Key, Value>. (I4a950، b/280655188)
تغییرات رفتار
- دیگر برای اجرای آزمایشهای صفحهبندی
asSnapshotبه توزیعکننده اصلی نیاز نیست. تنظیم آن دیگر تغییری در رفتار آزمایش ایجاد نمیکند. (Ie56ea)
نسخه 3.2.0-alpha05
۳ مه ۲۰۲۳
androidx.paging:paging-*:3.2.0-alpha05 منتشر شده است. نسخه 3.2.0-alpha05 حاوی این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
- اکنون پارامتر
loadOperationsدر Paging Testing API مربوط بهasSnapshotبهطور پیشفرض روی لامبدا خالی تنظیم شده است. این کار امکان فراخوانی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
۸ فوریه ۲۰۲۳
androidx.paging:paging-*:3.2.0-alpha04 منتشر شده است. نسخه 3.2.0-alpha04 حاوی این ارسالها است.
آزمایش صفحهبندی
- اکنون خروجی ساختاریافته
paging-testingحاوی روشasPagingSourceFactoryبرای ایجادpagingSourceFactoryازFlow<List<Value>>است تا به «ورقزن» ارائه شود. هر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>مستقیم ترجمه میکند.asSnapshotlambda به شما امکان میدهد میانای کاربر برنامهتان را ازطریق میاناهای برنامهسازی کاربردی مثل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
۲۴ اکتبر ۲۰۲۲
androidx.paging:paging-*:3.2.0-alpha03 منتشر شده است. نسخه 3.2.0-alpha03 حاوی این commitها است.
آزمایش صفحهبندی
این نسخه پخش حاوی خروجی ساختاریافته جدیدی است: paging-testing. این آرتیفکت میاناهای برنامهسازی کاربردیای ارائه میدهد که برای آزمایش واحد هر لایه از برنامه شما و ادغام آن با «صفحهبندی» بهصورت مجزا طراحی شدهاند.
برای مثال، این نسخه اولیه شامل کلاس TestPager است که به شما امکان میدهد رفتار پیادهسازی سفارشی PagingSource خود را مستقل از Pager و میانای کاربر واقعی که معمولاً برای شبیهسازی ادغام «صفحهبندی» سرتاسری نیاز دارید، اعتبارسنجی کنید.
TestPager باید بهعنوان یک جعلی درنظر گرفته شود - یک بدل آزمایشی که پیادهسازی واقعی Pager را منعکس میکند و درعینحال یک سطح API سادهشده برای آزمایش PagingSource ارائه میدهد. این میاناهای برنامهسازی کاربردی، میاناهای برنامهسازی کاربردی suspend هستند و باید در runTest اجرا شوند، همانطور که در راهنمای آزمایش کردن روالهای مشترک Kotlin در Android توضیح داده شده است.
نمونهای از این میاناهای برنامهسازی کاربردی درحال استفاده را میتوانید در room-paging آزمایشها پیدا کنید که برای استفاده از TestPager بازسازی کد شدهاند.
تغییرات میانای برنامهسازی کاربردی
- تکرار راحت را ازطریق
LoadResult.Page.dataتاLoadResult.Page.iterator()فعال میکند. این کار بهطور غیرمستقیم اجازه میدهد از روش کتابخانه استاندارد Kotlinflattenهنگام ارائهList<LoadResult.Page>استفاده شود، مثلاً با ویژگیpagesازPagingStateکه به روشPagingSource.getRefreshKeyمنتقل میشود. (Ie0718)
نسخه 3.2.0-alpha02
۱۰ اوت ۲۰۲۲
androidx.paging:paging-*:3.2.0-alpha02 منتشر شده است. نسخه 3.2.0-alpha02 حاوی این ارسالها است.
ویژگیهای جدید
- اکنون «صفحهبندی» گزارشها را ازطریق کلاسهای
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
۱ ژوئن ۲۰۲۲
androidx.paging:paging-*:3.2.0-alpha01 منتشر شده است. نسخه 3.2.0-alpha01 حاوی این commitها است.
تغییرات میانای برنامهسازی کاربردی
- سازندههایی برای
PagingDataAdapterوAsyncPagingDataDifferاضافه شده است کهCoroutineContextرا بهجایCoroutineDispatcherمیپذیرند. (Idc878) - بهطور پیشفرض،
PagingData.from()وPagingData.empty()دیگر رویCombinedLoadStatesدر سمت ارائهدهنده تأثیر نخواهند گذاشت. یک سربارگذاری جدید که امکان ارسالsourceLoadStatesوremoteLoadStatesبه این سازندهها را فراهم میکند، اضافه شده است تا رفتار موجود تنظیمLoadStatesبرای کاملاً پایانی بودن (یعنی،NotLoading(endOfPaginationReached = false))، با این گزینه که درصورت نیاز، وضعیتهای ازراهدور را نیز اضافه کنید. اگرLoadStatesارسال نشود،CombinedLoadStatesقبلی در سمت ارائهدهنده حفظ خواهد شد وقتیPagingDataثابت را دریافت کند. (Ic3ce5، b/205344028)
رفع اشکالها
- اکنون در مواردی که مقدار تهی برمیگرداند، اما
initialKeyغیرتهی تنظیم شده است، نتیجهPagingSource.getRefreshKey()بهدرستی برinitialKeyاولویت داده میشود. (Ic9542، b/230391606)
همیاری خارجی
- Updated :compose:ui:ui-test api (updateApi) due to test-coroutines-lib migration (I3366d)
نسخه ۳.۱
نسخه ۳.۱.۱
۹ مارس ۲۰۲۲
androidx.paging:paging-*:3.1.1 منتشر شده است. نسخه ۳.۱.۱ حاوی این ثبتها است.
رفع اشکالها
- رویدادهای واسطه
LoadState.NotLoadingبین نسلها که بهاشتباه توسط.cachedIn()درج شده بود برداشته شد. این تغییر با حذف رویدادهایLoadState.NotLoadingزائد که بین تلاش مجدد برای بارگیریهای ناموفق، هنگام بازآوری، یا درطول نامعتبرسازی ایجاد میشدند، واکنش نشان دادن به تغییراتLoadStateرا بسیار آسانتر میکند.
نسخه ۳.۱.۰
۱۷ نوامبر ۲۰۲۱
androidx.paging:paging-*:3.1.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اضافه شده است که باعث میشود «صفحهبندی» هرگونه درخواست بارگیری معلقه یا آتی به اینPagingSourceرا نادیده بگیرد و آن را نامعتبر کند. این نوع پاسخ برای مدیریت دادههای بالقوه نامعتبر یا قدیمی که ممکن است از پایگاه داده یا شبکه برگردانده شوند طراحی شده است. - میاناهای برنامهسازی کاربردی ارائهدهنده
.onPagesPresentedو.addOnPagesUpdatedListenerاضافه شد که بهطور همزمان با ارائه صفحهها در میانای کاربر راهاندازی میشوند. بهروزرسانیهای صفحه میتواند در سناریوهای زیر اتفاق بیفتد:- بارگیری اولیه نسل جدیدی از PagingData تکمیل میشود، صرفنظر از اینکه نسل جدید حاوی تغییراتی در موارد ارائهشده باشد یا نه. یعنی، نسل جدیدی که بارگیری اولیه را بدون بهروزرسانی تکمیل میکند، چون فهرست دقیقاً یکسان است، همچنان این فراخوانی برگشتی را راهاندازی خواهد کرد.
- صفحهای درج میشود، حتی اگر صفحه درجشده حاوی هیچ مورد جدیدی نباشد.
- صفحهای رها شود، حتی اگر صفحه رهاشده خالی باشد.
نسخه 3.1.0-rc01
۳ نوامبر ۲۰۲۱
androidx.paging:paging-*:3.1.0-rc01 منتشر شده است. نسخه 3.1.0-rc01 شامل این commitها است.
رفع اشکالها
- شرایط رقابتی + نشت حافظه در .cachedIn() در مواردی که چندین رویداد بارگیری توسط Paging downstream ارسال میشد درحالیکه هیچ ناظری وجود نداشت یا بین زمانی که ناظر درحال جابهجایی به PagingData جدید بود برطرف شد. (Ib682e)
نسخه 3.1.0-beta01
۱۳ اکتبر ۲۰۲۱
androidx.paging:paging-*:3.1.0-beta01 منتشر شده است. نسخه 3.1.0-beta01 شامل این کدهای ثبتشده است.
رفع اشکالها
- مشکلی برطرف شد که در آن دسترسیهای سریع متعدد به موارد میتوانست باعث شود که آنها برای بررسی در prefetchDistance حذف شوند و بارگیری صفحه متوقف شود. این مشکل بهویژه زمانی رخ میدهد که موارد زیادی بهطور همزمان در ترتیبی چیده شده باشند که بارگیری را برخلاف جهت پیمایش کاربر اولویتبندی کند. این دسترسیهای مورد اکنون بافر شدهاند و بهطور همزمان اولویتبندی شدهاند تا از حذف شدن آنها جلوگیری شود. (aosp/1833273)
نسخه 3.1.0-alpha04
۲۹ سپتامبر ۲۰۲۱
androidx.paging:paging-*:3.1.0-alpha04 منتشر شده است. نسخه 3.1.0-alpha04 حاوی این commitها است.
تغییرات میانای برنامهسازی کاربردی
- میاناهای برنامهسازی کاربردی
Flow<PagingData>.observableوFlow<PagingData>.flowableدیگر آزمایشی نیستند. (Ie0bdd)
رفع اشکالها
- برای LoadStates،
endOfPaginationReachedاکنون همیشهfalseاست برایLoadType.REFRESH. قبلاً ممکن بود endOfPaginationReached برای RemoteMediatorREFRESHtrueباشد، اما نه برای 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
۲۱ ژوئیه ۲۰۲۱
androidx.paging:paging-*:3.1.0-alpha03 منتشر شده است. نسخه 3.1.0-alpha03 حاوی این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
نوع پاسخ LoadResult سوم LoadResult.Invalid به PagingSource اضافه شده است. وقتی PagingSource.load مقدار LoadResult.Invalid را برمیگرداند، صفحهبندی دادههای بارشده را دور میاندازد و PagingSource را نامعتبر میکند. این نوع پاسخ برای رسیدگی به دادههای بالقوه نامعتبر یا قدیمی که ممکن است از پایگاه داده یا شبکه برگردانده شوند طراحی شده است.
برای مثال، اگر پایگاه داده زیربنایی نوشته شود اما PagingSource بهموقع نامعتبر نشود، ممکن است نتایج ناسازگاری برگرداند اگر پیادهسازی آن به تغییرناپذیری مجموعه داده پشتیبان که از آن بارگیری میکند بستگی داشته باشد (مثلاً، پیادهسازیهای پایگاه داده به سبک LIMIT OFFSET). در این سناریو، توصیه میشود که پساز بار کردن، نامعتبر بودن را بررسی کنید و LoadResult.Invalid را برگردانید که باعث میشود Paging هرگونه درخواست بار کردن معلق یا آتی را برای این PagingSource نادیده بگیرد و آن را نامعتبر کند.
این نوع پاسخ توسط میانای برنامهسازی کاربردی Paging2 که از LivePagedList یا RxPagedList بهره میبرد نیز پشتیبانی میشود. When using a PagingSource with Paging2's PagedList APIs, the PagedList is immediately detached, stopping further attempts to load data on this PagedList and triggers invalidation on the PagingSource.
LoadResult یک کلاس مهرومومشده است، به این معنی که این یک تغییر ناسازگار با منبع است بهطوریکه موارد استفادهای که مستقیماً از نتایج PagingSource.load استفاده میکنند باید LoadResult.Invalid را در زمان ترجمه مدیریت کنند. برای مثال، کاربران Kotlin که از exhaustive-when برای بررسی نوع پاسخ استفاده میکنند باید بررسی نوع «نامعتبر» را اضافه کنند. (Id6bd3، b/191806126، b/192013267)
رفع اشکالها
- فراخوانهای برگشتی باطلسازی که ازطریق PagingSource.registerInvalidatedCallback یا DataSource.addInvalidatedCallback اضافه شدهاند، اکنون اگر در PagingSource / DataSource که قبلاً باطل شده است ثبت شده باشند، بهطور خودکار راهاندازی میشوند. این کار شرایط رقابتی را که باعث میشد «صفحهبندی» سیگنالهای نامعتبرسازی را رها کند و هنگام ارائه «منبعی» که قبلاً درطول بارگیری اولیه نامعتبر بود گیر کند، برطرف میکند. بهعلاوه، فراخوانیهای برگشتی نامعتبر اکنون پساز فعال شدن بهدرستی برداشته میشوند زیرا تضمین میشود که حداکثر یک بار فراخوانی شوند. (I27e69)
- ارسال مقدار اولیه جایبان (InitialPagedList) از یک جریان PagedList تازه نمونهسازیشده، مانند LivePagedListBuilder یا RxPagedListBuilder، دیگر دادههای بارگذاریشده قبلی را پاک نخواهد کرد.
نسخه 3.1.0-alpha02
۱ ژوئیه ۲۰۲۱
androidx.paging:paging-*:3.1.0-alpha02 منتشر شده است. نسخه 3.1.0-alpha02 حاوی این commitها است.
ویژگیهای جدید
میانای برنامهسازی کاربردی شنونده onPagesPresented و ارائهدهنده جریان اضافه شد که بلافاصله پساز بهروزرسانی صفحههای ارائهشده در میانای کاربر فعال میشود.
ازآنجاییکه این بهروزرسانیها با میانای کاربر همگام هستند، میتوانید روشهای آداپتور مانند snapshot.، getItemCount. را برای بررسی وضعیت پساز اعمال بهروزرسانی فراخوانی کنید. توجه داشته باشید که .snapshot() برای فراخوانی صریح باقی مانده است زیرا انجام آن در هر بهروزرسانی میتواند پرهزینه باشد.
بهروزرسانیهای صفحه میتواند در سناریوهای زیر اتفاق بیفتد:
- بارگیری اولیه نسل جدیدی از PagingData تکمیل میشود، صرفنظر از اینکه نسل جدید حاوی تغییراتی در موارد ارائهشده باشد یا نه. یعنی، نسل جدیدی که بارگیری اولیه را تکمیل میکند بدون هیچ بهروزرسانی، چون فهرست دقیقاً یکسان است، همچنان این فراخوانی برگشتی را راهاندازی میکند.
- صفحهای درج میشود، حتی اگر صفحه درجشده حاوی هیچ مورد جدیدی نباشد
- صفحهای رها شده است، حتی اگر صفحه رهاشده خالی بوده باشد (I272c9، b/189999634)
رفع اشکالها
- دسترسی به PagedList.dataSource از مقدار اولیه تولیدشده توسط LivePagedList یا RxPagedList دیگر بهاشتباه IllegalStateException را ایجاد نمیکند (I96707)
نسخه 3.1.0-alpha01
۲ ژوئن ۲۰۲۱
androidx.paging:paging-*:3.1.0-alpha01 منتشر شده است. نسخه 3.1.0-alpha01 حاوی این commitها است.
تغییرات میانای برنامهسازی کاربردی
- کلاسهای ارائهشده توسط
paging-rxjava3اکنون تحت بستهandroidx.paging.rxjava3قرار دارند تا باpaging-rxjava2تداخل نداشته باشند (Ifa7f6)
رفع اشکالها
- مشکلی برطرف شد که در آن «صفحهبندی» گاهی اوقات رویدادهای differ بدون عملیات را به RecyclerView ارسال میکرد، که میتوانست باعث شود برخی شنوندگان زودتر فعال شوند. (Ic507f, b/182510751)
همیاری خارجی
- Added deprecated PagedList compat APIs to rxjava3 artifact (Id1ce2, b/182497591)
Paging Compose نسخه ۱.۰.۰
نسخه 1.0.0-alpha20
۲۴ مه ۲۰۲۳
androidx.paging:paging-compose:1.0.0-alpha20 منتشر شده است. نسخه 1.0.0-alpha20 حاوی این commit-ها است.
ویژگیهای جدید
- اکنون 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
۳ مه ۲۰۲۳
androidx.paging:paging-compose:1.0.0-alpha19 منتشر شده است. نسخه 1.0.0-alpha19 حاوی این commit-ها است.
پشتیبانی از همه چیدمانهای تنبل
قبلاً، Paging Compose افزونههای سفارشی items و itemsIndexed را در LazyListScope ارائه میکرد، به این معنی که نمیتوانستید از Paging Compose با سایر چیدمانهای تنبل مانند LazyVerticalGrid، HorizontalPager، یا سایر مؤلفههای تنبل سفارشی ارائهشده توسط کتابخانههای Wear و TV استفاده کنید. رسیدگی به این عدم انعطافپذیری بهروزرسانی اصلی این نسخه است.
برای پشتیبانی از چیدمانهای تنبل بیشتر، لازم بود میاناهای برنامهسازی کاربردی را در لایه متفاوتی بسازیم - بهجای ارائه میانای برنامهسازی کاربردی 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 وابستگی خود را از Compose 1.0.5 به Compose 1.2.1 بهروز کرده است. (Ib1918، b/255283378)
نسخه 1.0.0-alpha18
۸ فوریه ۲۰۲۳
androidx.paging:paging-compose:1.0.0-alpha18 بدون تغییر منتشر شد. نسخه 1.0.0-alpha18 شامل این commit-ها است.
نسخه 1.0.0-alpha17
۲۴ اکتبر ۲۰۲۲
androidx.paging:paging-compose:1.0.0-alpha17 منتشر شده است. نسخه 1.0.0-alpha17 حاوی این commit-ها است.
ویژگیهای جدید
- افزودن پشتیبانی برای
CoroutineContextسفارشی هنگام تماس باcollectLazyPagingItems. (I7a574، b/243182795، b/233783862)
نسخه 1.0.0-alpha16
۱۰ اوت ۲۰۲۲
androidx.paging:paging-compose:1.0.0-alpha16 منتشر شده است. نسخه 1.0.0-alpha16 حاوی این ارسالها است.
ویژگیهای جدید
- اکنون «صفحهبندی» گزارشها را ازطریق کلاس
LazyPagingItemsارائه میدهد تا اطلاعات اشکالزدایی جمعآوریشده از PagingData را نمایش دهد. - گزارشها را میتوان ازطریق فرمان
adb shelladb shell setprop log.tag.Paging [DEBUG|VERBOSE]فعال کرد. ([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
۱ ژوئن ۲۰۲۲
androidx.paging:paging-compose:1.0.0-alpha15 منتشر شده است. نسخه 1.0.0-alpha15 حاوی این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
- سازندههایی برای
PagingDataAdapterوAsyncPagingDataDifferاضافه شده است کهCoroutineContextرا بهجایCoroutineDispatcherمیپذیرند. (Idc878)
رفع اشکالها
-
LazyPagingItemsاکنونloadStateاولیه را برای بازآوریLoadState.Loadingتنظیم میکند. (I55043، b/224855902)
نسخه 1.0.0-alpha14
۱۳ اکتبر ۲۰۲۱
androidx.paging:paging-compose:1.0.0-alpha14 منتشر شده است. نسخه 1.0.0-alpha14 شامل این commit-ها است.
نسخه 1.0.0-alpha13
۲۹ سپتامبر ۲۰۲۱
androidx.paging:paging-compose:1.0.0-alpha13 منتشر شده است. نسخه 1.0.0-alpha13 حاوی این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
- تابع
LazyPagingItems.snapshot()با ویژگیLazyPagingItems.itemSnapshotListجایگزین شد (Ie2da8) -
LazyPagingItems.getAsState()منسوخشده برداشته شد (Ie65e4)
نسخه 1.0.0-alpha12
۲۱ ژوئیه ۲۰۲۱
androidx.paging:paging-compose:1.0.0-alpha12 منتشر شده است. نسخه 1.0.0-alpha12 حاوی این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
items(lazyPagingItems)وitemsIndexed(lazyPagingItems)که برای اتصال «صفحهبندی» باLazyColumn/Rowاستفاده میشوند اکنون پارامتر کلید گزینه را میپذیرند که به شما امکان میدهد کلید پایداری را که نشاندهنده مورد است مشخص کنید. در اینجا میتوانید درباره کلیدها بیشتر بخوانید. (I7986d)- تابع
lazyPagingItems.getAsState(index)اکنون منسوخ شده است. درعوض ازlazyPagingItems[index]استفاده کنید. (I086cb، b/187339372)
نسخه 1.0.0-alpha11
۳۰ ژوئن ۲۰۲۱
androidx.paging:paging-compose:1.0.0-alpha11 منتشر شده است. نسخه 1.0.0-alpha11 حاوی این commit-ها است.
نسخه 1.0.0-alpha10
۲ ژوئن ۲۰۲۱
androidx.paging:paging-compose:1.0.0-alpha10 منتشر شده است. نسخه 1.0.0-alpha10 حاوی این commit-ها است.
نسخه 1.0.0-alpha09
۱۸ مه ۲۰۲۱
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فقط با Compose نسخه1.0.0-beta07و بالاتر سازگار است.
نسخه 1.0.0-alpha08
۲۴ فوریه ۲۰۲۱
androidx.paging:paging-compose:1.0.0-alpha08 منتشر شده است. نسخه 1.0.0-alpha08 حاوی این commit-ها است.
بهروزرسانیشده برای ادغام با Compose 1.0.0-beta01.
نسخه 1.0.0-alpha07
۱۰ فوریه ۲۰۲۱
androidx.paging:paging-compose:1.0.0-alpha07 منتشر شده است. نسخه 1.0.0-alpha07 شامل این ارسالها است.
برای ادغام با Compose alpha12 بهروز شد.
نسخه 1.0.0-alpha06
۲۸ ژانویه ۲۰۲۱
androidx.paging:paging-compose:1.0.0-alpha06 منتشر شده است. نسخه 1.0.0-alpha06 حاوی این commit-ها است.
رفع اشکالها
بهروزرسانی شد تا به Compose 1.0.0-alpha11 وابسته باشد.
نسخه 1.0.0-alpha05
۱۳ ژانویه ۲۰۲۱
androidx.paging:paging-compose:1.0.0-alpha05 منتشر شده است. نسخه 1.0.0-alpha05 شامل این commit-ها است.
بهروزرسانی شد تا به Compose 1.0.0-alpha10 وابسته باشد.
نسخه 1.0.0-alpha04
۱۶ دسامبر ۲۰۲۰
androidx.paging:paging-compose:1.0.0-alpha04 منتشر شده است. نسخه 1.0.0-alpha04 حاوی این commit-ها است.
رفع اشکالها
- Updated the convenience properties,
CombinedLoadStates.refresh,CombinedLoadStates.prepend,CombinedLoadStates.appendto only transition fromLoadingtoNotLoadingafter both mediator and source load states areNotLoadingto ensure the remote update has been applied. (I65619)
نسخه 1.0.0-alpha03
۲ دسامبر ۲۰۲۰
androidx.paging:paging-compose:1.0.0-alpha03 منتشر شده است. نسخه 1.0.0-alpha03 حاوی این commit-ها است.
- Updated to match Compose 1.0.0-alpha08.
نسخه 1.0.0-alpha02
۱۱ نوامبر ۲۰۲۰
androidx.paging:paging-compose:1.0.0-alpha02 منتشر شده است. نسخه 1.0.0-alpha02 حاوی این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
- روشهای
.peek()،.snapshot()،.retry()، و.refresh()بهLazyPagingItemاضافه شد که همان عملکرد موجود درAsyncPagingDataDiffer/PagingDataAdapterرا نشان میدهد (Iddfe8، b/172041660)
نسخه 1.0.0-alpha01
۲۸ اکتبر ۲۰۲۰
androidx.paging:paging-compose:1.0.0-alpha01 منتشر شده است. نسخه 1.0.0-alpha01 حاوی این commit-ها است.
ویژگیهای جدید
ساخته paging-compose یکپارچهسازی بین کتابخانه صفحهبندی و Jetpack Compose را فراهم میکند. نمونه استفاده ساده:
@Composable
@OptIn(ExperimentalLazyDsl::class)
fun ItemsDemo(flow: Flow<PagingData<String>>) {
val lazyPagingItems = flow.collectAsLazyPagingItems()
LazyColumn {
items(lazyPagingItems) {
Text("Item is $it")
}
}
}
نسخه ۳.۰.۱
نسخه ۳.۰.۱
۲۱ ژوئیه ۲۰۲۱
androidx.paging:paging-*:3.0.1 منتشر شده است. نسخه ۳.۰.۱ حاوی این موارد است.
رفع اشکالها
- دسترسی به
PagedList.dataSourceاز مقدار اولیه تولیدشده توسطLivePagedListیاRxPagedListدیگر بهاشتباه IllegalStateException را ایجاد نخواهد کرد (I96707)
نسخه ۳.۰.۰
نسخه ۳.۰.۰
۵ مه ۲۰۲۱
androidx.paging:paging-*:3.0.0 منتشر شده است. نسخه ۳.۰.۰ حاوی این ارسالها است.
ویژگیهای اصلی نسخه 3.0.0
بخش عمدهای از API موجود از Paging 2.x.x بهنفع APIهای جدید Paging 3 منسوخ شده است تا بهبودهای زیر را بههمراه داشته باشد:
- پشتیبانی درجه یک از روالهای مشترک Kotlin و Flow
- پشتیبانی برای لغو
- نشانهای خطا و حالت بارگذاری داخلی
- عملکرد امتحان مجدد + بازآوری
- هر سه زیرکلاس DataSource در یک کلاس واحد PagingSource ترکیب شدهاند
- تبدیلهای صفحه سفارشی ازجمله تبدیل داخلی برای افزودن جداکنندهها
- درحال بار کردن سرصفحهها و پاصفحههای ایالت
نسخه 3.0.0-rc01
۲۱ آوریل ۲۰۲۱
androidx.paging:paging-*:3.0.0-rc01 منتشر شده است. نسخه 3.0.0-rc01 حاوی این commit-ها است.
رفع اشکالها
- مشکلی برطرف شد که در آن «صفحهبندی» گاهی اوقات رویدادهای differ بدون عملیات را به RecyclerView ارسال میکرد، که میتوانست باعث شود برخی شنوندگان زودتر فعال شوند. (Ic507f, b/182510751)
نسخه 3.0.0-beta03
۲۴ مارس ۲۰۲۱
androidx.paging:paging-*:3.0.0-beta03 منتشر شده است. نسخه 3.0.0-beta03 حاوی این commit-ها است.
رفع اشکالها
- نحوه مدیریت جایبانها را هنگام بار کردن مجدد فهرست اصلاح کردهایم تا از پرشهای غیرمنتظره در RecyclerView جلوگیری شود. برای جزئیات، NullPaddedDiffing.md را ببینید. (If1490، b/170027529، b/177338149)
- سازندگان مختلف PagedList (مسیر سازگاری قدیمی) دیگر هنگام فراخوانی
.build()، بهطور نادرستDataSource.Factory.create()را بهصورت همزمان در رشته اصلی فراخوانی نمیکنند. (b/182798948)
نسخه 3.0.0-beta02
۱۰ مارس ۲۰۲۱
androidx.paging:paging-*:3.0.0-beta02 منتشر شده است. نسخه 3.0.0-beta02 حاوی این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
- افزونههای Rx3 اکنون بهدرستی الزامات موافقت کردن
@ExperimentalCoroutinesApiرا منتشر میکنند. قبلاً آنها روی روش@getعلامتگذاری شده بودند که بهدلیل https://youtrack.jetbrains.com/issue/KT-45227 (I5733c) توسط Kotlin Compiler نادیده گرفته میشود.
رفع اشکالها
- Enforce restrictions on public usage of experimental APIs (I6aa29, b/174531520)
- اشکالی که باعث میشد
PagingStateهمیشهnullباشد وقتی بازآوری ازراهدور فراخوانی میشود برطرف شد. - اشکالی برطرف شد که در آن صفحههای خالی برگرداندهشده توسط PagingSource میتوانست مانع از واکشی مجدد Paging برای برآورده کردن
prefetchDistanceشود و باعث شود Paging «گیر کند».
نسخه 3.0.0-beta01
۱۰ فوریه ۲۰۲۱
androidx.paging:paging-*:3.0.0-beta01 منتشر شده است. نسخه 3.0.0-beta01 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
- پوشانندههای Rx2 و Rx3 اکنون حاشیهنویسی آزمایشی را که به آن وابسته هستند نشان میدهند. اگر از پوششهای سازگار Rx در paging-rxjava2 یا
paging-rxjava3 استفاده میکنید، اکنون باید موارد استفاده را با
@OptIn(ExperimentalCoroutinesApi::class)حاشیهنویسی کنید (Ib1f9d)
رفع اشکالها
IndexOutOfBoundsException: Inconsistency detectedکه گاهی هنگام استفاده از میاناهای برنامهسازی کاربردیDataSourceنسخه ۲ ازطریق مسیرهای سازگاری ایجاد میشد برطرف شد- اکنون تماس
isInvalidدرطول مقداردهی اولیهDataSourceهنگام استفاده ازطریق مسیرهای سازگاری بهجای رشته اصلی، بهدرستی در fetchDispatcher راهاندازی میشود. این کارIllegalStateExceptionرا بهدلیل دسترسی Db در رشته اصلی هنگام استفاده از پیادهسازیPagingSourceRoom برطرف میکند.
نسخه 3.0.0-alpha13
۲۷ ژانویه ۲۰۲۱
androidx.paging:paging-*:3.0.0-alpha13 منتشر شده است. نسخه 3.0.0-alpha13 حاوی این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
PagingSource.getRefreshKeyدیگر برای پیادهسازی اختیاری نیست، اکنون یک تابع انتزاعی بدون پیادهسازی پیشفرض است. کاربران درحال انتقال میتوانند به برگرداندن پیادهسازی پیشفرض ادامه دهند که بهسادگیnullرا برمیگرداند، اماgetRefreshKey()باید پیادهسازی واقعی داشته باشد که کلیدی را براساس موقعیت پیمایش فعلی کاربر برمیگرداند که به «صفحهبندی» اجازه میدهد درصورت امکان به بار کردن متمرکز در اطراف نمای هدف ازطریقPagingState.anchorPositionادامه دهد. (I4339a)-
InvalidatingPagingSourceFactoryاکنون کلاس نهایی است (Ia3b0a) - امکان پیکربندی رفتار جداکننده پایانه (سرصفحه / پاصفحه)
با پارامتر اختیاری اضافی SeparatorType. دو گزینه
عبارتند از:
FULLY_COMPLETE- رفتار موجود؛ قبلاز افزودن جداکنندههای پایانه، منتظر بمانید تا PagingSource و RemoteMediator هر دو endOfPaginationReached را علامتگذاری کنند. اگر از RemoteMediator استفاده نشود، loadState از راه دور نادیده گرفته میشود. این ویژگی عمدتاً زمانی مفید است که بخواهید جداکنندههای بخش را فقط زمانی نشان دهید که بخش بهطور کامل بار شده باشد، ازجمله واکشی از منبع راه دور، مثلاً شبکه.SOURCE_COMPLETE- only wait for PagingSource to mark endOfPaginationReached even if RemoteMediator is used. این کار باعث میشود سرصفحهها و پاصفحهها بهطور همزمان با بارگیری اولیه ارائه شوند، که مانع از نیاز کاربران به پیمایش برای دیدن جداکنندههای پایانه میشود. (Ibe993، b/174700218)
رفع اشکالها
- نشت حافظه نادری که وقتی PagingSource قبلاز اینکه PageFetcher بتواند بار کردن از آن را شروع کند نامعتبر میشود، برطرف شد. (I9606b، b/174625633)
نسخه 3.0.0-alpha12
۱۳ ژانویه ۲۰۲۱
androidx.paging:paging-*:3.0.0-alpha12 منتشر شده است. نسخه 3.0.0-alpha12 حاوی این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
- InvalidatingPagingSourceFactory دیگر کلاس انتزاعی نیست چون هیچگاه متد انتزاعی نداشته است. (I4a8c4)
- افزودن سربارگذاری .cachedIn() که ViewModel را بهجای Lifecycle یا CoroutineScope برای کاربران Java میپذیرد. (I97d81، b/175332619)
- به تماسگیرندگان جاوا اجازه میدهد با پذیرفتن Executor در آرگومانهای عملگر تبدیل، از عملیات تبدیل PagingData بهصورت ناهمگام استفاده کنند. اکنون پسوند Sync- از همه عملگرهای تبدیل Sync- برداشته شده است و کاربران Kotlin Coroutine باید با فراخوانی تابع افزونهای که بلوک تعلیق را میپذیرد، ابهامزدایی کنند.
همه اپراتورهای تبدیل PagingData به افزونهها
تحت کلاس ثابت PagingDataTransforms منتقل شدهاند. کاربران Java باید
آنها را ازطریق کمککنندههای ایستا فراخوانی کنند، مثلاً
PagingDataTransforms.map(pagingData, transform)برای کاربران Kotlin، نحو یکسان است اما باید تابع را وارد کنید. (If6885، b/172895919)
رفع اشکالها
- اشکالی که باعث میشد اگر به انتهای صفحهبندی رسیده باشد،
RemoteMediator.load()درطولadapter.refresh()فراخوانی نشود برطرف شد.
نسخه 3.0.0-alpha11
۱۶ دسامبر ۲۰۲۰
androidx.paging:paging-*:3.0.0-alpha11 منتشر شده است. نسخه 3.0.0-alpha11 حاوی این commitها است.
ویژگیهای جدید
- پشتیبانی از وضعیت ذخیرهشده برای موارد استفاده پایه زیر اضافه شد (پشتیبانی کامل، بهویژه در مورد منبع لایهای، هنوز درحال توسعه است):
- جریان ذخیره شده است و برنامه متوقف نشده است (مثلاً جریان در مدل نما ذخیره شده است و فعالیت در فرایند بازآفرینی شده است)
- منبع صفحهبندی شمارش میشود، جایبانها فعال هستند، و چیدمان نامنظم نیست.
تغییرات میانای برنامهسازی کاربردی
-
PagingSource.getRefreshKey()اکنون میانای برنامهسازی کاربردی پایداری است (I22f6f، b/173530980) PagingSource.invalidateدیگر عملکردی باز نیست. اگر لازم است هنگام وقوع ابطال مطلع شوید، بهجای لغو invalidate، فراخوانی روش registerInvalidatedCallback را درنظر بگیرید. (I628d9، b/173029013، b/137971356)- Pager اکنون علاوهبر سازندههای معمولیاش، یک سازنده آزمایشی دارد، بهجای اینکه میاناهای برنامهسازی کاربردی آزمایشی را ازطریق حاشیهنویسی موافقت کردن به میانای برنامهسازی کاربردی عمومی غیرآزمایشی نشت دهد. (I9dc61، b/174531520)
- Updated the convenience properties,
CombinedLoadStates.refresh,CombinedLoadStates.prepend,CombinedLoadStates.appendto only transition fromLoadingtoNotLoadingafter both mediator and source load states areNotLoadingto ensure the remote update has been applied. (I65619) LoadParams.pageSize برداشته شده است (قبلاً منسوخ شده بود). توصیه میشود از
LoadParams.loadSizeدر PagingSource خود استفاده کنید.
LoadParams.loadSizeهمیشه برابر باPagingConfig.pageSizeاست، بهجز برای تماس بارگیری اولیه که برابر باPagingConfig.initialLoadSizeاست.اگر Paging2 DataSource را بدون استفاده از Pager یا PagedList آزمایش میکنید، اگر
initialLoadSizeرا نیز تنظیم کنید،pageSizeممکن است باPagingConfig.pageSizeمطابقت نداشته باشد. اگر این موضوع برای آزمایشهایتان مهم است، بهجای آن از Pager/PagedList استفاده کنید که بهطور داخلی PageSize صحیح را برای روشهای بارگیری DataSource شما تنظیم میکند. (I98ac7، b/149157296)
رفع اشکالها
- خرابی ناشی از IllegalStateException هنگام استفاده از جداکنندهها با تنظیم PagingConfig.maxSize برطرف شد. (I0ed33، b/174787528)
- اشکالی که باعث میشد وضعیت بارگیری برای PREPEND / APPEND بلافاصله پساز بارگیری اولیه درصورت تنظیم RemoteMediator به
NotLoading(endOfPaginationReached = true)بهروز نشود برطرف شد (I8cf5a) - اشکالی برطرف شد که در آن میاناهای برنامهسازی کاربردی سمت ارائهدهنده مانند .snapshot()، .peek()، و غیره، فهرست قبلی (قدیمی) را در بهروزرسانیهای ListUpdateCallback برمیگرداندند.
- اشکالی که باعث میشد اپراتورهای Separators هنگام استفاده با RemoteMediator سرصفحه یا پاصفحه اضافه نکنند برطرف شد
- اشکالی که در آن بهروزرسانیهای LoadState به NotLoading برای RemoteMediator در وضعیت Loading گیر میکرد برطرف شد
- اشکالی برطرف شد که در آن میانای برنامهسازی کاربردی سازگاری Paging2.0،
.asPagingSourceFactory()، میتوانست باعث شودDataSourceپشتیبان در CoroutineDispatcher نادرست مقداردهی اولیه شود. این کار باعث رفع خرابی و موارد احتمالی ANR میشود، بهویژه هنگام استفاده از پیادهسازی فعلی Room از PagingSource، که از این مسیر سازگاری استفاده میکند.
نسخه 3.0.0-alpha10
۲ دسامبر ۲۰۲۰
androidx.paging:paging-*:3.0.0-alpha10 منتشر شده است. نسخه 3.0.0-alpha10 حاوی این commitها است.
تغییرات میانای برنامهسازی کاربردی
میاناهای برنامهسازی کاربردی منسوخشده
dataRefreshFlowوdataRefreshListenerبرداشته شدهاند چون با بهروزرسانیهای loadStateFlow / Listener زائد هستند. برای کسانی که درحال انتقال هستند، معادل loadStateFlow عبارت است از:loadStateFlow.distinctUntilChangedBy { it.refresh } .filter { it.refresh is NotLoading }
رفع اشکالها
- endOfPaginationReached برای RemoteMediator
REFRESHاکنون بهدرستی به بهروزرسانیهای LoadState انتشار مییابد و از فعال شدنAPPENDوPREPENDاز راه دور جلوگیری میکند. (I94a3f، b/155290248) - ارائه فهرست خالی بهدلیل خالی بودن صفحه اولیه یا فیلتر کردن سنگین دیگر مانع از شروع بارگیریهای
PREPENDیاAPPENDتوسط «صفحهبندی» نمیشود. (I3e702، b/168169730) - مشکلی که باعث میشد وقتی ابطالها بهسرعت رخ میدهند،
getRefreshKeyدر نسلهای بعدی PagingSource فراخوانی نشود برطرف شد. (I45460، b/170027530)
همیاری خارجی
- کلاس انتزاعی جدید InvalidatingPagingSourceFactory با یک
.invalidate()API اضافه شده است که invalidate را به همه PagingSources که منتشر میکند بازارسال میکند. با تشکر از @claraf3! (Ie71fc، b/160716447)
مشکلات شناختهشده
- هنگام استفاده از RemoteMediator، ممکن است سرصفحهها و پاصفحهها از تبدیل .insertSeparators() فوراً ظاهر نشوند b/172254056
- استفاده از RemoteMediator میتواند باعث شود که
LoadStateاز راه دور گیر کند اگر ابطال وPagingSource.load(LoadParams.Refresh(...))قبلاز اینکهRemoteMediator.load()b/173717820 را برگرداند تکمیل شود
نسخه 3.0.0-alpha09
۱۱ نوامبر ۲۰۲۰
androidx.paging:paging-*:3.0.0-alpha09 منتشر شده است. نسخه 3.0.0-alpha09 شامل این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
- Fully deprecate dataRefreshFlow / Listener methods with a replaceWith clause. (I6e2dd)
رفع اشکالها
- رفع مشکل
IllegalArgumentExceptionکه هنگام استفاده از جداکنندهها با RemoteMediator ایجاد میشد و زمانی که بارگیری ازراهدور که endOfPagination را برمیگرداند هنوز درحال اجرا بود، invalidate راهاندازی میشد (I3a260)
نسخه 3.0.0-alpha08
۲۸ اکتبر ۲۰۲۰
androidx.paging:paging-*:3.0.0-alpha08 منتشر شده است. نسخه 3.0.0-alpha08 شامل این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
- انواع Kotlin / Java مربوط به
DataSource.InvalidatedCallbackبا فعال کردن تبدیلهای SAM در Kotlin ازطریق میانای تابع (در Kotlin 1.4 دردسترس است) ترکیب شدهاند. این کار همچنین اشکالی را برطرف میکند که در آن گونه kotlin از تماسهای برگشتی نامعتبر پساز تبدیل توسط.mapیا.mapByPageفراخوانی نمیشد. (I1f244، b/165313046)
رفع اشکالها
- تعامل صفحهبندی با ViewPager بهطور قابلتوجهی بهبود یافته است. بهطور مشخص، Paging دیگر تماس
RemoteMediator#loadرا بهدلیل نامعتبر بودن صفحه لغو نخواهد کرد. همچنین، اگر «بازآوری» لازم باشد، تا زمانی که درخواست «بازآوری» با موفقیت تکمیل نشود، دیگر درخواست بار کردن الحاق/ پیشالحاق ایجاد نخواهد کرد. (I6390b، b/162252536) - بررسی API lint برای MissingGetterMatchingBuilder برای androidx فعال شده است (I4bbea، b/138602561)
- اشکالی که در آن کمککنندههای
.withLoadState*ConcatAdapterبهدلیل اطلاعرسانی RecyclerView از رشته پسزمینه ازکار میافتادند برطرف شد (I18bb5، b/170988309) - اشکالی که باعث میشد بار کردن صفحه غیرخالی بسیار کوچک گاهی اوقات مانع از راهاندازی صحیح بارگیریها توسط پیشواکشی شود برطرف شد.Iffda3 b/169259468
نسخه 3.0.0-alpha07
۱ اکتبر ۲۰۲۰
androidx.paging:paging-*:3.0.0-alpha07 منتشر شده است. نسخه 3.0.0-alpha07 حاوی این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
- اپراتورهای مبتنی بر Async PagingData Guava اکنون Executor را بهعنوان پارامتر میپذیرند تا زمینه اجرا را کنترل کنند. (Id4372)
رفع اشکالها
- استثنای IndexOutOfBounds که بهدلیل شرایط رقابتی در RemoteMediator ایجاد میشد برطرف شد. (I00b7f، b/165821814)
- شرایط رقابتی در تبدیل DataSource -> PagingSource که میتوانست باعث شود PagingSource حاصل سیگنالهای نامعتبرسازی را از DataSource نادیده بگیرد برطرف شد.
- مشکلی در منطق واکشی صفحه برطرف شد که گاهی باعث میشد تا زمانی که PagingDataAdapter.refresh() فراخوانی نشده است، نسلهای جدید PagingSource را دریافت نکند
- مشکلی برطرف شد که باعث میشد گاهیاوقات هنگام استفاده از DataSource تبدیلشده به PagingSource (مانند آنچه توسط Room تولید میشود) در ترکیب با RemoteMediator، موقعیت پیمایش ازدست برود
همیاری خارجی
- از @simonschiller برای افزودن RxJava2، RxJava3، و اپراتورهای تبدیل ناهمگام مبتنی بر Guava برای PagingData سپاسگزاریم!
نسخه 3.0.0-alpha06
۲ سپتامبر ۲۰۲۰ (۱۲ شهریور ۱۳۹۹)
androidx.paging:paging-*:3.0.0-alpha06 منتشر شده است. نسخه 3.0.0-alpha06 حاوی این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
UnsupportedOperationExceptionبا پیامرسانی واضحتر درباره عدم پشتیبانی از شناسههای پایدار اکنون هروقتPagingDataAdapter.setHasStableIdsفراخوانی شود، نشان داده میشود. (Ib3890، b/158801427)
رفع اشکالها
- insertSeparators دیگر صفحههای خالی را فیلتر نمیکند و به ارائهدهنده اجازه میدهد فاصله پیشواکشی را حتی در مواردی که صفحههای خالی زیادی درج شدهاند رعایت کند. (I9cff6، b/162538908)
نسخه 3.0.0-alpha05
۱۹ اوت ۲۰۲۰
androidx.paging:paging-*:3.0.0-alpha05 منتشر شده است. نسخه 3.0.0-alpha05 حاوی این commitها است.
رفع اشکالها
- اکنون صفحهبندی بهدرستی صفحهها را پیشواکشی میکند، حتی وقتی دادههای ارائهشده بهشدت فیلتر شده باشند
- برگرداندن
LoadResult.Errorبه بارگیری مجدد دیگر باعث نمیشود دسترسیهای «مورد» بهاشتباه دوباره امتحان کردن را راهاندازی کند
همیاری خارجی
- با تشکر از Clara F برای کمک به پاکسازی برخیاز آزمایشها! (۵۴۹۶۱۲)
نسخه 3.0.0-alpha04
۵ اوت ۲۰۲۰
androidx.paging:paging-*:3.0.0-alpha04 منتشر شده است. نسخه 3.0.0-alpha04 شامل این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
peek()API بهAsyncPagingDataDifferوPagingDataAdapterاضافه شد تا دسترسی به دادههای ارائهشده بدون بارگیری صفحه راهانداز امکانپذیر شود. (I38898، b/159104197)- میانای برنامهسازی کاربردی
snapshot()بهPagingDataAdapterوAsyncPagingDataDifferاضافه شد تا بازیابی موارد ارائهشده بدون راهاندازی واکشی صفحه امکانپذیر شود. (I566b6، b/159104197) - سازنده
PagingData.from(List<T>)اضافه شد تا امکان ارائه فهرستهای ایستا فراهم شود. این فهرستها را میتوان با جریان کلی PagingData ترکیب کرد تا فهرستهای ایستا در حالتهای خاصی نشان داده شوند، مثلاً قبلاز اینکه REFRESH اولیه تمام شود یا صرفاً برای آزمایش تبدیلها. (Id134d) - منسوخ کردن dataRefresh Flow / Listener APIs چون هدف آنها نمایش وضعیت موارد ارائهشده در REFRESH بود، اما با بهبود زمانبندی فراخوان برگشتی loadState Flow / Listener و ویژگی itemCount، این APIها زائد هستند (Ia19f3)
- پوشانندههای سازگاری RxJava3 برای
PagingSourceوRemoteMediatorاضافه شد (I49ef3، b/161480176)
رفع اشکالها
PositionalDataSourceتبدیلشده بهPagingSourceازطریق کمککنندهtoPagingSourceFactory، ازجملهPagingSourceتولیدشده توسط Room اکنون بهدرستی خود را برای پشتیبانی از پرش علامتگذاری میکنند. (I3e84c، b/162161201)- اشکالی برطرف شد که در آن استفاده از نوع همگام submitData
گاهی منجر به رقابت میشد و
ClosedSendChannelExceptionایجاد میکرد (I4d702، b/160192222)
همیاری خارجی
- از زک سویرز برای افزودن پوشانندههای سازگاری RxJava3 ازطرف Slack سپاسگزاریم! (I49ef3، b/161480176)
نسخه 3.0.0-alpha03
۲۲ ژوئیه ۲۰۲۰
androidx.paging:paging-*:3.0.0-alpha03 منتشر شده است. نسخه 3.0.0-alpha03 حاوی این commitها است.
تغییرات میانای برنامهسازی کاربردی
- سازنده PagingState اکنون عمومی است، که باید پیادهسازیهای آزمایشی getRefreshKey() را آسانتر کند (I8bf15)
- انواع تابع نقشه kotlin مربوط به DataSource از Java پنهان شد تا ابهام بین انواع اصلی و kotlin برطرف شود. (If7b23، b/161150011)
- میاناهای برنامهسازی کاربردی اضافی که برای راحتی کاربران Kotlin درنظر گرفته شدهاند با @JvmSynthetic علامتگذاری شدهاند (I56ae5)
- افزودن اضافهبارها برای سازنده LoadResult.Page که itemsBefore و itemsAfter را بهطور پیشفرض روی COUNT_UNDEFINED تنظیم میکند (I47849)
- Made existing PagingData operators accept suspending methods and introduced new mapSync, flatMapSync, and filterSync non-suspending operators for Java users. روشهای تبدیل موجود به توابع افزونه منتقل شدهاند، بنابراین کاربران Kotlin اکنون باید آنها را وارد کنند. (I34239، b/159983232)
رفع اشکالها
- اکنون Room (و PositionalDataSource) PagingSources جداکننده پیشرو را بهعنوان بخشی از صفحه اول نمایش میدهند، بنابراین کاربر برای دیدن آن نیازی به پیمایش ندارد. (I6f747، b/160257628)
- دسترسی به موارد در جایبانها اکنون بهدرستی بارگیریهای PagingSource را فعال میکند تا زمانی که صفحهای برگردانده شود که نمایه درخواستشده را پساز تبدیل شدن توسط PagingData.filter() برآورده کند (I95625، b/158763195)
- رفع اشکالی که گاهی اوقات پیمایش پساز برگشت خطا از PagingSource میتوانست مانع از امتحان مجدد PagingDataAdapter.retry() شود. (I1084f، b/160194384)
- مشکلی را برطرف میکند که در آن دسترسی به مورد پساز رها کردن صفحه ممکن است صفحهها را بار نکند، اگرچه دسترسی به مورد در prefetchDistance (Ie95ae، b/160038730) باشد
- تنظیم PagingConfig.maxSize دیگر پساز رویداد رها کردن، جایبانها را فعال نمیکند (I2be29، b/159667766)
نسخه 3.0.0-alpha02
۲۴ ژوئن ۲۰۲۰
androidx.paging:paging-*:3.0.0-alpha02 منتشر شده است. نسخه 3.0.0-alpha02 حاوی این commitها است.
تغییرات میانای برنامهسازی کاربردی
- افزودن سربارگذاری برای سازنده
PagingConfigبا مقادیر پیشفرض رایج (I39c50، b/158576040) - افزودن سربارگذاری برای سازندههای
PagingDataAdapterوAsyncPagingDataDifferبا مقادیر پیشفرض رایج (Ie91f5) - میاناهای برنامهسازی کاربردی آداپتور،
dataRefreshFlowوdataRefreshListenerاکنون یک مقدار بولی را برای نشان دادن خالی بودنPagingDataارسال میکنند (I6e37e، b/159054196) - Added RxJava and Guava APIs for RemoteMediator - RxRemoteMediator and ListenableFutureRemoteMediator
- Added helpers to PagingState for common item access such as
isEmpty()andfirstItemOrNull()(I3b5b6, b/158892717)
رفع اشکالها
- اکنون Pager استفاده مجدد از PagingSource را در کارخانه بررسی میکند تا از استفاده مجدد تصادفی از PagingSource نامعتبر که خطای نامشخصی ارائه میداد جلوگیری کند (I99809، b/158486430)
- خطاهای REFRESH در RemoteMediator دیگر مانع از بار شدن PagingSource نمیشود (I38b1b، b/158892717)
- نسخه غیرتعلیقی
submitDataدیگر بهدلیل جمعآوری همزمان در چندینPagingDataهنگام فراخوانی پساز نسخه تعلیقیsubmitData، باعث ازکارافتادن نمیشود. (I26358، b/158048877) - استثنای «نمیتوان دو بار از ورقزن جمعآوری کرد» که ممکن بود پساز تغییر پیکربندی رخ دهد برطرف شد (I58bcc، b/158784811)
نسخه 3.0.0-alpha01
۱۰ ژوئن ۲۰۲۰ (۲۱ خرداد ۱۳۹۹)
androidx.paging:paging-*:3.0.0-alpha01 منتشر شده است. نسخه 3.0.0-alpha01 حاوی این commitها است.
«کتابخانه صفحهبندی» به نسخه ۳.۰ بهروزرسانی شده است تا چندین ویژگی جدید اصلی را فعال کند.
ویژگیهای جدید نسخه ۳.۰
- پشتیبانی درجه یک از روالهای مشترک Kotlin و Flow.
- پشتیبانی از بارگیری ناهمگام با توابع تعلیق روالهای همزمان، RxJava Single، یا Guava ListenableFuture primitives.
- سیگنالهای خطا و وضعیت بارگیری داخلی برای طراحی واسط کاربر واکنشگرا، ازجمله عملکرد بازآوری و امتحان مجدد.
- بهبودهای لایه مخزن
- میانای منبع داده سادهشده
- صفحهبندی سادهشده شبکه + پایگاه داده
- پشتیبانی لغو
- بهبود لایه نمایش
مشکلات شناختهشده
- صفحهبندی ۳ javadocs هنوز دردسترس نیست. در این فاصله، لطفاً از راهنماهای پیوندشده در بالا یا اسناد Kotlin استفاده کنید. (b/158614050)
نسخه ۲.۱.۲
نسخه ۲.۱.۲
۱۸ مارس ۲۰۲۰ (۲۸ اسفند ۱۳۹۸)
androidx.paging:paging:2.1.2 منتشر شده است. نسخه ۲.۱.۲ حاوی این ارسالها درمقابل ۲.۱.۰ است.
رفع اشکالها
- رفع مشکل
IndexOutOfBoundsExceptionدر موارد نادر هنگام تبدیل موقعیت درطول باطلسازی.
مشکل نسخه پخش
نسخه
2.1.1صفحهبندی بهاشتباه از شاخهای با پیکربندی نادرست منتشر شده است و میاناهای برنامهسازی کاربردی و عملکردهای نیمهپیادهسازیشدهای را که در نسخه آتی ارائه خواهند شد درمعرض دید قرار داده است.صفحهبندی
2.1.2حاوی اصلاحیه مرکز بارگذاری است که در نسخه ۲.۱.۱ منتشر شده بود، اما این بار بهدرستی در بالای نسخه ۲.۱.۰ گلچین شده است. اگر درحالحاضر از نسخه ۲.۱.۱ استفاده میکنید، اکیداً توصیه میشود به این نسخه ارتقا دهید.
نسخه ۲.۱.۱
نسخه ۲.۱.۱
۱۸ دسامبر ۲۰۱۹
androidx.paging:paging-*:2.1.1 منتشر شده است. نسخه ۲.۱.۱ حاوی این ثبتها است.
رفع اشکالها
- وقتی جایبانها غیرفعال باشند، بارهای اولیه مجاور از PositionalDataSources اکنون حول آخرین دسترسی متمرکز میشوند
نسخه ۲.۱.۰
نسخه ۲.۱.۰
۲۵ ژانویه ۲۰۱۹
صفحهبندی 2.1.0 بدون تغییر نسبت به 2.1.0-rc01 منتشر شد.
نسخه 2.1.0-rc01
۶ دسامبر ۲۰۱۸
صفحهبندی 2.1.0-rc01 بدون تغییر نسبت به 2.1.0-beta01 منتشر شد.
نسخه 2.1.0-beta01
۱ نوامبر ۲۰۱۸
صفحهبندی 2.1.0-beta01 بدون تغییر نسبت به 2.1.0-alpha01 منتشر شد.
نسخه 2.1.0-alpha01
۱۲ اکتبر ۲۰۱۸
صفحهبندی 2.1.0-alpha01 دو افزودنی اصلی دارد - حذف صفحه، و کتابخانههای افزونه KTX برای هر آرتیفکت - و همچنین چندین تغییر API و رفع اشکال دیگر.
تغییرات میانای برنامهسازی کاربردی
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اضافه شدند - Added
AsyncPagedListDiffer.addPagedListListener()for listening to when PagedList is swapped. b/111698609 - Added
PagedListAdapter.onCurrentListChanged()variant that passes old and new list, deprecated previous variant. - انواع
PagedListAdapter/AsyncPagedListDiffer.submitList()اضافه شد که یک فراخوانی برگشتی اضافی را میگیرد که اگر/وقتی pagedlist نمایش داده شود، پساز تفکیک کردن، راهاندازی میشود. این کار به شما امکان میدهد تعویض PagedList را با سایر بهروزرسانیهای میانای کاربر همگامسازی کنید. b/73781068 PagedList.getLoadedCount()اضافه شد تا بدانید چند مورد در حافظه وجود دارد. توجه داشته باشید که اگر جایبانها غیرفعال باشند، مقدار برگشتی همیشه برابر با.size()است.
رفع اشکالها
- رفع مشکل شرایط رقابتی هنگام مقایسه کردن درصورت استفاده مجدد از فهرستها b/111591017
PagedList.loadAround()اکنون وقتی نمایه نامعتبر باشدIndexOutOfBoundsExceptionرا برمیگرداند. قبلاً ممکن بود با استثنای نامشخص دیگری ازکار بیفتد.- موردی را برطرف کردیم که در آن اندازه بارگیری اولیه بسیار کوچک همراه با دادههای بدون تغییر منجر به عدم بارگیری بیشتر میشد b/113122599
نسخه ۲.۰.۰
نسخه ۲.۰.۰
۱ اکتبر ۲۰۱۸
Paging 2.0.0 با یک رفع اشکال منتشر شد.
رفع اشکالها
- خرابیای که ممکن بود هنگام پیمایش بسیار سریع بااستفاده از
PositionalDataSourceو جایبانهای b/114635383 رخ دهد برطرف شد.
نسخه 2.0.0-beta01
۲ ژوئیه ۲۰۱۸
رفع اشکالها
- Fixed content disappearing in some prepend cases (placeholders disabled, PositionalDataSource) b/80149146
- (قبلاً در
1.0.1منتشر شده است) خرابیهایی که در آنهاPagedListAdapterوAsyncPagedListDifferنمیتوانستند رویدادهای جابهجایی را علامتگذاری کنند برطرف شد. b/110711937
وابستگیهای Pre-AndroidX
برای نسخههای پیشاز AndroidX از Paging که در ادامه میآید، این وابستگیها را اضافه کنید:
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"
}
نسخه ۱.۰.۱
نسخه ۱.۰.۱
۲۶ ژوئن ۲۰۱۸
Paging 1.0.1 با یک رفع اشکال در runtime منتشر شده است. برای پایداری، اکیداً توصیه میکنیم از 1.0.1 استفاده کنید. Paging RxJava2 1.0.1 نیز منتشر شده است و با 1.0.0-rc1 یکسان است.
رفع اشکالها
- خرابیهایی که در آنها
PagedListAdapterوAsyncPagedListDifferنمیتوانستند رویدادهای انتقال را علامتگذاری کنند برطرف شد. b/110711937
RxJava2 Version 1.0.0
RxJava2 نسخه 1.0.0-rc1
۱۶ مه ۲۰۱۸
Paging RxJava2 1.0.0-rc1 بدون هیچ تغییری نسبتبه نسخه آلفای اولیه به نامزد انتشار منتقل میشود.
نسخه ۱.۰.۰
نسخه 1.0.0-rc1
۱۹ آوریل ۲۰۱۸ نامزد انتشار صفحهبندی
مشکل شناختهشده دیگری نداریم و ویژگی جدیدی برای انتشار Paging 1.0.0 برنامهریزی نشده است. لطفاً پروژههایتان را ارتقا دهید تا از 1.0.0-rc1 استفاده کنید و
به ما کمک کنید آن را آزمایش کنیم تا بتوانیم 1.0.0 را بهصورت کاملاً پایدار عرضه کنیم.
هیچ تغییری در این نسخه پخش وجود ندارد، این نسخه پخش همانند 1.0.0-beta1 است.
نسخه 1.0.0-beta1
۵ آوریل ۲۰۱۸
صفحهبندی برای مدت کوتاهی در نسخه بتا خواهد بود و سپس به نامزد انتشار ارتقا مییابد.
ما قصد نداریم تغییرات بیشتری در API برای Paging 1.0 ایجاد کنیم و سطح استاندارد برای هرگونه تغییر در API بسیار بالا است.
پشتیبانی Alpha RxJava2 برای «صفحهبندی» بهعنوان یک ماژول اختیاری جداگانه (android.arch.paging:rxjava2:1.0.0-alpha1) منتشر شده است
و تا زمانی که پایدار شود، بهطور موقت بهصورت جداگانه نسخهبندی خواهد شد.
این کتابخانه جدید جایگزین RxJava2 برای LivePagedListBuilder است و میتواند
Observable و Flowable بسازد و بهجای Executor، Scheduler بگیرد:
کاتلین
val pagedItems = RxPagedListBuilder(myDataSource, /* page size */ 50) .setFetchScheduler(myNetworkScheduler) .buildObservable()
جاوا
Observable<PagedList<Item>> pagedItems = RxPagedListBuilder(myDataSource, /* page size */ 50) .setFetchScheduler(myNetworkScheduler) .buildObservable();
ویژگیهای جدید
-
RxPagedListBuilderازطریق مصنوع جدیدandroid.arch.paging:rxjava2اضافه شده است.
تغییرات میانای برنامهسازی کاربردی
تغییرات API برای شفافسازی نقش اجراکنندگان در سازندگان:
نام
setBackgroundThreadExecutor()بهsetFetchExecutor()تغییر کرد (درPagedList.BuilderوLivePagedListBuilder)نام
setMainThreadExecutor()بهsetNotifyExecutor()تغییر کرد (درPagedList.Builder).
عضو ثابت
PagedList.mCallbacksخصوصی باشد.
رفع اشکالها
LivePagedListBuilderبار اولیهPagedListرا در مجری مشخصشده راهاندازی میکند، بهجای استخر رشته IO مؤلفههای Arch.رفتار نامعتبرسازی در پوشانندههای داخلی
DataSource(که برای پیادهسازیDataSource.map، و همچنین بار کردنPositionalDataSourceبا جایبان غیرفعالشده استفاده میشود) اصلاح شد b/77237534
نسخه 1.0.0-alpha7
۲۱ مارس ۲۰۱۸
Paging 1.0.0-alpha7 همراه با Lifecycles 1.1.1 منتشر میشود. ازآنجاییکه Paging alpha7 به انتقال کلاس Function که در بالا ذکر شد بستگی دارد، باید وابستگی lifecycle:runtime را به android.arch.lifecycle:runtime:1.1.1 بهروز کنید.
قرار است «صفحهبندی» alpha7 آخرین نسخه قبلاز رسیدن «صفحهبندی» به نسخه بتا باشد.
تغییرات میانای برنامهسازی کاربردی
- اشیاء
DataSource.LoadParamsاکنون سازنده عمومی دارند و اشیاءDataSource.LoadCallbackاکنون انتزاعی هستند. This enables wrapping aDataSourceor directly testing aDataSourcewith a mock callback. 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- همه کلاسهای منسوخشده از API برداشته شدهاند، ازجمله بقایای بسته
recyclerview.extensionsوLivePagedListProvider. DataSource.Factoryاز میانای به کلاس انتزاعی تغییر کرده است تا عملکرد نقشه فعال شود.
رفع اشکالها
- Changed Builders to be final. b/70848565
- پیادهسازی Room
DataSourceاکنون برای رسیدگی به پُرسمانهای چندجدولی اصلاح شده است - این اصلاح در Room 1.1.0-beta1 گنجانده شده است، بالا را ببینید. - اشکالی برطرف شد که در آن اگر جایبانها فعال باشند و اندازه کل مضرب دقیقی از اندازه صفحه باشد،
BoundaryCallback.onItemAtEndLoadedبرایPositionalDataSourceفراخوانی نمیشد.
نسخه 1.0.0-alpha5
۲۲ ژانویه ۲۰۱۸
رفع اشکالها
- Fix page loading when placeholders are disabled b/70573345
- ثبت گزارش اضافی برای ردیابی اشکال IllegalArgumentException b/70360195 (و اصلاح احتمالی در سمت Room)
- Javadoc sample code fixes b/70411933, b/71467637