Paging

Tabel ini mencantumkan semua artefak dalam grup androidx.paging.

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada Paging, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

dependencies {
  def paging_version = "3.1.1"

  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:1.0.0-alpha17"
}

dependencies {
  val paging_version = "3.1.1"

  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:1.0.0-alpha17")
}

Untuk informasi cara menggunakan ekstensi Kotlin, lihat dokumentasi ktx.

Untuk informasi selengkapnya tentang dependensi, lihat Menambahkan Dependensi Build.

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Versi 3.2

Versi 3.2.0-alpha03

24 Oktober 2022

androidx.paging:paging-*:3.2.0-alpha03 dirilis. Versi 3.2.0-alpha03 berisi commit ini.

Pengujian Paging

Rilis ini berisi artefak baru: paging-testing. Artefak ini menyediakan API yang didesain untuk menguji unit setiap lapisan aplikasi Anda dan integrasinya dengan Paging secara terpisah.

Misalnya, rilis pertama ini menyertakan class TestPager yang memungkinkan Anda memvalidasi perilaku implementasi PagingSource kustom Anda sendiri secara independen dari Pager dan UI sebenarnya yang biasanya perlu simulasi integrasi Paging menyeluruh.

TestPager harus dianggap sebagai palsu - pengujian ganda yang mencerminkan implementasi sebenarnya dari Pager, sekaligus menyediakan platform API yang disederhanakan untuk menguji PagingSource. API ini adalah suspend API dan harus dijalankan dalam runTest seperti yang dijelaskan dalam panduan untuk Menguji coroutine Kotlin di Android.

Contoh penggunaan API ini dapat ditemukan di pengujian room-paging, yang difaktorkan ulang untuk menggunakan TestPager.

Perubahan API

• Memungkinkan iterasi yang nyaman melalui LoadResult.Page.data hingga LoadResult.Page.iterator(). Tindakan ini secara tidak langsung memungkinkan penggunaan metode flatten library standar Kotlin saat diberi List<LoadResult.Page>, seperti dengan properti pages dari PagingState yang diteruskan ke metode PagingSource.getRefreshKey. (Ie0718)

Versi 3.2.0-alpha02

10 Agustus 2022

androidx.paging:paging-*:3.2.0-alpha02 dirilis. Versi 3.2.0-alpha02 berisi commit ini.

Fitur Baru

• Paging sekarang menyediakan log melalui class AsyncPagingDataDiffer atau PagingDataAdapter untuk menampilkan informasi proses debug yang dikumpulkan dari PagingData.
• Log dapat diaktifkan melalui perintah adb shell adb shell setprop log.tag.Paging [DEBUG|VERBOSE].(b/235527159)

Perbaikan Bug

• Memperbaiki error konstruktor PagingDataDiffer yang hilang saat menggunakan paging-common:3.2.0-alpha01 dengan runtime paging-runtime:3.1.1 atau yang lebih lama.(b/235256201)

Versi 3.2.0-alpha01

1 Juni 2022

androidx.paging:paging-*:3.2.0-alpha01 dirilis. Versi 3.2.0-alpha01 berisi commit ini.

Perubahan API

• Menambahkan konstruktor untuk PagingDataAdapter dan AsyncPagingDataDiffer yang menerima CoroutineContext, bukan CoroutineDispatcher. (Idc878)
• Secara default, PagingData.from() dan PagingData.empty() tidak akan lagi memengaruhi CombinedLoadStates di sisi presenter. Overload baru yang memungkinkan penerusan sourceLoadStates dan remoteLoadStates ke konstruktor ini telah ditambahkan untuk mempertahankan perilaku setelan LoadStates yang ada agar sepenuhnya menjadi terminal (yaitu, NotLoading(endOfPaginationReached = false)), dengan opsi untuk menyertakan juga status jarak jauh jika diperlukan. Jika LoadStates tidak diteruskan, CombinedLoadStates sebelumnya akan dipertahankan di sisi presenter saat menerima PagingData statis. (Ic3ce5, b/205344028)

Perbaikan Bug

• Hasil PagingSource.getRefreshKey() kini diprioritaskan dengan benar atas initialKey jika akan menampilkan null, tetapi initialKey non-null ditetapkan. (Ic9542, b/230391606)

Kontribusi Eksternal

• Diupdate: compose:ui:ui-test api (updateApi) karena migrasi test-coroutines-lib (I3366d)

Versi 3.1

Versi 3.1.1

9 Maret 2022

androidx.paging:paging-*:3.1.1 dirilis. Versi 3.1.1 berisi commit ini.

Perbaikan Bug

• Menghapus peristiwa LoadState.NotLoading perantara antara beberapa generasi yang salah disisipkan oleh .cachedIn(). Perubahan ini sangat mempermudah reaksi terhadap perubahan LoadState dengan menghapus peristiwa LoadState.NotLoading redundan yang dihasilkan antara mencoba ulang pemuatan yang gagal, saat memuat ulang atau selama pembatalan validasi.

Versi 3.1.0

17 November 2021

androidx.paging:paging-*:3.1.0 dirilis. Versi 3.1.0 berisi commit berikut ini.

Perubahan penting sejak versi 3.0.0

• Flow<PagingData>.observable API dan Flow<PagingData>.flowable API tidak lagi bersifat eksperimental
• Perubahan perilaku pada LoadState:
  • endOfPaginationReached sekarang selalu false untuk LoadType.REFRESH untuk PagingSource dan RemoteMediator
  • LoadStates dari Paging sekarang menunggu nilai yang valid dari PagingSource dan RemoteMediator sebelum memunculkan downstream. Sekarang, generasi baru PagingData akan selalu dimulai dengan benar menggunakan Loading untuk status refresh, bukan salah direset ke NotLoading dalam beberapa kasus.
  • .loadStateFlow dan .addLoadStateListener pada API presenter tidak lagi secara berlebihan mengirim CombinedLoadStates awal yang selalu memiliki status mediator yang ditetapkan ke null
• Pembatalan generasi sebelumnya kini segera terjadi pada saat invalidasi/generasi baru. Seharusnya tidak lagi harus menggunakan .collectLatest di Flow<PagingData>, walaupun masih direkomendasikan untuk melakukannya.
• PagingSource.LoadResult.Invalid telah ditambahkan sebagai jenis nilai baru yang ditampilkan dari PagingSource.load, sehingga menyebabkan Paging menghapus permintaan pemuatan yang tertunda atau yang akan datang ke PagingSource ini dan membatalkan validasinya. Jenis nilai yang ditampilkan ini dirancang untuk menangani data yang berpotensi tidak valid atau tidak berlaku yang dapat ditampilkan dari database atau jaringan.
• Menambahkan API presenter .onPagesPresented dan .addOnPagesUpdatedListener yang terpicu secara sinkron saat halaman ditampilkan di UI. Pembaruan halaman dapat terjadi dalam skenario berikut:
  • Pemuatan awal pembuatan PagingData baru selesai, terlepas dari apakah pembuatan baru tersebut berisi perubahan pada item yang ditampilkan. Dengan kata lain, pembuatan baru menyelesaikan pemuatan awal tanpa pembaruan karena daftar yang sama persis akan tetap memicu callback ini.
  • Halaman disisipkan, meskipun halaman yang disisipkan tidak berisi item baru.
  • Halaman akan dihapus, meskipun halaman yang dilepas kosong.

