Paging
Ta tabela zawiera wszystkie artefakty w grupie androidx.paging.
| Artefakt | Wersja stabilna | Wersja kandydująca do publikacji | Wersja beta | Wersja alfa |
|---|---|---|---|---|
| paging-* | 3.5.3 | - | - | 3.6.0-alpha01 |
| paging-compose | 3.5.3 | - | - | 3.6.0-alpha01 |
Deklarowanie zależności
Aby dodać zależność od Paging, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w repozytorium Maven Google.
Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:
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.6.0-alpha01" }
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.6.0-alpha01") }
Informacje o korzystaniu z rozszerzeń Kotlin znajdziesz w dokumentacji ktx.
Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.
Prześlij opinię
Twoja opinia pomoże nam ulepszyć Jetpacka. Daj nam znać, jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki. Przed utworzeniem nowego problemu zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.
Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.
Wersja 3.6
Wersja 3.6.0-alpha01
18 listopada 2026 r.
Publikacja androidx.paging:paging-*:3.6.0-alpha01 Wersja 3.6.0-alpha01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodano
ItemSnapshotListrozszerzenia Lazy Foundations. Możesz teraz wywołaćItemSnapshotList#itemKeyiItemSnapshotList#itemContentType, aby automatycznie wygenerowaćitemKeyicontentTypedla Lazy foundation. (I73455, b/560754841)
Zewnętrzny wkład
- Dziękujemy, Kamal, za dodanie rozszerzeń
ItemSnapshotList.
Wersja 3.5
Wersja 3.5.3
12 października 2026 r.
Publikacja androidx.paging:paging-*:3.5.3 Wersja 3.5.3 zawiera te zatwierdzenia.
Poprawki błędów
ItemSnapshotListFlownie będzie już zgłaszać błęduIllegalArgumentException, gdyRemoteMediatorosiągnie koniec paginacji w dowolnym kierunku, a nagłówek lub stopka zostaną przekonwertowane na separator końcowy. (I821c7, b/566336825)- Gdy liczba wczytanych stron przekroczy
PagingConfig.maxSize, nie spadnie poniżej 2, aby zapewnić prawidłowe wypełnienie widocznego obszaru danymi. (I037a0, b/565835910)
Zewnętrzny wkład
Dziękujemy Igorowi za przesłanie poprawki błędu b/565835910.
Wersja 3.5.2
7 października 2026 r.
Publikacja androidx.paging:paging-*:3.5.2 Wersja 3.5.2 zawiera te zatwierdzenia.
Poprawki błędów
- Wywołania
Pager.append()przed zakończeniem początkowego odświeżania nie będą już powodować błęduNoSuchElementException. Wywołanie dołączania nie będzie działać. (Ide387, b/556780796)
Wersja 3.5.1
12 sierpnia 2026 r.
Publikacja androidx.paging:paging-*:3.5.1 Wersja 3.5.1 zawiera te zatwierdzenia.
Poprawki błędów
- Naprawiliśmy błąd, który powodował, że
PagingSource.getRefreshKeypodawał nieprawidłowyanchorPosition, który był zbyt duży podczas odświeżania strony z separatorami podczas przewijania do obiektów zastępczych. (I475f0, b/516565503)
Wersja 3.5.0
6 maja 2026 r.
Publikacja androidx.paging:paging-*:3.5.0 Wersja 3.5.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 3.4.0:
Dodano operator
Flow<PagingData>.asItemSnapshotListFlow, aby przekonwertowaćFlow<PagingData>naFlow<ItemSnapshotList>. Oznacza to, że do wczytanych danych można teraz uzyskać dostęp poza warstwą interfejsu, co pozwala na łączenieFlow<ItemSnapshotList>z innymi źródłami danych, lokalne buforowanie i modyfikowanie danych stronicowanych, udostępnianie danych stronicowanych jako części stanu interfejsu i nie tylko.Dodano funkcje rozszerzenia
Pager.appendiPager.prepend, które umożliwiają ręczne wczytywanie większej ilości danych bez przewijania.Dodano funkcje rozszerzenia
Pager.refreshiPaging.retry, aby umożliwić przywracanie po błędach wczytywania podczas korzystania z interfejsu APIasItemSnapshotListFlow.
Wersja 3.5.0-rc01
22 kwietnia 2026 r.
Publikacja androidx.paging:paging-*:3.5.0-rc01 Wersja 3.5.0-rc01 zawiera te zatwierdzenia.
Bez zmian
- Brak istotnych zmian w porównaniu z wersją
3.5.0-beta01.
Wersja 3.5.0-beta01
8 kwietnia 2026 r.
Publikacja androidx.paging:paging-*:3.5.0-beta01 Wersja 3.5.0-beta01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Nazwa interfejsu API
Flow<PagingData>.asStatezostała zmieniona naFlow<PagingData>.asItemSnapshotListFlow(I0dc11, b/496548025).
Wersja 3.5.0-alpha01
11 marca 2026 r.
Publikacja androidx.paging:paging-*:3.5.0-alpha01 Wersja 3.5.0-alpha01 zawiera te zatwierdzenia.
Nowe funkcje
Artefakt
paging-commonzawiera teraz nowy operator przepływuasStatewFlow<PagingData>, który konwertuje go naFlow<ItemSnapshotList>. Dzięki temu możesz:- połączenie Flow
ItemSnapshotListz innymi źródłami danych - udostępnianie przepływu wielu kolektorom bez
cachedIn - lokalne buforowanie danych ze stron
- modyfikowanie danych stronicowanych w pamięci,
- udostępniać dane podzielone na strony jako część stanu interfejsu,
// 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) { ... } }- połączenie Flow
Artefakt
paging-commondodał też interfejsy APIPager.appendiPager.prepend, aby ręcznie aktywować wczytywanie na dowolnej krawędzi wczytanych elementów.- W przypadku użycia z
paging-runtimelubpaging-composestanowi alternatywę dla przewijania, umożliwiając wczytywanie większej ilości danych - W przypadku użycia z nowym interfejsem API
asStatejest to jedyny sposób na wczytanie większej ilości danych.
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() } } }- W przypadku użycia z
Dodano
Pager.refreshiPager.retry, aby umożliwić przywracanie po błędach wczytywania podczas korzystania z interfejsu APIasState. Więcej przykładów użycia nowych interfejsów API znajdziesz w tym dokumencie. (I1e1e9, If3c87, Idbd48, Id1e1d, I816fe)
Wersja 3.4
Wersja 3.4.2
11 marca 2026 r.
Publikacja androidx.paging:paging-*:3.4.2 Wersja 3.4.2 zawiera te zatwierdzenia.
Bez zmian
- Ta wersja nie zawiera żadnych zmian w interfejsie API ani w zachowaniu w porównaniu z wersją 3.4.1.
Wersja 3.4.1
11 lutego 2026 r.
Publikacja androidx.paging:paging-*:3.4.1 Wersja 3.4.1 zawiera te zatwierdzenia.
Aktualizacja zależności
- Zaktualizowano zależność guava w paging-guava z wersji 31.1 do 32.0.1.
Wersja 3.4.0
28 stycznia 2026 r.
Publikacja androidx.paging:paging-*:3.4.0 Wersja 3.4.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 3.3.0:
- Dodano więcej platform docelowych KMP do bibliotek
paging-common,paging-testingipaging-compose. Wszystkie obsługują teraz JVM (Android i komputery), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) i Web (JavaScript, WasmJS). paging-common,paging-testingipaging-composenie obsługują jużmacosX64,iosX64,watchosX64itvosX64, aby dostosować się do wycofania przez Jetbrains elementów docelowych macosX64.- Dodaliśmy nowy interfejs API
PagingStateclosestItemAroundPosition, który umożliwia pobieranie wczytanego elementu znajdującego się najbliżej pozycji docelowej i pasującego do predykatu wejściowego. Można go używać do generowania kluczy odświeżania na podstawie elementów, gdy idealny element, który można zakotwiczyć, znajduje się w pobliżu, ale nie w dokładnej pozycji docelowej.
Wersja 3.4.0-rc01
14 stycznia 2026 r.
Publikacja androidx.paging:paging-*:3.4.0-rc01 Wersja 3.4.0-rc01 zawiera te zatwierdzenia.
Nowe funkcje
- Usunęliśmy obsługę tych platform KMP:
macosX64,iosX64,watchosX64itvosX64, aby dostosować się do wycofania przez Jetbrains elementów docelowych macosX64. (7cb9a4)
Wersja 3.4.0-beta01
17 grudnia 2025 r.
Publikacja androidx.paging:paging-*:3.4.0-beta01 Wersja 3.4.0-beta01 zawiera te zatwierdzenia.
Poprawki błędów
- Naprawiono wyścig między wczytywaniem
RecyclerViewiRefresh, który prowadził doIndexOutOfBoundsExceptionwRecyclerView. Przerwanie aktualizacji interfejsu z powodu ciągłego wczytywaniaRefreshmoże spowodować desynchronizację stanu stronicowania zRecyclerView. Można to naprawić, resetując stronicowanie do stanu sprzed odświeżenia, jeśli odświeżanie zostanie przerwane (np. przez kolejne wczytanieRefresh). (I771b0, b/409809768)
Wersja 3.4.0-alpha04
10 września 2025 r.
Publikacja androidx.paging:paging-*:3.4.0-alpha04 Wersja 3.4.0-alpha04 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodaliśmy nowy interfejs API
PagingStateclosestItemAroundPosition, który umożliwia pobieranie wczytanego elementu znajdującego się najbliżej pozycji docelowej i pasującego do predykatu wejściowego. Można go używać do generowania kluczy odświeżania opartych na elementach, gdy idealny element możliwy do zakotwiczenia znajduje się w pobliżu, ale nie w dokładnej pozycji docelowej. (I96e5c, b/440187139)
Wersja 3.4.0-alpha03
27 sierpnia 2025 roku
Publikacja androidx.paging:paging-*:3.4.0-alpha03 Wersja 3.4.0-alpha03 zawiera te zatwierdzenia.
Nowe funkcje
- Do biblioteki Paging-common dodano komputery jako nowy cel Kotlin Multiplatform (KMP). Obecnie obsługuje JVM (Android i komputery), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) i Web (JavaScript, WasmJS). (Id2483, b/436884811)
- Do testowania stronicowania dodano nowe cele Kotlin Multiplatform (KMP). Obecnie obsługuje JVM (Android i komputery), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) i Web (JavaScript, WasmJS). (I0c543, b/435014650)
- Do biblioteki Paging-compose dodano nowe cele Kotlin Multiplatform (KMP). Obecnie obsługuje JVM (Android i komputery), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) i Web (JavaScript, WasmJS). (I70d44, b/436884801)
Zmiany w interfejsie API
- Przeniesienie domyślnego minSdk z API 21 na API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)
Wersja 3.4.0-alpha02
30 lipca 2025 r.
Publikacja androidx.paging:paging-*:3.4.0-alpha02 Wersja 3.4.0-alpha02 zawiera te zatwierdzenia.
Zmiany w interfejsie API
PagingData.fromumożliwia teraz ustawienieplaceholdersBeforeiplaceholdersAfter. Pamiętaj, że przewijanie tych obiektów zastępczych nie powoduje wczytywania. (I06983)
Wersja 3.4.0-alpha01
2 lipca 2025 r.
Publikacja androidx.paging:paging-*:3.4.0-alpha01 Wersja 3.4.0-alpha01 zawiera te zatwierdzenia.
Nowe funkcje
- Do stronicowania dodano te cele KMP: watchos, tvos, mingwX64, watchosDeviceArm64 i linuxArm64. (I237dd, Ia62b3, b/368046982, Icf15d, b/364652024, I139d3, b/338268719)
Poprawki błędów
- Testy jednostkowe na Androidzie, które pobierają stronicowanie w wersji 3.3 lub nowszej, nie będą już zgłaszać błędów z
PagingLogger(Ia9400, b/331684448). - Naprawiliśmy błąd, który powodował, że
RecyclerViewzgłaszał błądIndexOutOfBoundsException, gdy użytkownik przewijał ekran podczas aktualizowaniaRecyclerView(Id1f16, b/381024738). - Naprawiliśmy błąd, który powodował, że stronicowanie nie mogło wywołać kolejnych wczytań podczas odświeżania w trakcie przewijania. (I60ca5, b/352586078)
- Rozwiązaliśmy problem z awarią podczas przewijania i odświeżania elementów stronicowania. (I8c65a, b/347649763)
Wersja 3.3
Wersja 3.3.6
12 lutego 2025 r.
Publikacja androidx.paging:paging-*:3.3.6 Wersja 3.3.6 zawiera te zatwierdzenia.
Poprawki błędów
- Sygnały odświeżania i ponownej próby wysłane podczas początkowego odświeżania będą teraz przechowywane i automatycznie wysyłane ponownie, gdy prezenter stronicowania będzie gotowy.
Zewnętrzny wkład
Wersja 3.3.5
11 grudnia 2024 r.
Publikacja androidx.paging:paging-*:3.3.5 Wersja 3.3.5 zawiera te zatwierdzenia.
Poprawki błędów
- Naprawiliśmy błąd, który powodował, że
RecyclerViewzgłaszał wyjątekIndexOutOfBoundsException, gdy użytkownik przewijał ekran podczas aktualizowaniaRecyclerView. (Id1f16, b/381024738)
Wersja 3.3.4
13 listopada 2024 r.
Publikacja androidx.paging:paging-*:3.3.4 Wersja 3.3.4 zawiera te zatwierdzenia.
Poprawki błędów
- Testy jednostkowe na Androidzie, które korzystają z Paging 3.3 lub nowszej wersji, nie będą już zgłaszać błędu takiego jak
Method isLoggable in android.util.Log not mocked. (Ia9400, b/331684448)
Wersja 3.3.2
7 sierpnia 2024 r.
Publikacja androidx.paging:paging-*:3.3.2 Wersja 3.3.2 zawiera te zatwierdzenia.
Nowe funkcje
paging-commonipaging-testingdodają nowe cele Kotlin-Multiplatform:watchos,tvosilinuxArm64(90c9768, 53e0eca)
Wersja 3.3.1
24 lipca 2024 r.
Publikacja androidx.paging:paging-*:3.3.1 Wersja 3.3.1 zawiera te zatwierdzenia.
Poprawki błędów
- Rozwiązaliśmy problem, który powodował, że interfejs
AsyncPagingDataDifferlub interfejsy API utworzone na jego podstawie, takie jakPagingDataAdapterużywany zRecyclerView, nie mogły wywoływać kolejnych wczytań, gdy źródło danych było odświeżane podczas przewijania. (I60ca5, b/352586078) - Naprawiliśmy błąd powodujący awarię, gdy elementy są usuwane z podstawowego źródła danych podczas przewijania
RecyclerViewza pomocąPagingDataAdapterlubAsyncPagingDataDiffer. (I8c65a, b/347649763)
Wersja 3.3.0
14 maja 2024 r.
Publikacja androidx.paging:paging-*:3.3.0 Wersja 3.3.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 3.2.0
- Zajęcia
PagingDataPresentersą teraz publiczne. Prezentery wieloplatformowe można teraz tworzyć na podstawiePagingDataPresenter, zamiast wymagać wewnętrznych interfejsów API stronicowania lubAsyncPagingDataDifferpaging-runtime. - Dodaliśmy nowe metody pomocnicze
LoadStatesiCombinedLoadStateswhasErroriisIdle, aby sprawdzać, czyLoadStatesjest w stanie błędu lubNotLoading. Dodaliśmy też nową metodę rozszerzenia KotlinawaitNotLoading()wFlow<CombinedLoadStates>, która czeka, aż wczytywanie zostanie zakończone w stanieNotLoadinglub błędu. PagingData.empty()domyślnie wysyła teraz stanyNotLoading, chyba że do konstruktora przekazano niestandardoweLoadStates. To zachowanie różni się od dotychczasowego, w którym nie wysyłaLoadStates, gdy jest przesyłany doPagingDataAdapter, lub wysyła stany wczytywania, gdy jest zbierany jakoLazyPagingItems. Gdy jest zbierany jakoLazyPagingItems, od razu po początkowym utworzeniu wyświetla też pustą listę.
Zgodność z Kotlin Multiplatform
Paging dostarcza teraz artefakty zgodne z Kotlin Multiplatform, głównie dzięki pracy nad projektem multiplatform-paging CashApp.
- W wersji
paging-commonwszystkie interfejsy API Paging 3 zostały przeniesione docommoni są teraz zgodne z JVM i iOS, a nie tylko z Androidem. - Kod biblioteki
paging-testingzostał przeniesiony docommoni jest teraz zgodny z JVM i iOS, a nie tylko z Androidem. - Biblioteka
paging-composeprzeniosła swój kod docommoni dostarcza artefakt Androida, który pasuje do obsługi wielu platform przezandroidx.compose. paging-runtime,paging-guava,paging-rxjava2ipaging-rxjava3będą nadal dostępne tylko na Androidzie.
Wersja 3.3.0-rc01
1 maja 2024 r.
Wersja androidx.paging:paging-*:3.3.0-rc01 została opublikowana bez zmian w porównaniu z wersją Paging 3.3.0-beta01. Wersja 3.3.0-rc01 zawiera te zatwierdzenia.
Wersja 3.3.0-beta01
3 kwietnia 2024 r.
Wersja androidx.paging:paging-*:3.3.0-beta01 nie zawiera żadnych istotnych zmian. Wersja 3.3.0-beta01 zawiera te zatwierdzenia.
Wersja 3.3.0-alpha05
20 marca 2024 r.
Publikacja androidx.paging:paging-*:3.3.0-alpha05 Wersja 3.3.0-alpha05 zawiera te zmiany.
Zmiany w interfejsie API
- Paging używa teraz adnotacji
@MainThreadAndroidX w przypadku wspólnego kodu. (I78f0d, b/327682438)
Wersja 3.3.0-alpha04
6 marca 2024 roku
Publikacja androidx.paging:paging-*:3.3.0-alpha04 Wersja 3.3.0-alpha04 zawiera te zatwierdzenia.
Poprawki błędów
- Naprawiliśmy drobne błędy w dokumentacji związane z dodaniem zgodności z Kotlin Multiplatform. (aosp/2950785)
Wersja 3.3.0-alpha03
7 lutego 2024 r.
Publikacja androidx.paging:paging-*:3.3.0-alpha03 Wersja 3.3.0-alpha03 zawiera te zatwierdzenia.
Nowe funkcje
- Zajęcia
PagingDataPresentersą teraz publiczne. Prezentery wieloplatformowe można teraz tworzyć na podstawiePagingDataPresenter, zamiast wymagać wewnętrznych interfejsów API stronicowania lubAsyncPagingDataDifferpaging-runtime. (Id1f74, b/315214786) - Dodaliśmy nowe metody pomocnicze
LoadStatesiCombinedLoadStates, aby sprawdzać, czyLoadStatesjest w stanie błędu lubNotLoading. Dodaliśmy też nowy interfejs API, który czeka naLoadStateFlow, aż wczytywanie zakończy się stanemNotLoadinglub stanem błędu. (Id6c67)
Zmiana zachowania
PagingData.empty()domyślnie wysyła teraz stanyNotLoading, chyba że do konstruktora przekazano niestandardoweLoadStates. To zachowanie różni się od dotychczasowego, w którym nie wysyłaLoadStates, gdy jest przesyłany doPagingDataAdapter, lub wysyła stany wczytywania, gdy jest zbierany jakoLazyPagingItems. Gdy jest zbierany jakoLazyPagingItems, od razu po początkowym utworzeniu wyświetla też pustą listę. (I4d11d, b/301833847)
Wersja 3.3.0-alpha02
20 września 2023 r.
Publikacja androidx.paging:paging-*:3.3.0-alpha02 Wersja 3.3.0-alpha02 zawiera te zatwierdzenia.
Zgodność z Kotlin Multiplatform
Paging dostarcza teraz artefakty zgodne z Kotlin Multiplatform, głównie dzięki pracy nad projektem multiplatform-paging CashApp. Dzięki temu unikniemy rozbieżności między tymi 2 repozytoriami i zachowamy ich zgodność.
- W wersji
paging-commonwszystkie interfejsy API Paging 3 zostały przeniesione docommoni są teraz zgodne z JVM i iOS, a nie tylko z Androidem. - Kod biblioteki
paging-testingzostał przeniesiony docommoni jest teraz zgodny z JVM i iOS, a nie tylko z Androidem. - Biblioteka
paging-composeprzeniosła swój kod docommoni dostarcza artefakt Androida, który pasuje do obsługi wielu platform przezandroidx.compose. paging-runtime,paging-guava,paging-rxjava2ipaging-rxjava3będą nadal dostępne tylko na Androidzie.
Zmiany w interfejsie API
- Wycofaliśmy publiczny interfejs Logger, który był przeznaczony tylko do użytku wewnętrznego (I16e95, b/288623117).
Zewnętrzny wkład
- Dziękujemy użytkownikowi veyndan z Cash App za pomoc w przeniesieniu Paging do Kotlin Multiplatform (#560, #561, #562, #573, #576, #577, #578, #579, #580, #581, #583, #584, #586, #609)
Wersja 3.3.0-alpha01
20 września 2023 r.
- To pierwsza wieloplatformowa wersja bibliotek androidx.paging. Ta wersja zawiera tylko artefakty
*-jvmi*-android. W przypadku systemów macOS, iOS i Linux użyj3.3.0-alpha02.
Wersja 3.2
Wersja 3.2.1
6 września 2023 r.
Publikacja androidx.paging:paging-*:3.2.1 Wersja 3.2.1 zawiera te zatwierdzenia.
Poprawki błędów
- Rozwiązaliśmy problem, który powodował, że interfejs API
asSnapshot()artefaktu Paging Testing zawieszał się, gdy przekazywano mu przepływ utworzony za pomocąPagingData.from(List), ponieważasSnapshot()nie miał informacji o tym, kiedy wczytywanie zostało zakończone (w przeciwieństwie do przeciążeniaPagingData.from(List, LoadStates)). To obejście działa tylko w przypadku przepływów, które można ukończyć (np.flowOf(PagingData.from(...))). W przypadku przepływów, których nie można ukończyć (np.MutableStateFlow), użyj przeciążeniaPagingData.from, które zapewniaLoadStates. (I502c3) - Paging Compose używa teraz wewnętrznie
AndroidUiDispatcher.Main, aby zapewnić dostępność nowych danych w tej samej klatce, w której kończy się wczytywanie. (Ia55af)
Wersja 3.2.0
26 lipca 2023 r.
Publikacja androidx.paging:paging-*:3.2.0 Wersja 3.2.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 3.1.0
- Komponent Paging Compose osiągnął stabilność interfejsu API i został scalony z resztą komponentu Paging, gdzie jego wersja odpowiada teraz wszystkim innym artefaktom Paging. Zmiany od wersji 3.1.0:
- Obsługa podglądu listy fałszywych danych przez utworzenie
PagingData.from(fakeData)i opakowanie tegoPagingDatawMutableStateFlow(np.MutableStateFlow(PagingData.from(listOf(1, 2, 3)))). Przekaż ten przepływ do funkcji kompozycyjnych@Previewjako odbiornik dlacollectAsLazyPagingItems()do podglądu. - Obsługa wszystkich układów Lazy, takich jak
LazyVerticalGridiHorizontalPager, a także niestandardowych komponentów Lazy z bibliotek Wear i TV. Udało się to osiągnąć dzięki nowym metodom rozszerzeniaLazyPagingItemsitemKeyiitemContentTypeniższego poziomu, które pomagają wdrożyć parametrykeyicontentTypew standardowych interfejsach APIitems, które już istnieją w przypadkuLazyColumn,LazyVerticalGrid, a także ich odpowiedniki w interfejsach API, takich jakHorizontalPager. - Atrybuty
items(lazyPagingItems)iitemsIndexed(lazyPagingItems), które obsługują tylko wartośćLazyListScope, zostały wycofane.
- Obsługa podglądu listy fałszywych danych przez utworzenie
- Nowy artefakt
paging-testing, który udostępnia interfejsy API przeznaczone do testów jednostkowych każdej warstwy aplikacji i jej integracji z Pagingiem w izolacji. Obejmuje na przykład:- Klasa
TestPager, która umożliwia sprawdzanie działania własnej implementacjiPagingSourceniezależnie od pagera i rzeczywistego interfejsu. - Interfejsy API
asPagingSourceFactorydo przekształcaniaFlow<List<Value>>lub statycznegoList<Value>wPagingSourceFactory, który można przekazać do pagera w testach - Rozszerzenie Kotlin
asSnapshotwFlow<PagingData<Value>>, które tłumaczyFlow<PagingData<Value>>na bezpośrednieList<Value>.asSnapshot lambdaumożliwia naśladowanie interfejsu aplikacji za pomocą interfejsów API, takich jakscrollTolubappendScrollWhile, dzięki czemu możesz sprawdzić, czy migawka danych jest prawidłowa w dowolnym punkcie zestawu danych podzielonych na strony.
- Klasa
- Dodano domyślne logi, aby udostępniać informacje na potrzeby debugowania stronicowania na 2 poziomach:
VERBOSEiDEBUG. Dzienniki można włączyć za pomocą poleceniaadb shell setprop log.tag.Paging [DEBUG|VERBOSE]. Dotyczy to zarówno stronicowania z widokami, jak i stronicowania z Compose. - Dodano konstruktory dla
PagingDataAdapteriAsyncPagingDataDiffer, które akceptująCoroutineContextzamiastCoroutineDispatcher. - Dodaliśmy nowy interfejs funkcjonalny
PagingSourceFactory, który zapewnia bardziej przejrzysty interfejs API niż poprzednie wyrażenia lambda () ->PagingSource. Ta fabryka może służyć do tworzenia instancji pagera.
Wersja 3.2.0-rc01
21 czerwca 2023 r.
Publikacja androidx.paging:paging-*:3.2.0-rc01 Wersja 3.2.0-rc01 zawiera te zatwierdzenia.
Zewnętrzny wkład
- Dziękujemy użytkownikowi Veyndan za pomoc w oddzieleniu stronicowania od specyfiki Androida/JVM. (#553, #554, #555, #559)
Wersja 3.2.0-beta01
7 czerwca 2023 r.
Publikacja androidx.paging:paging-*:3.2.0-beta01 Wersja 3.2.0-beta01 zawiera te zatwierdzenia.
Paging Compose
- Interfejs API Paging Compose osiągnął oficjalnie stabilność. W związku z tym wersja została zaktualizowana z
1.0.0-alpha20, aby odpowiadała wersji wszystkich innych artefaktów Paging.
Zmiany w interfejsie API
- Z Paging Compose usunięto wycofane interfejsy API
items(LazyPagingItems)iitemsIndexed(LazyPagingItems). Przykłady interfejsów API, które je zastępują, znajdziesz w informacjach o wersji Paging Compose1.0.0-alpha20. (I9626e)
Wersja 3.2.0-alpha06
24 maja 2023 r.
Publikacja androidx.paging:paging-*:3.2.0-alpha06 Wersja 3.2.0-alpha06 zawiera te zatwierdzenia.
Nowe funkcje
- Dodaliśmy nowy interfejs funkcjonalny
PagingSourceFactory, który zapewnia bardziej przejrzysty interfejs API niż dotychczasowe wyrażenia lambda() -> PagingSource. Ta fabryka może służyć do tworzenia instancjiPager. (I33165, b/280655188) - Dodaliśmy nowy interfejs API
paging-testingwList<Value>.asPagingSourceFactory(), aby uzyskaćPagingSourceFactory, który wczytuje się tylko z niezmiennej listy danych. Istniejące rozszerzenie na stronieFlow<List<Value>>powinno być nadal używane do testowania z wieloma generacjami danych statycznych. (Id34d1, b/280655188)
Zmiany w interfejsie API
- Wszystkie publiczne interfejsy API w paging-testing są teraz oznaczone adnotacją
@VisibleForTesting, aby zapewnić, że są używane tylko w testach. (I7db6e) - Interfejs API
asSnapshotnie wymaga już przekazywania parametruCoroutineScope. Domyślnie używa teraz kontekstu odziedziczonego z zakresu nadrzędnego. (Id0a78, b/282240990) - Zmieniono kolejność parametrów konstruktora
TestPager, aby intuicyjnie odpowiadała kolejności parametrów konstruktoraPager(I6185a). - Przeniesiono użycie typu lambda
() -> PagingSource<Key, Value>w paging-testing do typuPagingSourceFactory<Key, Value>. (I4a950, b/280655188)
Zmiany w zachowaniu
- Do uruchamiania testów stronicowania
asSnapshotnie jest już wymagany główny dyspozytor. Ustawienie tej opcji nie powoduje już żadnych zmian w działaniu testu. (Ie56ea)
Wersja 3.2.0-alpha05
3 maja 2023 r.
Publikacja androidx.paging:paging-*:3.2.0-alpha05 Wersja 3.2.0-alpha05 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Interfejs Paging Testing API w
asSnapshotdomyślnie ustawia teraz parametrloadOperationsna pustą funkcję lambda. Dzięki temu można wywołać metodęasSnapshotbez przekazywania żadnych operacji wczytywania, aby pobrać dane z początkowego odświeżenia. (Ied354, b/277233770)
Ulepszenia dokumentacji
- Zaktualizowaliśmy dokumentację dotyczącą
asPagingSourceFactory(), aby wyjaśnić, że jest to metoda rozszerzenia wFlow, która zwraca fabrykę wielokrotnego użytku do generowania instancjiPagingSource. (I5ff4f, I705b5) - Zaktualizowaliśmy dokumentację konstruktora
LoadResult.Page, aby wyjaśnić, że trzeba zastąpić metodyitemsBeforeiitemsAfter, aby obsługiwać przeskakiwanie. (Ied354)
Treści zewnętrzne
- Dziękujemy użytkownikowi Veyndan za pomoc w oddzieleniu stronicowania od specyfiki Androida/JVM. (#525, #523, #520, #519, #507, #506, #505, #499, #497, #496, #493)
Wersja 3.2.0-alpha04
8 lutego 2023 r.
Publikacja androidx.paging:paging-*:3.2.0-alpha04 Wersja 3.2.0-alpha04 zawiera te zatwierdzenia.
Testowanie stronicowania
- Artefakt
paging-testingzawiera teraz metodęasPagingSourceFactory, która umożliwia utworzeniepagingSourceFactoryzFlow<List<Value>>do przekazania do pagera. Każdy elementList<Value>>emitowany z Flow reprezentuje generowanie danych Paged. Ułatwia to testowanie stronicowania, np. przekształceńPagingData, przez sfałszowanie źródła danych, z którego Pager ma zbierać dane. (I6f230, b/235528239) Artefakt
paging-testingzostał rozszerzony o nowe interfejsy API, które umożliwiają weryfikację poprawności danych zawartych wFlow<PagingData<T>>. Można go użyć na przykład do potwierdzenia danych wyjściowychFlow<PagingData<T>>z warstwy ViewModel.Odbywa się to za pomocą rozszerzenia Kotlin
asSnapshotwFlow<PagingData<Value>>, które przekształcaFlow<PagingData<Value>>w bezpośrednieList<Value>. Funkcja lambdaasSnapshotumożliwia naśladowanie interfejsu aplikacji za pomocą interfejsów API takich jakscrollTolubappendScrollWhilew sposób powtarzalny i spójny, dzięki czemu możesz sprawdzić, czy migawka danych jest prawidłowa w dowolnym punkcie zestawu danych podzielonych na strony.// 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 valuesasSnapshotto metodasuspend, która powinna być uruchamiana w ramachrunTest. Więcej informacji znajdziesz w artykule Testowanie współprogramów Kotlin na Androidzie. (I55fd2, I5bd26, I7ce34, I51f4d, I2249f, Id6223, Ic4bab, Ib29b9, Ic1238, I96def, b/235528239)
Zmiany w interfejsie API
- Wywołania interfejsu do
getItemipeekwAsyncPagingDataDifferiPagingDataAdaptersą teraz prawidłowo oznaczone jako możliwe do wywołania tylko w wątku głównym. (I699b6) - Usunięto symbole wieloznaczne z typów ogólnych używanych przez
TestPager, co ułatwia korzystanie z wyników tych metod w kodzie napisanym w języku programowania Java. (I56c42)
Wersja 3.2.0-alpha03
24 października 2022 r.
Publikacja androidx.paging:paging-*:3.2.0-alpha03 Wersja 3.2.0-alpha03 zawiera te zatwierdzenia.
Testowanie stronicowania
Ta wersja zawiera nowy artefakt: paging-testing. Ten artefakt udostępnia interfejsy API zaprojektowane pod kątem testów jednostkowych każdej warstwy aplikacji i jej integracji z Pagingiem w izolacji.
Na przykład ta pierwsza wersja zawiera klasę TestPager, która umożliwia sprawdzanie działania własnej implementacji PagingSource niezależnie od Pager i rzeczywistego interfejsu, które zwykle są potrzebne do symulowania kompleksowej integracji stronicowania.
TestPager należy traktować jako fałszywy – dubler testowy, który odzwierciedla rzeczywistą implementację Pager, zapewniając jednocześnie uproszczoną powierzchnię interfejsu API do testowania PagingSource. Te interfejsy API to interfejsy suspend i powinny być uruchamiane w runTest zgodnie z opisem w przewodniku Testowanie współprogramów Kotlin na Androidzie.
Przykład użycia tych interfejsów API można znaleźć w testach room-paging, które zostały poddane refaktoryzacji, aby używały TestPager.
Zmiany w interfejsie API
- Umożliwia wygodną iterację w
LoadResult.Page.dataza pomocąLoadResult.Page.iterator(). Pośrednio umożliwia to użycie metodyflattenbiblioteki standardowej Kotlin, gdy podany jest obiektList<LoadResult.Page>, np. z właściwościąpagesobiektuPagingStateprzekazywaną do metodyPagingSource.getRefreshKey. (Ie0718)
Wersja 3.2.0-alpha02
10 sierpnia 2022 r.
Publikacja androidx.paging:paging-*:3.2.0-alpha02 Wersja 3.2.0-alpha02 zawiera te zatwierdzenia.
Nowe funkcje
- Paging udostępnia teraz logi za pomocą klas
AsyncPagingDataDifferlubPagingDataAdapter, aby ujawniać informacje na potrzeby debugowania zebrane zPagingData. - Logi można włączyć za pomocą polecenia
adb shelladb shell setprop log.tag.Paging [DEBUG|VERBOSE].(b/235527159).
Poprawki błędów
- Naprawiono błąd brakującego konstruktora
PagingDataDifferpodczas używaniapaging-common:3.2.0-alpha01ze środowiskiem wykonawczympaging-runtime:3.1.1lub starszym (b/235256201).
Wersja 3.2.0-alpha01
1 czerwca 2022 r.
Publikacja androidx.paging:paging-*:3.2.0-alpha01 Wersja 3.2.0-alpha01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodano konstruktory dla
PagingDataAdapteriAsyncPagingDataDiffer, które akceptująCoroutineContextzamiastCoroutineDispatcher. (Idc878) - Domyślnie zasady
PagingData.from()iPagingData.empty()nie będą już wpływać naCombinedLoadStatespo stronie prowadzącego. Dodano nowe przeciążenie, które umożliwia przekazywaniesourceLoadStatesiremoteLoadStatesdo tych konstruktorów, aby zachować dotychczasowe działanie ustawieniaLoadStatesjako w pełni terminalowego (tj.NotLoading(endOfPaginationReached = false)), z opcją uwzględnienia w razie potrzeby również stanów zdalnych. Jeśli nie zostaną przekazane parametryLoadStates, po otrzymaniu statycznego parametruPagingDatapo stronie prezentera zostanie zachowany poprzedni parametrCombinedLoadStates. (Ic3ce5, b/205344028)
Poprawki błędów
- Wynik funkcji
PagingSource.getRefreshKey()jest teraz prawidłowo traktowany priorytetowo w stosunku do funkcjiinitialKeyw przypadkach, gdy zwraca wartość null, ale ustawiono wartość inną niż null dla funkcjiinitialKey. (Ic9542, b/230391606)
Zewnętrzny wkład
- Zaktualizowano interfejs API :compose:ui:ui-test (updateApi) z powodu migracji test-coroutines-lib (I3366d)
Wersja 3.1
Wersja 3.1.1
9 marca 2022 r.
Publikacja androidx.paging:paging-*:3.1.1 Wersja 3.1.1 zawiera te zatwierdzenia.
Poprawki błędów
- Usunięto pośrednie zdarzenia
LoadState.NotLoadingmiędzy generacjami, które zostały nieprawidłowo wstawione przez.cachedIn(). Ta zmiana znacznie ułatwia reagowanie na zmianyLoadState, ponieważ usuwa nadmiarowe zdarzeniaLoadState.NotLoading, które były generowane między ponownymi próbami nieudanego wczytania, podczas odświeżania lub unieważniania.
Wersja 3.1.0
17 listopada 2021 r.
Publikacja androidx.paging:paging-*:3.1.0 Wersja 3.1.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 3.0.0
- Interfejsy API
Flow<PagingData>.observableiFlow<PagingData>.flowablenie są już eksperymentalne - Zmiany w
LoadState:endOfPaginationReachedjest teraz zawszefalsezaLoadType.REFRESHw przypadkuPagingSourceiRemoteMediatorLoadStatesz Paging czeka teraz na prawidłowe wartości zPagingSourceiRemoteMediator, zanim wyemituje je dalej. Nowe generacjePagingDatabędą teraz zawsze prawidłowo zaczynać się odLoadingw przypadku stanu odświeżania, zamiast w niektórych przypadkach nieprawidłowo resetować się doNotLoading..loadStateFlowi.addLoadStateListenerw interfejsach API prezenterów nie wysyłają już niepotrzebnie początkowegoCombinedLoadStates, który zawsze ma stany mediatora ustawione nanull
- Anulowanie poprzednich generacji następuje teraz natychmiast po unieważnieniu lub rozpoczęciu nowych generacji. Nie powinno być już konieczne używanie
.collectLatestnaFlow<PagingData>, chociaż nadal jest to zalecane. PagingSource.LoadResult.Invalidzostał dodany jako nowy zwracany typ z:PagingSource.load, co powoduje, że stronicowanie odrzuca wszystkie oczekujące lub przyszłe żądania wczytania do tegoPagingSourcei unieważnia je. Ten zwracany typ jest przeznaczony do obsługi potencjalnie nieprawidłowych lub nieaktualnych danych, które mogą zostać zwrócone z bazy danych lub sieci.- Dodano interfejsy API do prezentowania
.onPagesPresentedi.addOnPagesUpdatedListener, które są wywoływane synchronicznie, gdy strony są prezentowane w interfejsie. Aktualizacje stron mogą mieć miejsce w tych sytuacjach:- Zakończy się początkowe wczytywanie nowej generacji PagingData, niezależnie od tego, czy zawiera ona jakieś zmiany w prezentowanych elementach, np. Nowa generacja, która zakończy wczytywanie początkowe bez aktualizacji, ponieważ lista jest dokładnie taka sama, nadal wywoła to wywołanie zwrotne.
- Strona zostanie wstawiona, nawet jeśli nie zawiera żadnych nowych elementów.
- Strona zostanie usunięta, nawet jeśli była pusta.
Wersja 3.1.0-rc01
3 listopada 2021 r.
Publikacja androidx.paging:paging-*:3.1.0-rc01 Wersja 3.1.0-rc01 zawiera te zatwierdzenia.
Poprawki błędów
- Naprawiono sytuację wyścigu i wyciek pamięci w metodzie .cachedIn() w przypadkach, gdy wiele zdarzeń wczytywania zostało wysłanych przez Paging downstream, gdy nie ma obserwatorów lub gdy obserwator przełącza się na nowe PagingData. (Ib682e)
Wersja 3.1.0-beta01
13 października 2021 r.
Publikacja androidx.paging:paging-*:3.1.0-beta01 Wersja 3.1.0-beta01 zawiera te zatwierdzenia.
Poprawki błędów
- Rozwiązaliśmy problem, który powodował, że wiele szybkich dostępów do elementów mogło spowodować ich pominięcie w prefetchDistance, co powodowało zatrzymanie wczytywania strony. Jest to szczególnie problematyczne, gdy wiele elementów jest układanych jednocześnie w kolejności, która priorytetowo traktuje wczytywanie w kierunku przewijania przez użytkownika. Dostęp do tych elementów jest teraz buforowany i synchronicznie traktowany priorytetowo, aby zapobiec jego utracie. (aosp/1833273)
Wersja 3.1.0-alpha04
29 września 2021 r.
Publikacja androidx.paging:paging-*:3.1.0-alpha04 Wersja 3.1.0-alpha04 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Interfejsy API
Flow<PagingData>.observableiFlow<PagingData>.flowablenie są już eksperymentalne. (Ie0bdd)
Poprawki błędów
- W przypadku LoadStates
endOfPaginationReachedjest teraz zawszefalsedlaLoadType.REFRESH. Wcześniej parametr endOfPaginationReached mógł mieć wartośćtruew przypadku RemoteMediatorREFRESH, ale nie w przypadku PagingSource. To zachowanie zostało teraz ujednolicone, aby zawsze zwracać wartośćfalse, ponieważ REFRESH nigdy nie powinien być stanem końcowym. Jest to teraz udokumentowane jako część umowy API w LoadStates. Decyzję o zakończeniu podziału na strony należy zawsze podejmować w odniesieniu do kierunku APPEND lub PREPEND. (I047b6) Stany LoadState z Paging oczekują teraz na prawidłowe wartości z PagingSource i RemoteMediator, zanim zostaną wyemitowane do dalszych etapów między generacjami. Zapobiega to wysyłaniu przez nowe generacje PagingData stanu NotLoading w CombinedLoadStates.source.refresh, jeśli był już stan Loading. Nowe generacje PagingData będą teraz zawsze prawidłowo zaczynać od stanu Loading w przypadku stanu odświeżania, zamiast najpierw nieprawidłowo resetować się do stanu NotLoading w niektórych przypadkach.
Anulowanie poprzednich generacji następuje teraz natychmiast po unieważnieniu lub rozpoczęciu nowych generacji. Nie powinno być już wymagane używanie .collectLatest w
Flow<PagingData>, chociaż nadal jest to zdecydowanie zalecane (I0b2b5, b/177351336, b/195028524).Interfejsy API
.loadStateFlowi.addLoadStateListenerw prezenterze nie wysyłają już niepotrzebnie początkowego stanuCombinedLoadStates, który zawsze ma stany mediatora ustawione nanulli stany źródła ustawione naNotLoading(endOfPaginationReached = false). Oznacza to, że:- stany mediatora będą zawsze wypełniane, jeśli używasz RemoteMediator.
- Zarejestrowanie nowego detektora loadState lub nowego kolektora w
.loadStateFlownie będzie już powodować natychmiastowego wyemitowania bieżącej wartości, jeśli nie otrzyma on rzeczywistego elementuCombinedLoadStateszPagingData. Może się tak zdarzyć, jeśli moduł zbierający lub nasłuchujący uruchomi się przed przesłaniemPagingData. (I1a748)
Wersja 3.1.0-alpha03
21 lipca 2021 r.
Publikacja androidx.paging:paging-*:3.1.0-alpha03 Wersja 3.1.0-alpha03 zawiera te zatwierdzenia.
Zmiany w interfejsie API
Do PagingSource dodano trzeci zwracany typ LoadResult, LoadResult.Invalid. Gdy PagingSource.load zwraca LoadResult.Invalid, stronicowanie odrzuca wczytane dane i unieważnia PagingSource. Ten zwracany typ jest przeznaczony do obsługi potencjalnie nieprawidłowych lub nieaktualnych danych, które mogą zostać zwrócone z bazy danych lub sieci.
Jeśli na przykład do bazy danych zostaną zapisane dane, ale PagingSource nie unieważni ich na czas, może zwrócić niespójne wyniki, jeśli jego implementacja zależy od niezmienności zbioru danych, z którego się wczytuje (np. implementacje bazy danych w stylu LIMIT OFFSET). W takim przypadku zalecamy sprawdzenie unieważnienia po wczytaniu i zwrócenie wartości LoadResult.Invalid, co spowoduje, że Paging odrzuci wszystkie oczekujące lub przyszłe żądania wczytania do tego źródła PagingSource i unieważni je.
Ten zwracany typ jest też obsługiwany przez interfejs Paging2 API, który wykorzystuje LivePagedList lub RxPagedList. Gdy używasz PagingSource z interfejsami API PagedList w Paging2, PagedList jest natychmiast odłączany, co zatrzymuje dalsze próby wczytania danych na tej liście PagedList i wywołuje unieważnienie w PagingSource.
LoadResult to klasa zapieczętowana, co oznacza, że jest to zmiana niezgodna ze źródłem, więc przypadki użycia, które bezpośrednio korzystają z wyników PagingSource.load, będą musiały obsługiwać LoadResult.Invalid w czasie kompilacji. Na przykład użytkownicy Kotlina, którzy używają instrukcji exhaustive-when do sprawdzania zwracanego typu, będą musieli dodać sprawdzenie typu Invalid. (Id6bd3, b/191806126, b/192013267)
Poprawki błędów
- Wywołania zwrotne unieważnienia dodane za pomocą funkcji PagingSource.registerInvalidatedCallback lub DataSource.addInvalidatedCallback są teraz automatycznie aktywowane, jeśli zostały zarejestrowane w źródle PagingSource lub DataSource, które było już nieprawidłowe. Rozwiązuje to sytuację wyścigu, która powodowała, że Paging odrzucał sygnały unieważnienia i zawieszał się, gdy podano źródło, które było już nieprawidłowe podczas początkowego wczytywania. Dodatkowo wywołania zwrotne unieważnienia są teraz prawidłowo usuwane po wywołaniu, ponieważ gwarantowane jest, że zostaną wywołane co najwyżej raz. (I27e69)
- Przesłanie początkowej wartości obiektu zastępczego (InitialPagedList) z nowo utworzonego strumienia PagedList, np. LivePagedListBuilder lub RxPagedListBuilder, nie będzie już powodować czyszczenia wcześniej wczytanych danych.
Wersja 3.1.0-alpha02
1 lipca 2021 r.
Publikacja androidx.paging:paging-*:3.1.0-alpha02 Wersja 3.1.0-alpha02 zawiera te zatwierdzenia.
Nowe funkcje
Dodano interfejsy API detektora onPagesPresented i prezentera przepływu, które są aktywowane natychmiast po zaktualizowaniu prezentowanych stron w interfejsie.
Te aktualizacje są synchroniczne z interfejsem, więc możesz wywoływać metody adaptera, takie jak .snapshot czy .getItemCount, aby sprawdzić stan po zastosowaniu aktualizacji. Pamiętaj, że metoda .snapshot() została pozostawiona do jawnego wywołania, ponieważ może być kosztowna przy każdej aktualizacji.
Aktualizacje strony mogą nastąpić w tych sytuacjach:
- Zakończy się początkowe wczytywanie nowej generacji PagingData, niezależnie od tego, czy zawiera ona jakieś zmiany w prezentowanych elementach. Na przykład: Nowa generacja, która kończy wczytywanie początkowe bez aktualizacji, ponieważ lista jest dokładnie taka sama, nadal wywoła to wywołanie zwrotne.
- Strona jest wstawiana, nawet jeśli nie zawiera nowych elementów.
- Strona jest upuszczana, nawet jeśli jest pusta (I272c9, b/189999634).
Poprawki błędów
- Uzyskanie dostępu do PagedList.dataSource z początkowej wartości wygenerowanej przez LivePagedList lub RxPagedList nie będzie już nieprawidłowo powodować błędu IllegalStateException (I96707).
Wersja 3.1.0-alpha01
2 czerwca 2021 r.
Publikacja androidx.paging:paging-*:3.1.0-alpha01 Wersja 3.1.0-alpha01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Klasy udostępniane przez
paging-rxjava3znajdują się teraz w pakiecieandroidx.paging.rxjava3, dzięki czemu nie kolidują zpaging-rxjava2(Ifa7f6)
Poprawki błędów
- Rozwiązaliśmy problem, który powodował, że stronicowanie czasami wysyłało do RecyclerView zdarzenia różnicowe bez operacji, co mogło powodować przedwczesne uruchamianie niektórych detektorów. (Ic507f, b/182510751)
Zewnętrzny wkład
- Dodano wycofane interfejsy API zgodności PagedList do artefaktu rxjava3 (Id1ce2, b/182497591).
Paging Compose w wersji 1.0.0
Wersja 1.0.0-alpha20
24 maja 2023 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha20 Wersja 1.0.0-alpha20 zawiera te zatwierdzenia.
Nowe funkcje
- Paging Compose obsługuje teraz podgląd listy fałszywych danych przez utworzenie
PagingData.from(fakeData)i opakowaniePagingDatawMutableStateFlow(np.MutableStateFlow(PagingData.from(listOf(1, 2, 3)))). Jeśli użyjesz tych danych jako danych wejściowych dla@Preview, wywołaniacollectAsLazyPagingItems()będą dostarczaćLazyPagingItemsz możliwością podglądu. (I8a78d, b/194544557)
Poprawki błędów
- Dane z pamięci podręcznej z
pager.flow.cachedIn, które zostały zebrane wLazyPagingItems, będą teraz natychmiast dostępne po przywróceniu stanu bez konieczności asynchronicznego zbierania. Oznacza to, że dane z pamięci podręcznej będą gotowe do wyświetlenia natychmiast po początkowym utworzeniu kompozycji po przywróceniu stanu. (I97a60, b/177245496)
Wersja 1.0.0-alpha19
3 maja 2023 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha19 Wersja 1.0.0-alpha19 zawiera te zatwierdzenia.
Obsługa wszystkich układów Lazy
Wcześniej funkcja Paging Compose udostępniała niestandardowe rozszerzenia items i itemsIndexed w LazyListScope, co oznaczało, że nie można było używać funkcji Paging Compose z innymi układami leniwymi, takimi jak LazyVerticalGrid, HorizontalPager, ani z innymi niestandardowymi komponentami leniwymi udostępnianymi przez biblioteki Wear i TV. Główną zmianą w tej wersji jest rozwiązanie tego problemu.
Aby obsługiwać więcej układów leniwych, musieliśmy utworzyć interfejsy API na innej warstwie. Zamiast udostępniać niestandardowy interfejs API items dla każdego układu leniwego, Paging Compose udostępnia teraz metody rozszerzeń na nieco niższym poziomie w LazyPagingItems w itemKey i itemContentType. Te interfejsy API ułatwiają implementację parametrów key i contentType w standardowych interfejsach API items, które już istnieją w przypadku LazyColumn, LazyVerticalGrid, a także ich odpowiedników w interfejsach API takich jak HorizontalPager. (Ifa13b, Ib04f0, b/259385813)
Oznacza to, że obsługa LazyVerticalGrid wyglądałaby tak:
// 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)
}
}
Więcej przykładów użycia tych nowych interfejsów API znajdziesz w naszych przykładach.
Chociaż te zmiany sprawiają, że przykłady LazyColumn i LazyRow są o kilka wierszy dłuższe, uznaliśmy, że spójność wszystkich układów Lazy jest ważnym czynnikiem dla osób, które będą korzystać z Paging Compose. Z tego powodu dotychczasowe rozszerzenia LazyListScope zostały wycofane. (I0c459, I92c8f, b/276989796)
Zmiany w interfejsie API
- Aby ułatwić migrację do nowych interfejsów API, funkcje rozszerzeń
itemsiitemsIndexedwLazyListScopeobsługują teraz parametrcontentType, co odzwierciedla obsługę w nowych interfejsach API. (Ib1918, b/255283378)
Aktualizacje zależności
- Paging Compose zaktualizował zależność z Compose 1.0.5 do Compose 1.2.1. (Ib1918, b/255283378)
Wersja 1.0.0-alpha18
8 lutego 2023 r.
Wersja androidx.paging:paging-compose:1.0.0-alpha18 została opublikowana bez zmian. Wersja 1.0.0-alpha18 zawiera te zatwierdzenia.
Wersja 1.0.0-alpha17
24 października 2022 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha17 Wersja 1.0.0-alpha17 zawiera te zatwierdzenia.
Nowe funkcje
- Dodaj obsługę niestandardowego parametru
CoroutineContextpodczas wywoływaniacollectLazyPagingItems. (I7a574, b/243182795, b/233783862)
Wersja 1.0.0-alpha16
10 sierpnia 2022 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha16 Wersja 1.0.0-alpha16 zawiera te zatwierdzenia.
Nowe funkcje
- Paging udostępnia teraz logi za pomocą klasy
LazyPagingItems, aby ujawniać informacje na potrzeby debugowania zebrane z PagingData. - Dzienniki można włączyć za pomocą polecenia
adb shelladb shell setprop log.tag.Paging [DEBUG|VERBOSE]. ([b/235527159}(https://issuetracker.google.com/issues/235527159))
Poprawki błędów
- Naprawiliśmy błąd brakującego konstruktora
PagingDataDifferpodczas używaniapaging-compose:1.0.0-alpha15zpaging-common:3.1.1lub starszą wersją (b/235256201, b/239868768).
Wersja 1.0.0-alpha15
1 czerwca 2022 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha15 Wersja 1.0.0-alpha15 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodano konstruktory dla
PagingDataAdapteriAsyncPagingDataDiffer, które akceptująCoroutineContextzamiastCoroutineDispatcher. (Idc878)
Poprawki błędów
LazyPagingItemsustawia teraz początkowyloadStatena odświeżanie coLoadState.Loading. (I55043, b/224855902)
Wersja 1.0.0-alpha14
13 października 2021 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha14 Wersja 1.0.0-alpha14 zawiera te zatwierdzenia.
Wersja 1.0.0-alpha13
29 września 2021 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha13 Wersja 1.0.0-alpha13 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Funkcja
LazyPagingItems.snapshot()została zastąpiona właściwościąLazyPagingItems.itemSnapshotList(Ie2da8) - Wycofana metoda
LazyPagingItems.getAsState()została usunięta (Ie65e4)
Wersja 1.0.0-alpha12
21 lipca 2021 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha12 Wersja 1.0.0-alpha12 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Funkcje
items(lazyPagingItems)iitemsIndexed(lazyPagingItems)używane do łączenia stronicowania zLazyColumn/Rowakceptują teraz parametr klucza opcji, który umożliwia określenie stabilnego klucza reprezentującego element. Więcej informacji o kluczach znajdziesz tutaj. (I7986d) - Funkcja
lazyPagingItems.getAsState(index)została wycofana. Użyj w zamian zasadylazyPagingItems[index]. (I086cb, b/187339372)
Wersja 1.0.0-alpha11
30 czerwca 2021 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha11 Wersja 1.0.0-alpha11 zawiera te zatwierdzenia.
Wersja 1.0.0-alpha10
2 czerwca 2021 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha10 Wersja 1.0.0-alpha10 zawiera te zatwierdzenia.
Wersja 1.0.0-alpha09
18 maja 2021 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha09 Wersja 1.0.0-alpha09 zawiera te zatwierdzenia.
Poprawki błędów
- Elementy itemCount i item getter klasy LazyPagingItems są teraz możliwe do obserwowania, co pozwala na ich używanie również z LazyVerticalGrid (Ie2446, b/171872064, b/168285687).
Zgodność z Compose
- Komponent
androidx.paging:paging-compose:1.0.0-alpha09jest zgodny tylko z Compose w wersji1.0.0-beta07lub nowszej.
Wersja 1.0.0-alpha08
24 lutego 2021 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha08 Wersja 1.0.0-alpha08 zawiera te zatwierdzenia.
Zaktualizowano w celu integracji z Compose 1.0.0-beta01.
Wersja 1.0.0-alpha07
10 lutego 2021 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha07 Wersja 1.0.0-alpha07 zawiera te zatwierdzenia.
Zaktualizowano w celu integracji z Compose alpha12.
Wersja 1.0.0-alpha06
28 stycznia 2021 roku
Publikacja androidx.paging:paging-compose:1.0.0-alpha06 Wersja 1.0.0-alpha06 zawiera te zatwierdzenia.
Poprawki błędów
Zaktualizowano zależność od Compose 1.0.0-alpha11.
Wersja 1.0.0-alpha05
13 stycznia 2021 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te zatwierdzenia.
Zaktualizowano zależność od Compose 1.0.0-alpha10.
Wersja 1.0.0-alpha04
16 grudnia 2020 roku
Publikacja androidx.paging:paging-compose:1.0.0-alpha04 Wersja 1.0.0-alpha04 zawiera te zatwierdzenia.
Poprawki błędów
- Zaktualizowano właściwości ułatwień dostępu
CombinedLoadStates.refresh,CombinedLoadStates.prepend,CombinedLoadStates.append, aby przechodziły ze stanuLoadingdo stanuNotLoadingdopiero wtedy, gdy stany wczytywania mediatora i źródła będą miały wartośćNotLoading. Dzięki temu aktualizacja zdalna zostanie zastosowana. (I65619)
Wersja 1.0.0-alpha03
2 grudnia 2020 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha03 Wersja 1.0.0-alpha03 zawiera te zatwierdzenia.
- Zaktualizowano, aby dopasować do Compose 1.0.0-alpha08.
Wersja 1.0.0-alpha02
11 listopada 2020 roku
Publikacja androidx.paging:paging-compose:1.0.0-alpha02 Wersja 1.0.0-alpha02 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodano metody
.peek(),.snapshot(),.retry()i.refresh()doLazyPagingItem, które udostępniają te same funkcje coAsyncPagingDataDiffer/PagingDataAdapter(Iddfe8, b/172041660)
Wersja 1.0.0-alpha01
28 października 2020 r.
Publikacja androidx.paging:paging-compose:1.0.0-alpha01 Wersja 1.0.0-alpha01 zawiera te zatwierdzenia.
Nowe funkcje
Artefakt paging-compose zapewnia integrację między biblioteką Paging a Jetpack Compose. Prosty przykład użycia:
@Composable
@OptIn(ExperimentalLazyDsl::class)
fun ItemsDemo(flow: Flow<PagingData<String>>) {
val lazyPagingItems = flow.collectAsLazyPagingItems()
LazyColumn {
items(lazyPagingItems) {
Text("Item is $it")
}
}
}
Wersja 3.0.1
Wersja 3.0.1
21 lipca 2021 r.
Publikacja androidx.paging:paging-*:3.0.1 Wersja 3.0.1 zawiera te zatwierdzenia.
Poprawki błędów
- Uzyskiwanie dostępu do
PagedList.dataSourcez początkowej wartości wygenerowanej przezLivePagedListlubRxPagedListnie będzie już nieprawidłowo powodować błędu IllegalStateException (I96707).
Wersja 3.0.0
Wersja 3.0.0
5 maja 2021 roku
Publikacja androidx.paging:paging-*:3.0.0 Wersja 3.0.0 zawiera te zatwierdzenia.
Główne funkcje wersji 3.0.0
Większość interfejsów API z Paging 2.x.x została wycofana na rzecz nowych interfejsów API Paging 3, które wprowadzają te ulepszenia:
- Najwyższej klasy obsługa współprogramów i Flow w języku Kotlin
- Pomoc dotycząca anulowania
- Wbudowane sygnały stanu wczytywania i błędu
- funkcję ponawiania i odświeżania,
- Wszystkie 3 podklasy DataSource zostały połączone w ujednoliconą klasę PagingSource.
- Niestandardowe przekształcenia stron, w tym wbudowane przekształcenie do dodawania separatorów reklam
- Nagłówki i stopki stanu wczytywania
Wersja 3.0.0-rc01
21 kwietnia 2021 r.
Publikacja androidx.paging:paging-*:3.0.0-rc01 Wersja 3.0.0-rc01 zawiera te zatwierdzenia.
Poprawki błędów
- Rozwiązaliśmy problem, który powodował, że stronicowanie czasami wysyłało do RecyclerView zdarzenia różnicowe bez operacji, co mogło powodować przedwczesne uruchamianie niektórych detektorów. (Ic507f, b/182510751)
Wersja 3.0.0-beta03
24 marca 2021 r.
Publikacja androidx.paging:paging-*:3.0.0-beta03 Wersja 3.0.0-beta03 zawiera te zatwierdzenia.
Poprawki błędów
- Zmieniliśmy sposób obsługi obiektów zastępczych podczas ponownego wczytywania listy, aby zapobiec nieoczekiwanym przeskokom w RecyclerView. Szczegółowe informacje znajdziesz w pliku NullPaddedDiffing.md. (If1490, b/170027529, b/177338149)
- Różne kreatory PagedList (stara ścieżka zgodności) nie wywołują już nieprawidłowo synchronicznie metody
DataSource.Factory.create()w głównym wątku, gdy wywoływana jest metoda.build(). (b/182798948)
Wersja 3.0.0-beta02
10 marca 2021 r.
Publikacja androidx.paging:paging-*:3.0.0-beta02 Wersja 3.0.0-beta02 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Rozszerzenia Rx3 prawidłowo przekazują teraz wymaganie dotyczące akceptacji
@ExperimentalCoroutinesApi. Wcześniej były one oznaczone w metodzie@get, która jest ignorowana przez kompilator Kotlin z powodu: https://youtrack.jetbrains.com/issue/KT-45227 (I5733c)
Poprawki błędów
- Wymuszanie ograniczeń dotyczących publicznego korzystania z eksperymentalnych interfejsów API (I6aa29, b/174531520)
- Naprawiliśmy błąd, który powodował, że parametr
PagingStatezawsze miał wartośćnull, gdy wywoływane było odświeżanie zdalne. - Naprawiliśmy błąd, który powodował, że puste strony zwracane przez PagingSource mogły uniemożliwiać ponowne pobieranie przez Paging w celu spełnienia
prefetchDistance, co powodowało „zawieszenie” Paging.
Wersja 3.0.0-beta01
10 lutego 2021 r.
Publikacja androidx.paging:paging-*:3.0.0-beta01 Wersja 3.0.0-beta01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Opakowania Rx2 i Rx3 udostępniają teraz adnotację eksperymentalną, od której zależą. Jeśli używasz kodów Rx compat w paging-rxjava2 lub paging-rxjava3, musisz teraz dodać adnotacje do zastosowań za pomocą
@OptIn(ExperimentalCoroutinesApi::class)(Ib1f9d).
Poprawki błędów
- Naprawiliśmy błąd
IndexOutOfBoundsException: Inconsistency detected, który czasami występował podczas korzystania z interfejsów APIDataSourcew wersji 2 przez ścieżki zgodności. - Wywołanie
isInvalidpodczas inicjowaniaDataSource, gdy jest używane przez ścieżki zgodności, jest teraz prawidłowo uruchamiane w fetchDispatcher, a nie w głównym wątku. Naprawia to błądIllegalStateExceptionspowodowany dostępem do bazy danych w głównym wątku podczas korzystania z implementacjiPagingSourceRoom.
Wersja 3.0.0-alpha13
27 stycznia 2021 r.
Publikacja androidx.paging:paging-*:3.0.0-alpha13 Wersja 3.0.0-alpha13 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Funkcja
PagingSource.getRefreshKeynie jest już opcjonalna do wdrożenia, jest teraz funkcją abstrakcyjną bez domyślnej implementacji. Użytkownicy, którzy przeprowadzają migrację, mogą nadal zwracać domyślną implementację, która po prostu zwracanull, alegetRefreshKey()powinna mieć rzeczywistą implementację zwracającą klucz na podstawie bieżącej pozycji przewijania użytkownika, która umożliwia stronicowaniu dalsze ładowanie wyśrodkowane wokół widocznego obszaru za pomocąPagingState.anchorPosition, jeśli to możliwe. (I4339a) InvalidatingPagingSourceFactoryjest teraz klasą finalną (Ia3b0a)- Zezwalaj na konfigurowanie zachowania separatora terminala (nagłówek/stopka) za pomocą dodatkowego opcjonalnego parametru SeparatorType. Dostępne są 2 opcje:
FULLY_COMPLETE– dotychczasowe działanie; przed dodaniem separatorów końcowych poczekaj, aż PagingSource i RemoteMediator oznaczą endOfPaginationReached. Jeśli nie używasz RemoteMediator, zdalny stan loadState jest ignorowany. Jest to przydatne głównie wtedy, gdy chcesz wyświetlać separatory sekcji tylko wtedy, gdy sekcja jest w pełni załadowana, w tym pobrana ze zdalnego źródła, np. z sieci.SOURCE_COMPLETE– czekaj tylko na oznaczenie endOfPaginationReached przez PagingSource, nawet jeśli używany jest RemoteMediator. Dzięki temu nagłówki i stopki mogą być wyświetlane synchronicznie z początkowym wczytywaniem, co zapobiega konieczności przewijania przez użytkowników w celu wyświetlenia separatorów końcowych. (Ibe993, b/174700218)
Poprawki błędów
- Naprawiliśmy rzadki wyciek pamięci, który występuje, gdy źródło PagingSource zostaje unieważnione, zanim PageFetcher zacznie z niego wczytywać dane. (I9606b, b/174625633)
Wersja 3.0.0-alpha12
13 stycznia 2021 r.
Publikacja androidx.paging:paging-*:3.0.0-alpha12 Wersja 3.0.0-alpha12 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Klasa InvalidatingPagingSourceFactory nie jest już klasą abstrakcyjną, ponieważ nigdy nie miała żadnych metod abstrakcyjnych. (I4a8c4)
- Dodano przeciążenie metody .cachedIn(), która akceptuje ViewModel zamiast Lifecycle lub CoroutineScope dla użytkowników Javy. (I97d81, b/175332619)
- Zezwalaj obiektom wywołującym w języku Java na asynchroniczne używanie operacji przekształcania PagingData przez akceptowanie obiektu Executor w argumentach operatora przekształcania. Wszystkie operatory przekształcania -Sync mają teraz usunięty sufiks -Sync, a użytkownicy współprogramów Kotlin będą musieli uściślić, wywołując funkcję rozszerzenia, która akceptuje blok zawieszenia.
Wszystkie operatory przekształcania PagingData zostały przeniesione do rozszerzeń w ramach statycznej klasy PagingDataTransforms. Użytkownicy Javy będą musieli wywoływać je za pomocą statycznych funkcji pomocniczych, np.
PagingDataTransforms.map(pagingData, transform). W przypadku Kotlina składnia jest taka sama, ale trzeba zaimportować funkcję. (If6885, b/172895919)
Poprawki błędów
- Naprawiliśmy błąd, który powodował, że funkcja
RemoteMediator.load()nie była wywoływana podczasadapter.refresh(), jeśli osiągnięto już koniec paginacji.
Wersja 3.0.0-alpha11
16 grudnia 2020 roku
Publikacja androidx.paging:paging-*:3.0.0-alpha11 Wersja 3.0.0-alpha11 zawiera te zatwierdzenia.
Nowe funkcje
- Dodano obsługę zapisanego stanu w tych podstawowych przypadkach użycia (pełna obsługa, zwłaszcza w przypadku źródeł warstwowych, jest nadal w trakcie opracowywania):
- przepływ jest przechowywany w pamięci podręcznej, a aplikacja nie jest zamykana (np. przepływ jest przechowywany w pamięci podręcznej w modelu widoku, a aktywność jest odtwarzana w procesie);
- źródło stronicowania jest zliczane, obiekty zastępcze są włączone, a układ nie jest naprzemienny.
Zmiany w interfejsie API
PagingSource.getRefreshKey()jest teraz stabilnym interfejsem API (I22f6f, b/173530980).PagingSource.invalidatenie jest już funkcją otwartą. Jeśli chcesz otrzymywać powiadomienia o unieważnieniu, rozważ wywołanie metody registerInvalidatedCallback zamiast zastępowania metody invalidate. (I628d9, b/173029013, b/137971356)- Pager ma teraz jeden eksperymentalny konstruktor obok zwykłych konstruktorów, zamiast ujawniać eksperymentalne interfejsy API w nieeksperymentalnym publicznym interfejsie API za pomocą adnotacji o akceptacji. (I9dc61, b/174531520)
- Zaktualizowano właściwości ułatwień dostępu
CombinedLoadStates.refresh,CombinedLoadStates.prepend,CombinedLoadStates.append, aby przechodziły ze stanuLoadingdo stanuNotLoadingdopiero wtedy, gdy stany wczytywania mediatora i źródła będą miały wartośćNotLoading. Dzięki temu aktualizacja zdalna zostanie zastosowana. (I65619) Usunięto parametr LoadParams.pageSize (który był już wycofany). Zalecamy użycie
LoadParams.loadSizew PagingSource.Wartość
LoadParams.loadSizejest zawsze równa wartościPagingConfig.pageSize, z wyjątkiem wywołania wczytywania początkowego, w którym jest równa wartościPagingConfig.initialLoadSize.Jeśli testujesz DataSource Paging2 bez użycia Pager lub PagedList,
pageSizemoże nie pasować doPagingConfig.pageSize, jeśli ustawiasz teżinitialLoadSize. Jeśli jest to ważne w przypadku Twoich testów, spróbuj użyć klasy Pager/PagedList, która wewnętrznie ustawi prawidłowy rozmiar PageSize dla metod wczytywania DataSource. (I98ac7, b/149157296)
Poprawki błędów
- Naprawiliśmy błąd powodujący awarię z powodu IllegalStateException podczas używania separatorów z ustawioną wartością PagingConfig.maxSize. (I0ed33, b/174787528)
- Naprawiliśmy błąd, który powodował, że stan wczytywania dla PREPEND / APPEND nie aktualizował się do
NotLoading(endOfPaginationReached = true)natychmiast po początkowym wczytaniu, jeśli ustawiono RemoteMediator (I8cf5a) - Naprawiliśmy błąd, który powodował, że interfejsy API po stronie prezentera, takie jak .snapshot(), .peek() itp., zwracały poprzednią (nieaktualną) listę w aktualizacjach ListUpdateCallback.
- Naprawiliśmy błąd, który powodował, że operatory separatorów nie dodawały nagłówków ani stopek, gdy były używane z RemoteMediator.
- Naprawiliśmy błąd, który powodował, że aktualizacje LoadState do NotLoading dla RemoteMediator zacinały się w stanie Loading.
- Naprawiliśmy błąd, który powodował, że interfejs API zgodności Paging 2.0 (
.asPagingSourceFactory()) mógł inicjować bazowy elementDataSourcew nieprawidłowym elemencie CoroutineDispatcher. Rozwiązuje to problem z awarią i możliwymi przypadkami ANR, zwłaszcza podczas korzystania z obecnej implementacji PagingSource w Room, która używa tej ścieżki zgodności.
Wersja 3.0.0-alpha10
2 grudnia 2020 r.
Publikacja androidx.paging:paging-*:3.0.0-alpha10 Wersja 3.0.0-alpha10 zawiera te zatwierdzenia.
Zmiany w interfejsie API
Wycofane interfejsy API
dataRefreshFlowidataRefreshListenerzostały usunięte, ponieważ są zbędne w przypadku aktualizacji loadStateFlow i detektora. W przypadku migracji odpowiednikiem loadStateFlow jest:loadStateFlow.distinctUntilChangedBy { it.refresh } .filter { it.refresh is NotLoading }
Poprawki błędów
- endOfPaginationReached dla RemoteMediator
REFRESHteraz prawidłowo propaguje do aktualizacji LoadState i zapobiega uruchamianiu zdalnychAPPENDiPREPEND. (I94a3f, b/155290248) - Wyświetlanie pustej listy z powodu pustej strony początkowej lub intensywnego filtrowania nie będzie już uniemożliwiać uruchamiania wczytywania
PREPENDlubAPPENDprzez stronicowanie. (I3e702, b/168169730) - Rozwiązaliśmy problem, który powodował, że funkcja
getRefreshKeynie była wywoływana w kolejnych generacjach PagingSource, gdy unieważnienia występowały szybko. (I45460, b/170027530)
Zewnętrzny wkład
- Dodano nową klasę abstrakcyjną InvalidatingPagingSourceFactory z interfejsem API
.invalidate(), który przekazuje unieważnienie do wszystkich emitowanych przez nią obiektów PagingSource. Podziękowania dla @claraf3. (Ie71fc, b/160716447)
Znane problemy
- Nagłówki i stopki z przekształcenia .insertSeparators() mogą nie pojawiać się od razu podczas korzystania z RemoteMediator b/172254056
- Użycie RemoteMediator może spowodować, że zdalne
LoadStateutknie, jeśli unieważnienie iPagingSource.load(LoadParams.Refresh(...))zakończą się, zanimRemoteMediator.load()zwróci b/173717820
Wersja 3.0.0-alpha09
11 listopada 2020 roku
Publikacja androidx.paging:paging-*:3.0.0-alpha09 Wersja 3.0.0-alpha09 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Całkowicie wycofaj metody dataRefreshFlow / Listener za pomocą klauzuli replaceWith. (I6e2dd)
Poprawki błędów
- Naprawiliśmy błąd powodujący zgłaszanie wyjątku
IllegalArgumentException, gdy używane są separatory z RemoteMediator i wywoływane jest unieważnienie, podczas gdy zdalne wczytywanie, które zwróciłoby endOfPagination, nadal trwa (I3a260).
Wersja 3.0.0-alpha08
28 października 2020 r.
Publikacja androidx.paging:paging-*:3.0.0-alpha08 Wersja 3.0.0-alpha08 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Warianty
DataSource.InvalidatedCallbackw językach Kotlin i Java zostały połączone przez włączenie konwersji SAM w Kotlinie za pomocą interfejsu funkcjonalnego (dostępnego w Kotlinie 1.4). Rozwiązuje to też błąd, który powodował, że wywołania zwrotne unieważnienia w wariancie Kotlin nie były wywoływane po przekształceniu przez.maplub.mapByPage. (I1f244, b/165313046)
Poprawki błędów
- Znacznie ulepszono interakcję stronicowania z ViewPager. W szczególności Paging nie będzie już anulować wywołania
RemoteMediator#loadz powodu unieważnienia strony. Jeśli wymagane jest ODŚWIEŻENIE, nie będzie też wysyłać żądania wczytania dołączania/poprzedzania, dopóki żądanie ODŚWIEŻENIA nie zostanie pomyślnie zrealizowane. (I6390b, b/162252536) - W androidx włączono sprawdzanie linta interfejsu API pod kątem MissingGetterMatchingBuilder (I4bbea, b/138602561).
- Naprawiliśmy błąd, który powodował awarię klas pomocniczych
.withLoadState*ConcatAdapterz powodu powiadamiania RecyclerView z wątku w tle (I18bb5, b/170988309). - Naprawiliśmy błąd, który powodował, że wczytywanie bardzo małej, niepustej strony czasami uniemożliwiało prawidłowe wczytywanie przez wstępne pobieranie.Iffda3 b/169259468
Wersja 3.0.0-alpha07
1 października 2020 roku
Publikacja androidx.paging:paging-*:3.0.0-alpha07 Wersja 3.0.0-alpha07 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Asynchroniczne operatory PagingData oparte na Guava akceptują teraz Executor jako parametr, aby kontrolować kontekst wykonywania. (Id4372)
Poprawki błędów
- Naprawiliśmy wyjątek IndexOutOfBounds zgłaszany w RemoteMediator z powodu sytuacji wyścigu. (I00b7f, b/165821814)
- Naprawiliśmy sytuację wyścigu w konwersji DataSource -> PagingSource, która mogła powodować, że wynikowy obiekt PagingSource ignorował sygnały unieważnienia z DataSource.
- Rozwiązaliśmy problem z logiką pobierania stron, który czasami powodował, że nie udawało się pobrać nowych generacji PagingSource, dopóki nie wywołano PagingDataAdapter.refresh()
- Rozwiązaliśmy problem, który powodował, że pozycja przewijania była czasami tracona podczas używania DataSource przekonwertowanego na PagingSource (np. utworzonego przez Room) w połączeniu z RemoteMediator.
Zewnętrzny wkład
- Dziękujemy użytkownikowi @simonschiller za dodanie operatorów asynchronicznych przekształceń RxJava2, RxJava3 i Guava do PagingData.
Wersja 3.0.0-alpha06
2 września 2020 r.
Publikacja androidx.paging:paging-*:3.0.0-alpha06 Wersja 3.0.0-alpha06 zawiera te zatwierdzenia.
Zmiany w interfejsie API
UnsupportedOperationExceptionz bardziej zrozumiałym komunikatem o braku obsługi stabilnych identyfikatorów jest teraz zgłaszany za każdym razem, gdy wywoływana jest metodaPagingDataAdapter.setHasStableIds. (Ib3890, b/158801427)
Poprawki błędów
- Funkcja insertSeparators nie odfiltrowuje już pustych stron, dzięki czemu prezenter może uwzględniać odległość pobierania z wyprzedzeniem nawet w przypadku wstawienia wielu pustych stron. (I9cff6, b/162538908)
Wersja 3.0.0-alpha05
19 sierpnia 2020 r.
Publikacja androidx.paging:paging-*:3.0.0-alpha05 Wersja 3.0.0-alpha05 zawiera te zatwierdzenia.
Poprawki błędów
- Paging teraz prawidłowo pobiera strony z wyprzedzeniem, nawet gdy wyświetlane dane są mocno przefiltrowane.
- Powrót do
LoadResult.Errorpo ponownej próbie wczytania nie powoduje już nieprawidłowego ponownego uruchomienia próby przez dostęp do elementu
Zewnętrzny wkład
- Dziękujemy Clara F za pomoc w wyczyszczeniu niektórych testów. (549612)
Wersja 3.0.0-alpha04
5 sierpnia 2020 r.
Publikacja androidx.paging:paging-*:3.0.0-alpha04 Wersja 3.0.0-alpha04 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodano interfejs API
peek()doAsyncPagingDataDifferiPagingDataAdapter, aby umożliwić dostęp do prezentowanych danych bez wywoływania wczytywania strony. (I38898, b/159104197) - Dodano interfejs API
snapshot()doPagingDataAdapteriAsyncPagingDataDiffer, aby umożliwić pobieranie prezentowanych elementów bez wywoływania pobierania strony. (I566b6, b/159104197) - Dodano konstruktor
PagingData.from(List<T>), który umożliwia prezentowanie list statycznych.Można je łączyć z ogólnym przepływem PagingData, aby wyświetlać listy statyczne w określonych stanach, np. przed zakończeniem początkowego ODŚWIEŻANIA lub po prostu do testowania przekształceń. (Id134d) - Wycofanie interfejsów API dataRefresh Flow / Listener, ponieważ miały one ujawniać stan prezentowanych elementów w przypadku REFRESH, ale dzięki ulepszeniom czasu wywołania zwrotnego loadState Flow / Listener i właściwości itemCount są one zbędne (Ia19f3)
- Dodano kod zgodności RxJava3 dla
PagingSourceiRemoteMediator(I49ef3, b/161480176)
Poprawki błędów
PositionalDataSourceprzekonwertowane naPagingSourceza pomocą pomocnikatoPagingSourceFactory, w tymPagingSourcewygenerowane przez Room, teraz prawidłowo oznaczają się jako obsługujące przeskakiwanie. (I3e84c, b/162161201)- Naprawiliśmy błąd, który powodował, że użycie synchronicznego wariantu submitData czasami prowadziło do wyścigu, co powodowało
ClosedSendChannelException(I4d702, b/160192222).
Zewnętrzny wkład
- Dziękujemy Zacowi Sweersowi za dodanie w imieniu Slacka kodów zgodności z RxJava3. (I49ef3, b/161480176)
Wersja 3.0.0-alpha03
22 lipca 2020 r.
Publikacja androidx.paging:paging-*:3.0.0-alpha03 Wersja 3.0.0-alpha03 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Konstruktor klasy PagingState jest teraz publiczny, co powinno ułatwić testowanie implementacji metody getRefreshKey() (I8bf15).
- Ukryto warianty funkcji mapy DataSource w Kotlinie przed Javą, aby rozwiązać problem z niejednoznacznością między wariantami oryginalnymi i w Kotlinie. (If7b23, b/161150011)
- Nadmiarowe interfejsy API przeznaczone dla użytkowników Kotlina zostały oznaczone jako @JvmSynthetic (I56ae5).
- Dodano przeciążenia konstruktora LoadResult.Page, który domyślnie ustawia itemsBefore i itemsAfter na COUNT_UNDEFINED (I47849).
- Sprawiliśmy, że istniejące operatory PagingData akceptują metody zawieszania, i wprowadziliśmy nowe operatory niezawieszające mapSync, flatMapSync i filterSync dla użytkowników Javy. Dotychczasowe metody przekształcania zostały przeniesione do funkcji rozszerzeń, więc użytkownicy Kotlina będą musieli je teraz importować. (I34239, b/159983232)
Poprawki błędów
- Źródła PagingSource Room (i PositionalDataSource) będą teraz wyświetlać separator początkowy jako część pierwszej strony, dzięki czemu użytkownik nie będzie musiał przewijać, aby go zobaczyć. (I6f747, b/160257628)
- Dostęp do elementów w obiektach zastępczych teraz prawidłowo wywołuje wczytywanie PagingSource, dopóki nie zostanie zwrócona strona, która spełnia żądany indeks po przekształceniu przez PagingData.filter() (I95625, b/158763195).
- Naprawiliśmy błąd, który powodował, że czasami przewijanie po zwróceniu błędu przez PagingSource mogło uniemożliwiać ponowną próbę przez PagingDataAdapter.retry(). (I1084f, b/160194384)
- Rozwiązaliśmy problem, który powodował, że po usunięciu strony dostęp do elementów mógł nie wczytywać stron, mimo że dostęp do elementów był w zakresie prefetchDistance (Ie95ae, b/160038730).
- Ustawienie PagingConfig.maxSize nie powoduje już włączania obiektów zastępczych po zdarzeniu upuszczenia (I2be29, b/159667766).
Wersja 3.0.0-alpha02
24 czerwca 2020 r.
Publikacja androidx.paging:paging-*:3.0.0-alpha02 Wersja 3.0.0-alpha02 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodano przeciążenia konstruktora
PagingConfigz typowymi wartościami domyślnymi (I39c50, b/158576040). - Dodano przeciążenia konstruktorów
PagingDataAdapteriAsyncPagingDataDifferz typowymi wartościami domyślnymi (Ie91f5). - Interfejsy API adaptera
dataRefreshFlowidataRefreshListenerprzekazują teraz wartość logiczną, aby zasygnalizować, czyPagingDatajest pusty (I6e37e, b/159054196). - Dodano interfejsy RxJava i Guava API dla RemoteMediator – RxRemoteMediator i ListenableFutureRemoteMediator.
- Dodano do PagingState funkcje pomocnicze umożliwiające dostęp do typowych elementów, takich jak
isEmpty()ifirstItemOrNull()(I3b5b6, b/158892717).
Poprawki błędów
- Pager sprawdza teraz, czy PagingSource jest ponownie używany w fabryce, aby zapobiec przypadkowemu ponownemu użyciu nieprawidłowych źródeł PagingSource, co powodowało niejasny błąd (I99809, b/158486430).
- Błędy REFRESH w RemoteMediator nie uniemożliwiają już wczytywania PagingSource (I38b1b, b/158892717).
- Wersja
submitDatabez zawieszania nie powoduje już awarii z powodu jednoczesnego zbierania danych w wieluPagingData, gdy jest wywoływana po wersjisubmitDataz zawieszaniem. (I26358, b/158048877) - Naprawiono wyjątek „cannot collect twice from pager” (nie można pobrać 2 razy z pagera), który mógł wystąpić po zmianie konfiguracji (I58bcc, b/158784811).
Wersja 3.0.0-alpha01
10 czerwca 2020 r.
Publikacja androidx.paging:paging-*:3.0.0-alpha01 Wersja 3.0.0-alpha01 zawiera te zatwierdzenia.
Biblioteka Paging została zaktualizowana do wersji 3.0, aby umożliwić korzystanie z kilku ważnych nowych funkcji.
Nowe funkcje w wersji 3.0
- Najwyższej klasy obsługa współprogramów i przepływów w języku Kotlin.
- Obsługa asynchronicznego wczytywania za pomocą funkcji zawieszania współprogramów, elementów podstawowych RxJava Single lub Guava ListenableFuture.
- Wbudowane sygnały stanu wczytywania i błędów na potrzeby projektowania elastycznego interfejsu, w tym funkcje ponawiania i odświeżania.
- Ulepszenia warstwy repozytorium
- Uproszczony interfejs źródła danych
- Uproszczona paginacja sieci i bazy danych
- Pomoc dotycząca anulowania
- Ulepszenia warstwy prezentacji
Znane problemy
- Dokumentacja Javadoc dotycząca Paging 3 nie jest jeszcze dostępna. Tymczasem skorzystaj z przewodników, do których linki znajdziesz powyżej, lub z dokumentacji Kotlina. (b/158614050)
Wersja 2.1.2
Wersja 2.1.2
18 marca 2020 r.
Publikacja androidx.paging:paging:2.1.2 Wersja 2.1.2 zawiera te zatwierdzenia w porównaniu z wersją 2.1.0.
Poprawki błędów
- Naprawiono błąd dotyczący
IndexOutOfBoundsException, który w rzadkich przypadkach występował podczas konwertowania pozycji w trakcie unieważniania.
Problem z wersją
Wersja
2.1.1biblioteki Paging została nieprawidłowo opublikowana z błędnie skonfigurowanej gałęzi, co spowodowało ujawnienie częściowo zaimplementowanych interfejsów API i funkcji, które mają zostać udostępnione w przyszłej wersji.Paging w wersji
2.1.2zawiera poprawkę dotyczącą wyśrodkowania wczytywania, która została pierwotnie opublikowana w wersji 2.1.1, ale tym razem została prawidłowo przeniesiona do wersji 2.1.0. Jeśli obecnie używasz wersji 2.1.1, zdecydowanie zalecamy uaktualnienie do tej wersji.
Wersja 2.1.1
Wersja 2.1.1
18 grudnia 2019 r.
Publikacja androidx.paging:paging-*:2.1.1 Wersja 2.1.1 zawiera te zatwierdzenia.
Poprawki błędów
- Ciągłe początkowe wczytywanie z PositionalDataSources jest teraz skoncentrowane wokół ostatniego dostępu, gdy obiekty zastępcze są wyłączone.
Wersja 2.1.0
Wersja 2.1.0
25 stycznia 2019 r.
Komponent Paging w wersji 2.1.0 został opublikowany bez zmian w stosunku do wersji 2.1.0-rc01.
Wersja 2.1.0-rc01
6 grudnia 2018 r.
Komponent Paging w wersji 2.1.0-rc01 został opublikowany bez zmian w stosunku do wersji 2.1.0-beta01.
Wersja 2.1.0-beta01
1 listopada 2018 r.
Komponent Paging w wersji 2.1.0-beta01 został opublikowany bez zmian w stosunku do wersji 2.1.0-alpha01.
Wersja 2.1.0-alpha01
12 października 2018 r.
W Paging 2.1.0-alpha01 wprowadziliśmy 2 główne dodatki – porzucanie stron i biblioteki rozszerzeń KTX dla każdego artefaktu – a także kilka innych zmian w interfejsie API i poprawek błędów.
Zmiany w interfejsie API
- Dodano
PagedList.Config.Builder.setMaxSize(), aby ograniczyć liczbę elementów wczytywanych do pamięci. - Dodaliśmy
androidx.paging.Config()jako alternatywę dlaPagedList.Config.Builderw języku Kotlin. - Dodaliśmy
androidx.paging.PagedList()jako alternatywę dlaPagedList.Builderw języku Kotlin. - Dodaliśmy
DataSourceFactory.toLiveData()jako alternatywę dlaLivePagedListBuilderw języku Kotlin. - Dodano
DataSourceFactory.toObservable()itoFlowable()jako alternatywy w języku Kotlin dlaRxPagedListBuilder - Dodano
AsyncPagedListDiffer.addPagedListListener()do nasłuchiwania, gdy PagedList zostanie zamieniony. b/111698609 - Dodano wariant
PagedListAdapter.onCurrentListChanged(), który przekazuje starą i nową listę, wycofano poprzedni wariant. - Dodano warianty
PagedListAdapter/AsyncPagedListDiffer.submitList(), które przyjmują dodatkowe wywołanie zwrotne, które jest aktywowane, gdy lista pagedlist jest wyświetlana po porównaniu. Dzięki temu możesz zsynchronizować zamianę PagedList z innymi aktualizacjami interfejsu. b/73781068 - Dodano
PagedList.getLoadedCount(), aby poinformować Cię, ile elementów znajduje się w pamięci. Pamiętaj, że jeśli obiekty zastępcze są wyłączone, zwracana wartość jest zawsze równa.size().
Poprawki błędów
- Naprawiono sytuację wyścigu podczas porównywania, gdy listy są używane ponownie (b/111591017).
PagedList.loadAround()teraz zgłasza błądIndexOutOfBoundsException, gdy indeks jest nieprawidłowy. Wcześniej mogło dojść do awarii z niejasnym innym wyjątkiem.- Naprawiliśmy błąd, który powodował, że w przypadku bardzo małego rozmiaru początkowego i niezmienionych danych nie następowało dalsze wczytywanie b/113122599.
Wersja 2.0.0
Wersja 2.0.0
1 października 2018 r.
Wydaliśmy wersję 2.0.0 biblioteki Paging z jedną poprawką błędu.
Poprawki błędów
- Naprawiliśmy błąd, który mógł powodować awarię podczas bardzo szybkiego przewijania za pomocą
PositionalDataSourcei obiektów zastępczych b/114635383.
Wersja 2.0.0-beta01
2 lipca 2018 r.
Poprawki błędów
- Naprawiliśmy błąd powodujący znikanie treści w niektórych przypadkach dodawania na początku (wyłączone obiekty zastępcze, PositionalDataSource) – b/80149146.
- (Już opublikowane w
1.0.1) Naprawiono błędy, które powodowały, żePagedListAdapteriAsyncPagedListDiffernie sygnalizowały zdarzeń przeniesienia. b/110711937
Zależności sprzed AndroidX
W przypadku poniższych wersji Paging sprzed AndroidX uwzględnij te zależności:
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"
}
Wersja 1.0.1
Wersja 1.0.1
26 czerwca 2018 r.
Wersja 1.0.1 biblioteki Paging została opublikowana z jedną poprawką błędu w runtime. Zdecydowanie zalecamy używanie 1.0.1, aby zapewnić stabilność. Opublikowaliśmy też Paging RxJava2 w wersji 1.0.1, która jest identyczna z wersją 1.0.0-rc1.
Poprawki błędów
- Naprawiliśmy błędy powodujące awarie, w których
PagedListAdapteriAsyncPagedListDiffernie sygnalizowały zdarzeń przeniesienia. b/110711937
RxJava2 w wersji 1.0.0
RxJava2 w wersji 1.0.0-rc1
16 maja 2018 r.
Paging RxJava2 1.0.0-rc1 przechodzi do wersji kandydującej do publikacji bez zmian w stosunku do początkowej wersji alfa.
Wersja 1.0.0
Wersja 1.0.0-rc1
19 kwietnia 2018 r. Wersja kandydująca do publikacji biblioteki Paging
Nie mamy żadnych znanych problemów ani nowych funkcji zaplanowanych do wydania w wersji 1.0.0 biblioteki Paging. Zaktualizuj swoje projekty, aby korzystać z 1.0.0-rc1, i pomóż nam przetestować tę wersję, abyśmy mogli udostępnić stabilną wersję 1.0.0.
W tej wersji nie ma żadnych zmian, jest taka sama jak 1.0.0-beta1.
Wersja 1.0.0-beta1
5 kwietnia 2018 r.
Paging będzie przez krótki czas w wersji beta, zanim przejdzie do wersji kandydującej do publikacji.
Nie planujemy dalszych zmian w interfejsie API w Paging 1.0, a poprzeczka dla wszelkich zmian w interfejsie API jest bardzo wysoka.
Wersja alfa obsługi RxJava2 na potrzeby stronicowania została wydana jako osobny opcjonalny moduł (android.arch.paging:rxjava2:1.0.0-alpha1) i będzie tymczasowo oznaczana osobną wersją, dopóki nie zostanie ustabilizowana.
Ta nowa biblioteka udostępnia alternatywę RxJava2 dla LivePagedListBuilder, która może tworzyć obiekty Observable i Flowable, przyjmując Scheduler zamiast 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();
Nowe funkcje
RxPagedListBuilderjest dodawany za pomocą nowego artefaktuandroid.arch.paging:rxjava2.
Zmiany w interfejsie API
Zmiany w interfejsie API, które wyjaśniają rolę wykonawców w obiektach typu builder:
Zmieniono nazwę
setBackgroundThreadExecutor()nasetFetchExecutor()(w:PagedList.BuilderiLivePagedListBuilder)Zmieniono nazwę
setMainThreadExecutor()nasetNotifyExecutor()(w:PagedList.Builder).
Naprawiono błąd, który powodował, że element
PagedList.mCallbacksbył prywatny.
Poprawki błędów
LivePagedListBuilderwywołuje początkowe wczytywaniePagedListw określonym wykonawcy zamiast w puli wątków IO komponentów Arch.Naprawiono zachowanie unieważniania w wewnętrznych kodach
DataSource(używanych do implementacjiDataSource.maporaz wczytywaniaPositionalDataSourcez wyłączonym obiektem zastępczym) b/77237534
Wersja 1.0.0-alpha7
21 marca 2018 r.
Komponent Paging 1.0.0-alpha7 został wydany wraz z komponentem Lifecycles 1.1.1. Ponieważ Paging alpha7 zależy od przeniesienia wspomnianej wyżej klasy Function, musisz zaktualizować zależność lifecycle:runtime do wersji android.arch.lifecycle:runtime:1.1.1.
Paging alpha7 ma być ostatnią wersją przed przejściem do wersji beta.
Zmiany w interfejsie API
- Obiekty
DataSource.LoadParamsmają teraz konstruktor publiczny, a obiektyDataSource.LoadCallbacksą teraz abstrakcyjne. Umożliwia to opakowanieDataSourcelub bezpośrednie przetestowanieDataSourceza pomocą próbnego wywołania zwrotnego. b/72600421 - Mappery dla DataSource i DataSource.Factory
map(Function<IN,OUT>)umożliwia przekształcanie, opakowywanie lub dekorowanie wyników wczytanych przezDataSource.mapByPage(<List<IN>,List<OUT>>)umożliwia to samo w przypadku przetwarzania wsadowego (np. jeśli elementy wczytane z SQL muszą dodatkowo wysłać zapytanie do osobnej bazy danych, można to zrobić wsadowo).
- Dodano metodę
PagedList#getDataSource()jako metodę ułatwiającą b/72611341 - Z interfejsu API zostały usunięte wszystkie wycofane klasy, w tym pozostałości pakietu
recyclerview.extensionsiLivePagedListProvider. DataSource.Factoryzostała zmieniona z interfejsu na klasę abstrakcyjną, aby umożliwić korzystanie z funkcji mapy.
Poprawki błędów
- thought Zmieniono klasy Builder na finalne. b/70848565
- Implementacja Room
DataSourcezostała poprawiona, aby obsługiwać zapytania dotyczące wielu tabel. Ta poprawka jest zawarta w Room 1.1.0-beta1 (patrz wyżej). - Naprawiliśmy błąd, który powodował, że funkcja
BoundaryCallback.onItemAtEndLoadednie była wywoływana dlaPositionalDataSource, jeśli obiekty zastępcze były włączone, a łączny rozmiar był wielokrotnością rozmiaru strony.
Wersja 1.0.0-alpha5
22 stycznia 2018 r.
Poprawki błędów
- Naprawienie wczytywania strony, gdy obiekty zastępcze są wyłączone b/70573345
- Dodatkowe logowanie na potrzeby śledzenia błędu IllegalArgumentException b/70360195 (oraz spekulacyjna poprawka po stronie Room)
- Poprawki przykładowego kodu Javadoc: b/70411933, b/71467637