পেজিং

পেজিং লাইব্রেরি আপনার অ্যাপের RecyclerView-এর মধ্যে ধীরে ধীরে এবং সুন্দরভাবে ডেটা লোড করা আপনার জন্য সহজ করে তোলে।

এই টেবিলে 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 যোগ করা হয়েছে।

  • asItemSnapshotListFlow API ব্যবহার করার সময় লোড সংক্রান্ত সমস্যা থেকে রিকভার করতে এক্সটেনশন ফাংশন 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>.asState API-এর নাম পরিবর্তন করে 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.prepend API যোগ করেছে।

    • paging-runtime বা paging-compose-এর সাথে ব্যবহার করা হলে, স্ক্রল করা ছাড়াও আরও ডেটা লোড করার বিকল্প প্রদান করে
    • নতুন asState API-এর সাথে ব্যবহার করা হলে, আরও ডেটা লোড করার এটিই একমাত্র উপায়
    LazyColumn {
    item {
           /**
           * Load more items when users scroll near the top of loaded items.
           */
           LaunchedEffect(viewModel) { viewModel.prepend() }
        }
    items(snapshot.items) { item -> Text("Item: $item") }
    item {
            /**
            * Load more items when users scroll near the bottom of loaded items.
            */
          LaunchedEffect(viewModel) { viewModel.append() }
      }
    }
    
  • asState API ব্যবহার করার সময় লোড সংক্রান্ত সমস্যা থেকে রিকভার করতে 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-এর জন্য সহায়তা সরিয়ে দিয়েছে।
  • টার্গেট পজিশনের সবচেয়ে কাছাকাছি থাকা এবং ইনপুট প্রেডিকেটের সাথে ম্যাচ করা লোড করা আইটেম ফিরিয়ে আনতে নতুন PagingState API closestItemAroundPosition যোগ করা হয়েছে। এটি আইটেম-ভিত্তিক রিফ্রেশ কী জেনারেট করতে ব্যবহার করা যেতে পারে যেখানে আদর্শ অ্যাঙ্করযোগ্য আইটেমটি আশেপাশে থাকে তবে সঠিক টার্গেট পজিশনে থাকে না।

ভার্সন 3.4.0-rc01

১৪ জানুয়ারি, ২০২৬

androidx.paging:paging-*:3.4.0-rc01 রিলিজ করা হয়েছে। 3.4.0-rc01 ভার্সনে এইসব কমিট রয়েছে।

নতুন ফিচার