Versi 3.1.0-rc01

3 November 2021

androidx.paging:paging-*:3.1.0-rc01 dirilis. Versi 3.1.0-rc01 berisi commit berikut ini.

Perbaikan Bug

• Memperbaiki kondisi race + kebocoran memori dalam .cachedIn() jika beberapa peristiwa pemuatan dikirim oleh downstream Paging saat tidak ada pengamat atau antara waktu saat observer beralih ke PagingData baru. (Ib682e)

Versi 3.1.0-beta01

13 Oktober 2021

androidx.paging:paging-*:3.1.0-beta01 dirilis. Versi 3.1.0-beta01 berisi commit berikut ini.

Perbaikan Bug

• Memperbaiki masalah saat banyak akses item cepat dapat menyebabkan item tersebut dihapus untuk pertimbangan dalam prefetchDistance, sehingga pemuatan halaman terhenti. Hal ini terutama menjadi masalah saat banyak letak item ditata sekaligus dalam urutan yang akan memprioritaskan pemuatan terhadap arah scroll pengguna. Akses item ini sekarang di-buffer dan diprioritaskan secara sinkron agar tidak dihapus. (aosp/1833273)

Versi 3.1.0-alpha04

29 September 2021

androidx.paging:paging-*:3.1.0-alpha04 dirilis. Versi 3.1.0-alpha04 berisi commit berikut ini.

Perubahan API

• Flow<PagingData>.observable API dan Flow<PagingData>.flowable API tidak lagi bersifat eksperimental. (Ie0bdd)

Perbaikan Bug

• Untuk LoadStates, endOfPaginationReached sekarang selalu false untuk LoadType.REFRESH. Sebelumnya, endOfPaginationReached dapat menjadi true untuk RemoteMediator REFRESH, tetapi tidak untuk PagingSource. Perilaku ini sekarang digabungkan untuk selalu menampilkan false karena tidak masuk akal untuk REFRESH menjadi terminal, dan kini didokumentasikan sebagai bagian dari kontrak API di LoadStates. Saat menentukan apakah penomoran halaman dihentikan, Anda harus selalu melakukannya sesuai dengan arahan APPEND atau PREPEND. (I047b6)

• LoadStates dari Paging sekarang menunggu nilai yang valid dari PagingSource dan RemoteMediator sebelum menghasilkan downstream antar-generasi. Hal ini mencegah generasi baru PagingData mengirim NotLoading di CombinedLoadStates.source.refresh jika sudah Memuat; generasi baru PagingData sekarang akan selalu dimulai dengan benar karena Memuat untuk status refresh, bukan terlebih dulu mereset ke NotLoading dengan tidak benar di beberapa kasus.

  Pembatalan generasi sebelumnya kini segera terjadi pada saat invalidasi/ generasi baru. Sekarang tidak perlu lagi menggunakan .collectLatest di Flow<PagingData>, meskipun sangat direkomendasikan untuk melakukannya. (I0b2b5, b/177351336, b/195028524)

• .loadStateFlow dan .addLoadStateListener pada API presenter tidak lagi mengirimkan inisial CombinedLoadStates berlebihan yang selalu memiliki status mediator yang disetel ke null dan status sumber yang disetel ke NotLoading(endOfPaginationReached = false). Ini berarti:

  1. Status mediator akan selalu terisi jika Anda menggunakan RemoteMediator.
  2. Mendaftarkan pemroses loadState baru atau kolektor baru pada .loadStateFlow tidak akan lagi memberikan nilai saat ini jika belum menerima CombinedLoadStates nyata dari PagingData. Hal ini dapat terjadi jika kolektor atau pemroses dimulai sebelum PagingData dikirimkan. (I1a748)

Versi 3.1.0-alpha03

21 Juli 2021

androidx.paging:paging-*:3.1.0-alpha03 dirilis. Versi 3.1.0-alpha03 berisi commit ini.

Perubahan API

• Jenis nilai yang ditampilkan LoadResult ketiga, LoadResult.Invalid ditambahkan ke PagingSource. Ketika PagingSource.load menampilkan LoadResult.Invalid, paging akan menghapus data yang dimuat dan membatalkan validasi PagingSource. Jenis nilai yang ditampilkan ini dirancang untuk menangani data yang berpotensi tidak valid atau tidak berlaku yang dapat ditampilkan dari database atau jaringan.

  Misalnya, jika database dasar mengalami penulisan, tetapi PagingSource tidak membatalkan validasi secara tepat waktu, mungkin akan menampilkan hasil yang tidak konsisten jika implementasinya bergantung pada tingkat ketetapan set data pendukung yang memuatnya (misalnya, penerapan db gaya LIMIT OFFSET). Dalam skenario ini, sebaiknya periksa pembatalan validasi setelah memuat dan menampilkan LoadResult.Invalid, yang menyebabkan Paging menghapus permintaan pemuatan yang tertunda atau mendatang di PagingSource ini dan membatalkan validasinya.

  Jenis nilai yang ditampilkan ini juga didukung oleh Paging2 API yang memanfaatkan LivePagedList atau RxPagedList. Saat menggunakan PagingSource dengan PagedList API Paging2, PagedList akan segera dilepaskan, sehingga menghentikan upaya untuk memuat data pada PagedList ini dan memicu pembatalan validasi pada PagingSource.

  LoadResult merupakan class tertutup, yang berarti perubahan ini tidak kompatibel dengan sumber sehingga kasus penggunaan langsung menggunakan hasil PagingSource.load harus menangani LoadResult.Invalid pada waktu kompilasi. Misalnya, pengguna Kotlin yang memanfaatkan when menyeluruh untuk memeriksa jenis nilai yang ditampilkan harus menambahkan pemeriksaan untuk Jenis tidak valid. (Id6bd3, b/191806126, b/192013267)

Perbaikan Bug

• Callback pembatalan validasi yang ditambahkan melalui PagingSource.registerInvalidatedCallback atau DataSource.addInvalidatedCallback kini terpicu secara otomatis jika terdaftar pada PagingSource / DataSource yang sudah tidak valid. Tindakan ini mengatasi kondisi race yang menyebabkan Paging menghilangkan sinyal pembatalan validasi dan macet saat diberikan Sumber yang tidak valid selama pemuatan awal. Selain itu, callback pembatalan validasi sekarang dihapus dengan benar setelah dipicu karena callback dijamin akan dipanggil paling banyak satu kali. (I27e69)
• Mengirimkan nilai awal placeholder (InitialPagedList) dari stream PagedList yang baru dibuat instance, misalnya, LivePagedListBuilder atau RxPagedListBuilder tidak akan lagi menghapus data yang dimuat sebelumnya.

Versi 3.1.0-alpha02

1 Juli 2021

androidx.paging:paging-*:3.1.0-alpha02 dirilis. Versi 3.1.0-alpha02 berisi commit ini.

Fitur Baru

