صفحه‌بندی

«کتابخانه صفحه‌بندی» بار کردن تدریجی و روان داده‌ها را در RecyclerView برنامه‌تان آسان‌تر می‌کند.

این جدول همه مصنوعات موجود در گروه 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 throw NoSuchElementException. 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 برای بازیابی از خطاهای بارگیری هنگام استفاده از asItemSnapshotListFlow API اضافه شد.

نسخه 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>.asState API به 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 استفاده شود، جایگزینی برای بار کردن داده‌های بیشتر علاوه‌بر پیمایش ارائه می‌دهد
    • وقتی با asState API جدید استفاده می‌شود، تنها راه برای بار کردن داده‌های بیشتر است
    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 برداشته است.
  • PagingState API closestItemAroundPosition جدیدی اضافه شد تا مورد بارشده‌ای را که به موقعیت هدف نزدیک‌تر است و با گزاره ورودی مطابقت دارد بازیابی کند. از این ویژگی می‌توان برای تولید کلیدهای بازآوری مبتنی بر مورد استفاده کرد، جایی که مورد قابل‌لنگر انداختن ایده‌آل در اطراف موقعیت هدف دقیق قرار دارد اما دقیقاً در آن موقعیت نیست.

نسخه 3.4.0-rc01

‫۱۴ ژانویه ۲۰۲۶

‫androidx.paging:paging-*:3.4.0-rc01 منتشر شده است. نسخه 3.4.0-rc01 حاوی این موارد ثبت است.

ویژگی‌های جدید

نسخه 3.4.0-beta01

‫۱۷ دسامبر ۲۰۲۵

‫androidx.paging:paging-*:3.4.0-beta01 منتشر شده است. نسخه 3.4.0-beta01 حاوی این ارسال‌ها است.

رفع اشکال‌ها

  • Fix race between RecyclerView and Refresh loads leading to IndexOutOfBoundsException in RecyclerView. به‌روزرسانی‌های منقطع میانای کاربر به‌دلیل بارگیری‌های مداوم Refresh می‌تواند باعث شود وضعیت «صفحه‌بندی» با RecyclerView همگام‌سازی نشود. این مشکل با بازنشانی «صفحه‌بندی» به وضعیت پیش‌از «بازآوری» درصورت قطع شدن «بازآوری» (یعنی با بارگیری متوالی Refresh) برطرف می‌شود. (I771b0، b/409809768)

نسخه 3.4.0-alpha04

‫۱۰ سپتامبر ۲۰۲۵

‫androidx.paging:paging-*:3.4.0-alpha04 منتشر شده است. نسخه 3.4.0-alpha04 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • PagingState API closestItemAroundPosition جدیدی اضافه شد تا مورد بارشده‌ای را که به موقعیت هدف نزدیک‌تر است و با گزاره ورودی مطابقت دارد بازیابی کند. از این ویژگی می‌توان برای تولید کلیدهای بازآوری مبتنی بر مورد استفاده کرد، جایی که مورد قابل‌لنگر انداختن ایده‌آل در اطراف موقعیت هدف دقیق قرار دارد اما دقیقاً در آن موقعیت نیست. (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)

تغییرات میانای برنامه‌سازی کاربردی

نسخه 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 حاوی این ارسال‌ها است.

ویژگی‌های جدید

رفع اشکال‌ها

  • آزمایش‌های واحد 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 منتشر شده است. نسخه ۳.۳.۶ حاوی این ثبت‌ها است.

رفع اشکال‌ها

  • سیگنال‌های بازآوری و تکرار ارسال‌شده درطول بازآوری اولیه اکنون ذخیره می‌شوند و به‌محض آماده شدن ارائه‌دهنده صفحه‌بندی، به‌طور خودکار دوباره ارسال می‌شوند.

همیاری خارجی

  • از Eva برای ارسال رفع اشکال (#۷۵۴) سپاس‌گزاریم

نسخه ۳.۳.۵

‫۱۱ دسامبر ۲۰۲۴

‫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 اکنون کلاس عمومی است. اکنون می‌توان ارائه‌دهنده‌های چندپلاتفرمی را به‌جای نیاز به میاناهای برنامه‌سازی کاربردی صفحه‌بندی داخلی یا AsyncPagingDataDiffer paging-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 اکنون کلاس عمومی است. اکنون می‌توان ارائه‌دهنده‌های چندپلاتفرمی را به‌جای نیاز به میاناهای برنامه‌سازی کاربردی صفحه‌بندی داخلی یا AsyncPagingDataDiffer paging-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)

همیاری خارجی

نسخه 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)))). این جریان را به @Preview composables به‌عنوان گیرنده برای 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ها است.

