Sayfalandırma

Paging kitaplığı, verileri uygulamanızın RecyclerView'ına kademeli ve sorunsuz bir şekilde yüklemenizi kolaylaştırır.

Bu tabloda, androidx.paging grubundaki tüm yapılar listelenir.

Yapı Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
paging-* 3.5.3 - - 3.6.0-alpha01
paging-compose 3.5.3 - - 3.6.0-alpha01
Bu kitaplık en son 18 Kasım 2026'da güncellenmiştir.

Bağımlılıkları bildirme

Sayfalandırma'ya bağımlılık eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposu sayfasını okuyun.

Uygulamanız veya modülünüz için build.gradle dosyasında ihtiyacınız olan yapıların bağımlılıklarını ekleyin:

Groovy

dependencies {
  def paging_version = "3.5.3"

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

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

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

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

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

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

Kotlin

dependencies {
  val paging_version = "3.5.3"

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

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

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

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

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

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

Kotlin uzantılarını kullanma hakkında bilgi edinmek için ktx belgelerine bakın.

Bağımlılıklar hakkında daha fazla bilgi için Derleme Bağımlılıkları Ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildirimleriniz Jetpack'i geliştirmemize yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir sorun için oy verebilirsiniz.

Yeni bir sorun oluşturma

Daha fazla bilgi için Issue Tracker belgelerine bakın.

Sürüm 3.6

Sürüm 3.6.0-alpha01

18 Kasım 2026

androidx.paging:paging-*:3.6.0-alpha01 yayınlandı. 3.6.0-alpha01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Lazy Foundations için ItemSnapshotList uzantı eklendi. Artık Lazy Foundation için itemKey ve contentType öğelerini otomatik olarak oluşturmak üzere ItemSnapshotList#itemKey ve ItemSnapshotList#itemContentType öğelerini çağırabilirsiniz. (I73455, b/560754841)

Harici Katkı

  • ItemSnapshotList uzantılarını eklediğiniz için teşekkür ederiz Kamal.

Sürüm 3.5

Sürüm 3.5.3

12 Ekim 2026

androidx.paging:paging-*:3.5.3 yayınlandı. 3.5.3 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • ItemSnapshotListFlow, bir RemoteMediator her iki yönde de sayfalama sonuna ulaştığında ve bir üstbilgi veya altbilgi terminal ayırıcıya dönüştürüldüğünde artık IllegalArgumentException oluşturmayacak. (I821c7, b/566336825)
  • Yüklenen sayfa sayısı PagingConfig.maxSize değerini aştığında, görüntü alanının verilerle düzgün şekilde doldurulması için yüklenen sayfalar iki sayfanın altına düşmez. (I037a0, b/565835910)

Harici Katkı

b/565835910 numaralı hata düzeltmesini gönderdiği için Igor'a teşekkür ederiz.

Sürüm 3.5.2

7 Ekim 2026

androidx.paging:paging-*:3.5.2 yayınlandı. 3.5.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • İlk yenileme tamamlanmadan önce yapılan Pager.append() çağrıları artık NoSuchElementException hatası vermeyecek. Ekleme çağrısı işlem yapmayacak. (Ide387, b/556780796)

Sürüm 3.5.1

12 Ağustos 2026

androidx.paging:paging-*:3.5.1 yayınlandı. 3.5.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Yer tutuculara kaydırırken ayırıcılar içeren bir sayfa yenilendiğinde PagingSource.getRefreshKey öğesinin çok büyük ve yanlış bir anchorPosition sağlaması sorunu düzeltildi. (I475f0, b/516565503)

Sürüm 3.5.0

6 Mayıs 2026

androidx.paging:paging-*:3.5.0 yayınlandı. 3.5.0 sürümü bu commit'leri içerir.

3.4.0 sürümünden sonra yapılan önemli değişiklikler:

  • Flow<PagingData> değerini Flow<ItemSnapshotList> değerine dönüştürmek için Flow<PagingData>.asItemSnapshotListFlow operatörü eklendi. Bu sayede, yüklenen verilere artık kullanıcı arayüzü katmanının dışından erişilebilir. Böylece Flow<ItemSnapshotList> öğesini diğer veri kaynaklarıyla birleştirebilir, sayfalandırılmış verileri yerel olarak önbelleğe alıp değiştirebilir veya sayfalandırılmış verileri kullanıcı arayüzü durumunun bir parçası olarak gösterebilirsiniz.

  • Kaydırma yapmadan manuel olarak daha fazla veri yüklemek için Pager.append ve Pager.prepend uzantı işlevleri eklendi.

  • asItemSnapshotListFlow API'si kullanılırken yükleme hatalarını düzeltmek için Pager.refresh ve Paging.retry uzantı işlevleri eklendi.

Sürüm 3.5.0-rc01

22 Nisan 2026

androidx.paging:paging-*:3.5.0-rc01 yayınlandı. 3.5.0-rc01 sürümü bu kayıtları içerir.

Değişiklik yok

  • 3.5.0-beta01 sürümünden bu yana önemli bir değişiklik yapılmadı.

Sürüm 3.5.0-beta01

8 Nisan 2026

androidx.paging:paging-*:3.5.0-beta01 yayınlandı. 3.5.0-beta01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Flow<PagingData>.asState API'sinin adı Flow<PagingData>.asItemSnapshotListFlow olarak değiştirildi (I0dc11, b/496548025)

Sürüm 3.5.0-alpha01

11 Mart 2026

androidx.paging:paging-*:3.5.0-alpha01 yayınlandı. 3.5.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

  • paging-common yapısı artık Flow<PagingData> üzerinde yeni bir asState akış operatörü içeriyor ve bu operatör, yapıyı Flow<ItemSnapshotList> değerine dönüştürüyor. Bu sayede aşağıdaki gibi özelliklerden yararlanabilirsiniz:

    • ItemSnapshotList akışını diğer veri kaynaklarıyla birleştirme
    • cachedIn olmadan birden fazla toplayıcıyla akış paylaşma
    • sayfalanmış verileri yerel olarak önbelleğe alma
    • Bellekteki sayfalanmış verileri değiştirme
    • sayfalandırılmış verileri kullanıcı arayüzü durumunun bir parçası olarak gösterme
    // 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 yapısı, yüklenen öğelerin her iki ucunda da yüklemeleri manuel olarak tetiklemek için Pager.append ve Pager.prepend API'lerini de ekledi.

    • paging-runtime veya paging-compose ile kullanıldığında, kaydırma dışında daha fazla veri yüklemek için bir alternatif sunar.
    • Yeni asState API ile kullanıldığında daha fazla veri yüklemenin tek yolu budur.
    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() }
      }
    }
    
  • asState API'si kullanılırken yükleme hatalarını düzeltmek için Pager.refresh ve Pager.retry eklendi. Yeni API'lerin diğer örnek kullanımları için bu dokümana bakın. (I1e1e9, If3c87, Idbd48, Id1e1d, I816fe)

Sürüm 3.4

Sürüm 3.4.2

11 Mart 2026

androidx.paging:paging-*:3.4.2 yayınlandı. 3.4.2 sürümü bu commit'leri içerir.

Değişiklik yok

  • Bu sürümde, 3.4.1 sürümüne kıyasla herhangi bir API veya davranış değişikliği yoktur.

Sürüm 3.4.1

11 Şubat 2026

androidx.paging:paging-*:3.4.1 yayınlandı. 3.4.1 sürümü bu commit'leri içerir.

Bağımlılık Güncellemesi

  • paging-guava'nın guava bağımlılığı 31.1 sürümünden 32.0.1 sürümüne güncellendi.

Sürüm 3.4.0

28 Ocak 2026

androidx.paging:paging-*:3.4.0 yayınlandı. 3.4.0 sürümü bu commit'leri içerir.

3.3.0 sürümünden sonra yapılan önemli değişiklikler:

  • paging-common, paging-testing ve paging-compose için daha fazla KMP hedefi eklendi. Artık tümü JVM (Android ve masaüstü), yerel (Linux, iOS, watchOS, tvOS, macOS, MinGW) ve web (JavaScript, WasmJS) platformlarını destekliyor.
  • paging-common, paging-testing ve paging-compose; Jetbrains'in macosX64 hedeflerini kullanımdan kaldırmasıyla uyumlu olacak şekilde macosX64, iosX64, watchosX64 ve tvosX64 desteğini kaldırdı.
  • Hedef konuma en yakın olan ve giriş yüklemiyle eşleşen yüklenen öğeyi almak için yeni bir PagingState API'si closestItemAroundPosition eklendi. Bu, ideal sabitlenebilir öğenin tam hedef konumda değil de yakınında olduğu öğe tabanlı yenileme anahtarları oluşturmak için kullanılabilir.

Sürüm 3.4.0-rc01

14 Ocak 2026

androidx.paging:paging-*:3.4.0-rc01 yayınlandı. 3.4.0-rc01 sürümü bu kayıtları içerir.

Yeni özellikler

Sürüm 3.4.0-beta01

17 Aralık 2025

androidx.paging:paging-*:3.4.0-beta01 yayınlandı. 3.4.0-beta01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • RecyclerView ve Refresh yüklemeleri arasında RecyclerView içinde IndexOutOfBoundsException ile sonuçlanan yarış düzeltildi. Sürekli Refresh yüklemeleri nedeniyle kullanıcı arayüzü güncellemelerinin kesintiye uğraması, sayfalama durumunun RecyclerView ile senkronizasyonunun bozulmasına neden olabilir. Yenileme işlemi kesintiye uğrarsa (ör. ardışık bir Refresh yüklemesi nedeniyle) sayfalama, yenileme öncesi durumuna sıfırlanarak bu sorun düzeltilir. (I771b0, b/409809768)

Sürüm 3.4.0-alpha04

10 Eylül 2025

androidx.paging:paging-*:3.4.0-alpha04 yayınlandı. 3.4.0-alpha04 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Hedef konuma en yakın olan ve giriş yüklemiyle eşleşen yüklenen öğeyi almak için yeni bir PagingState API'si closestItemAroundPosition eklendi. Bu, ideal sabitlenebilir öğenin tam hedef konumda değil de yakınında olduğu öğe tabanlı yenileme anahtarları oluşturmak için kullanılabilir. (I96e5c, b/440187139)

Sürüm 3.4.0-alpha03

27 Ağustos 2025

androidx.paging:paging-*:3.4.0-alpha03 yayınlandı. 3.4.0-alpha03 sürümü bu kayıtları içerir.

Yeni özellikler

  • Paging-common, yeni bir Kotlin Multiplatform (KMP) hedefi olarak masaüstünü ekledi. Şu anda JVM (Android ve masaüstü), yerel (Linux, iOS, watchOS, tvOS, macOS, MinGW) ve web (JavaScript, WasmJS) platformlarını destekliyor. (Id2483, b/436884811)
  • Paging-testing'e yeni Kotlin Multiplatform (KMP) hedefleri eklendi. Şu anda JVM (Android ve masaüstü), yerel (Linux, iOS, watchOS, tvOS, macOS, MinGW) ve web (JavaScript, WasmJS) platformlarını destekliyor. (I0c543, b/435014650)
  • Paging-compose'a yeni Kotlin Multiplatform (KMP) hedefleri eklendi. Şu anda JVM (Android ve masaüstü), yerel (Linux, iOS, watchOS, tvOS, macOS, MinGW) ve web (JavaScript, WasmJS) platformlarını destekliyor. (I70d44, b/436884801)

API Değişiklikleri

Sürüm 3.4.0-alpha02

30 Temmuz 2025

androidx.paging:paging-*:3.4.0-alpha02 yayınlandı. 3.4.0-alpha02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • PagingData.from artık placeholdersBefore ve placeholdersAfter ayarlarının yapılmasına olanak tanıyor. Bu yer tutucular arasında gezinmenin yüklemeleri tetiklemediğini unutmayın. (I06983)

Sürüm 3.4.0-alpha01

2 Temmuz 2025

androidx.paging:paging-*:3.4.0-alpha01 yayınlandı. 3.4.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