• Menambahkan pemroses onPagesPresented dan API presenter alur yang segera terpicu setelah halaman yang ditampilkan diperbarui di UI.

  Karena pembaruan ini sinkron dengan UI, Anda dapat memanggil metode adaptor seperti .snapshot, .getItemCount, untuk memeriksa status setelah pembaruan diterapkan. Perhatikan bahwa .snapshot() dibiarkan dipanggil secara eksplisit karena dapat menjadi mahal jika dilakukan pada setiap pembaruan.

  Pembaruan halaman dapat terjadi dalam skenario berikut:

  • Pemuatan awal pembuatan PagingData baru selesai, terlepas dari apakah pembuatan baru tersebut berisi perubahan pada item yang ditampilkan. Dengan kata lain, pembuatan baru menyelesaikan pemuatan awal tanpa pembaruan karena daftar yang sama persis akan tetap memicu callback ini.
  • Halaman disisipkan, meskipun halaman yang disisipkan tidak berisi item baru
  • Halaman dihapus, meskipun halaman yang dihapus kosong (I272c9, b/189999634)

Perbaikan Bug

• Mengakses PagedList.dataSource dari nilai awal yang dihasilkan oleh LivePagedList atau RxPagedList tidak akan salah lagi melempar IllegalStateException (I96707)

Versi 3.1.0-alpha01

2 Juni 2021

androidx.paging:paging-*:3.1.0-alpha01 dirilis. Versi 3.1.0-alpha01 berisi commit ini.

Perubahan API

• Class yang disediakan oleh paging-rxjava3 kini ada dalam paket androidx.paging.rxjava3 sehingga tidak berkonflik dengan paging-rxjava2 (Ifa7f6)

Perbaikan Bug

• Memperbaiki masalah saat Paging terkadang mengirimkan peristiwa lain tanpa pengoperasian ke RecyclerView, yang dapat menyebabkan pemroses tertentu dipicu lebih awal. (Ic507f, b/182510751)

Kontribusi Eksternal

• Menambahkan API compat PagedList yang tidak digunakan lagi ke artefak rxjava3 (Id1ce2, b/182497591)

Paging Compose Versi 1.0.0

Versi 1.0.0-alpha17

24 Oktober 2022

androidx.paging:paging-compose:1.0.0-alpha17 dirilis. Versi 1.0.0-alpha17 berisi commit berikut ini.

Fitur Baru

• Tambahkan dukungan untuk CoroutineContext kustom saat memanggil collectLazyPagingItems. (I7a574, b/243182795, b/233783862)

Versi 1.0.0-alpha16

10 Agustus 2022

androidx.paging:paging-compose:1.0.0-alpha16 dirilis. Versi 1.0.0-alpha16 berisi commit berikut ini.

Fitur Baru

