पृष्ठांकन
इस टेबल में, androidx.paging ग्रुप के सभी आर्टफ़ैक्ट की सूची दी गई है.
| सह-प्रॉडक्ट | स्टेबल वर्शन | रिलीज़ कैंडिडेट | बीटा रिलीज़ | ऐल्फ़ा रिलीज़ |
|---|---|---|---|---|
| paging-* | 3.5.3 | - | - | 3.6.0-alpha01 |
| paging-compose | 3.5.3 | - | - | 3.6.0-alpha01 |
डिपेंडेंसी का एलान करना
Paging पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट में Google Maven रिपॉज़िटरी जोड़नी होगी. ज़्यादा जानकारी के लिए, Google की Maven रिपॉज़िटरी पढ़ें.
अपने ऐप्लिकेशन या मॉड्यूल के लिए, build.gradle फ़ाइल में उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको ज़रूरत है:
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 एक्सटेंशन इस्तेमाल करने के बारे में जानकारी पाने के लिए, ktx दस्तावेज़ देखें.
डिपेंडेंसी के बारे में ज़्यादा जानने के लिए, बिल्ड डिपेंडेंसी जोड़ना लेख पढ़ें.
सुझाव/राय दें या शिकायत करें
आपके सुझाव, शिकायत या राय से Jetpack को बेहतर बनाने में मदद मिलती है. अगर आपको कोई नई समस्या मिलती है या आपके पास इस लाइब्रेरी को बेहतर बनाने के लिए सुझाव हैं, तो हमें बताएं. कृपया नई समस्या सबमिट करने से पहले, इस लाइब्रेरी में शामिल मौजूदा समस्याओं को देखें. स्टार बटन पर क्लिक करके, किसी मौजूदा समस्या के लिए वोट किया जा सकता है.
ज़्यादा जानकारी के लिए, Issue Tracker का दस्तावेज़ देखें.
वर्शन 3.6
वर्शन 3.6.0-alpha01
18 नवंबर, 2026
androidx.paging:paging-*:3.6.0-alpha01 रिलीज़ हो गया है. वर्शन 3.6.0-alpha01 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
ItemSnapshotListने Lazy foundations के लिए एक्सटेंशन जोड़े. अबItemSnapshotList#itemKeyऔरItemSnapshotList#itemContentTypeको कॉल करके, Lazy foundation के लिएitemKeyऔरcontentTypeअपने-आप जनरेट होने की सुविधा चालू की जा सकती है. (I73455, b/560754841)
बाहरी योगदान
ItemSnapshotListएक्सटेंशन जोड़ने के लिए धन्यवाद कमल.
वर्शन 3.5
वर्शन 3.5.3
12 अक्टूबर, 2026
androidx.paging:paging-*:3.5.3 रिलीज़ हो गया है. वर्शन 3.5.3 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- जब
RemoteMediatorकिसी भी दिशा में पेजेशन के आखिर तक पहुंच जाता है और हेडर या फ़ुटर को टर्मिनल सेपरेटर में बदल दिया जाता है, तबItemSnapshotListFlowअबIllegalArgumentExceptionको थ्रो नहीं करेगा. (I821c7, b/566336825) - जब लोड किए गए पेज
PagingConfig.maxSizeसे ज़्यादा हो जाते हैं, तो लोड किए गए पेज दो से कम नहीं होंगे. इससे यह पक्का किया जा सकेगा कि व्यूपोर्ट में डेटा सही तरीके से भरा गया है. (I037a0, b/565835910)
बाहरी योगदान
गड़बड़ी b/565835910 को ठीक करने के लिए, Igor आपका धन्यवाद
वर्शन 3.5.2
7 अक्टूबर, 2026
androidx.paging:paging-*:3.5.2 रिलीज़ हो गया है. वर्शन 3.5.2 में ये कमिट शामिल हैं.
गड़बड़ियां ठीक की गईं
- शुरुआती रीफ़्रेश पूरा होने से पहले
Pager.append()कॉल करने पर, अबNoSuchElementExceptionनहीं दिखेगा. अपेंड कॉल, no-op होगा. (Ide387, b/556780796)
वर्शन 3.5.1
12 अगस्त, 2026
androidx.paging:paging-*:3.5.1 रिलीज़ हो गया है. वर्शन 3.5.1 में ये कमिट शामिल हैं.
गड़बड़ियां ठीक की गईं
PagingSource.getRefreshKeyमें मौजूद उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, प्लेसहोल्डर में स्क्रोल करते समय सेपरेटर वाले पेज को रीफ़्रेश करने पर, गलतanchorPositionदिखता था. यह बहुत बड़ा होता था. (I475f0, b/516565503)
वर्शन 3.5.0
6 मई, 2026
androidx.paging:paging-*:3.5.0 रिलीज़ हो गया है. वर्शन 3.5.0 में ये कमिट शामिल हैं.
3.4.0 के बाद किए गए अहम बदलाव:
Flow<PagingData>कोFlow<ItemSnapshotList>में बदलने के लिए,Flow<PagingData>.asItemSnapshotListFlowऑपरेटर जोड़ा गया. इसका मतलब है कि लोड किए गए डेटा को अब यूज़र इंटरफ़ेस (यूआई) लेयर के बाहर ऐक्सेस किया जा सकता है. इससे आपकोFlow<ItemSnapshotList>को अन्य डेटा सोर्स के साथ जोड़ने, पेज पर मौजूद डेटा को कैश मेमोरी में सेव करने, और उसमें स्थानीय तौर पर बदलाव करने की सुविधा मिलती है. इसके अलावा, पेज पर मौजूद डेटा को यूज़र इंटरफ़ेस (यूआई) की स्थिति के हिस्से के तौर पर दिखाया जा सकता है.बिना स्क्रोल किए, मैन्युअल तरीके से ज़्यादा डेटा लोड करने के लिए, एक्सटेंशन फ़ंक्शन
Pager.appendऔरPager.prependजोड़े गए.asItemSnapshotListFlowएपीआई का इस्तेमाल करते समय, लोड होने से जुड़ी गड़बड़ियों को ठीक करने के लिए, एक्सटेंशन फ़ंक्शनPager.refreshऔरPaging.retryजोड़े गए.
वर्शन 3.5.0-rc01
22 अप्रैल, 2026
androidx.paging:paging-*:3.5.0-rc01 रिलीज़ हो गया है. वर्शन 3.5.0-rc01 में ये कमिट शामिल हैं.
कोई बदलाव नहीं
- वर्शन
3.5.0-beta01के बाद से कोई खास बदलाव नहीं किया गया है.
वर्शन 3.5.0-beta01
8 अप्रैल, 2026
androidx.paging:paging-*:3.5.0-beta01 रिलीज़ हो गया है. वर्शन 3.5.0-beta01 में ये कमिट शामिल हैं.
एपीआई में बदलाव
Flow<PagingData>.asStateएपीआई का नाम बदलकरFlow<PagingData>.asItemSnapshotListFlowकर दिया गया है (I0dc11, b/496548025)
वर्शन 3.5.0-alpha01
11 मार्च, 2026
androidx.paging:paging-*:3.5.0-alpha01 रिलीज़ हो गया है. वर्शन 3.5.0-alpha01 में ये बदलाव शामिल हैं.
नई सुविधाएं
paging-commonआर्टफ़ैक्ट में अबFlow<PagingData>पर एक नयाasStateफ़्लो ऑपरेटर मौजूद है, ताकि इसेFlow<ItemSnapshotList>में बदला जा सके. इससे ये काम किए जा सकते हैं:ItemSnapshotListके फ़्लो को अन्य डेटा सोर्स के साथ जोड़नाcachedInके बिना, कई कलेक्टर के साथ फ़्लो शेयर करें- पेज के डेटा को डिवाइस पर कैश मेमोरी में सेव करना
- मेमोरी में मौजूद पेज किए गए डेटा में बदलाव करना
- यूज़र इंटरफ़ेस (यूआई) की स्थिति के हिस्से के तौर पर, पेज पर मौजूद डेटा को एक्सपोज़ करना
// In your ViewModel val pager = Pager(pagingConfig, pagingSourceFactory) val pagerFlow = pager.flow.asState() // alterantively convert the flow to a SharedFlow val pagerFlow = pager.flow.asState().stateIn() // In presenter layer val snapshotFlow = viewModel.pagerFlow.collectAsStateWithLifecycle(initialList) val snapshot = itemsFlow.value LazyColumn { items(items = snapshot.items) { ... } }paging-commonआर्टफ़ैक्ट मेंPager.appendऔरPager.prependएपीआई भी जोड़े गए हैं. इनकी मदद से, लोड किए गए आइटम के किसी भी किनारे पर, मैन्युअल तरीके से लोड ट्रिगर किए जा सकते हैं.paging-runtimeयाpaging-composeके साथ इस्तेमाल करने पर, स्क्रोल करने के अलावा ज़्यादा डेटा लोड करने का विकल्प मिलता है- नए
asStateएपीआई के साथ इस्तेमाल करने पर, ज़्यादा डेटा लोड करने का यही एकमात्र तरीका है
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एपीआई का इस्तेमाल करते समय, लोड होने से जुड़ी गड़बड़ियों को ठीक करने के लिए,Pager.refreshऔरPager.retryको जोड़ा गया. नए एपीआई के इस्तेमाल के ज़्यादा उदाहरण देखने के लिए, यह दस्तावेज़ देखें. (I1e1e9, If3c87, Idbd48, Id1e1d, I816fe)
वर्शन 3.4
वर्शन 3.4.2
11 मार्च, 2026
androidx.paging:paging-*:3.4.2 रिलीज़ हो गया है. वर्शन 3.4.2 में ये बदलाव शामिल हैं.
कोई बदलाव नहीं
- इस रिलीज़ में, वर्शन 3.4.1 के मुकाबले एपीआई या व्यवहार में कोई बदलाव नहीं किया गया है.
वर्शन 3.4.1
11 फ़रवरी, 2026
androidx.paging:paging-*:3.4.1 रिलीज़ हो गया है. वर्शन 3.4.1 में ये बदलाव शामिल हैं.
डिपेंडेंसी अपडेट
- paging-guava की guava डिपेंडेंसी को वर्शन 31.1 से 32.0.1 पर अपडेट किया गया.
वर्शन 3.4.0
28 जनवरी, 2026
androidx.paging:paging-*:3.4.0 रिलीज़ हो गया है. वर्शन 3.4.0 में ये कमिट शामिल हैं.
3.3.0 के बाद किए गए अहम बदलाव:
paging-common,paging-testing, औरpaging-composeमें ज़्यादा केएमपी टारगेट जोड़े गए. अब ये सभी जेवीएम (Android और डेस्कटॉप), नेटिव (Linux, iOS, watchOS, tvOS, macOS, MinGW), और वेब (JavaScript, WasmJS) के साथ काम करते हैंpaging-common,paging-testing, औरpaging-composeनेmacosX64,iosX64,watchosX64, औरtvosX64के लिए सहायता देना बंद कर दिया है. ऐसा Jetbrains के macosX64 टारगेट को बंद करने की वजह से किया गया है.- लोड किए गए उस आइटम को वापस पाने के लिए, नया
PagingStateएपीआईclosestItemAroundPositionजोड़ा गया है जो टारगेट पोज़िशन के सबसे नज़दीक है और इनपुट प्रेडिकेट से मैच करता है. इसका इस्तेमाल, आइटम के हिसाब से रीफ़्रेश बटन जनरेट करने के लिए किया जा सकता है. ऐसा तब किया जाता है, जब ऐंकर किया जा सकने वाला आइटम आस-पास मौजूद हो, लेकिन टारगेट की गई जगह पर न हो.
वर्शन 3.4.0-rc01
14 जनवरी, 2026
androidx.paging:paging-*:3.4.0-rc01 रिलीज़ हो गया है. वर्शन 3.4.0-rc01 में ये कमिट शामिल हैं.
नई सुविधाएं
- Jetbrains की ओर से macosX64 टारगेट के बंद होने की वजह से, इन केएमपी प्लैटफ़ॉर्म के लिए सहायता हटा दी गई है:
macosX64,iosX64,watchosX64, औरtvosX64. (7cb9a4)
वर्शन 3.4.0-beta01
17 दिसंबर, 2025
androidx.paging:paging-*:3.4.0-beta01 रिलीज़ हो गया है. वर्शन 3.4.0-beta01 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
RecyclerViewऔरRefreshके लोड होने के बीच की रेस को ठीक किया गया. इसकी वजह से,RecyclerViewमेंIndexOutOfBoundsExceptionकी समस्या आ रही थी.Refreshके लगातार लोड होने की वजह से, यूज़र इंटरफ़ेस (यूआई) के अपडेट में रुकावट आ सकती है. इससे पेजिंग की स्थिति,RecyclerViewके साथ सिंक नहीं हो पाती. अगर रीफ़्रेश करने में कोई रुकावट आती है, तो पेजिंग को रीफ़्रेश करने से पहले की स्थिति पर रीसेट करके इसे ठीक किया जाता है. जैसे, लगातारRefreshलोड होने की वजह से. (I771b0, b/409809768)
वर्शन 3.4.0-alpha04
10 सितंबर, 2025
androidx.paging:paging-*:3.4.0-alpha04 रिलीज़ हो गया है. वर्शन 3.4.0-alpha04 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
- लोड किए गए उस आइटम को वापस पाने के लिए, नया
PagingStateएपीआईclosestItemAroundPositionजोड़ा गया है जो टारगेट पोज़िशन के सबसे नज़दीक है और इनपुट प्रेडिकेट से मैच करता है. इसका इस्तेमाल, आइटम के हिसाब से रीफ़्रेश बटन जनरेट करने के लिए किया जा सकता है. ऐसा तब किया जाता है, जब ऐंकर किया जा सकने वाला आइटम आस-पास मौजूद हो, लेकिन टारगेट की गई जगह पर न हो. (I96e5c, b/440187139)
वर्शन 3.4.0-alpha03
27 अगस्त, 2025
androidx.paging:paging-*:3.4.0-alpha03 रिलीज़ हो गया है. वर्शन 3.4.0-alpha03 में ये कमिट शामिल हैं.
नई सुविधाएं
- Paging-common ने डेस्कटॉप को नए Kotlin Multiplatform (केएमपी) टारगेट के तौर पर जोड़ा है. अब यह जेवीएम (Android और डेस्कटॉप), नेटिव (Linux, iOS, watchOS, tvOS, macOS, MinGW), और वेब (JavaScript, WasmJS) पर काम करता है. (Id2483, b/436884811)
- Paging-testing में नए Kotlin Multiplatform (केएमपी) टारगेट जोड़े गए हैं. अब यह जेवीएम (Android और डेस्कटॉप), नेटिव (Linux, iOS, watchOS, tvOS, macOS, MinGW), और वेब (JavaScript, WasmJS) पर काम करता है. (I0c543, b/435014650)
- Paging-compose में नए Kotlin Multiplatform (केएमपी) टारगेट जोड़े गए हैं. अब यह जेवीएम (Android और डेस्कटॉप), नेटिव (Linux, iOS, watchOS, tvOS, macOS, MinGW), और वेब (JavaScript, WasmJS) पर काम करता है. (I70d44, b/436884801)
एपीआई में बदलाव
- डिफ़ॉल्ट minSdk को एपीआई 21 से एपीआई 23 पर ले जाया गया (Ibdfca, b/380448311, b/435705964, b/435705223)
वर्शन 3.4.0-alpha02
30 जुलाई, 2025
androidx.paging:paging-*:3.4.0-alpha02 रिलीज़ हो गया है. वर्शन 3.4.0-alpha02 में ये कमिट शामिल हैं.
एपीआई में बदलाव
PagingData.fromअबplaceholdersBeforeऔरplaceholdersAfterको सेट करने की अनुमति देता है. ध्यान दें कि इन प्लेसहोल्डर को स्क्रोल करने से, लोड ट्रिगर नहीं होते. (I06983)
वर्शन 3.4.0-alpha01
2 जुलाई, 2025
androidx.paging:paging-*:3.4.0-alpha01 रिलीज़ हो गया है. वर्शन 3.4.0-alpha01 में ये बदलाव शामिल हैं.
नई सुविधाएं
- Paging ने ये केएमपी टारगेट जोड़े हैं: watchos, tvos, mingwX64, watchosDeviceArm64, और linuxArm64. (I237dd, Ia62b3, b/368046982, Icf15d, b/364652024, I139d3, b/338268719)
गड़बड़ियां ठीक की गईं
- Paging 3.3 या इसके बाद के वर्शन का इस्तेमाल करने वाले Android यूनिट टेस्ट, अब
PagingLoggerसे थ्रो नहीं करेंगे (Ia9400, b/331684448) - उस गड़बड़ी को ठीक किया गया है जिसमें
RecyclerViewको अपडेट करते समय स्क्रोल करने पर,IndexOutOfBoundsExceptionथ्रो होता था (Id1f16, b/381024738)RecyclerView - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से स्क्रोल करते समय रीफ़्रेश करने पर, पेजिंग ज़्यादा लोड ट्रिगर नहीं कर पा रही थी. (I60ca5, b/352586078)
- पेजिंग आइटम रीफ़्रेश करते समय स्क्रोल करने पर, ऐप्लिकेशन क्रैश होने की समस्या को ठीक किया गया. (I8c65a, b/347649763)
वर्शन 3.3
वर्शन 3.3.6
12 फ़रवरी, 2025
androidx.paging:paging-*:3.3.6 रिलीज़ हो गया है. वर्शन 3.3.6 में ये कमिट शामिल हैं.
गड़बड़ियां ठीक की गईं
- शुरुआती रीफ़्रेश के दौरान भेजे गए रीफ़्रेश और फिर से कोशिश करने के सिग्नल अब सेव किए जाएंगे. साथ ही, पेजिंग प्रज़ेंटर के तैयार होने पर, वे अपने-आप फिर से भेजे जाएंगे.
बाहरी योगदान
वर्शन 3.3.5
11 दिसंबर, 2024
androidx.paging:paging-*:3.3.5 रिलीज़ हो गया है. वर्शन 3.3.5 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से
RecyclerViewको अपडेट करते समय स्क्रोल करने पर,RecyclerViewमेंIndexOutOfBoundsExceptionदिखता था. (Id1f16, b/381024738)
वर्शन 3.3.4
13 नवंबर, 2024
androidx.paging:paging-*:3.3.4 रिलीज़ हो गया है. वर्शन 3.3.4 में ये कमिट शामिल हैं.
गड़बड़ियां ठीक की गईं
- Paging 3.3 या इसके बाद के वर्शन का इस्तेमाल करने वाले Android यूनिट टेस्ट में, अब
Method isLoggable in android.util.Log not mockedजैसी गड़बड़ी नहीं दिखेगी. (Ia9400, b/331684448)
वर्शन 3.3.2
7 अगस्त, 2024
androidx.paging:paging-*:3.3.2 रिलीज़ हो गया है. वर्शन 3.3.2 में ये कमिट शामिल हैं.
नई सुविधाएं
paging-commonऔरpaging-testingमें नए Kotlin-Multiplatform टारगेट जोड़े गए हैं:watchos,tvos, औरlinuxArm64(90c9768), (53e0eca)
वर्शन 3.3.1
24 जुलाई, 2024
androidx.paging:paging-*:3.3.1 रिलीज़ हो गया है. वर्शन 3.3.1 में ये कमिट शामिल हैं.
गड़बड़ियां ठीक की गईं
- उस समस्या को ठीक किया गया है जिसमें स्क्रोल करते समय बैकग्राउंड में डेटा सोर्स रीफ़्रेश होने पर,
AsyncPagingDataDifferया इसके ऊपर बने एपीआई, जैसे किRecyclerViewके साथ इस्तेमाल किए जाने वालेPagingDataAdapter, ज़्यादा लोड ट्रिगर नहीं कर पाते थे. (I60ca5, b/352586078) - उस क्रैश को ठीक किया गया जो
PagingDataAdapterयाAsyncPagingDataDifferका इस्तेमाल करकेRecyclerViewको स्क्रोल करते समय, बैकिंग डेटा सोर्स से आइटम हटाने पर होता है. (I8c65a, b/347649763)
वर्शन 3.3.0
14 मई, 2024
androidx.paging:paging-*:3.3.0 रिलीज़ हो गया है. वर्शन 3.3.0 में ये कमिट शामिल हैं.
3.2.0 के बाद किए गए अहम बदलाव
PagingDataPresenterअब एक सार्वजनिक क्लास है. मल्टीप्लैटफ़ॉर्म प्रज़ेंटर को अबPagingDataPresenterपर बनाया जा सकता है. इसके लिए, इंटरनल पेजिंग एपीआई याpaging-runtimeकेAsyncPagingDataDifferकी ज़रूरत नहीं है.hasErrorऔरisIdleमें नएLoadStatesऔरCombinedLoadStatesहेल्पर तरीके जोड़े गए हैं. इनसे यह पता लगाया जा सकता है किLoadStates, गड़बड़ी याNotLoadingकी स्थिति में है या नहीं. साथ ही,Flow<CombinedLoadStates>पर एक नयाawaitNotLoading()Kotlin एक्सटेंशन मेथड जोड़ा गया है. यह तब तक इंतज़ार करता है, जब तक कि लोडNotLoadingया गड़बड़ी वाली स्थिति में सेटल नहीं हो जाता.PagingData.empty()अब डिफ़ॉल्ट रूप सेNotLoadingस्टेटस भेजता है. हालांकि, अगर इसके कंस्ट्रक्टर को कस्टमLoadStatesपास किया जाता है, तो ऐसा नहीं होता. यह मौजूदा व्यवहार से अलग है. इसमेंPagingDataAdapterपर सबमिट किए जाने पर,LoadStatesको डिस्पैच नहीं किया जाता याLazyPagingItemsके तौर पर इकट्ठा किए जाने पर, लोड होने की स्थितियों को डिस्पैच किया जाता है.LazyPagingItemsके तौर पर इकट्ठा किए जाने पर, अब यह शुरुआती कंपोज़िशन के तुरंत बाद एक खाली सूची भी दिखाएगा.
Kotlin Multiplatform के साथ काम करना
Paging अब Kotlin Multiplatform के साथ काम करने वाले आर्टफ़ैक्ट उपलब्ध कराता है. ऐसा CashApp के multiplatform-paging प्रोजेक्ट के अपस्ट्रीम किए गए काम की वजह से हुआ है.
paging-commonने सभी Paging 3 एपीआई कोcommonपर माइग्रेट कर दिया है. अब यह Android के साथ-साथ, जेवीएम और iOS पर भी काम करता है.paging-testingने अपना कोडcommonपर माइग्रेट कर दिया है. अब यह Android के साथ-साथ, JVM और iOS के साथ भी काम करता है.paging-composeने अपना कोडcommonपर माइग्रेट कर दिया है और Android आर्टफ़ैक्ट को शिप किया है. यहandroidx.composeके मल्टीप्लैटफ़ॉर्म सपोर्ट से मैच करता है.paging-runtime,paging-guava,paging-rxjava2, औरpaging-rxjava3सिर्फ़ Android पर उपलब्ध रहेंगे.
वर्शन 3.3.0-rc01
1 मई, 2024
androidx.paging:paging-*:3.3.0-rc01 को Paging 3.3.0-beta01 में बिना किसी बदलाव के रिलीज़ किया गया है. वर्शन 3.3.0-rc01 में ये बदलाव शामिल हैं.
वर्शन 3.3.0-beta01
3 अप्रैल, 2024
androidx.paging:paging-*:3.3.0-beta01 को बिना किसी खास बदलाव के रिलीज़ किया गया है. वर्शन 3.3.0-beta01 में ये कमिट शामिल हैं.
वर्शन 3.3.0-alpha05
20 मार्च, 2024
androidx.paging:paging-*:3.3.0-alpha05 रिलीज़ हो गया है. वर्शन 3.3.0-alpha05 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
- पेजिंग अब सामान्य कोड के लिए, AndroidX एनोटेशन
@MainThreadएनोटेशन का इस्तेमाल करता है. (I78f0d, b/327682438)
वर्शन 3.3.0-alpha04
6 मार्च, 2024
androidx.paging:paging-*:3.3.0-alpha04 रिलीज़ हो गया है. वर्शन 3.3.0-alpha04 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- Kotlin Multiplatform के साथ काम करने की सुविधा जोड़ने से जुड़ी दस्तावेज़ की छोटी-मोटी गड़बड़ियों को ठीक किया गया. (aosp/2950785)
वर्शन 3.3.0-alpha03
7 फ़रवरी, 2024
androidx.paging:paging-*:3.3.0-alpha03 रिलीज़ हो गया है. वर्शन 3.3.0-alpha03 में ये बदलाव शामिल हैं.
नई सुविधाएं
PagingDataPresenterअब एक सार्वजनिक क्लास है. मल्टीप्लैटफ़ॉर्म प्रज़ेंटर को अबPagingDataPresenterके ऊपर बनाया जा सकता है. इसके लिए, इंटरनल पेजिंग एपीआई याpaging-runtimeकेAsyncPagingDataDifferकी ज़रूरत नहीं है. (Id1f74, b/315214786)LoadStatesऔरCombinedLoadStatesके लिए नए हेल्पर तरीके जोड़े गए हैं, ताकि यह पता लगाया जा सके किLoadStates, गड़बड़ी याNotLoadingकी स्थिति में है या नहीं. हमने एक नया एपीआई भी जोड़ा है. यहLoadStateFlowपर तब तक इंतज़ार करता है, जब तक कि लोडNotLoadingया गड़बड़ी वाले पेज की स्थिति में सेटल नहीं हो जाता. (Id6c67)
व्यवहार में बदलाव
PagingData.empty()अब डिफ़ॉल्ट रूप सेNotLoadingस्टेटस भेजता है. हालांकि, अगर इसके कंस्ट्रक्टर को कस्टमLoadStatesपास किया जाता है, तो ऐसा नहीं होता. यह मौजूदा व्यवहार से अलग है. इसमेंPagingDataAdapterपर सबमिट किए जाने पर,LoadStatesको डिस्पैच नहीं किया जाता याLazyPagingItemsके तौर पर इकट्ठा किए जाने पर, लोड होने की स्थितियों को डिस्पैच किया जाता है.LazyPagingItemsके तौर पर इकट्ठा किए जाने पर, अब यह शुरुआती कंपोज़िशन के तुरंत बाद एक खाली सूची भी दिखाएगा. (I4d11d, b/301833847)
वर्शन 3.3.0-alpha02
20 सितंबर, 2023
androidx.paging:paging-*:3.3.0-alpha02 रिलीज़ हो गया है. वर्शन 3.3.0-alpha02 में ये बदलाव शामिल हैं.
Kotlin Multiplatform के साथ काम करना
Paging अब Kotlin Multiplatform के साथ काम करने वाले आर्टफ़ैक्ट उपलब्ध कराता है. ऐसा CashApp के multiplatform-paging प्रोजेक्ट के अपस्ट्रीम किए गए काम की वजह से हुआ है. इससे हम दो रिपॉज़िटरी के बीच अंतर को कम कर पाएंगे और उन्हें एक-दूसरे के साथ काम करने लायक बना पाएंगे.
paging-commonने सभी Paging 3 एपीआई कोcommonपर माइग्रेट कर दिया है. अब यह Android के साथ-साथ, जेवीएम और iOS पर भी काम करता है.paging-testingने अपना कोडcommonपर माइग्रेट कर दिया है. अब यह Android के साथ-साथ, JVM और iOS के साथ भी काम करता है.paging-composeने अपना कोडcommonपर माइग्रेट कर दिया है और Android आर्टफ़ैक्ट को शिप किया है. यहandroidx.composeके मल्टीप्लैटफ़ॉर्म सपोर्ट से मैच करता है.paging-runtime,paging-guava,paging-rxjava2, औरpaging-rxjava3सिर्फ़ Android पर उपलब्ध रहेंगे.
एपीआई में बदलाव
- सार्वजनिक लॉगर इंटरफ़ेस को बंद कर दिया गया है. इसका इस्तेमाल सिर्फ़ अंदरूनी तौर पर किया जाना था (I16e95, b/288623117)
बाहरी योगदान
- पेजिंग को Kotlin मल्टीप्लैटफ़ॉर्म पर माइग्रेट करने में मदद करने के लिए, Cash App के veyndan को धन्यवाद (#560, #561, #562, #573, #576, #577, #578, #579, #580, #581, #583, #584, #586, #609)
वर्शन 3.3.0-alpha01
20 सितंबर, 2023
- यह androidx.paging लाइब्रेरी की पहली मल्टीप्लैटफ़ॉर्म रिलीज़ है. इस वर्शन में सिर्फ़
*-jvmऔर*-androidआर्टफ़ैक्ट हैं. macOS, iOS, और Linux के वैरिएंट के लिए,3.3.0-alpha02का इस्तेमाल करें.
वर्शन 3.2
वर्शन 3.2.1
6 सितंबर, 2023
androidx.paging:paging-*:3.2.1 रिलीज़ हो गया है. वर्शन 3.2.1 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- उस समस्या को ठीक किया गया है जिसमें पेजिंग टेस्टिंग आर्टफ़ैक्ट के
asSnapshot()एपीआई कोPagingData.from(List)का इस्तेमाल करके बनाए गए फ़्लो को पास करने पर, वह हैंग हो जाता था. ऐसा इसलिए होता था, क्योंकिasSnapshot()को यह जानकारी नहीं होती थी कि लोड होने की प्रोसेस कब पूरी हुई. हालांकि,PagingData.from(List, LoadStates)ओवरलोड के मामले में ऐसा नहीं होता था. यह तरीका सिर्फ़ उन Flows के लिए काम करता है जिन्हें पूरा किया जा सकता है (जैसे,flowOf(PagingData.from(...))). जिन Flows को पूरा नहीं किया जा सकता (जैसे,MutableStateFlow), उनके लिएPagingData.fromओवरलोड का इस्तेमाल करें, जोLoadStatesउपलब्ध कराता है. (I502c3) - Paging Compose अब इंटरनल तौर पर
AndroidUiDispatcher.Mainका इस्तेमाल करता है. इससे यह पक्का किया जाता है कि नया डेटा, लोड होने के बाद उसी फ़्रेम में उपलब्ध हो. (Ia55af)
वर्शन 3.2.0
26 जुलाई, 2023
androidx.paging:paging-*:3.2.0 रिलीज़ हो गया है. वर्शन 3.2.0 में ये बदलाव शामिल हैं.
3.1.0 के बाद किए गए अहम बदलाव
- Paging Compose, एपीआई के स्टेबल वर्शन पर पहुंच गया है. साथ ही, इसे Paging के बाकी हिस्सों में मर्ज कर दिया गया है. अब इसका वर्शन, Paging के अन्य सभी आर्टफ़ैक्ट से मैच करता है. 3.1.0 के बाद किए गए बदलावों में ये शामिल हैं:
PagingData.from(fakeData)बनाकर और उसेPagingDataMutableStateFlow(जैसे,MutableStateFlow(PagingData.from(listOf(1, 2, 3)))) में रैप करके, नकली डेटा की सूची की झलक देखने की सुविधा. इस फ़्लो को@Previewकंपोज़ेबल में पास करें, ताकिcollectAsLazyPagingItems()की झलक देखी जा सके.LazyVerticalGridऔरHorizontalPagerजैसे सभी लेज़ी लेआउट के साथ-साथ, Wear और TV लाइब्रेरी के कस्टम लेज़ी कॉम्पोनेंट के लिए सहायता. इसके लिए, हमनेLazyPagingItemsएक्सटेंशन के नए लोअर लेवल तरीकेitemKeyऔरitemContentTypeउपलब्ध कराए हैं. इनकी मदद से,keyऔरcontentTypeपैरामीटर को स्टैंडर्डitemsएपीआई में लागू किया जा सकता है. ये एपीआई,LazyColumnऔरLazyVerticalGridके लिए पहले से मौजूद हैं. साथ ही,HorizontalPagerजैसे एपीआई में भी ये पैरामीटर लागू किए जा सकते हैं.items(lazyPagingItems)औरitemsIndexed(lazyPagingItems)को बंद कर दिया गया है. ये सिर्फ़LazyListScopeके साथ काम करते थे.
- नया
paging-testingआर्टफ़ैक्ट, जो आपके ऐप्लिकेशन की हर लेयर की यूनिट टेस्टिंग और Paging के साथ उसके इंटिग्रेशन के लिए डिज़ाइन किए गए एपीआई उपलब्ध कराता है. उदाहरण के लिए, इसमें ये शामिल हैंTestPagerक्लास, जिसकी मदद से Pager और असल यूज़र इंटरफ़ेस (यूआई) से अलग, अपने कस्टमPagingSourceके व्यवहार की पुष्टि की जा सकती है.-
asPagingSourceFactoryएपीआई, जोFlow<List<Value>>या स्टैटिकList<Value>कोPagingSourceFactoryमें बदलते हैं. इसे टेस्ट में Pager को पास किया जा सकता है Flow<PagingData<Value>>परasSnapshotKotlin एक्सटेंशन, जोFlow<PagingData<Value>>को सीधेList<Value>में बदलता है.asSnapshot lambdaकी मदद से,scrollToयाappendScrollWhileजैसे एपीआई का इस्तेमाल करके, अपने ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) की नकल की जा सकती है. इससे, पेज पर मौजूद डेटा के सेट में किसी भी समय यह पुष्टि की जा सकती है कि डेटा का स्नैपशॉट सही है या नहीं.
- पेजिंग को डीबग करने की जानकारी को दो लेवल पर दिखाने के लिए, डिफ़ॉल्ट लॉग जोड़े गए हैं:
VERBOSEऔरDEBUG. लॉग कोadb shell setprop log.tag.Paging [DEBUG|VERBOSE]कमांड की मदद से चालू किया जा सकता है. यह व्यू के साथ पेजिंग या Compose के साथ पेजिंग, दोनों पर लागू होता है. PagingDataAdapterऔरAsyncPagingDataDifferके लिए कंस्ट्रक्टर जोड़े गए हैं, जोCoroutineDispatcherके बजायCoroutineContextको स्वीकार करते हैं.- एक नया
PagingSourceFactoryफ़ंक्शनल इंटरफ़ेस जोड़ा गया है. यह पिछले () ->PagingSourceलैम्ब्डा के मुकाबले ज़्यादा साफ़ तौर पर एपीआई सरफ़ेस उपलब्ध कराता है. इस फ़ैक्ट्री का इस्तेमाल, Pager को इंस्टैंशिएट करने के लिए किया जा सकता है.
वर्शन 3.2.0-rc01
21 जून, 2023
androidx.paging:paging-*:3.2.0-rc01 रिलीज़ हो गया है. वर्शन 3.2.0-rc01 में ये बदलाव शामिल हैं.
बाहरी योगदान
- पेजिंग को Android/JVM से अलग करने में योगदान देने के लिए, Veyndan को धन्यवाद. (#553, #554, #555, #559)
वर्शन 3.2.0-beta01
7 जून, 2023
androidx.paging:paging-*:3.2.0-beta01 रिलीज़ हो गया है. वर्शन 3.2.0-beta01 में ये कमिट शामिल हैं.
Paging Compose
- Paging Compose, अब एपीआई के लिए स्टेबल वर्शन में उपलब्ध है. इसलिए, वर्शन को
1.0.0-alpha20से अपडेट कर दिया गया है, ताकि यह पेजिंग के अन्य सभी आर्टफ़ैक्ट के वर्शन से मैच हो सके.
एपीआई में बदलाव
- Paging Compose से, अब काम न करने वाले
items(LazyPagingItems)औरitemsIndexed(LazyPagingItems)एपीआई हटा दिए गए हैं. इनकी जगह इस्तेमाल किए जाने वाले एपीआई का उदाहरण देखने के लिए, Paging Compose1.0.0-alpha20के रिलीज़ नोट देखें. (I9626e)
वर्शन 3.2.0-alpha06
24 मई, 2023
androidx.paging:paging-*:3.2.0-alpha06 रिलीज़ हो गया है. वर्शन 3.2.0-alpha06 में ये बदलाव शामिल हैं.
नई सुविधाएं
- एक नया
PagingSourceFactoryफ़ंक्शनल इंटरफ़ेस जोड़ा गया है. यह मौजूदा() -> PagingSourceलैम्ब्डा की तुलना में, ज़्यादा साफ़ तौर पर एपीआई सरफ़ेस उपलब्ध कराता है. इस फ़ैक्ट्री का इस्तेमाल,Pagerको इंस्टैंशिएट करने के लिए किया जा सकता है. (I33165, b/280655188) List<Value>.asPagingSourceFactory()का नयाpaging-testingएपीआई जोड़ा गया, ताकिPagingSourceFactoryको लोड किया जा सके. यह सिर्फ़ डेटा की ऐसी सूची से लोड होता है जिसमें बदलाव नहीं किया जा सकता.Flow<List<Value>>पर मौजूद एक्सटेंशन का इस्तेमाल, स्टैटिक डेटा की कई जनरेशन के साथ टेस्टिंग के लिए किया जाना चाहिए. (Id34d1, b/280655188)
एपीआई में बदलाव
- paging-testing में मौजूद सभी सार्वजनिक एपीआई को अब
@VisibleForTestingके साथ एनोटेट किया गया है. इससे यह पक्का किया जा सकेगा कि इन एपीआई का इस्तेमाल सिर्फ़ टेस्ट में किया जाए. (I7db6e) asSnapshotAPI में अबCoroutineScopeपास करने की ज़रूरत नहीं है. अब यह डिफ़ॉल्ट रूप से, अपने पैरंट स्कोप से मिले कॉन्टेक्स्ट का इस्तेमाल करता है. (Id0a78, b/282240990)TestPagerकंस्ट्रक्टर पैरामीटर को फिर से क्रम में लगाया गया, ताकि वे असलPagerकंस्ट्रक्टर पैरामीटर के क्रम से मैच कर सकें (I6185a)- पेजिंग-टेस्टिंग में लैम्ब्डा टाइप
() -> PagingSource<Key, Value>के इस्तेमाल को टाइपPagingSourceFactory<Key, Value>पर माइग्रेट किया गया. (I4a950, b/280655188)
व्यवहार में बदलाव
asSnapshotपेजिंग टेस्ट चलाने के लिए, अब मुख्य डिस्पैचर की ज़रूरत नहीं है. इसे सेट करने से, टेस्ट के व्यवहार में कोई बदलाव नहीं होता. (Ie56ea)
वर्शन 3.2.0-alpha05
3 मई, 2023
androidx.paging:paging-*:3.2.0-alpha05 रिलीज़ हो गया है. वर्शन 3.2.0-alpha05 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
asSnapshotके पेजिंग टेस्टिंग एपीआई में, अबloadOperationsपैरामीटर की डिफ़ॉल्ट वैल्यू, खाली लैम्ब्डा पर सेट होती है. इससे, शुरुआती रीफ़्रेश लोड से डेटा वापस पाने के लिए, किसी भी लोड ऑपरेशन को पास किए बिनाasSnapshotको कॉल किया जा सकता है. (Ied354, b/277233770)
दस्तावेज़ों में किए गए सुधार
asPagingSourceFactory()के दस्तावेज़ को अपडेट किया गया, ताकि यह साफ़ तौर पर बताया जा सके कि यहFlowपर एक एक्सटेंशन मेथड है. यहPagingSourceइंस्टेंस जनरेट करने के लिए, फिर से इस्तेमाल की जा सकने वाली फ़ैक्ट्री दिखाता है. (I5ff4f, I705b5)LoadResult.Pageकंस्ट्रक्टर के दस्तावेज़ को अपडेट किया गया है, ताकि यह साफ़ तौर पर बताया जा सके कि जंप करने की सुविधा के लिए,itemsBeforeऔरitemsAfterको बदलना ज़रूरी है. (Ied354)
बाहरी योगदान
- पेजिंग को Android/JVM से अलग करने में योगदान देने के लिए, Veyndan को धन्यवाद. (#525, #523, #520, #519, #507, #506, #505, #499, #497, #496, #493)
वर्शन 3.2.0-alpha04
8 फ़रवरी, 2023
androidx.paging:paging-*:3.2.0-alpha04 रिलीज़ हो गया है. वर्शन 3.2.0-alpha04 में ये बदलाव शामिल हैं.
पेजिंग की जांच करना
paging-testingआर्टफ़ैक्ट में अबasPagingSourceFactoryमेथड शामिल है. इससेFlow<List<Value>>सेpagingSourceFactoryबनाया जा सकता है, ताकि उसे Pager को सप्लाई किया जा सके. Flow से उत्सर्जित होने वाला हरList<Value>>, पेज पर मौजूद डेटा की जनरेशन को दिखाता है. इससे पेजिंग टेस्ट करने में मदद मिलती है. उदाहरण के लिए,PagingDataट्रांसफ़ॉर्मेशन के लिए, Pager के इकट्ठा करने के लिए नकली डेटा सोर्स का इस्तेमाल किया जाता है. (I6f230, b/235528239)paging-testingआर्टफ़ैक्ट को नए एपीआई के साथ बड़ा किया गया है. ये एपीआई,Flow<PagingData<T>>में मौजूद डेटा की पुष्टि करने के लिए सही हैं. उदाहरण के लिए, इसका इस्तेमाल आपकी ViewModel लेयर सेFlow<PagingData<T>>के आउटपुट को दिखाने के लिए किया जा सकता है.ऐसा
Flow<PagingData<Value>>परasSnapshotKotlin एक्सटेंशन की मदद से किया जाता है. यहFlow<PagingData<Value>>को सीधेList<Value>में बदल देता है.asSnapshotलैम्ब्डा की मदद से,scrollToयाappendScrollWhileजैसे एपीआई के ज़रिए अपने ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) की नकल की जा सकती है. ऐसा इस तरह से किया जा सकता है कि उसे दोहराया जा सके और वह एक जैसा हो, ताकि आप यह पुष्टि कर सकें कि डेटा का स्नैपशॉट, पेज किए गए डेटा के सेट में किसी भी समय सही है.// Create your ViewModel instance val viewModel = … // Get the Flow of PagingData from the ViewModel val data< Flow<PagingData<String>> = viewModel.data val snapshot: List<String> = data.asSnapshot { // Each operation inside the lambda waits for the data to settle before continuing scrollTo(index = 50) // While you can’t view the items within the asSnapshot call, // you can continuously scroll in a direction while some condition is true // i.e., in this case until you hit a placeholder item appendScrollWhile { item: String -> item != “Header 1” } } // With the asSnapshot complete, you can now verify that the snapshot // has the expected valuesasSnapshotएकsuspendतरीका है, जिसेrunTestमें चलाया जाना चाहिए. ज़्यादा जानकारी के लिए, Android पर Kotlin कोरूटीन की जांच करना लेख पढ़ें. (I55fd2, I5bd26, I7ce34, I51f4d, I2249f, Id6223, Ic4bab, Ib29b9, Ic1238, I96def, b/235528239)
एपीआई में बदलाव
AsyncPagingDataDifferऔरPagingDataAdapterमेंgetItemऔरpeekके लिए यूज़र इंटरफ़ेस (यूआई) कॉल को अब मुख्य थ्रेड पर ही कॉल किए जा सकने वाले के तौर पर मार्क किया गया है. (I699b6)TestPagerके इस्तेमाल किए गए सामान्य टाइप से वाइल्डकार्ड हटा दिए गए हैं. इससे Java प्रोग्रामिंग लैंग्वेज में लिखे गए कोड में, उन तरीकों के नतीजों को इस्तेमाल करना आसान हो गया है. (I56c42)
वर्शन 3.2.0-alpha03
24 अक्टूबर, 2022
androidx.paging:paging-*:3.2.0-alpha03 रिलीज़ हो गया है. वर्शन 3.2.0-alpha03 में ये बदलाव शामिल हैं.
पेजिंग की जांच करना
इस रिलीज़ में एक नया आर्टफ़ैक्ट शामिल है: paging-testing. इस आर्टफ़ैक्ट में ऐसे एपीआई मौजूद हैं जिन्हें आपके ऐप्लिकेशन की हर लेयर की यूनिट टेस्टिंग के लिए डिज़ाइन किया गया है. साथ ही, इसमें Paging के साथ इसके इंटिग्रेशन की टेस्टिंग के लिए भी एपीआई मौजूद हैं.
उदाहरण के लिए, इस पहली रिलीज़ में एक TestPager क्लास शामिल है. इसकी मदद से, अपने कस्टम PagingSource लागू करने के तरीके की पुष्टि की जा सकती है. इसके लिए, आपको Pager और असली यूज़र इंटरफ़ेस (यूआई) की ज़रूरत नहीं होती. आम तौर पर, आपको एंड-टू-एंड पेजिंग इंटिग्रेशन को सिम्युलेट करने के लिए, इनकी ज़रूरत होती है.
TestPager को फ़ेक माना जाना चाहिए - एक टेस्ट डबल जो Pager के असल लागू होने को दिखाता है. साथ ही, PagingSource की जांच करने के लिए, आसान एपीआई सरफ़ेस उपलब्ध कराता है. ये एपीआई suspend एपीआई हैं और इन्हें runTest में चलाया जाना चाहिए. इसके बारे में, Android पर Kotlin कोरूटीन की जांच करना गाइड में बताया गया है.
इन एपीआई के इस्तेमाल का एक उदाहरण room-paging टेस्ट में देखा जा सकता है. इन्हें TestPager का इस्तेमाल करने के लिए फिर से तैयार किया गया था.
एपीआई में बदलाव
LoadResult.Page.iterator()की मदद से,LoadResult.Page.dataपर आसानी से बार-बार काम किया जा सकता है. इससे Kotlin स्टैंडर्ड लाइब्रेरीflattenतरीके का इस्तेमाल किया जा सकता है. ऐसा तब होता है, जबList<LoadResult.Page>दिया गया हो. जैसे,PagingStateकीpagesप्रॉपर्टी के साथ, जिसेPagingSource.getRefreshKeyतरीके को पास किया जाता है. (Ie0718)
वर्शन 3.2.0-alpha02
10 अगस्त, 2022
androidx.paging:paging-*:3.2.0-alpha02 रिलीज़ हो गया है. वर्शन 3.2.0-alpha02 में ये बदलाव शामिल हैं.
नई सुविधाएं
- पेजिंग अब
AsyncPagingDataDifferयाPagingDataAdapterक्लास के ज़रिए लॉग उपलब्ध कराता है, ताकिPagingDataसे इकट्ठा की गई डीबग करने की जानकारी को दिखाया जा सके. - लॉग को
adb shellकमांडadb shell setprop log.tag.Paging [DEBUG|VERBOSE].(b/235527159) की मदद से चालू किया जा सकता है
गड़बड़ियां ठीक की गईं
- रनटाइम
paging-runtime:3.1.1या इससे पुराने वर्शन के साथpaging-common:3.2.0-alpha01का इस्तेमाल करने पर,PagingDataDifferकंस्ट्रक्टर के मौजूद न होने की गड़बड़ी को ठीक किया गया.(b/235256201)
वर्शन 3.2.0-alpha01
1 जून, 2022
androidx.paging:paging-*:3.2.0-alpha01 रिलीज़ हो गया है. वर्शन 3.2.0-alpha01 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
PagingDataAdapterऔरAsyncPagingDataDifferके लिए कंस्ट्रक्टर जोड़े गए हैं, जोCoroutineDispatcherके बजायCoroutineContextको स्वीकार करते हैं. (Idc878)- डिफ़ॉल्ट रूप से,
PagingData.from()औरPagingData.empty()की वजह से, प्रज़ेंटर कोCombinedLoadStatesपर कोई असर नहीं दिखेगा. इन कंस्ट्रक्टर मेंsourceLoadStatesऔरremoteLoadStatesको पास करने की अनुमति देने वाला एक नया ओवरलोड जोड़ा गया है. इससेLoadStatesको पूरी तरह से टर्मिनल के तौर पर सेट करने का मौजूदा तरीका बना रहता है (यानी,NotLoading(endOfPaginationReached = false)) के लिए, रिमोट स्टेट को शामिल करने का विकल्प भी होता है. अगरLoadStatesपास नहीं किए जाते हैं, तो स्टैटिकPagingDataमिलने पर, प्रज़ेंटर की ओर से पिछलाCombinedLoadStatesबनाए रखा जाएगा. (Ic3ce5, b/205344028)
गड़बड़ियां ठीक की गईं
PagingSource.getRefreshKey()के नतीजे को अबinitialKeyके मुकाबले सही तरीके से प्राथमिकता दी जाती है. ऐसा उन मामलों में होता है जहां यह शून्य दिखाता है, लेकिन शून्य के अलावा कोई औरinitialKeyसेट किया गया हो. (Ic9542, b/230391606)
बाहरी योगदान
- test-coroutines-lib माइग्रेशन (I3366d) की वजह से, :compose:ui:ui-test एपीआई (updateApi) को अपडेट किया गया
वर्शन 3.1
वर्शन 3.1.1
9 मार्च, 2022
androidx.paging:paging-*:3.1.1 रिलीज़ हो गया है. वर्शन 3.1.1 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- जनरेशन के बीच के इंटरमीडिएट
LoadState.NotLoadingइवेंट हटा दिए गए हैं. इन्हें.cachedIn()ने गलत तरीके से शामिल किया था. इस बदलाव से,LoadStateमें हुए बदलावों पर प्रतिक्रिया देना आसान हो जाता है. इसके लिए, उन ग़ैर-ज़रूरीLoadState.NotLoadingइवेंट को हटा दिया जाता है जो लोड न हो पाने पर फिर से कोशिश करने, रीफ़्रेश करने या अमान्य होने के दौरान जनरेट हुए थे.
वर्शन 3.1.0
17 नवंबर, 2021
androidx.paging:paging-*:3.1.0 रिलीज़ हो गया है. वर्शन 3.1.0 में ये बदलाव शामिल हैं.
3.0.0 के बाद किए गए अहम बदलाव
Flow<PagingData>.observableऔरFlow<PagingData>.flowableएपीआई अब एक्सपेरिमेंट के तौर पर उपलब्ध नहीं हैंLoadStateमें होने वाले बदलाव:endOfPaginationReachedअबPagingSourceऔरRemoteMediator, दोनों के लिएLoadType.REFRESHकी सदस्यता लेने पर, हमेशाfalseमें उपलब्ध रहेगाLoadStates, पेजिंग से अबPagingSourceऔरRemoteMediator, दोनों से मान्य वैल्यू का इंतज़ार करता है. इसके बाद ही, वह डाउनस्ट्रीम को एमिट करता है.PagingDataकी नई जनरेशन अब रीफ़्रेश होने पर, हमेशाLoadingसे शुरू होंगी. कुछ मामलों में, ये गलत तरीके सेNotLoadingपर रीसेट हो जाती थीं..loadStateFlowऔर.addLoadStateListener, प्रज़ेंटर एपीआई पर अब बार-बार शुरुआतीCombinedLoadStatesनहीं भेजते. इसमें मीडिएटर की स्थितियां हमेशाnullपर सेट होती हैं
- पिछली जनरेशन के लिए, अमान्य होने या नई जनरेशन के लिए, अब रद्द करने की प्रोसेस तुरंत होती है. अब
Flow<PagingData>पर.collectLatestका इस्तेमाल करने की ज़रूरत नहीं है. हालांकि, हमारा सुझाव है कि आप ऐसा करें. PagingSource.LoadResult.InvalidकोPagingSource.loadसे नए रिटर्न टाइप के तौर पर जोड़ा गया है. इस वजह से, पेजिंग इसPagingSourceके लिए, लोड करने के किसी भी अनुरोध को खारिज कर देती है. भले ही, वह अनुरोध पहले से मौजूद हो या आने वाले समय में किया जाए. साथ ही, वह इसे अमान्य कर देती है. इस रिटर्न टाइप को डेटाबेस या नेटवर्क से मिलने वाले अमान्य या पुराने डेटा को मैनेज करने के लिए डिज़ाइन किया गया है..onPagesPresentedऔर.addOnPagesUpdatedListenerप्रज़ेंटर एपीआई जोड़े गए हैं. ये यूज़र इंटरफ़ेस (यूआई) में पेज दिखाए जाने पर, एक साथ ट्रिगर होते हैं. पेज के अपडेट इन स्थितियों में हो सकते हैं:- PagingData की नई जनरेशन का शुरुआती लोड पूरा हो जाता है. भले ही, नई जनरेशन में दिखाए गए आइटम में कोई बदलाव किया गया हो या नहीं. जैसे, अगर नई जनरेशन की सूची में कोई अपडेट नहीं है, तो भी यह कॉलबैक ट्रिगर होगा. ऐसा इसलिए, क्योंकि सूची बिलकुल पहले जैसी है.
- एक पेज शामिल किया जाता है, भले ही उसमें कोई नया आइटम न हो.
- कोई पेज हटाया जाता है, भले ही वह खाली हो.
वर्शन 3.1.0-rc01
3 नवंबर, 2021
androidx.paging:paging-*:3.1.0-rc01 रिलीज़ हो गया है. वर्शन 3.1.0-rc01 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- .cachedIn() में रेस कंडिशन और मेमोरी लीक की समस्या को ठीक किया गया. ऐसा उन मामलों में किया गया जहां Paging डाउनस्ट्रीम ने कई लोड इवेंट भेजे थे, लेकिन कोई ऑब्ज़र्वर नहीं था या जब कोई ऑब्ज़र्वर नए PagingData पर स्विच कर रहा था. (Ib682e)
वर्शन 3.1.0-beta01
13 अक्टूबर, 2021
androidx.paging:paging-*:3.1.0-beta01 रिलीज़ हो गया है. वर्शन 3.1.0-beta01 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- उस समस्या को ठीक किया गया है जिसमें कई आइटम को तेज़ी से ऐक्सेस करने पर, उन्हें prefetchDistance में शामिल नहीं किया जाता था. इस वजह से, पेज लोड होने में रुकावट आती थी. यह समस्या खास तौर पर तब होती है, जब कई आइटम एक साथ इस तरह से लेआउट किए जाते हैं कि वे उपयोगकर्ता के स्क्रोल करने की दिशा के उलट लोड होने लगते हैं. इन आइटम के ऐक्सेस को अब बफ़र किया जाता है और एक साथ प्राथमिकता दी जाती है, ताकि उन्हें हटाया न जाए. (aosp/1833273)
वर्शन 3.1.0-alpha04
29 सितंबर, 2021
androidx.paging:paging-*:3.1.0-alpha04 रिलीज़ हो गया है. वर्शन 3.1.0-alpha04 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
Flow<PagingData>.observableऔरFlow<PagingData>.flowableएपीआई, अब एक्सपेरिमेंट के तौर पर उपलब्ध नहीं हैं. (Ie0bdd)
गड़बड़ियां ठीक की गईं
- LoadStates के लिए,
endOfPaginationReachedअबLoadType.REFRESHके लिए हमेशाfalseहै. पहले, RemoteMediatorREFRESHके लिए endOfPaginationReached कोtrueपर सेट किया जा सकता था, लेकिन PagingSource के लिए नहीं. अब इस व्यवहार को हमेशाfalseदिखाने के लिए कंसोलिडेट किया गया है, क्योंकि REFRESH को टर्मिनल के तौर पर दिखाने का कोई मतलब नहीं है. अब इसे LoadStates में एपीआई कॉन्ट्रैक्ट के हिस्से के तौर पर दस्तावेज़ में शामिल किया गया है. पेजिनेशन को खत्म करने का फ़ैसला लेते समय, आपको हमेशा APPEND या PREPEND निर्देशों के हिसाब से ऐसा करना चाहिए. (I047b6) Paging से LoadStates को अब PagingSource और RemoteMediator, दोनों से मान्य वैल्यू मिलने का इंतज़ार करना होगा. इसके बाद ही, जनरेशन के बीच डाउनस्ट्रीम को एमिट किया जा सकेगा. इससे PagingData की नई जनरेशन, CombinedLoadStates.source.refresh में NotLoading भेजने से बचती हैं. ऐसा तब होता है, जब वह पहले से ही लोड हो रहा हो. PagingData की नई जनरेशन, अब रीफ़्रेश की स्थिति के लिए हमेशा Loading से सही तरीके से शुरू होंगी. कुछ मामलों में, पहले गलत तरीके से NotLoading पर रीसेट नहीं किया जाएगा.
पिछले जनरेशन के रद्द होने की प्रोसेस अब अमान्य होने / नए जनरेशन के आने पर तुरंत होती है. अब
Flow<PagingData>पर .collectLatest का इस्तेमाल करने की ज़रूरत नहीं है. हालांकि, ऐसा करने का सुझाव अब भी दिया जाता है. (I0b2b5, b/177351336, b/195028524).loadStateFlowऔर.addLoadStateListener, प्रज़ेंटर एपीआई पर अब शुरुआतीCombinedLoadStatesको बार-बार नहीं भेजते हैं. इसमें मीडिएटर की स्थितियां हमेशाnullपर और सोर्स की स्थितियांNotLoading(endOfPaginationReached = false)पर सेट होती हैं. इसका मतलब है कि:- अगर RemoteMediator का इस्तेमाल किया जाता है, तो मीडिएटर स्टेट हमेशा पॉप्युलेट होंगे.
.loadStateFlowपर नए loadState listener या नए कलेक्टर को रजिस्टर करने पर, मौजूदा वैल्यू तुरंत नहीं दिखेगी. ऐसा तब होगा, जब उसेPagingDataसे असलCombinedLoadStatesन मिला हो. ऐसा तब हो सकता है, जबPagingDataसबमिट करने से पहले ही, कोई कलेक्टर या लिसनर शुरू हो जाए. (I1a748)
वर्शन 3.1.0-alpha03
21 जुलाई, 2021
androidx.paging:paging-*:3.1.0-alpha03 रिलीज़ हो गया है. वर्शन 3.1.0-alpha03 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
PagingSource में, तीसरे LoadResult रिटर्न टाइप LoadResult.Invalid को जोड़ा गया है. जब PagingSource.load, LoadResult.Invalid दिखाता है, तो पेजिंग लोड किए गए डेटा को खारिज कर देगी और PagingSource को अमान्य कर देगी. इस रिटर्न टाइप को डेटाबेस या नेटवर्क से मिलने वाले अमान्य या पुराने डेटा को मैनेज करने के लिए डिज़ाइन किया गया है.
उदाहरण के लिए, अगर डेटाबेस में डेटा लिखा जाता है, लेकिन PagingSource समय पर अमान्य नहीं होता है, तो हो सकता है कि वह अलग-अलग नतीजे दिखाए.ऐसा तब हो सकता है, जब PagingSource को लागू करने का तरीका, उस डेटासेट के इम्यूटेबल होने पर निर्भर करता हो जिससे वह डेटा लोड करता है. जैसे, LIMIT OFFSET स्टाइल वाले डेटाबेस को लागू करने का तरीका. इस स्थिति में, हमारा सुझाव है कि लोड करने के बाद, अमान्य होने की जांच करें और LoadResult.Invalid को वापस करें. इससे Paging, इस PagingSource के लिए, लोड करने के किसी भी अनुरोध को खारिज कर देता है और उसे अमान्य कर देता है.
यह रिटर्न टाइप, Paging2 API के साथ भी काम करता है. यह एपीआई, LivePagedList या RxPagedList का इस्तेमाल करता है. Paging2 के PagedList एपीआई के साथ PagingSource का इस्तेमाल करने पर, PagedList तुरंत अलग हो जाती है. इससे इस PagedList पर डेटा लोड करने की कोशिशें रुक जाती हैं और PagingSource पर अमान्य होने की प्रोसेस ट्रिगर हो जाती है.
LoadResult एक सील की गई क्लास है. इसका मतलब है कि यह सोर्स के साथ काम न करने वाला बदलाव है. इससे, PagingSource.load के नतीजों का सीधे तौर पर इस्तेमाल करने वाले इस्तेमाल के उदाहरणों को कंपाइल के समय LoadResult.Invalid को मैनेज करना होगा. उदाहरण के लिए, Kotlin का इस्तेमाल करने वाले ऐसे लोग जो रिटर्न टाइप की जांच करने के लिए, exhaustive-when का इस्तेमाल करते हैं उन्हें अमान्य टाइप के लिए एक जांच जोड़नी होगी. (Id6bd3, b/191806126, b/192013267)
गड़बड़ियां ठीक की गईं
- PagingSource.registerInvalidatedCallback या DataSource.addInvalidatedCallback के ज़रिए जोड़े गए अमान्य कॉलबैक, अब अपने-आप ट्रिगर हो जाते हैं. ऐसा तब होता है, जब उन्हें किसी ऐसे PagingSource / DataSource पर रजिस्टर किया गया हो जो पहले से ही अमान्य था. इससे रेस कंडिशन की समस्या हल हो जाती है. इस समस्या की वजह से, पेजिंग अमान्य सिग्नल को छोड़ देती थी और शुरुआती लोड के दौरान पहले से ही अमान्य सोर्स मिलने पर अटक जाती थी. इसके अलावा, अमान्य कॉलबैक ट्रिगर होने के बाद, अब उन्हें सही तरीके से हटा दिया जाता है. ऐसा इसलिए, क्योंकि उन्हें ज़्यादा से ज़्यादा एक बार कॉल करने की गारंटी दी जाती है. (I27e69)
- नए PagedList स्ट्रीम से प्लेसहोल्डर की शुरुआती वैल्यू (InitialPagedList) सबमिट करने पर, पहले से लोड किया गया डेटा नहीं मिटेगा. जैसे, LivePagedListBuilder या RxPagedListBuilder.
वर्शन 3.1.0-alpha02
1 जुलाई, 2021
androidx.paging:paging-*:3.1.0-alpha02 रिलीज़ हो गया है. वर्शन 3.1.0-alpha02 में ये बदलाव शामिल हैं.
नई सुविधाएं
onPagesPresented लिसनर और फ़्लो प्रज़ेंटर एपीआई जोड़े गए हैं. ये यूज़र इंटरफ़ेस (यूआई) में पेजों के अपडेट होने के तुरंत बाद ट्रिगर होते हैं.
ये अपडेट, यूज़र इंटरफ़ेस (यूआई) के साथ सिंक होते हैं. इसलिए, अपडेट लागू होने के बाद, स्टेटस की जांच करने के लिए, .snapshot, .getItemCount जैसे अडैप्टर के तरीकों को कॉल किया जा सकता है. ध्यान दें कि .snapshot() को साफ़ तौर पर कॉल करने के लिए छोड़ दिया गया था, क्योंकि हर अपडेट पर ऐसा करना महंगा हो सकता है.
पेज अपडेट इन स्थितियों में हो सकते हैं:
- PagingData की नई जनरेशन का शुरुआती लोड पूरा हो गया है. इससे कोई फ़र्क़ नहीं पड़ता कि नई जनरेशन में, दिखाए गए आइटम में कोई बदलाव किया गया है या नहीं. जैसे, अगर कोई नई जनरेशन, बिना किसी अपडेट के शुरुआती लोड को पूरा करती है, तो भी यह कॉलबैक ट्रिगर होगा. ऐसा इसलिए, क्योंकि सूची बिलकुल वैसी ही है.
- एक पेज शामिल किया जाता है, भले ही उसमें कोई नया आइटम न हो
- कोई पेज ड्रॉप किया जाता है, भले ही वह खाली हो (I272c9, b/189999634)
गड़बड़ियां ठीक की गईं
- LivePagedList या RxPagedList से जनरेट की गई शुरुआती वैल्यू से PagedList.dataSource को ऐक्सेस करने पर, अब IllegalStateException (I96707) गड़बड़ी नहीं दिखेगी
वर्शन 3.1.0-alpha01
2 जून, 2021
androidx.paging:paging-*:3.1.0-alpha01 रिलीज़ हो गया है. वर्शन 3.1.0-alpha01 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
paging-rxjava3की ओर से उपलब्ध कराई गई क्लास अबandroidx.paging.rxjava3पैकेज में मौजूद हैं, ताकि वेpaging-rxjava2(Ifa7f6) के साथ मेल न खाएं
गड़बड़ियां ठीक की गईं
- उस समस्या को ठीक किया गया है जिसमें पेजिंग की सुविधा, कभी-कभी RecyclerView को नो-ऑप डिफ़र इवेंट भेजती थी. इसकी वजह से, कुछ लिसनर जल्दी ट्रिगर हो सकते थे. (Ic507f, b/182510751)
बाहरी योगदान
- rxjava3 आर्टफ़ैक्ट में, अब काम न करने वाले PagedList के साथ काम करने वाले एपीआई जोड़े गए (Id1ce2, b/182497591)
Paging Compose का वर्शन 1.0.0
वर्शन 1.0.0-alpha20
24 मई, 2023
androidx.paging:paging-compose:1.0.0-alpha20 रिलीज़ हो गया है. वर्शन 1.0.0-alpha20 में ये बदलाव शामिल हैं.
नई सुविधाएं
- Paging Compose में अब नकली डेटा की सूची की झलक देखने की सुविधा उपलब्ध है.इसके लिए,
PagingData.from(fakeData)बनाएं और उसPagingDataकोMutableStateFlowमें रैप करें. उदाहरण के लिए,MutableStateFlow(PagingData.from(listOf(1, 2, 3))). उस डेटा को अपने@Previewमें इनपुट के तौर पर इस्तेमाल करने से,collectAsLazyPagingItems()को किए जाने वाले कॉल से, झलक देखने लायकLazyPagingItemsमिलेगा. (I8a78d, b/194544557)
गड़बड़ियां ठीक की गईं
LazyPagingItemsमें इकट्ठा किया गयाpager.flow.cachedInका कैश मेमोरी में सेव डेटा, अब स्टेट रीस्टोरेशन के बाद तुरंत उपलब्ध हो जाएगा. इसके लिए, एसिंक्रोनस कलेक्शन की ज़रूरत नहीं होगी. इसका मतलब है कि स्टेट को पहले जैसा करने के बाद, शुरुआती कंपोज़िशन के तुरंत बाद कैश मेमोरी में सेव किया गया डेटा प्रज़ेंटेशन के लिए तैयार हो जाएगा. (I97a60, b/177245496)
वर्शन 1.0.0-alpha19
3 मई, 2023
androidx.paging:paging-compose:1.0.0-alpha19 रिलीज़ हो गया है. वर्शन 1.0.0-alpha19 में ये बदलाव शामिल हैं.
सभी लेज़ी लेआउट के साथ काम करना
पहले, Paging Compose में LazyListScope पर कस्टम items और itemsIndexed एक्सटेंशन उपलब्ध थे. इसका मतलब है कि Paging Compose का इस्तेमाल, LazyVerticalGrid, HorizontalPager जैसे अन्य लेज़ी लेआउट या Wear और TV लाइब्रेरी से मिले अन्य कस्टम लेज़ी कॉम्पोनेंट के साथ नहीं किया जा सकता था. इस रिलीज़ का मुख्य अपडेट, इस समस्या को हल करना है.
ज़्यादा लेज़ी लेआउट के साथ काम करने के लिए, हमें एक अलग लेयर पर एपीआई बनाने की ज़रूरत थी. हर लेज़ी लेआउट के लिए कस्टम items एपीआई उपलब्ध कराने के बजाय, Paging Compose अब itemKey और itemContentType में LazyPagingItems पर थोड़े कम लेवल के एक्सटेंशन तरीके उपलब्ध कराता है. इन एपीआई का मकसद, key और contentType पैरामीटर को स्टैंडर्ड items एपीआई में लागू करने में आपकी मदद करना है. ये एपीआई, LazyColumn, LazyVerticalGrid के लिए पहले से मौजूद हैं. साथ ही, HorizontalPager जैसे एपीआई में भी ये पैरामीटर मौजूद हैं. (Ifa13b, Ib04f0, b/259385813)
इसका मतलब है कि LazyVerticalGrid को सपोर्ट करने पर, आपको ये फ़ायदे मिलेंगे:
// This part is unchanged
val lazyPagingItems = pager.collectAsLazyPagingItems()
LazyVerticalGrid(columns = GridCells.Fixed(2)) {
// Here we use the standard items API
items(
count = lazyPagingItems.itemCount,
// Here we use the new itemKey extension on LazyPagingItems to
// handle placeholders automatically, ensuring you only need to provide
// keys for real items
key = lazyPagingItems.itemKey { it.uniqueId },
// Similarly, itemContentType lets you set a custom content type for each item
contentType = lazyPagingItems.itemContentType { "contentType" }
) { index ->
// As the standard items call provides only the index, we get the item
// directly from our lazyPagingItems
val item = lazyPagingItems[index]
PagingItem(item = item)
}
}
इन नए एपीआई को इस्तेमाल करने के ज़्यादा उदाहरणों के लिए, कृपया हमारे सैंपल देखें.
इन बदलावों की वजह से, LazyColumn और LazyRow के उदाहरण कुछ लाइन लंबे हो जाते हैं. हालांकि, हमें लगा कि सभी लेज़ी लेआउट में एक जैसा होना, आने वाले समय में Paging Compose का इस्तेमाल करने वालों के लिए एक अहम फ़ैक्टर है. इस वजह से, LazyListScope के मौजूदा एक्सटेंशन अब बंद कर दिए गए हैं. (I0c459, I92c8f, b/276989796)
एपीआई में बदलाव
- नए एपीआई पर माइग्रेट करने की प्रोसेस को आसान बनाने के लिए,
LazyListScopeपरitemsऔरitemsIndexedएक्सटेंशन फ़ंक्शन अबcontentTypeपैरामीटर के साथ काम करते हैं. इससे नए एपीआई में भी सहायता मिलती है. (Ib1918, b/255283378)
डिपेंडेंसी अपडेट
- Paging Compose ने अपनी डिपेंडेंसी को Compose 1.0.5 से Compose 1.2.1 पर अपडेट कर दिया है. (Ib1918, b/255283378)
वर्शन 1.0.0-alpha18
8 फ़रवरी, 2023
androidx.paging:paging-compose:1.0.0-alpha18 को बिना किसी बदलाव के रिलीज़ किया गया है. वर्शन 1.0.0-alpha18 में ये बदलाव शामिल हैं.
वर्शन 1.0.0-alpha17
24 अक्टूबर, 2022
androidx.paging:paging-compose:1.0.0-alpha17 रिलीज़ हो गया है. वर्शन 1.0.0-alpha17 में ये बदलाव शामिल हैं.
नई सुविधाएं
collectLazyPagingItemsको कॉल करते समय, कस्टमCoroutineContextके लिए सहायता जोड़ें. (I7a574, b/243182795, b/233783862)
वर्शन 1.0.0-alpha16
10 अगस्त, 2022
androidx.paging:paging-compose:1.0.0-alpha16 रिलीज़ हो गया है. वर्शन 1.0.0-alpha16 में ये बदलाव शामिल हैं.
नई सुविधाएं
- Paging अब
LazyPagingItemsक्लास के ज़रिए लॉग उपलब्ध कराता है, ताकि PagingData से इकट्ठा की गई डीबग करने की जानकारी को दिखाया जा सके. - लॉग को
adb shellकमांडadb shell setprop log.tag.Paging [DEBUG|VERBOSE]की मदद से चालू किया जा सकता है. ([b/235527159}(https://issuetracker.google.com/issues/235527159))
गड़बड़ियां ठीक की गईं
paging-compose:1.0.0-alpha15कोpaging-common:3.1.1या इससे पुराने वर्शन के साथ इस्तेमाल करने पर,PagingDataDifferकंस्ट्रक्टर के मौजूद न होने की गड़बड़ी को ठीक किया गया.(b/235256201,b/239868768)
वर्शन 1.0.0-alpha15
1 जून, 2022
androidx.paging:paging-compose:1.0.0-alpha15 रिलीज़ हो गया है. वर्शन 1.0.0-alpha15 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
PagingDataAdapterऔरAsyncPagingDataDifferके लिए कंस्ट्रक्टर जोड़े गए हैं, जोCoroutineDispatcherके बजायCoroutineContextको स्वीकार करते हैं. (Idc878)
गड़बड़ियां ठीक की गईं
LazyPagingItemsअब शुरुआतीloadStateको सेट करता है, ताकिLoadState.Loadingरीफ़्रेश हो सके. (I55043, b/224855902)
वर्शन 1.0.0-alpha14
13 अक्टूबर, 2021
androidx.paging:paging-compose:1.0.0-alpha14 रिलीज़ हो गया है. वर्शन 1.0.0-alpha14 में ये बदलाव शामिल हैं.
वर्शन 1.0.0-alpha13
29 सितंबर, 2021
androidx.paging:paging-compose:1.0.0-alpha13 रिलीज़ हो गया है. वर्शन 1.0.0-alpha13 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
LazyPagingItems.snapshot()फ़ंक्शन कोLazyPagingItems.itemSnapshotListप्रॉपर्टी (Ie2da8) से बदल दिया गया हैLazyPagingItems.getAsState()को हटा दिया गया है, क्योंकि अब इसका इस्तेमाल नहीं किया जाता (Ie65e4)
वर्शन 1.0.0-alpha12
21 जुलाई, 2021
androidx.paging:paging-compose:1.0.0-alpha12 रिलीज़ हो गया है. वर्शन 1.0.0-alpha12 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
items(lazyPagingItems)औरitemsIndexed(lazyPagingItems)का इस्तेमाल, पेजिंग कोLazyColumn/Rowसे कनेक्ट करने के लिए किया जाता है. अब ये विकल्प कुंजी पैरामीटर को स्वीकार करते हैं. इससे आपको आइटम को दिखाने वाली स्टेबल कुंजी तय करने की सुविधा मिलती है. कुंजियों के बारे में ज़्यादा जानने के लिए यहां जाएं. (I7986d)- फ़ंक्शन
lazyPagingItems.getAsState(index)अब काम नहीं करता. इसके बजाय,lazyPagingItems[index]का इस्तेमाल करें. (I086cb, b/187339372)
वर्शन 1.0.0-alpha11
30 जून, 2021
androidx.paging:paging-compose:1.0.0-alpha11 रिलीज़ हो गया है. वर्शन 1.0.0-alpha11 में ये बदलाव शामिल हैं.
वर्शन 1.0.0-alpha10
2 जून, 2021
androidx.paging:paging-compose:1.0.0-alpha10 रिलीज़ हो गया है. वर्शन 1.0.0-alpha10 में ये बदलाव शामिल हैं.
वर्शन 1.0.0-alpha09
18 मई, 2021
androidx.paging:paging-compose:1.0.0-alpha09 रिलीज़ हो गया है. वर्शन 1.0.0-alpha09 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- LazyPagingItems के itemCount और आइटम गेटर को अब मॉनिटर किया जा सकता है. इससे, इसे LazyVerticalGrid के साथ भी इस्तेमाल किया जा सकता है (Ie2446, b/171872064, b/168285687)
Compose के साथ काम करने की सुविधा
androidx.paging:paging-compose:1.0.0-alpha09, Compose के वर्शन1.0.0-beta07और इसके बाद के वर्शन के साथ ही काम करता है.
वर्शन 1.0.0-alpha08
24 फ़रवरी, 2021
androidx.paging:paging-compose:1.0.0-alpha08 रिलीज़ हो गया है. वर्शन 1.0.0-alpha08 में ये बदलाव शामिल हैं.
Compose 1.0.0-beta01 के साथ इंटिग्रेट करने के लिए अपडेट किया गया.
वर्शन 1.0.0-alpha07
10 फ़रवरी, 2021
androidx.paging:paging-compose:1.0.0-alpha07 रिलीज़ हो गया है. वर्शन 1.0.0-alpha07 में ये बदलाव शामिल हैं.
Compose alpha12 के साथ इंटिग्रेट करने के लिए अपडेट किया गया.
वर्शन 1.0.0-alpha06
28 जनवरी, 2021
androidx.paging:paging-compose:1.0.0-alpha06 रिलीज़ हो गया है. वर्शन 1.0.0-alpha06 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
Compose 1.0.0-alpha11 पर निर्भर रहने के लिए अपडेट किया गया.
वर्शन 1.0.0-alpha05
13 जनवरी, 2021
androidx.paging:paging-compose:1.0.0-alpha05 रिलीज़ हो गया है. वर्शन 1.0.0-alpha05 में ये बदलाव शामिल हैं.
Compose 1.0.0-alpha10 पर निर्भर रहने के लिए अपडेट किया गया.
वर्शन 1.0.0-alpha04
16 दिसंबर, 2020
androidx.paging:paging-compose:1.0.0-alpha04 रिलीज़ हो गया है. वर्शन 1.0.0-alpha04 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- सुविधाजनक प्रॉपर्टी,
CombinedLoadStates.refresh,CombinedLoadStates.prepend, औरCombinedLoadStates.appendको अपडेट किया गया, ताकि मीडिएटर और सोर्स लोड की स्थितियांNotLoadingहोने के बाद ही,LoadingसेNotLoadingपर ट्रांज़िशन हो. इससे यह पक्का किया जा सकेगा कि रिमोट अपडेट लागू हो गया है. (I65619)
वर्शन 1.0.0-alpha03
2 दिसंबर, 2020
androidx.paging:paging-compose:1.0.0-alpha03 रिलीज़ हो गया है. वर्शन 1.0.0-alpha03 में ये बदलाव शामिल हैं.
- Compose 1.0.0-alpha08 के हिसाब से अपडेट किया गया.
वर्शन 1.0.0-alpha02
11 नवंबर, 2020
androidx.paging:paging-compose:1.0.0-alpha02 रिलीज़ हो गया है. वर्शन 1.0.0-alpha02 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
LazyPagingItemमें.peek(),.snapshot(),.retry(), और.refresh()तरीके जोड़े गए हैं. ये तरीके,AsyncPagingDataDiffer/PagingDataAdapterमें उपलब्ध फ़ंक्शन को दिखाते हैं (Iddfe8, b/172041660)
वर्शन 1.0.0-alpha01
28 अक्टूबर, 2020
androidx.paging:paging-compose:1.0.0-alpha01 रिलीज़ हो गया है. वर्शन 1.0.0-alpha01 में ये बदलाव शामिल हैं.
नई सुविधाएं
paging-compose आर्टफ़ैक्ट, पेजिंग लाइब्रेरी और Jetpack Compose के बीच इंटिग्रेशन की सुविधा देता है. इस्तेमाल का एक आसान उदाहरण:
@Composable
@OptIn(ExperimentalLazyDsl::class)
fun ItemsDemo(flow: Flow<PagingData<String>>) {
val lazyPagingItems = flow.collectAsLazyPagingItems()
LazyColumn {
items(lazyPagingItems) {
Text("Item is $it")
}
}
}
वर्शन 3.0.1
वर्शन 3.0.1
21 जुलाई, 2021
androidx.paging:paging-*:3.0.1 रिलीज़ हो गया है. वर्शन 3.0.1 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
LivePagedListयाRxPagedListसे जनरेट की गई शुरुआती वैल्यू सेPagedList.dataSourceको ऐक्सेस करने पर, अब IllegalStateException (I96707) गड़बड़ी नहीं दिखेगी
वर्शन 3.0.0
वर्शन 3.0.0
5 मई, 2021
androidx.paging:paging-*:3.0.0 रिलीज़ हो गया है. वर्शन 3.0.0 में ये बदलाव शामिल हैं.
3.0.0 की मुख्य सुविधाएं
Paging 2.x.x के ज़्यादातर मौजूदा एपीआई को बंद कर दिया गया है. इनकी जगह, Paging 3 के नए एपीआई इस्तेमाल किए जा रहे हैं. इनसे ये सुधार किए जा सकते हैं:
- Kotlin कोरूटीन और Flow के लिए बेहतरीन सहायता
- सदस्यता रद्द करने में मदद
- लोड होने की स्थिति और गड़बड़ी के सिग्नल पहले से मौजूद होते हैं
- फिर से कोशिश करने और रीफ़्रेश करने की सुविधा
- DataSource की तीनों सबक्लास को एक यूनिफ़ाइड PagingSource क्लास में जोड़ दिया गया है
- कस्टम पेज ट्रांसफ़ॉर्मेशन, जिसमें सेपरेटर जोड़ने के लिए पहले से मौजूद ट्रांसफ़ॉर्मेशन शामिल है
- लोड होने की स्थिति के हेडर और फ़ुटर
वर्शन 3.0.0-rc01
21 अप्रैल, 2021
androidx.paging:paging-*:3.0.0-rc01 रिलीज़ हो गया है. वर्शन 3.0.0-rc01 में ये कमिट शामिल हैं.
गड़बड़ियां ठीक की गईं
- उस समस्या को ठीक किया गया है जिसमें पेजिंग की सुविधा, कभी-कभी RecyclerView को नो-ऑप डिफ़र इवेंट भेजती थी. इसकी वजह से, कुछ लिसनर जल्दी ट्रिगर हो सकते थे. (Ic507f, b/182510751)
वर्शन 3.0.0-beta03
24 मार्च, 2021
androidx.paging:paging-*:3.0.0-beta03 रिलीज़ हो गया है. वर्शन 3.0.0-beta03 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- हमने सूची को फिर से लोड करने पर प्लेसहोल्डर को मैनेज करने के तरीके में बदलाव किया है. इससे RecyclerView में अचानक होने वाले जंप को रोका जा सकेगा. ज़्यादा जानकारी के लिए, NullPaddedDiffing.md देखें. (If1490, b/170027529, b/177338149)
- अलग-अलग PagedList बिल्डर (पुराने कंपैटबिलिटी पाथ) अब
.build()को कॉल किए जाने पर, मेन थ्रेड परDataSource.Factory.create()को गलत तरीके से सिंक्रोनस रूप से कॉल नहीं करते. (b/182798948)
वर्शन 3.0.0-beta02
10 मार्च, 2021
androidx.paging:paging-*:3.0.0-beta02 रिलीज़ हो गया है. वर्शन 3.0.0-beta02 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
- Rx3 एक्सटेंशन अब
@ExperimentalCoroutinesApiशामिल होने की ज़रूरी शर्त को सही तरीके से लागू करते हैं. पहले, इन्हें@getतरीके पर मार्क किया गया था. Kotlin कंपाइलर इसे अनदेखा कर देता है. इसकी वजह यह है: https://youtrack.jetbrains.com/issue/KT-45227 (I5733c)
गड़बड़ियां ठीक की गईं
- एक्सपेरिमेंटल एपीआई के सार्वजनिक इस्तेमाल पर पाबंदियां लागू करें (I6aa29, b/174531520)
- उस गड़बड़ी को ठीक कर दिया गया है जिसकी वजह से रिमोट रीफ़्रेश को कॉल करने पर,
PagingStateहमेशाnullरहता था. - उस गड़बड़ी को ठीक किया गया है जिसमें PagingSource से मिले खाली पेजों की वजह से, Paging को
prefetchDistanceको पूरा करने के लिए फिर से फ़ेच करने से रोका जा सकता था. इससे Paging "अटक" जाता था.
वर्शन 3.0.0-beta01
10 फ़रवरी, 2021
androidx.paging:paging-*:3.0.0-beta01 रिलीज़ हो गया है. वर्शन 3.0.0-beta01 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
- Rx2 और Rx3 रैपर अब उस एक्सपेरिमेंटल एनोटेशन को एक्सपोज़ करते हैं जिस पर वे निर्भर हैं. अगर paging-rxjava2 या paging-rxjava3 में Rx के साथ काम करने वाले रैपर का इस्तेमाल किया जा रहा है, तो अब आपको
@OptIn(ExperimentalCoroutinesApi::class)(Ib1f9d) के साथ इस्तेमाल किए जाने वाले एनोटेशन की ज़रूरत होगी
गड़बड़ियां ठीक की गईं
- कंपैटिबिलिटी पाथ के ज़रिए v2
DataSourceएपीआई का इस्तेमाल करने पर, कभी-कभी दिखने वालीIndexOutOfBoundsException: Inconsistency detectedगड़बड़ी को ठीक किया गया - कंपैटिबिलिटी पाथ के ज़रिए इस्तेमाल किए जाने पर,
DataSourceको शुरू करने के दौरानisInvalidकॉल को अब मुख्य थ्रेड के बजाय, fetchDispatcher पर सही तरीके से लॉन्च किया जाता है. इससे Room केPagingSourceको लागू करते समय, मुख्य थ्रेड पर डेटाबेस ऐक्सेस की वजह से होने वालीIllegalStateExceptionकी समस्या ठीक हो जाती है.
वर्शन 3.0.0-alpha13
27 जनवरी, 2021
androidx.paging:paging-*:3.0.0-alpha13 रिलीज़ हो गया है. वर्शन 3.0.0-alpha13 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
PagingSource.getRefreshKeyको लागू करना अब ज़रूरी है. यह अब एक ऐब्स्ट्रैक्ट फ़ंक्शन है, जिसे डिफ़ॉल्ट रूप से लागू नहीं किया जाता. माइग्रेट करने वाले उपयोगकर्ता, डिफ़ॉल्ट तौर पर लागू होने वाले तरीके को वापस करना जारी रख सकते हैं. यह तरीका सिर्फ़nullदिखाता है, लेकिनgetRefreshKey()को उपयोगकर्ता की मौजूदा स्क्रोल पोज़िशन के आधार पर कुंजी दिखाने वाला असल तरीका लागू करना चाहिए. इससे पेजिंग, व्यूपोर्ट के आस-पास लोड होती रहती है. इसके लिए, अगर संभव हो, तोPagingState.anchorPositionका इस्तेमाल करें. (I4339a)InvalidatingPagingSourceFactoryअब एक फ़ाइनल क्लास है (Ia3b0a)- SeparatorType पैरामीटर की मदद से, टर्मिनल सेपरेटर (हेडर / फ़ुटर) के व्यवहार को कॉन्फ़िगर करने की अनुमति दें. यह पैरामीटर ज़रूरी नहीं है. इसके दो विकल्प हैं:
FULLY_COMPLETE- मौजूदा व्यवहार; टर्मिनल सेपरेटर जोड़ने से पहले, PagingSource और RemoteMediator, दोनों के endOfPaginationReached को मार्क करने का इंतज़ार करें. अगर RemoteMediator का इस्तेमाल नहीं किया जाता है, तो रिमोट loadState को अनदेखा कर दिया जाता है. यह मुख्य रूप से तब काम आता है, जब आपको सेक्शन सेपरेटर सिर्फ़ तब दिखाने हों, जब सेक्शन पूरी तरह से लोड हो जाए. इसमें रिमोट सोर्स, जैसे कि नेटवर्क से फ़ेच करना भी शामिल है.SOURCE_COMPLETE- PagingSource के endOfPaginationReached को मार्क करने का इंतज़ार करें. भले ही, RemoteMediator का इस्तेमाल किया गया हो. इससे हेडर और फ़ुटर, पेज के शुरुआती लोड के साथ ही दिखते हैं. इससे उपयोगकर्ताओं को टर्मिनल सेपरेटर देखने के लिए स्क्रोल नहीं करना पड़ता. (Ibe993, b/174700218)
गड़बड़ियां ठीक की गईं
- मेमोरी लीक की एक समस्या को ठीक किया गया है. यह समस्या तब होती है, जब PageFetcher, PagingSource से डेटा लोड करना शुरू करने से पहले ही उसे अमान्य कर देता है. हालांकि, ऐसा बहुत कम होता है. (I9606b, b/174625633)
वर्शन 3.0.0-alpha12
13 जनवरी, 2021
androidx.paging:paging-*:3.0.0-alpha12 रिलीज़ हो गया है. वर्शन 3.0.0-alpha12 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
- InvalidatingPagingSourceFactory अब ऐब्स्ट्रैक्ट क्लास नहीं है, क्योंकि इसमें कभी भी कोई ऐब्स्ट्रैक्ट तरीका नहीं था. (I4a8c4)
- .cachedIn() का एक ओवरलोड जोड़ा गया है, जो Java उपयोगकर्ताओं के लिए लाइफ़साइकल या CoroutineScope के बजाय ViewModel को स्वीकार करता है. (I97d81, b/175332619)
- Java कॉलर को PagingData ट्रांसफ़ॉर्मेशन ऑपरेशन को एसिंक्रोनस तरीके से इस्तेमाल करने की अनुमति दें. इसके लिए, ट्रांसफ़ॉर्म ऑपरेटर आर्ग्युमेंट में Executor को स्वीकार करें. सभी -Sync ट्रांसफ़ॉर्म ऑपरेटर से -Sync सफ़िक्स को हटा दिया गया है. Kotlin Coroutine का इस्तेमाल करने वाले लोगों को, एक्सटेंशन फ़ंक्शन को कॉल करके साफ़ तौर पर बताना होगा कि उन्हें कौनसा ऑपरेटर इस्तेमाल करना है. यह फ़ंक्शन, सस्पेंडिंग ब्लॉक को स्वीकार करता है.
PagingData को ट्रांसफ़ॉर्म करने वाले सभी ऑपरेटर, स्टैटिक PagingDataTransforms क्लास के तहत एक्सटेंशन में ले जाए गए हैं. Java का इस्तेमाल करने वाले लोगों को उन्हें स्टैटिक हेल्पर के ज़रिए कॉल करना होगा.उदाहरण के लिए,
PagingDataTransforms.map(pagingData, transform)Kotlin का इस्तेमाल करने वाले लोगों के लिए, सिंटैक्स एक जैसा होता है. हालांकि, आपको फ़ंक्शन को इंपोर्ट करना होगा. (If6885, b/172895919)
गड़बड़ियां ठीक की गईं
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, पेज नंबरिंग के आखिर तक पहुंचने पर,
adapter.refresh()के दौरानRemoteMediator.load()को कॉल नहीं किया जाता था.
वर्शन 3.0.0-alpha11
16 दिसंबर, 2020
androidx.paging:paging-*:3.0.0-alpha11 रिलीज़ हो गया है. वर्शन 3.0.0-alpha11 में ये बदलाव शामिल हैं.
नई सुविधाएं
- इस्तेमाल के इन बुनियादी मामलों के लिए, सेव की गई स्थिति की सुविधा जोड़ी गई है. हालांकि, लेयर्ड सोर्स के मामले में, पूरी तरह से सहायता देने की सुविधा पर अब भी काम चल रहा है:
- फ़्लो को कैश मेमोरी में सेव किया गया है और ऐप्लिकेशन को बंद नहीं किया गया है. उदाहरण के लिए, फ़्लो को व्यू मॉडल में कैश मेमोरी में सेव किया गया है और प्रोसेस में गतिविधि को फिर से बनाया गया है
- पेजिंग सोर्स की गिनती की जाती है, प्लेसहोल्डर चालू होते हैं, और लेआउट स्टैगर्ड नहीं होता है.
एपीआई में बदलाव
PagingSource.getRefreshKey()अब स्टेबल एपीआई है (I22f6f, b/173530980)PagingSource.invalidateअब एक ओपन फ़ंक्शन नहीं है. अगर आपको अमान्य होने पर सूचना चाहिए, तो invalidate को ओवरराइड करने के बजाय, registerInvalidatedCallback तरीके को कॉल करें. (I628d9, b/173029013, b/137971356)- Pager में अब अपने सामान्य कंस्ट्रक्टर के साथ-साथ, एक्सपेरिमेंट के तौर पर उपलब्ध एक कंस्ट्रक्टर भी है. इसमें, शामिल होने वाले एनोटेशन के ज़रिए, एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई को एक्सपेरिमेंट के तौर पर उपलब्ध न होने वाले सार्वजनिक एपीआई में लीक नहीं किया जाता. (I9dc61, b/174531520)
- सुविधाजनक प्रॉपर्टी,
CombinedLoadStates.refresh,CombinedLoadStates.prepend,CombinedLoadStates.appendको अपडेट किया गया, ताकि मीडिएटर और सोर्स लोड की स्थितियांNotLoadingहोने के बाद ही,LoadingसेNotLoadingपर ट्रांज़िशन हो. इससे यह पक्का किया जा सकेगा कि रिमोट अपडेट लागू हो गया है. (I65619) LoadParams.pageSize को हटा दिया गया है. इसे पहले ही बंद कर दिया गया था. हमारा सुझाव है कि आप अपने PagingSource में
LoadParams.loadSizeका इस्तेमाल करें.LoadParams.loadSizeहमेशाPagingConfig.pageSizeके बराबर होता है. हालांकि, शुरुआती लोड कॉल के लिए यहPagingConfig.initialLoadSizeके बराबर होता है.अगर Pager या PagedList का इस्तेमाल किए बिना Paging2 DataSource की जांच की जा रही है, तो हो सकता है कि
pageSize,PagingConfig.pageSizeसे मैच न करे. ऐसा तब हो सकता है, जबinitialLoadSizeभी सेट किया जा रहा हो. अगर यह आपके टेस्ट के लिए ज़रूरी है, तो Pager/PagedList का इस्तेमाल करके देखें. इससे आपके DataSource लोड करने के तरीकों के लिए, PageSize की सही वैल्यू अपने-आप सेट हो जाएगी. (I98ac7, b/149157296)
गड़बड़ियां ठीक की गईं
- PagingConfig.maxSize सेट होने पर, सेपरेटर का इस्तेमाल करने पर IllegalStateException की वजह से होने वाले क्रैश को ठीक किया गया. (I0ed33, b/174787528)
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, RemoteMediator के सेट होने पर, शुरुआती लोड के तुरंत बाद PREPEND / APPEND के लिए लोड की स्थिति
NotLoading(endOfPaginationReached = true)पर अपडेट नहीं होती थी (I8cf5a) - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, ListUpdateCallback अपडेट में .snapshot(), .peek() वगैरह जैसे प्रज़ेंटर-साइड एपीआई, पिछली (पुरानी) सूची दिखाते थे.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, RemoteMediator के साथ इस्तेमाल किए जाने पर सेपरेटर ऑपरेटर, हेडर या फ़ुटर नहीं जोड़ते थे
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, RemoteMediator के लिए LoadState के NotLoading में अपडेट होने पर, वह Loading स्टेटस में अटक जाता था
- एक गड़बड़ी को ठीक किया गया है. इसकी वजह से, Paging2.0 के साथ काम करने वाला एपीआई,
.asPagingSourceFactory(), गलत CoroutineDispatcher पर बैकिंगDataSourceको शुरू कर सकता था. इससे क्रैश और एएनआर की संभावित समस्याओं को ठीक किया जा सकता है. खास तौर पर, Room के PagingSource के मौजूदा वर्शन का इस्तेमाल करते समय, जो इस कंपैटिबिलिटी पाथ का इस्तेमाल करता है.
वर्शन 3.0.0-alpha10
2 दिसंबर, 2020
androidx.paging:paging-*:3.0.0-alpha10 रिलीज़ हो गया है. वर्शन 3.0.0-alpha10 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
अब काम न करने वाले
dataRefreshFlowऔरdataRefreshListenerएपीआई हटा दिए गए हैं, क्योंकि loadStateFlow / Listener अपडेट के साथ इनकी ज़रूरत नहीं है. माइग्रेट करने वाले लोगों के लिए, loadStateFlow के बराबर यह है:loadStateFlow.distinctUntilChangedBy { it.refresh } .filter { it.refresh is NotLoading }
गड़बड़ियां ठीक की गईं
- RemoteMediator
REFRESHके लिए endOfPaginationReached अब LoadState अपडेट में सही तरीके से लागू होता है. साथ ही, रिमोटAPPENDऔरPREPENDको ट्रिगर होने से रोकता है. (I94a3f, b/155290248) - शुरुआती पेज खाली होने या ज़्यादा फ़िल्टर करने की वजह से खाली सूची दिखने पर, अब पेजिंग को
PREPENDयाAPPENDलोड होने से नहीं रोका जाएगा. (I3e702, b/168169730) - उस समस्या को ठीक किया गया है जिसकी वजह से, अमान्य होने की प्रोसेस तेज़ी से होने पर, PagingSource की अगली जनरेशन पर
getRefreshKeyको कॉल नहीं किया जाता था. (I45460, b/170027530)
बाहरी योगदान
- एक नई ऐब्स्ट्रैक्ट क्लास InvalidatingPagingSourceFactory जोड़ी गई है. इसमें एक
.invalidate()एपीआई है, जो इससे जनरेट होने वाले सभी PagingSource को अमान्य कर देता है. @claraf3 को धन्यवाद! (Ie71fc, b/160716447)
पहले से मालूम समस्याएं
- RemoteMediator b/172254056 का इस्तेमाल करने पर, हो सकता है कि .insertSeparators() ट्रांसफ़ॉर्म के हेडर और फ़ुटर तुरंत न दिखें
- RemoteMediator का इस्तेमाल करने पर, रिमोट
LoadStateअटक सकता है. ऐसा तब होता है, जबRemoteMediator.load()के नतीजे मिलने से पहले ही, अमान्य करने की प्रोसेस औरPagingSource.load(LoadParams.Refresh(...))पूरा हो जाता है b/173717820
वर्शन 3.0.0-alpha09
11 नवंबर, 2020
androidx.paging:paging-*:3.0.0-alpha09 रिलीज़ हो गया है. वर्शन 3.0.0-alpha09 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
- dataRefreshFlow / Listener के तरीकों को पूरी तरह से बंद करें और उनकी जगह replaceWith क्लॉज़ का इस्तेमाल करें. (I6e2dd)
गड़बड़ियां ठीक की गईं
- RemoteMediator के साथ सेपरेटर का इस्तेमाल करते समय,
IllegalArgumentExceptionके थ्रो होने की समस्या को ठीक किया गया. साथ ही, अमान्य होने की प्रोसेस तब ट्रिगर होती है, जब endOfPagination को वापस करने वाला रिमोट लोड अब भी चल रहा हो (I3a260)
वर्शन 3.0.0-alpha08
28 अक्टूबर, 2020
androidx.paging:paging-*:3.0.0-alpha08 रिलीज़ हो गया है. वर्शन 3.0.0-alpha08 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
DataSource.InvalidatedCallbackके Kotlin / Java वैरिएंट को Kotlin में एसएएम-कन्वर्ज़न चालू करके, फ़ंक्शनल इंटरफ़ेस के ज़रिए जोड़ा गया है. यह Kotlin 1.4 में उपलब्ध है. इससे उस गड़बड़ी को भी ठीक किया गया है जिसमें.mapया.mapByPageसे ट्रांसफ़ॉर्म किए जाने के बाद, अमान्य कॉलबैक के Kotlin वैरिएंट को कॉल नहीं किया जाता था. (I1f244, b/165313046)
गड़बड़ियां ठीक की गईं
- ViewPager के साथ Paging के इंटरैक्शन को काफ़ी बेहतर बनाया गया है. खास तौर पर, पेज अमान्य होने की वजह से, Paging अब
RemoteMediator#loadकॉल को रद्द नहीं करेगा. साथ ही, यह तब तक डेटा को अपेंड/प्रीपेंड करने का अनुरोध नहीं करेगा, जब तक रीफ़्रेश करने का अनुरोध पूरा नहीं हो जाता. हालांकि, ऐसा तब होगा, जब रीफ़्रेश करना ज़रूरी हो. (I6390b, b/162252536) - MissingGetterMatchingBuilder के लिए एपीआई लिंट की जांच, androidx के लिए चालू है (I4bbea, b/138602561)
- एक गड़बड़ी को ठीक किया गया है. इसकी वजह से, बैकग्राउंड थ्रेड से RecyclerView को सूचना देने पर,
.withLoadState*ConcatAdapterहेल्पर क्रैश हो जाते थे (I18bb5, b/170988309) - एक गड़बड़ी को ठीक किया गया है. इसकी वजह से, खाली न होने वाले बहुत छोटे पेज को लोड करने पर, कभी-कभी प्रीफ़ेच की सुविधा सही तरीके से लोड नहीं हो पाती थी.Iffda3 b/169259468
वर्शन 3.0.0-alpha07
1 अक्टूबर, 2020
androidx.paging:paging-*:3.0.0-alpha07 रिलीज़ हो गया है. वर्शन 3.0.0-alpha07 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
- Async PagingData Guava-based ऑपरेटर अब एक्ज़ीक्यूशन कॉन्टेक्स्ट को कंट्रोल करने के लिए, पैरामीटर के तौर पर Executor को स्वीकार करते हैं. (Id4372)
गड़बड़ियां ठीक की गईं
- रेस कंडिशन की वजह से, RemoteMediator में IndexOutOfBounds अपवाद को ठीक किया गया. (I00b7f, b/165821814)
- DataSource -> PagingSource कन्वर्ज़न में रेस कंडिशन को ठीक किया गया. इसकी वजह से, PagingSource, DataSource से मिलने वाले अमान्य सिग्नल को अनदेखा कर सकता था.
- पेज फ़ेच करने के लॉजिक में आने वाली समस्या को ठीक किया गया है. इसकी वजह से, PagingSource की नई जनरेशन को तब तक फ़ेच नहीं किया जा सकता था, जब तक PagingDataAdapter.refresh() को कॉल नहीं किया जाता था
- उस समस्या को ठीक किया गया है जिसकी वजह से, RemoteMediator के साथ PagingSource में बदले गए DataSource (जैसे, Room से जनरेट किया गया DataSource) का इस्तेमाल करने पर, कभी-कभी स्क्रोल-पोज़िशन खो जाती थी
बाहरी योगदान
- PagingData के लिए, RxJava2, RxJava3, और Guava पर आधारित एसिंक्रोनस ट्रांसफ़ॉर्मेशन ऑपरेटर जोड़ने के लिए, @simonschiller को धन्यवाद!
वर्शन 3.0.0-alpha06
2 सितंबर, 2020
androidx.paging:paging-*:3.0.0-alpha06 रिलीज़ हो गया है. वर्शन 3.0.0-alpha06 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
- अब जब भी
PagingDataAdapter.setHasStableIdsको कॉल किया जाएगा, तब स्टेबल आईडी के लिए सहायता न होने के बारे में साफ़ तौर पर मैसेज देने वालाUnsupportedOperationExceptionदिखेगा. (Ib3890, b/158801427)
गड़बड़ियां ठीक की गईं
- insertSeparators अब खाली पेजों को फ़िल्टर नहीं करता. इससे प्रज़ेंटर, प्रीफ़ेच डिस्टेंस का पालन कर पाता है. भले ही, कई खाली पेज डाले गए हों. (I9cff6, b/162538908)
वर्शन 3.0.0-alpha05
19 अगस्त, 2020
androidx.paging:paging-*:3.0.0-alpha05 रिलीज़ हो गया है. वर्शन 3.0.0-alpha05 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- पेजिंग अब पेजों को सही तरीके से पहले से फ़ेच करता है. भले ही, दिखाया गया डेटा बहुत ज़्यादा फ़िल्टर किया गया हो
- फिर से लोड करने की कोशिश करने पर,
LoadResult.Errorको वापस करने से, आइटम के ऐक्सेस को फिर से लोड करने की कोशिश गलत तरीके से ट्रिगर नहीं होती
बाहरी योगदान
- कुछ टेस्ट को हटाने में मदद करने के लिए, क्लारा एफ़ को धन्यवाद! (549612)
वर्शन 3.0.0-alpha04
5 अगस्त, 2020
androidx.paging:paging-*:3.0.0-alpha04 रिलीज़ हो गया है. वर्शन 3.0.0-alpha04 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
AsyncPagingDataDifferऔरPagingDataAdapterमेंpeek()एपीआई जोड़ा गया, ताकि ट्रिगर पेज लोड किए बिना, दिखाए गए डेटा को ऐक्सेस किया जा सके. (I38898, b/159104197)PagingDataAdapterऔरAsyncPagingDataDifferमेंsnapshot()एपीआई जोड़ा गया, ताकि पेज फ़ेच किए बिना ही दिखाए गए आइटम वापस पाए जा सकें. (I566b6, b/159104197)- स्टैटिक सूचियां दिखाने के लिए,
PagingData.from(List<T>)कंस्ट्रक्टर जोड़ा गया.इसे PagingData फ़्लो के साथ जोड़ा जा सकता है, ताकि कुछ स्थितियों में स्टैटिक सूचियां दिखाई जा सकें. उदाहरण के लिए, शुरुआती REFRESH खत्म होने से पहले या सिर्फ़ ट्रांसफ़ॉर्मेशन की जांच करने के लिए. (Id134d) - dataRefresh Flow / Listener API को बंद कर दिया गया है, क्योंकि इनका मकसद REFRESH पर दिखाए गए आइटम की स्थिति को दिखाना था. हालांकि, loadState Flow / Listener कॉलबैक के समय और itemCount प्रॉपर्टी में सुधार होने की वजह से, अब इनकी ज़रूरत नहीं है (Ia19f3)
PagingSourceऔरRemoteMediatorके लिए, RxJava3 के साथ काम करने वाले रैपर जोड़े गए (I49ef3, b/161480176)
गड़बड़ियां ठीक की गईं
toPagingSourceFactoryहेल्पर की मदद से,PositionalDataSourceकोPagingSourceमें बदला गया. इसमें Room से जनरेट किया गयाPagingSourceभी शामिल है. अब ये जंपिंग की सुविधा के साथ काम करने के लिए, खुद को सही तरीके से मार्क करते हैं. (I3e84c, b/162161201)- एक गड़बड़ी को ठीक किया गया है. इसमें submitData के सिंक्रोनस वैरिएंट का इस्तेमाल करने पर, कभी-कभी रेस कंडीशन की वजह से
ClosedSendChannelException(I4d702, b/160192222) की समस्या आती थी
बाहरी योगदान
- Slack की ओर से RxJava3 के साथ काम करने वाले रैपर जोड़ने के लिए, ज़ैक स्वीर्स को धन्यवाद! (I49ef3, b/161480176)
वर्शन 3.0.0-alpha03
22 जुलाई, 2020
androidx.paging:paging-*:3.0.0-alpha03 रिलीज़ हो गया है. वर्शन 3.0.0-alpha03 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
- PagingState के लिए कंस्ट्रक्टर अब सार्वजनिक है. इससे getRefreshKey() के लागू होने की जांच करना आसान हो जाएगा (I8bf15)
- DataSource kotlin मैप फ़ंक्शन के वैरिएंट को Java से छिपाया गया, ताकि ओरिजनल और kotlin वैरिएंट के बीच के अंतर को समझा जा सके. (If7b23, b/161150011)
- Kotlin का इस्तेमाल करने वाले लोगों की सुविधा के लिए बनाए गए ग़ैर-ज़रूरी एपीआई को @JvmSynthetic (I56ae5) के तौर पर मार्क किया गया है
- LoadResult.Page के कंस्ट्रक्टर के लिए ओवरलोड जोड़े गए हैं. ये itemsBefore और itemsAfter को COUNT_UNDEFINED पर डिफ़ॉल्ट रूप से सेट करते हैं (I47849)
- मौजूदा PagingData ऑपरेटर को सस्पेंड करने वाले तरीकों को स्वीकार करने की सुविधा दी गई. साथ ही, Java उपयोगकर्ताओं के लिए, सस्पेंड न करने वाले नए mapSync, flatMapSync, और filterSync ऑपरेटर जोड़े गए. ट्रांसफ़ॉर्मेशन के मौजूदा तरीकों को एक्सटेंशन फ़ंक्शन में बदल दिया गया है. इसलिए, Kotlin का इस्तेमाल करने वाले लोगों को अब उन्हें इंपोर्ट करना होगा. (I34239, b/159983232)
गड़बड़ियां ठीक की गईं
- Room (और PositionalDataSource) PagingSources अब पहले पेज के हिस्से के तौर पर, लीडिंग सेपरेटर दिखाएगा. इससे उपयोगकर्ता को इसे देखने के लिए स्क्रोल नहीं करना पड़ेगा. (I6f747, b/160257628)
- प्लेसहोल्डर पर आइटम ऐक्सेस करने से, अब PagingSource लोड सही तरीके से ट्रिगर होते हैं. ऐसा तब तक होता है, जब तक PagingData.filter() से ट्रांसफ़ॉर्म होने के बाद, अनुरोध किए गए इंडेक्स को पूरा करने वाला पेज नहीं मिल जाता (I95625, b/158763195)
- उस गड़बड़ी को ठीक किया गया है जिसमें PagingSource से गड़बड़ी का मैसेज मिलने के बाद स्क्रोल करने पर, PagingDataAdapter.retry() को फिर से कोशिश करने से रोका जा सकता था. (I1084f, b/160194384)
- उस समस्या को ठीक किया गया है जिसमें किसी पेज को छोड़ने के बाद आइटम ऐक्सेस करने पर, पेज लोड नहीं हो पाते थे. भले ही, आइटम ऐक्सेस prefetchDistance के अंदर हो (Ie95ae, b/160038730)
- PagingConfig.maxSize को सेट करने से, ड्रॉप इवेंट के बाद प्लेसहोल्डर चालू नहीं होते (I2be29, b/159667766)
वर्शन 3.0.0-alpha02
24 जून, 2020
androidx.paging:paging-*:3.0.0-alpha02 रिलीज़ हो गया है. वर्शन 3.0.0-alpha02 में ये बदलाव शामिल हैं.
एपीआई में बदलाव
PagingConfigके कंस्ट्रक्टर के लिए, सामान्य डिफ़ॉल्ट वैल्यू के साथ ओवरलोड जोड़े गए (I39c50, b/158576040)PagingDataAdapterऔरAsyncPagingDataDifferके कंस्ट्रक्टर के लिए, सामान्य डिफ़ॉल्ट वैल्यू (Ie91f5) के साथ ओवरलोड जोड़े गए हैं- अडैप्टर एपीआई,
dataRefreshFlowऔरdataRefreshListenerअब बूलियन वैल्यू पास करते हैं, ताकि यह पता चल सके किPagingDataखाली है या नहीं (I6e37e, b/159054196) - RemoteMediator के लिए, RxJava और Guava एपीआई जोड़े गए - RxRemoteMediator और ListenableFutureRemoteMediator
isEmpty()औरfirstItemOrNull()जैसे सामान्य आइटम ऐक्सेस करने के लिए, PagingState में हेल्पर जोड़े गए (I3b5b6, b/158892717)
गड़बड़ियां ठीक की गईं
- Pager अब फ़ैक्ट्री में PagingSource के फिर से इस्तेमाल की जांच करता है, ताकि अमान्य PagingSource के गलती से फिर से इस्तेमाल को रोका जा सके. इससे गड़बड़ी का साफ़ तौर पर पता नहीं चलता था (I99809, b/158486430)
- RemoteMediator REFRESH के फ़ेल होने पर, अब PagingSource को लोड होने से नहीं रोका जाता (I38b1b, b/158892717)
submitDataके सस्पेंड न होने वाले वर्शन की वजह से, अब कईPagingDataपर एक साथ कलेक्शन होने की वजह से क्रैश नहीं होता. ऐसा तब होता है, जबsubmitDataके सस्पेंड होने वाले वर्शन के बाद कॉल किया जाता है. (I26358, b/158048877)- कॉन्फ़िगरेशन में बदलाव होने के बाद, "पेजर से दो बार डेटा इकट्ठा नहीं किया जा सकता" अपवाद को ठीक किया गया (I58bcc, b/158784811)
वर्शन 3.0.0-alpha01
10 जून, 2020
androidx.paging:paging-*:3.0.0-alpha01 रिलीज़ हो गया है. वर्शन 3.0.0-alpha01 में ये बदलाव शामिल हैं.
पेजिंग लाइब्रेरी को 3.0 वर्शन में अपडेट किया गया है, ताकि कई नई सुविधाएं चालू की जा सकें.
3.0 की नई सुविधाएं
- Kotlin कोरूटीन और Flow के लिए बेहतरीन सहायता.
- coroutines suspend functions, RxJava Single या Guava ListenableFuture primitives के साथ एसिंक्रोनस लोडिंग की सुविधा.
- रिस्पॉन्सिव यूज़र इंटरफ़ेस (यूआई) डिज़ाइन के लिए, पहले से मौजूद लोड स्टेट और गड़बड़ी के सिग्नल. इनमें फिर से कोशिश करने और रीफ़्रेश करने की सुविधा भी शामिल है.
- डेटा स्टोर करने की जगह की लेयर में सुधार
- डेटा सोर्स का आसान इंटरफ़ेस
- नेटवर्क और डेटाबेस पेजेशन को आसान बनाया गया
- सदस्यता रद्द करने से जुड़ी सहायता
- प्रज़ेंटेशन लेयर में किए गए सुधार
पहले से मालूम समस्याएं
- Paging 3 के javadocs अभी उपलब्ध नहीं हैं. इस दौरान, कृपया ऊपर लिंक की गई गाइड या Kotlin के दस्तावेज़ों का इस्तेमाल करें. (b/158614050)
वर्शन 2.1.2
वर्शन 2.1.2
18 मार्च, 2020
androidx.paging:paging:2.1.2 रिलीज़ हो गया है. वर्शन 2.1.2 में 2.1.0 के मुकाबले ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- अमान्य होने के दौरान पोज़िशन को कन्वर्ट करते समय, कुछ मामलों में
IndexOutOfBoundsExceptionके लिए गड़बड़ी ठीक की गई.
रिलीज़ से जुड़ी समस्या
Paging का वर्शन
2.1.1, गलत तरीके से कॉन्फ़िगर की गई ब्रांच से गलती से रिलीज़ हो गया था. इससे, आने वाले वर्शन में उपलब्ध होने वाले एपीआई और सुविधाओं की जानकारी समय से पहले ही ज़ाहिर हो गई थी.Paging
2.1.2में, लोड-सेंटरिंग से जुड़ी गड़बड़ी को ठीक करने की सुविधा शामिल है. इसे मूल रूप से 2.1.1 में रिलीज़ किया गया था. हालांकि, इस बार इसे 2.1.0 रिलीज़ के ऊपर सही तरीके से चुना गया है. अगर आपके पास फ़िलहाल 2.1.1 वर्शन है, तो हमारा सुझाव है कि आप इस रिलीज़ पर अपग्रेड करें.
वर्शन 2.1.1
वर्शन 2.1.1
18 दिसंबर, 2019
androidx.paging:paging-*:2.1.1 रिलीज़ हो गया है. वर्शन 2.1.1 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- प्लेसहोल्डर बंद होने पर, PositionalDataSources से लगातार होने वाले शुरुआती लोड अब पिछली बार ऐक्सेस किए गए डेटा के आस-पास ही होते हैं
वर्शन 2.1.0
वर्शन 2.1.0
25 जनवरी, 2019
Paging 2.1.0 को 2.1.0-rc01 के बाद से बिना किसी बदलाव के रिलीज़ किया गया है.
वर्शन 2.1.0-rc01
6 दिसंबर, 2018
Paging 2.1.0-rc01 को 2.1.0-beta01 के बाद से बिना किसी बदलाव के रिलीज़ किया गया है.
वर्शन 2.1.0-beta01
1 नवंबर 2018
Paging 2.1.0-beta01 को 2.1.0-alpha01 के बाद से बिना किसी बदलाव के रिलीज़ किया गया है.
वर्शन 2.1.0-alpha01
12 अक्टूबर, 2018
Paging 2.1.0-alpha01 में दो मुख्य बदलाव किए गए हैं - पेज ड्रॉपिंग और हर आर्टफ़ैक्ट के लिए KTX एक्सटेंशन लाइब्रेरी. साथ ही, एपीआई में कई अन्य बदलाव किए गए हैं और गड़बड़ियां ठीक की गई हैं.
एपीआई में बदलाव
- मेमोरी में लोड किए गए आइटम की संख्या को सीमित करने के लिए,
PagedList.Config.Builder.setMaxSize()को जोड़ा गया. PagedList.Config.Builderके लिए, Kotlin के विकल्प के तौर परandroidx.paging.Config()को जोड़ा गयाPagedList.Builderके लिए, Kotlin के विकल्प के तौर परandroidx.paging.PagedList()को जोड़ा गयाLivePagedListBuilderके लिए, Kotlin के विकल्प के तौर परDataSourceFactory.toLiveData()को जोड़ा गयाRxPagedListBuilderके लिए, Kotlin के विकल्पों के तौर परDataSourceFactory.toObservable()औरtoFlowable()को जोड़ा गया- PagedList के स्वैप होने पर सुनने के लिए,
AsyncPagedListDiffer.addPagedListListener()को जोड़ा गया. b/111698609 PagedListAdapter.onCurrentListChanged()वैरिएंट जोड़ा गया, जो पुरानी और नई सूची को पास करता है. साथ ही, पिछले वैरिएंट को बंद कर दिया गया है.PagedListAdapter/AsyncPagedListDiffer.submitList()वैरिएंट जोड़े गए हैं. ये वैरिएंट एक अतिरिक्त कॉलबैक लेते हैं. यह कॉलबैक, डिफ़िंग के बाद, pagedlist के दिखने पर ट्रिगर होता है. इससे, PagedList स्वैप को अन्य यूज़र इंटरफ़ेस (यूआई) अपडेट के साथ सिंक किया जा सकता है. b/73781068PagedList.getLoadedCount()को जोड़ा गया, ताकि आपको पता चल सके कि मेमोरी में कितने आइटम हैं. ध्यान दें कि अगर प्लेसहोल्डर बंद हैं, तो रिटर्न वैल्यू हमेशा.size()के बराबर होती है.
गड़बड़ियां ठीक की गईं
- सूचियों का फिर से इस्तेमाल किए जाने पर, अंतर की तुलना करते समय होने वाली रेस कंडिशन को ठीक किया गया b/111591017
- इंडेक्स अमान्य होने पर,
PagedList.loadAround()अबIndexOutOfBoundsExceptionदिखाता है. पहले, यह किसी अन्य अपवाद की वजह से क्रैश हो सकता था. - उस समस्या को ठीक किया गया है जिसमें शुरुआती लोड का साइज़ बहुत छोटा होने और डेटा में कोई बदलाव न होने पर, आगे कोई डेटा लोड नहीं होता था b/113122599
वर्शन 2.0.0
वर्शन 2.0.0
1 अक्टूबर, 2018
Paging 2.0.0 को एक गड़बड़ी ठीक करके रिलीज़ किया गया है.
गड़बड़ियां ठीक की गईं
PositionalDataSourceऔर प्लेसहोल्डर b/114635383 का इस्तेमाल करके, बहुत तेज़ी से स्क्रोल करने पर होने वाली क्रैश की समस्या को ठीक किया गया.
वर्शन 2.0.0-beta01
2 जुलाई, 2018
गड़बड़ियां ठीक की गईं
- कुछ मामलों में, पहले से मौजूद कॉन्टेंट के गायब होने की समस्या को ठीक किया गया. जैसे, प्लेसहोल्डर बंद होने पर, PositionalDataSource b/80149146
- (
1.0.1में पहले ही रिलीज़ किया जा चुका है) क्रैश होने की उन समस्याओं को ठीक किया गया है जिनकी वजह सेPagedListAdapterऔरAsyncPagedListDiffer, मूव इवेंट को सिग्नल नहीं भेज पाते थे. b/110711937
AndroidX से पहले की डिपेंडेंसी
AndroidX से पहले के Paging के वर्शन के लिए, ये डिपेंडेंसी शामिल करें:
dependencies {
def paging_version = "1.0.0"
implementation "android.arch.paging:runtime:$paging_version"
// alternatively - without Android dependencies for testing
testImplementation "android.arch.paging:common:$paging_version"
// optional - RxJava support
implementation "android.arch.paging:rxjava2:$paging_version"
}
वर्शन 1.0.1
वर्शन 1.0.1
26 जून, 2018
Paging 1.0.1 को runtime में गड़बड़ी ठीक करने के साथ रिलीज़ किया गया है. हमारा सुझाव है कि आप 1.0.1 का इस्तेमाल करें, ताकि आपको बेहतर अनुभव मिल सके. Paging RxJava2 1.0.1 भी रिलीज़ हो गया है. यह 1.0.0-rc1 जैसा ही है.
गड़बड़ियां ठीक की गईं
- ऐसी गड़बड़ियों को ठीक किया गया है जिनकी वजह से
PagedListAdapterऔरAsyncPagedListDiffer, मूव इवेंट को सिग्नल नहीं भेज पाते थे. b/110711937
RxJava2 वर्शन 1.0.0
RxJava2 वर्शन 1.0.0-rc1
16 मई, 2018
Paging RxJava2 1.0.0-rc1 को रिलीज़ कैंडिडेट में शामिल किया जा रहा है. इसमें शुरुआती ऐल्फ़ा वर्शन के बाद से कोई बदलाव नहीं किया गया है.
वर्शन 1.0.0
वर्शन 1.0.0-rc1
19 अप्रैल, 2018 पेजिंग रिलीज़ कैंडिडेट
Paging 1.0.0 रिलीज़ के लिए, हमारे पास कोई और समस्या या नई सुविधा शेड्यूल नहीं है. कृपया अपने प्रोजेक्ट को 1.0.0-rc1 पर अपग्रेड करें और इसकी टेस्टिंग में हमारी मदद करें, ताकि हम 1.0.0 को बेहतर बना सकें.
इस रिलीज़ में कोई बदलाव नहीं किया गया है. यह 1.0.0-beta1 जैसी ही है.
वर्शन 1.0.0-beta1
5 अप्रैल, 2018
पेजिंग की सुविधा कुछ समय के लिए बीटा वर्शन में उपलब्ध होगी. इसके बाद, इसे रिलीज़ कैंडिडेट के तौर पर उपलब्ध कराया जाएगा.
हम Paging 1.0 के लिए, एपीआई में और बदलाव करने का प्लान नहीं बना रहे हैं. साथ ही, एपीआई में किसी भी तरह के बदलाव के लिए, ज़रूरी शर्तें पूरी करना बहुत मुश्किल है.
पेजिंग के लिए, Alpha RxJava2 की सुविधा को एक अलग वैकल्पिक मॉड्यूल (android.arch.paging:rxjava2:1.0.0-alpha1) के तौर पर रिलीज़ किया गया है. साथ ही, इसे तब तक अलग से वर्शन किया जाएगा, जब तक यह स्टेबल नहीं हो जाता.
यह नई लाइब्रेरी, LivePagedListBuilder के लिए RxJava2 का विकल्प उपलब्ध कराती है. यह Observable और Flowable बना सकती है. साथ ही, Executor के बजाय Scheduler ले सकती है:
Kotlin
val pagedItems = RxPagedListBuilder(myDataSource, /* page size */ 50) .setFetchScheduler(myNetworkScheduler) .buildObservable()
Java
Observable<PagedList<Item>> pagedItems = RxPagedListBuilder(myDataSource, /* page size */ 50) .setFetchScheduler(myNetworkScheduler) .buildObservable();
नई सुविधाएं
RxPagedListBuilderको नएandroid.arch.paging:rxjava2आर्टफ़ैक्ट की मदद से जोड़ा गया है.
एपीआई में बदलाव
बिल्डर में एक्ज़ीक्यूटर की भूमिका को साफ़ तौर पर बताने के लिए, एपीआई में किए गए बदलाव:
setBackgroundThreadExecutor()का नाम बदलकरsetFetchExecutor()किया गया (PagedList.BuilderऔरLivePagedListBuilderमें)setMainThreadExecutor()का नाम बदलकरsetNotifyExecutor()किया गया (PagedList.Builderमें).
PagedList.mCallbacksसदस्य को निजी के तौर पर सेट किया गया.
गड़बड़ियां ठीक की गईं
LivePagedListBuilder, Arch Components IO थ्रेड पूल के बजाय, तय किए गए एक्ज़ीक्यूटर पर शुरुआतीPagedListलोड को ट्रिगर करता है.इंटरनल
DataSourceरैपर में अमान्य व्यवहार को ठीक किया गया. इनका इस्तेमाल,DataSource.mapको लागू करने के साथ-साथ, प्लेसहोल्डर के बिनाPositionalDataSourceलोड करने के लिए किया जाता है b/77237534
वर्शन 1.0.0-alpha7
21 मार्च, 2018
Paging 1.0.0-alpha7 को Lifecycles 1.1.1 के साथ रिलीज़ किया गया. Paging alpha7, ऊपर बताई गई Function क्लास के मूव पर निर्भर करता है. इसलिए, आपको lifecycle:runtime डिपेंडेंसी को android.arch.lifecycle:runtime:1.1.1 पर अपडेट करना होगा.
Paging alpha7, Paging के बीटा वर्शन के रिलीज़ होने से पहले का आखिरी वर्शन होगा.
एपीआई में बदलाव
DataSource.LoadParamsऑब्जेक्ट में अब एक सार्वजनिक कंस्ट्रक्टर है औरDataSource.LoadCallbackऑब्जेक्ट अब ऐब्स्ट्रैक्ट हैं. इससेDataSourceको रैप किया जा सकता है या मॉक कॉलबैक की मदद से,DataSourceको सीधे तौर पर टेस्ट किया जा सकता है. b/72600421- DataSource और DataSource.Factory के लिए मैपर
map(Function<IN,OUT>)की मदद से,DataSourceसे लोड किए गए नतीजों को बदला जा सकता है, रैप किया जा सकता है या सजाया जा सकता है.mapByPage(<List<IN>,List<OUT>>), बैच प्रोसेसिंग के लिए भी ऐसा ही करता है. उदाहरण के लिए, अगर SQL से लोड किए गए आइटम को किसी अलग डेटाबेस से क्वेरी करने की ज़रूरत है, तो ऐसा बैच के तौर पर किया जा सकता है.
PagedList#getDataSource()को सुविधा के तौर पर जोड़ा गया है b/72611341- एपीआई से, बंद की गई सभी क्लास हटा दी गई हैं. इनमें
recyclerview.extensionsपैकेज औरLivePagedListProviderके बचे हुए हिस्से भी शामिल हैं. - मैप की सुविधा चालू करने के लिए,
DataSource.Factoryको इंटरफ़ेस से ऐब्स्ट्रैक्ट क्लास में बदल दिया गया है.
गड़बड़ियां ठीक की गईं
- बिल्डर को फ़ाइनल में बदला गया. b/70848565
- मल्टी-टेबल क्वेरी को मैनेज करने के लिए, Room
DataSourceको लागू करने की सुविधा को अब ठीक कर दिया गया है. यह सुधार Room 1.1.0-beta1 में शामिल है. ऊपर देखें. - एक गड़बड़ी को ठीक किया गया है. इसमें, प्लेसहोल्डर चालू होने और कुल साइज़, पेज के साइज़ का सटीक मल्टीपल होने पर,
PositionalDataSourceके लिएBoundaryCallback.onItemAtEndLoadedको शुरू नहीं किया जाता था.
वर्शन 1.0.0-alpha5
22 जनवरी, 2018
गड़बड़ियां ठीक की गईं
- प्लेसहोल्डर बंद होने पर, पेज लोड होने की समस्या को ठीक करना b/70573345
- IllegalArgumentException गड़बड़ी b/70360195 को ट्रैक करने के लिए अतिरिक्त लॉगिंग (और रूम-साइड पर संभावित सुधार)
- Javadoc सैंपल कोड से जुड़ी गड़बड़ियां ठीक की गईं b/70411933, b/71467637