Hata Düzeltmeleri

  • Paging 3.3 veya sonraki sürümleri kullanan Android birim testleri artık PagingLogger'dan hata vermeyecek (Ia9400, b/331684448)
  • Kullanıcı RecyclerView öğesini güncellerken kaydırdığında RecyclerView öğesinin IndexOutOfBoundsException hatası vermesine neden olan hata düzeltildi (Id1f16, b/381024738).
  • Kaydırma sırasında yenileme yaparken sayfalama özelliğinin daha fazla yükleme tetikleyememesiyle ilgili hata düzeltildi. (I60ca5, b/352586078)
  • Sayfalama öğeleri yenilenirken kaydırma yapıldığında oluşan kilitlenme sorunu düzeltildi. (I8c65a, b/347649763)

Sürüm 3.3

Sürüm 3.3.6

12 Şubat 2025

androidx.paging:paging-*:3.3.6 yayınlandı. 3.3.6 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • İlk yenileme sırasında gönderilen yenileme ve yeniden deneme sinyalleri artık depolanacak ve sayfalama sunucusu hazır olduğunda otomatik olarak yeniden gönderilecek.

Harici Katkı

  • Hata düzeltmesini (#754) gönderdiği için Eva'ya teşekkür ederiz.

Sürüm 3.3.5

11 Aralık 2024

androidx.paging:paging-*:3.3.5 yayınlandı. 3.3.5 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Kullanıcı RecyclerView öğesini güncellerken kaydırdığında RecyclerView öğesinin IndexOutOfBoundsException hatası vermesine neden olan hata düzeltildi. (Id1f16, b/381024738)

Sürüm 3.3.4

13 Kasım 2024

androidx.paging:paging-*:3.3.4 yayınlandı. 3.3.4 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Paging 3.3 veya sonraki sürümleri kullanan Android birim testleri artık Method isLoggable in android.util.Log not mocked gibi bir hata vermeyecek. (Ia9400, b/331684448)

Sürüm 3.3.2

7 Ağustos 2024

androidx.paging:paging-*:3.3.2 yayınlandı. 3.3.2 sürümü bu commit'leri içerir.

Yeni özellikler

  • paging-common ve paging-testing, yeni Kotlin-Multiplatform hedefleri ekledi: watchos, tvos ve linuxArm64 (90c9768), (53e0eca)

Sürüm 3.3.1

24 Temmuz 2024

androidx.paging:paging-*:3.3.1 yayınlandı. 3.3.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • AsyncPagingDataDiffer veya bunun üzerine oluşturulan API'ler (ör. RecyclerView ile kullanılan PagingDataAdapter) kaydırma sırasında destekleyici veri kaynağı yenilendiğinde daha fazla yüklemeyi tetikleyemiyordu. Bu sorun düzeltildi. (I60ca5, b/352586078)
  • PagingDataAdapter veya AsyncPagingDataDiffer kullanarak RecyclerView kaydırılırken öğeler destekleyici veri kaynağından kaldırıldığında oluşan kilitlenme sorunu düzeltildi. (I8c65a, b/347649763)

Sürüm 3.3.0

14 Mayıs 2024

androidx.paging:paging-*:3.3.0 yayınlandı. 3.3.0 sürümü bu commit'leri içerir.

3.2.0 sürümünden sonra yapılan önemli değişiklikler

  • PagingDataPresenter artık herkese açık bir sınıf. Çoklu platform sunucuları artık dahili Paging API'leri veya paging-runtime'nin AsyncPagingDataDiffer sınıfını gerektirmek yerine PagingDataPresenter üzerine oluşturulabilir.
  • LoadStates öğesinin sırasıyla Hata veya NotLoading durumunda olup olmadığını kontrol etmek için hasError ve isIdle sınıflarına yeni LoadStates ve CombinedLoadStates yardımcı yöntemleri eklendi. Ayrıca, Flow<CombinedLoadStates> üzerinde, yükleme NotLoading veya hata durumuna geçene kadar bekleyen yeni bir awaitNotLoading() Kotlin uzantı yöntemi eklendi.
  • PagingData.empty(), oluşturucusuna özel LoadStates iletilmediği sürece artık varsayılan olarak NotLoading durumlarını gönderir. Bu, PagingDataAdapter öğesine gönderildiğinde LoadStates göndermediği veya LazyPagingItems olarak toplandığında yükleme durumları gönderdiği mevcut davranıştan farklıdır. LazyPagingItems olarak toplandığında, ilk oluşturma işleminden hemen sonra boş bir liste de gösterilir.

Kotlin Multiplatform Uyumluluğu

Paging, büyük ölçüde CashApp'in multiplatform-paging projesinden alınan çalışmalar sayesinde artık Kotlin Multiplatform ile uyumlu yapılar sunuyor.

  • paging-common, tüm Paging 3 API'lerini common'e taşıdı ve artık Android'in yanı sıra jvm ve iOS ile de uyumlu.
  • paging-testing, kodunu common konumuna taşıdı ve artık Android'in yanı sıra JVM ve iOS ile de uyumlu.
  • paging-compose, kodunu common konumuna taşıdı ve androidx.compose'nin çoklu platform desteğiyle eşleşen bir Android yapısı sunuyor.
  • paging-runtime, paging-guava, paging-rxjava2 ve paging-rxjava3 yalnızca Android'de kullanılabilir.

Sürüm 3.3.0-rc01

1 Mayıs 2024

androidx.paging:paging-*:3.3.0-rc01, Paging 3.3.0-beta01'de herhangi bir değişiklik yapılmadan yayınlandı. 3.3.0-rc01 sürümü bu kayıtları içerir.

Sürüm 3.3.0-beta01

3 Nisan 2024

androidx.paging:paging-*:3.3.0-beta01, önemli bir değişiklik olmadan yayınlandı. 3.3.0-beta01 sürümü bu kayıtları içerir.

Sürüm 3.3.0-alpha05

20 Mart 2024

androidx.paging:paging-*:3.3.0-alpha05 yayınlandı. 3.3.0-alpha05 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Paging artık ortak kod için AndroidX Annotation @MainThread ek açıklamasını kullanıyor. (I78f0d, b/327682438)

Sürüm 3.3.0-alpha04

6 Mart 2024

androidx.paging:paging-*:3.3.0-alpha04 yayınlandı. 3.3.0-alpha04 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Kotlin çoklu platform uyumluluğunun eklenmesiyle ilgili küçük doküman hataları düzeltildi. (aosp/2950785)

Sürüm 3.3.0-alpha03

7 Şubat 2024

androidx.paging:paging-*:3.3.0-alpha03 yayınlandı. 3.3.0-alpha03 sürümü bu kayıtları içerir.

Yeni özellikler

  • PagingDataPresenter artık herkese açık bir sınıf. Çoklu platform sunucuları artık dahili Paging API'leri veya paging-runtime'nin AsyncPagingDataDiffer sınıfını gerektirmek yerine PagingDataPresenter üzerine oluşturulabilir. (Id1f74, b/315214786)
  • LoadStates öğesinin Hata veya NotLoading durumunda olup olmadığını kontrol etmek için yeni LoadStates ve CombinedLoadStates yardımcı yöntemleri eklendi. Ayrıca, bir yükleme NotLoading veya hata durumuna geçene kadar LoadStateFlow üzerinde bekleyen yeni bir API eklendi. (Id6c67)

Davranış değişikliği

  • PagingData.empty(), oluşturucusuna özel LoadStates iletilmediği sürece artık varsayılan olarak NotLoading durumlarını gönderir. Bu, PagingDataAdapter öğesine gönderildiğinde LoadStates göndermediği veya LazyPagingItems olarak toplandığında yükleme durumları gönderdiği mevcut davranıştan farklıdır. LazyPagingItems olarak toplandığında, ilk oluşturma işleminden hemen sonra boş bir liste de gösterilir. (I4d11d, b/301833847)

Sürüm 3.3.0-alpha02

20 Eylül 2023

androidx.paging:paging-*:3.3.0-alpha02 yayınlandı. 3.3.0-alpha02 sürümü bu kayıtları içerir.

Kotlin Multiplatform Uyumluluğu

Paging, büyük ölçüde CashApp'in multiplatform-paging projesinden alınan çalışmalar sayesinde artık Kotlin Multiplatform ile uyumlu yapılar sunuyor. Bu sayede iki depo arasında farklılık oluşmasını önleyebilir ve depoların uyumlu kalmasını sağlayabiliriz.

  • paging-common, tüm Paging 3 API'lerini common'e taşıdı ve artık Android'in yanı sıra jvm ve iOS ile de uyumlu.
  • paging-testing, kodunu common konumuna taşıdı ve artık Android'in yanı sıra JVM ve iOS ile de uyumlu.
  • paging-compose, kodunu common konumuna taşıdı ve androidx.compose'nin çoklu platform desteğiyle eşleşen bir Android yapısı sunuyor.
  • paging-runtime, paging-guava, paging-rxjava2 ve paging-rxjava3 yalnızca Android'de kullanılabilir.

API Değişiklikleri

  • Yalnızca dahili kullanım için tasarlanan herkese açık Logger arayüzü kullanımdan kaldırıldı (I16e95, b/288623117).

Harici Katkı

Sürüm 3.3.0-alpha01

20 Eylül 2023

  • Bu, androidx.paging kitaplıklarının ilk çoklu platform sürümüdür. Bu sürümde yalnızca *-jvm ve *-android yapıları var. macOS, iOS ve Linux varyantları için 3.3.0-alpha02 kullanın.

Sürüm 3.2

Sürüm 3.2.1

6 Eylül 2023

androidx.paging:paging-*:3.2.1 yayınlandı. 3.2.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • asSnapshot(), yüklemenin ne zaman tamamlandığına dair bilgiye sahip olmadığından (PagingData.from(List, LoadStates) aşırı yüklemesinin aksine), PagingData.from(List) kullanılarak oluşturulan bir Flow iletildiğinde Paging Testing yapısının asSnapshot() API'sinin kilitlenmesine neden olan sorun düzeltildi. Bu geçici çözüm yalnızca tamamlanabilir akışlar (ör. flowOf(PagingData.from(...))) için geçerlidir. Tamamlanamayan akışlar (ör. MutableStateFlow) için LoadStates sağlayan PagingData.from aşırı yüklemesini kullanın. (I502c3)
  • Paging Compose, yeni verilerin yükleme tamamlandığında aynı karede kullanılabilir olmasını sağlamak için artık dahili olarak AndroidUiDispatcher.Main kullanıyor. (Ia55af)

Sürüm 3.2.0

26 Temmuz 2023

androidx.paging:paging-*:3.2.0 yayınlandı. 3.2.0 sürümü bu commit'leri içerir.

3.1.0 sürümünden sonra yapılan önemli değişiklikler

  • Paging Compose, API kararlılığına ulaştı ve Paging'in geri kalanına birleştirildi. Sürümü artık diğer tüm Paging yapılarıyla eşleşiyor. 3.1.0 sürümünden sonra yapılan değişiklikler:
    • PagingData.from(fakeData) oluşturup bunu PagingData MutableStateFlow içinde sarmalayarak (ör. MutableStateFlow(PagingData.from(listOf(1, 2, 3)))) sahte veri listesini önizleme desteği. Önizleme için collectAsLazyPagingItems() alıcısı olarak bu akışı @Preview bileşenlerine iletin.
    • LazyVerticalGrid ve HorizontalPager gibi tüm geç yüklenen düzenlerin yanı sıra Wear ve TV kitaplıklarındaki özel geç yüklenen bileşenler için destek. Bu, key ve contentType parametrelerini LazyColumn, LazyVerticalGrid için mevcut olan standart items API'lerine ve HorizontalPager gibi API'lerdeki eşdeğerlerine uygulamanıza yardımcı olan yeni alt düzey LazyPagingItems uzantı yöntemleri itemKey ve itemContentType ile sağlandı.
    • Yalnızca LazyListScope destekleyen items(lazyPagingItems) ve itemsIndexed(lazyPagingItems) kullanımdan kaldırıldı.
  • Uygulamanızın her katmanını ve Paging ile entegrasyonunu ayrı ayrı birim testine tabi tutmak için tasarlanmış API'ler sağlayan yeni paging-testing yapısı. Örneğin, şunları içerir:
    • TestPager sınıfını kullanabilirsiniz. Bu sınıf, kendi özel PagingSource uygulamanızın davranışını sayfa gezgininden ve gerçek kullanıcı arayüzünden bağımsız olarak doğrulamanıza olanak tanır.
    • ​​asPagingSourceFactory API'leri, testlerde bir sayfa gezginine aktarılabilecek PagingSourceFactory oluşturmak için Flow<List<Value>> veya statik List<Value> dönüştürür.
    • Flow<PagingData<Value>> üzerinde asSnapshot Kotlin uzantısı. Bu uzantı, Flow<PagingData<Value>> değerini doğrudan List<Value> değerine dönüştürür. asSnapshot lambda, scrollTo veya appendScrollWhile gibi API'ler aracılığıyla uygulamanızın kullanıcı arayüzünü taklit etmenize olanak tanır. Böylece, sayfalı veri kümenizin herhangi bir noktasında veri anlık görüntüsünün doğru olduğunu doğrulayabilirsiniz.
  • Sayfalama hata ayıklama bilgilerini iki düzeyde göstermek için varsayılan günlükler eklendi: VERBOSE ve DEBUG. Günlükler, adb shell setprop log.tag.Paging [DEBUG|VERBOSE] komutuyla etkinleştirilebilir. Bu durum, hem görünümlerle sayfalama hem de Compose ile sayfalama için geçerlidir.
  • PagingDataAdapter ve AsyncPagingDataDiffer için CoroutineDispatcher yerine CoroutineContext kabul eden yapıcılar eklendi.
  • Önceki () -> PagingSource lambda'lardan daha açık bir API yüzeyi sağlayan yeni bir PagingSourceFactory işlevsel arayüzü eklendi. Bu fabrika, bir sayfa gezginini örneklendirmek için kullanılabilir.

Sürüm 3.2.0-rc01

21 Haziran 2023

androidx.paging:paging-*:3.2.0-rc01 yayınlandı. 3.2.0-rc01 sürümü bu kayıtları içerir.

Harici Katkı

  • Paging'i Android/JVM özelliklerinden uzaklaştırmaya katkıda bulunan Veyndan'a teşekkür ederiz. (#553, #554, #555, #559)

Sürüm 3.2.0-beta01

7 Haziran 2023

androidx.paging:paging-*:3.2.0-beta01 yayınlandı. 3.2.0-beta01 sürümü bu kayıtları içerir.

Paging Compose

  • Paging Compose, API kararlılığına resmi olarak ulaştı. Bu nedenle, sürüm 1.0.0-alpha20 sürümünden diğer tüm Paging yapılarıyla eşleşecek şekilde güncellendi.

API Değişiklikleri

Sürüm 3.2.0-alpha06

24 Mayıs 2023

androidx.paging:paging-*:3.2.0-alpha06 yayınlandı. 3.2.0-alpha06 sürümü bu kayıtları içerir.

Yeni özellikler

  • Mevcut () -> PagingSource lambda'lardan daha açık bir API yüzeyi sağlayan yeni bir PagingSourceFactory işlevsel arayüzü eklendi. Bu fabrika, Pager örneklendirmek için kullanılabilir. (I33165, b/280655188)
  • Yalnızca sabit bir veri listesinden yüklenen PagingSourceFactory elde etmek için yeni List<Value>.asPagingSourceFactory() paging-testing API'si eklendi. Flow<List<Value>> üzerindeki mevcut uzantı, birden fazla statik veri nesliyle test yapmak için kullanılmaya devam edilmelidir. (Id34d1, b/280655188)

API Değişiklikleri

  • paging-testing'deki tüm herkese açık API'ler, yalnızca testlerde kullanılmalarını sağlamak için artık @VisibleForTesting ile ek açıklama eklenmiştir. (I7db6e)
  • asSnapshot API'si artık CoroutineScope parametresinin iletilmesini gerektirmiyor. Artık varsayılan olarak üst kapsamından devralınan bağlamı kullanır. (Id0a78, b/282240990)
  • TestPager oluşturucu parametreleri, gerçek Pager oluşturucu parametrelerinin sırasıyla sezgisel olarak eşleşecek şekilde yeniden sıralandı (I6185a).
  • paging-testing'in lambda türü () -> PagingSource<Key, Value> kullanımı PagingSourceFactory<Key, Value> türüne taşındı. (I4a950, b/280655188)

Davranış Değişiklikleri

  • asSnapshot sayfalama testlerini çalıştırmak için artık ana dağıtıcı gerekmiyor. Bu ayarın yapılması, test davranışında artık herhangi bir değişiklik yapmaz. (Ie56ea)

Sürüm 3.2.0-alpha05

3 Mayıs 2023

androidx.paging:paging-*:3.2.0-alpha05 yayınlandı. 3.2.0-alpha05 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • asSnapshot için Paging Testing API'nin loadOperations parametresi artık varsayılan olarak boş bir lambda değerine ayarlanıyor. Bu sayede, ilk yenileme yüklemesinden verileri almak için herhangi bir yükleme işlemi iletmeden asSnapshot çağrılabilir. (Ied354, b/277233770)

Belgelerle ilgili iyileştirmeler

  • asPagingSourceFactory() ile ilgili dokümanlar, PagingSource örnekleri oluşturmak için yeniden kullanılabilir bir fabrika döndüren Flow üzerinde bir uzantı yöntemi olduğunu açıklayacak şekilde güncellendi. (I5ff4f, I705b5)
  • Atlamayı desteklemek için itemsBefore ve itemsAfter yöntemlerinin geçersiz kılınması gerektiğini açıklamak amacıyla LoadResult.Page oluşturucusuyla ilgili dokümanlar güncellendi. (Ied354)

Harici Katkılar

Sürüm 3.2.0-alpha04

8 Şubat 2023

androidx.paging:paging-*:3.2.0-alpha04 yayınlandı. 3.2.0-alpha04 sürümü bu kayıtları içerir.

Sayfalama Testi

  • paging-testing yapısı artık bir sayfa gezginine sağlanacak Flow<List<Value>> öğesinden pagingSourceFactory oluşturmak için bir asPagingSourceFactory yöntemi içeriyor. Flow'dan yayılan her List<Value>>, bir sayfalara ayrılmış veri neslini temsil eder. Bu, sayfa gezgininin veri toplayacağı bir veri kaynağını taklit ederek örneğin PagingData dönüşümlerinde sayfalama testlerini kolaylaştırır. (I6f230, b/235528239)
  • paging-testing yapısı, Flow<PagingData<T>> içinde bulunan verilerin doğru olduğunu doğrulamaya uygun yeni API'lerle genişletildi. Bu, örneğin ViewModel katmanınızdan bir Flow<PagingData<T>> çıkışını onaylamak için kullanılabilir.

    Bu işlem, Flow<PagingData<Value>> üzerindeki asSnapshot Kotlin uzantısı aracılığıyla yapılır. Bu uzantı, Flow<PagingData<Value>> değerini doğrudan bir List<Value> değerine dönüştürür. asSnapshot lambda, scrollTo veya appendScrollWhile gibi API'ler aracılığıyla uygulamanızın kullanıcı arayüzünü tekrarlanabilir ve tutarlı bir şekilde taklit etmenize olanak tanır. Böylece, sayfalara ayrılmış veri kümenizin herhangi bir noktasında veri anlık görüntüsünün doğru olduğunu doğrulayabilirsiniz.

    // 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, runTest içinde çalıştırılması beklenen bir suspend yöntemidir. Daha fazla bilgi için Android'de Kotlin eş yordamlarını test etme başlıklı makaleyi inceleyin. (I55fd2, I5bd26, I7ce34, I51f4d, I2249f, Id6223, Ic4bab, Ib29b9, Ic1238, I96def, b/235528239)

API Değişiklikleri

  • AsyncPagingDataDiffer ve PagingDataAdapter içindeki getItem ve peek için kullanıcı arayüzü çağrıları artık yalnızca ana iş parçacığında çağrılabilir olarak doğru şekilde işaretleniyor. (I699b6)
  • TestPager tarafından kullanılan genel türlerden joker karakterler kaldırıldı. Böylece, bu yöntemlerin sonuçlarının Java programlama dilinde yazılmış kodlarda kullanılması kolaylaştırıldı. (I56c42)

Sürüm 3.2.0-alpha03

24 Ekim 2022

androidx.paging:paging-*:3.2.0-alpha03 yayınlandı. 3.2.0-alpha03 sürümü bu taahhütleri içerir.

Sayfalama Testi

Bu sürümde yeni bir yapı var: paging-testing. Bu yapı, uygulamanızın her katmanının birim testine ve Paging ile entegrasyonuna göre tasarlanmış API'ler sağlar.

Örneğin, bu ilk sürümde, normalde uçtan uca Paging entegrasyonunu simüle etmek için ihtiyaç duyacağınız Pager ve gerçek kullanıcı arayüzünden bağımsız olarak kendi özel PagingSource uygulamanızın davranışını doğrulamanıza olanak tanıyan bir TestPager sınıfı bulunur.

TestPager, sahte olarak kabul edilmelidir. Bu, Pager'in gerçek uygulamasını yansıtan ve PagingSource'yı test etmek için basitleştirilmiş bir API yüzeyi sağlayan bir test dublörüdür. Bu API'ler suspend API'leridir ve Android'de Kotlin eş yordamlarını test etme kılavuzunda açıklandığı gibi runTest içinde çalıştırılmalıdır.

Bu API'lerin kullanımına örnek olarak TestPager kullanacak şekilde yeniden düzenlenen room-paging testleri gösterilebilir.

API Değişiklikleri

  • LoadResult.Page.iterator() üzerinden LoadResult.Page.data üzerinde kolay iterasyon sağlar. Bu, PagingSource.getRefreshKey yöntemine iletilen PagingState öğesinin pages özelliği gibi bir List<LoadResult.Page> verildiğinde Kotlin standart kitaplığı flatten yönteminin dolaylı olarak kullanılmasına olanak tanır. (Ie0718)

Sürüm 3.2.0-alpha02

10 Ağustos 2022

androidx.paging:paging-*:3.2.0-alpha02 yayınlandı. 3.2.0-alpha02 sürümü şu taahhütleri içerir.

Yeni özellikler

  • Paging artık PagingData'den toplanan hata ayıklama bilgilerini göstermek için AsyncPagingDataDiffer veya PagingDataAdapter sınıfları aracılığıyla günlükler sağlar.
  • Günlükler, adb shell komutu adb shell setprop log.tag.Paging [DEBUG|VERBOSE]. ile etkinleştirilebilir (b/235527159).

Hata Düzeltmeleri

  • paging-common:3.2.0-alpha01, paging-runtime:3.1.1 veya daha eski çalışma zamanı ile kullanılırken eksik PagingDataDiffer oluşturucu hatası düzeltildi.(b/235256201)

Sürüm 3.2.0-alpha01

1 Haziran 2022

androidx.paging:paging-*:3.2.0-alpha01 yayınlandı. 3.2.0-alpha01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • PagingDataAdapter ve AsyncPagingDataDiffer için CoroutineDispatcher yerine CoroutineContext kabul eden yapıcılar eklendi. (Idc878)
  • Varsayılan olarak PagingData.from() ve PagingData.empty(), sunucu tarafında CombinedLoadStates'yi artık etkilemeyecek. sourceLoadStatesremoteLoadStatesLoadStates değerini tamamen terminal olarak ayarlama (ör. NotLoading(endOfPaginationReached = false)) ve gerekirse uzak durumları da dahil etme seçeneği sunar. LoadStates iletilmezse sunucu tarafı statik PagingData aldığında önceki CombinedLoadStates korunur. (Ic3ce5, b/205344028)

Hata Düzeltmeleri

  • PagingSource.getRefreshKey() işlevinin sonucu, null değer döndüreceği ancak null olmayan bir initialKey değerinin ayarlandığı durumlarda artık initialKey işlevine göre doğru şekilde önceliklendiriliyor. (Ic9542, b/230391606)

Harici Katkı

  • test-coroutines-lib taşıma işlemi nedeniyle :compose:ui:ui-test API'si (updateApi) güncellendi (I3366d).

Sürüm 3.1

Sürüm 3.1.1

9 Mart 2022

androidx.paging:paging-*:3.1.1 yayınlandı. 3.1.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • .cachedIn() tarafından yanlışlıkla eklenen, nesiller arasındaki ara LoadState.NotLoading etkinlikleri kaldırıldı. Bu değişiklik, başarısız yüklemeleri yeniden denerken, yenilerken veya geçersiz kılarken üretilen gereksiz LoadState.NotLoading etkinliklerini kaldırarak LoadState değişikliklerine tepki vermeyi çok daha kolay hale getirir.

Sürüm 3.1.0

17 Kasım 2021

androidx.paging:paging-*:3.1.0 yayınlandı. 3.1.0 sürümü bu commit'leri içerir.

3.0.0 sürümünden sonra yapılan önemli değişiklikler

  • Flow<PagingData>.observable ve Flow<PagingData>.flowable API'leri artık deneysel değil
  • LoadState ile ilgili davranış değişiklikleri:
    • endOfPaginationReached artık hem PagingSource hem de RemoteMediator için her zaman LoadType.REFRESH karşılığında false
    • Paging'den LoadStates, alt akışa yayınlanmadan önce hem PagingSource hem de RemoteMediator'den geçerli değerler bekliyor. PagingData için yeni nesiller artık her zaman yenileme durumu için doğru şekilde Loading ile başlayacak ve bazı durumlarda yanlışlıkla NotLoading olarak sıfırlanmayacak.
    • Sunucu API'lerindeki .loadStateFlow ve .addLoadStateListener, artık her zaman null olarak ayarlanmış aracı durumlarına sahip ilk CombinedLoadStates değerini gereksiz yere göndermiyor.
  • Geçmiş nesillerdeki iptal işlemi artık geçersiz kılma/yeni nesillerde hemen gerçekleşir. Flow<PagingData> üzerinde .collectLatest kullanılması artık zorunlu olmasa da bunu yapmanız önerilir.
  • PagingSource.LoadResult.Invalid, PagingSource.load için yeni bir dönüş türü olarak eklendi. Bu nedenle, sayfalama bu PagingSource için bekleyen veya gelecekteki yükleme isteklerini siler ve geçersiz kılar. Bu dönüş türü, veritabanından veya ağdan döndürülebilecek geçersiz ya da eski verileri işlemek için tasarlanmıştır.
  • Sayfalar kullanıcı arayüzünde sunulurken eşzamanlı olarak tetiklenen .onPagesPresented ve .addOnPagesUpdatedListener sunucu API'leri eklendi. Sayfa güncellemeleri aşağıdaki senaryolarda gerçekleşebilir:
    • Yeni nesil PagingData'nın ilk yüklemesi, yeni nesilde sunulan öğelerde herhangi bir değişiklik olup olmadığına bakılmaksızın tamamlanır. Örneğin: Liste tamamen aynı olduğu için güncelleme olmadan ilk yüklemeyi tamamlayan yeni bir nesil, bu geri çağırmayı tetiklemeye devam eder.
    • Eklenen sayfada yeni öğe olmasa bile sayfa eklenir.
    • Boş olsa bile bir sayfa bırakıldığında

Sürüm 3.1.0-rc01

3 Kasım 2021

androidx.paging:paging-*:3.1.0-rc01 yayınlandı. 3.1.0-rc01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Gözlemci yokken veya bir gözlemci yeni bir PagingData'ya geçiş yaparken Paging tarafından aşağı akışta birden fazla yükleme etkinliği gönderildiği durumlarda .cachedIn()'deki yarışma durumu ve bellek sızıntısı düzeltildi. (Ib682e)

Sürüm 3.1.0-beta01

13 Ekim 2021

androidx.paging:paging-*:3.1.0-beta01 yayınlandı. 3.1.0-beta01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Öğelere çok hızlı bir şekilde erişildiğinde, prefetchDistance'ta değerlendirilmek üzere bırakılmalarına ve sayfa yüklemelerinin durmasına neden olan bir sorun düzeltildi. Bu durum, özellikle birçok öğe aynı anda kullanıcının kaydırma yönüne göre yüklemeye öncelik verecek şekilde düzenlendiğinde sorun teşkil eder. Bu öğe erişimleri artık arabelleğe alınır ve bırakılmalarını önlemek için eşzamanlı olarak önceliklendirilir. (aosp/1833273)

Sürüm 3.1.0-alpha04

29 Eylül 2021

androidx.paging:paging-*:3.1.0-alpha04 yayınlandı. 3.1.0-alpha04 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Flow<PagingData>.observable ve Flow<PagingData>.flowable API'leri artık deneysel değil. (Ie0bdd)

Hata Düzeltmeleri

  • LoadStates için endOfPaginationReached artık her zaman LoadType.REFRESH için false. Daha önce, RemoteMediator REFRESH için endOfPaginationReached true olabiliyordu ancak PagingSource için bu mümkün değildi. Bu davranış artık her zaman false döndürecek şekilde birleştirildi. REFRESH'in terminal olması hiçbir zaman mantıklı olmadığından, artık LoadStates'teki API sözleşmesinin bir parçası olarak belgeleniyor. Sayfalandırmanın sonlandırılıp sonlandırılmayacağına karar verirken her zaman APPEND veya PREPEND yönlerine göre karar vermeniz gerekir. (I047b6)
  • Paging'deki LoadStates, nesiller arasında aşağı akış yaymadan önce hem PagingSource hem de RemoteMediator'dan geçerli değerleri bekler. Bu sayede, yeni PagingData nesillerinin, zaten Loading durumundaysa CombinedLoadStates.source.refresh içinde NotLoading göndermesi engellenir. Yeni PagingData nesilleri artık bazı durumlarda yanlış bir şekilde NotLoading olarak sıfırlanmak yerine her zaman doğru bir şekilde yenileme durumu için Loading ile başlar.

    Önceki nesillerin iptali artık geçersiz kılma/yeni nesillerde hemen gerçekleşir. Flow<PagingData> üzerinde .collectLatest kullanılması artık zorunlu olmasa da kullanılması önemle tavsiye edilir. (I0b2b5, b/177351336, b/195028524)

  • Sunucu API'lerindeki .loadStateFlow ve .addLoadStateListener, artık gereksiz yere aracı durumları null ve kaynak durumları NotLoading(endOfPaginationReached = false) olarak ayarlanmış bir ilk CombinedLoadStates göndermiyor. Bunun anlamı:

    1. RemoteMediator kullanıyorsanız aracı durumları her zaman doldurulur.
    2. .loadStateFlow üzerinde yeni bir loadState dinleyicisi veya yeni bir toplayıcı kaydetmek, PagingData üzerinden gerçek bir CombinedLoadStates almadıysa mevcut değeri hemen yayınlamayacak. Bu durum, bir toplayıcı veya dinleyici PagingData gönderilmeden önce başlatılırsa ortaya çıkabilir. (I1a748)

Sürüm 3.1.0-alpha03

21 Temmuz 2021

androidx.paging:paging-*:3.1.0-alpha03 yayınlandı. 3.1.0-alpha03 sürümü şu commit'leri içerir:

API Değişiklikleri

  • PagingSource'a üçüncü bir LoadResult dönüş türü olan LoadResult.Invalid eklendi. PagingSource.load, LoadResult.Invalid döndürdüğünde sayfalama, yüklenen verileri siler ve PagingSource'u geçersiz kılar. Bu dönüş türü, veritabanından veya ağdan döndürülebilecek geçersiz ya da eski verileri işlemek için tasarlanmıştır.

    Örneğin, temel veritabanına yazma işlemi yapılıyor ancak PagingSource zamanında geçersiz kılınmıyorsa, uygulamanın yüklediği destekleyici veri kümesinin değişmezliğine bağlı olması durumunda (ör. LIMIT OFFSET tarzı veritabanı uygulamaları) tutarsız sonuçlar döndürebilir. Bu senaryoda, yüklemeden sonra geçersiz kılma işlemini kontrol etmeniz ve LoadResult.Invalid değerini döndürmeniz önerilir. Bu işlem, Paging'in bu PagingSource'a yönelik bekleyen veya gelecekteki yükleme isteklerini silmesine ve geçersiz kılmasına neden olur.

    Bu dönüş türü, LivePagedList veya RxPagedList'ten yararlanan Paging2 API tarafından da desteklenir. PagingSource, Paging2'nin PagedList API'leriyle kullanıldığında PagedList hemen ayrılır. Bu PagedList'e veri yükleme girişimleri durdurulur ve PagingSource'da geçersiz kılma tetiklenir.

    LoadResult, kapalı bir sınıftır. Bu nedenle, doğrudan PagingSource.load sonuçlarını kullanan kullanım alanlarının derleme süresinde LoadResult.Invalid'i işlemesi gerektiğinden bu, kaynakla uyumlu olmayan bir değişikliktir. Örneğin, dönüş türünü kontrol etmek için exhaustive-when kullanan Kotlin kullanıcılarının geçersiz tür için bir kontrol eklemesi gerekir. (Id6bd3, b/191806126, b/192013267)

Hata Düzeltmeleri

  • PagingSource.registerInvalidatedCallback veya DataSource.addInvalidatedCallback aracılığıyla eklenen geçersiz kılma geri çağırmaları, geçersiz bir PagingSource/DataSource'a kaydedilmişse artık otomatik olarak tetiklenir. Bu sayede, ilk yükleme sırasında geçersiz olan bir kaynak sağlandığında sayfalama işleminin geçersiz kılma sinyallerini bırakmasına ve takılmasına neden olan yarışma durumu çözülür. Ayrıca, geçersiz kılma geri çağırmaları, en fazla bir kez çağrılmaları garanti edildiğinden tetiklendikten sonra düzgün bir şekilde kaldırılır. (I27e69)
  • Yeni örneklendirilmiş bir PagedList akışından (ör. LivePagedListBuilder veya RxPagedListBuilder) yer tutucu başlangıç değerini (InitialPagedList) göndermek, daha önce yüklenen verileri artık temizlemeyecek.

Sürüm 3.1.0-alpha02

1 Temmuz 2021

androidx.paging:paging-*:3.1.0-alpha02 yayınlandı. 3.1.0-alpha02 sürümü şu taahhütleri içerir:

Yeni özellikler

  • Sunulan sayfalar kullanıcı arayüzünde güncellendikten hemen sonra tetiklenen onPagesPresented dinleyici ve akış sunucu API'leri eklendi.

    Bu güncellemeler kullanıcı arayüzüyle eşzamanlı olduğundan, güncelleme uygulandıktan sonra durumu incelemek için .snapshot, .getItemCount gibi bağdaştırıcı yöntemlerini çağırabilirsiniz. .snapshot() yönteminin her güncellemede çalıştırılması maliyetli olabileceğinden açıkça çağrılması gerektiğini unutmayın.

    Sayfa güncellemeleri aşağıdaki senaryolarda gerçekleşebilir:

    • Yeni nesil PagingData'nın ilk yüklemesi, yeni nesilde sunulan öğelerde herhangi bir değişiklik olup olmadığına bakılmaksızın tamamlanır. Örneğin: Liste tamamen aynı olduğu için güncelleme olmadan ilk yüklemeyi tamamlayan yeni bir nesil, bu geri çağırmayı tetiklemeye devam eder.
    • Eklenen sayfada yeni öğe olmasa bile sayfa eklenir.
    • Bırakılan sayfa boş olsa bile sayfa bırakılır (I272c9, b/189999634)

Hata Düzeltmeleri

  • LivePagedList veya RxPagedList tarafından üretilen ilk değerden PagedList.dataSource'a erişmek artık yanlışlıkla IllegalStateException (I96707) hatası vermeyecek.

Sürüm 3.1.0-alpha01

2 Haziran 2021

androidx.paging:paging-*:3.1.0-alpha01 yayınlandı. 3.1.0-alpha01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • paging-rxjava3 tarafından sağlanan sınıflar artık androidx.paging.rxjava3 paketi altında yer alıyor. Böylece paging-rxjava2 ile çakışmıyorlar (Ifa7f6).

Hata Düzeltmeleri

  • Sayfalandırma'nın bazen RecyclerView'a işlem yapılmayan fark etkinlikleri göndermesine ve bu nedenle belirli dinleyicilerin erken tetiklenmesine neden olan bir sorun düzeltildi. (Ic507f, b/182510751)

Harici Katkı

  • Kullanımdan kaldırılan PagedList uyumluluk API'leri rxjava3 yapısına eklendi (Id1ce2, b/182497591)

Paging Compose 1.0.0 sürümü

Sürüm 1.0.0-alpha20

24 Mayıs 2023

androidx.paging:paging-compose:1.0.0-alpha20 yayınlandı. 1.0.0-alpha20 sürümü bu kayıtları içerir.

Yeni özellikler

  • Paging Compose artık PagingData.from(fakeData) oluşturup bu PagingData öğesini MutableStateFlow (ör. MutableStateFlow(PagingData.from(listOf(1, 2, 3)))) içine sarmalayarak sahte verilerden oluşan bir listeyi önizlemeyi destekliyor. Bu verileri @Preview öğenizin girişi olarak kullandığınızda collectAsLazyPagingItems() çağrıları, önizlenebilir LazyPagingItems sağlar. (I8a78d, b/194544557)

Hata Düzeltmeleri

  • LazyPagingItems uygulamasında toplanan pager.flow.cachedIn önbelleğe alınmış verileri, eşzamansız toplama gerektirmeden durum geri yüklemesinden hemen sonra kullanılabilir. Bu, önbelleğe alınan verilerin, durum geri yüklendikten sonra ilk oluşturma işleminde hemen sunulmaya hazır olacağı anlamına gelir. (I97a60, b/177245496)

Sürüm 1.0.0-alpha19

3 Mayıs 2023

androidx.paging:paging-compose:1.0.0-alpha19 yayınlandı. 1.0.0-alpha19 sürümü bu kayıtları içerir.

Tüm geç yüklenen düzenleri destekleme

Daha önce Paging Compose, LazyListScope üzerinde özel items ve itemsIndexed uzantıları sağlıyordu. Bu nedenle, Paging Compose'u LazyVerticalGrid, HorizontalPager gibi diğer geç listeleme düzenleriyle veya Wear ve TV kitaplıkları tarafından sağlanan diğer özel geç listeleme bileşenleriyle kullanamıyordunuz. Bu sürümdeki temel güncelleme, bu esneklik eksikliğini gidermektir.

Daha fazla geç yüklenen düzeni desteklemek için farklı bir katmanda API'ler oluşturmamız gerekiyordu. Paging Compose, her geç yüklenen düzen için özel bir items API'si sağlamak yerine artık itemKey ve itemContentType'de LazyPagingItems üzerinde biraz daha düşük seviyeli uzantı yöntemleri sağlıyor. Bu API'ler, LazyColumn ve LazyVerticalGrid için mevcut olan standart items API'lerine key ve contentType parametrelerini uygulamanıza yardımcı olmaya odaklanır. Ayrıca HorizontalPager gibi API'lerdeki eşdeğerlerini de uygulamanıza yardımcı olur. (Ifa13b, Ib04f0, b/259385813)

Bu durumda, LazyVerticalGrid desteklemek için şunları yapmanız gerekir:

// 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)
  }
}