• Paging sekarang menyediakan log melalui class LazyPagingItems untuk menampilkan informasi proses debug yang dikumpulkan dari PagingData.
• Log dapat diaktifkan melalui perintah adb shell, yakni adb shell setprop log.tag.Paging [DEBUG|VERBOSE]. ([b/235527159}(https://issuetracker.google.com/issues/235527159))

Perbaikan Bug

• Memperbaiki error konstruktor PagingDataDiffer yang hilang saat menggunakan paging-compose:1.0.0-alpha15 dengan paging-common:3.1.1 atau yang lebih lama.(b/235256201,b/239868768)

Versi 1.0.0-alpha15

1 Juni 2022

androidx.paging:paging-compose:1.0.0-alpha15 dirilis. Versi 1.0.0-alpha15 berisi commit ini.

Perubahan API

• Menambahkan konstruktor untuk PagingDataAdapter dan AsyncPagingDataDiffer yang menerima CoroutineContext, bukan CoroutineDispatcher. (Idc878)

Perbaikan Bug

• LazyPagingItems kini menetapkan loadState awal untuk memuat ulang LoadState.Loading. (I55043, b/224855902)

Versi 1.0.0-alpha14

13 Oktober 2021

androidx.paging:paging-compose:1.0.0-alpha14 dirilis. Versi 1.0.0-alpha14 berisi commit berikut ini.

Versi 1.0.0-alpha13

29 September 2021

androidx.paging:paging-compose:1.0.0-alpha13 dirilis. Versi 1.0.0-alpha013 berisi commit berikut ini.

Perubahan API

• Fungsi LazyPagingItems.snapshot() diganti dengan properti LazyPagingItems.itemSnapshotList (Ie2da8)
• LazyPagingItems.getAsState() yang tidak digunakan lagi telah dihapus (Ie65e4)

Versi 1.0.0-alpha12

21 Juli 2021

androidx.paging:paging-compose:1.0.0-alpha12 dirilis. Versi 1.0.0-alpha12 berisi commit ini.

Perubahan API

• items(lazyPagingItems) dan itemsIndexed(lazyPagingItems) yang digunakan untuk menghubungkan Paging dengan LazyColumn/Row sekarang menerima parameter kunci opsi yang memungkinkan Anda menentukan kunci stabil yang menampilkan item. Anda dapat membaca selengkapnya tentang kunci di sini. (I7986d)
• Fungsi lazyPagingItems.getAsState(index) kini tidak digunakan lagi. Gunakan lazyPagingItems[index] saja. (I086cb, b/187339372)

Versi 1.0.0-alpha11

30 Juni 2021

androidx.paging:paging-compose:1.0.0-alpha11 dirilis. Versi 1.0.0-alpha11 berisi commit berikut ini.

Versi 1.0.0-alpha10

2 Juni 2021

androidx.paging:paging-compose:1.0.0-alpha10 dirilis. Versi 1.0.0-alpha10 berisi commit berikut.

Versi 1.0.0-alpha09

18 Mei 2021

androidx.paging:paging-compose:1.0.0-alpha09 dirilis. Versi 1.0.0-alpha09 berisi commit berikut ini.

Perbaikan Bug

• itemCount dan pengambil item LazyPagingItems kini dapat diobservasi sehingga juga dapat digunakan dengan LazyVerticalGrid (Ie2446, b/171872064, b/168285687)

Kompatibilitas Compose

• androidx.paging:paging-compose:1.0.0-alpha09 hanya kompatibel dengan Compose versi 1.0.0-beta07 dan yang lebih baru.

Versi 1.0.0-alpha08

24 Februari 2021

androidx.paging:paging-compose:1.0.0-alpha08 dirilis. Versi 1.0.0-alpha08 berisi commit berikut.

Diupdate untuk diintegrasikan dengan Compose 1.0.0-beta01.

Versi 1.0.0-alpha07

10 Februari 2021

androidx.paging:paging-compose:1.0.0-alpha07 dirilis. Versi 1.0.0-alpha07 berisi commit berikut ini.

Diperbarui agar dapat berintegrasi dengan Compose alpha12.

Versi 1.0.0-alpha06

28 Januari 2021

androidx.paging:paging-compose:1.0.0-alpha06 dirilis. Versi 1.0.0-alpha06 berisi commit berikut ini.

Perbaikan Bug

Diperbarui agar bergantung pada Compose 1.0.0-alpha11.

Versi 1.0.0-alpha05

13 Januari 2021

androidx.paging:paging-compose:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit ini.

Diperbarui agar bergantung pada Compose 1.0.0-alpha10.

Versi 1.0.0-alpha04

16 Desember 2020

androidx.paging:paging-compose:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit berikut ini.

Perbaikan Bug

• Memperbarui properti kemudahan, CombinedLoadStates.refresh, CombinedLoadStates.prepend, dan CombinedLoadStates.append agar hanya bertransisi dari Loading ke NotLoading setelah pemuatan sumber dan mediator dalam status NotLoading untuk memastikan pembaruan jarak jauh telah diterapkan. (I65619)

Versi 1.0.0-alpha03

2 Desember 2020

androidx.paging:paging-compose:1.0.0-alpha03 dirilis. Versi 1.0.0-alpha03 berisi commit berikut ini.

• Diperbarui agar cocok dengan Compose 1.0.0-alpha08.

Versi 1.0.0-alpha02

11 November 2020

androidx.paging:paging-compose:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Perubahan API

• Menambahkan metode .peek(), .snapshot(), .retry(), dan .refresh() ke LazyPagingItem yang menunjukkan fungsi sama dengan yang tersedia di AsyncPagingDataDiffer / PagingDataAdapter (Iddfe8, b/172041660)

Versi 1.0.0-alpha01

28 Oktober 2020

androidx.paging:paging-compose:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

Artefak paging-compose menyediakan integrasi antara Library Paging dan Jetpack Compose. Contoh penggunaan sederhana:

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

Versi 3.0.1

Versi 3.0.1

21 Juli 2021

androidx.paging:paging-*:3.0.1 dirilis. Versi 3.0.1 berisi commit berikut ini.

Perbaikan Bug

• Mengakses PagedList.dataSource dari nilai awal yang dihasilkan oleh LivePagedList atau RxPagedList tidak akan lagi salah menampilkan IllegalStateException (I96707)

Versi 3.0.0

Versi 3.0.0

5 Mei 2021

androidx.paging:paging-*:3.0.0 dirilis. Versi 3.0.0 berisi commit berikut ini.

Fitur utama 3.0.0

Sebagian besar API yang ada dari Paging 2.x.x tidak digunakan lagi dan digantikan dengan API Paging 3 baru untuk menghadirkan peningkatan berikut:

• Dukungan kelas satu untuk coroutine Kotlin dan Flow
• Dukungan untuk pembatalan
• Status pemuatan bawaan dan sinyal error
• Fungsionalitas coba lagi + refresh
• Ketiga subclass DataSource telah digabungkan ke dalam class PagingSource terpadu
• Transformasi halaman kustom termasuk transformasi bawaan untuk menambahkan pemisah
• Header dan footer status pemuatan

Versi 3.0.0-rc01

21 April 2021

androidx.paging:paging-*:3.0.0-rc01 dirilis. Versi 3.0.0-rc01 berisi commit berikut ini.

Perbaikan Bug

• Memperbaiki masalah saat Paging terkadang mengirimkan peristiwa lain tanpa pengoperasian ke RecyclerView, yang dapat menyebabkan pemroses tertentu dipicu lebih awal. (Ic507f, b/182510751)

Versi 3.0.0-beta03

24 Maret 2021

androidx.paging:paging-*:3.0.0-beta03 dirilis. Versi 3.0.0-beta03 berisi commit berikut ini.

Perbaikan Bug

• Kami telah mengubah cara penanganan placeholder saat daftar dimuat ulang untuk mencegah lompatan tidak terduga di RecyclerView. Lihat NullPaddedDiffing.md untuk detail selengkapnya. (If1490, b/170027529, b/177338149)
• Berbagai builder PagedList (jalur kompatibilitas lama) tidak lagi salah memanggil DataSource.Factory.create() secara sinkron di thread Utama saat .build() dipanggil. (b/182798948)

Versi 3.0.0-beta02

10 Maret 2021

androidx.paging:paging-*:3.0.0-beta02 dirilis. Version 3.0.0-beta02 berisi commit berikut ini.

Perubahan API

• Ekstensi Rx3 kini memperluas persyaratan Opt-In @ExperimentalCoroutinesApi dengan benar. Sebelumnya ekstensi ini ditandai pada metode @get, yang diabaikan oleh Kotlin Compiler karena: https://youtrack.jetbrains.com/issue/KT-45227 (I5733c)

Perbaikan Bug

• Menerapkan batasan di penggunaan publik API eksperimental (I6aa29, b/174531520)
• Memperbaiki bug yang menyebabkan PagingState selalu null saat pemuatan ulang jarak jauh dipanggil.
• Memperbaiki bug saat halaman kosong yang ditampilkan oleh PagingSource dapat mencegah Paging agar tidak mengambil data lagi untuk memenuhi prefetchDistance yang menyebabkan Paging “terhenti”.

Versi 3.0.0-beta01

10 Februari 2021

androidx.paging:paging-*:3.0.0-beta01 dirilis. Versi 3.0.0-beta01 berisi commit berikut ini.

Perubahan API

• Wrapper Rx2 dan Rx3 sekarang mengekspos anotasi eksperimental yang menjadi dependensinya. Jika menggunakan wrapper kompatibilitas Rx di paging-rxjava2 atau paging-rxjava3, Anda sekarang perlu memberi anotasi pada penggunaan dengan @OptIn(ExperimentalCoroutinesApi::class) (Ib1f9d)

Perbaikan Bug

• Memperbaiki IndexOutOfBoundsException: Inconsistency detected yang terkadang dilempar saat menggunakan DataSource API v2 melalui jalur kompatibilitas
• Panggilan isInvalid selama inisialisasi DataSource saat digunakan melalui jalur kompatibilitas kini diluncurkan dengan benar di fetchDispatcher, bukan di thread utama. Tindakan ini memperbaiki IllegalStateException karena akses Db di thread utama saat menggunakan implementasi PagingSource Room.

Versi 3.0.0-alpha13

27 Januari 2021

androidx.paging:paging-*:3.0.0-alpha13 dirilis. Versi 3.0.0-alpha13 berisi commit berikut.

Perubahan API

• PagingSource.getRefreshKey tidak lagi bersifat opsional untuk diimplementasikan, fungsi tersebut sekarang menjadi fungsi abstrak tanpa implementasi default. Memigrasikan pengguna dapat terus menampilkan implementasi default, yang hanya menampilkan null, tetapi getRefreshKey() harus memiliki implementasi nyata yang menampilkan kunci berdasarkan posisi scroll saat ini dari pengguna yang memungkinkan Paging terus memuat di tengah area pandang melalui PagingState.anchorPosition jika memungkinkan. (I4339a)
• InvalidatingPagingSourceFactory sekarang menjadi class final (Ia3b0a)
• Mengizinkan konfigurasi perilaku pemisah terminal (header/footer) dengan parameter SeparatorType opsional tambahan. Kedua opsi tersebut adalah:
  • FULLY_COMPLETE - perilaku yang ada; menunggu hingga PagingSource dan RemoteMediator menandai endOfPaginationReached sebelum menambahkan pemisah terminal. Jika RemoteMediator tidak digunakan, loadState jarak jauh akan diabaikan. Hal ini berguna terutama jika Anda hanya ingin menampilkan pemisah bagian ketika bagian tersebut dimuat sepenuhnya, termasuk pengambilan dari sumber jarak jauh, misalnya jaringan.
  • SOURCE_COMPLETE - hanya menunggu PagingSource untuk menandai endOfPaginationReached meskipun RemoteMediator digunakan. Hal ini memungkinkan header dan footer ditampilkan secara sinkron dengan pemuatan awal, sehingga pengguna tidak perlu men-scroll untuk melihat pemisah terminal. (Ibe993, b/174700218)

Perbaikan Bug

• Memperbaiki kebocoran memori yang jarang, yang terjadi ketika PagingSource tidak valid sebelum PageFetcher dapat mulai memuat darinya. (I9606b, b/174625633)

Versi 3.0.0-alpha12

13 Januari 2021

androidx.paging:paging-*:3.0.0-alpha12 dirilis. Versi 3.0.0-alpha12 berisi commit berikut.

Perubahan API

• InvalidatingPagingSourceFactory tidak lagi menjadi class abstrak karena tidak pernah memiliki metode abstrak. (I4a8c4)
• Menambahkan overload .cachedIn() yang menerima ViewModel, bukan Lifecycle atau CoroutineScope untuk pengguna Java. (I97d81, b/175332619)
• Mengizinkan pemanggil Java untuk menggunakan operasi transformasi PagingData secara asinkron, dengan menerima Executor ke dalam argumen operator transformasi. Akhiran -Sync pada semua operator transformasi -Sync kini telah dihapus, dan sebagai gantinya, pengguna Coroutine Kotlin harus membedakan dengan memanggil fungsi ekstensi yang menerima blok penangguhan. Semua operator transformasi PagingData telah dipindahkan ke ekstensi di bawah class PagingDataTransforms statis. Pengguna Java harus memanggilnya melalui helper statis, misalnya, PagingDataTransforms.map(pagingData, transform) Untuk pengguna Kotlin, sintaksisnya sama, tetapi Anda harus mengimpor fungsi tersebut. (If6885, b/172895919)

Perbaikan Bug

• Memperbaiki bug saat RemoteMediator.load() tidak akan dipanggil selama adapter.refresh() jika akhir paging sudah tercapai.

Versi 3.0.0-alpha11

16 Desember 2020

androidx.paging:paging-*:3.0.0-alpha11 dirilis. Versi 3.0.0-alpha11 berisi commit berikut ini.

Fitur Baru

• Menambahkan dukungan status tersimpan untuk kasus penggunaan dasar berikut (dukungan penuh, terutama untuk sumber berlapis, masih dalam proses):
  • alur di-cache dan aplikasi tidak ditutup (misalnya, alur di-cache dalam model tampilan dan aktivitas dibuat ulang dalam proses)
  • sumber paging dihitung, placeholder diaktifkan, dan tata letak tidak diatur.

Perubahan API

• PagingSource.getRefreshKey() sekarang menjadi API stabil (I22f6f, b/173530980)
• PagingSource.invalidate tidak lagi menjadi fungsi terbuka. Jika Anda perlu mendapatkan notifikasi saat pembatalan validasi terjadi, sebaiknya panggil metode registerInvalidatedCallback, bukan mengganti pembatalan validasi. (I628d9, b/173029013, b/137971356)
• Pager sekarang memiliki satu konstruktor eksperimental bersama dengan konstruktor regulernya, dan bukan membocorkan API eksperimental ke dalam API publik non-eksperimental melalui anotasi keikutsertaan. (I9dc61, b/174531520)
• Memperbarui properti kemudahan, CombinedLoadStates.refresh, CombinedLoadStates.prepend, dan CombinedLoadStates.append agar hanya bertransisi dari Loading ke NotLoading setelah pemuatan sumber dan mediator dalam status NotLoading untuk memastikan pembaruan jarak jauh telah diterapkan. (I65619)

• LoadParams.pageSize telah dihapus (sudah tidak digunakan lagi). Sebaiknya gunakan LoadParams.loadSize di PagingSource Anda.

  LoadParams.loadSize selalu sama dengan PagingConfig.pageSize kecuali untuk panggilan pemuatan awal yang sama dengan PagingConfig.initialLoadSize.

  Jika Anda menguji Paging2 DataSource tanpa menggunakan Pager atau PagedList, pageSize mungkin tidak cocok dengan PagingConfig.pageSize jika Anda juga menyetel initialLoadSize. Jika penting bagi pengujian Anda, coba gunakan Pager/PagedList saja, yang secara internal akan menyetel PageSize yang benar untuk metode pemuatan DataSource Anda. (I98ac7, b/149157296)

Perbaikan Bug

• Memperbaiki error karena IllegalStateException saat menggunakan pemisah dengan kumpulan PagingConfig.maxSize. (I0ed33, b/174787528)
• Memperbaiki bug saat status pemuatan untuk PREPEND/APPEND tidak segera diperbarui menjadi NotLoading(endOfPaginationReached = true) setelah pemuatan awal jika RemoteMediator disetel (I8cf5a)
• Memperbaiki bug saat API sisi presenter seperti .snapshot(), .peek(), dll., akan menampilkan daftar sebelumnya (yang sudah tidak berlaku) dalam pembaruan ListUpdateCallback.
• Memperbaiki bug saat operator Pemisah tidak akan menambahkan header atau footer ketika digunakan dengan RemoteMediator
• Memperbaiki bug saat pembaruan LoadState ke NotLoading untuk RemoteMediator akan terhenti dalam status Loading
• Memperbaiki bug saat API kompatibilitas Paging2.0, .asPagingSourceFactory(), dapat menyebabkan DataSource pendukung diinisialisasi pada CoroutineDispatcher yang salah. Tindakan ini akan memperbaiki error dan kemungkinan kasus ANR, terutama ketika menggunakan implementasi PagingSource saat ini dari Room, yang menggunakan jalur kompatibilitas ini.

Versi 3.0.0-alpha10

2 Desember 2020

androidx.paging:paging-*:3.0.0-alpha10 dirilis. Versi 3.0.0-alpha10 berisi commit berikut ini.

Perubahan API

• API dataRefreshFlow dan dataRefreshListener yang sudah tidak digunakan lagi telah dihapus karena redundan dengan pembaruan loadStateFlow/Listener. Bagi yang bermigrasi, nilai loadStateFlow yang setara adalah:

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

  (Ib5570, b/173530908)

Perbaikan Bug

• endOfPaginationReached untuk RemoteMediator REFRESH sekarang diperluas dengan benar ke pembaruan LoadState dan mencegah APPEND dan PREPEND jarak jauh dipicu. (I94a3f, b/155290248)
• Menyajikan daftar kosong karena halaman awal yang kosong atau pemfilteran yang berlebihan tidak lagi mencegah Paging memulai pemuatan PREPEND atau APPEND. (I3e702, b/168169730)
• Memperbaiki masalah saat getRefreshKey tidak dipanggil pada pembuatan PagingSource berikutnya saat pembatalan validasi terjadi dengan cepat. (I45460, b/170027530)

Kontribusi Eksternal

• Class abstrak baru InvalidatingPagingSourceFactory telah ditambahkan dengan .invalidate() API yang meneruskan pembatalan validasi ke semua PagingSources yang mengeluarkannya. Terima kasih kepada @claraf3. (Ie71fc, b/160716447)

Masalah Umum

• Header dan footer dari transformasi .insertSeparators() mungkin tidak langsung muncul saat menggunakan RemoteMediator b/172254056
• Menggunakan RemoteMediator dapat menyebabkan LoadState jarak jauh terhenti jika pembatalan validasi dan PagingSource.load(LoadParams.Refresh(...)) selesai sebelum RemoteMediator.load() ditampilkan b/173717820

Versi 3.0.0-alpha09

11 November 2020

androidx.paging:paging-*:3.0.0-alpha09 dirilis. Versi 3.0.0-alpha09 berisi commit berikut.

Perubahan API

• Metode dataRefreshFlow/Listener sepenuhnya tidak digunakan lagi dengan klausa replaceWith. (I6e2dd)

Perbaikan Bug

• Perbaikan untuk IllegalArgumentException ditampilkan saat menggunakan pemisah dengan RemoteMediator dan invalidate akan dipicu saat pemuatan jarak jauh yang akan menampilkan endOfPagination masih berjalan (I3a260)

Versi 3.0.0-alpha08

28 Oktober 2020

androidx.paging:paging-*:3.0.0-alpha08 dirilis. Versi 3.0.0-alpha08 berisi commit berikut.

Perubahan API

• Varian Kotlin/Java dari DataSource.InvalidatedCallback telah digabungkan dengan mengaktifkan konversi SAM di Kotlin melalui antarmuka fungsional (tersedia di Kotlin 1.4). Hal ini juga memperbaiki bug yang menyebabkan varian kotlin dari callback yang tidak divalidasi tidak dipanggil setelah ditransformasi oleh .map atau .mapByPage. (I1f244, b/165313046)

Perbaikan Bug

• Interaksi Paging dengan ViewPager menjadi jauh lebih baik. Terutama, Paging tidak akan lagi membatalkan panggilan RemoteMediator#load karena invalidasi halaman. Tindakan ini juga tidak akan lagi membuat permintaan pemuatan append/prepend, jika perlu REFRESH, hingga permintaan REFRESH berhasil diselesaikan. (I6390b, b/162252536)
• Pemeriksaan lint API untuk MissingGetterMatchingBuilder diaktifkan untuk androidx (I4bbea, b/138602561)
• Memperbaiki bug yang membuat helper .withLoadState* ConcatAdapter error karena memberi tahu RecyclerView dari thread latar belakang (I18bb5, b/170988309)
• Memperbaiki bug saat pemuatan halaman non-kosong yang sangat kecil terkadang mencegah pengambilan data sehingga tidak memicu pemuatan dengan benar.Iffda3 b/169259468

Versi 3.0.0-alpha07

1 Oktober 2020

androidx.paging:paging-*:3.0.0-alpha07 dirilis. Versi 3.0.0-alpha07 berisi commit berikut ini.

Perubahan API

• Operator PagingData asinkron berbasis Guava kini menerima Executor sebagai parameter, untuk mengontrol konteks eksekusi. (Id4372)

Perbaikan Bug

• Memperbaiki pengecualian IndexOutOfBounds yang ditampilkan di RemoteMediator karena kondisi race. (I00b7f, b/165821814)
• Memperbaiki kondisi race dalam konversi DataSource -> PagingSource yang dapat menyebabkan PagingSource yang dihasilkan mengabaikan sinyal invalidasi dari DataSource.
• Memperbaiki masalah dalam logika pengambilan halaman yang terkadang menyebabkan kegagalan pengambilan pembuatan PagingSource baru sampai PagingDataAdapter.refresh() dipanggil
• Memperbaiki masalah yang akan menyebabkan posisi scroll terkadang hilang saat menggunakan DataSource yang dikonversi ke PagingSource (seperti yang dihasilkan oleh Room), bersama RemoteMediator

Kontribusi Eksternal

• Terima kasih kepada @simonschiller yang telah menambahkan operator transformasi asinkron berbasis RxJava2, RxJava3, dan Guava untuk PagingData.

Versi 3.0.0-alpha06

2 September 2020

androidx.paging:paging-*:3.0.0-alpha06 dirilis. Versi 3.0.0-alpha06 berisi commit berikut.

Perubahan API

• UnsupportedOperationException dengan pesan yang lebih jelas seputar kurangnya dukungan untuk ID stabil kini ditampilkan setiap kali PagingDataAdapter.setHasStableIds dipanggil. (Ib3890, b/158801427)

Perbaikan Bug

• insertSeparator tidak lagi memfilter halaman kosong yang memungkinkan jarak pengambilan data diterima oleh presenter meskipun banyak halaman kosong disisipkan. (I9cff6, b/162538908)

Versi 3.0.0-alpha05

19 Agustus 2020

androidx.paging:paging-*:3.0.0-alpha05 dirilis. Versi 3.0.0-alpha05 berisi commit berikut ini.

Perbaikan Bug

• Kini paging mengambil data halaman dengan benar meskipun data yang disajikan memiliki banyak filter
• Menampilkan LoadResult.Error ke pemuatan yang dicoba ulang tidak lagi menyebabkan akses Item salah memicu kembali percobaan ulang

Kontribusi Eksternal

• Terima kasih kepada Clara F yang telah membantu membereskan beberapa pengujian. (549612)

Versi 3.0.0-alpha04

5 Agustus 2020

androidx.paging:paging-*:3.0.0-alpha04 dirilis. Versi 3.0.0-alpha04 berisi commit berikut.

Perubahan API

• Menambahkan peek() API ke AsyncPagingDataDiffer dan PagingDataAdapter untuk memungkinkan akses data yang disajikan tanpa memicu pemuatan halaman. (I38898, b/159104197)
• Menambahkan snapshot() API ke PagingDataAdapter dan AsyncPagingDataDiffer untuk memungkinkan pengambilan item yang disajikan tanpa memicu pengambilan halaman. (I566b6, b/159104197)
• Menambahkan konstruktor PagingData.from(List<T>) untuk memungkinkan penyajian daftar statis, yang dapat digabungkan dengan alur PagingData keseluruhan untuk menampilkan daftar statis di status tertentu, misalnya sebelum REFRESH awal selesai atau hanya untuk menguji transformasi. (Id134d)
• Menghentikan dataRefresh Flow/Listener API karena ini ditujukan untuk mengekspos status item yang ditampilkan pada REFRESH. Namun, dengan perbaikan pada pengaturan waktu callback loadState Flow/Listener, dan properti itemCount, API ini tidak diperlukan lagi (Ia19f3)
• Menambahkan wrapper kompatibilitas RxJava3 untuk PagingSource dan RemoteMediator (I49ef3, b/161480176)

Perbaikan Bug

• PositionalDataSource dikonversi menjadi PagingSource melalui helper toPagingSourceFactory, termasuk PagingSource yang dihasilkan oleh Room sekarang telah menandai dirinya dengan benar untuk mendukung jumping. (I3e84c, b/162161201)
• Memperbaiki bug untuk masalah penggunaan varian submitData sinkron yang terkadang menimbulkan race yang menyebabkan ClosedSendChannelException (I4d702, b/160192222)

Kontribusi Eksternal

• Terima kasih kepada Zac Sweers karena telah menambahkan wrapper kompatibilitas RxJava3 mewakili Slack. (I49ef3, b/161480176)

Versi 3.0.0-alpha03

22 Juli 2020

androidx.paging:paging-*:3.0.0-alpha03 dirilis. Versi 3.0.0-alpha03 berisi commit berikut ini.

Perubahan API

• Konstruktor untuk PagingState sekarang bersifat publik, sehingga seharusnya mempermudah implementasi pengujian getRefreshKey() (I8bf15)
• Varian fungsi peta kotlin DataSource disembunyikan dari Java untuk mengatasi masalah ambiguitas antara varian asli dan varian kotlin. (If7b23, b/161150011)
• API redundan yang ditujukan untuk memudahkan pengguna Kotlin telah ditandai @JvmSynthetic (I56ae5)
• Overload untuk konstruktor LoadResult.Page ditambahkan sehingga COUNT_UNDEFINED menjadi nilai default untuk itemsBefore dan itemsAfter (I47849)
• Operator PagingData yang sudah ada diubah agar mau menerima metode penangguhan, dan operator non-penangguhan mapSync, flatMapSync, dan filterSync baru diperkenalkan untuk pengguna Java. Metode transformasi yang ada telah dipindahkan ke fungsi ekstensi sehingga pengguna Kotlin kini harus mengimpornya. (I34239, b/159983232)

Perbaikan Bug

• Room (dan PositionalDataSource) PagingSources sekarang menampilkan pemisah utama sebagai bagian dari halaman pertama, sehingga pengguna tidak perlu men-scroll untuk memunculkannya. (I6f747, b/160257628)
• Pengaksesan item pada placeholder sekarang memicu pemuatan PagingSource dengan benar hingga halaman ditampilkan memenuhi indeks yang diminta setelah diubah oleh PagingData.filter() (I95625, b/158763195)
• Perbaikan bug yang terkadang dapat mencegah PagingDataAdapter.retry() mencoba lagi jika terjadi scroll setelah muncul pesan error yang dihasilkan PagingSource. (I1084f, b/160194384)
• Memperbaiki masalah ketika ada kemungkinan pengaksesan item setelah suatu halaman ditutup ternyata tidak memuat halaman meskipun pengaksesan item tersebut masih berada dalam prefetchDistance (Ie95ae, b/160038730)
• Setelan PagingConfig.maxSize tidak lagi mengaktifkan placeholder setelah peristiwa penutupan (I2be29, b/159667766)

Versi 3.0.0-alpha02

24 Juni 2020

androidx.paging:paging-*:3.0.0-alpha02 dirilis. Versi 3.0.0-alpha02 berisi commit berikut.

Perubahan API

• Penambahan overload untuk konstruktor PagingConfig dengan nilai default umum (I39c50, b/158576040)
• Menambahkan overload untuk konstruktor PagingDataAdapter dan AsyncPagingDataDiffer dengan nilai default umum (Ie91f5)
• API adaptor, dataRefreshFlow, dan dataRefreshListener sekarang meneruskan Boolean untuk memberi sinyal apakah PagingData kosong (I6e37e, b/159054196)
• Menambahkan RxJava dan Guava API untuk RemoteMediator - RxRemoteMediator dan ListenableFutureRemoteMediator
• Menambahkan bantuan ke PagingState untuk akses item umum seperti isEmpty() dan firstItemOrNull() (I3b5b6, b/158892717)

Perbaikan Bug

• Pager kini memeriksa penggunaan kembali PagingSource di factory, untuk mencegah penggunaan ulang PagingSource yang tidak valid secara tidak sengaja, sehingga menimbulkan error yang tidak jelas (I99809, b/158486430)
• Kegagalan dari RemoteMediator REFRESH tidak lagi mencegah pemuatan PagingSource (I38b1b, b/158892717)
• Versi non-penangguhan submitData tidak lagi menyebabkan error karena pengumpulan serentak pada beberapa PagingData ketika dipanggil setelah versi submitData yang ditangguhkan. (I26358, b/158048877)
• Memperbaiki pengecualian "tidak dapat dikumpulkan dua kali dari pager" yang dapat terjadi setelah perubahan konfigurasi (I58bcc, b/158784811)

Versi 3.0.0-alpha01

10 Juni 2020

androidx.paging:paging-*:3.0.0-alpha01 dirilis. Versi 3.0.0-alpha01 berisi commit berikut.

Library Paging telah diupdate ke versi 3.0, untuk mengaktifkan beberapa fitur penting baru.

Fitur Baru Versi 3.0

• Dukungan kelas satu untuk Flow dan coroutine Kotlin.
• Dukungan untuk pemuatan asinkron dengan fungsi penangguhan coroutine, primitif Guava ListenableFuture atau RxJava Single.
• Status pemuatan bawaan dan sinyal error untuk desain UI yang responsif, termasuk fungsi coba lagi (retry) dan refresh.
• Perbaikan pada lapisan repositori
  • Antarmuka sumber data yang disederhanakan
  • Penomoran halaman database + jaringan yang disederhanakan
  • Dukungan pembatalan
• Perbaikan pada lapisan presentasi
  • Transformasi halaman khusus
  • Pemisah daftar
  • Header dan footer status pemuatan

Masalah Umum

• Paging 3 javadocs belum tersedia. Untuk sementara, gunakan panduan yang ditautkan di atas atau dokumen Kotlin. (b/158614050)

Versi 2.1.2

Versi 2.1.2

18 Maret 2020

androidx.paging:paging:2.1.2 dirilis. Versi 2.1.2 berisi commit berikut pada 2.1.0.

Perbaikan Bug

• Perbaikan untuk IndexOutOfBoundsException dalam kasus yang jarang terjadi saat mengonversi posisi selama invalidasi.

Masalah rilis

• Versi Paging 2.1.1 dirilis secara tidak benar dari cabang yang salah dikonfigurasi, sehingga mengekspos API dan fungsionalitas yang diimplementasikan sebagian dalam rilis mendatang.

• Paging 2.1.2 berisi perbaikan pemusatan muatan yang awalnya dirilis pada 2.1.1, tetapi kali ini dipilih lebih teliti berdasarkan rilis 2.1.0. Sebaiknya Anda mengupgrade ke rilis ini, jika saat ini Anda menggunakan 2.1.1.

Versi 2.1.1

Versi 2.1.1

18 Desember 2019

androidx.paging:paging-*:2.1.1 dirilis. Versi 2.1.1 berisi commit berikut.

Perbaikan bug

• Pemuatan awal yang berdekatan dari PositionalDataSources kini terpusat di sekitar akses terakhir saat placeholder dinonaktifkan

Versi 2.1.0

Versi 2.1.0

25 Januari 2019

Paging 2.1.0 dirilis tanpa perubahan dari versi 2.1.0-rc01.

Versi 2.1.0-rc01

6 Desember 2018

Paging 2.1.0-rc01 dirilis tanpa perubahan dari versi 2.1.0-beta01.

Versi 2.1.0-beta01

1 November 2018

Paging 2.1.0-beta01 dirilis tanpa perubahan dari versi 2.1.0-alpha01.

Versi 2.1.0-alpha01

12 Oktober 2018

Paging 2.1.0-alpha01 memiliki dua tambahan utama - page dropping, dan library ekstensi KTX untuk setiap artefak - selain beberapa perubahan API dan perbaikan bug lainnya.

Perubahan API

• Penambahan PagedList.Config.Builder.setMaxSize() untuk membatasi jumlah item yang dimuat dalam memori.
• Penambahan androidx.paging.Config() sebagai alternatif Kotlin untuk PagedList.Config.Builder
• Penambahan androidx.paging.PagedList() sebagai alternatif Kotlin untuk PagedList.Builder
• Penambahan DataSourceFactory.toLiveData() sebagai alternatif Kotlin untuk LivePagedListBuilder
• Penambahan DataSourceFactory.toObservable() dan toFlowable() sebagai alternatif Kotlin untuk RxPagedListBuilder
• Penambahan AsyncPagedListDiffer.addPagedListListener() untuk memantau kapan PagedList ditukar. b/111698609
• Penambahan varian PagedListAdapter.onCurrentListChanged() yang meneruskan daftar lama dan baru; varian sebelumnya tidak digunakan lagi.
• Penambahan varian PagedListAdapter/AsyncPagedListDiffer.submitList() yang mengambil callback tambahan yang terpicu jika/ketika pagedlist ditampilkan, setelah diffing. Hal ini memungkinkan Anda untuk menyinkronkan pertukaran PagedList dengan update UI lainnya. b/73781068
• Penambahan PagedList.getLoadedCount() untuk memberitahukan jumlah item dalam memori. Perlu diketahui bahwa nilai yang ditampilkan akan selalu sama dengan .size() jika placeholder dinonaktifkan.

Perbaikan Bug

• Memperbaiki kondisi race saat melakukan diffing jika daftar digunakan kembali b/111591017
• PagedList.loadAround() sekarang menampilkan IndexOutOfBoundsException jika indeks tidak valid. Sebelumnya, masalah dapat terjadi dengan pengecualian lain yang tidak jelas.
• Memperbaiki masalah ketika ukuran pemuatan awal yang sangat kecil dan data yang tidak berubah berpotensi menghentikan pemuatan lebih lanjut. b/113122599

Versi 2.0.0

Versi 2.0.0

1 Oktober 2018

Paging 2.0.0 dirilis dengan satu perbaikan bug.

Perbaikan Bug

• Memperbaiki error yang dapat terjadi pada scroll yang sangat cepat menggunakan PositionalDataSource dan placeholder b/114635383.

Versi 2.0.0-beta01

2 Juli 2018

Perbaikan Bug

• Memperbaiki konten yang hilang dalam beberapa kasus prepend (placeholder dinonaktifkan, PositionalDataSource) b/80149146
• (Sudah dirilis dalam 1.0.1) Memperbaiki error ketika PagedListAdapter dan AsyncPagedListDiffer gagal menandai peristiwa pemindahan. b/110711937

Dependensi Pra-AndroidX

Untuk Paging versi pra-AndroidX, sertakan dependensi berikut:

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"
}

Versi 1.0.1

Versi 1.0.1

26 Juni 2018

Paging 1.0.1 dirilis dengan satu perbaikan bug di runtime. Kami sangat menganjurkan penggunaan 1.0.1 demi stabilitas. Paging RxJava2 1.0.1 juga dirilis, dan identik dengan 1.0.0-rc1.

Perbaikan Bug

• Memperbaiki error ketika PagedListAdapter dan AsyncPagedListDiffer gagal menandai peristiwa pemindahan. b/110711937

RxJava2 Versi 1.0.0

RxJava2 Versi 1.0.0-rc1

16 Mei 2018

Paging RxJava2 1.0.0-rc1 dialihkan ke kandidat rilis tanpa perubahan dari rilis alfa awal.

Versi 1.0.0

Versi 1.0.0-rc1

19 April 2018 Kandidat Rilis Paging

Kami tidak memiliki masalah umum atau fitur baru lagi yang dijadwalkan untuk rilis Paging 1.0.0. Harap upgrade project untuk menggunakan 1.0.0-rc1 dan bantu kami melakukan uji banding agar dapat merilis 1.0.0 yang sempurna.

Tidak ada perubahan dalam rilis ini, semuanya sama dengan versi 1.0.0-beta1.

Versi 1.0.0-beta01

5 April 2018

Paging akan berada dalam versi beta untuk waktu yang singkat sebelum menjadi kandidat rilis. Tidak ada rencana perubahan API lebih lanjut untuk Paging 1.0, dan standar untuk setiap perubahan API sangatlah tinggi.

Dukungan RxJava2 alfa untuk Paging dirilis sebagai modul opsional terpisah (android.arch.paging:rxjava2:1.0.0-alpha1) dan akan diberi versi sementara secara terpisah sampai stabil.

Library baru ini memberikan alternatif RxJava2 untuk LivePagedListBuilder, yang mampu merancang Observable dan Flowable, menggunakan Scheduler, bukannya Executor:

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

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

Fitur Baru

• RxPagedListBuilder ditambahkan melalui artefak android.arch.paging:rxjava2 baru.

Perubahan API

• Perubahan API untuk memperjelas peran eksekutor dalam builder:

  • Mengganti nama setBackgroundThreadExecutor() menjadi setFetchExecutor() (dalam PagedList.Builder dan LivePagedListBuilder)

  • Mengganti nama setMainThreadExecutor() menjadi setNotifyExecutor() (dalam PagedList.Builder).

• Memperbaiki anggota PagedList.mCallbacks menjadi pribadi.

Perbaikan Bug

• LivePagedListBuilder memicu pemuatan PagedList awal pada eksekutor yang ditentukan, bukannya kumpulan thread IO Komponen Arch.

• Memperbaiki perilaku pembatalan validasi dalam wrapper DataSource internal (yang digunakan untuk mengimplementasikan DataSource.map, serta pemuatan PositionalDataSource yang dinonaktifkan placeholder). b/77237534

Versi 1.0.0-alpha7

21 Maret 2018

Paging 1.0.0-alpha7 dirilis bersama Lifecycle 1.1.1. Karena Paging alfa7 bergantung pada pemindahan class Function sebagaimana disebutkan di atas, Anda harus memperbarui dependensi lifecycle:runtime ke android.arch.lifecycle:runtime:1.1.1.

Paging alpha7 direncanakan menjadi rilis final sebelum Paging mencapai beta.

Perubahan API

• Objek DataSource.LoadParams sekarang memiliki konstruktor publik dan objek DataSource.LoadCallback sekarang abstrak. Perubahan ini memungkinkan penggabungan DataSource atau pengujian DataSource secara langsung dengan callback palsu. b/72600421
• Mapper untuk DataSource dan DataSource.Factory
  • map(Function<IN,OUT>) memungkinkan Anda mengubah, menggabungkan, atau mendekorasi hasil yang dimuat DataSource.
  • mapByPage(<List<IN>,List<OUT>>) memungkinkan tindakan yang sama untuk batch processing (misalnya, jika item yang dimuat dari SQL harus mengkueri database terpisah, hal tersebut dapat dilakukan sebagai batch.)
• PagedList#getDataSource() ditambahkan sebagai metode yang mempermudah pekerjaan b/72611341
• Semua class yang tidak digunakan lagi telah dihapus dari API, termasuk sisa-sisa paket recyclerview.extensions dan LivePagedListProvider.
• DataSource.Factory diubah dari antarmuka menjadi class abstrak guna memungkinkan fungsi peta.

Perbaikan Bug

• Mengubah Builder menjadi final. b/70848565
• Perbaikan implementasi DataSource Room untuk menangani kueri multitabel. Perbaikan ini disertakan dalam Room 1.1.0-beta1, lihat di atas.
• Memperbaiki bug yang menyebabkan BoundaryCallback.onItemAtEndLoaded tidak dipanggil untuk PositionalDataSource jika placeholder diaktifkan dan ukuran total merupakan kelipatan persis ukuran halaman.

Versi 1.0.0-alpha5

22 Januari 2018

Perbaikan Bug

• Perbaikan pemuatan halaman saat placeholder dinonaktifkan b/70573345
• Logging tambahan untuk melacak bug IllegalArgumentException b/70360195 (dan perbaikan sisi Room spekulatif)
• Perbaikan kode contoh Javadoc b/70411933, b/71467637