Sayfalandırma
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 |
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.
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
ItemSnapshotListuzantı eklendi. Artık Lazy Foundation içinitemKeyvecontentTypeöğelerini otomatik olarak oluşturmak üzereItemSnapshotList#itemKeyveItemSnapshotList#itemContentTypeöğelerini çağırabilirsiniz. (I73455, b/560754841)
Harici Katkı
ItemSnapshotListuzantı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, birRemoteMediatorher 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ıkIllegalArgumentExceptionoluşturmayacak. (I821c7, b/566336825)- Yüklenen sayfa sayısı
PagingConfig.maxSizedeğ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ıkNoSuchElementExceptionhatası 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ış biranchorPositionsağ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ğeriniFlow<ItemSnapshotList>değerine dönüştürmek içinFlow<PagingData>.asItemSnapshotListFlowoperatörü eklendi. Bu sayede, yüklenen verilere artık kullanıcı arayüzü katmanının dışından erişilebilir. BöyleceFlow<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.appendvePager.prependuzantı işlevleri eklendi.asItemSnapshotListFlowAPI'si kullanılırken yükleme hatalarını düzeltmek içinPager.refreshvePaging.retryuzantı 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-beta01sü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>.asStateAPI'sinin adıFlow<PagingData>.asItemSnapshotListFlowolarak 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-commonyapısı artıkFlow<PagingData>üzerinde yeni birasStateakış 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:ItemSnapshotListakışını diğer veri kaynaklarıyla birleştirmecachedInolmadan 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-commonyapısı, yüklenen öğelerin her iki ucunda da yüklemeleri manuel olarak tetiklemek içinPager.appendvePager.prependAPI'lerini de ekledi.paging-runtimeveyapaging-composeile kullanıldığında, kaydırma dışında daha fazla veri yüklemek için bir alternatif sunar.- Yeni
asStateAPI 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() } } }asStateAPI'si kullanılırken yükleme hatalarını düzeltmek içinPager.refreshvePager.retryeklendi. 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-testingvepaging-composeiç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-testingvepaging-compose; Jetbrains'in macosX64 hedeflerini kullanımdan kaldırmasıyla uyumlu olacak şekildemacosX64,iosX64,watchosX64vetvosX64desteğini kaldırdı.- Hedef konuma en yakın olan ve giriş yüklemiyle eşleşen yüklenen öğeyi almak için yeni bir
PagingStateAPI'siclosestItemAroundPositioneklendi. 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
- Jetbrains'in macosX64 hedeflerini kullanımdan kaldırması nedeniyle şu KMP platformlarına yönelik destek kaldırıldı:
macosX64,iosX64,watchosX64vetvosX64. (7cb9a4)
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
RecyclerViewveRefreshyüklemeleri arasındaRecyclerViewiçindeIndexOutOfBoundsExceptionile sonuçlanan yarış düzeltildi. SürekliRefreshyüklemeleri nedeniyle kullanıcı arayüzü güncellemelerinin kesintiye uğraması, sayfalama durumununRecyclerViewile senkronizasyonunun bozulmasına neden olabilir. Yenileme işlemi kesintiye uğrarsa (ör. ardışık birRefreshyü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
PagingStateAPI'siclosestItemAroundPositioneklendi. 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
- Varsayılan minSdk, API 21'den API 23'e taşındı (Ibdfca, b/380448311, b/435705964, b/435705223)
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.fromartıkplaceholdersBeforeveplaceholdersAfterayarları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
- Paging, şu KMP hedeflerini ekledi: watchos, tvos, mingwX64, watchosDeviceArm64 ve linuxArm64. (I237dd, Ia62b3, b/368046982, Icf15d, b/364652024, I139d3, b/338268719)
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ığındaRecyclerViewöğesininIndexOutOfBoundsExceptionhatası 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ı
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ığındaRecyclerViewöğesininIndexOutOfBoundsExceptionhatası 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 mockedgibi 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-commonvepaging-testing, yeni Kotlin-Multiplatform hedefleri ekledi:watchos,tvosvelinuxArm64(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
AsyncPagingDataDifferveya bunun üzerine oluşturulan API'ler (ör.RecyclerViewile kullanılanPagingDataAdapter) kaydırma sırasında destekleyici veri kaynağı yenilendiğinde daha fazla yüklemeyi tetikleyemiyordu. Bu sorun düzeltildi. (I60ca5, b/352586078)PagingDataAdapterveyaAsyncPagingDataDifferkullanarakRecyclerViewkaydı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
PagingDataPresenterartık herkese açık bir sınıf. Çoklu platform sunucuları artık dahili Paging API'leri veyapaging-runtime'ninAsyncPagingDataDiffersınıfını gerektirmek yerinePagingDataPresenterüzerine oluşturulabilir.LoadStatesöğesinin sırasıyla Hata veyaNotLoadingdurumunda olup olmadığını kontrol etmek içinhasErrorveisIdlesınıflarına yeniLoadStatesveCombinedLoadStatesyardımcı yöntemleri eklendi. Ayrıca,Flow<CombinedLoadStates>üzerinde, yüklemeNotLoadingveya hata durumuna geçene kadar bekleyen yeni birawaitNotLoading()Kotlin uzantı yöntemi eklendi.PagingData.empty(), oluşturucusuna özelLoadStatesiletilmediği sürece artık varsayılan olarakNotLoadingdurumlarını gönderir. Bu,PagingDataAdapteröğesine gönderildiğindeLoadStatesgöndermediği veyaLazyPagingItemsolarak toplandığında yükleme durumları gönderdiği mevcut davranıştan farklıdır.LazyPagingItemsolarak 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'lerinicommon'e taşıdı ve artık Android'in yanı sıra jvm ve iOS ile de uyumlu.paging-testing, kodunucommonkonumuna taşıdı ve artık Android'in yanı sıra JVM ve iOS ile de uyumlu.paging-compose, kodunucommonkonumuna taşıdı veandroidx.compose'nin çoklu platform desteğiyle eşleşen bir Android yapısı sunuyor.paging-runtime,paging-guava,paging-rxjava2vepaging-rxjava3yalnı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
@MainThreadek 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
PagingDataPresenterartık herkese açık bir sınıf. Çoklu platform sunucuları artık dahili Paging API'leri veyapaging-runtime'ninAsyncPagingDataDiffersınıfını gerektirmek yerinePagingDataPresenterüzerine oluşturulabilir. (Id1f74, b/315214786)LoadStatesöğesinin Hata veyaNotLoadingdurumunda olup olmadığını kontrol etmek için yeniLoadStatesveCombinedLoadStatesyardımcı yöntemleri eklendi. Ayrıca, bir yüklemeNotLoadingveya hata durumuna geçene kadarLoadStateFlowüzerinde bekleyen yeni bir API eklendi. (Id6c67)
Davranış değişikliği
PagingData.empty(), oluşturucusuna özelLoadStatesiletilmediği sürece artık varsayılan olarakNotLoadingdurumlarını gönderir. Bu,PagingDataAdapteröğesine gönderildiğindeLoadStatesgöndermediği veyaLazyPagingItemsolarak toplandığında yükleme durumları gönderdiği mevcut davranıştan farklıdır.LazyPagingItemsolarak 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'lerinicommon'e taşıdı ve artık Android'in yanı sıra jvm ve iOS ile de uyumlu.paging-testing, kodunucommonkonumuna taşıdı ve artık Android'in yanı sıra JVM ve iOS ile de uyumlu.paging-compose, kodunucommonkonumuna taşıdı veandroidx.compose'nin çoklu platform desteğiyle eşleşen bir Android yapısı sunuyor.paging-runtime,paging-guava,paging-rxjava2vepaging-rxjava3yalnı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ı
- Paging'in Kotlin Multiplatform'a taşınmasına yardımcı olduğu için Cash App'ten veyndan'a teşekkür ederiz (#560, #561, #562, #573, #576, #577, #578, #579, #580, #581, #583, #584, #586, #609).
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
*-jvmve*-androidyapıları var. macOS, iOS ve Linux varyantları için3.3.0-alpha02kullanı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ınasSnapshot()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çinLoadStatessağlayanPagingData.fromaşı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.Mainkullanı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 bunuPagingDataMutableStateFlowiçinde sarmalayarak (ör.MutableStateFlow(PagingData.from(listOf(1, 2, 3)))) sahte veri listesini önizleme desteği. Önizleme içincollectAsLazyPagingItems()alıcısı olarak bu akışı@Previewbileşenlerine iletin.LazyVerticalGridveHorizontalPagergibi 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,keyvecontentTypeparametreleriniLazyColumn,LazyVerticalGridiçin mevcut olan standartitemsAPI'lerine veHorizontalPagergibi API'lerdeki eşdeğerlerine uygulamanıza yardımcı olan yeni alt düzeyLazyPagingItemsuzantı yöntemleriitemKeyveitemContentTypeile sağlandı.- Yalnızca
LazyListScopedestekleyenitems(lazyPagingItems)veitemsIndexed(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-testingyapısı. Örneğin, şunları içerir:TestPagersınıfını kullanabilirsiniz. Bu sınıf, kendi özelPagingSourceuygulamanızın davranışını sayfa gezgininden ve gerçek kullanıcı arayüzünden bağımsız olarak doğrulamanıza olanak tanır.-
asPagingSourceFactoryAPI'leri, testlerde bir sayfa gezginine aktarılabilecekPagingSourceFactoryoluşturmak içinFlow<List<Value>>veya statikList<Value>dönüştürür. Flow<PagingData<Value>>üzerindeasSnapshotKotlin uzantısı. Bu uzantı,Flow<PagingData<Value>>değerini doğrudanList<Value>değerine dönüştürür.asSnapshot lambda,scrollToveyaappendScrollWhilegibi 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:
VERBOSEveDEBUG. 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. PagingDataAdapterveAsyncPagingDataDifferiçinCoroutineDispatcheryerineCoroutineContextkabul eden yapıcılar eklendi.- Önceki () ->
PagingSourcelambda'lardan daha açık bir API yüzeyi sağlayan yeni birPagingSourceFactoryiş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-alpha20sürümünden diğer tüm Paging yapılarıyla eşleşecek şekilde güncellendi.
API Değişiklikleri
- Desteği sonlandırılan
items(LazyPagingItems)veitemsIndexed(LazyPagingItems)API'leri Paging Compose'dan kaldırıldı. Değiştirilen API'lerin bir örneği için Paging Compose1.0.0-alpha20sürüm notlarını inceleyin. (I9626e)
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
() -> PagingSourcelambda'lardan daha açık bir API yüzeyi sağlayan yeni birPagingSourceFactoryişlevsel arayüzü eklendi. Bu fabrika,Pagerörneklendirmek için kullanılabilir. (I33165, b/280655188) - Yalnızca sabit bir veri listesinden yüklenen
PagingSourceFactoryelde etmek için yeniList<Value>.asPagingSourceFactory()paging-testingAPI'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
@VisibleForTestingile ek açıklama eklenmiştir. (I7db6e) asSnapshotAPI'si artıkCoroutineScopeparametresinin iletilmesini gerektirmiyor. Artık varsayılan olarak üst kapsamından devralınan bağlamı kullanır. (Id0a78, b/282240990)TestPageroluşturucu parametreleri, gerçekPageroluş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
asSnapshotsayfalama 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
asSnapshotiçin Paging Testing API'ninloadOperationsparametresi 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 iletmedenasSnapshotç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ürenFlowüzerinde bir uzantı yöntemi olduğunu açıklayacak şekilde güncellendi. (I5ff4f, I705b5)- Atlamayı desteklemek için
itemsBeforeveitemsAfteryöntemlerinin geçersiz kılınması gerektiğini açıklamak amacıylaLoadResult.Pageoluşturucusuyla ilgili dokümanlar güncellendi. (Ied354)
Harici Katkılar
- Paging'i Android/JVM özelliklerinden uzaklaştırmaya katkıda bulunan Veyndan'a teşekkür ederiz. (#525, #523, #520, #519, #507, #506, #505, #499, #497, #496, #493)
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-testingyapısı artık bir sayfa gezginine sağlanacakFlow<List<Value>>öğesindenpagingSourceFactoryoluşturmak için birasPagingSourceFactoryyöntemi içeriyor. Flow'dan yayılan herList<Value>>, bir sayfalara ayrılmış veri neslini temsil eder. Bu, sayfa gezgininin veri toplayacağı bir veri kaynağını taklit ederek örneğinPagingDatadönüşümlerinde sayfalama testlerini kolaylaştırır. (I6f230, b/235528239)paging-testingyapı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 birFlow<PagingData<T>>çıkışını onaylamak için kullanılabilir.Bu işlem,
Flow<PagingData<Value>>üzerindekiasSnapshotKotlin uzantısı aracılığıyla yapılır. Bu uzantı,Flow<PagingData<Value>>değerini doğrudan birList<Value>değerine dönüştürür.asSnapshotlambda,scrollToveyaappendScrollWhilegibi 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 valuesasSnapshot,runTestiçinde çalıştırılması beklenen birsuspendyö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
AsyncPagingDataDiffervePagingDataAdapteriçindekigetItemvepeekiç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)TestPagertarafı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()üzerindenLoadResult.Page.dataüzerinde kolay iterasyon sağlar. Bu,PagingSource.getRefreshKeyyöntemine iletilenPagingStateöğesininpagesözelliği gibi birList<LoadResult.Page>verildiğinde Kotlin standart kitaplığıflattenyö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çinAsyncPagingDataDifferveyaPagingDataAdaptersınıfları aracılığıyla günlükler sağlar. - Günlükler,
adb shellkomutuadb 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.1veya daha eski çalışma zamanı ile kullanılırken eksikPagingDataDifferoluş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
PagingDataAdapterveAsyncPagingDataDifferiçinCoroutineDispatcheryerineCoroutineContextkabul eden yapıcılar eklendi. (Idc878)- Varsayılan olarak
PagingData.from()vePagingData.empty(), sunucu tarafındaCombinedLoadStates'yi artık etkilemeyecek.sourceLoadStatesremoteLoadStatesLoadStatesdeğerini tamamen terminal olarak ayarlama (ör.NotLoading(endOfPaginationReached = false)) ve gerekirse uzak durumları da dahil etme seçeneği sunar.LoadStatesiletilmezse sunucu tarafı statikPagingDataaldığında öncekiCombinedLoadStateskorunur. (Ic3ce5, b/205344028)
Hata Düzeltmeleri
PagingSource.getRefreshKey()işlevinin sonucu, null değer döndüreceği ancak null olmayan birinitialKeydeğerinin ayarlandığı durumlarda artıkinitialKeyiş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 araLoadState.NotLoadingetkinlikleri kaldırıldı. Bu değişiklik, başarısız yüklemeleri yeniden denerken, yenilerken veya geçersiz kılarken üretilen gereksizLoadState.NotLoadingetkinliklerini kaldırarakLoadStatedeğ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>.observableveFlow<PagingData>.flowableAPI'leri artık deneysel değilLoadStateile ilgili davranış değişiklikleri:endOfPaginationReachedartık hemPagingSourcehem deRemoteMediatoriçin her zamanLoadType.REFRESHkarşılığındafalse- Paging'den
LoadStates, alt akışa yayınlanmadan önce hemPagingSourcehem deRemoteMediator'den geçerli değerler bekliyor.PagingDataiçin yeni nesiller artık her zaman yenileme durumu için doğru şekildeLoadingile başlayacak ve bazı durumlarda yanlışlıklaNotLoadingolarak sıfırlanmayacak. - Sunucu API'lerindeki
.loadStateFlowve.addLoadStateListener, artık her zamannullolarak ayarlanmış aracı durumlarına sahip ilkCombinedLoadStatesdeğ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.collectLatestkullanılması artık zorunlu olmasa da bunu yapmanız önerilir. PagingSource.LoadResult.Invalid,PagingSource.loadiçin yeni bir dönüş türü olarak eklendi. Bu nedenle, sayfalama buPagingSourceiç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
.onPagesPresentedve.addOnPagesUpdatedListenersunucu 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>.observableveFlow<PagingData>.flowableAPI'leri artık deneysel değil. (Ie0bdd)
Hata Düzeltmeleri
- LoadStates için
endOfPaginationReachedartık her zamanLoadType.REFRESHiçinfalse. Daha önce, RemoteMediatorREFRESHiçin endOfPaginationReachedtrueolabiliyordu ancak PagingSource için bu mümkün değildi. Bu davranış artık her zamanfalsedö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
.loadStateFlowve.addLoadStateListener, artık gereksiz yere aracı durumlarınullve kaynak durumlarıNotLoading(endOfPaginationReached = false)olarak ayarlanmış bir ilkCombinedLoadStatesgöndermiyor. Bunun anlamı:- RemoteMediator kullanıyorsanız aracı durumları her zaman doldurulur.
.loadStateFlowüzerinde yeni bir loadState dinleyicisi veya yeni bir toplayıcı kaydetmek,PagingDataüzerinden gerçek birCombinedLoadStatesalmadıysa mevcut değeri hemen yayınlamayacak. Bu durum, bir toplayıcı veya dinleyiciPagingDatagö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-rxjava3tarafından sağlanan sınıflar artıkandroidx.paging.rxjava3paketi altında yer alıyor. Böylecepaging-rxjava2ile ç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 buPagingDataöğesiniMutableStateFlow(ö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ızdacollectAsLazyPagingItems()çağrıları, önizlenebilirLazyPagingItemssağlar. (I8a78d, b/194544557)
Hata Düzeltmeleri
LazyPagingItemsuygulamasında toplananpager.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üzerindekiitemsveitemsIndexeduzantı işlevleri artık yeni API'lerdeki desteği yansıtan bircontentTypeparametresini 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
collectLazyPagingItemsçağrılırken özel birCoroutineContextiçin destek ekleyin. (I7a574, b/243182795, b/233783862)
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
LazyPagingItemssınıfı aracılığıyla günlükler sağlar. - Günlükler,
adb shellkomutuadb 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.1veya daha eski sürümlerle kullanıldığında ortaya çıkan eksikPagingDataDifferoluş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
PagingDataAdapterveAsyncPagingDataDifferiçinCoroutineDispatcheryerineCoroutineContextkabul eden yapıcılar eklendi. (Idc878)
Hata Düzeltmeleri
LazyPagingItems, ilkloadStatedeğeriniLoadState.Loadingyenileme 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/Rowile bağlamak için kullanılanitems(lazyPagingItems)veitemsIndexed(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 yerinelazyPagingItems[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-alpha09yalnızca Compose1.0.0-beta07ve 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.appendkolaylık özellikleri, yalnızca hem uyumlulaştırıcı hem de kaynak yükleme durumlarıNotLoadingolduğundaLoadingdurumundanNotLoadingdurumuna 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/PagingDataAdapterile aynı işlevleri sunanLazyPagingItemsı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
LivePagedListveyaRxPagedListtarafından üretilen ilk değerdenPagedList.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ığındaDataSource.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
@ExperimentalCoroutinesApietkinleştirme şartını doğru şekilde uyguluyor. Daha önce@getyö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
PagingStatedeğerinin her zamannullolmasına neden olan bir hata düzeltildi. - PagingSource tarafından döndürülen boş sayfaların, Paging'in
prefetchDistancedeğ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
DataSourceAPI'leri kullanılırken bazen ortaya çıkanIndexOutOfBoundsException: Inconsistency detectedhatası düzeltildi. - Uyumluluk yolları üzerinden kullanıldığında
DataSourcebaşlatılırken yapılanisInvalidçağrısı artık ana iş parçacığı yerine fetchDispatcher'da doğru şekilde başlatılıyor. Bu sayede, Room'unPagingSourceuygulamasını kullanırken ana iş parçacığındaki veritabanı erişimi nedeniyle oluşanIllegalStateExceptionhatası 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.getRefreshKeyartı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ızcanulldöndürür ancakgetRefreshKey(), 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ünsePagingState.anchorPositionaracılığıyla görüntü alanının etrafında ortalanmış olarak yüklemeye devam edebilir. (I4339a)InvalidatingPagingSourceFactoryartı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ındaRemoteMediator.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.invalidateartı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.appendkolaylık özellikleri, yalnızca hem uyumlulaştırıcı hem de kaynak yükleme durumlarıNotLoadingolduğundaLoadingdurumundanNotLoadingdurumuna geçecek şekilde güncellendi. (I65619) LoadParams.pageSize kaldırıldı (zaten desteği sonlandırılmıştı). PagingSource'unuzda
LoadParams.loadSizekullanmanız önerilir.LoadParams.loadSize, ilk yükleme çağrısı dışında her zamanPagingConfig.pageSizedeğerine eşittir. İlk yükleme çağrısında isePagingConfig.initialLoadSizedeğerine eşittir.Paging2 DataSource'unuzu sayfa gezgini veya PagedList kullanmadan test ediyorsanız
initialLoadSizedeğerini de ayarladığınızdapageSize,PagingConfig.pageSizeile 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()), destekleyiciDataSourceöğ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
dataRefreshFlowvedataRefreshListenerAPI'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 }
Hata Düzeltmeleri
- RemoteMediator
REFRESHiçin endOfPaginationReached artık LoadState güncellemelerine doğru şekilde yayılıyor ve uzakAPPENDilePREPENDöğ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
PREPENDveyaAPPENDyü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
getRefreshKeyyö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 uzakLoadStatetakı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
IllegalArgumentExceptionhatası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.mapveya.mapByPagetarafı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*ConcatAdapteryardı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.Errordö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
AsyncPagingDataDiffervePagingDataAdapter'yepeek()API'si eklendi. (I38898, b/159104197) - Sayfa getirme işlemini tetiklemeden sunulan öğelerin alınmasına olanak tanımak için
PagingDataAdapterveAsyncPagingDataDiffer'ye birsnapshot()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).
PagingSourceveRemoteMediatoriçin RxJava3 uyumluluk sarmalayıcıları eklendi (I49ef3, b/161480176)
Hata Düzeltmeleri
toPagingSourceFactoryyardımcı programı aracılığıylaPagingSourcedeğerine dönüştürülenPositionalDataSource(Room tarafından oluşturulanPagingSourcedahil) 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
ClosedSendChannelExceptionhatası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
PagingConfigoluş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)
PagingDataAdapterveAsyncPagingDataDifferoluşturucuları için aşırı yüklemeler eklendi. dataRefreshFlowvedataRefreshListenerbağdaştırıcı API'leri artıkPagingDataöğ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()vefirstItemOrNull()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 fazlaPagingDataü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
- Kotlin eş yordamları ve Flow için birinci sınıf destek.
- Eş yordam askıya alma işlevleri, RxJava Single veya Guava ListenableFuture temel öğeleri ile eşzamansız yükleme desteği.
- Yeniden deneme ve yenileme işlevi de dahil olmak üzere duyarlı kullanıcı arayüzü tasarımı için yerleşik yükleme durumu ve hata sinyalleri.
- Depo katmanında yapılan iyileştirmeler
- Basitleştirilmiş veri kaynağı arayüzü
- Basitleştirilmiş ağ ve veritabanı sayfalama
- İptal desteği
- Sunum katmanında yapılan iyileştirmeler
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
IndexOutOfBoundsExceptionhatası düzeltildi.
Sürüm sorunu
Paging'in
2.1.1sü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.Builderiçin Kotlin alternatifi olarakandroidx.paging.Config()eklendiPagedList.Builderiçin Kotlin alternatifi olarakandroidx.paging.PagedList()eklendiLivePagedListBuilderiçin Kotlin alternatifi olarakDataSourceFactory.toLiveData()eklendiRxPagedListBuilderiçin Kotlin alternatifleri olarakDataSourceFactory.toObservable()vetoFlowable()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ıkIndexOutOfBoundsExceptionhatası 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
PositionalDataSourceve 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.1sürümünde yayınlandı)PagedListAdapterveAsyncPagedListDiffer'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
PagedListAdapterveAsyncPagedListDiffer'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, yeniandroid.arch.paging:rxjava2yapı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.BuilderveLivePagedListBuilderdillerinde)setMainThreadExecutor(),setNotifyExecutor()olarak yeniden adlandırıldı (PagedList.Builderiç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 ilkPagedListyüklemeyi tetikler.Dahili
DataSourcesarmalayıcılarında geçersiz kılma davranışı düzeltildi (DataSource.mapve yer tutucu devre dışı bırakılmışPositionalDataSourceyü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.LoadParamsnesnelerinin artık herkese açık bir oluşturucusu var veDataSource.LoadCallbacknesneleri artık soyut. Bu sayede,DataSourcesarmalanabilir veya sahte geri çağırma ile doğrudanDataSourcetest edilebilir. b/72600421- DataSource ve DataSource.Factory için eşleyiciler
map(Function<IN,OUT>),DataSourcetarafı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/72611341recyclerview.extensionspaketinin kalıntıları veLivePagedListProviderdahil 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
DataSourceuygulaması 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
PositionalDataSourceiçinBoundaryCallback.onItemAtEndLoadediş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