ভার্সন 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-তে পরিবর্তন

  • টার্গেট পজিশনের সবচেয়ে কাছাকাছি থাকা এবং ইনপুট প্রেডিকেটের সাথে ম্যাচ করা লোড করা আইটেম ফিরিয়ে আনতে নতুন PagingState API closestItemAroundPosition যোগ করা হয়েছে। এটি আইটেম-ভিত্তিক রিফ্রেশ কী জেনারেট করতে ব্যবহার করা যেতে পারে যেখানে আদর্শ অ্যাঙ্করযোগ্য আইটেমটি আশেপাশে থাকে তবে সঠিক টার্গেট পজিশনে থাকে না। (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-তে পরিবর্তন

ভার্সন 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 ভার্সনে এইসব কমিট রয়েছে।

নতুন ফিচার

ত্রুটি সমাধান

  • 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-এ এইসব কমিট আছে।

ত্রুটি সমাধান

  • প্রাথমিক রিফ্রেশ করার সময় পাঠানো রিফ্রেশ ও আবার চেষ্টা করার সিগন্যাল এখন স্টোর করা হবে এবং পেজিং প্রেজেন্টার রেডি হয়ে গেলে অটোমেটিক আবার পাঠানো হবে।

এক্সটার্নাল কন্ট্রিবিউশন

  • Eva, ত্রুটি সমাধান (#754) জমা দেওয়ার জন্য ধন্যবাদ

ভার্সন 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 সব পেজিং ৩ API common-এ সরিয়ে নিয়ে গেছে এবং এখন 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 সব পেজিং ৩ API common-এ সরিয়ে নিয়ে গেছে এবং এখন 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)

এক্সটার্নাল কন্ট্রিবিউশন

ভার্সন 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 প্যারামিটারগুলি স্ট্যান্ডার্ড items API-তে প্রয়োগ করতে সাহায্য করে যা ইতিমধ্যেই LazyColumn, LazyVerticalGrid-এর জন্য বিদ্যমান এবং সেইসাথে HorizontalPager-এর মতো API-তে তাদের সমতুল্য।
    • items(lazyPagingItems) এবং itemsIndexed(lazyPagingItems) যা শুধুমাত্র LazyListScope-এ কাজ করে তা বন্ধ করা হয়েছে।
  • নতুন paging-testing আর্টিফ্যাক্ট যা আপনার অ্যাপের প্রতিটি লেয়ারের ইউনিট টেস্টিং এবং আইসোলেশনে পেজিংয়ের সাথে এর ইন্টিগ্রেশনের জন্য ডিজাইন করা API প্রদান করে। যেমন, এর মধ্যে অন্তর্ভুক্ত হল
    • TestPager ক্লাস যা আপনাকে পেজার এবং আসল UI থেকে স্বাধীনভাবে আপনার নিজস্ব কাস্টম PagingSource ইমপ্লিমেন্টেশনের আচরণ যাচাই করতে দেয়।
    • ​​asPagingSourceFactory API, Flow<List<Value>> বা স্ট্যাটিক List<Value>-কে PagingSourceFactory-এ পরিবর্তন করে যা টেস্টে পেজারে পাস করা যেতে পারে
    • Flow<PagingData<Value>>-এ asSnapshot Kotlin এক্সটেনশন, যা 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-testing API যোগ করা হয়েছে যা শুধুমাত্র ডেটার অপরিবর্তনীয় তালিকা থেকে লোড হয়। স্ট্যাটিক ডেটার একাধিক জেনারেশন নিয়ে পরীক্ষা করার জন্য Flow<List<Value>>-এ আগে থেকে থাকা এক্সটেনশন এখনও ব্যবহার করা উচিত। (Id34d1, b/280655188)

API-তে পরিবর্তন

  • পেজিং-টেস্টিং-এর সমস্ত পাবলিক API এখন @VisibleForTesting-এর সাথে অ্যানোটেট করা হয়েছে যাতে এই APIগুলি শুধুমাত্র টেস্টে ব্যবহার করা হয়। (I7db6e)
  • asSnapshot API-তে আর 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>>-এ asSnapshot Kotlin এক্সটেনশনের মাধ্যমে করা হয়, যা 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 values
    

    asSnapshot হল একটি 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>.flowable API আর পরীক্ষামূলক পর্যায়ে নেই
  • 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>.flowable API আর পরীক্ষামূলক নয়। (Ie0bdd)

ত্রুটি সমাধান

  • LoadStates-এর জন্য, endOfPaginationReached এখন সবসময় false LoadType.REFRESH-এর জন্য। আগে, RemoteMediator REFRESH-এর জন্য endOfPaginationReached true হতে পারত, কিন্তু 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)-এ সেট করা থাকে। এর অর্থ হল:

    1. আপনি RemoteMediator ব্যবহার করলে, মধ্যস্থতাকারীর স্ট্যাটাস সবসময় পপুলেট করা হবে।
    2. .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 DataSource API ব্যবহার করার সময় কখনও কখনও 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 পরীক্ষা করেন, তাহলে pageSize PagingConfig.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 এবং dataRefreshListener API সরিয়ে দেওয়া হয়েছে কারণ loadStateFlow / Listener আপডেটের সাথে এগুলি অপ্রয়োজনীয়। যারা মাইগ্রেট করছেন, তাদের জন্য loadStateFlow-এর সমতুল্য হল:

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

    (Ib5570, b/173530908)

ত্রুটি সমাধান

  • 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-এর নতুন ফিচার

পরিচিত সমস্যা

  • 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