Страницы
В этой таблице перечислены все артефакты в группе androidx.paging.
| Объект | Основная версия | Релиз-кандидат | Бета-версия | Альфа-версия |
|---|---|---|---|---|
| paging-* | 3.5.3 | - | - | 3.6.0-alpha01 |
| paging-compose | 3.5.3 | - | - | 3.6.0-alpha01 |
Объявление зависимостей
Чтобы добавить зависимость от Paging, необходимо добавить в проект репозиторий Google Maven. Подробную информацию можно найти в статье Репозиторий Google Maven.
Добавьте зависимости для нужных артефактов в файл build.gradle приложения или модуля:
Яркий
dependencies { def paging_version = "3.5.3" implementation "androidx.paging:paging-runtime:$paging_version" // alternatively - without Android dependencies for tests testImplementation "androidx.paging:paging-common:$paging_version" // optional - RxJava2 support implementation "androidx.paging:paging-rxjava2:$paging_version" // optional - RxJava3 support implementation "androidx.paging:paging-rxjava3:$paging_version" // optional - Guava ListenableFuture support implementation "androidx.paging:paging-guava:$paging_version" // optional - Jetpack Compose integration implementation "androidx.paging:paging-compose:3.5.3" }
Kotlin
dependencies { val paging_version = "3.5.3" implementation("androidx.paging:paging-runtime:$paging_version") // alternatively - without Android dependencies for tests testImplementation("androidx.paging:paging-common:$paging_version") // optional - RxJava2 support implementation("androidx.paging:paging-rxjava2:$paging_version") // optional - RxJava3 support implementation("androidx.paging:paging-rxjava3:$paging_version") // optional - Guava ListenableFuture support implementation("androidx.paging:paging-guava:$paging_version") // optional - Jetpack Compose integration implementation("androidx.paging:paging-compose:3.5.3") }
Информацию об использовании расширений Kotlin можно найти в документации по KTX.
Подробнее о добавлении зависимостей сборки…
Отзыв
Ваши отзывы помогают нам улучшать Jetpack. Если вы обнаружите новые проблемы или у вас появятся идеи по улучшению этой библиотеки, сообщите нам. Прежде чем сообщать о новых ошибках, изучите уже добавленные. Чтобы проголосовать за существующую проблему, нажмите на значок звездочки.
Дополнительную информацию можно найти в документации по системе отслеживания ошибок.
Версия 3.6
Версия 3.6.0-alpha01
18 ноября 2026 г.
Данные "androidx.paging:paging-*:3.6.0-alpha01" опубликованы. Версия 3.6.0-alpha01 содержит эти коммиты.
Изменения в API
- Добавлено
ItemSnapshotListрасширение для Lazy foundations. Теперь вы можете вызватьItemSnapshotList#itemKeyиItemSnapshotList#itemContentType, чтобы автоматически сгенерироватьitemKeyиcontentTypeдля Lazy foundation. (I73455, b/560754841)
Внешний вклад
- Спасибо, Камал, что добавил
ItemSnapshotListрасширения.
Версия 3.5
Версия 3.5.3
12 октября 2026 г.
Данные "androidx.paging:paging-*:3.5.3" опубликованы. Версия 3.5.3 содержит эти коммиты.
Исправление ошибок
ItemSnapshotListFlowбольше не будет выдавать ошибкуIllegalArgumentException, когдаRemoteMediatorдостигает конца разбивки на страницы в любом направлении, а верхний или нижний колонтитул преобразуется в конечный разделитель. (I821c7, b/566336825)- Если количество загруженных страниц превышает
PagingConfig.maxSize, оно не уменьшится до менее чем двух страниц, чтобы область просмотра была заполнена данными. (I037a0, b/565835910)
Внешний вклад
Благодарим Игоря за исправление ошибки b/565835910.
Версия 3.5.2
7 октября 2026 г.
Данные "androidx.paging:paging-*:3.5.2" опубликованы. Версия 3.5.2 содержит эти коммиты.
Исправление ошибок
- Вызовы
Pager.append()до завершения первоначального обновления больше не будут вызывать ошибкуNoSuchElementException. Вызов append не будет выполнять никаких действий (Ide387, b/556780796).
Версия 3.5.1
12 августа 2026 г.
Данные "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>. Это означает, что теперь к загруженным данным можно получить доступ за пределами уровня пользовательского интерфейса, что позволяет комбинироватьFlow<ItemSnapshotList>с другими источниками данных, кэшировать и изменять постраничные данные локально или предоставлять постраничные данные как часть состояния пользовательского интерфейса и многое другое.Добавлены функции расширения
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
- API
Flow<PagingData>.asStateпереименован в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>. Это позволяет:- Объединить поток
ItemSnapshotListс другими источниками данных - share flow with multiple collectors without
cachedIn - кешировать данные страниц локально;
- изменение данных в памяти, разбитых на страницы
- предоставлять данные с разбивкой по страницам как часть состояния пользовательского интерфейса
// In your ViewModel val pager = Pager(pagingConfig, pagingSourceFactory) val pagerFlow = pager.flow.asState() // alterantively convert the flow to a SharedFlow val pagerFlow = pager.flow.asState().stateIn() // In presenter layer val snapshotFlow = viewModel.pagerFlow.collectAsStateWithLifecycle(initialList) val snapshot = itemsFlow.value LazyColumn { items(items = snapshot.items) { ... } }- Объединить поток
В артефакт
paging-commonтакже добавлены APIPager.appendиPager.prepend, позволяющие вручную запускать загрузку с любого края загруженных элементов.- При использовании с
paging-runtimeилиpaging-composeпредоставляет альтернативный способ загрузки дополнительных данных, помимо прокрутки. - При использовании с новым API
asStateэто единственный способ загрузить больше данных.
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для восстановления после ошибок загрузки при использовании APIasState. Примеры использования новых 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 содержит эти коммиты.
Обновление зависимостей
- Зависимость guava в paging-guava обновлена с версии 31.1 до 32.0.1.
Версия 3.4.0
28 января 2026 г.
Данные "androidx.paging:paging-*:3.4.0" опубликованы. Версия 3.4.0 содержит эти коммиты.
Важные изменения по сравнению с версией 3.3.0
- Добавлено больше целевых платформ KMP для
paging-common,paging-testingиpaging-compose. Теперь все они поддерживают JVM (Android и ПК), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) и Web (JavaScript, WasmJS). - В
paging-common,paging-testingиpaging-composeбольше не поддерживаютсяmacosX64,iosX64,watchosX64иtvosX64, поскольку Jetbrains прекратила поддержку macosX64. - Добавлен новый
PagingStateAPIclosestItemAroundPositionдля получения загруженного элемента, который находится ближе всего к целевой позиции и соответствует входному предикату. Это можно использовать для создания ключей обновления на основе элементов, когда идеальный закрепляемый элемент находится рядом с целевой позицией, но не точно в ней.
Версия 3.4.0-rc01
14 января 2026 г.
Данные "androidx.paging:paging-*:3.4.0-rc01" опубликованы. Версия 3.4.0-rc01 содержит эти коммиты.
Новые функции
- Прекращена поддержка следующих платформ KMP:
macosX64,iosX64,watchosX64иtvosX64. Это связано с тем, что Jetbrains прекращает поддержку целевых платформ macosX64. (7cb9a4)
Версия 3.4.0-beta01
17 декабря 2025 г.
Данные "androidx.paging:paging-*:3.4.0-beta01" опубликованы. Версия 3.4.0-beta01 содержит эти коммиты.
Исправление ошибок
- Исправлено состояние гонки между загрузками
RecyclerViewиRefresh, которое приводило кIndexOutOfBoundsExceptionвRecyclerView. Прерывание обновления интерфейса из-за непрерывной загрузки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 и ПК), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) и Web (JavaScript, WasmJS). (Id2483, b/436884811)
- В Paging-testing добавлены новые целевые платформы Kotlin Multiplatform (KMP). Теперь он поддерживает JVM (Android и ПК), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) и Web (JavaScript, WasmJS). (I0c543, b/435014650)
- В Paging-compose добавлены новые целевые платформы Kotlin Multiplatform (KMP). Теперь он поддерживает JVM (Android и ПК), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) и Web (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 содержит эти коммиты.
Новые функции
- В Paging добавлены следующие целевые платформы KMP: watchos, tvos, mingwX64, watchosDeviceArm64 и linuxArm64. (I237dd, Ia62b3, b/368046982, Icf15d, b/364652024, I139d3, b/338268719)
Исправление ошибок
- Модульные тесты Android, использующие Paging 3.3 или более поздней версии, больше не будут вызывать исключение из
PagingLogger(Ia9400, b/331684448). - Исправлена ошибка, из-за которой
RecyclerViewвыдавалIndexOutOfBoundsException, когда пользователь прокручивал экран во время обновленияRecyclerView(Id1f16, b/381024738). - Исправлена ошибка, из-за которой при обновлении во время прокрутки не загружались дополнительные страницы. (I60ca5, b/352586078)
- Исправлен сбой, возникавший при прокрутке во время обновления элементов Paging. (I8c65a, b/347649763)
Версия 3.3
Версия 3.3.6
12 февраля 2025 г.
Данные "androidx.paging:paging-*:3.3.6" опубликованы. Версия 3.3.6 содержит эти коммиты.
Исправление ошибок
- Сигналы обновления и повторной попытки, отправленные во время первоначального обновления, теперь будут сохраняться и автоматически отправляться повторно, как только презентер Paging будет готов.
Внешний вклад
Версия 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 содержит эти коммиты.
Исправление ошибок
- Модульные тесты 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 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой
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теперь является общедоступным классом. Теперь кроссплатформенные презентеры можно создавать на основеPagingDataPresenter, а не внутренних API Paging илиAsyncPagingDataDifferизpaging-runtime.- В
hasErrorиisIdleдобавлены новые вспомогательные методыLoadStatesиCombinedLoadStates, позволяющие проверить, находится ли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, а не только с Android. - Код
paging-testingперенесен вcommon. Теперь он совместим не только с Android, но и с JVM и iOS. - Код
paging-composeперенесен вcommon, и теперь поставляется артефакт Android, соответствующий мультиплатформенной поддержкеandroidx.compose. paging-runtime,paging-guava,paging-rxjava2иpaging-rxjava3останутся доступными только на Android.
Версия 3.3.0-rc01
1 мая 2024 г.
androidx.paging:paging-*:3.3.0-rc01 выпущен без изменений в Paging 3.3.0-beta01. Версия 3.3.0-rc01 содержит эти коммиты.
Версия 3.3.0-beta01
3 апреля 2024 г.
В версии androidx.paging:paging-*:3.3.0-beta01 нет значительных изменений. Версия 3.3.0-beta01 содержит эти коммиты.
Версия 3.3.0-alpha05
20 марта 2024 г.
Данные "androidx.paging:paging-*:3.3.0-alpha05" опубликованы. Версия 3.3.0-alpha05 содержит эти коммиты.
Изменения в API
- Теперь в Paging используется аннотация
@MainThreadAndroidX для общего кода. (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теперь является общедоступным классом. Теперь кроссплатформенные презентеры можно создавать на основеPagingDataPresenter, а не внутренних API Paging или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. Это позволит избежать расхождений между двумя хранилищами и сохранить их совместимость.
- В
paging-commonвсе API Paging 3 перенесены вcommon. Теперь они совместимы с JVM и iOS, а не только с Android. - Код
paging-testingперенесен вcommon. Теперь он совместим не только с Android, но и с JVM и iOS. - Код
paging-composeперенесен вcommon, и теперь поставляется артефакт Android, соответствующий мультиплатформенной поддержкеandroidx.compose. paging-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()артефакта Paging Testing зависал при передаче Flow, созданного с помощьюPagingData.from(List), поскольку уasSnapshot()не было информации о том, когда загрузка завершилась (в отличие от перегрузкиPagingData.from(List, LoadStates)). Это решение работает только для завершаемых потоков (например,flowOf(PagingData.from(...))). Для незавершаемых потоков (например,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. Изменения по сравнению с версией 3.1.0:
- Поддержка предварительного просмотра списка фиктивных данных путем создания
PagingData.from(fakeData)и упаковки этогоPagingDataвMutableStateFlow(например,MutableStateFlow(PagingData.from(listOf(1, 2, 3)))). Передайте этот поток в composable-функции@Previewв качестве получателя для предварительного просмотраcollectAsLazyPagingItems(). - Поддержка всех ленивых макетов, таких как
LazyVerticalGridиHorizontalPager, а также пользовательских ленивых компонентов из библиотек Wear и TV. Это было достигнуто за счет новых методов расширенияLazyPagingItemsболее низкого уровняitemKeyиitemContentType, которые помогают реализовать параметрыkeyиcontentTypeдля стандартных APIitems, которые уже существуют дляLazyColumn,LazyVerticalGrid, а также их эквивалентов в API, таких какHorizontalPager. items(lazyPagingItems)иitemsIndexed(lazyPagingItems), которые поддерживают толькоLazyListScope, больше не поддерживаются.
- Поддержка предварительного просмотра списка фиктивных данных путем создания
- Новый артефакт
paging-testing, который предоставляет API, предназначенные для модульного тестирования каждого уровня приложения и его интеграции с Paging в изоляции. Например:TestPager, который позволяет проверить поведение вашей собственной реализацииPagingSourceнезависимо от Pager и реального пользовательского интерфейса.-
asPagingSourceFactoryAPI для преобразованияFlow<List<Value>>или статическогоList<Value>вPagingSourceFactory, который можно передать в Pager в тестах. asSnapshot– расширение Kotlin дляFlow<PagingData<Value>>, которое преобразуетFlow<PagingData<Value>>вList<Value>.asSnapshot lambdaпозволяет имитировать интерфейс приложения с помощью API, таких какscrollToилиappendScrollWhile, чтобы вы могли проверить правильность снимка данных в любой точке набора постраничных данных.
- Добавлены стандартные журналы для предоставления сведений для отладки разбиения на страницы на двух уровнях:
VERBOSEиDEBUG. Журналы можно включить с помощью командыadb shell setprop log.tag.Paging [DEBUG|VERBOSE]. Это относится как к разбиению на страницы с представлениями, так и к разбиению на страницы с помощью Compose. - Добавлены конструкторы для
PagingDataAdapterиAsyncPagingDataDiffer, которые принимаютCoroutineContextвместоCoroutineDispatcher. - Добавлен новый функциональный интерфейс
PagingSourceFactory, который предоставляет более явный API, чем предыдущие лямбда-выражения () ->PagingSource. Эта фабрика может использоваться для создания экземпляра 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
- Из Paging Compose удалены устаревшие API
items(LazyPagingItems)иitemsIndexed(LazyPagingItems). Пример замены 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, чем существующие лямбда-выражения() -> PagingSource. Эта фабрика может использоваться для создания экземпляраPager. (I33165, b/280655188) - Добавлен новый API
paging-testingдляList<Value>.asPagingSourceFactory(), позволяющий получитьPagingSourceFactory, который загружается только из неизменяемого списка данных. Существующее расширение дляFlow<List<Value>>по-прежнему следует использовать для тестирования с несколькими поколениями статических данных. (Id34d1, b/280655188)
Изменения в API
- Все общедоступные API в paging-testing теперь аннотированы с помощью
@VisibleForTesting, чтобы они использовались только в тестах. (I7db6e) - Для API
asSnapshotбольше не требуется передаватьCoroutineScope. Теперь по умолчанию используется контекст, унаследованный от родительской области действия. (Id0a78, b/282240990) - Изменен порядок параметров конструктора
TestPager, чтобы он интуитивно соответствовал порядку параметров конструктораPager(I6185a). - Перенесено использование лямбда-типа
() -> PagingSource<Key, Value>в типPagingSourceFactory<Key, Value>в paging-testing. (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теперь по умолчанию используется пустая лямбда-функция. Это позволяет вызыватьasSnapshotбез передачи операций загрузки для получения данных из начальной загрузки обновления. (Ied354, b/277233770)
Улучшения документации
- В документацию по
asPagingSourceFactory()добавлено пояснение, что это метод расширения дляFlow, который возвращает многоразовую фабрику для создания экземпляровPagingSource. (I5ff4f, I705b5) - В документацию по конструктору
LoadResult.Pageдобавлено уточнение о том, что для поддержки перехода нужно переопределить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>>, который будет предоставлен Pager. Каждый объектList<Value>>, созданный из Flow, представляет собой поколение данных Paged. Это упрощает тестирование разбивки на страницы, например преобразованийPagingData, за счет имитации источника данных, из которого Pager может собирать данные. (I6f230, b/235528239) Артефакт
paging-testingбыл расширен новыми API, подходящими для проверки правильности данных, содержащихся вFlow<PagingData<T>>. Это можно использовать, например, для подтверждения выводаFlow<PagingData<T>>из слоя ViewModel.Это делается с помощью расширения Kotlin
asSnapshotдляFlow<PagingData<Value>>, которое преобразуетFlow<PagingData<Value>>вList<Value>. Лямбда-выражениеasSnapshotпозволяет имитировать интерфейс приложения с помощью 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 на Android… (I55fd2, I5bd26, I7ce34, I51f4d, I2249f, Id6223, Ic4bab, Ib29b9, Ic1238, I96def, b/235528239)
Изменения в API
- Вызовы интерфейса к
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, разработанные для модульного тестирования каждого уровня вашего приложения и его интеграции с Paging в изоляции.
Например, этот первый выпуск включает класс TestPager, который позволяет вам проверять поведение вашей собственной пользовательской реализации PagingSource независимо от Pager и реального пользовательского интерфейса, который вам обычно нужен для имитации сквозной интеграции Paging.
TestPager следует рассматривать как подделку – дублер теста, который отражает реальную реализацию Pager, предоставляя упрощенную поверхность API для тестирования PagingSource. Это 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. (Ic9542, b/230391606)
Внешний вклад
- Обновлен API :compose:ui:ui-test (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
- API
Flow<PagingData>.observableиFlow<PagingData>.flowableбольше не являются экспериментальными - Изменения в работе
LoadState:endOfPaginationReachedтеперь всегда стоитfalseзаLoadType.REFRESHдляPagingSourceиRemoteMediatorLoadStatesиз Paging теперь ожидает допустимые значения изPagingSourceиRemoteMediator, прежде чем передавать их дальше. Новые поколенияPagingDataтеперь всегда будут правильно начинаться сLoadingдля состояния обновления вместо неправильного сброса доNotLoadingв некоторых случаях..loadStateFlowи.addLoadStateListenerв API докладчика больше не отправляют избыточное начальное значениеCombinedLoadStates, в котором состояния посредника всегда заданы какnull.
- Отмена предыдущих генераций теперь происходит сразу при аннулировании или новых генерациях. Использовать
.collectLatestвFlow<PagingData>больше не требуется, хотя мы по-прежнему рекомендуем это делать. PagingSource.LoadResult.Invalid– новый тип возвращаемого значения изPagingSource.load, из-за которого Paging отменяет все ожидающие и будущие запросы на загрузку в этотPagingSourceи делает его недействительным. Этот тип возвращаемого значения предназначен для обработки потенциально недействительных или устаревших данных, которые могут быть возвращены из базы данных или сети.- Добавлены API презентера
.onPagesPresentedи.addOnPagesUpdatedListener, которые запускаются синхронно при показе страниц в интерфейсе. Обновление страниц может происходить в следующих случаях:- Завершается начальная загрузка нового поколения PagingData, независимо от того, содержит ли новое поколение какие-либо изменения в представленных элементах. то есть, Новое поколение, завершающее начальную загрузку без обновлений, поскольку список точно такой же, по-прежнему будет запускать этот обратный вызов.
- Страница вставляется, даже если она не содержит новых элементов.
- Страница удаляется, даже если она была пустой.
Версия 3.1.0-rc01
3 ноября 2021 г.
Данные "androidx.paging:paging-*:3.1.0-rc01" опубликованы. Версия 3.1.0-rc01 содержит эти коммиты.
Исправление ошибок
- Исправлено состояние гонки и утечка памяти в .cachedIn() в случаях, когда несколько событий загрузки отправлялись Paging downstream, когда не было наблюдателей или между моментами, когда наблюдатель переключался на новые 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 из Paging теперь ожидает допустимых значений как от PagingSource, так и от RemoteMediator, прежде чем передавать их вниз по потоку между поколениями. Это предотвращает отправку NotLoading в CombinedLoadStates.source.refresh новыми поколениями PagingData, если уже было Loading. Теперь новые поколения PagingData всегда будут правильно начинаться с Loading для состояния обновления, а не сбрасываться сначала до NotLoading, как это иногда происходило.
Отмена предыдущих генераций теперь происходит сразу при аннулировании или создании новых. Использовать .collectLatest в
Flow<PagingData>больше не обязательно, хотя мы по-прежнему настоятельно рекомендуем это делать (I0b2b5, b/177351336, b/195028524)..loadStateFlowи.addLoadStateListenerв API докладчика больше не отправляют избыточное начальное значениеCombinedLoadStates, в котором состояния посредника всегда заданы какnull, а состояния источника – какNotLoading(endOfPaginationReached = false). Вот что это значит:- Состояния посредника всегда будут заполняться, если вы используете RemoteMediator.
- Регистрация нового прослушивателя loadState или нового сборщика в
.loadStateFlowбольше не будет немедленно выдавать текущее значение, если он не получил реальныйCombinedLoadStatesотPagingData. Это может произойти, если сборщик или прослушиватель запускается до отправкиPagingData. (I1a748)
Версия 3.1.0-alpha03
21 июля 2021 г.
Данные "androidx.paging:paging-*:3.1.0-alpha03" опубликованы. Версия 3.1.0-alpha03 содержит эти коммиты.
Изменения в API
В PagingSource добавлен третий тип возвращаемого значения LoadResult – LoadResult.Invalid. Когда PagingSource.load возвращает LoadResult.Invalid, разбиение на страницы отбрасывает загруженные данные и делает PagingSource недействительным. Этот тип возвращаемого значения предназначен для обработки потенциально недействительных или устаревших данных, которые могут быть возвращены из базы данных или сети.
Например, если в базовую базу данных выполняется запись, но PagingSource не аннулируется вовремя, он может возвращать несогласованные результаты, если его реализация зависит от неизменности резервного набора данных, из которого он загружается (например, реализации БД в стиле LIMIT OFFSET). В этом случае рекомендуется проверять недействительность после загрузки и возвращать LoadResult.Invalid, что заставляет Paging отбрасывать любые ожидающие или будущие запросы на загрузку для этого PagingSource и аннулировать его.
Этот тип возвращаемого значения также поддерживается Paging2 API, который использует LivePagedList или RxPagedList. При использовании PagingSource с API PagedList из Paging 2 PagedList немедленно отсоединяется, что останавливает дальнейшие попытки загрузить данные в этот PagedList и запускает аннулирование в PagingSource.
LoadResult – это запечатанный класс, поэтому изменение несовместимо с исходным кодом. В случаях, когда напрямую используются результаты PagingSource.load, во время компиляции нужно будет обрабатывать LoadResult.Invalid. Например, пользователям Kotlin, которые используют exhaustive-when для проверки типа возвращаемого значения, нужно будет добавить проверку на недопустимый тип. (Id6bd3, b/191806126, b/192013267)
Исправление ошибок
- Обратные вызовы недействительности, добавленные через PagingSource.registerInvalidatedCallback или DataSource.addInvalidatedCallback, теперь автоматически запускаются, если они были зарегистрированы в PagingSource/DataSource, который уже был недействителен. Это устраняет состояние гонки, из-за которого Paging отбрасывал сигналы недействительности и зависал, если при начальной загрузке предоставлялся уже недействительный источник. Кроме того, обратные вызовы invalidate теперь корректно удаляются после запуска, поскольку гарантированно вызываются не более одного раза. (I27e69)
- Отправка начального значения плейсхолдера (InitialPagedList) из нового экземпляра потока PagedList, например LivePagedListBuilder или RxPagedListBuilder, больше не будет очищать ранее загруженные данные.
Версия 3.1.0-alpha02
1 июля 2021 г.
Данные "androidx.paging:paging-*:3.1.0-alpha02" опубликованы. Версия 3.1.0-alpha02 содержит эти коммиты.
Новые функции
Добавлены API прослушивателя onPagesPresented и flow presenter, которые срабатывают сразу после обновления представленных страниц в интерфейсе.
Поскольку эти обновления синхронизируются с пользовательским интерфейсом, вы можете вызывать методы адаптера, такие как .snapshot, .getItemCount, чтобы проверить состояние после применения обновления. Обратите внимание, что метод .snapshot() вызывается явно, поскольку его выполнение при каждом обновлении может быть ресурсоемким.
Обновление страницы может произойти в следующих случаях:
- Завершается начальная загрузка нового поколения PagingData, независимо от того, содержит ли новое поколение какие-либо изменения в представленных элементах. То есть: Новое поколение, завершающее начальную загрузку без обновлений, поскольку список точно такой же, все равно вызовет этот обратный вызов.
- Страница вставляется, даже если она не содержит новых элементов.
- Страница удаляется, даже если она пустая (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).
Исправление ошибок
- Исправлена ошибка, из-за которой Paging иногда отправлял в RecyclerView события сравнения, не выполняющие никаких операций. Это могло приводить к преждевременному срабатыванию некоторых прослушивателей. (Ic507f, b/182510751)
Внешний вклад
- В артефакт rxjava3 добавлены устаревшие API совместимости PagedList (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 содержит эти коммиты.
Поддержка всех ленивых макетов
Ранее Paging Compose предоставлял пользовательские расширения items и itemsIndexed для LazyListScope. Это означало, что вы не могли использовать Paging Compose с другими ленивыми макетами, такими как LazyVerticalGrid, HorizontalPager, или другими пользовательскими ленивыми компонентами, предоставляемыми библиотеками Wear и TV. В этом выпуске мы решили эту проблему.
Чтобы поддерживать больше ленивых макетов, нам нужно было создать API на другом уровне. Вместо того чтобы предоставлять собственный API items для каждого ленивого макета, 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 стали на несколько строк длиннее, мы посчитали, что согласованность всех ленивых макетов является важным фактором для тех, кто в дальнейшем будет использовать Paging Compose. Поэтому существующие расширения для LazyListScope теперь не поддерживаются. (I0c459, I92c8f, b/276989796)
Изменения в API
- Чтобы упростить переход на новые API, функции расширения
itemsиitemsIndexedвLazyListScopeтеперь поддерживают параметрcontentType, как и новые API. (Ib1918, b/255283378)
Обновления зависимостей
- Зависимость Paging Compose обновлена с 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 is released with no changes. Версия 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), используемые для подключения Paging кLazyColumn/Row, теперь принимают параметр option key, который позволяет указать стабильный ключ, представляющий элемент. Подробнее о ключах… (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 и метод получения элементов 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
- В
LazyPagingItemдобавлены методы.peek(),.snapshot(),.retry()и.refresh(), которые предоставляют те же функции, что и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 обеспечивает интеграцию между библиотекой Paging и 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, которые обеспечивают следующие улучшения:
- Первоклассная поддержка сопрограмм Kotlin и Flow.
- Поддержка при отмене
- Встроенные сигналы о состоянии загрузки и ошибках
- Функция повтора и обновления
- Все три подкласса DataSource были объединены в единый класс PagingSource.
- Специальные преобразования страниц, включая встроенное преобразование для добавления разделителей.
- Загрузка верхних и нижних колонтитулов
Версия 3.0.0-rc01
21 апреля 2021 г.
Данные "androidx.paging:paging-*:3.0.0-rc01" опубликованы. Коммиты, относящиеся к версии 3.0.0-rc01
Исправление ошибок
- Исправлена ошибка, из-за которой Paging иногда отправлял в RecyclerView события сравнения, не выполняющие никаких операций. Это могло приводить к преждевременному срабатыванию некоторых прослушивателей. (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
- Оболочки Rx2 и Rx3 теперь предоставляют экспериментальную аннотацию, от которой они зависят. Если вы используете обертки совместимости Rx в paging-rxjava2 или paging-rxjava3, вам нужно будет аннотировать их использование с помощью
@OptIn(ExperimentalCoroutinesApi::class)(Ib1f9d).
Исправление ошибок
- Исправлена ошибка
IndexOutOfBoundsException: Inconsistency detected, которая иногда возникала при использовании APIDataSourceверсии 2 через пути совместимости. - Вызов
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, позволяющий настраивать поведение разделителя терминала (верхнего/нижнего колонтитула). Доступны два варианта:
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 нужно будет устранить неоднозначность, вызвав функцию расширения, которая принимает приостанавливающий блок.
Все операторы преобразования 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 содержит эти коммиты.
Новые функции
- Добавлена поддержка сохраненного состояния для следующих основных сценариев использования (полная поддержка, особенно в случае многоуровневого источника, все еще находится в разработке):
- flow кэшируется, а приложение не закрывается (например, flow кэшируется в модели представления, а действие воссоздается в процессе)
- Источник разбиения на страницы подсчитывается, плейсхолдеры включены, а макет не является ступенчатым.
Изменения в API
PagingSource.getRefreshKey()теперь является стабильным API (I22f6f, b/173530980).- Функция
PagingSource.invalidateбольше не является открытой. Если вам нужно получать уведомления о недействительности, вызовите метод registerInvalidatedCallback вместо переопределения invalidate. (I628d9, b/173029013, b/137971356) - Теперь у Pager есть один экспериментальный конструктор наряду с обычными конструкторами. Экспериментальные API больше не попадают в неэкспериментальный общедоступный API через аннотацию согласия. (I9dc61, b/174531520)
- Обновлены свойства
CombinedLoadStates.refresh,CombinedLoadStates.prependиCombinedLoadStates.append, чтобы переход из состоянияLoadingвNotLoadingпроисходил только после того, как состояния загрузки посредника и источника станутNotLoading. Это гарантирует, что удаленное обновление было применено. (I65619) Удален параметр LoadParams.pageSize (он уже был устаревшим). Рекомендуется использовать
LoadParams.loadSizeв PagingSource.LoadParams.loadSizeвсегда равноPagingConfig.pageSize, за исключением первого вызова загрузки, когда оно равноPagingConfig.initialLoadSize.Если вы тестируете DataSource из Paging2 без использования Pager или PagedList,
pageSizeможет не совпадать сPagingConfig.pageSize, если вы также задаетеinitialLoadSize. Если это важно для ваших тестов, попробуйте использовать Pager/PagedList, который будет внутренне устанавливать правильный PageSize для методов загрузки DataSource. (I98ac7, b/149157296)
Исправление ошибок
- Исправлен сбой, вызванный IllegalStateException при использовании разделителей с заданным PagingConfig.maxSize. (I0ed33, b/174787528)
- Исправлена ошибка, из-за которой состояние загрузки для PREPEND/APPEND не обновлялось до
NotLoading(endOfPaginationReached = true)сразу после начальной загрузки, если был задан RemoteMediator (I8cf5a). - Исправлена ошибка, из-за которой API на стороне презентера, такие как .snapshot(), .peek() и т. д., возвращали предыдущий (устаревший) список в обновлениях ListUpdateCallback.
- Исправлена ошибка, из-за которой операторы Separators не добавляли верхние или нижние колонтитулы при использовании с RemoteMediator.
- Исправлена ошибка, из-за которой обновления LoadState до NotLoading для RemoteMediator застревали в состоянии Loading.
- Исправлена ошибка, из-за которой API совместимости Paging 2.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)
Внешний вклад
- Добавлен новый абстрактный класс InvalidatingPagingSourceFactory с API
.invalidate(), который перенаправляет invalidate всем создаваемым им PagingSource. Спасибо @claraf3! (Ie71fc, b/160716447)
Известные проблемы
- Верхние и нижние колонтитулы из преобразования .insertSeparators() могут не сразу появляться при использовании 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)
Исправление ошибок
- Исправлена ошибка, из-за которой при использовании разделителей с RemoteMediator возникало исключение
IllegalArgumentException, а при удаленной загрузке, которая возвращала endOfPagination, запускалась инвалидация (I3a260).
Версия 3.0.0-alpha08
28 октября 2020 г.
Данные "androidx.paging:paging-*:3.0.0-alpha08" опубликованы. Версия 3.0.0-alpha08 содержит эти коммиты.
Изменения в API
- Варианты
DataSource.InvalidatedCallbackдля Kotlin и Java были объединены путем включения SAM-преобразований в Kotlin через функциональный интерфейс (доступно в Kotlin 1.4). Также исправлена ошибка, из-за которой обратные вызовы invalidate в Kotlin не выполнялись после преобразования с помощью.mapили.mapByPage. (I1f244, b/165313046)
Исправление ошибок
- Значительно улучшено взаимодействие Paging с ViewPager. В частности, Paging больше не будет отменять вызов
RemoteMediator#loadиз-за недействительности страницы. Кроме того, если требуется REFRESH, то до успешного выполнения запроса REFRESH не будет выполняться запрос на загрузку с добавлением в начало или конец. (I6390b, b/162252536) - Для androidx включена проверка MissingGetterMatchingBuilder (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 для асинхронного класса 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
- Теперь при вызове
PagingDataAdapter.setHasStableIdsвыдается ошибкаUnsupportedOperationExceptionс более понятным сообщением о том, что стабильные идентификаторы не поддерживаются. (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при повторной загрузке больше не приводит к тому, что доступ к объектам ошибочно запускает повторную попытку.
Внешний вклад
- Спасибо Кларе Ф. за помощь в очистке некоторых тестов! (549612)
Версия 3.0.0-alpha04
5 августа 2020 г.
Данные "androidx.paging:paging-*:3.0.0-alpha04" опубликованы. Версия 3.0.0-alpha04 содержит эти коммиты.
Изменения в API
- Добавлен API
peek()дляAsyncPagingDataDifferиPagingDataAdapter, чтобы разрешить доступ к представленным данным без загрузки триггерных страниц. (I38898, b/159104197) - В
PagingDataAdapterиAsyncPagingDataDifferдобавлен APIsnapshot(), позволяющий получать представленные элементы без запуска извлечения страницы. (I566b6, b/159104197) - Добавлен конструктор
PagingData.from(List<T>), позволяющий представлять статические списки, которые можно комбинировать с общим потоком PagingData для показа статических списков в определенных состояниях, например до завершения начального REFRESH или просто для тестирования преобразований. (Id134d) - Прекращена поддержка API dataRefresh Flow и Listener, поскольку они предназначались для показа состояния представленных элементов при обновлении, но с улучшением времени обратного вызова loadState Flow и Listener, а также свойства itemCount они стали избыточными (Ia19f3).
- Добавлены оболочки совместимости RxJava3 для
PagingSourceиRemoteMediator(I49ef3, b/161480176).
Исправление ошибок
PositionalDataSource, преобразованные вPagingSourceс помощью помощникаtoPagingSourceFactory, включаяPagingSource, сгенерированные Room, теперь правильно помечают себя для поддержки перехода. (I3e84c, b/162161201)- Исправлена ошибка, из-за которой использование синхронного варианта submitData иногда приводило к состоянию гонки, вызывающему
ClosedSendChannelException(I4d702, b/160192222).
Внешний вклад
- Благодарим Зака Свирса (Zac Sweers) за добавление оберток совместимости 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).
- Варианты функции map в DataSource на Kotlin скрыты от Java, чтобы устранить неоднозначность между исходными вариантами и вариантами на Kotlin. (If7b23, b/161150011)
- Избыточные API, предназначенные для удобства пользователей Kotlin, помечены как @JvmSynthetic (I56ae5).
- Добавлены перегрузки для конструктора LoadResult.Page, в котором для itemsBefore и itemsAfter по умолчанию задано значение COUNT_UNDEFINED (I47849).
- Существующие операторы PagingData теперь принимают методы приостановки. Для пользователей Java добавлены новые операторы mapSync, flatMapSync и filterSync, не поддерживающие приостановку. Существующие методы преобразования были перенесены в функции расширения, поэтому пользователям Kotlin теперь нужно будет их импортировать. (I34239, b/159983232)
Исправление ошибок
- PagingSource для Room (и PositionalDataSource) теперь будут показывать начальный разделитель на первой странице, чтобы пользователю не нужно было прокручивать экран. (I6f747, b/160257628)
- Доступ к элементам в плейсхолдерах теперь корректно запускает загрузку PagingSource, пока не будет возвращена страница, которая соответствует запрошенному индексу после преобразования с помощью PagingData.filter() (I95625, b/158763195).
- Исправлена ошибка, из-за которой прокрутка после того, как PagingSource возвращает ошибку, могла препятствовать повторной попытке PagingDataAdapter.retry(). (I1084f, b/160194384)
- Исправлена ошибка, из-за которой при доступе к элементу после удаления страницы могли не загружаться страницы, хотя доступ к элементу был в пределах prefetchDistance (Ie95ae, b/160038730).
- При настройке PagingConfig.maxSize больше не включаются плейсхолдеры после события drop (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). - Добавлены API RxJava и Guava для RemoteMediator – RxRemoteMediator и ListenableFutureRemoteMediator.
- В PagingState добавлены вспомогательные функции для доступа к общим элементам, таким как
isEmpty()иfirstItemOrNull()(I3b5b6, b/158892717).
Исправление ошибок
- Теперь Pager проверяет, не используется ли PagingSource повторно в фабрике, чтобы предотвратить случайное повторное использование недопустимых PagingSource, которое приводило к неясной ошибке (I99809, b/158486430).
- Сбои при обновлении RemoteMediator больше не препятствуют загрузке PagingSource (I38b1b, b/158892717).
- Версия
submitDataбез приостановки больше не вызывает сбой из-за одновременного сбора данных в несколькихPagingData, если она вызывается после версииsubmitDataс приостановкой. (I26358, b/158048877) - Исправлено исключение "cannot collect twice from pager", которое могло возникать после изменения конфигурации (I58bcc, b/158784811).
Версия 3.0.0-alpha01
10 июня 2020 г.
Данные "androidx.paging:paging-*:3.0.0-alpha01" опубликованы. Версия 3.0.0-alpha01 содержит эти коммиты.
Библиотека Paging Library обновлена до версии 3.0, в которой появилось несколько новых функций.
Новые функции в версии 3.0
- Первоклассная поддержка сопрограмм Kotlin и Flow.
- Поддержка асинхронной загрузки с помощью приостанавливаемых функций сопрограмм, примитивов RxJava Single или Guava ListenableFuture.
- Встроенные сигналы о состоянии загрузки и ошибках для адаптивного дизайна интерфейса, включая функции повтора и обновления.
- Улучшения уровня репозитория
- Упрощенный интерфейс источников данных
- Упрощенная разбивка на страницы для сети и базы данных
- Поддержка по вопросам отмены
- Улучшения уровня представления
Известные проблемы
- Документация 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была выпущена по ошибке из неправильно настроенной ветки. В результате стали доступны частично реализованные 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 содержит эти коммиты.
Исправление ошибок
- Если плейсхолдеры отключены, то смежные начальные загрузки из PositionalDataSources теперь центрируются вокруг последнего доступа.
Версия 2.1.0
Версия 2.1.0
25 января 2019 г.
Выпущена версия Paging 2.1.0 без изменений по сравнению с 2.1.0-rc01.
Версия 2.1.0-rc01
6 декабря 2018 г.
Выпущена версия Paging 2.1.0-rc01 без изменений по сравнению с 2.1.0-beta01.
Версия 2.1.0-beta01
1 ноября 2018 г.
Выпущена версия Paging 2.1.0-beta01 без изменений по сравнению с 2.1.0-alpha01.
Версия 2.1.0-alpha01
12 октября 2018 г.
В Paging 2.1.0-alpha01 появилось два основных дополнения: удаление страниц и библиотеки расширений KTX для каждого артефакта, а также несколько других изменений API и исправлений ошибок.
Изменения в API
- Добавлен параметр
PagedList.Config.Builder.setMaxSize(), позволяющий ограничить количество загружаемых в память объектов. - Добавлен метод
androidx.paging.Config()как альтернативаPagedList.Config.Builderдля Kotlin. - Добавлен метод
androidx.paging.PagedList()как альтернативаPagedList.Builderдля Kotlin. - Добавлен метод
DataSourceFactory.toLiveData()как альтернативаLivePagedListBuilderдля Kotlin. - Добавлены
DataSourceFactory.toObservable()иtoFlowable()в качестве альтернатив Kotlin дляRxPagedListBuilder. - Добавлен метод
AsyncPagedListDiffer.addPagedListListener()для отслеживания замены PagedList. b/111698609 - Добавлен вариант
PagedListAdapter.onCurrentListChanged(), который передает старый и новый списки. Предыдущий вариант больше не поддерживается. - Добавлены варианты
PagedListAdapter/AsyncPagedListDiffer.submitList(), которые принимают дополнительный обратный вызов, срабатывающий, если/когда отображается pagedlist, после сравнения. Это позволяет синхронизировать замену PagedList с другими обновлениями интерфейса. 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.
- Исправлены сбои, из-за которых
PagedListAdapterиAsyncPagedListDifferне могли сигнализировать о событиях перемещения (уже выпущено в1.0.1). b/110711937
Зависимости до AndroidX
Для версий Paging до AndroidX включите следующие зависимости:
dependencies {
def paging_version = "1.0.0"
implementation "android.arch.paging:runtime:$paging_version"
// alternatively - without Android dependencies for testing
testImplementation "android.arch.paging:common:$paging_version"
// optional - RxJava support
implementation "android.arch.paging:rxjava2:$paging_version"
}
Версия 1.0.1
Версия 1.0.1
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 г.
Библиотека Paging будет находиться в бета-версии в течение короткого времени, прежде чем перейти к релиз-кандидату.
Мы не планируем дальнейших изменений 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, уточняющие роль исполнителей в конструкторах:
Название изменено с "
setBackgroundThreadExecutor()" на "setFetchExecutor()" (вPagedList.BuilderиLivePagedListBuilder)Название файла "
setMainThreadExecutor()" изменено на "setNotifyExecutor()" (в папке "PagedList.Builder").
Элемент
PagedList.mCallbacksдолжен быть закрытым.
Исправление ошибок
LivePagedListBuilderзапускает начальную загрузкуPagedListв указанном исполнителе, а не в пуле потоков ввода-вывода компонентов архитектуры.Исправлено поведение аннулирования во внутренних оболочках
DataSource(используется для реализацииDataSource.map, а также загрузкиPositionalDataSourceс отключенным плейсхолдером). b/77237534
Версия 1.0.0-alpha7
21 марта 2018 г.
Библиотека Paging 1.0.0-alpha7 выпущена вместе с Lifecycles 1.1.1. Поскольку Paging alpha7 зависит от перемещения класса Function, упомянутого выше, вам нужно будет обновить зависимость lifecycle:runtime до android.arch.lifecycle:runtime:1.1.1.
Paging alpha7 планируется как финальный выпуск перед бета-версией.
Изменения в API
- Объекты
DataSource.LoadParamsтеперь имеют общедоступный конструктор, а объектыDataSource.LoadCallbackстали абстрактными. Это позволяет упаковатьDataSourceили напрямую протестироватьDataSourceс помощью макета обратного вызова. b/72600421 - Преобразователи для 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 теперь являются финальными. 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.