همیاری خارجی

  • از Veyndan برای مشارکت در انتقال Paging از جزئیات Android/JVM سپاس‌گزاریم. (#553، #554، #555، #559)

نسخه 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 Compose 1.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)
  • asSnapshot API دیگر نیازی به ارسال CoroutineScope ندارد. اکنون به‌طور پیش‌فرض از بافت به‌ارث‌رسیده از دامنه ولی خود استفاده می‌کند. (Id0a78، b/282240990)
  • پارامترهای سازنده TestPager دوباره مرتب شدند تا به‌طور شهودی با ترتیب پارامترهای سازنده واقعی Pager مطابقت داشته باشند (I6185a)
  • Migrated paging-testing's use of lambda type () -> PagingSource<Key, Value> to type PagingSourceFactory<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)

همیاری‌های خارجی

نسخه 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> مستقیم ترجمه می‌کند. asSnapshot lambda به شما امکان می‌دهد میانای کاربر برنامه‌تان را ازطریق میاناهای برنامه‌سازی کاربردی مثل 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() فعال می‌کند. این کار به‌طور غیرمستقیم اجازه می‌دهد از روش کتابخانه استاندارد Kotlin flatten هنگام ارائه 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 برای RemoteMediator REFRESH true باشد، اما نه برای PagingSource. این رفتار اکنون ادغام شده است تا همیشه false را برگرداند زیرا هیچ‌گاه منطقی نیست که REFRESH پایانه باشد، و اکنون به‌عنوان بخشی از قرارداد میانای برنامه‌سازی کاربردی در LoadStates مستند شده است. هنگام تصمیم‌گیری درباره اینکه آیا صفحه‌بندی خاتمه یافته است، همیشه باید این کار را با توجه به جهت‌های APPEND یا PREPEND انجام دهید. (I047b6)
  • ‫LoadStates از Paging اکنون قبل‌از انتشار پایین‌دست بین نسل‌ها، منتظر مقادیر معتبر از هر دو PagingSource و RemoteMediator می‌ماند. این کار از ارسال نسل‌های جدید PagingData در NotLoading در CombinedLoadStates.source.refresh جلوگیری می‌کند، اگر قبلاً Loading بوده باشد؛ نسل‌های جدید PagingData اکنون همیشه به‌درستی با Loading برای حالت بازآوری شروع می‌شوند، به‌جای اینکه ابتدا در برخی موارد به‌اشتباه به NotLoading بازنشانی شوند.

    Cancellation on past generations now happen eagerly on invalidation / new generations. دیگر نباید لازم باشد از collectLatest .در Flow<PagingData> استفاده شود، هرچند همچنان به‌شدت توصیه می‌شود این کار را انجام دهید. (I0b2b5، b/177351336، b/195028524)

  • ‫.loadStateFlow و .addLoadStateListener در میاناهای ارائه‌دهنده دیگر به‌طور زائد CombinedLoadStates اولیه‌ای را ارسال نمی‌کنند که همیشه حالت‌های میانجی آن روی null و حالت‌های منبع آن روی NotLoading(endOfPaginationReached = false) تنظیم شده باشد. این یعنی:

    1. اگر از RemoteMediator استفاده کنید، حالت‌های میانجی همیشه پر می‌شوند.
    2. ثبت شنونده loadState جدید یا جمع‌آورنده جدید در .loadStateFlow دیگر بلافاصله مقدار فعلی را منتشر نمی‌کند اگر CombinedLoadStates واقعی را از PagingData دریافت نکرده باشد. این اتفاق زمانی می‌افتد که جمع‌آوری‌کننده یا شنونده قبل‌از ارسال PagingData شروع به کار کند. (I1a748)

نسخه 3.1.0-alpha03

‫۲۱ ژوئیه ۲۰۲۱

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

همیاری خارجی

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 shell adb 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.append to only transition from Loading to NotLoading after both mediator and source load states are NotLoading to 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 در رشته اصلی هنگام استفاده از پیاده‌سازی PagingSource Room برطرف می‌کند.

نسخه 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.append to only transition from Loading to NotLoading after both mediator and source load states are NotLoading to 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 }
    

    (Ib5570، b/173530908)

رفع اشکال‌ها

  • ‫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() and firstItemOrNull() (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ها است.

«کتابخانه صفحه‌بندی» به نسخه ۳.۰ به‌روزرسانی شده است تا چندین ویژگی جدید اصلی را فعال کند.

ویژگی‌های جدید نسخه ۳.۰

مشکلات شناخته‌شده

  • صفحه‌بندی ۳ 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 a DataSource or directly testing a DataSource with 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