เพจจิ้ง

ไลบรารี Paging ช่วยให้คุณโหลดข้อมูลอย่างค่อยเป็นค่อยไปและราบรื่นภายใน RecyclerView ของแอปได้ง่ายขึ้น

ตารางนี้แสดงอาร์ติแฟกต์ทั้งหมดในกลุ่ม androidx.paging

อาร์ติแฟกต์ รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
paging-* 3.5.3 - - 3.6.0-alpha01
paging-compose 3.5.3 - - 3.6.0-alpha01
คลังนี้ได้รับการอัปเดตล่าสุดเมื่อวันที่ 18 พฤศจิกายน 2026

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มทรัพยากร Dependency ใน Paging คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google

เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูล ดังนี้

Groovy

dependencies {
  def paging_version = "3.5.3"

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

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

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

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

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

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

Kotlin

dependencies {
  val paging_version = "3.5.3"

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

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

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

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

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

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

ดูข้อมูลเกี่ยวกับการใช้ส่วนขยาย Kotlin ได้ที่เอกสารประกอบ ktx

ดูข้อมูลเพิ่มเติมเกี่ยวกับการขึ้นต่อกันได้ที่เพิ่มการขึ้นต่อกันของบิลด์

ความคิดเห็น

ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากคุณพบปัญหาใหม่หรือมีแนวคิดในการปรับปรุงไลบรารีนี้ โปรดดูปัญหาที่มีอยู่ในคลังนี้ก่อนที่จะสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่ได้โดยคลิกปุ่มดาว

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ Issue Tracker

เวอร์ชัน 3.6

เวอร์ชัน 3.6.0-alpha01

18 พฤศจิกายน 2569

androidx.paging:paging-*:3.6.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 3.6.0-alpha01 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มส่วนขยาย ItemSnapshotList รายการสำหรับ Lazy Foundation ตอนนี้คุณสามารถเรียกใช้ ItemSnapshotList#itemKey และ ItemSnapshotList#itemContentType เพื่อสร้าง itemKey และ contentType โดยอัตโนมัติสำหรับ Lazy Foundation ได้แล้ว (I73455, b/560754841)

การมีส่วนร่วมจากภายนอก

  • ขอขอบคุณ Kamal ที่เพิ่มส่วนขยาย ItemSnapshotList รายการ

เวอร์ชัน 3.5

เวอร์ชัน 3.5.3

12 ตุลาคม 2569

androidx.paging:paging-*:3.5.3 เผยแพร่แล้ว เวอร์ชัน 3.5.3 มี Commit เหล่านี้

แก้ไขข้อบกพร่อง

  • ItemSnapshotListFlow จะไม่แสดง IllegalArgumentException อีกต่อไปเมื่อ RemoteMediator ถึงจุดสิ้นสุดของการแบ่งหน้าในทิศทางใดทิศทางหนึ่ง และส่วนหัวหรือส่วนท้ายถูกแปลงเป็นตัวคั่นเทอร์มินัล (I821c7, b/566336825)
  • เมื่อหน้าเว็บที่โหลดเกิน PagingConfig.maxSize หน้าเว็บที่โหลดจะไม่ลดลงต่ำกว่า 2 หน้าเพื่อให้แน่ใจว่าวิวพอร์ตมีข้อมูลครบถ้วน (I037a0, b/565835910)

การมีส่วนร่วมจากภายนอก

ขอขอบคุณ Igor ที่ส่งการแก้ไขข้อบกพร่อง b/565835910

เวอร์ชัน 3.5.2

7 ตุลาคม 2569

androidx.paging:paging-*:3.5.2 เผยแพร่แล้ว เวอร์ชัน 3.5.2 มี คอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • การเรียก Pager.append() ก่อนที่การรีเฟรชครั้งแรกจะเสร็จสมบูรณ์จะไม่แสดง NoSuchElementException อีกต่อไป การเรียกใช้การต่อท้ายจะไม่มีผล (Ide387, b/556780796)

เวอร์ชัน 3.5.1

12 สิงหาคม 2569

androidx.paging:paging-*:3.5.1 เผยแพร่แล้ว เวอร์ชัน 3.5.1 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่ PagingSource.getRefreshKey ระบุ anchorPosition ที่ไม่ถูกต้องซึ่งมีขนาดใหญ่เกินไปเมื่อรีเฟรชหน้าเว็บที่มีตัวคั่นขณะเลื่อนไปยังตัวยึดตำแหน่ง (I475f0, b/516565503)

เวอร์ชัน 3.5.0

6 พฤษภาคม 2026

androidx.paging:paging-*:3.5.0 เผยแพร่แล้ว เวอร์ชัน 3.5.0 มี คอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 3.4.0

  • เพิ่มโอเปอเรเตอร์ Flow<PagingData>.asItemSnapshotListFlow เพื่อแปลง Flow<PagingData> เป็น Flow<ItemSnapshotList> ซึ่งหมายความว่าตอนนี้คุณสามารถเข้าถึงข้อมูลที่โหลดไว้นอกเลเยอร์ UI ได้แล้ว ซึ่งจะช่วยให้คุณรวม Flow<ItemSnapshotList> เข้ากับแหล่งข้อมูลอื่นๆ แคชและแก้ไขข้อมูลที่มีการแบ่งหน้าในเครื่อง หรือแสดงข้อมูลที่มีการแบ่งหน้าเป็นส่วนหนึ่งของสถานะ UI และอื่นๆ ได้

  • เพิ่มฟังก์ชันส่วนขยาย Pager.append และ Pager.prepend เพื่อโหลดข้อมูลเพิ่มเติมด้วยตนเองโดยไม่ต้องเลื่อน

  • เพิ่มฟังก์ชันส่วนขยาย Pager.refresh และ Paging.retry เพื่อกู้คืนจากข้อผิดพลาดในการโหลดเมื่อใช้ asItemSnapshotListFlow API

เวอร์ชัน 3.5.0-rc01

22 เมษายน 2026

androidx.paging:paging-*:3.5.0-rc01 เผยแพร่แล้ว เวอร์ชัน 3.5.0-rc01 มีคอมมิตเหล่านี้

ไม่มีการเปลี่ยนแปลง

  • ไม่มีการเปลี่ยนแปลงที่สำคัญจากเวอร์ชัน 3.5.0-beta01

เวอร์ชัน 3.5.0-beta01

8 เมษายน 2026

androidx.paging:paging-*:3.5.0-beta01 เผยแพร่แล้ว เวอร์ชัน 3.5.0-beta01 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เปลี่ยนชื่อ Flow<PagingData>.asState API เป็น Flow<PagingData>.asItemSnapshotListFlow (I0dc11, b/496548025)

เวอร์ชัน 3.5.0-alpha01

11 มีนาคม 2026

androidx.paging:paging-*:3.5.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 3.5.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ตอนนี้อาร์ติแฟกต์ paging-common มีโอเปอเรเตอร์โฟลว์ asState ใหม่ใน Flow<PagingData> เพื่อแปลงเป็น Flow<ItemSnapshotList> ซึ่งจะปลดล็อกความสามารถต่างๆ เช่น

    • รวม Flow ของ 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 ยังเพิ่ม API Pager.append และ Pager.prepend เพื่อทริกเกอร์การโหลดด้วยตนเองที่ขอบด้านใดด้านหนึ่งของรายการที่โหลด

    • เมื่อใช้กับ 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() }
      }
    }
    
  • เพิ่ม Pager.refresh และ Pager.retry เพื่อกู้คืนจากข้อผิดพลาดในการโหลดเมื่อใช้ asState API ดูตัวอย่างการใช้งาน API ใหม่เพิ่มเติมได้ในเอกสารนี้ (I1e1e9, If3c87, Idbd48, Id1e1d, I816fe)

เวอร์ชัน 3.4

เวอร์ชัน 3.4.2

11 มีนาคม 2026

androidx.paging:paging-*:3.4.2 เผยแพร่แล้ว เวอร์ชัน 3.4.2 มีคอมมิตเหล่านี้

ไม่มีการเปลี่ยนแปลง

  • รุ่นนี้ไม่มีการเปลี่ยนแปลง API หรือลักษณะการทำงานจากเวอร์ชัน 3.4.1

เวอร์ชัน 3.4.1

11 กุมภาพันธ์ 2026

androidx.paging:paging-*:3.4.1 เผยแพร่แล้ว เวอร์ชัน 3.4.1 มีคอมมิตเหล่านี้

การอัปเดตทรัพยากร Dependency

  • อัปเดตทรัพยากร Dependency ของ Guava ของ paging-guava จากเวอร์ชัน 31.1 เป็น 32.0.1

เวอร์ชัน 3.4.0

28 มกราคม 2026

androidx.paging:paging-*:3.4.0 เผยแพร่แล้ว เวอร์ชัน 3.4.0 มี Commit เหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 3.3.0:

  • เพิ่มเป้าหมาย KMP เพิ่มเติมใน paging-common, paging-testing และ paging-compose แล้ว ตอนนี้ไลบรารีทั้งหมดรองรับ JVM (Android และเดสก์ท็อป), เนทีฟ (Linux, iOS, watchOS, tvOS, macOS, MinGW) และเว็บ (JavaScript, WasmJS)
  • paging-common, paging-testing และ paging-compose ได้นำการรองรับ macosX64, iosX64, watchosX64 และ tvosX64 ออกเพื่อให้สอดคล้องกับการเลิกใช้งานเป้าหมาย macosX64 ของ Jetbrains
  • เพิ่ม PagingState API closestItemAroundPosition ใหม่เพื่อดึงข้อมูลรายการที่โหลดซึ่งอยู่ใกล้กับตำแหน่งเป้าหมายมากที่สุดและตรงกับเพรดิเคตอินพุต ซึ่งสามารถใช้เพื่อสร้างคีย์รีเฟรชตามรายการที่รายการที่ยึดได้ในอุดมคติอยู่ใกล้ๆ แต่ไม่ได้อยู่ที่ตำแหน่งเป้าหมายที่แน่นอน

เวอร์ชัน 3.4.0-rc01

14 มกราคม 2026

androidx.paging:paging-*:3.4.0-rc01 เผยแพร่แล้ว เวอร์ชัน 3.4.0-rc01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

เวอร์ชัน 3.4.0-beta01

17 ธันวาคม 2025

androidx.paging:paging-*:3.4.0-beta01 เผยแพร่แล้ว เวอร์ชัน 3.4.0-beta01 มี คอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขการแย่งชิงทรัพยากรระหว่างการโหลด RecyclerView และ Refresh ซึ่งทำให้เกิด IndexOutOfBoundsException ใน RecyclerView การอัปเดต UI ที่หยุดชะงักเนื่องจากการโหลด Refresh อย่างต่อเนื่องอาจทำให้สถานะเพจจิ้งไม่ซิงค์กับ RecyclerView ปัญหานี้แก้ไขได้โดยการรีเซ็ตเพจจิ้งเป็นสถานะก่อนรีเฟรชหากการรีเฟรชถูกขัดจังหวะ (เช่น โดยการโหลด Refresh ติดต่อกัน) (I771b0, b/409809768)

เวอร์ชัน 3.4.0-alpha04

10 กันยายน 2025

androidx.paging:paging-*:3.4.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 3.4.0-alpha04 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่ม PagingState API closestItemAroundPosition ใหม่เพื่อดึงข้อมูลรายการที่โหลดซึ่งอยู่ใกล้กับตำแหน่งเป้าหมายมากที่สุดและตรงกับเพรดิเคตอินพุต ซึ่งสามารถใช้เพื่อสร้างคีย์รีเฟรชตามรายการที่รายการที่ยึดได้ในอุดมคติอยู่ใกล้ๆ แต่ไม่ได้อยู่ที่ตำแหน่งเป้าหมายที่แน่นอน (I96e5c, b/440187139)

เวอร์ชัน 3.4.0-alpha03

27 สิงหาคม 2025

androidx.paging:paging-*:3.4.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 3.4.0-alpha03 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • Paging-common ได้เพิ่มเดสก์ท็อปเป็นเป้าหมาย Kotlin Multiplatform (KMP) ใหม่ ปัจจุบันรองรับ JVM (Android และเดสก์ท็อป), เนทีฟ (Linux, iOS, watchOS, tvOS, macOS, MinGW) และเว็บ (JavaScript, WasmJS) (Id2483, b/436884811)
  • การทดสอบการแบ่งหน้าได้เพิ่มเป้าหมาย 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

30 กรกฎาคม 2025

androidx.paging:paging-*:3.4.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 3.4.0-alpha02 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ตอนนี้ PagingData.from อนุญาตให้ตั้งค่า placeholdersBefore และ placeholdersAfter ได้แล้ว โปรดทราบว่าการเลื่อนดูตัวยึดตำแหน่งเหล่านี้จะไม่ทริกเกอร์การโหลด (I06983)

เวอร์ชัน 3.4.0-alpha01

2 กรกฎาคม 2025

androidx.paging:paging-*:3.4.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 3.4.0-alpha01 มี คอมมิตเหล่านี้

ฟีเจอร์ใหม่

แก้ไขข้อบกพร่อง

  • การทำ Unit Test ของ Android ที่ดึงข้อมูลใน Paging 3.3 ขึ้นไปจะไม่แสดงข้อผิดพลาดจาก PagingLogger อีกต่อไป (Ia9400, b/331684448)
  • แก้ไขข้อบกพร่องที่ RecyclerView แสดง IndexOutOfBoundsException เมื่อผู้ใช้เลื่อนขณะอัปเดต RecyclerView (Id1f16, b/381024738)
  • แก้ไขข้อบกพร่องที่การแบ่งหน้าไม่สามารถทริกเกอร์การโหลดเพิ่มเติมเมื่อรีเฟรชขณะเลื่อน (I60ca5, b/352586078)
  • แก้ไขข้อขัดข้องเมื่อเลื่อนขณะรีเฟรชรายการแบ่งหน้า (I8c65a, b/347649763)

เวอร์ชัน 3.3

เวอร์ชัน 3.3.6

12 กุมภาพันธ์ 2025

androidx.paging:paging-*:3.3.6 เผยแพร่แล้ว เวอร์ชัน 3.3.6 มี คอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • ตอนนี้ระบบจะจัดเก็บสัญญาณรีเฟรชและลองใหม่ที่ส่งระหว่างการรีเฟรชครั้งแรก และส่งอีกครั้งโดยอัตโนมัติเมื่อผู้นำเสนอเพจพร้อม