Bu yeni API'lerin kullanımıyla ilgili daha fazla örnek için lütfen örneklerimizi inceleyin.

Bu değişiklikler LazyColumn ve LazyRow örneklerini birkaç satır uzatsa da tüm geç yüklenen düzenlerde tutarlılığın, gelecekte Paging Compose'u kullanacak kişiler için önemli bir faktör olduğunu düşündük. Bu nedenle, LazyListScope için mevcut uzantıların desteği sonlandırıldı. (I0c459, I92c8f, b/276989796)

API Değişiklikleri

  • Yeni API'lere geçişi kolaylaştırmak için LazyListScope üzerindeki items ve itemsIndexed uzantı işlevleri artık yeni API'lerdeki desteği yansıtan bir contentType parametresini destekliyor. (Ib1918, b/255283378)

Bağımlılık Güncellemeleri

  • Paging Compose, bağımlılığını Compose 1.0.5'ten Compose 1.2.1'e güncelledi. (Ib1918, b/255283378)

Sürüm 1.0.0-alpha18

8 Şubat 2023

androidx.paging:paging-compose:1.0.0-alpha18, değişiklik yapılmadan yayınlandı. 1.0.0-alpha18 sürümü bu commit'leri içerir.

Sürüm 1.0.0-alpha17

24 Ekim 2022

