เพจจิ้ง
ตารางนี้แสดงอาร์ติแฟกต์ทั้งหมดในกลุ่ม androidx.paging
| อาร์ติแฟกต์ | รุ่นที่เสถียร | รุ่นที่อาจได้รับการเผยแพร่ | รุ่นเบต้า | รุ่นอัลฟ่า |
|---|---|---|---|---|
| paging-* | 3.5.3 | - | - | 3.6.0-alpha01 |
| paging-compose | 3.5.3 | - | - | 3.6.0-alpha01 |
การประกาศทรัพยากร 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เพื่อกู้คืนจากข้อผิดพลาดในการโหลดเมื่อใช้asItemSnapshotListFlowAPI
เวอร์ชัน 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>.asStateAPI เป็น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) { ... } }- รวม Flow ของ
อาร์ติแฟกต์
paging-commonยังเพิ่ม APIPager.appendและPager.prependเพื่อทริกเกอร์การโหลดด้วยตนเองที่ขอบด้านใดด้านหนึ่งของรายการที่โหลด- เมื่อใช้กับ
paging-runtimeหรือpaging-composeจะเป็นทางเลือกในการโหลดข้อมูลเพิ่มเติม นอกเหนือจากการเลื่อน - เมื่อใช้กับ
asStateAPI ใหม่ วิธีนี้จะเป็นวิธีเดียวในการโหลดข้อมูลเพิ่มเติม
LazyColumn { item { /** * Load more items when users scroll near the top of loaded items. */ LaunchedEffect(viewModel) { viewModel.prepend() } } items(snapshot.items) { item -> Text("Item: $item") } item { /** * Load more items when users scroll near the bottom of loaded items. */ LaunchedEffect(viewModel) { viewModel.append() } } }- เมื่อใช้กับ
เพิ่ม
Pager.refreshและPager.retryเพื่อกู้คืนจากข้อผิดพลาดในการโหลดเมื่อใช้asStateAPI ดูตัวอย่างการใช้งาน 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- เพิ่ม
PagingStateAPIclosestItemAroundPositionใหม่เพื่อดึงข้อมูลรายการที่โหลดซึ่งอยู่ใกล้กับตำแหน่งเป้าหมายมากที่สุดและตรงกับเพรดิเคตอินพุต ซึ่งสามารถใช้เพื่อสร้างคีย์รีเฟรชตามรายการที่รายการที่ยึดได้ในอุดมคติอยู่ใกล้ๆ แต่ไม่ได้อยู่ที่ตำแหน่งเป้าหมายที่แน่นอน
เวอร์ชัน 3.4.0-rc01
14 มกราคม 2026
androidx.paging:paging-*:3.4.0-rc01 เผยแพร่แล้ว เวอร์ชัน 3.4.0-rc01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- นำการรองรับแพลตฟอร์ม KMP ต่อไปนี้ออก ได้แก่
macosX64,iosX64,watchosX64และtvosX64เพื่อให้สอดคล้องกับการเลิกใช้งานเป้าหมาย macosX64 ของ Jetbrains (7cb9a4)
เวอร์ชัน 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
- เพิ่ม
PagingStateAPIclosestItemAroundPositionใหม่เพื่อดึงข้อมูลรายการที่โหลดซึ่งอยู่ใกล้กับตำแหน่งเป้าหมายมากที่สุดและตรงกับเพรดิเคตอินพุต ซึ่งสามารถใช้เพื่อสร้างคีย์รีเฟรชตามรายการที่รายการที่ยึดได้ในอุดมคติอยู่ใกล้ๆ แต่ไม่ได้อยู่ที่ตำแหน่งเป้าหมายที่แน่นอน (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
- การย้าย minSdk เริ่มต้นจาก API 21 ไปยัง API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)
เวอร์ชัน 3.4.0-alpha02
30 กรกฎาคม 2025
androidx.paging:paging-*:3.4.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 3.4.0-alpha02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
PagingData.fromอนุญาตให้ตั้งค่าplaceholdersBeforeและplaceholdersAfterได้แล้ว โปรดทราบว่าการเลื่อนดูตัวยึดตำแหน่งเหล่านี้จะไม่ทริกเกอร์การโหลด (I06983)
เวอร์ชัน 3.4.0-alpha01
2 กรกฎาคม 2025
androidx.paging:paging-*:3.4.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 3.4.0-alpha01 มี คอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพจจิ้งได้เพิ่มเป้าหมาย KMP ต่อไปนี้ watchos, tvos, mingwX64, watchosDeviceArm64 และ linuxArm64 (I237dd, Ia62b3, b/368046982, Icf15d, b/364652024, I139d3, b/338268719)
แก้ไขข้อบกพร่อง
- การทำ 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 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้ระบบจะจัดเก็บสัญญาณรีเฟรชและลองใหม่ที่ส่งระหว่างการรีเฟรชครั้งแรก และส่งอีกครั้งโดยอัตโนมัติเมื่อผู้นำเสนอเพจพร้อม
การมีส่วนร่วมจากภายนอก
เวอร์ชัน 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ตามลำดับ นอกจากนี้ ยังเพิ่มเมธอดส่วนขยาย KotlinawaitNotLoading()ใหม่ใน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 นอกเหนือจาก Androidpaging-testingได้ย้ายโค้ดไปยังcommonและตอนนี้เข้ากันได้กับ JVM และ iOS นอกเหนือจาก Androidpaging-composeได้ย้ายโค้ดไปยังcommonและจัดส่งอาร์ติแฟกต์ Android ซึ่งตรงกับการรองรับหลายแพลตฟอร์มของandroidx.composepaging-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 นอกเหนือจาก Androidpaging-testingได้ย้ายโค้ดไปยังcommonและตอนนี้เข้ากันได้กับ JVM และ iOS นอกเหนือจาก Androidpaging-composeได้ย้ายโค้ดไปยังcommonและจัดส่งอาร์ติแฟกต์ Android ซึ่งตรงกับการรองรับหลายแพลตฟอร์มของandroidx.composepaging-runtime,paging-guava,paging-rxjava2และpaging-rxjava3จะยังคงใช้ได้เฉพาะใน Android เท่านั้น
การเปลี่ยนแปลง API
- เลิกใช้งานอินเทอร์เฟซ Logger สาธารณะที่มีไว้สำหรับการใช้งานภายในเท่านั้น (I16e95, b/288623117)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ veyndan จาก Cash App ที่ช่วยย้าย Paging ไปยัง Kotlin Multiplatform (#560, #561, #562, #573, #576, #577, #578, #579, #580, #581, #583, #584, #586, #609)
เวอร์ชัน 3.3.0-alpha01
20 กันยายน 2023
- นี่เป็นรุ่นแรกของไลบรารี androidx.paging ที่ใช้ได้หลายแพลตฟอร์ม เวอร์ชันนี้มีเฉพาะอาร์ติแฟกต์
*-jvmและ*-androidสำหรับตัวแปร macOS, iOS และ Linux ให้ใช้3.3.0-alpha02
เวอร์ชัน 3.2
เวอร์ชัน 3.2.1
6 กันยายน 2023
androidx.paging:paging-*:3.2.1 เผยแพร่แล้ว เวอร์ชัน 3.2.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ 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กับ APIitemsมาตรฐานที่มีอยู่แล้วสำหรับLazyColumn,LazyVerticalGridรวมถึงพารามิเตอร์ที่เทียบเท่าใน API เช่นHorizontalPager items(lazyPagingItems)และitemsIndexed(lazyPagingItems)ซึ่งรองรับเฉพาะLazyListScopeเลิกใช้งานแล้ว
- รองรับการแสดงตัวอย่างรายการข้อมูลจำลองโดยการสร้าง
- อาร์ติแฟกต์
paging-testingใหม่ซึ่งมี API ที่ออกแบบมาเพื่อการทำ Unit Test ของแต่ละเลเยอร์ในแอปและการผสานรวมกับเพจจิ้งแบบแยกต่างหาก ตัวอย่างเช่น- คลาส
TestPagerที่ช่วยให้คุณตรวจสอบลักษณะการทำงานของการติดตั้งใช้งานPagingSourceที่กำหนดเองได้โดยไม่ขึ้นอยู่กับ Pager และ UI จริง -
asPagingSourceFactoryAPI เพื่อเปลี่ยน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 ที่ชัดเจนกว่า () ->PagingSourcelambdas ก่อนหน้า คุณสามารถใช้โรงงานนี้เพื่อสร้างอินสแตนซ์ของ 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
- นำ API
items(LazyPagingItems)และitemsIndexed(LazyPagingItems)ที่เลิกใช้งานแล้วออกจาก Paging Compose ดูตัวอย่าง API ที่ใช้แทนได้ในบันทึกประจำรุ่นของ Paging Compose1.0.0-alpha20(I9626e)
เวอร์ชัน 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-testingAPI ใหม่ของ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.Pageconstructor เพื่อชี้แจงความจำเป็นในการลบล้างitemsBeforeและitemsAfterเพื่อรองรับการข้าม (Ied354)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ Veyndan ที่มีส่วนร่วมในการย้าย Paging ออกจากข้อมูลเฉพาะของ Android/JVM (#525, #523, #520, #519, #507, #506, #505, #499, #497, #496, #493)
เวอร์ชัน 3.2.0-alpha04
8 กุมภาพันธ์ 2023
androidx.paging:paging-*:3.2.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 3.2.0-alpha04 มีคอมมิตเหล่านี้
การทดสอบเพจจิ้ง
- ตอนนี้อาร์ติแฟกต์
paging-testingมีเมธอดasPagingSourceFactoryเพื่อสร้างpagingSourceFactoryจากFlow<List<Value>>เพื่อส่งไปยัง PagerList<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>โดยตรงasSnapshotlambda ช่วยให้คุณเลียนแบบ 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 valuesasSnapshotเป็นเมธอด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 shelladb 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>.observableAPI และFlow<PagingData>.flowableAPI ไม่ได้อยู่ในขั้นทดลองอีกต่อไป- การเปลี่ยนแปลงลักษณะการทำงานของ
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สำหรับ RemoteMediatorREFRESHแต่ไม่ใช่สำหรับ 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)เสมอ ซึ่งหมายความว่า- ระบบจะป้อนข้อมูลสถานะสื่อกลางเสมอหากคุณใช้ RemoteMediator
- การลงทะเบียน 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 shelladb 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 v2DataSourceผ่านเส้นทางความเข้ากันได้ - ตอนนี้การเรียก
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ใน PagingSourceLoadParams.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 }
แก้ไขข้อบกพร่อง
- ตอนนี้ 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
- การรองรับระดับเฟิร์สคลาสสำหรับโครูทีนและ Flow ของ Kotlin
- รองรับการโหลดแบบไม่พร้อมกันด้วยฟังก์ชันระงับ Coroutine, RxJava Single หรือ Guava ListenableFuture
- สัญญาณสถานะการโหลดและข้อผิดพลาดในตัวสำหรับการออกแบบ UI ที่ปรับเปลี่ยนตามอุปกรณ์ รวมถึงฟังก์ชันการลองใหม่และการรีเฟรช
- การปรับปรุงเลเยอร์ที่เก็บข้อมูล
- อินเทอร์เฟซแหล่งข้อมูลที่เรียบง่ายขึ้น
- การแบ่งหน้าเครือข่ายและฐานข้อมูลที่เรียบง่ายขึ้น
- การสนับสนุนการยกเลิก
- การปรับปรุงเลเยอร์การนำเสนอ
ปัญหาที่ทราบ
- 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