การมีส่วนร่วมจากภายนอก

  • ขอขอบคุณ Eva ที่ส่งการแก้ไขข้อบกพร่อง (#754)

เวอร์ชัน 3.3.5

11 ธันวาคม 2024

androidx.paging:paging-*:3.3.5 เผยแพร่แล้ว เวอร์ชัน 3.3.5 มี คอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องที่ RecyclerView แสดง IndexOutOfBoundsException เมื่อผู้ใช้เลื่อนขณะอัปเดต RecyclerView (Id1f16, b/381024738)

เวอร์ชัน 3.3.4

13 พฤศจิกายน 2024

androidx.paging:paging-*:3.3.4 เผยแพร่แล้ว เวอร์ชัน 3.3.4 มี คอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • การทำ Unit Test ของ Android ที่ดึงข้อมูลใน Paging 3.3 ขึ้นไปจะไม่แสดงข้อผิดพลาด เช่น Method isLoggable in android.util.Log not mocked อีกต่อไป (Ia9400, b/331684448)

เวอร์ชัน 3.3.2

7 สิงหาคม 2024

androidx.paging:paging-*:3.3.2 เผยแพร่แล้ว เวอร์ชัน 3.3.2 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • paging-common และ paging-testing ได้เพิ่มเป้าหมาย Kotlin-Multiplatform ใหม่ ได้แก่ watchos, tvos และ linuxArm64 (90c9768), (53e0eca)

เวอร์ชัน 3.3.1

24 กรกฎาคม 2024

androidx.paging:paging-*:3.3.1 เผยแพร่แล้ว เวอร์ชัน 3.3.1 มี Commit เหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่ AsyncPagingDataDiffer หรือ API ที่สร้างขึ้นจาก เช่น PagingDataAdapter ที่ใช้กับ RecyclerView ไม่สามารถทริกเกอร์การโหลดเพิ่มเติมเมื่อแหล่งข้อมูลสำรองรีเฟรชขณะเลื่อน (I60ca5, b/352586078)
  • แก้ไขข้อขัดข้องที่เกิดขึ้นเมื่อนำรายการออกจากแหล่งข้อมูลสำรองขณะเลื่อน RecyclerView โดยใช้ PagingDataAdapter หรือ AsyncPagingDataDiffer (I8c65a, b/347649763)

เวอร์ชัน 3.3.0

14 พฤษภาคม 2024

androidx.paging:paging-*:3.3.0 เผยแพร่แล้ว เวอร์ชัน 3.3.0 มี คอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 3.2.0

  • PagingDataPresenter เป็นชั้นเรียนสาธารณะแล้ว ตอนนี้คุณสามารถสร้าง Multiplatform Presenter บน PagingDataPresenter ได้แล้ว โดยไม่ต้องใช้ Paging API ภายในหรือ AsyncPagingDataDiffer ของ paging-runtime
  • เพิ่มเมธอดตัวช่วย LoadStates และ CombinedLoadStates ใหม่ใน hasError และ isIdle เพื่อตรวจสอบว่า LoadStates อยู่ในสถานะ Error หรือ NotLoading ตามลำดับ นอกจากนี้ ยังเพิ่มเมธอดส่วนขยาย Kotlin awaitNotLoading() ใหม่ใน Flow<CombinedLoadStates> ซึ่งจะรอจนกว่าการโหลดจะเข้าสู่สถานะ NotLoading หรือสถานะข้อผิดพลาด
  • ตอนนี้ PagingData.empty() จะส่งสถานะ NotLoading โดยค่าเริ่มต้น เว้นแต่จะมีการส่ง LoadStates ที่กำหนดเองไปยังตัวสร้าง ซึ่งแตกต่างจากลักษณะการทำงานที่มีอยู่ซึ่งจะไม่ส่ง LoadStates เมื่อส่งไปยัง PagingDataAdapter หรือจะส่งสถานะการโหลดเมื่อรวบรวมเป็น LazyPagingItems เมื่อรวบรวมเป็น LazyPagingItems ตอนนี้ระบบจะแสดงรายการที่ว่างเปล่าทันทีเมื่อเริ่มคอมโพสิชันด้วย

ความเข้ากันได้ของ Kotlin Multiplatform

ตอนนี้ Paging จะจัดส่งอาร์ติแฟกต์ที่เข้ากันได้กับ Kotlin Multiplatform ซึ่งส่วนใหญ่เป็นผลมาจากงานที่อัปสตรีมจากโปรเจ็กต์ multiplatform-paging ของ CashApp

  • paging-common ได้ย้าย API ของ Paging 3 ทั้งหมดไปยัง common และตอนนี้เข้ากันได้กับ JVM และ iOS นอกเหนือจาก Android
  • paging-testing ได้ย้ายโค้ดไปยัง common และตอนนี้เข้ากันได้กับ JVM และ iOS นอกเหนือจาก Android
  • paging-compose ได้ย้ายโค้ดไปยัง common และจัดส่งอาร์ติแฟกต์ Android ซึ่งตรงกับการรองรับหลายแพลตฟอร์มของ androidx.compose
  • paging-runtime, paging-guava, paging-rxjava2 และ paging-rxjava3 จะยังคงใช้ได้เฉพาะใน Android เท่านั้น

เวอร์ชัน 3.3.0-rc01

1 พฤษภาคม 2024

androidx.paging:paging-*:3.3.0-rc01 เปิดตัวโดยไม่มีการเปลี่ยนแปลงใน Paging 3.3.0-beta01 เวอร์ชัน 3.3.0-rc01 มีคอมมิตเหล่านี้

เวอร์ชัน 3.3.0-beta01

3 เมษายน 2024

androidx.paging:paging-*:3.3.0-beta01 เปิดตัวโดยไม่มีการเปลี่ยนแปลงที่สำคัญ เวอร์ชัน 3.3.0-beta01 มีคอมมิตเหล่านี้

เวอร์ชัน 3.3.0-alpha05

20 มีนาคม 2024

androidx.paging:paging-*:3.3.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 3.3.0-alpha05 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ตอนนี้ Paging ใช้คำอธิบายประกอบ @MainThread ของ AndroidX Annotation สำหรับโค้ดทั่วไป (I78f0d, b/327682438)

เวอร์ชัน 3.3.0-alpha04

6 มีนาคม 2024

androidx.paging:paging-*:3.3.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 3.3.0-alpha04 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขข้อผิดพลาดเล็กน้อยในเอกสารประกอบที่เกี่ยวข้องกับการเพิ่มความเข้ากันได้กับ Kotlin Multiplatform (aosp/2950785)

เวอร์ชัน 3.3.0-alpha03

7 กุมภาพันธ์ 2024

androidx.paging:paging-*:3.3.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 3.3.0-alpha03 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • PagingDataPresenter เป็นชั้นเรียนสาธารณะแล้ว ตอนนี้คุณสามารถสร้าง Multiplatform Presenter บน PagingDataPresenter ได้แล้ว โดยไม่ต้องใช้ Paging API ภายในหรือ AsyncPagingDataDiffer ของ paging-runtime (Id1f74, b/315214786)
  • เพิ่มเมธอดตัวช่วย LoadStates และ CombinedLoadStates ใหม่เพื่อตรวจสอบว่า LoadStates อยู่ในสถานะ Error หรือ NotLoading นอกจากนี้ยังเพิ่ม API ใหม่ที่รอ LoadStateFlow จนกว่าการโหลดจะเข้าสู่สถานะ NotLoading หรือสถานะข้อผิดพลาด (Id6c67)

พฤติกรรม

  • ตอนนี้ PagingData.empty() จะส่งสถานะ NotLoading โดยค่าเริ่มต้น เว้นแต่จะมีการส่ง LoadStates ที่กำหนดเองไปยังตัวสร้าง ซึ่งแตกต่างจากลักษณะการทำงานที่มีอยู่ซึ่งจะไม่ส่ง LoadStates เมื่อส่งไปยัง PagingDataAdapter หรือจะส่งสถานะการโหลดเมื่อรวบรวมเป็น LazyPagingItems เมื่อรวบรวมเป็น LazyPagingItems ตอนนี้ระบบจะแสดงรายการที่ว่างเปล่าทันทีเมื่อเริ่มคอมโพสิชันด้วย (I4d11d, b/301833847)

เวอร์ชัน 3.3.0-alpha02

20 กันยายน 2023

androidx.paging:paging-*:3.3.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 3.3.0-alpha02 มีคอมมิตเหล่านี้

ความเข้ากันได้ของ Kotlin Multiplatform

ตอนนี้ Paging จะจัดส่งอาร์ติแฟกต์ที่เข้ากันได้กับ Kotlin Multiplatform ซึ่งส่วนใหญ่เป็นผลมาจากงานที่อัปสตรีมจากโปรเจ็กต์ multiplatform-paging ของ CashApp ซึ่งจะช่วยให้เราหลีกเลี่ยงความแตกต่างระหว่างที่เก็บทั้ง 2 แห่งและทำให้ที่เก็บทั้งสองเข้ากันได้

  • paging-common ได้ย้าย API ของ Paging 3 ทั้งหมดไปยัง common และตอนนี้เข้ากันได้กับ JVM และ iOS นอกเหนือจาก Android
  • paging-testing ได้ย้ายโค้ดไปยัง common และตอนนี้เข้ากันได้กับ JVM และ iOS นอกเหนือจาก Android
  • paging-compose ได้ย้ายโค้ดไปยัง common และจัดส่งอาร์ติแฟกต์ Android ซึ่งตรงกับการรองรับหลายแพลตฟอร์มของ androidx.compose
  • paging-runtime, paging-guava, paging-rxjava2 และ paging-rxjava3 จะยังคงใช้ได้เฉพาะใน Android เท่านั้น

การเปลี่ยนแปลง API

  • เลิกใช้งานอินเทอร์เฟซ Logger สาธารณะที่มีไว้สำหรับการใช้งานภายในเท่านั้น (I16e95, b/288623117)

การมีส่วนร่วมจากภายนอก

เวอร์ชัน 3.3.0-alpha01

20 กันยายน 2023

  • นี่เป็นรุ่นแรกของไลบรารี androidx.paging ที่ใช้ได้หลายแพลตฟอร์ม เวอร์ชันนี้มีเฉพาะอาร์ติแฟกต์ *-jvm และ *-android สำหรับตัวแปร macOS, iOS และ Linux ให้ใช้ 3.3.0-alpha02

เวอร์ชัน 3.2

เวอร์ชัน 3.2.1

6 กันยายน 2023

androidx.paging:paging-*:3.2.1 เผยแพร่แล้ว เวอร์ชัน 3.2.1 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่ API asSnapshot() ของอาร์ติแฟกต์การทดสอบการแบ่งหน้าจะค้างเมื่อส่ง Flow ที่สร้างโดยใช้ PagingData.from(List) เนื่องจาก asSnapshot() จะไม่มีข้อมูลว่าการโหลดเสร็จสิ้นเมื่อใด (ต่างจากโอเวอร์โหลด PagingData.from(List, LoadStates)) วิธีแก้ปัญหานี้ใช้ได้กับ Flow ที่ดำเนินการจนเสร็จสมบูรณ์ได้เท่านั้น (เช่น flowOf(PagingData.from(...))) สำหรับ Flow ที่ดำเนินการจนเสร็จสมบูรณ์ไม่ได้ (เช่น MutableStateFlow) ให้ใช้โอเวอร์โหลด PagingData.from ที่มี LoadStates (I502c3)
  • ตอนนี้ Paging Compose จะใช้ AndroidUiDispatcher.Main ภายในเพื่อให้มั่นใจว่าข้อมูลใหม่จะพร้อมใช้งานในเฟรมเดียวกับที่การโหลดเสร็จสมบูรณ์ (Ia55af)

เวอร์ชัน 3.2.0

26 กรกฎาคม 2023

androidx.paging:paging-*:3.2.0 เผยแพร่แล้ว เวอร์ชัน 3.2.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 3.1.0

  • Paging Compose มีความเสถียรของ API และได้ผสานรวมกลับเข้ากับส่วนที่เหลือของ Paging ซึ่งตอนนี้เวอร์ชันของ Paging Compose ตรงกับอาร์ติแฟกต์ Paging อื่นๆ ทั้งหมดแล้ว การเปลี่ยนแปลงตั้งแต่เวอร์ชัน 3.1.0 มีดังนี้
    • รองรับการแสดงตัวอย่างรายการข้อมูลจำลองโดยการสร้าง PagingData.from(fakeData) และรวม PagingData นั้นไว้ใน MutableStateFlow (เช่น MutableStateFlow(PagingData.from(listOf(1, 2, 3)))) ส่ง Flow นี้ไปยัง Composable @Preview เป็นตัวรับเพื่อให้ collectAsLazyPagingItems() แสดงตัวอย่าง
    • รองรับเลย์เอาต์แบบ Lazy ทั้งหมด เช่น LazyVerticalGrid และ HorizontalPager รวมถึงคอมโพเนนต์แบบ Lazy ที่กำหนดเองจากไลบรารี Wear และ TV ซึ่งทำได้โดยใช้เมธอดส่วนขยาย LazyPagingItems ระดับต่ำกว่าแบบใหม่ itemKey และ itemContentType ซึ่งช่วยให้คุณใช้พารามิเตอร์ key และ contentType กับ API items มาตรฐานที่มีอยู่แล้วสำหรับ LazyColumn, LazyVerticalGrid รวมถึงพารามิเตอร์ที่เทียบเท่าใน API เช่น HorizontalPager
    • items(lazyPagingItems) และ itemsIndexed(lazyPagingItems) ซึ่งรองรับเฉพาะ LazyListScope เลิกใช้งานแล้ว
  • อาร์ติแฟกต์ paging-testing ใหม่ซึ่งมี API ที่ออกแบบมาเพื่อการทำ Unit Test ของแต่ละเลเยอร์ในแอปและการผสานรวมกับเพจจิ้งแบบแยกต่างหาก ตัวอย่างเช่น
    • คลาส TestPager ที่ช่วยให้คุณตรวจสอบลักษณะการทำงานของการติดตั้งใช้งาน PagingSource ที่กำหนดเองได้โดยไม่ขึ้นอยู่กับ Pager และ UI จริง
    • ​​asPagingSourceFactory API เพื่อเปลี่ยน Flow<List<Value>> หรือ List<Value> แบบคงที่ให้เป็น PagingSourceFactory ที่สามารถส่งไปยัง Pager ในการทดสอบได้
    • ส่วนขยาย Kotlin asSnapshot ใน Flow<PagingData<Value>> ซึ่งจะแปล Flow<PagingData<Value>> เป็น List<Value> โดยตรง asSnapshot lambda ช่วยให้คุณเลียนแบบ UI ของแอปผ่าน API เช่น scrollTo หรือ appendScrollWhile เพื่อให้คุณยืนยันได้ว่าภาพรวมของข้อมูลถูกต้อง ณ จุดใดก็ตามในชุดข้อมูลที่มีการแบ่งหน้า
  • เพิ่มบันทึกค่าเริ่มต้นเพื่อแสดงข้อมูลการแก้ไขข้อบกพร่องของเพจจิ้งใน 2 ระดับ ได้แก่ VERBOSE และ DEBUG คุณเปิดใช้บันทึกได้ผ่านคำสั่ง adb shell setprop log.tag.Paging [DEBUG|VERBOSE] ซึ่งใช้ได้กับทั้งเพจจิ้งด้วยมุมมองหรือเพจจิ้งด้วย Compose
  • เพิ่มคอนสตรักเตอร์สำหรับ PagingDataAdapter และ AsyncPagingDataDiffer ซึ่งยอมรับ CoroutineContext แทน CoroutineDispatcher
  • เพิ่มอินเทอร์เฟซฟังก์ชัน PagingSourceFactory ใหม่ที่ให้แพลตฟอร์ม API ที่ชัดเจนกว่า () -> PagingSource lambdas ก่อนหน้า คุณสามารถใช้โรงงานนี้เพื่อสร้างอินสแตนซ์ของ Pager ได้

เวอร์ชัน 3.2.0-rc01

21 มิถุนายน 2023

androidx.paging:paging-*:3.2.0-rc01 เผยแพร่แล้ว เวอร์ชัน 3.2.0-rc01 มีคอมมิตเหล่านี้

การมีส่วนร่วมจากภายนอก

  • ขอขอบคุณ Veyndan ที่มีส่วนร่วมในการย้าย Paging ออกจากข้อมูลเฉพาะของ Android/JVM (#553, #554, #555, #559)

เวอร์ชัน 3.2.0-beta01

7 มิถุนายน 2023

androidx.paging:paging-*:3.2.0-beta01 เผยแพร่แล้ว เวอร์ชัน 3.2.0-beta01 มีคอมมิตเหล่านี้

Paging Compose

  • Paging Compose มีความเสถียรของ API อย่างเป็นทางการแล้ว ด้วยเหตุนี้ เวอร์ชันจึงได้รับการอัปเดตจาก 1.0.0-alpha20 เพื่อให้ตรงกับเวอร์ชันของอาร์ติแฟกต์ Paging อื่นๆ ทั้งหมด

การเปลี่ยนแปลง API

เวอร์ชัน 3.2.0-alpha06

24 พฤษภาคม 2023

androidx.paging:paging-*:3.2.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 3.2.0-alpha06 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มอินเทอร์เฟซฟังก์ชัน PagingSourceFactory ใหม่ที่ให้ API ที่ชัดเจนกว่า Lambda () -> PagingSource ที่มีอยู่ คุณสามารถใช้โรงงานนี้เพื่อสร้างอินสแตนซ์ Pager ได้ (I33165, b/280655188)
  • เพิ่ม paging-testing API ใหม่ของ List<Value>.asPagingSourceFactory() เพื่อรับ PagingSourceFactory ที่โหลดจากรายการข้อมูลที่เปลี่ยนแปลงไม่ได้เท่านั้น ส่วนขยายที่มีอยู่ใน Flow<List<Value>> ควรยังคงใช้สำหรับการทดสอบกับข้อมูลคงที่หลายรุ่น (Id34d1, b/280655188)

การเปลี่ยนแปลง API

  • ตอนนี้ API สาธารณะทั้งหมดใน paging-testing จะมีคำอธิบายประกอบเป็น @VisibleForTesting เพื่อให้มั่นใจว่า API เหล่านี้จะใช้ในการทดสอบเท่านั้น (I7db6e)
  • API asSnapshot ไม่จำเป็นต้องส่ง CoroutineScope อีกต่อไป ตอนนี้ระบบจะใช้บริบทที่รับค่ามาจากขอบเขตระดับบนสุดโดยค่าเริ่มต้น (Id0a78, b/282240990)
  • จัดเรียงพารามิเตอร์คอนสตรัคเตอร์ TestPager ใหม่เพื่อให้ตรงกับลำดับของพารามิเตอร์คอนสตรัคเตอร์ Pager จริงอย่างเป็นธรรมชาติ (I6185a)
  • ย้ายข้อมูลการใช้ประเภท Lambda () -> PagingSource<Key, Value> ของ paging-testing ไปยังประเภท PagingSourceFactory<Key, Value> แล้ว (I4a950, b/280655188)

การเปลี่ยนแปลงพฤติกรรม

  • ไม่จำเป็นต้องใช้ผู้มอบหมายงานหลักเพื่อทำการทดสอบการเพจ asSnapshot อีกต่อไป การตั้งค่านี้จะไม่ทำให้เกิดการเปลี่ยนแปลงใดๆ กับลักษณะการทำงานของการทดสอบอีกต่อไป (Ie56ea)

เวอร์ชัน 3.2.0-alpha05

3 พฤษภาคม 2023

androidx.paging:paging-*:3.2.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 3.2.0-alpha05 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ตอนนี้ Paging Testing API ของ asSnapshot จะตั้งค่าพารามิเตอร์ loadOperations เป็น Lambda ที่ว่างเปล่าโดยค่าเริ่มต้น ซึ่งช่วยให้เรียกใช้ asSnapshot ได้โดยไม่ต้องส่งผ่านการดำเนินการโหลดใดๆ เพื่อดึงข้อมูลจากการโหลดรีเฟรชครั้งแรก (Ied354, b/277233770)

การปรับปรุงเอกสารประกอบ

  • อัปเดตเอกสารประกอบเกี่ยวกับ asPagingSourceFactory() เพื่อชี้แจงว่าเป็นเมธอดส่วนขยายใน Flow ซึ่งแสดงผลโรงงานที่นำกลับมาใช้ซ้ำได้สำหรับการสร้างอินสแตนซ์ PagingSource (I5ff4f, I705b5)
  • อัปเดตเอกสารประกอบเกี่ยวกับ LoadResult.Page constructor เพื่อชี้แจงความจำเป็นในการลบล้าง itemsBefore และ itemsAfter เพื่อรองรับการข้าม (Ied354)

การมีส่วนร่วมจากภายนอก

เวอร์ชัน 3.2.0-alpha04

8 กุมภาพันธ์ 2023

androidx.paging:paging-*:3.2.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 3.2.0-alpha04 มีคอมมิตเหล่านี้

การทดสอบเพจจิ้ง

  • ตอนนี้อาร์ติแฟกต์ paging-testing มีเมธอด asPagingSourceFactory เพื่อสร้าง pagingSourceFactory จาก Flow<List<Value>> เพื่อส่งไปยัง Pager List<Value>> แต่ละรายการที่ปล่อยออกมาจาก Flow แสดงถึงการสร้างข้อมูลที่มีการแบ่งหน้า ซึ่งจะช่วยอำนวยความสะดวกในการทดสอบการแบ่งหน้า เช่น การเปลี่ยนรูปแบบ PagingData โดยการปลอมแปลงแหล่งข้อมูลเพื่อให้ Pager รวบรวมข้อมูล (I6f230, b/235528239)
  • อาร์ติแฟกต์ paging-testing ได้รับการขยายด้วย API ใหม่ที่เหมาะสำหรับการยืนยันว่าข้อมูลที่อยู่ใน Flow<PagingData<T>> นั้นถูกต้อง ตัวอย่างเช่น คุณสามารถใช้เพื่อยืนยันเอาต์พุตของ Flow<PagingData<T>> จากเลเยอร์ ViewModel

    ซึ่งทำได้ผ่านส่วนขยาย Kotlin asSnapshot ใน Flow<PagingData<Value>> ซึ่งจะแปล Flow<PagingData<Value>> เป็น List<Value> โดยตรง asSnapshot lambda ช่วยให้คุณเลียนแบบ UI ของแอปผ่าน API เช่น scrollTo หรือ appendScrollWhile ในลักษณะที่ทำซ้ำได้และสอดคล้องกัน เพื่อให้คุณยืนยันได้ว่าภาพรวมของข้อมูลถูกต้อง ณ จุดใดก็ตามในชุดข้อมูลที่มีการแบ่งหน้า

    // Create your ViewModel instance
    val viewModel = …
    // Get the Flow of PagingData from the ViewModel
    val data< Flow<PagingData<String>> = viewModel.data
    val snapshot: List<String> = data.asSnapshot {
      // Each operation inside the lambda waits for the data to settle before continuing
      scrollTo(index = 50)
    
      // While you can’t view the items within the asSnapshot call,
      // you can continuously scroll in a direction while some condition is true
      // i.e., in this case until you hit a placeholder item
      appendScrollWhile {  item: String -> item != “Header 1” }
    }
    // With the asSnapshot complete, you can now verify that the snapshot
    // has the expected values
    

    asSnapshot เป็นเมธอด suspend ที่คาดว่าจะทำงานภายใน runTest ดูข้อมูลเพิ่มเติมได้ที่การทดสอบ Kotlin Coroutine ใน Android (I55fd2, I5bd26, I7ce34, I51f4d, I2249f, Id6223, Ic4bab, Ib29b9, Ic1238, I96def, b/235528239)

การเปลี่ยนแปลง API

  • ตอนนี้การเรียก UI ไปยัง getItem และ peek ใน AsyncPagingDataDiffer และ PagingDataAdapter ได้รับการทำเครื่องหมายอย่างถูกต้องว่าเรียกได้เฉพาะในเธรดหลักเท่านั้น (I699b6)
  • นำไวลด์การ์ดออกจากประเภททั่วไปที่ TestPager ใช้ เพื่อให้ใช้ผลลัพธ์ของเมธอดเหล่านั้นในโค้ดที่เขียนด้วยภาษาโปรแกรม Java ได้ง่ายขึ้น (I56c42)

เวอร์ชัน 3.2.0-alpha03

24 ตุลาคม 2022

androidx.paging:paging-*:3.2.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 3.2.0-alpha03 มีคอมมิตเหล่านี้

การทดสอบเพจจิ้ง

รุ่นนี้มีอาร์ติแฟกต์ใหม่: paging-testing อาร์ติแฟกต์นี้มี API ที่ออกแบบมาเพื่อการทำ Unit Test ของแต่ละเลเยอร์ในแอปและการผสานรวมกับ Paging แยกต่างหาก

ตัวอย่างเช่น เวอร์ชันแรกนี้มีคลาส TestPager ที่ช่วยให้คุณตรวจสอบลักษณะการทำงานของการติดตั้งใช้งาน PagingSource ที่กำหนดเองได้อย่างอิสระจาก Pager และ UI จริงที่คุณมักจะต้องจำลองการผสานรวมการแบ่งหน้าตั้งแต่ต้นจนจบ

TestPager ควรได้รับการพิจารณาว่าเป็นของปลอม ซึ่งเป็นออบเจ็กต์จำลองที่จำลองการใช้งานจริงของ Pager ขณะเดียวกันก็มีแพลตฟอร์ม API ที่เรียบง่ายสำหรับการทดสอบ PagingSource API เหล่านี้เป็น API ของ suspend และควรเรียกใช้ภายใน runTest ตามที่ระบุไว้ในคู่มือสำหรับการทดสอบโครูทีน Kotlin ใน Android

ดูตัวอย่างการใช้ API เหล่านี้ได้ในการทดสอบ room-paging ซึ่งได้รับการเปลี่ยนโครงสร้างภายในโค้ดเพื่อใช้ TestPager

การเปลี่ยนแปลง API

  • ช่วยให้ทำซ้ำ LoadResult.Page.data ผ่าน LoadResult.Page.iterator() ได้อย่างสะดวก ซึ่งจะอนุญาตให้ใช้เมธอด flatten ของไลบรารีมาตรฐาน Kotlin โดยอ้อมเมื่อระบุ List<LoadResult.Page> เช่น พร็อพเพอร์ตี้ pages ของ PagingState ที่ส่งไปยังเมธอด PagingSource.getRefreshKey (Ie0718)

เวอร์ชัน 3.2.0-alpha02

10 สิงหาคม 2022

androidx.paging:paging-*:3.2.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 3.2.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ตอนนี้ Paging จะแสดงบันทึกผ่านคลาส AsyncPagingDataDiffer หรือ PagingDataAdapter เพื่อแสดงข้อมูลการแก้ไขข้อบกพร่องที่รวบรวมจาก PagingData
  • เปิดใช้บันทึกได้ผ่านคำสั่ง adb shell adb shell setprop log.tag.Paging [DEBUG|VERBOSE].(b/235527159)

แก้ไขข้อบกพร่อง

  • แก้ไขข้อผิดพลาดเกี่ยวกับคอนสตรัคเตอร์ PagingDataDiffer ที่หายไปเมื่อใช้ paging-common:3.2.0-alpha01 กับรันไทม์ paging-runtime:3.1.1 หรือเก่ากว่า (b/235256201)

เวอร์ชัน 3.2.0-alpha01

1 มิถุนายน 2022

androidx.paging:paging-*:3.2.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 3.2.0-alpha01 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มคอนสตรักเตอร์สำหรับ PagingDataAdapter และ AsyncPagingDataDiffer ซึ่งยอมรับ CoroutineContext แทน CoroutineDispatcher (Idc878)
  • โดยค่าเริ่มต้น PagingData.from() และ PagingData.empty() จะไม่มีผลกับ CombinedLoadStates ในฝั่งผู้นำเสนออีกต่อไป เราได้เพิ่มโอเวอร์โหลดใหม่ที่อนุญาตให้ส่ง sourceLoadStates และ remoteLoadStates ไปยังตัวสร้างเหล่านี้เพื่อคงลักษณะการทำงานที่มีอยู่ของการตั้งค่า LoadStates ให้เป็นเทอร์มินัลอย่างสมบูรณ์ (เช่น NotLoading(endOfPaginationReached = false)) โดยมีตัวเลือกให้รวมสถานะระยะไกลด้วยหากจำเป็น หากไม่มีการส่ง LoadStates ระบบจะคง CombinedLoadStates ก่อนหน้าไว้ในฝั่งผู้นำเสนอเมื่อได้รับ PagingData แบบคงที่ (Ic3ce5, b/205344028)

แก้ไขข้อบกพร่อง

  • ตอนนี้ผลลัพธ์ของ PagingSource.getRefreshKey() จะได้รับการจัดลำดับความสำคัญเหนือ initialKey อย่างถูกต้องในกรณีที่แสดงผลเป็น Null แต่มีการตั้งค่า initialKey ที่ไม่ใช่ Null (Ic9542, b/230391606)

การมีส่วนร่วมจากภายนอก

  • อัปเดต :compose:ui:ui-test api (updateApi) เนื่องจากการย้ายข้อมูล test-coroutines-lib (I3366d)

เวอร์ชัน 3.1

เวอร์ชัน 3.1.1

9 มีนาคม 2022

androidx.paging:paging-*:3.1.1 เผยแพร่แล้ว เวอร์ชัน 3.1.1 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • นำเหตุการณ์ LoadState.NotLoading ระดับกลางระหว่างการสร้างที่ .cachedIn() แทรกอย่างไม่ถูกต้องออก การเปลี่ยนแปลงนี้ช่วยให้ตอบสนองต่อการเปลี่ยนแปลงของ LoadState ได้ง่ายขึ้นมากด้วยการนำเหตุการณ์ LoadState.NotLoading ที่ซ้ำซ้อนซึ่งเกิดขึ้นระหว่างการลองโหลดที่ล้มเหลวอีกครั้งออกเมื่อรีเฟรชหรือระหว่างการทำให้เป็นโมฆะ

เวอร์ชัน 3.1.0

17 พฤศจิกายน 2021

androidx.paging:paging-*:3.1.0 เผยแพร่แล้ว เวอร์ชัน 3.1.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 3.0.0

  • Flow<PagingData>.observable API และ Flow<PagingData>.flowable API ไม่ได้อยู่ในขั้นทดลองอีกต่อไป
  • การเปลี่ยนแปลงลักษณะการทำงานของ LoadState
    • ตอนนี้ endOfPaginationReached จะมีราคา false สำหรับ LoadType.REFRESH เสมอสำหรับทั้ง PagingSource และ RemoteMediator
    • LoadStates จากเพจจิ้งกำลังรอค่าที่ถูกต้องจากทั้ง PagingSource และ RemoteMediator ก่อนที่จะส่งไปยังดาวน์สตรีม ตอนนี้การสร้าง PagingData รุ่นใหม่จะเริ่มต้นด้วย Loading อย่างถูกต้องเสมอสำหรับสถานะการรีเฟรช แทนที่จะรีเซ็ตเป็น NotLoading อย่างไม่ถูกต้องในบางกรณี
    • .loadStateFlow และ .addLoadStateListener ใน API ของผู้นำเสนอจะไม่ส่ง CombinedLoadStates เริ่มต้นซ้ำซ้อนซึ่งมีสถานะสื่อกลางตั้งค่าเป็น null เสมออีกต่อไป
  • ตอนนี้การยกเลิกในรุ่นที่ผ่านมาจะเกิดขึ้นอย่างรวดเร็วเมื่อมีการทำให้เป็นโมฆะ/รุ่นใหม่ คุณไม่จำเป็นต้องใช้ .collectLatest ใน Flow<PagingData> อีกต่อไป แม้ว่าเราจะยังคงแนะนำให้ใช้ก็ตาม
  • เพิ่ม PagingSource.LoadResult.Invalid เป็นประเภทการแสดงผลใหม่จาก PagingSource.load แล้ว ซึ่งทำให้เพจจิ้งทิ้งคำขอโหลดที่รอดำเนินการหรือคำขอโหลดในอนาคตไปยัง PagingSource นี้และทำให้ใช้งานไม่ได้ ประเภทการแสดงผลนี้ออกแบบมาเพื่อจัดการข้อมูลที่อาจไม่ถูกต้องหรือล้าสมัยซึ่งอาจแสดงผลจากฐานข้อมูลหรือเครือข่าย
  • เพิ่ม API ของผู้นำเสนอ .onPagesPresented และ .addOnPagesUpdatedListener ซึ่งทริกเกอร์พร้อมกันเมื่อมีการแสดงหน้าเว็บใน UI การอัปเดตหน้าเว็บอาจเกิดขึ้นในสถานการณ์ต่อไปนี้
    • การโหลดครั้งแรกของ PagingData รุ่นใหม่เสร็จสมบูรณ์ ไม่ว่ารุ่นใหม่จะมีการเปลี่ยนแปลงรายการที่แสดงหรือไม่ก็ตาม เช่น การสร้างใหม่ที่โหลดครั้งแรกเสร็จสมบูรณ์โดยไม่มีการอัปเดตเนื่องจากรายการเหมือนกันทุกประการจะยังคงทริกเกอร์ Callback นี้
    • ระบบจะแทรกหน้าเว็บ แม้ว่าหน้าเว็บที่แทรกจะไม่มีรายการใหม่ก็ตาม
    • ระบบจะวางหน้าเว็บ แม้ว่าหน้าเว็บที่วางจะว่างเปล่าก็ตาม

เวอร์ชัน 3.1.0-rc01

3 พฤศจิกายน 2021

androidx.paging:paging-*:3.1.0-rc01 เผยแพร่แล้ว เวอร์ชัน 3.1.0-rc01 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขภาวะแข่งขัน + หน่วยความจำรั่วไหลใน .cachedIn() ในกรณีที่ Paging ส่งเหตุการณ์การโหลดหลายรายการไปยังปลายทางขณะที่ไม่มีผู้สังเกตการณ์ หรือระหว่างที่ผู้สังเกตการณ์เปลี่ยนไปใช้ PagingData ใหม่ (Ib682e)

เวอร์ชัน 3.1.0-beta01

13 ตุลาคม 2021

androidx.paging:paging-*:3.1.0-beta01 เผยแพร่แล้ว เวอร์ชัน 3.1.0-beta01 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่การเข้าถึงรายการอย่างรวดเร็วหลายครั้งอาจทำให้รายการเหล่านั้นถูกตัดออกจากการพิจารณาใน prefetchDistance ซึ่งทำให้การโหลดหน้าเว็บหยุดชะงัก ปัญหานี้จะเกิดขึ้นเมื่อมีการจัดวางรายการจำนวนมากพร้อมกันในลำดับที่จะให้ความสำคัญกับการโหลดตามทิศทางการเลื่อนของผู้ใช้ ตอนนี้การเข้าถึงรายการเหล่านี้จะได้รับการบัฟเฟอร์และจัดลำดับความสำคัญแบบซิงโครนัสเพื่อป้องกันไม่ให้ถูกยกเลิก (aosp/1833273)

เวอร์ชัน 3.1.0-alpha04

29 กันยายน 2021

androidx.paging:paging-*:3.1.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 3.1.0-alpha04 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • API ของ Flow<PagingData>.observable และ Flow<PagingData>.flowable ไม่ได้อยู่ในขั้นทดลองอีกต่อไป (Ie0bdd)

แก้ไขข้อบกพร่อง

  • สำหรับ LoadStates ตอนนี้ endOfPaginationReached จะเป็น false เสมอสำหรับ LoadType.REFRESH ก่อนหน้านี้ endOfPaginationReached อาจเป็น true สำหรับ RemoteMediator REFRESH แต่ไม่ใช่สำหรับ PagingSource ตอนนี้ลักษณะการทำงานนี้ได้รับการรวมให้แสดงผล false เสมอ เนื่องจาก REFRESH ไม่ควรเป็นเทอร์มินัล และตอนนี้ได้รับการบันทึกเป็นส่วนหนึ่งของสัญญา API ใน LoadStates แล้ว เมื่อตัดสินใจว่าจะสิ้นสุดการแบ่งหน้าหรือไม่ คุณควรดำเนินการโดยคำนึงถึงทิศทาง APPEND หรือ PREPEND เสมอ (I047b6)
  • ตอนนี้ LoadStates จากเพจจิ้งจะรอค่าที่ถูกต้องจากทั้ง PagingSource และ RemoteMediator ก่อนที่จะส่งดาวน์สตรีมระหว่างรุ่น การดำเนินการนี้จะป้องกันไม่ให้ PagingData รุ่นใหม่ส่ง NotLoading ใน CombinedLoadStates.source.refresh หากมีการโหลดอยู่แล้ว ตอนนี้ PagingData รุ่นใหม่จะเริ่มต้นด้วยการโหลดสำหรับสถานะการรีเฟรชอย่างถูกต้องเสมอ แทนที่จะรีเซ็ตเป็น NotLoading อย่างไม่ถูกต้องในบางกรณี

    ตอนนี้การยกเลิกในรุ่นที่ผ่านมาจะเกิดขึ้นอย่างรวดเร็วเมื่อมีการทำให้ใช้งานไม่ได้/ รุ่นใหม่ ไม่จำเป็นต้องใช้ .collectLatest ใน Flow<PagingData> อีกต่อไป แม้ว่าจะยังคงแนะนำให้ใช้อยู่ก็ตาม (I0b2b5, b/177351336, b/195028524)

  • .loadStateFlow และ .addLoadStateListener ใน API ของผู้นำเสนอจะไม่ส่ง CombinedLoadStates เริ่มต้นซ้ำซ้อนอีกต่อไป ซึ่งจะมีสถานะสื่อกลางเป็น null และสถานะแหล่งที่มาเป็น NotLoading(endOfPaginationReached = false) เสมอ ซึ่งหมายความว่า

    1. ระบบจะป้อนข้อมูลสถานะสื่อกลางเสมอหากคุณใช้ RemoteMediator
    2. การลงทะเบียน Listener ของ loadState ใหม่หรือ Collector ใหม่ใน .loadStateFlow จะไม่ส่งค่าปัจจุบันทันทีอีกต่อไปหากยังไม่ได้รับ CombinedLoadStates จริงจาก PagingData กรณีนี้อาจเกิดขึ้นหากตัวรวบรวมหรือ Listener เริ่มทำงานก่อนที่จะมีการส่ง PagingData (I1a748)

เวอร์ชัน 3.1.0-alpha03

21 กรกฎาคม 2021

androidx.paging:paging-*:3.1.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 3.1.0-alpha03 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • มีการเพิ่มประเภทการแสดงผล LoadResult รายการที่ 3 ซึ่งก็คือ LoadResult.Invalid ลงใน PagingSource เมื่อ PagingSource.load แสดงผล LoadResult.Invalid การแบ่งหน้าจะทิ้งข้อมูลที่โหลดและทำให้ PagingSource ไม่ถูกต้อง ประเภทการแสดงผลนี้ออกแบบมาเพื่อจัดการข้อมูลที่อาจไม่ถูกต้องหรือล้าสมัยซึ่งอาจแสดงผลจากฐานข้อมูลหรือเครือข่าย

    ตัวอย่างเช่น หากมีการเขียนลงในฐานข้อมูลที่สำคัญ แต่ PagingSource ไม่ทำให้ข้อมูลเป็นโมฆะทันเวลา ก็อาจแสดงผลลัพธ์ที่ไม่สอดคล้องกันหากการใช้งานขึ้นอยู่กับความไม่เปลี่ยนแปลงของชุดข้อมูลสำรองที่โหลดมา (เช่น การใช้งานฐานข้อมูลสไตล์ LIMIT OFFSET) ในสถานการณ์นี้ ขอแนะนำให้ตรวจสอบการทำให้เป็นโมฆะหลังจากโหลดและแสดงผล LoadResult.Invalid ซึ่งจะทำให้เพจจิ้งทิ้งคำขอโหลดที่รอดำเนินการหรือคำขอโหลดในอนาคตไปยัง PagingSource นี้และทำให้เป็นโมฆะ

    นอกจากนี้ API ของ Paging2 ที่ใช้ประโยชน์จาก LivePagedList หรือ RxPagedList ยังรองรับประเภทการแสดงผลนี้ด้วย เมื่อใช้ PagingSource กับ API ของ PagedList ของ Paging2 ระบบจะแยก PagedList ออกทันที ซึ่งจะหยุดความพยายามในการโหลดข้อมูลใน PagedList นี้เพิ่มเติมและทริกเกอร์การทำให้ PagingSource ไม่ถูกต้อง

    LoadResult เป็นคลาสที่ปิดผนึก ซึ่งหมายความว่านี่เป็นการเปลี่ยนแปลงที่เข้ากันไม่ได้กับแหล่งที่มา ดังนั้น Use Case ที่ใช้ผลลัพธ์ PagingSource.load โดยตรงจะต้องจัดการ LoadResult.Invalid ในเวลาคอมไพล์ ตัวอย่างเช่น ผู้ใช้ Kotlin ที่ใช้ประโยชน์จาก exhaustive-when เพื่อตรวจสอบประเภทการแสดงผลจะต้องเพิ่มการตรวจสอบประเภทที่ไม่ถูกต้อง (Id6bd3, b/191806126, b/192013267)

แก้ไขข้อบกพร่อง

  • ตอนนี้ Callback การทำให้เป็นโมฆะที่เพิ่มผ่าน PagingSource.registerInvalidatedCallback หรือ DataSource.addInvalidatedCallback จะทริกเกอร์โดยอัตโนมัติหากลงทะเบียนใน PagingSource / DataSource ที่ไม่ถูกต้องอยู่แล้ว ซึ่งจะช่วยแก้ไขภาวะแข่งขันที่ทำให้เพจจิ้งทิ้งสัญญาณการทำให้เป็นโมฆะและค้างเมื่อได้รับแหล่งที่มาที่ไม่ถูกต้องอยู่แล้วระหว่างการโหลดครั้งแรก นอกจากนี้ ระบบจะนำ Callback ที่ไม่ถูกต้องออกอย่างเหมาะสมหลังจากที่มีการทริกเกอร์ เนื่องจากรับประกันว่าจะมีการเรียกใช้ Callback ไม่เกิน 1 ครั้ง (I27e69)
  • การส่งค่าเริ่มต้นของตัวยึดตำแหน่ง (InitialPagedList) จากสตรีม PagedList ที่สร้างขึ้นใหม่ เช่น LivePagedListBuilder หรือ RxPagedListBuilder จะไม่ล้างข้อมูลที่โหลดไว้ก่อนหน้านี้อีกต่อไป

เวอร์ชัน 3.1.0-alpha02

1 กรกฎาคม 2021

androidx.paging:paging-*:3.1.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 3.1.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่ม Listener onPagesPresented และ API ผู้นำเสนอขั้นตอนซึ่งจะทริกเกอร์ทันทีหลังจากที่หน้าเว็บที่นำเสนอได้รับการอัปเดตใน UI

    เนื่องจากการอัปเดตเหล่านี้ซิงโครนัสกับ UI คุณจึงเรียกใช้เมธอดอะแดปเตอร์ เช่น .snapshot, .getItemCount เพื่อตรวจสอบสถานะหลังจากใช้การอัปเดตได้ โปรดทราบว่าระบบจะปล่อยให้มีการเรียกใช้ .snapshot() อย่างชัดเจนเนื่องจากการดำเนินการนี้อาจมีค่าใช้จ่ายสูงในการอัปเดตทุกครั้ง

    การอัปเดตหน้าเว็บอาจเกิดขึ้นในสถานการณ์ต่อไปนี้

    • การโหลดครั้งแรกของ PagingData รุ่นใหม่เสร็จสมบูรณ์ ไม่ว่ารุ่นใหม่จะมีการเปลี่ยนแปลงใดๆ ในรายการที่นำเสนอหรือไม่ก็ตาม เช่น การสร้างใหม่ที่โหลดครั้งแรกเสร็จสมบูรณ์โดยไม่มีการอัปเดตเนื่องจากรายการเหมือนกันทุกประการจะยังคงทริกเกอร์ Callback นี้
    • ระบบจะแทรกหน้า แม้ว่าหน้าที่แทรกจะไม่มีรายการใหม่ก็ตาม
    • หน้าเว็บถูกทิ้ง แม้ว่าหน้าเว็บที่ทิ้งจะว่างเปล่า (I272c9, b/189999634)

แก้ไขข้อบกพร่อง

  • การเข้าถึง PagedList.dataSource จากค่าเริ่มต้นที่สร้างโดย LivePagedList หรือ RxPagedList จะไม่แสดง IllegalStateException (I96707) อย่างไม่ถูกต้องอีกต่อไป

เวอร์ชัน 3.1.0-alpha01

2 มิถุนายน 2021

androidx.paging:paging-*:3.1.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 3.1.0-alpha01 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ตอนนี้คลาสที่ paging-rxjava3 มีให้อยู่ในแพ็กเกจ androidx.paging.rxjava3 เพื่อไม่ให้ขัดแย้งกับ paging-rxjava2 (Ifa7f6)

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่บางครั้งเพจจิ้งจะส่งเหตุการณ์ที่ไม่มีการดำเนินการไปยัง RecyclerView ซึ่งอาจทำให้ Listener บางรายการทริกเกอร์ก่อนเวลาอันควร (Ic507f, b/182510751)

การมีส่วนร่วมจากภายนอก

  • เพิ่ม API ที่เข้ากันได้กับ PagedList ที่เลิกใช้งานแล้วลงในอาร์ติแฟกต์ rxjava3 (Id1ce2, b/182497591)

Paging Compose เวอร์ชัน 1.0.0

เวอร์ชัน 1.0.0-alpha20

24 พฤษภาคม 2023

androidx.paging:paging-compose:1.0.0-alpha20 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha20 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ตอนนี้ Paging Compose รองรับการแสดงตัวอย่างรายการข้อมูลจำลองโดยการสร้าง PagingData.from(fakeData) และรวม PagingData นั้นไว้ใน MutableStateFlow (เช่น MutableStateFlow(PagingData.from(listOf(1, 2, 3)))) การใช้ข้อมูลดังกล่าวเป็นอินพุตใน @Preview จะทำให้การเรียกใช้ collectAsLazyPagingItems() แสดง LazyPagingItems ที่แสดงตัวอย่างได้ (I8a78d, b/194544557)

แก้ไขข้อบกพร่อง

  • ตอนนี้ข้อมูลที่แคชไว้จาก pager.flow.cachedIn ซึ่งรวบรวมไว้ใน LazyPagingItems จะพร้อมใช้งานทันทีหลังจากกู้คืนสถานะโดยไม่ต้องรวบรวมแบบอะซิงโครนัส ซึ่งหมายความว่าข้อมูลที่แคชไว้จะพร้อมสำหรับการนำเสนอทันทีเมื่อมีการจัดองค์ประกอบครั้งแรกหลังจากกู้คืนสถานะแล้ว (I97a60, b/177245496)

เวอร์ชัน 1.0.0-alpha19

3 พฤษภาคม 2023

androidx.paging:paging-compose:1.0.0-alpha19 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha19 มีคอมมิตเหล่านี้

รองรับเลย์เอาต์แบบ Lazy ทั้งหมด

ก่อนหน้านี้ Paging Compose มีส่วนขยาย items และ itemsIndexed ที่กำหนดเองใน LazyListScope ซึ่งหมายความว่าคุณไม่สามารถใช้ Paging Compose กับเลย์เอาต์แบบ Lazy อื่นๆ เช่น LazyVerticalGrid, HorizontalPager หรือคอมโพเนนต์แบบ Lazy อื่นๆ ที่กำหนดเองซึ่งไลบรารี Wear และ TV มีให้ การแก้ไขความไม่ยืดหยุ่นนี้เป็นการอัปเดตหลักสำหรับรุ่นนี้

เพื่อรองรับเลย์เอาต์แบบ Lazy มากขึ้น เราจำเป็นต้องสร้าง API ในเลเยอร์อื่น แทนที่จะจัดเตรียม API items ที่กำหนดเองสำหรับเลย์เอาต์แบบ Lazy แต่ละรายการ ตอนนี้ Paging Compose มีเมธอดส่วนขยายระดับที่ต่ำกว่าเล็กน้อยใน LazyPagingItems ใน itemKey และ itemContentType API เหล่านี้มุ่งเน้นที่การช่วยคุณใช้พารามิเตอร์ key และ contentType กับ API items มาตรฐานที่มีอยู่แล้วสำหรับ LazyColumn, LazyVerticalGrid รวมถึงพารามิเตอร์ที่เทียบเท่าใน API เช่น HorizontalPager (Ifa13b, Ib04f0, b/259385813)

ซึ่งหมายความว่าการรองรับ LazyVerticalGrid จะมีลักษณะดังนี้

// This part is unchanged
val lazyPagingItems = pager.collectAsLazyPagingItems()

LazyVerticalGrid(columns = GridCells.Fixed(2)) {
  // Here we use the standard items API
  items(
    count = lazyPagingItems.itemCount,
    // Here we use the new itemKey extension on LazyPagingItems to
    // handle placeholders automatically, ensuring you only need to provide
    // keys for real items
    key = lazyPagingItems.itemKey { it.uniqueId },
    // Similarly, itemContentType lets you set a custom content type for each item
    contentType = lazyPagingItems.itemContentType { "contentType" }
  ) { index ->
    // As the standard items call provides only the index, we get the item
    // directly from our lazyPagingItems
    val item = lazyPagingItems[index]
    PagingItem(item = item)
  }
}

ดูตัวอย่างเพิ่มเติมเกี่ยวกับการใช้ API ใหม่เหล่านี้ได้ที่ตัวอย่างของเรา

แม้ว่าการเปลี่ยนแปลงเหล่านี้จะทำให้ตัวอย่าง LazyColumn และ LazyRow ยาวขึ้น 2-3 บรรทัด แต่เราคิดว่าความสอดคล้องกันในเลย์เอาต์แบบ Lazy ทั้งหมดเป็นปัจจัยสำคัญสำหรับผู้ที่ใช้ Paging Compose ต่อไป ด้วยเหตุนี้ เราจึงเลิกใช้งานส่วนขยายที่มีอยู่สำหรับ LazyListScope แล้ว (I0c459, I92c8f, b/276989796)

การเปลี่ยนแปลง API

  • เพื่อให้ย้ายข้อมูลไปยัง API ใหม่ได้ง่ายขึ้น ฟังก์ชันส่วนขยาย items และ itemsIndexed ใน LazyListScope จึงรองรับพารามิเตอร์ contentType แล้ว ซึ่งสอดคล้องกับการรองรับใน API ใหม่ (Ib1918, b/255283378)

การอัปเดตทรัพยากร Dependency

  • Paging Compose ได้อัปเดตทรัพยากร Dependency จาก Compose 1.0.5 เป็น Compose 1.2.1 (Ib1918, b/255283378)

เวอร์ชัน 1.0.0-alpha18

8 กุมภาพันธ์ 2023

androidx.paging:paging-compose:1.0.0-alpha18 เผยแพร่โดยไม่มีการเปลี่ยนแปลง เวอร์ชัน 1.0.0-alpha18 มีคอมมิตเหล่านี้

เวอร์ชัน 1.0.0-alpha17

24 ตุลาคม 2022

androidx.paging:paging-compose:1.0.0-alpha17 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha17 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มการรองรับ CoroutineContext ที่กำหนดเองเมื่อเรียกใช้ collectLazyPagingItems (I7a574, b/243182795, b/233783862)

เวอร์ชัน 1.0.0-alpha16

10 สิงหาคม 2022

androidx.paging:paging-compose:1.0.0-alpha16 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha16 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ตอนนี้ Paging จะแสดงบันทึกผ่านคลาส LazyPagingItems เพื่อแสดงข้อมูลการแก้ไขข้อบกพร่องที่รวบรวมจาก PagingData
  • คุณเปิดใช้บันทึกได้ผ่านคำสั่ง adb shell adb shell setprop log.tag.Paging [DEBUG|VERBOSE] ([b/235527159}(https://issuetracker.google.com/issues/235527159))

แก้ไขข้อบกพร่อง

  • แก้ไขข้อผิดพลาดเกี่ยวกับคอนสตรัคเตอร์ PagingDataDiffer ที่หายไปเมื่อใช้ paging-compose:1.0.0-alpha15 กับ paging-common:3.1.1 หรือเวอร์ชันที่เก่ากว่า (b/235256201,b/239868768)

เวอร์ชัน 1.0.0-alpha15

1 มิถุนายน 2022

androidx.paging:paging-compose:1.0.0-alpha15 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha15 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มคอนสตรักเตอร์สำหรับ PagingDataAdapter และ AsyncPagingDataDiffer ซึ่งยอมรับ CoroutineContext แทน CoroutineDispatcher (Idc878)

แก้ไขข้อบกพร่อง

  • ตอนนี้ LazyPagingItems จะตั้งค่า loadState เริ่มต้นให้มีการรีเฟรช LoadState.Loading (I55043, b/224855902)

เวอร์ชัน 1.0.0-alpha14

13 ตุลาคม 2021

androidx.paging:paging-compose:1.0.0-alpha14 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha14 มีคอมมิตเหล่านี้

เวอร์ชัน 1.0.0-alpha13

29 กันยายน 2021

androidx.paging:paging-compose:1.0.0-alpha13 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha13 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • แทนที่ฟังก์ชัน LazyPagingItems.snapshot() ด้วยพร็อพเพอร์ตี้ LazyPagingItems.itemSnapshotList (Ie2da8)
  • นำ LazyPagingItems.getAsState() ที่เลิกใช้งานออกแล้ว (Ie65e4)

เวอร์ชัน 1.0.0-alpha12

21 กรกฎาคม 2021

androidx.paging:paging-compose:1.0.0-alpha12 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha12 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ตอนนี้ items(lazyPagingItems) และ itemsIndexed(lazyPagingItems) ที่ใช้เชื่อมต่อเพจจิ้งกับ LazyColumn/Row จะยอมรับพารามิเตอร์คีย์ตัวเลือกซึ่งช่วยให้คุณระบุคีย์ที่เสถียรซึ่งแสดงถึงรายการได้ อ่านข้อมูลเพิ่มเติมเกี่ยวกับคีย์ได้ที่นี่ (I7986d)
  • ฟังก์ชัน lazyPagingItems.getAsState(index) เลิกใช้งานแล้ว โปรดใช้ lazyPagingItems[index] แทน (I086cb, b/187339372)

เวอร์ชัน 1.0.0-alpha11

30 มิถุนายน 2021

androidx.paging:paging-compose:1.0.0-alpha11 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha11 มีคอมมิตเหล่านี้

เวอร์ชัน 1.0.0-alpha10

2 มิถุนายน 2021

androidx.paging:paging-compose:1.0.0-alpha10 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha10 มีคอมมิตเหล่านี้

เวอร์ชัน 1.0.0-alpha09

18 พฤษภาคม 2021

androidx.paging:paging-compose:1.0.0-alpha09 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha09 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • ตอนนี้ itemCount และ Item Getter ของ LazyPagingItems สังเกตได้แล้ว ซึ่งช่วยให้ใช้กับ LazyVerticalGrid ได้ด้วย (Ie2446, b/171872064, b/168285687)

ความเข้ากันได้ของ Compose

  • androidx.paging:paging-compose:1.0.0-alpha09 ใช้ได้กับ Compose เวอร์ชัน 1.0.0-beta07 ขึ้นไปเท่านั้น

เวอร์ชัน 1.0.0-alpha08

24 กุมภาพันธ์ 2021

androidx.paging:paging-compose:1.0.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha08 มีคอมมิตเหล่านี้

อัปเดตเพื่อผสานรวมกับ Compose 1.0.0-beta01

เวอร์ชัน 1.0.0-alpha07

10 กุมภาพันธ์ 2021

androidx.paging:paging-compose:1.0.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha07 มีคอมมิตเหล่านี้

อัปเดตเพื่อผสานรวมกับ Compose alpha12

เวอร์ชัน 1.0.0-alpha06

28 มกราคม 2021

androidx.paging:paging-compose:1.0.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha06 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

อัปเดตให้ขึ้นอยู่กับ Compose 1.0.0-alpha11

เวอร์ชัน 1.0.0-alpha05

13 มกราคม 2021

androidx.paging:paging-compose:1.0.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha05 มีคอมมิตเหล่านี้

อัปเดตให้ขึ้นอยู่กับ Compose 1.0.0-alpha10

เวอร์ชัน 1.0.0-alpha04

16 ธันวาคม 2020

androidx.paging:paging-compose:1.0.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha04 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • อัปเดตพร็อพเพอร์ตี้อำนวยความสะดวก CombinedLoadStates.refresh, CombinedLoadStates.prepend, CombinedLoadStates.append ให้เปลี่ยนจาก Loading เป็น NotLoading หลังจากที่ทั้งสถานะการโหลดของสื่อกลางและแหล่งที่มาเป็น NotLoading เพื่อให้แน่ใจว่ามีการใช้การอัปเดตระยะไกลแล้ว (I65619)

เวอร์ชัน 1.0.0-alpha03

2 ธันวาคม 2020

androidx.paging:paging-compose:1.0.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha03 มีคอมมิตเหล่านี้

  • อัปเดตให้ตรงกับ Compose 1.0.0-alpha08

เวอร์ชัน 1.0.0-alpha02

11 พฤศจิกายน 2020

androidx.paging:paging-compose:1.0.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha02 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มเมธอด .peek(), .snapshot(), .retry() และ .refresh() ลงใน LazyPagingItem ซึ่งแสดงฟังก์ชันการทำงานเดียวกันกับที่มีใน AsyncPagingDataDiffer / PagingDataAdapter (Iddfe8, b/172041660)

เวอร์ชัน 1.0.0-alpha01

28 ตุลาคม 2020

androidx.paging:paging-compose:1.0.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

อาร์ติแฟกต์ paging-compose ช่วยผสานรวมระหว่างไลบรารีการแบ่งหน้ากับ Jetpack Compose ตัวอย่างการใช้งานง่ายๆ มีดังนี้

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

เวอร์ชัน 3.0.1

เวอร์ชัน 3.0.1

21 กรกฎาคม 2021

androidx.paging:paging-*:3.0.1 เผยแพร่แล้ว เวอร์ชัน 3.0.1 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • การเข้าถึง PagedList.dataSource จากค่าเริ่มต้นที่สร้างโดย LivePagedList หรือ RxPagedList จะไม่แสดง IllegalStateException (I96707) อย่างไม่ถูกต้องอีกต่อไป

เวอร์ชัน 3.0.0

เวอร์ชัน 3.0.0

5 พฤษภาคม 2021

androidx.paging:paging-*:3.0.0 เผยแพร่แล้ว เวอร์ชัน 3.0.0 มีคอมมิตเหล่านี้

ฟีเจอร์หลักของ 3.0.0

เราเลิกใช้งาน API ส่วนใหญ่ที่มีอยู่จาก Paging 2.x.x แล้วเพื่อใช้ API ของ Paging 3 ใหม่ซึ่งมีการปรับปรุงต่อไปนี้

  • การรองรับระดับเฟิร์สคลาสสำหรับโครูทีนและ Flow ของ Kotlin
  • การสนับสนุนสำหรับการยกเลิก
  • สัญญาณสถานะการโหลดและข้อผิดพลาดในตัว
  • ฟังก์ชันลองใหม่ + รีเฟรช
  • คลาสย่อย DataSource ทั้ง 3 คลาสได้รวมเข้าเป็นคลาส PagingSource แบบรวม
  • การเปลี่ยนรูปแบบหน้าเว็บที่กำหนดเอง รวมถึงการเปลี่ยนรูปแบบในตัวสำหรับการเพิ่มตัวคั่น
  • กำลังโหลดส่วนหัวและส่วนท้ายของสถานะ

เวอร์ชัน 3.0.0-rc01

21 เมษายน 2021

androidx.paging:paging-*:3.0.0-rc01 เผยแพร่แล้ว เวอร์ชัน 3.0.0-rc01 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่บางครั้งเพจจิ้งจะส่งเหตุการณ์ที่ไม่มีการดำเนินการไปยัง RecyclerView ซึ่งอาจทำให้ Listener บางรายการทริกเกอร์ก่อนเวลาอันควร (Ic507f, b/182510751)

เวอร์ชัน 3.0.0-beta03

24 มีนาคม 2021

androidx.paging:paging-*:3.0.0-beta03 เผยแพร่แล้ว เวอร์ชัน 3.0.0-beta03 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • เราได้ปรับปรุงวิธีจัดการตัวยึดตำแหน่งเมื่อโหลดรายการซ้ำเพื่อป้องกันการข้ามที่ไม่คาดคิดใน RecyclerView ดูรายละเอียดได้ที่ NullPaddedDiffing.md (If1490, b/170027529, b/177338149)
  • เครื่องมือสร้าง PagedList ต่างๆ (เส้นทางความเข้ากันได้แบบเก่า) จะไม่เรียกใช้ DataSource.Factory.create() แบบซิงโครนัสอย่างไม่ถูกต้องในเทรดหลักเมื่อมีการเรียกใช้ .build() อีกต่อไป (b/182798948)

เวอร์ชัน 3.0.0-beta02

10 มีนาคม 2021

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 แสดงผลอาจทำให้ Paging ไม่สามารถดึงข้อมูลอีกครั้งเพื่อดำเนินการ prefetchDistance ให้เสร็จสมบูรณ์ ซึ่งทำให้ Paging "ค้าง"

เวอร์ชัน 3.0.0-beta01

10 กุมภาพันธ์ 2021

androidx.paging:paging-*:3.0.0-beta01 เผยแพร่แล้ว เวอร์ชัน 3.0.0-beta01 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ตอนนี้ Wrapper ของ Rx2 และ Rx3 จะแสดงคำอธิบายประกอบเวอร์ชันทดลองที่ใช้ หากใช้ Wrapper ที่เข้ากันได้กับ Rx ใน paging-rxjava2 หรือ paging-rxjava3 ตอนนี้คุณจะต้องใส่คำอธิบายประกอบการใช้งานด้วย @OptIn(ExperimentalCoroutinesApi::class) (Ib1f9d)

แก้ไขข้อบกพร่อง

  • แก้ไข IndexOutOfBoundsException: Inconsistency detected ที่บางครั้งเกิดขึ้นเมื่อใช้ API v2 DataSource ผ่านเส้นทางความเข้ากันได้
  • ตอนนี้การเรียก isInvalid ระหว่างการเริ่มต้น DataSource เมื่อใช้ผ่านเส้นทางความเข้ากันได้จะเปิดขึ้นอย่างถูกต้องใน fetchDispatcher แทนที่จะเป็นเทรดหลัก การดำเนินการนี้จะแก้ไข IllegalStateException ที่เกิดจากการเข้าถึงฐานข้อมูลในชุดข้อความหลักเมื่อใช้การติดตั้งใช้งาน PagingSource ของ Room

เวอร์ชัน 3.0.0-alpha13

27 มกราคม 2021

androidx.paging:paging-*:3.0.0-alpha13 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha13 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • PagingSource.getRefreshKey ไม่ใช่ตัวเลือกในการติดตั้งใช้งานอีกต่อไป แต่ตอนนี้เป็นฟังก์ชันนามธรรมที่ไม่มีการติดตั้งใช้งานเริ่มต้น ผู้ใช้ที่ย้ายข้อมูลสามารถเลือกที่จะแสดงผลการติดตั้งใช้งานเริ่มต้นต่อไป ซึ่งจะแสดงผล null แต่ getRefreshKey() ควรมีการติดตั้งใช้งานจริงที่แสดงผลคีย์ตามตำแหน่งการเลื่อนปัจจุบันของผู้ใช้ ซึ่งช่วยให้ Paging โหลดต่อไปโดยมีจุดศูนย์กลางอยู่ที่วิวพอร์ตผ่าน PagingState.anchorPosition หากเป็นไปได้ (I4339a)
  • InvalidatingPagingSourceFactory เป็นคลาสสุดท้ายแล้ว (Ia3b0a)
  • อนุญาตให้กำหนดค่าลักษณะการทำงานของตัวคั่นเทอร์มินัล (ส่วนหัว/ส่วนท้าย) ด้วยพารามิเตอร์ SeparatorType เพิ่มเติมที่ไม่บังคับ โดยมี 2 ตัวเลือกดังนี้
    • FULLY_COMPLETE - ลักษณะการทำงานที่มีอยู่ รอให้ทั้ง PagingSource และ RemoteMediator ทำเครื่องหมาย endOfPaginationReached ก่อนเพิ่มตัวคั่นเทอร์มินัล หากไม่ได้ใช้ RemoteMediator ระบบจะไม่สนใจ loadState ระยะไกล ซึ่งจะมีประโยชน์เป็นหลักหากคุณต้องการแสดงตัวคั่นส่วนเมื่อโหลดส่วนนั้นจนเสร็จสมบูรณ์เท่านั้น ซึ่งรวมถึงการดึงข้อมูลจากแหล่งที่มาระยะไกล เช่น เครือข่าย
    • SOURCE_COMPLETE - รอให้ PagingSource ทำเครื่องหมาย endOfPaginationReached เท่านั้น แม้ว่าจะใช้ RemoteMediator ก็ตาม ซึ่งจะช่วยให้ส่วนหัวและส่วนท้ายแสดงพร้อมกันกับการโหลดครั้งแรก ซึ่งช่วยป้องกันไม่ให้ผู้ใช้ต้องเลื่อนเพื่อดูตัวคั่นเทอร์มินัล (Ibe993, b/174700218)

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาหน่วยความจำรั่วไหลที่เกิดขึ้นไม่บ่อยนักเมื่อ PagingSource ไม่ถูกต้องก่อนที่ PageFetcher จะเริ่มโหลดจากแหล่งที่มาดังกล่าว (I9606b, b/174625633)

เวอร์ชัน 3.0.0-alpha12

13 มกราคม 2021

androidx.paging:paging-*:3.0.0-alpha12 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha12 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • InvalidatingPagingSourceFactory ไม่ใช่คลาสแอบสแตรกอีกต่อไปเนื่องจากไม่เคยมีเมธอดแอบสแตรก (I4a8c4)
  • เพิ่มโอเวอร์โหลดของ .cachedIn() ที่ยอมรับ ViewModel แทน Lifecycle หรือ CoroutineScope สำหรับผู้ใช้ Java (I97d81, b/175332619)
  • อนุญาตให้ผู้เรียก Java ใช้การดำเนินการเปลี่ยนรูปแบบ PagingData ในลักษณะไม่พร้อมกัน โดยยอมรับ Executor ในอาร์กิวเมนต์โอเปอเรเตอร์การเปลี่ยนรูปแบบ ตอนนี้โอเปอเรเตอร์การเปลี่ยนรูปแบบ -Sync ทั้งหมดได้นำคำต่อท้าย -Sync ออกแล้ว และผู้ใช้ Kotlin Coroutine จะต้องแก้ความกำกวมโดยการเรียกใช้ฟังก์ชันส่วนขยายที่ยอมรับบล็อกการระงับแทน ย้ายโอเปอเรเตอร์การเปลี่ยนรูปแบบ PagingData ทั้งหมดไปยังส่วนขยายภายใต้คลาส PagingDataTransforms แบบคงที่แล้ว ผู้ใช้ Java จะต้องเรียกใช้ผ่านตัวช่วยแบบคงที่ เช่น PagingDataTransforms.map(pagingData, transform) สำหรับผู้ใช้ Kotlin ไวยากรณ์จะเหมือนกัน แต่คุณจะต้องนำเข้าฟังก์ชัน (If6885, b/172895919)

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องที่ระบบไม่เรียกใช้ RemoteMediator.load() ระหว่าง adapter.refresh() หากถึงจุดสิ้นสุดของการแบ่งหน้าแล้ว

เวอร์ชัน 3.0.0-alpha11

16 ธันวาคม 2020

androidx.paging:paging-*:3.0.0-alpha11 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha11 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มการรองรับสถานะที่บันทึกไว้สำหรับกรณีการใช้งานพื้นฐานต่อไปนี้ (การรองรับอย่างเต็มรูปแบบ โดยเฉพาะในกรณีแหล่งที่มาแบบเลเยอร์ยังอยู่ระหว่างการพัฒนา)
    • ระบบจะแคชโฟลว์และไม่ปิดแอปพลิเคชัน (เช่น ระบบจะแคชโฟลว์ในโมเดลมุมมองและสร้างกิจกรรมขึ้นมาใหม่ในกระบวนการ)
    • ระบบจะนับแหล่งที่มาของการแบ่งหน้า เปิดใช้ตัวยึดตำแหน่ง และเลย์เอาต์จะไม่สลับกัน

การเปลี่ยนแปลง API

  • PagingSource.getRefreshKey() เป็น API ที่เสถียรแล้ว (I22f6f, b/173530980)
  • PagingSource.invalidate ไม่ใช่ฟังก์ชันแบบเปิดอีกต่อไป หากต้องการรับการแจ้งเตือนเมื่อเกิดการทำให้เป็นโมฆะ ให้พิจารณาเรียกใช้เมธอด registerInvalidatedCallback แทนการลบล้าง invalidate (I628d9, b/173029013, b/137971356)
  • ตอนนี้ Pager มีคอนสตรัคเตอร์ทดลองรายการเดียวควบคู่ไปกับคอนสตรัคเตอร์ปกติ แทนที่จะรั่วไหล API ทดลองไปยัง API สาธารณะที่ไม่ใช่เวอร์ชันทดลองผ่านคำอธิบายประกอบการเลือกใช้ (I9dc61, b/174531520)
  • อัปเดตพร็อพเพอร์ตี้อำนวยความสะดวก CombinedLoadStates.refresh, CombinedLoadStates.prepend, CombinedLoadStates.append ให้เปลี่ยนจาก Loading เป็น NotLoading หลังจากที่ทั้งสถานะการโหลดของสื่อกลางและแหล่งที่มาเป็น NotLoading เพื่อให้แน่ใจว่ามีการใช้การอัปเดตระยะไกลแล้ว (I65619)
  • นำ LoadParams.pageSize ออกแล้ว (เลิกใช้งานแล้ว) เราขอแนะนำให้ใช้ LoadParams.loadSize ใน PagingSource

    LoadParams.loadSize จะเท่ากับ PagingConfig.pageSize เสมอ ยกเว้นการเรียกโหลดครั้งแรกซึ่งจะเท่ากับ PagingConfig.initialLoadSize

    หากคุณกำลังทดสอบ DataSource ของ Paging2 โดยไม่ใช้ Pager หรือ PagedList pageSize อาจไม่ตรงกับ PagingConfig.pageSize หากคุณตั้งค่า initialLoadSize ด้วย หากการดำเนินการนี้สำคัญสำหรับการทดสอบ ให้ลองใช้ Pager/PagedList แทน ซึ่งจะตั้งค่า PageSize ที่ถูกต้องสำหรับเมธอดการโหลด DataSource ภายใน (I98ac7, b/149157296)

แก้ไขข้อบกพร่อง

  • แก้ไขข้อขัดข้องที่เกิดจาก IllegalStateException เมื่อใช้ตัวคั่นที่มีการตั้งค่า PagingConfig.maxSize (I0ed33, b/174787528)
  • แก้ไขข้อบกพร่องที่สถานะการโหลดสำหรับ PREPEND / APPEND ไม่อัปเดตเป็น NotLoading(endOfPaginationReached = true) ทันทีหลังจากการโหลดครั้งแรกหากมีการตั้งค่า RemoteMediator (I8cf5a)
  • แก้ไขข้อบกพร่องที่ API ฝั่งผู้นำเสนอ เช่น .snapshot(), .peek() ฯลฯ จะแสดงรายการก่อนหน้า (ล้าสมัย) ภายในการอัปเดต ListUpdateCallback
  • แก้ไขข้อบกพร่องที่โอเปอเรเตอร์ตัวคั่นไม่เพิ่มส่วนหัวหรือส่วนท้ายเมื่อใช้กับ RemoteMediator
  • แก้ไขข้อบกพร่องที่การอัปเดต LoadState เป็น NotLoading สำหรับ RemoteMediator จะค้างอยู่ในสถานะ Loading
  • แก้ไขข้อบกพร่องที่ API ความเข้ากันได้ของ Paging2.0 .asPagingSourceFactory() อาจทำให้ DataSource ที่สนับสนุนได้รับการเริ่มต้นใน CoroutineDispatcher ที่ไม่ถูกต้อง ซึ่งจะช่วยแก้ปัญหาข้อขัดข้องและกรณี ANR ที่อาจเกิดขึ้น โดยเฉพาะเมื่อใช้การติดตั้งใช้งาน PagingSource ปัจจุบันของ Room ซึ่งใช้เส้นทางความเข้ากันได้นี้

เวอร์ชัน 3.0.0-alpha10

2 ธันวาคม 2020

androidx.paging:paging-*:3.0.0-alpha10 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha10 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เราได้นำ API dataRefreshFlow และ dataRefreshListener ที่เลิกใช้งานแล้วออกเนื่องจากซ้ำซ้อนกับการอัปเดต loadStateFlow / Listener สำหรับผู้ที่ย้ายข้อมูล loadStateFlow ที่เทียบเท่าคือ

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

    (Ib5570, b/173530908)

แก้ไขข้อบกพร่อง

  • ตอนนี้ endOfPaginationReached สำหรับ RemoteMediator REFRESH จะเผยแพร่ไปยังการอัปเดต LoadState อย่างถูกต้อง และป้องกันไม่ให้ APPEND และ PREPEND ระยะไกลทริกเกอร์ (I94a3f, b/155290248)
  • การแสดงรายการที่ว่างเปล่าเนื่องจากหน้าเริ่มต้นว่างเปล่าหรือการกรองที่เข้มงวดจะไม่ทำให้การแบ่งหน้าไม่สามารถเริ่มโหลด PREPEND หรือ APPEND ได้อีกต่อไป (I3e702, b/168169730)
  • แก้ไขปัญหาที่ไม่มีการเรียกใช้ getRefreshKey ใน PagingSource รุ่นต่อๆ มาเมื่อเกิดการทำให้เป็นโมฆะอย่างรวดเร็ว (I45460, b/170027530)

การมีส่วนร่วมจากภายนอก

  • เพิ่มคลาส Abstract ใหม่ InvalidatingPagingSourceFactory พร้อมด้วย .invalidate() API ที่ส่งต่อการทำให้เป็นโมฆะไปยัง PagingSource ทั้งหมดที่ส่งออกมา ขอขอบคุณ @claraf3 (Ie71fc, b/160716447)

ปัญหาที่ทราบ

  • ส่วนหัวและส่วนท้ายจาก .insertSeparators() transform อาจไม่ปรากฏทันทีเมื่อใช้ RemoteMediator b/172254056
  • การใช้ RemoteMediator อาจทำให้ LoadState ระยะไกลติดขัดหากการทำให้เป็นโมฆะและ PagingSource.load(LoadParams.Refresh(...)) เสร็จสมบูรณ์ก่อนที่ RemoteMediator.load() จะแสดงผล b/173717820

เวอร์ชัน 3.0.0-alpha09

11 พฤศจิกายน 2020

androidx.paging:paging-*:3.0.0-alpha09 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha09 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เลิกใช้งานเมธอด dataRefreshFlow / Listener โดยสมบูรณ์ด้วยคำสั่ง replaceWith (I6e2dd)

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่ IllegalArgumentException ถูกส่งเมื่อใช้ตัวคั่นกับ RemoteMediator และมีการทริกเกอร์การทำให้เป็นโมฆะขณะที่การโหลดระยะไกลซึ่งจะแสดงผล endOfPagination ยังคงทำงานอยู่ (I3a260)

เวอร์ชัน 3.0.0-alpha08

28 ตุลาคม 2020

androidx.paging:paging-*:3.0.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha08 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ตัวแปร Kotlin / Java ของ DataSource.InvalidatedCallback ได้รวมเข้าด้วยกันโดยเปิดใช้การแปลง SAM ใน Kotlin ผ่านอินเทอร์เฟซแบบฟังก์ชัน (พร้อมใช้งานใน Kotlin 1.4) นอกจากนี้ยังแก้ไขข้อบกพร่องที่ไม่มีการเรียกใช้ Callback ของ invalidate ในตัวแปร kotlin หลังจากแปลงโดย .map หรือ .mapByPage (I1f244, b/165313046)

แก้ไขข้อบกพร่อง

  • การโต้ตอบของ Paging กับ ViewPager ได้รับการปรับปรุงอย่างมาก กล่าวคือ เพจจิ้งจะไม่ยกเลิกการติดต่อ RemoteMediator#load เนื่องจากหน้าไม่ถูกต้องอีกต่อไป นอกจากนี้ ระบบจะไม่ส่งคำขอโหลดต่อท้าย/ต่อหน้าอีกต่อไปหากจำเป็นต้องใช้ REFRESH จนกว่าคำขอ REFRESH จะเสร็จสมบูรณ์ (I6390b, b/162252536)
  • เปิดใช้การตรวจสอบ Lint ของ API สำหรับ MissingGetterMatchingBuilder สำหรับ androidx (I4bbea, b/138602561)
  • แก้ไขข้อบกพร่องที่ตัวช่วย .withLoadState* ConcatAdapter ขัดข้องเนื่องจากการแจ้งเตือน RecyclerView จากเทรดที่ทำงานอยู่เบื้องหลัง (I18bb5, b/170988309)
  • แก้ไขข้อบกพร่องที่การโหลดหน้าเว็บขนาดเล็กมากซึ่งมีข้อมูลบางครั้งทำให้การดึงข้อมูลล่วงหน้าไม่เรียกให้โหลดอย่างถูกต้องIffda3 b/169259468

เวอร์ชัน 3.0.0-alpha07

1 ตุลาคม 2020

androidx.paging:paging-*:3.0.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha07 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ตอนนี้โอเปอเรเตอร์ที่ใช้ Guava ของ Async PagingData จะยอมรับ Executor เป็นพารามิเตอร์เพื่อควบคุมบริบทการดำเนินการ (Id4372)

แก้ไขข้อบกพร่อง

  • แก้ไขข้อยกเว้น IndexOutOfBounds ที่แสดงใน RemoteMediator เนื่องจากภาวะแข่งขัน (I00b7f, b/165821814)
  • แก้ไขภาวะแข่งขันในการแปลง DataSource -> PagingSource ซึ่งอาจทำให้ PagingSource ที่ได้ละเว้นสัญญาณการทำให้เป็นโมฆะจาก DataSource
  • แก้ไขปัญหาในตรรกะการดึงข้อมูลหน้าเว็บซึ่งบางครั้งทำให้ไม่สามารถรับ PagingSource รุ่นใหม่ได้จนกว่าจะมีการเรียกใช้ PagingDataAdapter.refresh()
  • แก้ไขปัญหาที่ทำให้ตำแหน่งการเลื่อนหายไปในบางครั้งเมื่อใช้ DataSource ที่แปลงเป็น PagingSource (เช่น แหล่งข้อมูลที่สร้างโดย Room) ร่วมกับ RemoteMediator

การมีส่วนร่วมจากภายนอก

  • ขอขอบคุณ @simonschiller ที่เพิ่มโอเปอเรเตอร์การเปลี่ยนรูปแบบแบบไม่พร้อมกันที่ใช้ RxJava2, RxJava3 และ Guava สำหรับ PagingData

เวอร์ชัน 3.0.0-alpha06

2 กันยายน 2020

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

19 สิงหาคม 2020

androidx.paging:paging-*:3.0.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha05 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • ตอนนี้เพจจิ้งจะดึงข้อมูลล่วงหน้าหน้าข้อมูลเพิ่มเติมอย่างถูกต้องแม้ว่าข้อมูลที่แสดงจะได้รับการกรองอย่างเข้มงวดก็ตาม
  • การส่งคืน LoadResult.Error ไปยังการโหลดที่ลองใหม่จะไม่ทำให้การเข้าถึงรายการเรียกใช้การลองใหม่อย่างไม่ถูกต้องอีกต่อไป

การมีส่วนร่วมจากภายนอก

  • ขอขอบคุณ Clara F ที่ช่วยล้างการทดสอบบางรายการ (549612)

เวอร์ชัน 3.0.0-alpha04

5 สิงหาคม 2020

androidx.paging:paging-*:3.0.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha04 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่ม peek() API ลงใน AsyncPagingDataDiffer และ PagingDataAdapter เพื่ออนุญาตให้เข้าถึงข้อมูลที่นำเสนอโดยไม่ต้องทริกเกอร์การโหลดหน้าเว็บ (I38898, b/159104197)
  • เพิ่ม snapshot() API ลงใน PagingDataAdapter และ AsyncPagingDataDiffer เพื่อให้ดึงข้อมูลรายการที่แสดงได้โดยไม่ต้องเรียกใช้การดึงข้อมูลหน้าเว็บ (I566b6, b/159104197)
  • เพิ่มตัวสร้าง PagingData.from(List<T>) เพื่ออนุญาตการแสดงรายการแบบคงที่ ซึ่งสามารถรวมกับโฟลว์ PagingData โดยรวมเพื่อแสดงรายการแบบคงที่ในบางสถานะ เช่น ก่อนที่ REFRESH เริ่มต้นจะเสร็จสิ้น หรือเพียงเพื่อทดสอบการเปลี่ยนรูปแบบ (Id134d)
  • เลิกใช้งาน dataRefresh Flow / Listener API เนื่องจากมีไว้เพื่อแสดงสถานะรายการที่แสดงใน REFRESH แต่ด้วยการปรับปรุงเวลาเรียกกลับของ loadState Flow / Listener และพร็อพเพอร์ตี้ itemCount จึงทำให้เกิดความซ้ำซ้อน (Ia19f3)
  • เพิ่ม Wrapper ความเข้ากันได้ของ RxJava3 สำหรับ PagingSource และ RemoteMediator (I49ef3, b/161480176)

แก้ไขข้อบกพร่อง

  • PositionalDataSource แปลงเป็น PagingSource ผ่านตัวช่วย toPagingSourceFactory รวมถึง PagingSource ที่สร้างโดย Room จะทำเครื่องหมายตัวเองอย่างถูกต้องเพื่อรองรับการข้าม (I3e84c, b/162161201)
  • แก้ไขข้อบกพร่องที่การใช้ตัวแปรแบบซิงโครนัสของ submitData บางครั้งอาจทำให้เกิด Race Condition ซึ่งส่งผลให้เกิด ClosedSendChannelException (I4d702, b/160192222)

การมีส่วนร่วมจากภายนอก

  • ขอขอบคุณ Zac Sweers ที่เพิ่ม Wrapper ความเข้ากันได้ของ RxJava3 ในนามของ Slack (I49ef3, b/161480176)

เวอร์ชัน 3.0.0-alpha03

22 กรกฎาคม 2020

androidx.paging:paging-*:3.0.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha03 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ตอนนี้ตัวสร้างสำหรับ PagingState เป็นแบบสาธารณะแล้ว ซึ่งจะช่วยให้การทดสอบการใช้งาน getRefreshKey() ง่ายขึ้น (I8bf15)
  • ซ่อนตัวแปรฟังก์ชัน Kotlin Map ของ DataSource จาก Java เพื่อแก้ไขความกำกวมระหว่างตัวแปร Kotlin กับตัวแปรเดิม (If7b23, b/161150011)
  • API ที่ซ้ำซ้อนซึ่งมีไว้เพื่ออำนวยความสะดวกให้ผู้ใช้ Kotlin ได้รับการทำเครื่องหมายเป็น @JvmSynthetic (I56ae5)
  • เพิ่มโอเวอร์โหลดสำหรับคอนสตรัคเตอร์ของ LoadResult.Page ซึ่งกำหนดค่าเริ่มต้น itemsBefore และ itemsAfter เป็น COUNT_UNDEFINED (I47849)
  • ทำให้โอเปอเรเตอร์ PagingData ที่มีอยู่ยอมรับเมธอดการระงับ และเปิดตัวโอเปอเรเตอร์ mapSync, flatMapSync และ filterSync แบบไม่ระงับใหม่สำหรับผู้ใช้ Java เราได้ย้ายเมธอดการเปลี่ยนรูปแบบที่มีอยู่ไปยังฟังก์ชันส่วนขยายแล้ว ดังนั้นผู้ใช้ Kotlin จะต้องนำเข้าฟังก์ชันดังกล่าว (I34239, b/159983232)

แก้ไขข้อบกพร่อง

  • ตอนนี้ Room (และ PositionalDataSource) PagingSources จะแสดงตัวคั่นนำหน้าเป็นส่วนหนึ่งของหน้าแรก เพื่อให้ผู้ใช้ไม่ต้องเลื่อนเพื่อแสดงตัวคั่น (I6f747, b/160257628)
  • ตอนนี้การเข้าถึงรายการในตัวยึดตำแหน่งจะทริกเกอร์การโหลด PagingSource อย่างถูกต้องจนกว่าจะมีการแสดงผลหน้าเว็บที่ตรงกับดัชนีที่ขอหลังจากเปลี่ยนรูปแบบโดย PagingData.filter() (I95625, b/158763195)
  • แก้ไขข้อบกพร่องที่บางครั้งการเลื่อนหลังจาก PagingSource แสดงข้อผิดพลาดอาจทำให้ PagingDataAdapter.retry() ไม่ลองใหม่ (I1084f, b/160194384)
  • แก้ไขปัญหาที่การเข้าถึงรายการหลังจากวางหน้าอาจไม่โหลดหน้า แม้ว่าการเข้าถึงรายการจะอยู่ภายใน prefetchDistance (Ie95ae, b/160038730)
  • การตั้งค่า PagingConfig.maxSize จะไม่เปิดใช้ตัวยึดตำแหน่งอีกต่อไปหลังจากเหตุการณ์การวาง (I2be29, b/159667766)

เวอร์ชัน 3.0.0-alpha02

24 มิถุนายน 2020

androidx.paging:paging-*:3.0.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha02 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มโอเวอร์โหลดสำหรับคอนสตรัคเตอร์ของ PagingConfig ที่มีค่าเริ่มต้นทั่วไป (I39c50, b/158576040)
  • เพิ่มโอเวอร์โหลดสำหรับคอนสตรัคเตอร์ของ PagingDataAdapter และ AsyncPagingDataDiffer ที่มีค่าเริ่มต้นทั่วไป (Ie91f5)
  • ตอนนี้ API ของอะแดปเตอร์ dataRefreshFlow และ dataRefreshListener จะส่งบูลีนเพื่อส่งสัญญาณว่า PagingData ว่างเปล่าหรือไม่ (I6e37e, b/159054196)
  • เพิ่ม RxJava และ Guava API สำหรับ RemoteMediator - RxRemoteMediator และ ListenableFutureRemoteMediator
  • เพิ่มตัวช่วยลงใน PagingState สำหรับการเข้าถึงรายการทั่วไป เช่น isEmpty() และ firstItemOrNull() (I3b5b6, b/158892717)

แก้ไขข้อบกพร่อง

  • ตอนนี้ Pager จะตรวจสอบการใช้ PagingSource ซ้ำในโรงงานเพื่อป้องกันการใช้ PagingSource ที่ไม่ถูกต้องซ้ำโดยไม่ตั้งใจ ซึ่งทำให้เกิดข้อผิดพลาดที่ไม่ชัดเจน (I99809, b/158486430)
  • ข้อผิดพลาดจาก REFRESH ของ RemoteMediator จะไม่ป้องกันไม่ให้ PagingSource โหลดอีกต่อไป (I38b1b, b/158892717)
  • เวอร์ชันที่ไม่ระงับของ submitData จะไม่ทำให้เกิดข้อขัดข้องเนื่องจากการรวบรวมพร้อมกันใน PagingData หลายรายการอีกต่อไปเมื่อเรียกใช้หลังจากเวอร์ชันที่ระงับของ submitData (I26358, b/158048877)
  • แก้ไขข้อยกเว้น "ไม่สามารถรวบรวมข้อมูลจากเพจเจอร์ได้ 2 ครั้ง" ที่อาจเกิดขึ้นหลังจากการเปลี่ยนแปลงการกำหนดค่า (I58bcc, b/158784811)

เวอร์ชัน 3.0.0-alpha01

10 มิถุนายน 2020

androidx.paging:paging-*:3.0.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 3.0.0-alpha01 มีคอมมิตเหล่านี้

ไลบรารี Paging ได้รับการอัปเดตเป็น 3.0 เพื่อเปิดใช้ฟีเจอร์ใหม่ที่สำคัญหลายรายการ

ฟีเจอร์ใหม่ของ 3.0

ปัญหาที่ทราบ

  • Javadoc ของ Paging 3 ยังไม่พร้อมใช้งาน ในระหว่างนี้ โปรดใช้คำแนะนำที่ลิงก์ไว้ด้านบนหรือเอกสาร Kotlin (b/158614050)

เวอร์ชัน 2.1.2

เวอร์ชัน 2.1.2

18 มีนาคม 2020

androidx.paging:paging:2.1.2 เผยแพร่แล้ว เวอร์ชัน 2.1.2 มีคอมมิตเหล่านี้เทียบกับ 2.1.0

แก้ไขข้อบกพร่อง

  • แก้ไข IndexOutOfBoundsException ในกรณีที่พบได้ยากเมื่อแปลงตำแหน่งระหว่างการทำให้เป็นโมฆะ

ปัญหาเกี่ยวกับรุ่น

  • Paging เวอร์ชัน 2.1.1 เผยแพร่อย่างไม่ถูกต้องจาก Branch ที่กำหนดค่าไม่ถูกต้อง ซึ่งทำให้ API และฟังก์ชันการทำงานที่ใช้งานบางส่วนซึ่งจะเปิดตัวในรุ่นต่อๆ ไปปรากฏขึ้น

  • Paging 2.1.2 มีการแก้ไขการจัดศูนย์กลางการโหลดที่เปิดตัวครั้งแรกใน 2.1.1 แต่ครั้งนี้ได้เลือกเฉพาะส่วนที่ถูกต้องไว้ด้านบนของรุ่น 2.1.0 เราขอแนะนำเป็นอย่างยิ่งให้อัปเกรดเป็นรุ่นนี้หากคุณใช้เวอร์ชัน 2.1.1 อยู่

เวอร์ชัน 2.1.1

เวอร์ชัน 2.1.1

18 ธันวาคม 2019

androidx.paging:paging-*:2.1.1 เผยแพร่แล้ว เวอร์ชัน 2.1.1 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • ตอนนี้การโหลดเริ่มต้นที่อยู่ติดกันจาก PositionalDataSource จะอยู่ตรงกลางรอบการเข้าถึงล่าสุดเมื่อปิดใช้ตัวยึดตำแหน่ง

เวอร์ชัน 2.1.0

เวอร์ชัน 2.1.0

25 มกราคม 2019

เพจจิ้ง 2.1.0 เปิดตัวโดยไม่มีการเปลี่ยนแปลงจาก 2.1.0-rc01

เวอร์ชัน 2.1.0-rc01

6 ธันวาคม 2018

เพจจิ้ง 2.1.0-rc01 เปิดตัวโดยไม่มีการเปลี่ยนแปลงจาก 2.1.0-beta01

เวอร์ชัน 2.1.0-beta01

1 พฤศจิกายน 2018

เพจจิ้ง 2.1.0-beta01 เปิดตัวโดยไม่มีการเปลี่ยนแปลงจาก 2.1.0-alpha01

เวอร์ชัน 2.1.0-alpha01

12 ตุลาคม 2018

Paging 2.1.0-alpha01 มีการเพิ่มที่สำคัญ 2 รายการ ได้แก่ การวางหน้าและไลบรารีส่วนขยาย KTX สำหรับอาร์ติแฟกต์ทุกรายการ รวมถึงการเปลี่ยนแปลง API และการแก้ไขข้อบกพร่องอื่นๆ อีกหลายรายการ

การเปลี่ยนแปลง API

  • เพิ่ม PagedList.Config.Builder.setMaxSize() เพื่อจำกัดจำนวนรายการที่โหลดในหน่วยความจำ
  • เพิ่ม androidx.paging.Config() เป็นทางเลือก Kotlin สำหรับ PagedList.Config.Builder แล้ว
  • เพิ่ม androidx.paging.PagedList() เป็นทางเลือก Kotlin สำหรับ PagedList.Builder แล้ว
  • เพิ่ม DataSourceFactory.toLiveData() เป็นทางเลือก Kotlin สำหรับ LivePagedListBuilder แล้ว
  • เพิ่ม DataSourceFactory.toObservable() และ toFlowable() เป็นทางเลือก Kotlin สำหรับ RxPagedListBuilder
  • เพิ่ม AsyncPagedListDiffer.addPagedListListener() เพื่อฟังเมื่อมีการสลับ PagedList b/111698609
  • เพิ่มตัวแปร PagedListAdapter.onCurrentListChanged() ที่ส่งรายการเก่าและใหม่ และเลิกใช้งานตัวแปรก่อนหน้าแล้ว
  • เพิ่มตัวแปร PagedListAdapter/AsyncPagedListDiffer.submitList() ซึ่งใช้ Callback เพิ่มเติมที่ทริกเกอร์หาก/เมื่อ pagedlist แสดงขึ้น หลังจากเปรียบเทียบความแตกต่าง ซึ่งจะช่วยให้คุณซิงค์การสลับ PagedList กับการอัปเดต UI อื่นๆ ได้ b/73781068
  • เพิ่ม PagedList.getLoadedCount() เพื่อให้คุณทราบจำนวนรายการในความทรงจำ โปรดทราบว่าค่าที่แสดงผลจะเท่ากับ .size() เสมอหากปิดใช้ตัวยึดตำแหน่ง

แก้ไขข้อบกพร่อง

  • แก้ไขภาวะแข่งขันเมื่อเปรียบเทียบความแตกต่างหากมีการใช้รายการซ้ำ b/111591017
  • ตอนนี้ PagedList.loadAround() จะแสดง IndexOutOfBoundsException เมื่อดัชนีไม่ถูกต้อง ก่อนหน้านี้ ระบบอาจขัดข้องโดยมีข้อยกเว้นอื่นๆ ที่ไม่ชัดเจน
  • แก้ไขกรณีที่ขนาดการโหลดเริ่มต้นที่เล็กมากรวมกับข้อมูลที่ไม่มีการเปลี่ยนแปลงจะส่งผลให้ไม่มีการโหลดเพิ่มเติม b/113122599

เวอร์ชัน 2.0.0

เวอร์ชัน 2.0.0

1 ตุลาคม 2018

Paging 2.0.0 เปิดตัวพร้อมการแก้ไขข้อบกพร่องรายการเดียว

แก้ไขข้อบกพร่อง

  • แก้ไขข้อขัดข้องที่อาจเกิดขึ้นเมื่อเลื่อนอย่างรวดเร็วโดยใช้ PositionalDataSource และตัวยึดตำแหน่ง b/114635383

เวอร์ชัน 2.0.0-beta01

2 กรกฎาคม 2018

แก้ไขข้อบกพร่อง

  • แก้ไขเนื้อหาที่หายไปในบางกรณีที่เพิ่มไว้ข้างหน้า (ปิดใช้ตัวยึดตำแหน่ง, PositionalDataSource) b/80149146
  • (เปิดตัวแล้วใน 1.0.1) แก้ไขข้อขัดข้องที่ PagedListAdapter และ AsyncPagedListDiffer ไม่สามารถส่งสัญญาณเหตุการณ์การย้าย b/110711937

ทรัพยากร Dependency ก่อน AndroidX

สำหรับ Paging เวอร์ชันก่อน AndroidX ที่ตามมา ให้รวมทรัพยากร Dependency เหล่านี้

dependencies {
    def paging_version = "1.0.0"

    implementation "android.arch.paging:runtime:$paging_version"

    // alternatively - without Android dependencies for testing
    testImplementation "android.arch.paging:common:$paging_version"

    // optional - RxJava support
    implementation "android.arch.paging:rxjava2:$paging_version"
}

เวอร์ชัน 1.0.1

เวอร์ชัน 1.0.1

26 มิถุนายน 2018

Paging 1.0.1 เปิดตัวพร้อมการแก้ไขข้อบกพร่องรายการเดียวใน runtime เราขอแนะนำอย่างยิ่งให้ใช้ 1.0.1 เพื่อความเสถียร นอกจากนี้ยังมีการเปิดตัว Paging RxJava2 1.0.1 ซึ่งเหมือนกับ 1.0.0-rc1

แก้ไขข้อบกพร่อง

  • แก้ไขข้อขัดข้องที่ PagedListAdapter และ AsyncPagedListDiffer ไม่สามารถส่งสัญญาณเหตุการณ์การย้าย b/110711937

RxJava2 เวอร์ชัน 1.0.0

RxJava2 เวอร์ชัน 1.0.0-rc1

16 พฤษภาคม 2018

Paging RxJava2 1.0.0-rc1 กำลังเปลี่ยนเป็นรุ่นที่อาจได้รับการเผยแพร่โดยไม่มีการเปลี่ยนแปลงจากเวอร์ชันอัลฟ่าเริ่มต้น

เวอร์ชัน 1.0.0

เวอร์ชัน 1.0.0-rc1

19 เมษายน 2018 รุ่นที่อาจได้รับการเผยแพร่ของ Paging

เราไม่มีปัญหาที่ทราบหรือฟีเจอร์ใหม่ที่กำหนดไว้สำหรับรุ่น Paging 1.0.0 โปรดอัปเกรดโปรเจ็กต์เพื่อใช้ 1.0.0-rc1 และช่วยเราทดสอบการใช้งานจริงเพื่อให้เราสามารถจัดส่ง 1.0.0 ที่มีประสิทธิภาพสูงได้

ไม่มีการเปลี่ยนแปลงในรุ่นนี้ โดยจะเหมือนกับ 1.0.0-beta1

เวอร์ชัน 1.0.0-beta1

5 เมษายน 2018

เพจจิ้งจะอยู่ในเวอร์ชันเบต้าเป็นระยะเวลาสั้นๆ ก่อนที่จะเปลี่ยนเป็นรุ่นที่อาจได้รับการเผยแพร่ เราไม่ได้วางแผนที่จะเปลี่ยนแปลง API เพิ่มเติมสำหรับ Paging 1.0 และเกณฑ์สำหรับการเปลี่ยนแปลง API นั้นสูงมาก

การรองรับ RxJava2 เวอร์ชันอัลฟ่าสำหรับ Paging จะเผยแพร่เป็นโมดูลเสริมแยกต่างหาก (android.arch.paging:rxjava2:1.0.0-alpha1) และจะมีการกำหนดเวอร์ชันแยกต่างหากชั่วคราวจนกว่าจะเสถียร

ไลบรารีใหม่นี้มี RxJava2 เป็นทางเลือกแทน LivePagedListBuilder ซึ่งสามารถสร้าง Observable และ Flowable โดยใช้ Scheduler แทน Executor ดังนี้

Kotlin

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

Java

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

ฟีเจอร์ใหม่

  • เพิ่ม RxPagedListBuilder ผ่านอาร์ติแฟกต์ android.arch.paging:rxjava2 ใหม่แล้ว

การเปลี่ยนแปลง API

  • การเปลี่ยนแปลง API เพื่อชี้แจงบทบาทของ Executor ใน Builder

    • เปลี่ยนชื่อ setBackgroundThreadExecutor() เป็น setFetchExecutor() (ใน PagedList.Builder และ LivePagedListBuilder)

    • เปลี่ยนชื่อ setMainThreadExecutor() เป็น setNotifyExecutor() (ใน PagedList.Builder) แล้ว

  • แก้ไขสมาชิก PagedList.mCallbacks ให้เป็นแบบส่วนตัวแล้ว

แก้ไขข้อบกพร่อง

  • LivePagedListBuilder ทริกเกอร์การโหลด PagedList เริ่มต้นใน Executor ที่ระบุ แทนพูลเธรด IO ของคอมโพเนนต์ Arch

  • แก้ไขลักษณะการทำงานที่ไม่ถูกต้องใน Wrapper DataSource ภายใน (ใช้เพื่อติดตั้งใช้งาน DataSource.map รวมถึงการโหลด PositionalDataSource ที่ปิดใช้ตัวยึดตำแหน่ง) b/77237534

เวอร์ชัน 1.0.0-alpha7

21 มีนาคม 2018

Paging 1.0.0-alpha7 เปิดตัวพร้อมกับ Lifecycles 1.1.1 เนื่องจาก Paging alpha7 ขึ้นอยู่กับการย้ายคลาส Function ที่กล่าวถึงข้างต้น คุณจึงต้องอัปเดตทรัพยากร Dependency ของ lifecycle:runtime เป็น android.arch.lifecycle:runtime:1.1.1

Paging alpha7 มีแผนที่จะเป็นรุ่นสุดท้ายก่อนที่ Paging จะเข้าสู่เวอร์ชันเบต้า

การเปลี่ยนแปลง API

  • ตอนนี้ออบเจ็กต์ DataSource.LoadParams มีคอนสตรัคเตอร์สาธารณะ และออบเจ็กต์ DataSource.LoadCallback เป็นแบบนามธรรมแล้ว ซึ่งจะช่วยให้สามารถรวม DataSource หรือทดสอบ DataSource โดยตรงด้วย Callback จำลองได้ b/72600421
  • Mapper สำหรับ DataSource และ DataSource.Factory
    • map(Function<IN,OUT>) ช่วยให้คุณเปลี่ยนรูปแบบ รวม หรือตกแต่งผลลัพธ์ที่โหลดโดย DataSource ได้
    • mapByPage(<List<IN>,List<OUT>>) ช่วยให้ทำแบบเดียวกันนี้ได้สำหรับการประมวลผลแบบกลุ่ม (เช่น หากสินค้าที่โหลดจาก SQL จำเป็นต้องค้นหาฐานข้อมูลแยกต่างหากเพิ่มเติม ก็สามารถทำได้แบบกลุ่ม)
  • เพิ่ม PagedList#getDataSource() เป็นเมธอดอำนวยความสะดวก b/72611341
  • ระบบได้นำคลาสที่เลิกใช้งานทั้งหมดออกจาก API แล้ว รวมถึงส่วนที่เหลือของแพ็กเกจ recyclerview.extensions และ LivePagedListProvider
  • DataSource.Factory เปลี่ยนจากอินเทอร์เฟซเป็นคลาสแอบสแตรกต์เพื่อเปิดใช้ฟังก์ชันการทำงานของแผนที่

แก้ไขข้อบกพร่อง

  • เปลี่ยน Builder เป็น Final b/70848565
  • การติดตั้งใช้งาน Room DataSource ได้รับการแก้ไขแล้วเพื่อจัดการการค้นหาหลายตาราง โดยการแก้ไขนี้รวมอยู่ใน Room 1.1.0-beta1 โปรดดูด้านบน
  • แก้ไขข้อบกพร่องที่ BoundaryCallback.onItemAtEndLoaded จะไม่ถูกเรียกใช้สำหรับ PositionalDataSource หากเปิดใช้ตัวยึดตำแหน่งและขนาดทั้งหมดเป็นจำนวนเท่าของขนาดหน้าเว็บพอดี

เวอร์ชัน 1.0.0-alpha5

22 มกราคม 2018

แก้ไขข้อบกพร่อง

  • แก้ไขการโหลดหน้าเว็บเมื่อปิดใช้ตัวยึดตำแหน่ง b/70573345
  • การบันทึกเพิ่มเติมเพื่อติดตามข้อบกพร่อง IllegalArgumentException b/70360195 (และการแก้ไขฝั่ง Room ที่คาดการณ์ไว้)
  • การแก้ไขโค้ดตัวอย่าง Javadoc b/70411933, b/71467637