androidx.paging:paging-compose:1.0.0-alpha17 yayınlandı. 1.0.0-alpha17 sürümü şu commit'leri içerir:

Yeni özellikler

Sürüm 1.0.0-alpha16

10 Ağustos 2022

androidx.paging:paging-compose:1.0.0-alpha16 yayınlandı. 1.0.0-alpha16 sürümü bu kayıtları içerir.

Yeni özellikler

  • Paging artık PagingData'dan toplanan hata ayıklama bilgilerini göstermek için LazyPagingItems sınıfı aracılığıyla günlükler sağlar.
  • Günlükler, adb shell komutu adb shell setprop log.tag.Paging [DEBUG|VERBOSE] aracılığıyla etkinleştirilebilir. ([b/235527159}(https://issuetracker.google.com/issues/235527159))

Hata Düzeltmeleri

  • paging-compose:1.0.0-alpha15, paging-common:3.1.1 veya daha eski sürümlerle kullanıldığında ortaya çıkan eksik PagingDataDiffer oluşturucu hatası düzeltildi.(b/235256201,b/239868768)

Sürüm 1.0.0-alpha15

1 Haziran 2022

androidx.paging:paging-compose:1.0.0-alpha15 yayınlandı. 1.0.0-alpha15 sürümü bu kayıtları içerir.

API Değişiklikleri

  • PagingDataAdapter ve AsyncPagingDataDiffer için CoroutineDispatcher yerine CoroutineContext kabul eden yapıcılar eklendi. (Idc878)

Hata Düzeltmeleri

  • LazyPagingItems, ilk loadState değerini LoadState.Loading yenileme hızı olacak şekilde ayarlar. (I55043, b/224855902)

Sürüm 1.0.0-alpha14

13 Ekim 2021

androidx.paging:paging-compose:1.0.0-alpha14 yayınlandı. 1.0.0-alpha14 sürümü bu kayıtları içerir.

Sürüm 1.0.0-alpha13

29 Eylül 2021

androidx.paging:paging-compose:1.0.0-alpha13 yayınlandı. 1.0.0-alpha13 sürümü bu commit'leri içerir.

API Değişiklikleri

  • LazyPagingItems.snapshot() işlevi, LazyPagingItems.itemSnapshotList özelliğiyle değiştirildi (Ie2da8)
  • Desteği sonlandırılan LazyPagingItems.getAsState() kaldırıldı (Ie65e4)

Sürüm 1.0.0-alpha12

21 Temmuz 2021

androidx.paging:paging-compose:1.0.0-alpha12 yayınlandı. 1.0.0-alpha12 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Paging'i LazyColumn/Row ile bağlamak için kullanılan items(lazyPagingItems) ve itemsIndexed(lazyPagingItems), artık öğeyi temsil eden sabit bir anahtar belirtmenize olanak tanıyan isteğe bağlı anahtar parametresini kabul ediyor. Anahtarlar hakkında daha fazla bilgiyi burada bulabilirsiniz. (I7986d)
  • lazyPagingItems.getAsState(index) işlevi artık kullanımdan kaldırıldı. Bunun yerine lazyPagingItems[index] politikasını kullanın. (I086cb, b/187339372)

Sürüm 1.0.0-alpha11

30 Haziran 2021

androidx.paging:paging-compose:1.0.0-alpha11 yayınlandı. 1.0.0-alpha11 sürümü bu kayıtları içerir.

Sürüm 1.0.0-alpha10

2 Haziran 2021

androidx.paging:paging-compose:1.0.0-alpha10 yayınlandı. 1.0.0-alpha10 sürümü bu kayıtları içerir.

Sürüm 1.0.0-alpha09

18 Mayıs 2021

androidx.paging:paging-compose:1.0.0-alpha09 yayınlandı. 1.0.0-alpha09 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • LazyPagingItems'ın itemCount ve öğe alıcısı artık gözlemlenebilir olduğundan LazyVerticalGrid ile de kullanılabilir (Ie2446, b/171872064, b/168285687)

Compose uyumluluğu

  • androidx.paging:paging-compose:1.0.0-alpha09 yalnızca Compose 1.0.0-beta07 ve sonraki sürümlerle uyumludur.

Sürüm 1.0.0-alpha08

24 Şubat 2021

androidx.paging:paging-compose:1.0.0-alpha08 yayınlandı. 1.0.0-alpha08 sürümü şu taahhütleri içerir:

Compose 1.0.0-beta01 ile entegre olacak şekilde güncellendi.

Sürüm 1.0.0-alpha07

10 Şubat 2021

androidx.paging:paging-compose:1.0.0-alpha07 yayınlandı. 1.0.0-alpha07 sürümü bu kayıtları içerir.

Compose alpha12 ile entegre olacak şekilde güncellendi.

Sürüm 1.0.0-alpha06

28 Ocak 2021

androidx.paging:paging-compose:1.0.0-alpha06 yayınlandı. 1.0.0-alpha06 sürümü şu taahhütleri içerir:

Hata Düzeltmeleri

Compose 1.0.0-alpha11'e bağlı olacak şekilde güncellendi.

Sürüm 1.0.0-alpha05

13 Ocak 2021

androidx.paging:paging-compose:1.0.0-alpha05 yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları içerir.

Compose 1.0.0-alpha10'a bağlı olacak şekilde güncellendi.

Sürüm 1.0.0-alpha04

16 Aralık 2020

androidx.paging:paging-compose:1.0.0-alpha04 yayınlandı. 1.0.0-alpha04 sürümü şu commit'leri içerir:

Hata Düzeltmeleri

  • Uzaktan güncellemenin uygulandığından emin olmak için CombinedLoadStates.refresh, CombinedLoadStates.prepend, CombinedLoadStates.append kolaylık özellikleri, yalnızca hem uyumlulaştırıcı hem de kaynak yükleme durumları NotLoading olduğunda Loading durumundan NotLoading durumuna geçecek şekilde güncellendi. (I65619)

Sürüm 1.0.0-alpha03

2 Aralık 2020

androidx.paging:paging-compose:1.0.0-alpha03 yayınlandı. 1.0.0-alpha03 sürümü bu kayıtları içerir.

  • Compose 1.0.0-alpha08 sürümüne uyacak şekilde güncellendi.

Sürüm 1.0.0-alpha02

11 Kasım 2020

androidx.paging:paging-compose:1.0.0-alpha02 yayınlandı. 1.0.0-alpha02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • AsyncPagingDataDiffer / PagingDataAdapter ile aynı işlevleri sunan LazyPagingItem sınıflarına .peek(), .snapshot(), .retry() ve .refresh() yöntemleri eklendi (Iddfe8, b/172041660)

Sürüm 1.0.0-alpha01

28 Ekim 2020

androidx.paging:paging-compose:1.0.0-alpha01 yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

paging-compose yapısı, Paging kitaplığı ile Jetpack Compose arasında entegrasyon sağlar. Basit bir kullanım örneği:

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

Sürüm 3.0.1

Sürüm 3.0.1

21 Temmuz 2021

androidx.paging:paging-*:3.0.1 yayınlandı. 3.0.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • LivePagedList veya RxPagedList tarafından üretilen ilk değerden PagedList.dataSource öğesine erişildiğinde artık yanlışlıkla IllegalStateException hatası verilmeyecek (I96707)

Sürüm 3.0.0

Sürüm 3.0.0

5 Mayıs 2021

androidx.paging:paging-*:3.0.0 yayınlandı. 3.0.0 sürümü bu commit'leri içerir.

3.0.0 sürümünün önemli özellikleri

Paging 2.x.x'teki mevcut API'lerin çoğu, aşağıdaki iyileştirmeleri sunan yeni Paging 3 API'leri lehine kullanımdan kaldırıldı:

  • Kotlin eş yordamları ve Flow için birinci sınıf destek
  • İptal için destek
  • Yerleşik yükleme durumu ve hata sinyalleri
  • Yeniden deneme ve yenileme işlevi
  • Üç DataSource alt sınıfının tümü birleştirilmiş bir PagingSource sınıfında birleştirildi.
  • Ayırıcı eklemek için yerleşik bir dönüşüm de dahil olmak üzere özel sayfa dönüşümleri
  • Yükleme durumu üstbilgileri ve altbilgileri

Sürüm 3.0.0-rc01

21 Nisan 2021

androidx.paging:paging-*:3.0.0-rc01 yayınlandı. 3.0.0-rc01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Sayfalandırma'nın bazen RecyclerView'a işlem yapılmayan fark etkinlikleri göndermesine ve bu nedenle belirli dinleyicilerin erken tetiklenmesine neden olan bir sorun düzeltildi. (Ic507f, b/182510751)

Sürüm 3.0.0-beta03

24 Mart 2021

androidx.paging:paging-*:3.0.0-beta03 yayınlandı. 3.0.0-beta03 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • RecyclerView'da beklenmedik atlamaları önlemek için liste yeniden yüklendiğinde yer tutucuların işlenme şeklini yeniledik. Ayrıntılar için NullPaddedDiffing.md sayfasına bakın. (If1490, b/170027529, b/177338149)
  • Çeşitli PagedList oluşturucular (eski uyumluluk yolu), .build() çağrıldığında artık ana iş parçacığında DataSource.Factory.create() öğesini yanlış bir şekilde eşzamanlı olarak çağırmıyor. (b/182798948)

Sürüm 3.0.0-beta02

10 Mart 2021

androidx.paging:paging-*:3.0.0-beta02 yayınlandı. 3.0.0-beta02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Rx3 uzantıları artık @ExperimentalCoroutinesApi etkinleştirme şartını doğru şekilde uyguluyor. Daha önce @get yönteminde işaretlenmişlerdi ancak Kotlin derleyicisi tarafından şu nedenle yoksayılıyorlardı: https://youtrack.jetbrains.com/issue/KT-45227 (I5733c)

Hata Düzeltmeleri

  • Deneysel API'lerin herkese açık kullanımına kısıtlamalar getirin (I6aa29, b/174531520)
  • Uzaktan yenileme çağrıldığında PagingState değerinin her zaman null olmasına neden olan bir hata düzeltildi.
  • PagingSource tarafından döndürülen boş sayfaların, Paging'in prefetchDistance değerini karşılamak için tekrar getirmesini engelleyerek Paging'in "takılmasına" neden olan bir hata düzeltildi.

Sürüm 3.0.0-beta01

10 Şubat 2021

androidx.paging:paging-*:3.0.0-beta01 yayınlandı. 3.0.0-beta01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Rx2 ve Rx3 sarmalayıcıları artık bağlı olduğu deneysel ek açıklamayı gösteriyor. paging-rxjava2 veya paging-rxjava3'te Rx uyumlu sarmalayıcılar kullanıyorsanız artık kullanımlara @OptIn(ExperimentalCoroutinesApi::class) ile ek açıklama eklemeniz gerekir (Ib1f9d).

Hata Düzeltmeleri

  • Uyumluluk yolları üzerinden v2 DataSource API'leri kullanılırken bazen ortaya çıkan IndexOutOfBoundsException: Inconsistency detected hatası düzeltildi.
  • Uyumluluk yolları üzerinden kullanıldığında DataSource başlatılırken yapılan isInvalid çağrısı artık ana iş parçacığı yerine fetchDispatcher'da doğru şekilde başlatılıyor. Bu sayede, Room'un PagingSource uygulamasını kullanırken ana iş parçacığındaki veritabanı erişimi nedeniyle oluşan IllegalStateException hatası düzeltilir.

Sürüm 3.0.0-alpha13

27 Ocak 2021

androidx.paging:paging-*:3.0.0-alpha13 yayınlandı. 3.0.0-alpha13 sürümü bu commit'leri içerir.

API Değişiklikleri

  • PagingSource.getRefreshKey artık isteğe bağlı bir işlev değildir. Varsayılan bir uygulaması olmayan soyut bir işlevdir. Geçiş yapan kullanıcılar, varsayılan uygulamayı döndürmeye devam edebilir. Bu uygulama yalnızca null döndürür ancak getRefreshKey(), kullanıcının mevcut kaydırma konumuna göre bir anahtar döndüren gerçek bir uygulamaya sahip olmalıdır. Bu sayede Paging, mümkünse PagingState.anchorPosition aracılığıyla görüntü alanının etrafında ortalanmış olarak yüklemeye devam edebilir. (I4339a)
  • InvalidatingPagingSourceFactory artık nihai bir sınıftır (Ia3b0a)
  • İsteğe bağlı ek bir SeparatorType parametresiyle terminal ayırıcı (üstbilgi/altbilgi) davranışının yapılandırılmasına izin verilir. İki seçenek şunlardır:
    • FULLY_COMPLETE: Mevcut davranış. Terminal ayırıcıları eklemeden önce hem PagingSource hem de RemoteMediator'ın endOfPaginationReached değerini işaretlemesini bekleyin. RemoteMediator kullanılmıyorsa uzak loadState yoksayılır. Bu, özellikle bölüm ayırıcıları yalnızca bölüm tamamen yüklendiğinde (ör. ağ gibi uzak kaynaktan getirme dahil) göstermek istiyorsanız kullanışlıdır.
    • SOURCE_COMPLETE: RemoteMediator kullanılsa bile yalnızca PagingSource'un endOfPaginationReached değerini işaretlemesini bekleyin. Bu sayede üstbilgiler ve altbilgiler, ilk yüklemeyle eşzamanlı olarak sunulur. Böylece kullanıcıların, terminal ayırıcıları görmek için sayfayı kaydırması gerekmez. (Ibe993, b/174700218)

Hata Düzeltmeleri

  • PageFetcher, PagingSource'tan yüklemeye başlamadan önce PagingSource geçersiz kılındığında nadiren görülen bir bellek sızıntısı düzeltildi. (I9606b, b/174625633)

Sürüm 3.0.0-alpha12

13 Ocak 2021

androidx.paging:paging-*:3.0.0-alpha12 yayınlandı. 3.0.0-alpha12 sürümü bu kayıtları içerir.

API Değişiklikleri

  • InvalidatingPagingSourceFactory, hiçbir soyut yöntemi olmadığı için artık soyut bir sınıf değildir. (I4a8c4)
  • Java kullanıcıları için Lifecycle veya CoroutineScope yerine ViewModel'i kabul eden bir .cachedIn() aşırı yüklemesi eklendi. (I97d81, b/175332619)
  • Dönüşüm operatörü bağımsız değişkenlerine bir Executor kabul ederek Java çağrıcılarının PagingData dönüştürme işlemlerini eşzamansız bir şekilde kullanmasına izin verin. Tüm -Sync dönüştürme operatörlerinin -Sync son eki kaldırıldı. Kotlin Coroutine kullanıcılarının, askıya alma bloğunu kabul eden uzantı işlevini çağırarak anlam belirsizliğini gidermesi gerekir. Tüm PagingData dönüşüm operatörleri, statik PagingDataTransforms sınıfı altındaki uzantılara taşındı. Java kullanıcılarının bunları statik yardımcılar aracılığıyla çağırması gerekir. Örneğin: PagingDataTransforms.map(pagingData, transform) Kotlin kullanıcıları için söz dizimi aynıdır ancak işlevi içe aktarmanız gerekir. (If6885, b/172895919)

Hata Düzeltmeleri

  • Sayfalandırmanın sonuna ulaşıldığında adapter.refresh() sırasında RemoteMediator.load() işlevinin çağrılmamasına neden olan hata düzeltildi.

Sürüm 3.0.0-alpha11

16 Aralık 2020

androidx.paging:paging-*:3.0.0-alpha11 yayınlandı. 3.0.0-alpha11 sürümü bu taahhütleri içerir.

Yeni özellikler

  • Aşağıdaki temel kullanım alanları için kaydedilmiş durum desteği eklendi (özellikle katmanlı kaynak durumunda tam destek hâlâ geliştirme aşamasındadır):
    • Akış önbelleğe alınır ve uygulama sonlandırılmaz (ör. akış bir görünüm modelinde önbelleğe alınır ve etkinlik işlem sırasında yeniden oluşturulur)
    • Sayfa kaynağı sayılır, yer tutucular etkinleştirilir ve düzen kademeli değildir.

API Değişiklikleri

  • PagingSource.getRefreshKey() artık kararlı bir API (I22f6f, b/173530980)
  • PagingSource.invalidate artık açık bir işlev değil. Geçersiz kılma işlemi gerçekleştiğinde bildirim almanız gerekiyorsa invalidate yöntemini geçersiz kılmak yerine registerInvalidatedCallback yöntemini çağırabilirsiniz. (I628d9, b/173029013, b/137971356)
  • Pager artık deneysel API'leri, etkinleştirme ek açıklaması aracılığıyla deneysel olmayan herkese açık API'ye sızdırmak yerine, normal kurucularının yanı sıra tek bir deneysel kurucuya sahip. (I9dc61, b/174531520)
  • Uzaktan güncellemenin uygulandığından emin olmak için CombinedLoadStates.refresh, CombinedLoadStates.prepend, CombinedLoadStates.append kolaylık özellikleri, yalnızca hem uyumlulaştırıcı hem de kaynak yükleme durumları NotLoading olduğunda Loading durumundan NotLoading durumuna geçecek şekilde güncellendi. (I65619)
  • LoadParams.pageSize kaldırıldı (zaten desteği sonlandırılmıştı). PagingSource'unuzda LoadParams.loadSize kullanmanız önerilir.

    LoadParams.loadSize, ilk yükleme çağrısı dışında her zaman PagingConfig.pageSize değerine eşittir. İlk yükleme çağrısında ise PagingConfig.initialLoadSize değerine eşittir.

    Paging2 DataSource'unuzu sayfa gezgini veya PagedList kullanmadan test ediyorsanız initialLoadSize değerini de ayarladığınızda pageSize, PagingConfig.pageSize ile eşleşmeyebilir. Testleriniz için önemliyse bunun yerine, DataSource yükleme yöntemleriniz için doğru PageSize değerini dahili olarak ayarlayacak bir Pager/PagedList kullanmayı deneyin. (I98ac7, b/149157296)

Hata Düzeltmeleri

  • PagingConfig.maxSize ayarlanmışken ayırıcılar kullanıldığında IllegalStateException nedeniyle oluşan kilitlenme düzeltildi. (I0ed33, b/174787528)
  • RemoteMediator ayarlandıysa PREPEND / APPEND için yükleme durumunun ilk yüklemeden hemen sonra NotLoading(endOfPaginationReached = true) olarak güncellenmemesine neden olan hata düzeltildi (I8cf5a).
  • .snapshot(), .peek() gibi sunucu tarafı API'lerin ListUpdateCallback güncellemelerinde önceki (eski) listeyi döndürmesine neden olan bir hata düzeltildi.
  • Ayırıcı operatörlerinin RemoteMediator ile kullanıldığında üstbilgi veya altbilgi eklememesiyle ilgili hata düzeltildi.
  • RemoteMediator için LoadState'in NotLoading olarak güncellenmesinin Loading durumunda takılı kalmasına neden olan hata düzeltildi.
  • Paging2.0 uyumluluk API'sinin (.asPagingSourceFactory()), destekleyici DataSource öğesinin yanlış CoroutineDispatcher'da başlatılmasına neden olabildiği bir hata düzeltildi. Bu sayede, özellikle Room'un bu uyumluluk yolunu kullanan mevcut PagingSource uygulamasını kullanırken kilitlenme ve olası ANR durumları çözülür.

Sürüm 3.0.0-alpha10

2 Aralık 2020

androidx.paging:paging-*:3.0.0-alpha10 yayınlandı. 3.0.0-alpha10 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Desteği sonlandırılan dataRefreshFlow ve dataRefreshListener API'leri, loadStateFlow/Listener güncellemeleriyle gereksiz hale geldikleri için kaldırıldı. Taşıma işlemi yapanlar için loadStateFlow eşdeğeri şudur:

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

    (Ib5570, b/173530908)

Hata Düzeltmeleri

  • RemoteMediator REFRESH için endOfPaginationReached artık LoadState güncellemelerine doğru şekilde yayılıyor ve uzak APPEND ile PREPEND öğelerinin tetiklenmesini engelliyor. (I94a3f, b/155290248)
  • İlk sayfanın boş olması veya yoğun filtreleme nedeniyle boş bir liste sunulması, artık sayfalama özelliğinin PREPEND veya APPEND yüklemelerini başlatmasını engellemeyecek. (I3e702, b/168169730)
  • Geçersiz kılma işlemleri hızlı bir şekilde gerçekleştiğinde sonraki PagingSource nesillerinde getRefreshKey yönteminin çağrılmaması sorunu düzeltildi. (I45460, b/170027530)

Harici Katkı

  • Oluşturduğu tüm PagingSource'lara geçersiz kılma işlemini ileten bir .invalidate() API'si içeren yeni bir soyut sınıf InvalidatingPagingSourceFactory eklendi. @claraf3'e teşekkürler. (Ie71fc, b/160716447)

Bilinen Sorunlar

  • RemoteMediator kullanılırken .insertSeparators() dönüşümünden elde edilen üstbilgiler ve altbilgiler hemen görünmeyebilir b/172254056
  • RemoteMediator kullanıldığında, geçersiz kılma ve PagingSource.load(LoadParams.Refresh(...)), RemoteMediator.load() döndürülmeden önce tamamlanırsa uzak LoadState takılabilir b/173717820

Sürüm 3.0.0-alpha09

11 Kasım 2020

androidx.paging:paging-*:3.0.0-alpha09 yayınlandı. 3.0.0-alpha09 sürümü bu kayıtları içerir.

API Değişiklikleri

  • dataRefreshFlow/Listener yöntemlerinin desteğini tamamen sonlandırıp replaceWith ifadesini kullanın. (I6e2dd)

Hata Düzeltmeleri

  • RemoteMediator ile ayırıcılar kullanılırken IllegalArgumentException hatasının oluşması ve endOfPagination döndürecek bir uzaktan yükleme işlemi devam ederken geçersiz kılma işleminin tetiklenmesiyle ilgili sorun düzeltildi (I3a260).

Sürüm 3.0.0-alpha08

28 Ekim 2020

androidx.paging:paging-*:3.0.0-alpha08 yayınlandı. 3.0.0-alpha08 sürümü bu commit'leri içerir.

API Değişiklikleri

  • DataSource.InvalidatedCallback öğesinin Kotlin/Java varyantları, işlevsel arayüz aracılığıyla Kotlin'de SAM dönüşümleri etkinleştirilerek birleştirildi (Kotlin 1.4'te kullanılabilir). Bu sayede, geçersiz kılma geri çağırmalarının Kotlin varyantının .map veya .mapByPage tarafından dönüştürüldükten sonra çağrılmamasıyla ilgili bir hata da düzeltildi. (I1f244, b/165313046)

Hata Düzeltmeleri

  • Paging'in ViewPager ile etkileşimi önemli ölçüde iyileştirildi. Özellikle, sayfalama artık sayfa geçersiz kılma nedeniyle RemoteMediator#load çağrısını iptal etmeyecek. Ayrıca, YENİLEME gerekiyorsa YENİLEME isteği başarıyla tamamlanana kadar ekleme/başa ekleme yükleme isteği de yapmaz. (I6390b, b/162252536)
  • MissingGetterMatchingBuilder için API lint kontrolü androidx'te etkinleştirildi (I4bbea, b/138602561)
  • .withLoadState* ConcatAdapter yardımcılarının, RecyclerView'u arka plan iş parçacığından bilgilendirmesi nedeniyle kilitlenmesine neden olan bir hata düzeltildi (I18bb5, b/170988309).
  • Boş olmayan çok küçük bir sayfa yüklendiğinde önceden getirmenin yüklemeleri doğru şekilde tetiklemesini bazen engelleyen bir hata düzeltildi.Iffda3 b/169259468

Sürüm 3.0.0-alpha07

1 Ekim 2020

androidx.paging:paging-*:3.0.0-alpha07 yayınlandı. 3.0.0-alpha07 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Async PagingData Guava tabanlı operatörler artık yürütme bağlamını kontrol etmek için parametre olarak bir Executor kabul ediyor. (Id4372)

Hata Düzeltmeleri

  • Yarışma durumu nedeniyle RemoteMediator'da oluşan IndexOutOfBounds istisnası düzeltildi. (I00b7f, b/165821814)
  • DataSource -> PagingSource dönüşümünde, elde edilen PagingSource'un DataSource'tan gelen geçersiz kılma sinyallerini yoksaymasına neden olabilecek bir yarışma durumu düzeltildi.
  • Sayfa getirme mantığında, bazen PagingDataAdapter.refresh() çağrılana kadar yeni PagingSource nesillerinin alınamamasına neden olan sorun düzeltildi.
  • PagingSource'a dönüştürülmüş bir DataSource (ör. Room tarafından üretilen) RemoteMediator ile birlikte kullanıldığında kaydırma konumunun bazen kaybolmasına neden olan bir sorun düzeltildi.

Harici Katkı

  • PagingData için RxJava2, RxJava3 ve Guava tabanlı eş zamansız dönüşüm operatörleri ekleyen @simonschiller'e teşekkür ederiz.

Sürüm 3.0.0-alpha06

2 Eylül 2020

androidx.paging:paging-*:3.0.0-alpha06 yayınlandı. 3.0.0-alpha06 sürümü bu commit'leri içerir.

API Değişiklikleri

  • UnsupportedOperationException, PagingDataAdapter.setHasStableIds çağrıldığında artık kararlı kimlikler için destek eksikliğiyle ilgili daha net mesajlar veriyor. (Ib3890, b/158801427)

Hata Düzeltmeleri

  • insertSeparators artık boş sayfaları filtrelemediğinden, birçok boş sayfanın eklendiği durumlarda bile sunucu, önceden getirme mesafesine uyar. (I9cff6, b/162538908)

Sürüm 3.0.0-alpha05

19 Ağustos 2020

androidx.paging:paging-*:3.0.0-alpha05 yayınlandı. 3.0.0-alpha05 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Sayfalandırma, sunulan veriler yoğun bir şekilde filtrelenmiş olsa bile sayfaları artık doğru şekilde önceden getiriyor.
  • Yeniden denenen bir yüklemeye LoadResult.Error döndürmek, öğe erişimlerinin yeniden denemeyi yanlış şekilde tekrar tetiklemesine neden olmaz.

Harici Katkı

  • Bazı testleri temizlemeye yardımcı olduğu için Clara F'ye teşekkür ederiz. (549612)

Sürüm 3.0.0-alpha04

5 Ağustos 2020

androidx.paging:paging-*:3.0.0-alpha04 yayınlandı. 3.0.0-alpha04 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • Sayfa yüklemelerini tetiklemeden sunulan verilere erişime izin vermek için AsyncPagingDataDiffer ve PagingDataAdapter'ye peek() API'si eklendi. (I38898, b/159104197)
  • Sayfa getirme işlemini tetiklemeden sunulan öğelerin alınmasına olanak tanımak için PagingDataAdapter ve AsyncPagingDataDiffer'ye bir snapshot() API'si eklendi. (I566b6, b/159104197)
  • Statik listelerin sunulmasına olanak tanıyan bir PagingData.from(List<T>) oluşturucu eklendi.Bu oluşturucu, belirli durumlarda (ör. ilk REFRESH işlemi tamamlanmadan önce veya yalnızca dönüşümleri test etmek için) statik listeleri göstermek üzere genel PagingData akışıyla birleştirilebilir. (Id134d)
  • dataRefresh Flow/Listener API'leri, sunulan öğe durumunu REFRESH'te göstermek için tasarlanmıştı. Ancak loadState Flow/Listener geri çağırma zamanlaması ve itemCount özelliğinde yapılan iyileştirmelerle bu API'ler gereksiz hale geldiği için kullanımdan kaldırıldı (Ia19f3).
  • PagingSource ve RemoteMediator için RxJava3 uyumluluk sarmalayıcıları eklendi (I49ef3, b/161480176)

Hata Düzeltmeleri

  • toPagingSourceFactory yardımcı programı aracılığıyla PagingSource değerine dönüştürülen PositionalDataSource (Room tarafından oluşturulan PagingSource dahil) artık atlamayı desteklemek için kendilerini doğru şekilde işaretliyor. (I3e84c, b/162161201)
  • submitData'nın eşzamanlı varyantının kullanılmasının bazen ClosedSendChannelException hatasına neden olan bir yarışa yol açtığı hata düzeltildi (I4d702, b/160192222).

Harici Katkı

  • Slack adına RxJava3 uyumluluk sarmalayıcıları eklediği için Zac Sweers'a teşekkür ederiz. (I49ef3, b/161480176)

Sürüm 3.0.0-alpha03

22 Temmuz 2020

androidx.paging:paging-*:3.0.0-alpha03 yayınlandı. 3.0.0-alpha03 sürümü bu kayıtları içerir.

API Değişiklikleri

  • PagingState için oluşturucu artık herkese açık olduğundan getRefreshKey() uygulamalarını test etmek daha kolay olacaktır (I8bf15).
  • Orijinal ve Kotlin varyantları arasındaki belirsizliği gidermek için DataSource Kotlin eşleme işlevi varyantları Java'dan gizlendi. (If7b23, b/161150011)
  • Kotlin kullanıcılarına kolaylık sağlamak için tasarlanan gereksiz API'ler @JvmSynthetic (I56ae5) olarak işaretlendi.
  • LoadResult.Page'in oluşturucusu için aşırı yüklemeler eklendi. Bu aşırı yüklemeler, itemsBefore ve itemsAfter'ı varsayılan olarak COUNT_UNDEFINED (I47849) değerine ayarlar.
  • Mevcut PagingData operatörleri, askıya alma yöntemlerini kabul edecek şekilde değiştirildi ve Java kullanıcıları için yeni mapSync, flatMapSync ve filterSync askıya alınmayan operatörler kullanıma sunuldu. Mevcut dönüştürme yöntemleri uzantı işlevlerine taşındığından Kotlin kullanıcılarının artık bunları içe aktarması gerekecek. (I34239, b/159983232)

Hata Düzeltmeleri

  • Room (ve PositionalDataSource) PagingSource'lar artık ilk sayfanın bir parçası olarak başta bir ayırıcı gösterecek. Böylece kullanıcının ayırıcıyı görmek için sayfayı kaydırması gerekmeyecek. (I6f747, b/160257628)
  • Yer tutuculardaki öğe erişimleri artık PagingData.filter() tarafından dönüştürüldükten sonra istenen dizini karşılayan bir sayfa döndürülene kadar PagingSource yüklemelerini doğru şekilde tetikliyor (I95625, b/158763195).
  • PagingSource bir hata döndürdükten sonra kaydırma yapıldığında bazen PagingDataAdapter.retry() yönteminin yeniden denemesini engelleyen hata düzeltildi. (I1084f, b/160194384)
  • Bir sayfa bırakıldıktan sonra öğe erişimlerinin, prefetchDistance içinde olmasına rağmen sayfaları yüklememesine neden olan sorun düzeltildi (Ie95ae, b/160038730).
  • PagingConfig.maxSize ayarı, bir bırakma etkinliğinden sonra yer tutucuları artık etkinleştirmez (I2be29, b/159667766)

Sürüm 3.0.0-alpha02

24 Haziran 2020

androidx.paging:paging-*:3.0.0-alpha02 yayınlandı. 3.0.0-alpha02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • PagingConfig oluşturucusu için yaygın varsayılan değerlere sahip aşırı yüklemeler eklendi (I39c50, b/158576040)
  • Yaygın varsayılan değerlerle (Ie91f5) PagingDataAdapter ve AsyncPagingDataDiffer oluşturucuları için aşırı yüklemeler eklendi.
  • dataRefreshFlow ve dataRefreshListener bağdaştırıcı API'leri artık PagingData öğesinin boş olup olmadığını (I6e37e, b/159054196) bildirmek için bir Boole değeri iletiyor.
  • RemoteMediator için RxJava ve Guava API'leri eklendi: RxRemoteMediator ve ListenableFutureRemoteMediator
  • isEmpty() ve firstItemOrNull() gibi yaygın öğe erişimi için PagingState'e yardımcılar eklendi (I3b5b6, b/158892717)

Hata Düzeltmeleri

  • Sayfa gezgini artık geçersiz PagingSource'ların yanlışlıkla yeniden kullanılmasını önlemek için fabrikada PagingSource'un yeniden kullanılıp kullanılmadığını kontrol ediyor. Bu durum, belirsiz bir hataya neden oluyordu (I99809, b/158486430).
  • RemoteMediator REFRESH'ten kaynaklanan hatalar artık PagingSource'un yüklenmesini engellemiyor (I38b1b, b/158892717)
  • submitData öğesinin askıya alınmayan sürümü, submitData öğesinin askıya alınan sürümünden sonra çağrıldığında birden fazla PagingData üzerinde eşzamanlı toplama nedeniyle artık kilitlenmeye neden olmaz. (I26358, b/158048877)
  • Yapılandırma değişikliğinden sonra ortaya çıkabilen "sayfa gezgininden iki kez toplanamıyor" istisnası düzeltildi (I58bcc, b/158784811).

Sürüm 3.0.0-alpha01

10 Haziran 2020

androidx.paging:paging-*:3.0.0-alpha01 yayınlandı. 3.0.0-alpha01 sürümü şu taahhütleri içerir:

Paging Library, birkaç önemli yeni özelliği etkinleştirmek için 3.0 sürümüne güncellendi.

3.0 sürümünün yeni özellikleri

Bilinen Sorunlar

  • Paging 3 javadocs henüz kullanılamıyor. Bu süre zarfında lütfen yukarıda bağlantısı verilen kılavuzları veya Kotlin belgelerini kullanın. (b/158614050)

Sürüm 2.1.2

Sürüm 2.1.2

18 Mart 2020

androidx.paging:paging:2.1.2 yayınlandı. 2.1.2 sürümü, 2.1.0 sürümüne kıyasla şu commit'leri içerir.

Hata Düzeltmeleri

  • Geçersiz kılma sırasında bir konum dönüştürülürken nadiren görülen IndexOutOfBoundsException hatası düzeltildi.

Sürüm sorunu

  • Paging'in 2.1.1 sürümü, yanlış yapılandırılmış bir daldan hatalı bir şekilde yayınlandı. Bu nedenle, kısmen uygulanmış API'ler ve gelecekteki bir sürümde sunulacak işlevler açığa çıktı.

  • Paging 2.1.2, ilk olarak 2.1.1 sürümünde yayınlanan yük ortalama düzeltmesini içerir ancak bu kez 2.1.0 sürümünün üzerine doğru şekilde seçilerek eklenmiştir. Şu anda 2.1.1 sürümünü kullanıyorsanız bu sürüme yükseltmeniz önemle tavsiye edilir.

Sürüm 2.1.1

Sürüm 2.1.1

18 Aralık 2019

androidx.paging:paging-*:2.1.1 yayınlandı. 2.1.1 sürümü bu commit'leri içerir.

Hata düzeltmeleri

  • PositionalDataSources'tan gelen bitişik ilk yüklemeler, yer tutucular devre dışı bırakıldığında artık son erişimi temel alır.

Sürüm 2.1.0

Sürüm 2.1.0

25 Ocak 2019

Paging 2.1.0, 2.1.0-rc01 sürümünden herhangi bir değişiklik yapılmadan yayınlandı.

Sürüm 2.1.0-rc01

6 Aralık 2018

Paging 2.1.0-rc01, 2.1.0-beta01 sürümünden herhangi bir değişiklik yapılmadan yayınlandı.

Sürüm 2.1.0-beta01

1 Kasım 2018

Paging 2.1.0-beta01, 2.1.0-alpha01 sürümünden herhangi bir değişiklik yapılmadan yayınlandı.

Sürüm 2.1.0-alpha01

12 Ekim 2018

Paging 2.1.0-alpha01, sayfa bırakma ve her yapı için KTX uzantı kitaplıkları olmak üzere iki önemli eklemenin yanı sıra çeşitli API değişiklikleri ve hata düzeltmeleri içerir.

API Değişiklikleri

  • Belleğe yüklenen öğe sayısını sınırlamak için PagedList.Config.Builder.setMaxSize() eklendi.
  • PagedList.Config.Builder için Kotlin alternatifi olarak androidx.paging.Config() eklendi
  • PagedList.Builder için Kotlin alternatifi olarak androidx.paging.PagedList() eklendi
  • LivePagedListBuilder için Kotlin alternatifi olarak DataSourceFactory.toLiveData() eklendi
  • RxPagedListBuilder için Kotlin alternatifleri olarak DataSourceFactory.toObservable() ve toFlowable() eklendi.
  • PagedList değiştirildiğinde dinlemek için AsyncPagedListDiffer.addPagedListListener() eklendi. b/111698609
  • Eski ve yeni listeyi ileten PagedListAdapter.onCurrentListChanged() varyantı eklendi, önceki varyantın desteği sonlandırıldı.
  • Farklılıklar belirlendikten sonra pagedlist gösterildiğinde tetiklenen ek bir geri çağırma alan PagedListAdapter/AsyncPagedListDiffer.submitList() varyantları eklendi. Bu sayede, PagedList değişimini diğer kullanıcı arayüzü güncellemeleriyle senkronize edebilirsiniz. b/73781068
  • Hafızada kaç öğe olduğunu bildirmek için PagedList.getLoadedCount() eklendi. Yer tutucular devre dışı bırakılırsa döndürülen değerin her zaman .size() değerine eşit olacağını unutmayın.

Hata Düzeltmeleri

  • Listeler yeniden kullanıldığında fark hesaplaması sırasında oluşan yarışma durumu düzeltildi b/111591017
  • PagedList.loadAround(), dizin geçersiz olduğunda artık IndexOutOfBoundsException hatası veriyor. Daha önce, belirsiz bir istisna nedeniyle kilitlenebiliyordu.
  • İlk yükleme boyutunun son derece küçük olduğu ve verilerin değişmediği durumlarda daha fazla yükleme yapılmamasına neden olan bir sorun düzeltildi b/113122599

Sürüm 2.0.0

Sürüm 2.0.0

1 Ekim 2018

Paging 2.0.0, tek bir hata düzeltmesiyle yayınlandı.

Hata Düzeltmeleri

  • PositionalDataSource ve yer tutucular kullanılarak çok hızlı kaydırma yapıldığında oluşabilecek bir kilitlenme sorunu düzeltildi b/114635383.

Sürüm 2.0.0-beta01

2 Temmuz 2018

Hata Düzeltmeleri

  • Bazı başa ekleme durumlarında (yer tutucular devre dışı, PositionalDataSource) içeriğin kaybolması sorunu düzeltildi b/80149146
  • (1.0.1 sürümünde yayınlandı) PagedListAdapter ve AsyncPagedListDiffer'nin taşıma etkinliklerini bildirememesine neden olan kilitlenmeler düzeltildi. b/110711937

AndroidX Öncesi Bağımlılıklar

Paging'in aşağıdaki AndroidX öncesi sürümleri için şu bağımlılıkları ekleyin:

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

Sürüm 1.0.1

Sürüm 1.0.1

26 Haziran 2018

Paging 1.0.1, runtime sürümünde tek bir hata düzeltmesiyle yayınlandı. Kararlılık için 1.0.1 kullanmanızı önemle tavsiye ederiz. Paging RxJava2 1.0.1 de yayınlandı ve 1.0.0-rc1 ile aynı.

Hata Düzeltmeleri

  • PagedListAdapter ve AsyncPagedListDiffer'in taşıma etkinliklerini bildirememesi nedeniyle yaşanan kilitlenmeler düzeltildi. b/110711937

RxJava2 Sürüm 1.0.0

RxJava2 Sürüm 1.0.0-rc1

16 Mayıs 2018

Paging RxJava2 1.0.0-rc1, ilk alfa sürümünden herhangi bir değişiklik olmadan sürüm adayı aşamasına geçiyor.

Sürüm 1.0.0

Sürüm 1.0.0-rc1

19 Nisan 2018 Paging Sürüm Adayı

Paging 1.0.0 sürümü için planlanan başka bilinen sorun veya yeni özellik yoktur. 1.0.0-rc1 sürümünü kullanmak için lütfen projelerinizi yükseltin ve 1.0.0 sürümünü sorunsuz bir şekilde yayınlayabilmemiz için test etmemize yardımcı olun.

Bu sürümde değişiklik yok, 1.0.0-beta1 ile aynı.

Sürüm 1.0.0-beta1

5 Nisan 2018

Sayfalama, sürüm adayı aşamasına geçmeden önce kısa bir süre beta sürümünde olacak. Paging 1.0 için başka API değişikliği planlamıyoruz ve API değişiklikleri için çıta çok yüksek.

Paging için alfa RxJava2 desteği, ayrı bir isteğe bağlı modül (android.arch.paging:rxjava2:1.0.0-alpha1) olarak yayınlandı ve kararlı hale gelene kadar geçici olarak ayrı bir sürüm olarak sunulacak.

Bu yeni kitaplık, LivePagedListBuilder için RxJava2 alternatifi sunar. Observable ve Flowable oluşturabilir, Executor yerine Scheduler alır:

Kotlin

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

Java

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

Yeni özellikler

  • RxPagedListBuilder, yeni android.arch.paging:rxjava2 yapısı aracılığıyla eklenir.

API Değişiklikleri

  • Oluşturuculardaki yürütücülerin rolünü netleştirmek için API değişiklikleri:

    • setBackgroundThreadExecutor(), setFetchExecutor() olarak yeniden adlandırıldı (PagedList.Builder ve LivePagedListBuilder dillerinde)

    • setMainThreadExecutor(), setNotifyExecutor() olarak yeniden adlandırıldı (PagedList.Builder içinde).

  • PagedList.mCallbacks üyesi gizli olarak düzeltildi.

Hata Düzeltmeleri

  • LivePagedListBuilder, Arch Components G/Ç iş parçacığı havuzu yerine belirtilen yürütücüde ilk PagedList yüklemeyi tetikler.

  • Dahili DataSource sarmalayıcılarında geçersiz kılma davranışı düzeltildi (DataSource.map ve yer tutucu devre dışı bırakılmış PositionalDataSource yüklemeyi uygulamak için kullanılır) b/77237534

Sürüm 1.0.0-alpha7

21 Mart 2018

Paging 1.0.0-alpha7, Lifecycles 1.1.1 ile birlikte yayınlandı. Paging alpha7, yukarıda bahsedilen Function sınıfının taşınmasına bağlı olduğundan lifecycle:runtime bağımlılığınızı android.arch.lifecycle:runtime:1.1.1 olarak güncellemeniz gerekir.

Paging alpha7, Paging beta sürümüne geçmeden önceki son sürüm olarak planlanmıştır.

API Değişiklikleri

  • DataSource.LoadParams nesnelerinin artık herkese açık bir oluşturucusu var ve DataSource.LoadCallback nesneleri artık soyut. Bu sayede, DataSource sarmalanabilir veya sahte geri çağırma ile doğrudan DataSource test edilebilir. b/72600421
  • DataSource ve DataSource.Factory için eşleyiciler
    • map(Function<IN,OUT>), DataSource tarafından yüklenen sonuçları dönüştürmenize, sarmalamanıza veya süslemenize olanak tanır.
    • mapByPage(<List<IN>,List<OUT>>), toplu işleme için de aynı şeyi sağlar (ör. SQL'den yüklenen öğelerin ayrı bir veritabanını sorgulaması gerekiyorsa bu işlem toplu olarak yapılabilir).
  • PagedList#getDataSource(), kolaylık yöntemi olarak eklendi b/72611341
  • recyclerview.extensions paketinin kalıntıları ve LivePagedListProvider dahil olmak üzere tüm desteği sonlandırılmış sınıflar API'den kaldırıldı.
  • Harita işlevini etkinleştirmek için DataSource.Factory, arayüzden soyut sınıfa dönüştürüldü.

Hata Düzeltmeleri

  • Oluşturucular, nihai olacak şekilde değiştirildi. b/70848565
  • Room DataSource uygulaması artık çok tablolu sorguları işleyecek şekilde düzeltildi. Bu düzeltme Room 1.1.0-beta1 sürümünde yer almaktadır (yukarıya bakın).
  • Yer tutucular etkinleştirildiğinde ve toplam boyut, sayfa boyutunun tam katı olduğunda PositionalDataSource için BoundaryCallback.onItemAtEndLoaded işlevinin çağrılmamasına neden olan hata düzeltildi.

Sürüm 1.0.0-alpha5

22 Ocak 2018

Hata Düzeltmeleri

  • Yer tutucular devre dışı bırakıldığında sayfa yükleme sorununu düzeltme b/70573345
  • IllegalArgumentException hatasını b/70360195 izlemek için ek günlük kaydı (ve tahmini Room tarafı düzeltmesi)
  • Javadoc örnek kod düzeltmeleri b/70411933, b/71467637