পেজিং
এই টেবিলে androidx.paging গ্রুপের সব আর্টিফ্যাক্টের তালিকা আছে।
| আর্টিফ্যাক্ট | স্টেবল রিলিজ | রিলিজ ক্যান্ডিডেট | বিটা রিলিজ | আলফা রিলিজ |
|---|---|---|---|---|
| পেজিং-* | ৩.৫.৩ | - | - | 3.6.0-alpha01 |
| পেজিং-কম্পোজ | ৩.৫.৩ | - | - | 3.6.0-alpha01 |
ডিপেন্ডেন্সি ঘোষণা করা
পেজিংয়ের উপর ডিপেন্ডেন্সি যোগ করতে, আপনার প্রোজেক্টে Google Maven রিপোজিটরি যোগ করতে হবে। আরও তথ্যের জন্য Google-এর Maven রিপোজিটরি পড়ুন।
আপনার অ্যাপ বা মডিউলের জন্য build.gradle ফাইলে আপনার প্রয়োজনীয় আর্টিফ্যাক্টের জন্য ডিপেন্ডেন্সি যোগ করুন:
গ্ৰুভি
dependencies { def paging_version = "3.5.3" implementation "androidx.paging:paging-runtime:$paging_version" // alternatively - without Android dependencies for tests testImplementation "androidx.paging:paging-common:$paging_version" // optional - RxJava2 support implementation "androidx.paging:paging-rxjava2:$paging_version" // optional - RxJava3 support implementation "androidx.paging:paging-rxjava3:$paging_version" // optional - Guava ListenableFuture support implementation "androidx.paging:paging-guava:$paging_version" // optional - Jetpack Compose integration implementation "androidx.paging:paging-compose:3.5.3" }
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.0-alpha01
১৮ নভেম্বর, ২০২৬
androidx.paging:paging-*:3.6.0-alpha01 রিলিজ করা হয়েছে। 3.6.0-alpha01 ভার্সনে এইসব কমিট রয়েছে।
API-তে পরিবর্তন
- Lazy foundations-এর জন্য
ItemSnapshotListটি এক্সটেনশন যোগ করা হয়েছে। আপনি এখনItemSnapshotList#itemKeyএবংItemSnapshotList#itemContentTypeকল করে Lazy foundation-এর জন্যitemKeyএবংcontentTypeঅটোমেটিক জেনারেট করতে পারবেন। (I73455, b/560754841)
এক্সটার্নাল কন্ট্রিবিউশন
ItemSnapshotListএক্সটেনশন যোগ করার জন্য ধন্যবাদ Kamal।
ভার্সন ৩.৫
ভার্সন 3.5.3
১২ অক্টোবর, ২০২৬
androidx.paging:paging-*:3.5.3 রিলিজ করা হয়েছে। ভার্সন 3.5.3-এ এইসব কমিট আছে।
ত্রুটি সমাধান
ItemSnapshotListFlowআরIllegalArgumentExceptionথ্রো করবে না যখনRemoteMediatorযেকোনও দিকে পেজিনেশনের শেষে পৌঁছে যাবে এবং হেডার বা ফুটার টার্মিনাল সেপারেটরে পরিবর্তিত হবে। (I821c7, b/566336825)- লোড করা পৃষ্ঠা
PagingConfig.maxSize-এর বেশি হলে, ভিউপোর্ট যাতে ডেটা দিয়ে সঠিকভাবে পপুলেট করা থাকে তা নিশ্চিত করতে, লোড করা পৃষ্ঠা দুটির কম হবে না। (I037a0, b/565835910)
এক্সটার্নাল কন্ট্রিবিউশন
ইগর, b/565835910 ত্রুটি সমাধান জমা দেওয়ার জন্য ধন্যবাদ
ভার্সন 3.5.2
৭ অক্টোবর, ২০২৬
androidx.paging:paging-*:3.5.2 রিলিজ করা হয়েছে। ভার্সন 3.5.2-এ এইসব কমিট আছে।
ত্রুটি সমাধান
- প্রাথমিক রিফ্রেশ সম্পূর্ণ হওয়ার আগে
Pager.append()কল করলে আরNoSuchElementExceptionদেখাবে না। The append call will be no-op. (Ide387, b/556780796)
ভার্সন 3.5.1
১২ আগস্ট, ২০২৬
androidx.paging:paging-*:3.5.1 রিলিজ করা হয়েছে। ভার্সন 3.5.1-এ এইসব কমিট আছে।
ত্রুটি সমাধান
- প্লেসহোল্ডারে স্ক্রল করার সময় সেপারেটর সহ পৃষ্ঠা রিফ্রেশ করার সময়
PagingSource.getRefreshKey-এর ভুলanchorPositionপ্রদান করার সমস্যা সমাধান করা হয়েছে, যা অনেক বড়। (I475f0, b/516565503)
ভার্সন 3.5.0
০৬ মে, ২০২৬
androidx.paging:paging-*:3.5.0 রিলিজ করা হয়েছে। ভার্সন 3.5.0-এ এইসব কমিট আছে।
3.4.0 ভার্সনের পর থেকে গুরুত্বপূর্ণ পরিবর্তন:
Flow<PagingData>-কেFlow<ItemSnapshotList>-এ পরিবর্তন করতেFlow<PagingData>.asItemSnapshotListFlowঅপারেটর যোগ করা হয়েছে। এর অর্থ হল, লোড করা ডেটা এখন UI লেয়ারের বাইরে অ্যাক্সেস করা যাবে, যার ফলে আপনিFlow<ItemSnapshotList>-কে অন্যান্য ডেটা সোর্সের সাথে একত্রিত করতে, লোকালভাবে পেজ করা ডেটা ক্যাশে ও পরিবর্তন করতে অথবা UI স্টেট এবং আরও অনেক কিছুর অংশ হিসেবে পেজ করা ডেটা প্রকাশ করতে পারবেন।স্ক্রল না করেই ম্যানুয়ালি আরও ডেটা লোড করার জন্য এক্সটেনশন ফাংশন
Pager.appendওPager.prependযোগ করা হয়েছে।asItemSnapshotListFlowAPI ব্যবহার করার সময় লোড সংক্রান্ত সমস্যা থেকে রিকভার করতে এক্সটেনশন ফাংশনPager.refreshওPaging.retryযোগ করা হয়েছে।
Version 3.5.0-rc01
২২ এপ্রিল, ২০২৬
androidx.paging:paging-*:3.5.0-rc01 রিলিজ করা হয়েছে। 3.5.0-rc01 ভার্সনে এইসব কমিট রয়েছে।
কোনও পরিবর্তন করা হয়নি
3.5.0-beta01ভার্সন থেকে কোনও উল্লেখযোগ্য পরিবর্তন করা হয়নি।
ভার্সন 3.5.0-beta01
৮ এপ্রিল, ২০২৬
androidx.paging:paging-*:3.5.0-beta01 রিলিজ করা হয়েছে। 3.5.0-beta01 ভার্সনে এইসব কমিট আছে।
API-তে পরিবর্তন
Flow<PagingData>.asStateAPI-এর নাম পরিবর্তন করেFlow<PagingData>.asItemSnapshotListFlow(I0dc11, b/496548025) করা হয়েছে
ভার্সন 3.5.0-alpha01
১১ মার্চ, ২০২৬
androidx.paging:paging-*:3.5.0-alpha01 রিলিজ করা হয়েছে। 3.5.0-alpha01 ভার্সনে এইসব কমিট আছে।
নতুন ফিচার
paging-commonআর্টিফ্যাক্টে এখনFlow<PagingData>-এ একটি নতুনasStateফ্লো অপারেটর রয়েছে যা এটিকেFlow<ItemSnapshotList>-এ রূপান্তর করে। এটি এই ধরনের ক্ষমতা আনলক করে:- অন্যান্য ডেটা সোর্সের সাথে
ItemSnapshotList-এর ফ্লো একত্রিত করুন cachedInছাড়াই একাধিক কালেক্টরের সাথে শেয়ার ফ্লো- স্থানীয়ভাবে পেজ করা ডেটা ক্যাশে করুন
- মেমরিতে পেজ করা ডেটা পরিবর্তন করুন
- UI স্টেট-এর অংশ হিসেবে পেজ করা ডেটা এক্সপোজ করা
// 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.prependAPI যোগ করেছে।paging-runtimeবাpaging-compose-এর সাথে ব্যবহার করা হলে, স্ক্রল করা ছাড়াও আরও ডেটা লোড করার বিকল্প প্রদান করে- নতুন
asStateAPI-এর সাথে ব্যবহার করা হলে, আরও ডেটা লোড করার এটিই একমাত্র উপায়
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 ব্যবহার করার সময় লোড সংক্রান্ত সমস্যা থেকে রিকভার করতেPager.refreshএবংPager.retryযোগ করা হয়েছে। নতুন API-এর আরও স্যাম্পেল ব্যবহার দেখতে এই ডকুমেন্ট দেখুন। (I1e1e9, If3c87, Idbd48, Id1e1d, I816fe)
ভার্সন ৩.৪
ভার্সন 3.4.2
১১ মার্চ, ২০২৬
androidx.paging:paging-*:3.4.2 রিলিজ করা হয়েছে। ভার্সন 3.4.2-এ এইসব কমিট আছে।
কোনও পরিবর্তন করা হয়নি
- এই রিলিজে ৩.৪.১ ভার্সন থেকে কোনও API বা আচরণগত পরিবর্তন নেই।
ভার্সন ৩.৪.১
১১ ফেব্রুয়ারি, ২০২৬
androidx.paging:paging-*:3.4.1 রিলিজ করা হয়েছে। ভার্সন 3.4.1-এ এইসব কমিট আছে।
ডিপেন্ডেন্সি আপডেট
- paging-guava-এর guava ডিপেন্ডেন্সি ভার্সন ৩১.১ থেকে ৩২.০.১-এ আপডেট করা হয়েছে।
ভার্সন 3.4.0
২৮ জানুয়ারি, ২০২৬
androidx.paging:paging-*:3.4.0 রিলিজ করা হয়েছে। ভার্সন 3.4.0-এ এইসব কমিট আছে।
3.3.0 ভার্সনের পর থেকে গুরুত্বপূর্ণ পরিবর্তন:
paging-common,paging-testingওpaging-compose-এ আরও KMP টার্গেট যোগ করা হয়েছে। সব মিলিয়ে, এগুলি এখন JVM (Android ও ডেস্কটপ), নেটিভ (Linux, iOS, watchOS, tvOS, macOS, MinGW) ও ওয়েব (JavaScript, WasmJS) প্ল্যাটফর্মে কাজ করে- Jetbrains-এর macosX64 টার্গেট বন্ধ করে দেওয়ার সাথে সামঞ্জস্য রেখে
paging-common,paging-testingওpaging-compose,macosX64,iosX64,watchosX64ওtvosX64-এর জন্য সহায়তা সরিয়ে দিয়েছে। - টার্গেট পজিশনের সবচেয়ে কাছাকাছি থাকা এবং ইনপুট প্রেডিকেটের সাথে ম্যাচ করা লোড করা আইটেম ফিরিয়ে আনতে নতুন
PagingStateAPIclosestItemAroundPositionযোগ করা হয়েছে। এটি আইটেম-ভিত্তিক রিফ্রেশ কী জেনারেট করতে ব্যবহার করা যেতে পারে যেখানে আদর্শ অ্যাঙ্করযোগ্য আইটেমটি আশেপাশে থাকে তবে সঠিক টার্গেট পজিশনে থাকে না।
ভার্সন 3.4.0-rc01
১৪ জানুয়ারি, ২০২৬
androidx.paging:paging-*:3.4.0-rc01 রিলিজ করা হয়েছে। 3.4.0-rc01 ভার্সনে এইসব কমিট রয়েছে।
নতুন ফিচার
- Jetbrains-এর macosX64 টার্গেট বন্ধ করে দেওয়ার সাথে সামঞ্জস্য রেখে নিম্নলিখিত KMP প্ল্যাটফর্মের জন্য সহায়তা সরিয়ে দেওয়া হয়েছে:
macosX64,iosX64,watchosX64এবংtvosX64। (7cb9a4)
ভার্সন 3.4.0-beta01
১৭ ডিসেম্বর, ২০২৫
androidx.paging:paging-*:3.4.0-beta01 রিলিজ করা হয়েছে। 3.4.0-beta01 ভার্সনে এইসব কমিট রয়েছে।
ত্রুটি সমাধান
RecyclerViewএবংRefreshলোডের মধ্যে রেস ঠিক করুন যার ফলেRecyclerView-এIndexOutOfBoundsExceptionহয়। ক্রমাগতRefreshলোড হওয়ার কারণে UI আপডেট বিঘ্নিত হলে, পেজিং স্টেটRecyclerView-এর সাথে ডিসিঙ্ক হতে পারে। রিফ্রেশ করার সময় কোনও বাধা এলে (যেমন, পরপরRefreshলোড হলে), পেজিংকে তার প্রি-রিফ্রেশ অবস্থায় রিসেট করে এটি ঠিক করা হয়। (I771b0, b/409809768)
ভার্সন 3.4.0-alpha04
১০ সেপ্টেম্বর, ২০২৫
androidx.paging:paging-*:3.4.0-alpha04 রিলিজ করা হয়েছে। 3.4.0-alpha04 ভার্সনে এইসব কমিট আছে।
API-তে পরিবর্তন
- টার্গেট পজিশনের সবচেয়ে কাছাকাছি থাকা এবং ইনপুট প্রেডিকেটের সাথে ম্যাচ করা লোড করা আইটেম ফিরিয়ে আনতে নতুন
PagingStateAPIclosestItemAroundPositionযোগ করা হয়েছে। এটি আইটেম-ভিত্তিক রিফ্রেশ কী জেনারেট করতে ব্যবহার করা যেতে পারে যেখানে আদর্শ অ্যাঙ্করযোগ্য আইটেমটি আশেপাশে থাকে তবে সঠিক টার্গেট পজিশনে থাকে না। (I96e5c, b/440187139)
ভার্সন 3.4.0-alpha03
২৭ আগস্ট, ২০২৫
androidx.paging:paging-*:3.4.0-alpha03 রিলিজ করা হয়েছে। 3.4.0-alpha03 ভার্সনে এইসব কমিট রয়েছে।
নতুন ফিচার
- Paging-common, নতুন Kotlin Multiplatform (KMP) টার্গেট হিসেবে ডেস্কটপ যোগ করেছে। মোটের উপর, এটি এখন JVM (Android ও ডেস্কটপ), নেটিভ (Linux, iOS, watchOS, tvOS, macOS, MinGW) ও ওয়েব (JavaScript, WasmJS)-এ কাজ করে। (Id2483, b/436884811)
- Paging-testing-এ নতুন Kotlin Multiplatform (KMP) টার্গেট যোগ করা হয়েছে। মোটের উপর, এটি এখন JVM (Android ও ডেস্কটপ), নেটিভ (Linux, iOS, watchOS, tvOS, macOS, MinGW) ও ওয়েব (JavaScript, WasmJS)-এ কাজ করে। (I0c543, b/435014650)
- Paging-compose নতুন Kotlin Multiplatform (KMP) টার্গেট যোগ করেছে। মোটের উপর, এটি এখন JVM (Android ও ডেস্কটপ), নেটিভ (Linux, iOS, watchOS, tvOS, macOS, MinGW) ও ওয়েব (JavaScript, WasmJS)-এ কাজ করে। (I70d44, b/436884801)
API-তে পরিবর্তন
- API 21 থেকে API 23-এ ডিফল্ট minSdk সরানো হচ্ছে (Ibdfca, b/380448311, b/435705964, b/435705223)
ভার্সন 3.4.0-alpha02
৩০ জুলাই, ২০২৫
androidx.paging:paging-*:3.4.0-alpha02 রিলিজ করা হয়েছে। 3.4.0-alpha02 ভার্সনে এইসব কমিট রয়েছে।
API-তে পরিবর্তন
PagingData.fromএখনplaceholdersBeforeওplaceholdersAfterসেট করার অনুমতি দেয়। মনে রাখবেন, এইসব প্লেসহোল্ডারের মাধ্যমে স্ক্রল করলে লোড ট্রিগার হয় না। (I06983)
ভার্সন 3.4.0-alpha01
২ জুলাই, ২০২৫
androidx.paging:paging-*:3.4.0-alpha01 রিলিজ করা হয়েছে। 3.4.0-alpha01 ভার্সনে এইসব কমিট রয়েছে।
নতুন ফিচার
- পেজিং নিম্নলিখিত KMP টার্গেট যোগ করেছে: watchos, tvos, mingwX64, watchosDeviceArm64 এবং linuxArm64. (I237dd, Ia62b3, b/368046982, Icf15d, b/364652024, I139d3, b/338268719)
ত্রুটি সমাধান
- Android ইউনিট টেস্ট যা Paging 3.3 বা তার পরবর্তী ভার্সন থেকে ডেটা পুল করে, সেটি আর
PagingLoggerথেকে থ্রো করবে না (Ia9400, b/331684448) RecyclerViewআপডেট করার সময় ব্যবহারকারী স্ক্রল করলেRecyclerView-এIndexOutOfBoundsExceptionদেখানোর সমস্যা সমাধান করা হয়েছে (Id1f16, b/381024738)- স্ক্রল করার সময় রিফ্রেশ করলে পেজিং আরও লোড ট্রিগার করতে না পারার সমস্যার সমাধান করা হয়েছে। (I60ca5, b/352586078)
- পেজিং আইটেম রিফ্রেশ করার সময় স্ক্রল করলে ক্র্যাশ হওয়ার সমস্যার সমাধান করা হয়েছে। (I8c65a, b/347649763)
ভার্সন ৩.৩
ভার্সন 3.3.6
১২ ফেব্রুয়ারি, ২০২৫
androidx.paging:paging-*:3.3.6 রিলিজ করা হয়েছে। ভার্সন 3.3.6-এ এইসব কমিট আছে।
ত্রুটি সমাধান
- প্রাথমিক রিফ্রেশ করার সময় পাঠানো রিফ্রেশ ও আবার চেষ্টা করার সিগন্যাল এখন স্টোর করা হবে এবং পেজিং প্রেজেন্টার রেডি হয়ে গেলে অটোমেটিক আবার পাঠানো হবে।
এক্সটার্নাল কন্ট্রিবিউশন
ভার্সন 3.3.5
১১ ডিসেম্বর, ২০২৪
androidx.paging:paging-*:3.3.5 রিলিজ করা হয়েছে। ভার্সন 3.3.5-এ এইসব কমিট আছে।
ত্রুটি সমাধান
RecyclerViewআপডেট করার সময় ব্যবহারকারী স্ক্রল করলেRecyclerView-এরIndexOutOfBoundsExceptionদেখানোর সমস্যা সমাধান করা হয়েছে। (Id1f16, b/381024738)
ভার্সন 3.3.4
১৩ নভেম্বর, ২০২৪
androidx.paging:paging-*:3.3.4 রিলিজ করা হয়েছে। ভার্সন 3.3.4-এ এইসব কমিট রয়েছে।
ত্রুটি সমাধান
- Android ইউনিট টেস্টে পেজিং ৩.৩ বা তার পরবর্তী ভার্সন পুল করলে,
Method isLoggable in android.util.Log not mocked-এর মতো সমস্যা আর দেখাবে না। (Ia9400, b/331684448)
ভার্সন 3.3.2
৭ আগস্ট, ২০২৪
androidx.paging:paging-*:3.3.2 রিলিজ করা হয়েছে। ভার্সন 3.3.2-এ এইসব কমিট রয়েছে।
নতুন ফিচার
paging-commonএবংpaging-testingনতুন Kotlin-Multiplatform টার্গেট যোগ করেছে:watchos,tvosএবংlinuxArm64(90c9768), (53e0eca)
ভার্সন 3.3.1
২৪ জুলাই, ২০২৪
androidx.paging:paging-*:3.3.1 রিলিজ করা হয়েছে। ভার্সন 3.3.1-এ এইসব কমিট আছে।
ত্রুটি সমাধান
- স্ক্রল করার সময় ব্যাক-আপ ডেটা সোর্স রিফ্রেশ করা হলে,
AsyncPagingDataDifferবাPagingDataAdapter-এর মতো এর উপরে তৈরি করা API,RecyclerView-এর সাথে ব্যবহার করা হলে, আরও লোড ট্রিগার করতে না পারার সমস্যা সমাধান করা হয়েছে। (I60ca5, b/352586078) PagingDataAdapterবাAsyncPagingDataDifferব্যবহার করেRecyclerViewস্ক্রল করার সময় ব্যাকিং ডেটা সোর্স থেকে আইটেম সরিয়ে দেওয়ার সময় ক্র্যাশ হওয়ার সমস্যার সমাধান করা হয়েছে। (I8c65a, b/347649763)
ভার্সন 3.3.0
১৪ মে, ২০২৪
androidx.paging:paging-*:3.3.0 রিলিজ করা হয়েছে। ভার্সন 3.3.0-এ এইসব কমিট রয়েছে।
3.2.0 ভার্সনের পর থেকে গুরুত্বপূর্ণ পরিবর্তন
PagingDataPresenterএখন একটি সর্বজনীন ক্লাস। মাল্টিপ্ল্যাটফর্ম প্রেজেন্টার এখন ইন্টার্নাল পেজিং API বাpaging-runtime-এরAsyncPagingDataDiffer-এর পরিবর্তেPagingDataPresenter-এর উপরে তৈরি করা যেতে পারে।LoadStatesএবংCombinedLoadStatesনতুন হেল্পার পদ্ধতিhasErrorএবংisIdle-এ যোগ করা হয়েছে যাতেLoadStates-এ কোনও সমস্যা আছে কিনা বাNotLoadingস্ট্যাটাসে আছে কিনা তা যথাক্রমে চেক করা যায়। এছাড়াও,Flow<CombinedLoadStates>-এ একটি নতুনawaitNotLoading()Kotlin এক্সটেনশন পদ্ধতি যোগ করা হয়েছে যা লোডNotLoadingবা সমস্যা সংক্রান্ত স্ট্যাটাসে সেটেল না হওয়া পর্যন্ত অপেক্ষা করে।PagingData.empty()এখন ডিফল্ট হিসেবেNotLoadingস্টেট ডিসপ্যাচ করে, যদি না কাস্টমLoadStatesএর কনস্ট্রাক্টরে পাস করা হয়। এটি বর্তমান আচরণ থেকে আলাদা যেখানেPagingDataAdapter-এ জমা দেওয়ার সময় এটিLoadStatesডিসপ্যাচ করে না বাLazyPagingItemsহিসেবে সংগ্রহ করার সময় এটি লোডিং স্ট্যাটাস ডিসপ্যাচ করে।LazyPagingItemsহিসেবে সংগ্রহ করা হলে, এটি এখন প্রাথমিক কম্পোজিশনের সাথে সাথেই একটি খালি তালিকাও দেখাবে।
Kotlin Multiplatform-এর সাথে মানানসই
পেজিং এখন Kotlin Multiplatform-এর সাথে মানানসই আর্টিফ্যাক্ট শিপ করে, CashApp-এর multiplatform-paging প্রোজেক্ট থেকে আপস্ট্রিম করা কাজের জন্য ধন্যবাদ।
paging-commonসব পেজিং ৩ APIcommon-এ সরিয়ে নিয়ে গেছে এবং এখন Android ছাড়াও jvm ও iOS-এর সাথে মানানসই।paging-testingতার কোডcommon-এ সরিয়ে নিয়ে গেছে এবং এখন Android ছাড়াও jvm ও iOS-এর সাথে মানানসই।paging-composeতার কোডcommon-এ সরিয়ে নিয়ে গেছে এবংandroidx.compose-এর মাল্টিপ্ল্যাটফর্ম সাপোর্টের সাথে ম্যাচ করে এমন একটি Android আর্টিফ্যাক্ট শিপ করে।paging-runtime,paging-guava,paging-rxjava2এবংpaging-rxjava3শুধুমাত্র Android-এ কাজ করবে।
ভার্সন 3.3.0-rc01
১ মে, ২০২৪
Paging 3.3.0-beta01-এ কোনও পরিবর্তন না করেই androidx.paging:paging-*:3.3.0-rc01 রিলিজ করা হয়েছে। ভার্সন 3.3.0-rc01-এ এইসব কমিট রয়েছে।
ভার্সন 3.3.0-beta01
৩ এপ্রিল, ২০২৪
androidx.paging:paging-*:3.3.0-beta01-এ কোনও উল্লেখযোগ্য পরিবর্তন করা হয়নি। 3.3.0-beta01 ভার্সনে এইসব কমিট রয়েছে।
ভার্সন 3.3.0-alpha05
২০ মার্চ, ২০২৪
androidx.paging:paging-*:3.3.0-alpha05 রিলিজ করা হয়েছে। 3.3.0-alpha05 ভার্সনে এইসব কমিট আছে।
API-তে পরিবর্তন
- পেজিং এখন সাধারণ কোডের জন্য AndroidX অ্যানোটেশন
@MainThreadঅ্যানোটেশন ব্যবহার করে। (I78f0d, b/327682438)
ভার্সন 3.3.0-alpha04
৬ মার্চ, ২০২৪
androidx.paging:paging-*:3.3.0-alpha04 রিলিজ করা হয়েছে। ভার্সন 3.3.0-alpha04-এ এইসব কমিট রয়েছে।
ত্রুটি সমাধান
- Kotlin মাল্টিপ্ল্যাটফর্ম কম্প্যাটিবিলিটি যোগ করার সাথে সম্পর্কিত ছোটখাটো ডকুমেন্টেশন সংক্রান্ত সমস্যার সমাধান করা হয়েছে। (aosp/2950785)
ভার্সন 3.3.0-alpha03
৭ ফেব্রুয়ারি, ২০২৪
androidx.paging:paging-*:3.3.0-alpha03 রিলিজ করা হয়েছে। ভার্সন 3.3.0-alpha03-এ এইসব কমিট রয়েছে।
নতুন ফিচার
PagingDataPresenterএখন একটি সর্বজনীন ক্লাস। মাল্টিপ্ল্যাটফর্ম প্রেজেন্টার এখন ইন্টার্নাল পেজিং API বাpaging-runtime-এরAsyncPagingDataDiffer-এর পরিবর্তেPagingDataPresenter-এর উপরে তৈরি করা যেতে পারে। (Id1f74, b/315214786)LoadStates-এ কোনও সমস্যা আছে কিনা বাNotLoadingস্ট্যাটাসে আছে কিনা তা চেক করার জন্য নতুনLoadStatesএবংCombinedLoadStatesহেল্পার পদ্ধতি যোগ করা হয়েছে। এছাড়াও, একটি নতুন API যোগ করা হয়েছে যাLoadStateFlow-এ অপেক্ষা করে যতক্ষণ না লোডNotLoadingবা সমস্যা সংক্রান্ত স্ট্যাটাসে সেটেল হয়। (Id6c67)
আচরণে পরিবর্তন
PagingData.empty()এখন ডিফল্ট হিসেবেNotLoadingস্টেট ডিসপ্যাচ করে, যদি না কাস্টমLoadStatesএর কনস্ট্রাক্টরে পাস করা হয়। এটি বর্তমান আচরণ থেকে আলাদা যেখানেPagingDataAdapter-এ জমা দেওয়ার সময় এটিLoadStatesডিসপ্যাচ করে না বাLazyPagingItemsহিসেবে সংগ্রহ করার সময় এটি লোডিং স্ট্যাটাস ডিসপ্যাচ করে।LazyPagingItemsহিসেবে সংগ্রহ করা হলে, এটি এখন প্রাথমিক কম্পোজিশনের সাথে সাথেই একটি খালি তালিকাও দেখাবে। (I4d11d, b/301833847)
ভার্সন 3.3.0-alpha02
২০ সেপ্টেম্বর, ২০২৩
androidx.paging:paging-*:3.3.0-alpha02 রিলিজ করা হয়েছে। ভার্সন 3.3.0-alpha02-এ এইসব কমিট রয়েছে।
Kotlin Multiplatform-এর সাথে মানানসই
পেজিং এখন Kotlin Multiplatform-এর সাথে মানানসই আর্টিফ্যাক্ট শিপ করে, CashApp-এর multiplatform-paging প্রোজেক্ট থেকে আপস্ট্রিম করা কাজের জন্য ধন্যবাদ। এটি আমাদের দুটি রিপোজিটরির মধ্যে পার্থক্য এড়াতে এবং সেগুলিকে সামঞ্জস্যপূর্ণ রাখতে সাহায্য করবে।
paging-commonসব পেজিং ৩ APIcommon-এ সরিয়ে নিয়ে গেছে এবং এখন Android ছাড়াও jvm ও iOS-এর সাথে মানানসই।paging-testingতার কোডcommon-এ সরিয়ে নিয়ে গেছে এবং এখন Android ছাড়াও jvm ও iOS-এর সাথে মানানসই।paging-composeতার কোডcommon-এ সরিয়ে নিয়ে গেছে এবংandroidx.compose-এর মাল্টিপ্ল্যাটফর্ম সাপোর্টের সাথে ম্যাচ করে এমন একটি Android আর্টিফ্যাক্ট শিপ করে।paging-runtime,paging-guava,paging-rxjava2এবংpaging-rxjava3শুধুমাত্র Android-এ কাজ করবে।
API-তে পরিবর্তন
- পাবলিক Logger ইন্টারফেস যা শুধুমাত্র ইন্টার্নাল ব্যবহারের জন্য ছিল তা বন্ধ করে দেওয়া হয়েছে (I16e95, b/288623117)
এক্সটার্নাল কন্ট্রিবিউশন
- Kotlin Multiplatform-এ পেজিং সরাতে সাহায্য করার জন্য Cash App-এর veyndan-কে ধন্যবাদ (#560, #561, #562, #573, #576, #577, #578, #579, #580, #581, #583, #584, #586, #609)
ভার্সন 3.3.0-alpha01
২০ সেপ্টেম্বর, ২০২৩
- এটি androidx.paging লাইব্রেরির প্রথম মাল্টিপ্ল্যাটফর্ম রিলিজ। এই ভার্সনে শুধু
*-jvmও*-androidআর্টিফ্যাক্ট আছে। macOS, iOS ও Linux ভ্যারিয়েন্টের জন্য3.3.0-alpha02ব্যবহার করুন।
ভার্সন ৩.২
ভার্সন ৩.২.১
৬ সেপ্টেম্বর, ২০২৩
androidx.paging:paging-*:3.2.1 রিলিজ করা হয়েছে। ভার্সন 3.2.1-এ এইসব কমিট রয়েছে।
ত্রুটি সমাধান
- পেজিং টেস্টিং আর্টিফ্যাক্টের
asSnapshot()API-তেPagingData.from(List)ব্যবহার করে তৈরি করা ফ্লো পাস করার সময় হ্যাং হয়ে যাওয়ার সমস্যা সমাধান করা হয়েছে, কারণ লোডিং কখন শেষ হয়েছে সেই সম্পর্কেasSnapshot()-এর কাছে কোনও তথ্য থাকে না (PagingData.from(List, LoadStates)ওভারলোডের মতো নয়)। এই সমাধান শুধুমাত্র সম্পূর্ণ করা যায় এমন ফ্লোয়ের (যেমন,flowOf(PagingData.from(...))) ক্ষেত্রে কাজ করে। সম্পূর্ণ করা যায় না এমন ফ্লোয়ের (যেমন,MutableStateFlow) ক্ষেত্রেPagingData.fromওভারলোড ব্যবহার করুন যাLoadStatesপ্রদান করে। (I502c3) - লোডিং সম্পূর্ণ হওয়ার সাথে সাথে একই ফ্রেমে নতুন ডেটা যাতে উপলভ্য হয় তা নিশ্চিত করতে, পেজিং কম্পোজ এখন ইন্টার্নালি
AndroidUiDispatcher.Mainব্যবহার করে। (Ia55af)
ভার্সন 3.2.0
২৬ জুলাই, ২০২৩
androidx.paging:paging-*:3.2.0 রিলিজ করা হয়েছে। ভার্সন 3.2.0-এ এইসব কমিট আছে।
3.1.0 ভার্সনের পর থেকে হওয়া গুরুত্বপূর্ণ পরিবর্তন
- পেজিং কম্পোজ API স্টেবিলিটিতে পৌঁছেছে এবং পেজিংয়ের বাকি অংশের সাথে মার্জ করা হয়েছে, যেখানে এর ভার্সন এখন অন্যান্য সব পেজিং আর্টফ্যাক্টের সাথে ম্যাচ করে। 3.1.0 ভার্সনের পর থেকে যেসব পরিবর্তন করা হয়েছে:
PagingData.from(fakeData)তৈরি করে এবংPagingData-কেMutableStateFlow-এ (যেমন,MutableStateFlow(PagingData.from(listOf(1, 2, 3)))) র্যাপ করে ফেক ডেটার তালিকা প্রিভিউ করার জন্য সহায়তা। প্রিভিউ করার জন্যcollectAsLazyPagingItems()-এর রিসিভার হিসেবে এই ফ্লো@Previewকম্পোজেবলে পাস করুন।LazyVerticalGridওHorizontalPager-এর মতো সব লেজি লেআউটের পাশাপাশি Wear ও TV লাইব্রেরি থেকে কাস্টম লেজি কম্পোনেন্টের জন্য সহায়তা। এটি নতুন লোয়ার লেভেলLazyPagingItemsএক্সটেনশন পদ্ধতিitemKeyএবংitemContentType-এর মাধ্যমে অর্জন করা হয়েছে, যা আপনাকেkeyএবংcontentTypeপ্যারামিটারগুলি স্ট্যান্ডার্ডitemsAPI-তে প্রয়োগ করতে সাহায্য করে যা ইতিমধ্যেইLazyColumn,LazyVerticalGrid-এর জন্য বিদ্যমান এবং সেইসাথেHorizontalPager-এর মতো API-তে তাদের সমতুল্য।items(lazyPagingItems)এবংitemsIndexed(lazyPagingItems)যা শুধুমাত্রLazyListScope-এ কাজ করে তা বন্ধ করা হয়েছে।
- নতুন
paging-testingআর্টিফ্যাক্ট যা আপনার অ্যাপের প্রতিটি লেয়ারের ইউনিট টেস্টিং এবং আইসোলেশনে পেজিংয়ের সাথে এর ইন্টিগ্রেশনের জন্য ডিজাইন করা API প্রদান করে। যেমন, এর মধ্যে অন্তর্ভুক্ত হলTestPagerক্লাস যা আপনাকে পেজার এবং আসল UI থেকে স্বাধীনভাবে আপনার নিজস্ব কাস্টমPagingSourceইমপ্লিমেন্টেশনের আচরণ যাচাই করতে দেয়।-
asPagingSourceFactoryAPI,Flow<List<Value>>বা স্ট্যাটিকList<Value>-কেPagingSourceFactory-এ পরিবর্তন করে যা টেস্টে পেজারে পাস করা যেতে পারে Flow<PagingData<Value>>-এasSnapshotKotlin এক্সটেনশন, যাFlow<PagingData<Value>>-কে সরাসরিList<Value>-এ অনুবাদ করে।asSnapshot lambdaআপনাকেscrollToবাappendScrollWhile-এর মতো API-এর মাধ্যমে আপনার অ্যাপের UI অনুকরণ করার অনুমতি দেয় যাতে আপনি যাচাই করতে পারেন যে আপনার সেট করা পৃষ্ঠা ডেটার যেকোনও পয়েন্টে ডেটার স্ন্যাপশট সঠিক আছে কিনা।
- দুটি লেভেলে পেজিং ডিবাগিং তথ্য প্রকাশ করার জন্য ডিফল্ট লগ যোগ করা হয়েছে:
VERBOSEএবংDEBUG।adb shell setprop log.tag.Paging [DEBUG|VERBOSE]কমান্ডের মাধ্যমে লগ চালু করা যেতে পারে। এটি ভিউ সহ পেজিং বা কম্পোজ সহ পেজিং, দুটির ক্ষেত্রেই প্রযোজ্য। PagingDataAdapterএবংAsyncPagingDataDiffer-এর জন্য কনস্ট্রাক্টর যোগ করা হয়েছে যাCoroutineDispatcher-এর পরিবর্তেCoroutineContextগ্রহণ করে।- নতুন
PagingSourceFactoryফাংশনাল ইন্টারফেস যোগ করা হয়েছে যা আগের () ->PagingSourceল্যাম্বডার চেয়ে আরও স্পষ্ট API সারফেস প্রদান করে। এই ফ্যাক্টরি ব্যবহার করে পেজার ইনস্ট্যানশিয়েট করা যাবে।
ভার্সন 3.2.0-rc01
২১ জুন, ২০২৩
androidx.paging:paging-*:3.2.0-rc01 রিলিজ করা হয়েছে। ভার্সন 3.2.0-rc01-এ এইসব কমিট রয়েছে।
এক্সটার্নাল কন্ট্রিবিউশন
- Android/JVM স্পেসিফিক থেকে পেজিং সরানোর কাজে কন্ট্রিবিউট করার জন্য Veyndan-কে ধন্যবাদ। (#৫৫৩, #৫৫৪, #৫৫৫, #৫৫৯)
ভার্সন 3.2.0-beta01
৭ জুন, ২০২৩
androidx.paging:paging-*:3.2.0-beta01 রিলিজ করা হয়েছে। ভার্সন 3.2.0-beta01-এ এইসব কমিট রয়েছে।
পেজিং কম্পোজ
- পেজিং কম্পোজ আনুষ্ঠানিকভাবে API স্টেবিলিটিতে পৌঁছেছে। সেই কারণে, ভার্সনটি
1.0.0-alpha20থেকে আপডেট করা হয়েছে যাতে এখন অন্যান্য সব পেজিং আর্টিফ্যাক্টের ভার্সনের সাথে ম্যাচ করে।
API-তে পরিবর্তন
- পেজিং কম্পোজ থেকে বন্ধ হয়ে যাওয়া
items(LazyPagingItems)এবংitemsIndexed(LazyPagingItems)API সরিয়ে দেওয়া হয়েছে। তাদের রিপ্লেসমেন্ট API-এর উদাহরণ দেখতে পেজিং কম্পোজ1.0.0-alpha20রিলিজ নোট দেখুন। (I9626e)
ভার্সন 3.2.0-alpha06
২৪ মে, ২০২৩
androidx.paging:paging-*:3.2.0-alpha06 রিলিজ করা হয়েছে। ভার্সন 3.2.0-alpha06-এ এইসব কমিট রয়েছে।
নতুন ফিচার
- নতুন
PagingSourceFactoryফাংশনাল ইন্টারফেস যোগ করা হয়েছে যা বর্তমানে উপলভ্য() -> PagingSourceল্যাম্বডার তুলনায় আরও স্পষ্ট API সারফেস প্রদান করে। এই ফ্যাক্টরিPagerইনস্ট্যানশিয়েট করতে ব্যবহার করা যেতে পারে। (I33165, b/280655188) PagingSourceFactoryপেতেList<Value>.asPagingSourceFactory()-এর নতুনpaging-testingAPI যোগ করা হয়েছে যা শুধুমাত্র ডেটার অপরিবর্তনীয় তালিকা থেকে লোড হয়। স্ট্যাটিক ডেটার একাধিক জেনারেশন নিয়ে পরীক্ষা করার জন্যFlow<List<Value>>-এ আগে থেকে থাকা এক্সটেনশন এখনও ব্যবহার করা উচিত। (Id34d1, b/280655188)
API-তে পরিবর্তন
- পেজিং-টেস্টিং-এর সমস্ত পাবলিক API এখন
@VisibleForTesting-এর সাথে অ্যানোটেট করা হয়েছে যাতে এই APIগুলি শুধুমাত্র টেস্টে ব্যবহার করা হয়। (I7db6e) asSnapshotAPI-তে আরCoroutineScopeপাস করার প্রয়োজন নেই। এটি এখন ডিফল্ট হিসেবে পেরেন্ট স্কোপ থেকে পাওয়া কনটেক্সট ব্যবহার করে। (Id0a78, b/282240990)TestPagerকনস্ট্রাক্টর প্যারামিটারকে আবার সাজানো হয়েছে যাতে আসলPagerকনস্ট্রাক্টর প্যারামিটারের (I6185a) ক্রমের সাথে স্বজ্ঞাতভাবে মেলে() -> PagingSource<Key, Value>ল্যাম্বডা টাইপ থেকেPagingSourceFactory<Key, Value>টাইপে মাইগ্রেট করা পেজিং-টেস্টিংয়ের ব্যবহার। (I4a950, b/280655188)
আচরণে পরিবর্তন
asSnapshotপেজিং টেস্ট চালানোর জন্য মূল ডিসপ্যাচার আর প্রয়োজন নেই। এটি সেট করলে টেস্টের আচরণে আর কোনও পরিবর্তন হয় না। (Ie56ea)
ভার্সন 3.2.0-alpha05
৩ মে, ২০২৩
androidx.paging:paging-*:3.2.0-alpha05 রিলিজ করা হয়েছে। ভার্সন 3.2.0-alpha05-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
asSnapshot-এর পেজিং টেস্টিং API এখন ডিফল্ট হিসেবে এরloadOperationsপ্যারামিটারকে একটি খালি ল্যাম্বডাতে সেট করে। এটি প্রাথমিক রিফ্রেশ লোড থেকে ডেটা ফিরিয়ে আনার জন্য কোনও লোড অপারেশন পাস না করেইasSnapshotকল করার অনুমতি দেয়। (Ied354, b/277233770)
ডকুমেন্টেশন সংক্রান্ত উন্নতি
asPagingSourceFactory()-এর ডকুমেন্টেশন আপডেট করা হয়েছে যাতে এটি স্পষ্ট হয় যে এটিFlow-এর একটি এক্সটেনশন পদ্ধতি যাPagingSourceইনস্ট্যান্স তৈরি করার জন্য একটি পুনর্ব্যবহারযোগ্য ফ্যাক্টরি প্রদান করে। (I5ff4f, I705b5)- জাম্পিংয়ের সুবিধা দিতে
itemsBeforeওitemsAfterওভাররাইড করার প্রয়োজনীয়তা স্পষ্ট করতেLoadResult.Pageকনস্ট্রাক্টরের ডকুমেন্টেশন আপডেট করা হয়েছে। (Ied354)
এক্সটার্নাল কন্ট্রিবিউশন
- Android/JVM স্পেসিফিক থেকে পেজিং সরানোর কাজে কন্ট্রিবিউট করার জন্য Veyndan-কে ধন্যবাদ। (#525, #523, #520, #519, #507, #506, #505, #499, #497, #496, #493)
ভার্সন 3.2.0-alpha04
৮ ফেব্রুয়ারি, ২০২৩
androidx.paging:paging-*:3.2.0-alpha04 রিলিজ করা হয়েছে। ভার্সন 3.2.0-alpha04-এ এইসব কমিট রয়েছে।
পেজিং টেস্টিং
paging-testingআর্টিফ্যাক্টে এখন একটিasPagingSourceFactoryপদ্ধতি রয়েছে যার মাধ্যমেFlow<List<Value>>থেকেpagingSourceFactoryতৈরি করা যায় এবং এটি পেজারে সাপ্লাই করা হয়। Flow থেকে নির্গত প্রতিটিList<Value>>, Paged ডেটার একটি জেনারেশনকে উপস্থাপন করে। এটি পেজিং টেস্টের সুবিধা দেয়, যেমন, পেজারের সংগ্রহ করার জন্য ডেটা সোর্স নকল করেPagingDataট্রান্সফর্মেশন। (I6f230, b/235528239)paging-testingআর্টিফ্যাক্টটি নতুন API-এর সাথে প্রসারিত করা হয়েছে যাFlow<PagingData<T>>-এর সাথে থাকা ডেটা সঠিক কিনা তা যাচাই করার জন্য উপযুক্ত। যেমন, আপনার ViewModel লেয়ার থেকেFlow<PagingData<T>>-এর আউটপুট অ্যাসার্ট করতে এটি ব্যবহার করা যেতে পারে।এটি
Flow<PagingData<Value>>-এasSnapshotKotlin এক্সটেনশনের মাধ্যমে করা হয়, যাFlow<PagingData<Value>>-কে সরাসরিList<Value>-এ অনুবাদ করে।asSnapshotল্যাম্বডা আপনাকেscrollToবাappendScrollWhile-এর মতো API-এর মাধ্যমে আপনার অ্যাপের UI-কে এমনভাবে অনুকরণ করতে দেয় যা পুনরাবৃত্তিযোগ্য এবং সামঞ্জস্যপূর্ণ যাতে আপনি আপনার পেজ করা ডেটার সেটের যেকোনো পয়েন্টে ডেটার স্ন্যাপশট সঠিক কিনা তা যাচাই করতে পারেন।// 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 Coroutines পরীক্ষা করা দেখুন। (I55fd2, I5bd26, I7ce34, I51f4d, I2249f, Id6223, Ic4bab, Ib29b9, Ic1238, I96def, b/235528239)
API-তে পরিবর্তন
AsyncPagingDataDifferএবংPagingDataAdapter-এgetItemএবংpeek-এ UI কলগুলি এখন সঠিকভাবে শুধুমাত্র প্রধান থ্রেডে কলযোগ্য হিসাবে চিহ্নিত করা হয়েছে। (I699b6)TestPager-এর ব্যবহার করা জেনেরিক টাইপ থেকে ওয়াইল্ডকার্ড সরিয়ে দেওয়া হয়েছে, যার ফলে Java প্রোগ্রামিং ল্যাঙ্গুয়েজে লেখা কোডে এইসব পদ্ধতির ফলাফল ব্যবহার করা আরও সহজ হয়েছে। (I56c42)
ভার্সন 3.2.0-alpha03
২৪ অক্টোবর, ২০২২
androidx.paging:paging-*:3.2.0-alpha03 রিলিজ করা হয়েছে। ভার্সন 3.2.0-alpha03-এ এইসব কমিট রয়েছে।
পেজিং টেস্টিং
এই রিলিজে নতুন আর্টিফ্যাক্ট আছে: paging-testing। এই আর্টিফ্যাক্টটি আপনার অ্যাপের প্রতিটি লেয়ারের ইউনিট টেস্টিং এবং বিচ্ছিন্নভাবে পেজিংয়ের সাথে এর ইন্টিগ্রেশনের চারপাশে ডিজাইন করা API প্রদান করে।
যেমন, এই প্রথম রিলিজে একটি TestPager ক্লাস অন্তর্ভুক্ত আছে যা আপনাকে Pager এবং আসল UI থেকে স্বাধীনভাবে আপনার নিজস্ব কাস্টম PagingSource ইমপ্লিমেন্টেশনের আচরণ যাচাই করার অনুমতি দেয় যা সাধারণত এন্ড-টু-এন্ড পেজিং ইন্টিগ্রেশন সিমুলেট করার জন্য প্রয়োজন হয়।
TestPager-কে ফেক হিসেবে বিবেচনা করা উচিত - একটি টেস্ট ডবল যা Pager-এর আসল ইমপ্লিমেন্টেশনকে মিরর করে এবং PagingSource টেস্ট করার জন্য একটি সরলীকৃত API সারফেস প্রদান করে। এই APIগুলি হল suspend API এবং Android-এ Kotlin coroutines পরীক্ষা করা সংক্রান্ত গাইডে যেমন উল্লেখ করা আছে, সেই অনুযায়ী runTest-এর মধ্যে রান করা উচিত।
এইসব API-এর ব্যবহারের উদাহরণ room-paging টেস্টে পাওয়া যাবে, যা TestPager ব্যবহার করার জন্য রিফ্যাক্টর করা হয়েছে।
API-তে পরিবর্তন
LoadResult.Page.dataথেকেLoadResult.Page.iterator()পর্যন্ত সুবিধাজনক ইটারেশন চালু করে। এটি পরোক্ষভাবে Kotlin স্ট্যান্ডার্ড লাইব্রেরিflattenপদ্ধতি ব্যবহার করার অনুমতি দেয় যখনList<LoadResult.Page>দেওয়া হয় যেমনPagingState-এরpagesপ্রপার্টি সহ যাPagingSource.getRefreshKeyপদ্ধতিতে পাস করা হয়। (Ie0718)
ভার্সন 3.2.0-alpha02
১০ আগস্ট, ২০২২
androidx.paging:paging-*:3.2.0-alpha02 রিলিজ করা হয়েছে। ভার্সন 3.2.0-alpha02-এ এইসব কমিট রয়েছে।
নতুন ফিচার
PagingDataথেকে সংগ্রহ করা ডিবাগিং তথ্য প্রকাশ করার জন্য পেজিং এখনAsyncPagingDataDifferবাPagingDataAdapterক্লাসের মাধ্যমে লগ প্রদান করে।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
১ জুন, ২০২২
androidx.paging:paging-*:3.2.0-alpha01 রিলিজ করা হয়েছে। ভার্সন 3.2.0-alpha01-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
PagingDataAdapterএবংAsyncPagingDataDiffer-এর জন্য কনস্ট্রাক্টর যোগ করা হয়েছে যাCoroutineDispatcher-এর পরিবর্তেCoroutineContextগ্রহণ করে। (Idc878)- ডিফল্ট হিসেবে,
PagingData.from()এবংPagingData.empty()আর উপস্থাপকের দিকেCombinedLoadStates-কে প্রভাবিত করবে না। একটি নতুন ওভারলোড যা এই কনস্ট্রাক্টরগুলিতেsourceLoadStatesএবংremoteLoadStatesপাস করার অনুমতি দেয়,LoadStates-এর বিদ্যমান আচরণ বজায় রাখার জন্য যোগ করা হয়েছে যাতে এটি সম্পূর্ণরূপে টার্মিনাল হয় (যেমন,NotLoading(endOfPaginationReached = false)), সাথে প্রয়োজন হলে রিমোট স্টেট অন্তর্ভুক্ত করার বিকল্পও রয়েছে।LoadStatesপাস না হলে, আগেরCombinedLoadStatesপ্রেজেন্টারের দিকে বজায় রাখা হবে যখন এটি স্ট্যাটিকPagingDataপাবে। (Ic3ce5, b/205344028)
ত্রুটি সমাধান
PagingSource.getRefreshKey()-এর ফলাফল এখনinitialKey-এর চেয়ে সঠিকভাবে অগ্রাধিকার দেওয়া হয়েছে, যেখানে এটি নাল রিটার্ন করবে, কিন্তু একটি নন-নালinitialKeyসেট করা হয়েছে। (Ic9542, b/230391606)
এক্সটার্নাল কন্ট্রিবিউশন
- test-coroutines-lib মাইগ্রেশনের (I3366d) কারণে :compose:ui:ui-test api (updateApi) আপডেট করা হয়েছে
ভার্সন ৩.১
ভার্সন ৩.১.১
৯ মার্চ, ২০২২
androidx.paging:paging-*:3.1.1 রিলিজ করা হয়েছে। ভার্সন 3.1.1-এ এইসব কমিট রয়েছে।
ত্রুটি সমাধান
.cachedIn()-এর মাধ্যমে ভুলভাবে যোগ করা জেনারেশনের মধ্যে থাকা ইন্টারমিডিয়েটLoadState.NotLoadingইভেন্ট সরিয়ে দেওয়া হয়েছে। এই পরিবর্তনের ফলেLoadState-এ হওয়া পরিবর্তনের উপর প্রতিক্রিয়া জানানো অনেক সহজ হয়ে যায়। এটি করার জন্য, রিফ্রেশ করার সময় বা বাতিল করার সময়, লোড করার ব্যর্থ প্রচেষ্টার মধ্যে তৈরি হওয়া অপ্রয়োজনীয়LoadState.NotLoadingইভেন্ট সরিয়ে দেওয়া হয়।
ভার্সন 3.1.0
১৭ নভেম্বর, ২০২১
androidx.paging:paging-*:3.1.0 রিলিজ করা হয়েছে। ভার্সন 3.1.0-এ এইসব কমিট আছে।
3.0.0 ভার্সনের পর থেকে হওয়া গুরুত্বপূর্ণ পরিবর্তন
Flow<PagingData>.observableএবংFlow<PagingData>.flowableAPI আর পরীক্ষামূলক পর্যায়ে নেইLoadState-এ আচরণের পরিবর্তন:endOfPaginationReachedএখনPagingSourceএবংRemoteMediatorউভয়ের জন্যLoadType.REFRESH-এ সবসময়falseহিসেবে সেট করা আছে- পেজিং থেকে
LoadStatesএখন ডাউনস্ট্রিমে এমিট করার আগেPagingSourceএবংRemoteMediatorউভয়ের কাছ থেকে সঠিক ভ্যালুর জন্য অপেক্ষা করছে।PagingData-এর নতুন জেনারেশন এখন থেকে সবসময় রিফ্রেশ স্টেট-এর জন্যLoadingদিয়ে সঠিকভাবে শুরু হবে, কিছু ক্ষেত্রেNotLoading-এ ভুলভাবে রিসেট হওয়ার পরিবর্তে। .loadStateFlowএবং.addLoadStateListenerপ্রেজেন্টার API-তে আর অপ্রয়োজনীয়ভাবে প্রাথমিকCombinedLoadStatesপাঠায় না, যার মধ্যস্থতাকারী স্ট্যাটাস সবসময়null-এ সেট করা থাকে
- Cancellation on past generations now happens eagerly on invalidation / new generations.
Flow<PagingData>-এ.collectLatestব্যবহার করার আর প্রয়োজন নেই, তবে এখনও এটি করার জন্য সাজেস্ট করা হয়। PagingSource.LoadResult.Invalid-কেPagingSource.loadথেকে নতুন রিটার্ন টাইপ হিসেবে যোগ করা হয়েছে, যার ফলে পেজিং এইPagingSource-এ যেকোনও পেন্ডিং বা ভবিষ্যতের লোড অনুরোধ বাতিল করে দেয় এবং এটিকে অবৈধ করে দেয়। এই রিটার্ন টাইপটি ডেটাবেস বা নেটওয়ার্ক থেকে ফেরত আসতে পারে এমন সম্ভাব্য ভুল বা পুরনো ডেটা ম্যানেজ করার জন্য ডিজাইন করা হয়েছে।.onPagesPresentedএবং.addOnPagesUpdatedListenerপ্রেজেন্টার API যোগ করা হয়েছে যা UI-তে পৃষ্ঠা দেখানোর সাথে সাথে সিঙ্ক হয়ে ট্রিগার হয়। নিম্নলিখিত পরিস্থিতিতে পৃষ্ঠা আপডেট হতে পারে:- নতুন প্রজন্মের PagingData-এর প্রাথমিক লোড সম্পূর্ণ হয়, নতুন প্রজন্মে উপস্থাপিত আইটেমগুলিতে কোনও পরিবর্তন থাকুক বা না থাকুক। অর্থাৎ, কোনও আপডেট ছাড়াই প্রাথমিক লোড সম্পূর্ণ করা একটি নতুন জেনারেশন এখনও এই কলব্যাক ট্রিগার করবে কারণ তালিকাটি ঠিক একই রকম।
- একটি পৃষ্ঠা যোগ করা হয়েছে, যদিও যোগ করা পৃষ্ঠায় কোনও নতুন আইটেম নেই।
- ড্রপ করা পৃষ্ঠাটি খালি থাকলেও, একটি পৃষ্ঠা ড্রপ করা হয়।
ভার্সন 3.1.0-rc01
৩ নভেম্বর, ২০২১
androidx.paging:paging-*:3.1.0-rc01 রিলিজ করা হয়েছে। ভার্সন 3.1.0-rc01-এ এইসব কমিট রয়েছে।
ত্রুটি সমাধান
- .cachedIn()-এ রেস কন্ডিশন + মেমরি লিক সংক্রান্ত সমস্যার সমাধান করা হয়েছে। এই সমস্যা তখন দেখা যায় যখন কোনও দর্শক না থাকলে বা কোনও দর্শক নতুন PagingData-তে সুইচ করার সময় পেজিং ডাউনস্ট্রিম একাধিক লোড ইভেন্ট পাঠায়। (Ib682e)
ভার্সন 3.1.0-beta01
১৩ অক্টোবর, ২০২১
androidx.paging:paging-*:3.1.0-beta01 রিলিজ করা হয়েছে। ভার্সন 3.1.0-beta01-এ এইসব কমিট রয়েছে।
ত্রুটি সমাধান
- একটি সমস্যার সমাধান করা হয়েছে যেখানে অনেক দ্রুত আইটেম অ্যাক্সেস করার ফলে prefetchDistance-এ বিবেচনার জন্য সেগুলি বাদ পড়ে যেতে পারে, যার ফলে পৃষ্ঠা লোড হতে দেরি হয়। এটি বিশেষ করে তখনই সমস্যা হয়ে দাঁড়ায় যখন অনেক আইটেম একসাথে এমন ক্রমে সাজানো থাকে যা ব্যবহারকারীর স্ক্রল করার দিকের বিপরীতে লোড করার ক্ষেত্রে অগ্রাধিকার দেয়। এইসব আইটেম অ্যাক্সেস এখন বাফার করা হয়েছে এবং ড্রপ হওয়া থেকে আটকাতে সিঙ্ক্রোনাইজ করে অগ্রাধিকার দেওয়া হয়েছে। (aosp/1833273)
ভার্সন 3.1.0-alpha04
২৯ সেপ্টেম্বর, ২০২১
androidx.paging:paging-*:3.1.0-alpha04 রিলিজ করা হয়েছে। ভার্সন 3.1.0-alpha04-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
Flow<PagingData>.observableএবংFlow<PagingData>.flowableAPI আর পরীক্ষামূলক নয়। (Ie0bdd)
ত্রুটি সমাধান
- LoadStates-এর জন্য,
endOfPaginationReachedএখন সবসময়falseLoadType.REFRESH-এর জন্য। আগে, RemoteMediatorREFRESH-এর জন্য endOfPaginationReachedtrueহতে পারত, কিন্তু PagingSource-এর জন্য নয়। এই আচরণ এখন সবসময়falseরিটার্ন করার জন্য কনসোলিডেট করা হয়েছে কারণ REFRESH-এর টার্মিনাল হওয়ার কোনও অর্থ হয় না এবং এখন LoadStates-এ API চুক্তির অংশ হিসেবে ডকুমেন্ট করা হয়েছে। পেজিনেশন বন্ধ করা হবে কিনা সেই সিদ্ধান্ত নেওয়ার সময়, আপনাকে সবসময় APPEND বা PREPEND ডিরেকশন অনুযায়ী তা করতে হবে। (I047b6) Paging থেকে LoadStates এখন জেনারেশনের মধ্যে ডাউনস্ট্রিম এমিট করার আগে PagingSource এবং RemoteMediator, উভয়ের থেকেই সঠিক ভ্যালুর জন্য অপেক্ষা করে। এটি PagingData-এর নতুন জেনারেশনকে CombinedLoadStates.source.refresh-এ NotLoading পাঠানো থেকে আটকায়, যদি এটি আগে থেকেই Loading অবস্থায় থাকে; PagingData-এর নতুন জেনারেশন এখন সবসময় রিফ্রেশ স্টেটের জন্য Loading দিয়ে সঠিকভাবে শুরু হবে, কিছু ক্ষেত্রে ভুলভাবে প্রথমে NotLoading-এ রিসেট করার পরিবর্তে।
Cancellation on past generations now happen eagerly on invalidation / new generations.
Flow<PagingData>-এ .collectLatest ব্যবহার করার আর প্রয়োজন নেই, যদিও এটি করার জন্য এখনও অত্যন্ত সাজেস্ট করা হয়। (I0b2b5, b/177351336, b/195028524)প্রেজেন্টার API-তে
.loadStateFlowএবং.addLoadStateListenerআর অপ্রয়োজনীয়ভাবে প্রাথমিকCombinedLoadStatesপাঠায় না, যার মিডিয়েটর স্টেট সবসময়nullএবং সোর্স স্টেট সবসময়NotLoading(endOfPaginationReached = false)-এ সেট করা থাকে। এর অর্থ হল:- আপনি RemoteMediator ব্যবহার করলে, মধ্যস্থতাকারীর স্ট্যাটাস সবসময় পপুলেট করা হবে।
.loadStateFlow-এ নতুন loadState লিসেনার বা নতুন কালেক্টর রেজিস্টার করলে তা আর অবিলম্বে বর্তমান ভ্যালু এমিট করবে না যদি না এটিPagingDataথেকে আসলCombinedLoadStatesনা পায়।PagingDataজমা দেওয়ার আগে কোনও কালেক্টর বা লিসেনার শুরু হলে এটি হতে পারে। (I1a748)
ভার্সন 3.1.0-alpha03
২১ জুলাই, ২০২১
androidx.paging:paging-*:3.1.0-alpha03 রিলিজ করা হয়েছে। ভার্সন 3.1.0-alpha03-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
PagingSource-এ তৃতীয় LoadResult রিটার্ন টাইপ LoadResult.Invalid যোগ করা হয়েছে। PagingSource.load যখন LoadResult.Invalid রিটার্ন করে, তখন পেজিং লোড করা ডেটা বাতিল করে দেবে এবং PagingSource-কে অবৈধ করে দেবে। এই রিটার্ন টাইপটি ডেটাবেস বা নেটওয়ার্ক থেকে ফেরত আসতে পারে এমন সম্ভাব্য ভুল বা বাসি ডেটা ম্যানেজ করার জন্য ডিজাইন করা হয়েছে।
যেমন, যদি অন্তর্নিহিত ডেটাবেসে লেখা হয় কিন্তু PagingSource সময়মতো অবৈধ না হয়, তাহলে এটি অসামঞ্জস্যপূর্ণ ফলাফল দেখাতে পারে যদি এর প্রয়োগ যে ব্যাকআপ ডেটাসেট থেকে এটি লোড করে তার অপরিবর্তনীয়তার উপর নির্ভর করে (যেমন, LIMIT OFFSET স্টাইল db প্রয়োগ)। এই পরিস্থিতিতে, লোড করার পরে অবৈধকরণের জন্য চেক করা এবং LoadResult.Invalid রিটার্ন করার সাজেশন দেওয়া হয়, যার ফলে পেজিং এই PagingSource-এ কোনও বাকি থাকা বা ভবিষ্যতের লোড অনুরোধ বাতিল করে দেয় এবং এটি অবৈধ করে দেয়।
এই রিটার্ন টাইপ Paging2 API-তেও কাজ করে যা LivePagedList বা RxPagedList-এর সুবিধা নেয়। Paging2-এর PagedList API-এর সাথে PagingSource ব্যবহার করার সময়, PagedList অবিলম্বে বিচ্ছিন্ন হয়ে যায়, এই PagedList-এ ডেটা লোড করার আরও প্রচেষ্টা বন্ধ করে দেয় এবং PagingSource-এ অবৈধকরণ ট্রিগার করে।
LoadResult হল একটি সিল করা ক্লাস, যার অর্থ হল এটি একটি সোর্স-অসঙ্গত পরিবর্তন যাতে সরাসরি ব্যবহার করা কেস ব্যবহার করে PagingSource.load ফলাফলগুলি LoadResult.Invalid পরিচালনা করতে হবে কম্পাইল করার সময়। যেমন, Kotlin ব্যবহারকারীরা রিটার্ন টাইপ চেক করার জন্য exhaustive-when ব্যবহার করলে, তাদের Invalid টাইপের জন্য একটি চেক যোগ করতে হবে। (Id6bd3, b/191806126, b/192013267)
ত্রুটি সমাধান
- PagingSource.registerInvalidatedCallback বা DataSource.addInvalidatedCallback-এর মাধ্যমে যোগ করা ইনভ্যালিডেশন কলব্যাক এখন অটোমেটিক ট্রিগার হয় যদি সেগুলি আগে থেকেই ইনভ্যালিড থাকা PagingSource / DataSource-এ রেজিস্টার করা থাকে। এটি রেস কন্ডিশন সংক্রান্ত সমস্যার সমাধান করে যার ফলে পেজিং ইনভ্যালিডেশন সিগন্যাল ড্রপ করে এবং প্রাথমিক লোডের সময় আগে থেকেই ইনভ্যালিড সোর্স প্রদান করা হলে আটকে যায়। এছাড়াও, ইনভ্যালিডেট কলব্যাক ট্রিগার হওয়ার পরে এখন সঠিকভাবে সরিয়ে দেওয়া হয় কারণ এগুলি সর্বাধিক একবার কল করার গ্যারান্টি দেওয়া হয়। (I27e69)
- নতুন ইনস্ট্যান্স করা PagedList স্ট্রিম থেকে প্লেসহোল্ডার প্রাথমিক ভ্যালু (InitialPagedList) জমা দিলে, যেমন, LivePagedListBuilder বা RxPagedListBuilder, আগে লোড করা ডেটা আর মুছে যাবে না।
Version 3.1.0-alpha02
১ জুলাই, ২০২১
androidx.paging:paging-*:3.1.0-alpha02 রিলিজ করা হয়েছে। ভার্সন 3.1.0-alpha02-এ এইসব কমিট রয়েছে।
নতুন ফিচার
onPagesPresented লিসেনার এবং ফ্লো প্রেজেন্টার API যোগ করা হয়েছে যা UI-তে উপস্থাপিত পৃষ্ঠা আপডেট হওয়ার সাথে সাথেই ট্রিগার হয়।
যেহেতু এই আপডেটগুলি UI-এর সাথে সিঙ্ক্রোনাস, তাই আপনি অ্যাডাপ্টার পদ্ধতি কল করতে পারেন যেমন .snapshot, .getItemCount, আপডেট প্রয়োগ করার পরে অবস্থা পরিদর্শন করতে। মনে রাখবেন যে .snapshot() এক্সপ্লিসিটলি কল করার জন্য বাকি রাখা হয়েছে কারণ প্রতিটি আপডেটে এটি করা ব্যয়বহুল হতে পারে।
নিম্নলিখিত পরিস্থিতিতে পৃষ্ঠা আপডেট হতে পারে:
- নতুন প্রজন্মের PagingData-এর প্রাথমিক লোড সম্পূর্ণ হয়, নতুন প্রজন্মে উপস্থাপিত আইটেমে কোনও পরিবর্তন থাকুক বা না থাকুক। অর্থাৎ, কোনও আপডেট ছাড়াই প্রাথমিক লোড সম্পূর্ণ করা নতুন জেনারেশন এই কলব্যাক ট্রিগার করবে কারণ তালিকাটি হুবহু একই রকম।
- একটি পৃষ্ঠা যোগ করা হয়েছে, যদিও যোগ করা পৃষ্ঠায় কোনও নতুন আইটেম নেই
- কোনও পৃষ্ঠা ড্রপ করা হয়েছে, এমনকি ড্রপ করা পৃষ্ঠাটি খালি থাকলেও (I272c9, b/189999634)
ত্রুটি সমাধান
- LivePagedList বা RxPagedList-এর মাধ্যমে তৈরি করা প্রাথমিক ভ্যালু থেকে PagedList.dataSource অ্যাক্সেস করলে, আর ভুল করে IllegalStateException (I96707) দেখানো হবে না
ভার্সন 3.1.0-alpha01
২ জুন, ২০২১
androidx.paging:paging-*:3.1.0-alpha01 রিলিজ করা হয়েছে। ভার্সন 3.1.0-alpha01-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
paging-rxjava3-এর প্রদান করা ক্লাস এখনandroidx.paging.rxjava3প্যাকেজের অধীনে থাকে যাতে সেগুলিpaging-rxjava2-এর সাথে কনফ্লিক্ট না করে (Ifa7f6)
ত্রুটি সমাধান
- একটি সমস্যার সমাধান করা হয়েছে যেখানে পেজিং কখনও কখনও RecyclerView-তে নো-অপ ডিফার ইভেন্ট পাঠাত, যার ফলে নির্দিষ্ট কিছু লিসেনার আগে ট্রিগার হতে পারত। (Ic507f, b/182510751)
এক্সটার্নাল কন্ট্রিবিউশন
- rxjava3 আর্টিফ্যাক্টে অবচিত PagedList compat API যোগ করা হয়েছে (Id1ce2, b/182497591)
Paging Compose ভার্সন 1.0.0
ভার্সন 1.0.0-alpha20
২৪ মে, ২০২৩
androidx.paging:paging-compose:1.0.0-alpha20 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha20-এ এইসব কমিট রয়েছে।
নতুন ফিচার
- পেজিং কম্পোজ এখন
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)
Version 1.0.0-alpha19
৩ মে, ২০২৩
androidx.paging:paging-compose:1.0.0-alpha19 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha19-এ এইসব কমিট রয়েছে।
সব লেজি লেআউট কাজ করে
আগে, পেজিং কম্পোজ LazyListScope-এ কাস্টম items এবং itemsIndexed এক্সটেনশন প্রদান করত, যার অর্থ হল আপনি Wear এবং TV লাইব্রেরি দ্বারা প্রদত্ত LazyVerticalGrid, HorizontalPager বা অন্যান্য কাস্টম লেজি কম্পোনেন্টের মতো অন্যান্য লেজি লেআউটের সাথে পেজিং কম্পোজ ব্যবহার করতে পারবেন না। এই অনমনীয়তার সমাধান করাই হল এই রিলিজের প্রাথমিক আপডেট।
আরও লেজি লেআউট সাপোর্ট করার জন্য, আমাদের অন্য লেয়ারে API তৈরি করতে হয়েছে - প্রতিটি লেজি লেআউটের জন্য কাস্টম items API প্রদান করার পরিবর্তে, পেজিং কম্পোজ এখন itemKey ও itemContentType-এ LazyPagingItems-এর উপর কিছুটা লোয়ার লেভেল এক্সটেনশন পদ্ধতি প্রদান করে। এইসব API-এর মূল লক্ষ্য হল, LazyColumn, LazyVerticalGrid-এর জন্য আগে থেকেই উপলভ্য স্ট্যান্ডার্ড items API-তে key ও contentType প্যারামিটার প্রয়োগ করতে আপনাকে সাহায্য করা। এর পাশাপাশি, HorizontalPager-এর মতো API-তে সমতুল্য প্যারামিটার প্রয়োগ করতেও সাহায্য করা। (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)
}
}
এইসব নতুন API ব্যবহার করার আরও উদাহরণ দেখতে, আমাদের স্যাম্পেল দেখুন।
এই পরিবর্তনগুলি LazyColumn এবং LazyRow উদাহরণগুলিকে আরও কয়েক লাইন দীর্ঘ করে তোলে, আমরা অনুভব করেছি যে সমস্ত লেজি লেআউট জুড়ে ধারাবাহিকতা তাদের জন্য একটি গুরুত্বপূর্ণ বিষয় যারা ভবিষ্যতে পেজিং কম্পোজ ব্যবহার করছেন। সেই কারণে, LazyListScope-এর জন্য আগে থেকে থাকা এক্সটেনশন এখন বন্ধ করে দেওয়া হয়েছে। (I0c459, I92c8f, b/276989796)
API-তে পরিবর্তন
- নতুন API-তে মাইগ্রেশন সহজ করতে,
LazyListScope-এitemsএবংitemsIndexedএক্সটেনশন ফাংশন এখনcontentTypeপ্যারামিটারকে সাপোর্ট করে, যা নতুন API-তে সাপোর্টকে মিরর করে। (Ib1918, b/255283378)
ডিপেন্ডেন্সি আপডেট
- পেজিং কম্পোজ, কম্পোজ ১.০.৫ থেকে কম্পোজ ১.২.১-এ এর ডিপেন্ডেন্সি আপডেট করেছে। (Ib1918, b/255283378)
Version 1.0.0-alpha18
৮ ফেব্রুয়ারি, ২০২৩
androidx.paging:paging-compose:1.0.0-alpha18 কোনও পরিবর্তন ছাড়াই রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha18-এ এইসব কমিট রয়েছে।
ভার্সন 1.0.0-alpha17
২৪ অক্টোবর, ২০২২
androidx.paging:paging-compose:1.0.0-alpha17 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha17-এ এইসব কমিট রয়েছে।
নতুন ফিচার
collectLazyPagingItems-এ কল করার সময় কাস্টমCoroutineContext-এর জন্য সহায়তা যোগ করুন। (I7a574, b/243182795, b/233783862)
ভার্সন 1.0.0-alpha16
১০ আগস্ট, ২০২২
androidx.paging:paging-compose:1.0.0-alpha16 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha16-এ এইসব কমিট রয়েছে।
নতুন ফিচার
- PagingData থেকে সংগ্রহ করা ডিবাগিং তথ্য প্রকাশ করার জন্য পেজিং এখন
LazyPagingItemsক্লাসের মাধ্যমে লগ প্রদান করে। adb shellকমান্ডadb shell setprop log.tag.Paging [DEBUG|VERBOSE]-এর মাধ্যমে লগ চালু করা যেতে পারে। ([b/235527159}(https://issuetracker.google.com/issues/235527159))
ত্রুটি সমাধান
paging-common:3.1.1বা তার আগের ভার্সনের সাথেpaging-compose:1.0.0-alpha15ব্যবহার করার সময়PagingDataDifferকনস্ট্রাক্টর না থাকার সমস্যা সমাধান করা হয়েছে।(b/235256201,b/239868768)
Version 1.0.0-alpha15
১ জুন, ২০২২
androidx.paging:paging-compose:1.0.0-alpha15 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha15-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
PagingDataAdapterএবংAsyncPagingDataDiffer-এর জন্য কনস্ট্রাক্টর যোগ করা হয়েছে যাCoroutineDispatcher-এর পরিবর্তেCoroutineContextগ্রহণ করে। (Idc878)
ত্রুটি সমাধান
LazyPagingItemsএখনLoadState.Loadingরিফ্রেশ করার জন্য প্রাথমিকloadStateসেট করে। (I55043, b/224855902)
ভার্সন 1.0.0-alpha14
১৩ অক্টোবর, ২০২১
androidx.paging:paging-compose:1.0.0-alpha14 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha14-এ এইসব কমিট রয়েছে।
Version 1.0.0-alpha13
২৯ সেপ্টেম্বর, ২০২১
androidx.paging:paging-compose:1.0.0-alpha13 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha13-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
LazyPagingItems.snapshot()ফাংশন পরিবর্তন করেLazyPagingItems.itemSnapshotListপ্রপার্টি (Ie2da8) করা হয়েছে- বন্ধ করে দেওয়া
LazyPagingItems.getAsState()সরানো হয়েছে (Ie65e4)
ভার্সন 1.0.0-alpha12
২১ জুলাই, ২০২১
androidx.paging:paging-compose:1.0.0-alpha12 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha12-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
items(lazyPagingItems)এবংitemsIndexed(lazyPagingItems)যাLazyColumn/Row-এর সাথে পেজিং কানেক্ট করতে ব্যবহার করা হয়, এখন বিকল্প কী প্যারাম গ্রহণ করে যা আপনাকে আইটেমটি উপস্থাপনকারী একটি স্টেবল কী নির্দিষ্ট করার অনুমতি দেয়। আপনি এখান থেকে 'কী' সম্পর্কে আরও জানতে পারবেন। (I7986d)lazyPagingItems.getAsState(index)ফাংশন এখন বন্ধ করে দেওয়া হয়েছে। পরিবর্তেlazyPagingItems[index]ব্যবহার করুন। (I086cb, b/187339372)
Version 1.0.0-alpha11
৩০ জুন, ২০২১
androidx.paging:paging-compose:1.0.0-alpha11 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha11-এ এইসব কমিট রয়েছে।
Version 1.0.0-alpha10
২ জুন, ২০২১
androidx.paging:paging-compose:1.0.0-alpha10 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha10-এ এইসব কমিট রয়েছে।
ভার্সন 1.0.0-alpha09
১৮ মে, ২০২১
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
২৪ ফেব্রুয়ারি, ২০২১
androidx.paging:paging-compose:1.0.0-alpha08 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha08-এ এইসব কমিট রয়েছে।
Compose 1.0.0-beta01-এর সাথে ইন্টিগ্রেট করার জন্য আপডেট করা হয়েছে।
ভার্সন 1.0.0-alpha07
১০ ফেব্রুয়ারি, ২০২১
androidx.paging:paging-compose:1.0.0-alpha07 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha07-এ এইসব কমিট রয়েছে।
Compose alpha12-এর সাথে ইন্টিগ্রেট করার জন্য আপডেট করা হয়েছে।
ভার্সন 1.0.0-alpha06
২৮ জানুয়ারি, ২০২১
androidx.paging:paging-compose:1.0.0-alpha06 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha06-এ এইসব কমিট রয়েছে।
ত্রুটি সমাধান
Compose 1.0.0-alpha11-এর উপর নির্ভর করার জন্য আপডেট করা হয়েছে।
ভার্সন 1.0.0-alpha05
১৩ জানুয়ারি, ২০২১
androidx.paging:paging-compose:1.0.0-alpha05 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha05-এ এইসব কমিট রয়েছে।
Compose 1.0.0-alpha10-এর উপর নির্ভর করার জন্য আপডেট করা হয়েছে।
ভার্সন 1.0.0-alpha04
১৬ ডিসেম্বর, ২০২০
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
২ ডিসেম্বর, ২০২০
androidx.paging:paging-compose:1.0.0-alpha03 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha03-এ এইসব কমিট রয়েছে।
- Compose 1.0.0-alpha08-এর সাথে ম্যাচ করার জন্য আপডেট করা হয়েছে।
Version 1.0.0-alpha02
১১ নভেম্বর ২০২০
androidx.paging:paging-compose:1.0.0-alpha02 রিলিজ করা হয়েছে। ভার্সন 1.0.0-alpha02-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
LazyPagingItem-এ.peek(),.snapshot(),.retry()এবং.refresh()পদ্ধতি যোগ করা হয়েছে যাAsyncPagingDataDiffer/PagingDataAdapter-এ উপলভ্য একই কার্যকারিতা প্রকাশ করে (Iddfe8, b/172041660)
ভার্সন 1.0.0-alpha01
২৮ অক্টোবর, ২০২০
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
২১ জুলাই, ২০২১
androidx.paging:paging-*:3.0.1 রিলিজ করা হয়েছে। ভার্সন 3.0.1-এ এইসব কমিট রয়েছে।
ত্রুটি সমাধান
LivePagedListবাRxPagedList-এর মাধ্যমে তৈরি করা প্রাথমিক ভ্যালু থেকেPagedList.dataSourceঅ্যাক্সেস করার সময় আর ভুল করে IllegalStateException (I96707) দেখাবে না
ভার্সন 3.0.0
ভার্সন 3.0.0
৫ মে, ২০২১
androidx.paging:paging-*:3.0.0 রিলিজ করা হয়েছে। ভার্সন 3.0.0-এ এইসব কমিট রয়েছে।
3.0.0-এর প্রধান ফিচার
Paging 2.x.x-এর বেশিরভাগ API-এর ব্যবহার বন্ধ করে দেওয়া হয়েছে এবং তার পরিবর্তে নতুন Paging 3 API নিয়ে আসা হয়েছে যাতে নিম্নলিখিত উন্নতিগুলি করা যায়:
- Kotlin Coroutines ও Flow-এর জন্য ফার্স্ট-ক্লাস সাপোর্ট
- বাতিল করার জন্য সহায়তা
- বিল্ট-ইন লোড স্টেট ও সমস্যা সংক্রান্ত সিগন্যাল
- আবার চেষ্টা করুন + রিফ্রেশ করার কার্যকারিতা
- তিনটি DataSource সাবক্লাসকে একটি ইউনিফায়েড PagingSource ক্লাসে একত্রিত করা হয়েছে
- বিভাজক যোগ করার জন্য বিল্ট-ইন সহ কাস্টম পৃষ্ঠা ট্রান্সফর্মেশন
- স্টেট হেডার ও ফুটার লোড করা হচ্ছে
ভার্সন 3.0.0-rc01
২১ এপ্রিল, ২০২১
androidx.paging:paging-*:3.0.0-rc01 রিলিজ করা হয়েছে। ভার্সন 3.0.0-rc01-এ এইসব কমিট রয়েছে।
ত্রুটি সমাধান
- একটি সমস্যার সমাধান করা হয়েছে যেখানে পেজিং কখনও কখনও RecyclerView-তে নো-অপ ডিফার ইভেন্ট পাঠাত, যার ফলে নির্দিষ্ট কিছু লিসেনার আগে ট্রিগার হতে পারত। (Ic507f, b/182510751)
ভার্সন 3.0.0-beta03
২৪ মার্চ, ২০২১
androidx.paging:paging-*:3.0.0-beta03 রিলিজ করা হয়েছে। ভার্সন 3.0.0-beta03-এ এইসব কমিট রয়েছে।
ত্রুটি সমাধান
- RecyclerView-এ অপ্রত্যাশিত জাম্প প্রতিরোধ করার জন্য তালিকা রিলোড করা হলে প্লেসহোল্ডারগুলি কীভাবে পরিচালনা করা হয় তা আমরা নতুন করে সাজিয়েছি। আরও বিবরণের জন্য NullPaddedDiffing.md দেখুন। (If1490, b/170027529, b/177338149)
.build()কল করা হলে বিভিন্ন PagedList বিল্ডার (পুরনো কম্প্যাটিবিলিটি পাথ) আর ভুলভাবে সিঙ্ক্রোনাস পদ্ধতিতে মেন থ্রেডেDataSource.Factory.create()কল করে না। (b/182798948)
ভার্সন 3.0.0-beta02
১০ মার্চ, ২০২১
androidx.paging:paging-*:3.0.0-beta02 রিলিজ করা হয়েছে। ভার্সন 3.0.0-beta02-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
- Rx3 এক্সটেনশন এখন সঠিকভাবে
@ExperimentalCoroutinesApiঅপ্ট-ইন সংক্রান্ত প্রয়োজনীয়তা প্রচার করে। আগে সেগুলি@getপদ্ধতিতে চিহ্নিত করা হয়েছিল, যা Kotlin কম্পাইলার উপেক্ষা করে, কারণ: https://youtrack.jetbrains.com/issue/KT-45227 (I5733c)
ত্রুটি সমাধান
- এক্সপেরিমেন্টাল API-এর পাবলিক ব্যবহারের উপর বিধিনিষেধ প্রয়োগ করুন (I6aa29, b/174531520)
- রিমোট রিফ্রেশ কল করা হলে,
PagingStateসবসময়nullহওয়ার কারণ সম্পর্কিত সমস্যার সমাধান করা হয়েছে। - PagingSource-এর মাধ্যমে খালি পৃষ্ঠা ফেরত দেওয়ার ফলে
prefetchDistanceপূরণ করার জন্য Paging আবার ফেচ করতে পারছিল না এবং এর ফলে Paging "আটকে" যাচ্ছিল। এই সমস্যার সমাধান করা হয়েছে।
ভার্সন 3.0.0-beta01
১০ ফেব্রুয়ারি, ২০২১
androidx.paging:paging-*:3.0.0-beta01 রিলিজ করা হয়েছে। ভার্সন 3.0.0-beta01-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
- Rx2 এবং Rx3 র্যাপার এখন পরীক্ষামূলক অ্যানোটেশন প্রকাশ করে যার উপর এটি
নির্ভর করে। আপনি যদি paging-rxjava2 বা paging-rxjava3-তে Rx কম্প্যাট র্যাপার ব্যবহার করেন, তাহলে আপনাকে এখন
@OptIn(ExperimentalCoroutinesApi::class)(Ib1f9d) ব্যবহার করে অ্যানোটেট করতে হবে
ত্রুটি সমাধান
- কম্প্যাটিবিলিটি পাথের মাধ্যমে v2
DataSourceAPI ব্যবহার করার সময় কখনও কখনওIndexOutOfBoundsException: Inconsistency detectedথ্রো করা হয়, এই সমস্যার সমাধান করা হয়েছে isInvalidকল,DataSource-এর ইনিশিয়ালাইজেশনের সময়, যখন কম্প্যাটিবিলিটি পাথের মাধ্যমে ব্যবহার করা হয়, এখন মেন থ্রেডের পরিবর্তে fetchDispatcher-এ সঠিকভাবে লঞ্চ করা হয়। রুমেরPagingSourceইমপ্লিমেন্টেশন ব্যবহার করার সময় প্রধান থ্রেডে Db অ্যাক্সেসের কারণে হওয়াIllegalStateExceptionএটি সমাধান করে।
Version 3.0.0-alpha13
২৭ জানুয়ারি, ২০২১
androidx.paging:paging-*:3.0.0-alpha13 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha13-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
PagingSource.getRefreshKeyপ্রয়োগ করা আর ঐচ্ছিক নয়, এটি এখন ডিফল্ট প্রয়োগ ছাড়াই একটি অ্যাবস্ট্রাক্ট ফাংশন। মাইগ্রেট করা ব্যবহারকারীরা ডিফল্ট ইমপ্লিমেন্টেশন ফিরিয়ে দেওয়া চালিয়ে যেতে পারেন, যা শুধুnullফিরিয়ে দেয়, কিন্তুgetRefreshKey()-এর একটি আসল ইমপ্লিমেন্টেশন থাকা উচিত যা ব্যবহারকারীর বর্তমান স্ক্রল পজিশনের উপর ভিত্তি করে একটি কী ফিরিয়ে দেয়, যা সম্ভব হলেPagingState.anchorPosition-এর মাধ্যমে ভিউ পোর্টকে কেন্দ্র করে পেজিং লোড করা চালিয়ে যেতে দেয়। (I4339a)InvalidatingPagingSourceFactoryএখন একটি ফাইনাল ক্লাস (Ia3b0a)- টার্মিনাল সেপারেটর (হেডার / ফুটার) কনফিগার করার অনুমতি দিন
অতিরিক্ত ঐচ্ছিক SeparatorType প্যারামিটার সহ আচরণ। দুটি
বিকল্প হল:
FULLY_COMPLETE- বর্তমান আচরণ; টার্মিনাল সেপারেটর যোগ করার আগে endOfPaginationReached চিহ্নিত করার জন্য PagingSource এবং RemoteMediator উভয়ের জন্য অপেক্ষা করুন। RemoteMediator ব্যবহার না করা হলে, রিমোট loadState এড়িয়ে যাওয়া হয়। আপনি যদি শুধুমাত্র বিভাগ বিভাজক দেখাতে চান, তাহলে এটি প্রাথমিকভাবে উপযোগী বিভাগটি সম্পূর্ণরূপে লোড হলে, রিমোট সোর্স থেকে আনা সহ যেমন, নেটওয়ার্ক।SOURCE_COMPLETE- RemoteMediator ব্যবহার করা হলেও, endOfPaginationReached চিহ্নিত করার জন্য শুধুমাত্র PagingSource-এর জন্য অপেক্ষা করুন। এটি প্রাথমিক লোডের সাথে হেডার এবং ফুটারকে সিঙ্ক্রোনাসভাবে উপস্থাপন করার অনুমতি দেয়, যা ব্যবহারকারীদের টার্মিনাল বিভাজক দেখতে স্ক্রোল করার প্রয়োজনীয়তা প্রতিরোধ করে। (Ibe993, b/174700218)
ত্রুটি সমাধান
- বিরল মেমরি লিক সংক্রান্ত সমস্যার সমাধান করা হয়েছে, PageFetcher, PagingSource থেকে লোড করা শুরু করার আগেই PagingSource বাতিল হয়ে গেলে এই সমস্যা হয়। (I9606b, b/174625633)
ভার্সন 3.0.0-alpha12
১৩ জানুয়ারি, ২০২১
androidx.paging:paging-*:3.0.0-alpha12 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha12-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
- InvalidatingPagingSourceFactory আর অ্যাবস্ট্রাক্ট ক্লাস নয় কারণ এতে কখনও কোনও অ্যাবস্ট্রাক্ট পদ্ধতি ছিল না। (I4a8c4)
- .cachedIn()-এর একটি ওভারলোড যোগ করা হয়েছে যা জাভা ব্যবহারকারীদের জন্য লাইফসাইকেল বা CoroutineScope-এর পরিবর্তে ViewModel গ্রহণ করে। (I97d81, b/175332619)
- ট্রান্সফর্ম অপারেটর আর্গুমেন্টে এক্সিকিউটর গ্রহণ করার মাধ্যমে, জাভা কলারদের অ্যাসিঙ্ক উপায়ে PagingData ট্রান্সফর্ম অপারেশন ব্যবহার করার অনুমতি দিন। এখন সব -Sync ট্রান্সফর্ম অপারেটর থেকে -Sync সাফিক্স
সরিয়ে দেওয়া হয়েছে এবং Kotlin Coroutine ব্যবহারকারীদের
এক্সটেনশন ফাংশন কল করে অস্পষ্টতা দূর করতে হবে, যা সাসপেন্ডিং ব্লক গ্রহণ করে।
সব PagingData ট্রান্সফর্মেশন অপারেটর স্ট্যাটিক PagingDataTransforms ক্লাসের
অধীনে এক্সটেনশনে সরানো হয়েছে। Java ব্যবহারকারীদের
স্ট্যাটিক হেল্পারের মাধ্যমে কল করতে হবে, যেমন,
PagingDataTransforms.map(pagingData, transform)Kotlin ব্যবহারকারীদের ক্ষেত্রে সিনট্যাক্স একই, তবে আপনাকে ফাংশন ইমপোর্ট করতে হবে। (If6885, b/172895919)
ত্রুটি সমাধান
- পেজিনেশনের শেষে পৌঁছে গেলে
adapter.refresh()-এর সময়RemoteMediator.load()কল না হওয়ার সমস্যা সমাধান করা হয়েছে।
ভার্সন 3.0.0-alpha11
১৬ ডিসেম্বর, ২০২০
androidx.paging:paging-*:3.0.0-alpha11 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha11-এ এইসব কমিট রয়েছে।
নতুন ফিচার
- নিম্নলিখিত প্রাথমিক ব্যবহারের ক্ষেত্রে সেভ করা স্টেট সাপোর্ট যোগ করা হয়েছে (সম্পূর্ণ সাপোর্ট, বিশেষ করে লেয়ার্ড সোর্স কেসের ক্ষেত্রে এখনও কাজ চলছে):
- ফ্লো ক্যাশে করা হয়েছে এবং অ্যাপ্লিকেশন বন্ধ করা হয়নি (যেমন, ফ্লো ভিউ মডেলে ক্যাশে করা হয়েছে এবং প্রসেসে অ্যাক্টিভিটি আবার তৈরি করা হয়েছে)
- পেজিং সোর্স গণনা করা হয়, প্লেসহোল্ডার চালু করা থাকে এবং লেআউট স্ট্যাগার করা থাকে না।
API-তে পরিবর্তন
PagingSource.getRefreshKey()এখন স্টেবল API (I22f6f, b/173530980)PagingSource.invalidateআর কোনও ওপেন ফাংশন নয়। ইনভ্যালিডেশন হলে আপনি যদি বিজ্ঞপ্তি পেতে চান, তাহলে ইনভ্যালিডেট ওভাররাইড করার পরিবর্তে registerInvalidatedCallback পদ্ধতি কল করার কথা বিবেচনা করুন। (I628d9, b/173029013, b/137971356)- Pager-এ এখন তার রেগুলার কনস্ট্রাক্টরের পাশাপাশি একটি একক পরীক্ষামূলক কনস্ট্রাক্টর রয়েছে, অপ্ট-ইন অ্যানোটেশনের মাধ্যমে পরীক্ষামূলক API-কে অ-পরীক্ষামূলক পাবলিক API-তে লিক করার পরিবর্তে। (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 পরীক্ষা করেন, তাহলে
pageSizePagingConfig.pageSize-এর সাথে নাও মিলতে পারে, যদি আপনিinitialLoadSize-ও সেট করেন। আপনার টেস্টের জন্য এটি গুরুত্বপূর্ণ হলে, এর পরিবর্তে Pager/PagedList ব্যবহার করে দেখুন যা ইন্টার্নালি আপনার DataSource লোড পদ্ধতির জন্য সঠিক PageSize সেট করবে। (I98ac7, b/149157296)
ত্রুটি সমাধান
- PagingConfig.maxSize সেট করা অবস্থায় সেপারেটর ব্যবহার করার সময় IllegalStateException-এর কারণে হওয়া ক্র্যাশ সংক্রান্ত সমস্যার সমাধান করা হয়েছে। (I0ed33, b/174787528)
- RemoteMediator সেট করা থাকলে, প্রাথমিক লোডের ঠিক পরেই PREPEND / APPEND-এর জন্য লোড স্টেট
NotLoading(endOfPaginationReached = true)-এ আপডেট না হওয়ার সমস্যার সমাধান করা হয়েছে (I8cf5a) - একটি সমস্যার সমাধান করা হয়েছে যেখানে .snapshot(), .peek() ইত্যাদির মতো প্রেজেন্টার-সাইড API, ListUpdateCallback আপডেটের মধ্যে আগের (পুরনো) তালিকা ফিরিয়ে দিত।
- RemoteMediator-এর সাথে ব্যবহার করার সময় Separators অপারেটর হেডার বা ফুটার যোগ করতে না পারার সমস্যা সমাধান করা হয়েছে
- RemoteMediator-এর জন্য LoadState আপডেট হয়ে NotLoading হয়ে যাওয়ার সময় Loading স্ট্যাটাসে আটকে যাওয়ার সমস্যা সমাধান করা হয়েছে
- Paging2.0 কম্প্যাটিবিলিটি API,
.asPagingSourceFactory(), ভুল CoroutineDispatcher-এ ব্যাকিংDataSourceইনিশিয়ালাইজ করার কারণ হতে পারে এমন একটি সমস্যার সমাধান করা হয়েছে। এটি ক্র্যাশ এবং সম্ভাব্য ANR কেস সমাধান করে, বিশেষ করে যখন রুমের বর্তমান PagingSource-এর ইমপ্লিমেন্টেশন ব্যবহার করা হয়, যা এই কম্প্যাটিবিলিটি পাথ ব্যবহার করে।
ভার্সন 3.0.0-alpha10
২ ডিসেম্বর, ২০২০
androidx.paging:paging-*:3.0.0-alpha10 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha10-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
বন্ধ হয়ে যাওয়া
dataRefreshFlowএবংdataRefreshListenerAPI সরিয়ে দেওয়া হয়েছে কারণ 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()API আছে যা এটি থেকে নির্গত সমস্ত PagingSources-এ ইনভ্যালিডেট ফরওয়ার্ড করে। @claraf3-কে ধন্যবাদ! (Ie71fc, b/160716447)
পরিচিত সমস্যা
- RemoteMediator b/172254056 ব্যবহার করার সময় .insertSeparators() ট্রান্সফর্ম থেকে হেডার ও ফুটার সাথে সাথে নাও দেখা যেতে পারে
- RemoteMediator ব্যবহার করলে রিমোট
LoadStateআটকে যেতে পারে যদিRemoteMediator.load()রিটার্ন করার আগে ইনভ্যালিডেশন এবংPagingSource.load(LoadParams.Refresh(...))সম্পূর্ণ হয় b/173717820
ভার্সন 3.0.0-alpha09
১১ নভেম্বর ২০২০
androidx.paging:paging-*:3.0.0-alpha09 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha09-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
- replaceWith ক্লজ সহ dataRefreshFlow / Listener পদ্ধতি সম্পূর্ণভাবে বাতিল করুন। (I6e2dd)
ত্রুটি সমাধান
- RemoteMediator-এর সাথে সেপারেটর ব্যবহার করার সময়
IllegalArgumentExceptionথ্রো হওয়ার সমস্যার সমাধান এবং রিমোট লোড যা endOfPagination রিটার্ন করবে তা এখনও চলছে (I3a260) এমন সময় একটি ইনভ্যালিডেট ট্রিগার করা হয়েছে
ভার্সন 3.0.0-alpha08
২৮ অক্টোবর, ২০২০
androidx.paging:paging-*:3.0.0-alpha08 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha08-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
DataSource.InvalidatedCallback-এর Kotlin / Java ভেরিয়েন্ট ফাংশনাল ইন্টারফেসের (Kotlin 1.4-এ উপলভ্য) মাধ্যমে Kotlin-এ SAM-কনভার্সন চালু করে একত্রিত করা হয়েছে। এটি এমন একটি সমস্যারও সমাধান করে যেখানে.mapবা.mapByPageদ্বারা রূপান্তরিত হওয়ার পরে ইনভ্যালিডেট কলব্যাকের কোটলিন ভেরিয়েন্ট কল করা হয়নি। (I1f244, b/165313046)
ত্রুটি সমাধান
- ViewPager-এর সাথে পেজিংয়ের ইন্টার্যাকশন উল্লেখযোগ্যভাবে উন্নত করা হয়েছে। বিশেষ করে, পেজ অবৈধ হওয়ার কারণে পেজিং আর
RemoteMediator#loadকল বাতিল করবে না। এছাড়াও, এটি আর কোনও অ্যাপেন্ড/প্রিপেন্ড লোড অনুরোধ করবে না, যদি REFRESH-এর প্রয়োজন হয়, যতক্ষণ না REFRESH অনুরোধ সফলভাবে সম্পূর্ণ হয়। (I6390b, b/162252536) - MissingGetterMatchingBuilder-এর জন্য API লিন্ট চেক androidx-এর জন্য চালু করা হয়েছে (I4bbea, b/138602561)
- ব্যাকগ্রাউন্ড থ্রেড থেকে RecyclerView-কে বিজ্ঞপ্তি পাঠানোর কারণে
.withLoadState*ConcatAdapterহেল্পার ক্র্যাশ করার সমস্যা সমাধান করা হয়েছে (I18bb5, b/170988309) - একটি সমস্যার সমাধান করা হয়েছে যেখানে খুব ছোট খালি নয় এমন পৃষ্ঠা লোড করার সময় কখনও কখনও প্রিফেচ সঠিকভাবে লোড ট্রিগার করতে বাধা দেয়।Iffda3 b/169259468
ভার্সন 3.0.0-alpha07
১ অক্টোবর, ২০২০
androidx.paging:paging-*:3.0.0-alpha07 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha07-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
- Async PagingData Guava-ভিত্তিক অপারেটর এখন এক্সিকিউশন কন্টেক্সট কন্ট্রোল করার জন্য প্যারামিটার হিসেবে Executor গ্রহণ করে। (Id4372)
ত্রুটি সমাধান
- রেস কন্ডিশনের কারণে RemoteMediator-এ IndexOutOfBounds এক্সেপশন থ্রো করার সমস্যা সমাধান করা হয়েছে। (I00b7f, b/165821814)
- DataSource -> PagingSource কনভার্সনে রেস কন্ডিশন সংক্রান্ত সমস্যার সমাধান করা হয়েছে, যার ফলে PagingSource, DataSource থেকে আসা ইনভ্যালিডেশন সিগন্যাল উপেক্ষা করতে পারে।
- পেজ ফেচিং লজিকে একটি সমস্যার সমাধান করা হয়েছে যা কখনও কখনও PagingDataAdapter.refresh() চালু না হওয়া পর্যন্ত PagingSource-এর নতুন জেনারেশন বেছে নিতে ব্যর্থ হয়
- RemoteMediator-এর সাথে PagingSource-এ (যেমন, Room-এর মাধ্যমে তৈরি করা) কনভার্ট করা DataSource ব্যবহার করার সময় স্ক্রল-পজিশন কখনও কখনও হারিয়ে যাওয়ার সমস্যা সমাধান করা হয়েছে
এক্সটার্নাল কন্ট্রিবিউশন
- PagingData-এর জন্য RxJava2, RxJava3 এবং Guava-ভিত্তিক অ্যাসিঙ্ক ট্রান্সফর্মেশন অপারেটর যোগ করার জন্য @simonschiller-কে ধন্যবাদ!
ভার্সন 3.0.0-alpha06
২ সেপ্টেম্বর, ২০২০
androidx.paging:paging-*:3.0.0-alpha06 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha06-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
UnsupportedOperationException-এর সাথে আরও স্পষ্ট মেসেজ স্টেবল আইডির জন্য সহায়তার অভাব এখন যখনইPagingDataAdapter.setHasStableIdsকল করা হয় তখনই থ্রো করা হয়। (Ib3890, b/158801427)
ত্রুটি সমাধান
- insertSeparators আর খালি পৃষ্ঠা ফিল্টার করে না, যার ফলে প্রেজেন্টার প্রিফেচ দূরত্ব মেনে চলতে পারে, এমনকি অনেক খালি পৃষ্ঠা যোগ করা হলেও। (I9cff6, b/162538908)
ভার্সন 3.0.0-alpha05
১৯ আগস্ট, ২০২০
androidx.paging:paging-*:3.0.0-alpha05 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha05-এ এইসব কমিট রয়েছে।
ত্রুটি সমাধান
- প্রেজেন্ট করা ডেটা অনেক বেশি ফিল্টার করা থাকলেও, পেজিং এখন সঠিকভাবে পেজ প্রিফেচ করে
- আবার চেষ্টা করা লোডে
LoadResult.Errorরিটার্ন করার ফলে আইটেম অ্যাক্সেস আর ভুলভাবে আবার চেষ্টা করার ট্রিগার করে না
এক্সটার্নাল কন্ট্রিবিউশন
- কিছু টেস্ট ক্লিন আপ করতে সাহায্য করার জন্য Clara F-কে ধন্যবাদ! (549612)
ভার্সন 3.0.0-alpha04
৫ আগস্ট, ২০২০
androidx.paging:paging-*:3.0.0-alpha04 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha04-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
AsyncPagingDataDiffer-এpeek()API এবংPagingDataAdapterযোগ করা হয়েছে যাতে ট্রিগার পৃষ্ঠা লোড না করেই দেখানো ডেটা অ্যাক্সেস করার অনুমতি দেওয়া যায়। (I38898, b/159104197)PagingDataAdapter-এsnapshot()API যোগ করা হয়েছে এবংAsyncPagingDataDiffer-এ পৃষ্ঠা ফেচ ট্রিগার না করেই দেখানো আইটেম ফিরিয়ে আনার অনুমতি দেওয়া হয়েছে। (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)
ত্রুটি সমাধান
PositionalDataSource-কেPagingSource-এ কনভার্ট করা হয়েছেtoPagingSourceFactoryহেল্পারের মাধ্যমে, যার মধ্যে Room-এর মাধ্যমে জেনারেট করাPagingSourceঅন্তর্ভুক্ত এখন জাম্পিং সাপোর্ট করার জন্য নিজেকে সঠিকভাবে চিহ্নিত করে। (I3e84c, b/162161201)- submitData-এর সিঙ্ক্রোনাস ভেরিয়েন্ট ব্যবহার করার সময়
কখনও কখনও রেস কন্ডিশন তৈরি হওয়ার ফলে
ClosedSendChannelException(I4d702, b/160192222) হওয়ার সমস্যা সমাধান করা হয়েছে
এক্সটার্নাল কন্ট্রিবিউশন
- Slack-এর হয়ে RxJava3 কম্প্যাটিবিলিটি র্যাপার যোগ করার জন্য জ্যাক সুইয়ার্সকে ধন্যবাদ! (I49ef3, b/161480176)
ভার্সন 3.0.0-alpha03
২২ জুলাই, ২০২০
androidx.paging:paging-*:3.0.0-alpha03 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha03-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
- PagingState-এর কনস্ট্রাক্টর এখন সর্বজনীন, যা getRefreshKey() (I8bf15) প্রয়োগ করার সময় টেস্টিং আরও সহজ করে তোলে
- Java থেকে DataSource kotlin ম্যাপ ফাংশন ভেরিয়েন্ট লুকানো হয়েছে, যাতে আসল ও kotlin ভেরিয়েন্টের মধ্যে অস্পষ্টতা দূর করা যায়। (If7b23, b/161150011)
- Kotlin ব্যবহারকারীদের সুবিধার জন্য তৈরি করা অপ্রয়োজনীয় API-কে @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)
- Fixes an issue where item accesses after dropping a page might not load pages although the item access was within prefetchDistance (Ie95ae, b/160038730)
- ড্রপ ইভেন্টের পরে PagingConfig.maxSize সেট করলে আর প্লেসহোল্ডার চালু হয় না (I2be29, b/159667766)
ভার্সন 3.0.0-alpha02
২৪ জুন, ২০২০
androidx.paging:paging-*:3.0.0-alpha02 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha02-এ এইসব কমিট রয়েছে।
API-তে পরিবর্তন
- সাধারণ ডিফল্ট ভ্যালু সহ
PagingConfig-এর কনস্ট্রাক্টরের জন্য ওভারলোড যোগ করা হয়েছে (I39c50, b/158576040) - সাধারণ ডিফল্ট ভ্যালু (Ie91f5) সহ
PagingDataAdapterএবংAsyncPagingDataDiffer-এর কনস্ট্রাক্টরের জন্য ওভারলোড যোগ করা হয়েছে - অ্যাডাপ্টার API,
dataRefreshFlowএবংdataRefreshListenerএখন একটি বুলিয়ান পাস করে সিগন্যাল দেয় যেPagingDataখালি আছে কিনা (I6e37e, b/159054196) - RemoteMediator-এর জন্য RxJava এবং Guava API যোগ করা হয়েছে - RxRemoteMediator এবং ListenableFutureRemoteMediator
isEmpty()এবংfirstItemOrNull()-এর মতো সাধারণ আইটেম অ্যাক্সেসের জন্য PagingState-এ হেল্পার যোগ করা হয়েছে (I3b5b6, b/158892717)
ত্রুটি সমাধান
- ভুল PagingSource যাতে ভুলবশত আবার ব্যবহার না করা হয়, তার জন্য পেজার এখন ফ্যাক্টরিতে PagingSource আবার ব্যবহার করা হচ্ছে কিনা তা চেক করে। ভুলবশত আবার ব্যবহার করা হলে, অস্পষ্ট সমস্যা (I99809, b/158486430) দেখা যেত
- RemoteMediator REFRESH-এর ব্যর্থতা আর PagingSource-কে লোড হতে বাধা দেয় না (I38b1b, b/158892717)
submitData-এর সাসপেন্ডিং ভার্সন কল করার পরে, একাধিকPagingData-এ একই সাথে কালেকশনের কারণেsubmitData-এর নন-সাসপেন্ডিং ভার্সন আর ক্র্যাশ করে না। (I26358, b/158048877)- "পেজার থেকে দুবার সংগ্রহ করা যাবে না" সংক্রান্ত ব্যতিক্রমী সমস্যা সমাধান করা হয়েছে যা কনফিগারেশন পরিবর্তনের পরে হতে পারে (I58bcc, b/158784811)
ভার্সন 3.0.0-alpha01
১০ জুন, ২০২০
androidx.paging:paging-*:3.0.0-alpha01 রিলিজ করা হয়েছে। ভার্সন 3.0.0-alpha01-এ এইসব কমিট রয়েছে।
পেজিং লাইব্রেরি 3.0-এ আপডেট করা হয়েছে, যাতে বেশ কিছু প্রধান নতুন ফিচার চালু করা যায়।
3.0-এর নতুন ফিচার
- Kotlin কোরুটিন ও Flow-এর জন্য ফার্স্ট-ক্লাস সহায়তা।
- coroutines suspend functions, RxJava Single বা Guava ListenableFuture primitives-এর সাথে অ্যাসিঙ্ক লোডিংয়ের জন্য সহায়তা।
- রেসপন্সিভ UI ডিজাইনের জন্য বিল্ট-ইন লোড স্টেট ও সমস্যার সিগন্যাল, যার মধ্যে আবার চেষ্টা করা ও রিফ্রেশ করার কার্যকারিতা অন্তর্ভুক্ত।
- রিপোজিটরি লেয়ারে করা উন্নতি
- ডেটা সোর্সের সহজ ইন্টারফেস
- সরলীকৃত নেটওয়ার্ক + ডেটাবেস পেজিনেশন
- বাতিল করার ব্যাপারে সহায়তা
- প্রেজেন্টেশন লেয়ারে করা উন্নতি
পরিচিত সমস্যা
- Paging 3 javadocs এখনও উপলভ্য নয়। ইতিমধ্যে, উপরে লিঙ্ক করা গাইড বা Kotlin ডকুমেন্ট ব্যবহার করুন। (b/158614050)
ভার্সন ২.১.২
ভার্সন ২.১.২
১৮ মার্চ, ২০২০
androidx.paging:paging:2.1.2 রিলিজ করা হয়েছে। ভার্সন 2.1.2-এ 2.1.0-এর তুলনায় এইসব কমিট রয়েছে।
ত্রুটি সমাধান
- ইনভ্যালিডেশনের সময় পজিশন কনভার্ট করার সময় বিরল ক্ষেত্রে
IndexOutOfBoundsException-এর জন্য সমাধান।
রিলিজ সংক্রান্ত সমস্যা
ভুলভাবে কনফিগার করা ব্রাঞ্চ থেকে পেজিং ভার্সন
2.1.1ভুলভাবে রিলিজ করা হয়েছে, যার ফলে আংশিকভাবে প্রয়োগ করা API এবং ভবিষ্যতে রিলিজ হতে চলা কার্যকারিতা প্রকাশ পেয়েছে।পেজিং
2.1.2-এ লোড-সেন্টারিং ফিক্স রয়েছে যা মূলত ২.১.১ ভার্সনে রিলিজ করা হয়েছিল, তবে এবার ২.১.০ রিলিজের উপরে সঠিকভাবে চেরি-পিক করা হয়েছে। আপনি বর্তমানে 2.1.1 ভার্সন ব্যবহার করলে, এই রিলিজে আপগ্রেড করার জন্য বিশেষভাবে সাজেস্ট করা হচ্ছে।
ভার্সন ২.১.১
ভার্সন ২.১.১
১৮ ডিসেম্বর, ২০১৯
androidx.paging:paging-*:2.1.1 রিলিজ করা হয়েছে। ভার্সন 2.1.1-এ এইসব কমিট আছে।
সমস্যার সমাধান
- প্লেসহোল্ডার বন্ধ করা থাকলে, PositionalDataSources থেকে সংলগ্ন প্রাথমিক লোড এখন শেষ অ্যাক্সেসের চারপাশে কেন্দ্রীভূত হয়
ভার্সন 2.1.0
ভার্সন 2.1.0
২৫ জানুয়ারি, ২০১৯
2.1.0-rc01 থেকে কোনও পরিবর্তন না করেই পেজিং 2.1.0 রিলিজ করা হয়েছে।
Version 2.1.0-rc01
৬ ডিসেম্বর, ২০১৮
2.1.0-beta01 থেকে কোনও পরিবর্তন না করেই পেজিং 2.1.0-rc01 রিলিজ করা হয়েছে।
Version 2.1.0-beta01
১ নভেম্বর, ২০১৮
2.1.0-alpha01 থেকে কোনও পরিবর্তন না করেই পেজিং 2.1.0-beta01 রিলিজ করা হয়েছে।
Version 2.1.0-alpha01
১২ অক্টোবর, ২০১৮
পেজিং 2.1.0-alpha01-এ দুটি প্রধান সংযোজন রয়েছে - পেজ ড্রপিং এবং প্রতিটি আর্টিফ্যাক্টের জন্য KTX এক্সটেনশন লাইব্রেরি - সেইসাথে অন্যান্য বেশ কয়েকটি API পরিবর্তন এবং বাগফিক্স।
API-তে পরিবর্তন
- মেমরিতে লোড করা আইটেমের সংখ্যা সীমিত করার জন্য
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 দেখানো হলে/হলে ট্রিগার করে। এটি আপনাকে অন্যান্য UI আপডেটের সাথে PagedList সোয়াপ সিঙ্ক করার অনুমতি দেয়। b/73781068- মেমরিতে কতগুলি আইটেম আছে তা আপনাকে জানাতে
PagedList.getLoadedCount()যোগ করা হয়েছে। মনে রাখবেন, প্লেসহোল্ডার বন্ধ করা থাকলে, রিটার্ন ভ্যালু সবসময়.size()-এর সমান হয়।
ত্রুটি সমাধান
- তালিকা আবার ব্যবহার করা হলে, ডিফারেন্সিয়েট করার সময় রেস কন্ডিশন সংক্রান্ত সমস্যার সমাধান করা হয়েছে b/111591017
- ইনডেক্স ভুল হলে
PagedList.loadAround()এখনIndexOutOfBoundsExceptionথ্রো করে। আগে এটি অস্পষ্ট অন্যান্য ব্যতিক্রমের সাথে ক্র্যাশ করতে পারত। - এমন একটি সমস্যার সমাধান করা হয়েছে যেখানে অত্যন্ত ছোট প্রাথমিক লোড সাইজ এবং অপরিবর্তিত ডেটার কারণে আর কোনও লোডিং হয় না b/113122599
ভার্সন 2.0.0
ভার্সন 2.0.0
১ অক্টোবর, ২০১৮
Paging 2.0.0 একটি বাগফিক্স সহ রিলিজ করা হয়েছে।
ত্রুটি সমাধান
PositionalDataSourceএবং প্লেসহোল্ডার b/114635383 ব্যবহার করে খুব দ্রুত স্ক্রল করার সময় যে ক্র্যাশ হতে পারত তা ঠিক করা হয়েছে।
ভার্সন 2.0.0-beta01
২ জুলাই, ২০১৮
ত্রুটি সমাধান
- কিছু প্রিপেন্ড কেসে কন্টেন্ট অদৃশ্য হয়ে যাওয়ার সমস্যা সমাধান করা হয়েছে (প্লেসহোল্ডার বন্ধ করা, PositionalDataSource) b/80149146
- (
1.0.1-এ আগেই রিলিজ করা হয়েছে) ক্র্যাশ সংক্রান্ত সমস্যার সমাধান করা হয়েছে যেখানেPagedListAdapterএবংAsyncPagedListDifferমুভ ইভেন্ট সিগন্যাল করতে ব্যর্থ হয়। b/110711937
AndroidX-এর আগের ডিপেন্ডেন্সি
পেজিংয়ের প্রি-AndroidX ভার্সনের জন্য, এই ডিপেন্ডেন্সি অন্তর্ভুক্ত করুন:
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
২৬ জুন, ২০১৮
runtime-এ একটিমাত্র বাগফিক্স সহ পেজিং 1.0.1 রিলিজ করা হয়েছে। আমরা আপনাকে 1.0.1 ব্যবহার করার জন্য বিশেষভাবে সাজেস্ট করি। Paging RxJava2 1.0.1-ও রিলিজ করা হয়েছে এবং এটি 1.0.0-rc1-এর মতোই।
ত্রুটি সমাধান
- ক্র্যাশ সংক্রান্ত সমস্যার সমাধান করা হয়েছে যেখানে
PagedListAdapterএবংAsyncPagedListDifferমুভ ইভেন্ট সিগন্যাল করতে ব্যর্থ হয়। b/110711937
RxJava2 ভার্সন 1.0.0
RxJava2 Version 1.0.0-rc1
১৬ মে, ২০১৮
পেজিং RxJava2 1.0.0-rc1 রিলিজ ক্যান্ডিডেটে সরানো হচ্ছে, প্রাথমিক আলফা থেকে কোনও পরিবর্তন করা হয়নি।
ভার্সন 1.0.0
ভার্সন 1.0.0-rc1
১৯ এপ্রিল, ২০১৮ পেজিং রিলিজ ক্যান্ডিডেট
Paging 1.0.0 রিলিজের জন্য আমাদের কাছে আর কোনও পরিচিত সমস্যা বা নতুন ফিচার শিডিউল করা নেই। 1.0.0-rc1 ব্যবহার করতে আপনার প্রোজেক্ট আপগ্রেড করুন এবং
এটি পরীক্ষা করতে আমাদের সাহায্য করুন যাতে আমরা একটি শক্তিশালী 1.0.0 শিপ করতে পারি।
এই রিলিজে কোনও পরিবর্তন করা হয়নি, এটি 1.0.0-beta1-এর মতোই।
ভার্সন 1.0.0-beta1
৫ এপ্রিল, ২০১৮
রিলিজ ক্যান্ডিডেট হিসেবে প্রকাশ করার আগে পেজিং অল্প সময়ের জন্য বিটা ভার্সনে থাকবে।
Paging 1.0-এর জন্য API-তে আর কোনও পরিবর্তন করার পরিকল্পনা আমাদের নেই এবং API-তে কোনও পরিবর্তন করার জন্য অনেক বেশি পরিশ্রম করতে হবে।
পেজিংয়ের জন্য 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()
জাভা
Observable<PagedList<Item>> pagedItems = RxPagedListBuilder(myDataSource, /* page size */ 50) .setFetchScheduler(myNetworkScheduler) .buildObservable();
নতুন ফিচার
- নতুন
android.arch.paging:rxjava2আর্টিফ্যাক্টের মাধ্যমেRxPagedListBuilderযোগ করা হয়েছে।
API-তে পরিবর্তন
বিল্ডারে এক্সিকিউটরের ভূমিকা স্পষ্ট করতে API-তে পরিবর্তন:
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
২১ মার্চ, ২০১৮
Lifecycles 1.1.1-এর সাথে Paging 1.0.0-alpha7 রিলিজ করা হয়েছে। যেহেতু পেজিং alpha7 উপরে উল্লেখ করা Function ক্লাসের মুভের উপর নির্ভর করে, তাই আপনাকে lifecycle:runtime ডিপেন্ডেন্সি আপডেট করে android.arch.lifecycle:runtime:1.1.1 করতে হবে।
পেজিং বিটাতে পৌঁছানোর আগে পেজিং alpha7-এর ফাইনাল রিলিজের পরিকল্পনা করা হয়েছে।
API-তে পরিবর্তন
DataSource.LoadParamsঅবজেক্টে এখন একটি পাবলিক কনস্ট্রাক্টর আছে এবংDataSource.LoadCallbackঅবজেক্ট এখন অ্যাবস্ট্রাক্ট। এটিDataSourceর্যাপ করা বা মক কলব্যাকের মাধ্যমে সরাসরিDataSourceপরীক্ষা করার সুবিধা দেয়। b/৭২৬০০৪২১- DataSource ও DataSource.Factory-এর জন্য ম্যাপার
map(Function<IN,OUT>)আপনাকেDataSource-এর মাধ্যমে লোড করা ফলাফল ট্রান্সফর্ম, র্যাপ বা সাজাতে দেয়।mapByPage(<List<IN>,List<OUT>>)ব্যাচ প্রসেসিংয়ের জন্য একই সুবিধা দেয় (যেমন, SQL থেকে লোড করা আইটেম যদি অতিরিক্তভাবে আলাদা ডেটাবেস কোয়েরি করতে চায়, তাহলে সেটি ব্যাচ হিসেবে করা যেতে পারে।)
PagedList#getDataSource()-কে একটি সুবিধাজনক পদ্ধতি হিসেবে যোগ করা হয়েছে b/72611341- API থেকে সব বাতিল করা ক্লাস সরিয়ে দেওয়া হয়েছে, যার মধ্যে
recyclerview.extensionsপ্যাকেজের অবশিষ্টাংশ এবংLivePagedListProviderঅন্তর্ভুক্ত। - ম্যাপের কার্যকারিতা চালু করতে
DataSource.Factoryইন্টারফেস থেকে অ্যাবস্ট্রাক্ট ক্লাসে পরিবর্তন করা হয়েছে।
ত্রুটি সমাধান
- Changed Builders to be final. b/70848565
- রুম
DataSource-এর ইমপ্লিমেন্টেশন এখন মাল্টি-টেবিল কোয়েরি ম্যানেজ করার জন্য ঠিক করা হয়েছে - এই সমাধান রুম 1.1.0-beta1-এর মধ্যে রয়েছে, উপরে দেখুন। - একটি সমস্যার সমাধান করা হয়েছে যেখানে প্লেসহোল্ডার চালু থাকলে এবং মোট সাইজ পৃষ্ঠা সাইজের সঠিক গুণিতক হলে
PositionalDataSource-এর জন্যBoundaryCallback.onItemAtEndLoadedকল করা হবে না।
ভার্সন 1.0.0-alpha5
২২ জানুয়ারি, ২০১৮
ত্রুটি সমাধান
- প্লেসহোল্ডার বন্ধ করা থাকলে পৃষ্ঠা লোড হওয়া সংক্রান্ত সমস্যার সমাধান করা b/70573345
- IllegalArgumentException বাগ b/70360195 (এবং অনুমানমূলক রুম-সাইড ফিক্স) ট্র্যাক করার জন্য অতিরিক্ত লগিং
- Javadoc স্যাম্পেল কোড ফিক্স b/70411933, b/71467637