Пейджинг

Библиотека постраничного просмотра упрощает постепенную и изящную загрузку данных в RecyclerView вашего приложения.

В этой таблице перечислены все артефакты в группе androidx.paging .

Артефакт Стабильный релиз Кандидат на релиз Бета-версия Альфа-релиз
пейджинг-* 3.3.6 - - 3.4.0-альфа02
paging-compose 3.3.6 - - 3.4.0-альфа02
Последнее обновление этой библиотеки: 30 июля 2025 г.

Объявление зависимостей

Чтобы добавить зависимость от Paging, необходимо добавить репозиторий Google Maven в свой проект. Подробнее см. в репозитории Google Maven .

Добавьте зависимости для необходимых артефактов в файл build.gradle вашего приложения или модуля:

Круто 

dependencies {
  def paging_version = "3.3.6"

  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.4.0-alpha02"
}

Котлин 

dependencies {
  val paging_version = "3.3.6"

  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.4.0-alpha02")
}

Информацию об использовании расширений Kotlin см. в документации ktx .

Дополнительную информацию о зависимостях см. в разделе Добавление зависимостей сборки .

Обратная связь

Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с уже существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав на кнопку со звёздочкой.

Создать новый выпуск

Более подробную информацию см. в документации по системе отслеживания проблем .

Версия 3.4

Версия 3.4.0-альфа02

30 июля 2025 г.

Выпущен androidx.paging:paging-*:3.4.0-alpha02 . Версия 3.4.0-alpha02 содержит следующие коммиты .

Изменения API

  • PagingData.from теперь позволяет устанавливать placeholdersBefore и placeholdersAfter . Обратите внимание, что прокрутка этих плейсхолдеров не запускает загрузку. ( I06983 )

Версия 3.4.0-альфа01

2 июля 2025 г.

Выпущен androidx.paging:paging-*:3.4.0-alpha01 . Версия 3.4.0-alpha01 содержит следующие коммиты .

Новые функции

Исправления ошибок

  • Модульные тесты Android, использующие Paging 3.3 или более позднюю версию, больше не будут выдавать ошибку из PagingLogger ( Ia9400 , b/331684448 ).
  • Исправлена ошибка, из-за которой RecyclerView выдавал исключение IndexOutOfBoundsException , когда пользователь прокручивал страницу во время обновления RecyclerView ( Id1f16 , b/381024738 ).
  • Исправлена ошибка, из-за которой при обновлении во время прокрутки не удавалось инициировать дополнительные загрузки. ( I60ca5 , b/352586078 )
  • Исправлен сбой при прокрутке во время обновления элементов постраничного просмотра. ( I8c65a , b/347649763 )

Версия 3.3

Версия 3.3.6

12 февраля 2025 г.

Выпущен androidx.paging:paging-*:3.3.6 . Версия 3.3.6 содержит следующие коммиты .

Исправления ошибок

  • Сигналы обновления и повторной попытки, отправленные во время первоначального обновления, теперь будут сохраняться и автоматически повторно отправляться, как только ведущий пейджинга будет готов.

Внешний вклад

  • Спасибо, Ева, за отправку исправления ошибки ( #754 )

Версия 3.3.5

11 декабря 2024 г.

Выпущен androidx.paging:paging-*:3.3.5 . Версия 3.3.5 содержит следующие коммиты .

Исправления ошибок

  • Исправлена ошибка, из-за которой RecyclerView выдавал исключение IndexOutOfBoundsException , когда пользователь прокручивал страницу во время обновления RecyclerView . ( Id1f16 , b/381024738 )

Версия 3.3.4

13 ноября 2024 г.

Выпущен androidx.paging:paging-*:3.3.4 . Версия 3.3.4 содержит следующие коммиты .

Исправления ошибок

  • Модульные тесты 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 .
  • Добавлены новые вспомогательные методы LoadStates и CombinedLoadStates в hasError и isIdle для проверки состояния LoadStates : Error или NotLoading соответственно. Также добавлен новый метод расширения Kotlin awaitNotLoading() для Flow<CombinedLoadStates> , который ожидает, пока загрузка не перейдет в состояние NotLoading или Error.
  • PagingData.empty() теперь по умолчанию отправляет состояния NotLoading , если только его конструктору не переданы пользовательские LoadStates . Это отличается от существующего поведения, где он не отправляет LoadStates при передаче в PagingDataAdapter или отправляет состояния Loading при сборе как LazyPagingItems . При сборе как LazyPagingItems он теперь также отображает пустой список сразу после первоначального составления.

Совместимость с Kotlin на разных платформах

Теперь пагинация отправляет артефакты, совместимые с Kotlin Multiplatform, во многом благодаря работе над проектом пагинации CashApp.

  • paging-common перенес все API Paging 3 в common и теперь совместим с jvm и iOS в дополнение к Android.
  • paging-testing перенес свой код в common и теперь совместим с jvm и iOS в дополнение к Android.
  • paging-compose перенес свой код в common и поставляет артефакт Android, соответствующий многоплатформенной поддержке androidx.compose .
  • paging-runtime , paging-guava , paging-rxjava2 и paging-rxjava3 останутся только для Android.

Версия 3.3.0-rc01

1 мая 2024 г.

androidx.paging:paging-*:3.3.0-rc01 выпущен без изменений в Paging 3.3.0-beta01. Версия 3.3.0-rc01 содержит следующие коммиты .

Версия 3.3.0-beta01

3 апреля 2024 г.

androidx.paging:paging-*:3.3.0-beta01 выпущен без существенных изменений. Версия 3.3.0-beta01 содержит следующие коммиты .

Версия 3.3.0-альфа05

20 марта 2024 г.

Выпущен androidx.paging:paging-*:3.3.0-alpha05 . Версия 3.3.0-alpha05 содержит следующие коммиты .

Изменения API

  • Теперь при пагинации используется аннотация AndroidX @MainThread для общего кода. ( I78f0d , b/327682438 )

Версия 3.3.0-альфа04

6 марта 2024 г.

Выпущена androidx.paging:paging-*:3.3.0-alpha04 . Версия 3.3.0-alpha04 содержит следующие коммиты .

Исправления ошибок

  • Исправлены незначительные ошибки документации, связанные с добавлением мультиплатформенной совместимости Kotlin. ( aosp/2950785 )

Версия 3.3.0-альфа03

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 или Error. ( Id6c67 )

Изменение поведения

  • PagingData.empty() теперь по умолчанию отправляет состояния NotLoading , если только его конструктору не переданы пользовательские LoadStates . Это отличается от существующего поведения, когда он не отправляет LoadStates при передаче в PagingDataAdapter или отправляет состояния Loading при сборе в LazyPagingItems . При сборе в LazyPagingItems он теперь также отображает пустой список сразу после первоначального составления. ( I4d11d , b/301833847 )

Версия 3.3.0-альфа02

20 сентября 2023 г.

Выпущена androidx.paging:paging-*:3.3.0-alpha02 . Версия 3.3.0-alpha02 содержит следующие изменения.

Совместимость с Kotlin на разных платформах

Подкачка теперь поставляет артефакты, совместимые с Kotlin Multiplatform, во многом благодаря работе над проектом CashApp по подкачиванию мультиплатформенных подкачек . Это позволит нам избежать расхождений между двумя репозиториями и поддерживать их совместимость.

  • paging-common перенес все API Paging 3 в common и теперь совместим с jvm и iOS в дополнение к Android.
  • paging-testing перенес свой код в common и теперь совместим с jvm и iOS в дополнение к Android.
  • paging-compose перенес свой код в common и поставляет артефакт Android, соответствующий многоплатформенной поддержке androidx.compose .
  • paging-runtime , paging-guava , paging-rxjava2 и paging-rxjava3 останутся только для Android.

Изменения API

  • Открытый интерфейс Logger, предназначенный только для внутреннего использования, устарел ( I16e95 , b/288623117 ).

Внешний вклад

Версия 3.3.0-альфа01

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 зависал при передаче потока, созданного с помощью 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

  • API Paging Compose достигло стабильности и было объединено с остальной частью Paging, где его версия теперь соответствует всем остальным артефактам Paging. Изменения по сравнению с версией 3.1.0 включают:
    • Поддержка предварительного просмотра списка поддельных данных путём создания PagingData.from(fakeData) и помещения этого PagingData в MutableStateFlow (например MutableStateFlow(PagingData.from(listOf(1, 2, 3))) ). Передайте этот поток в @Preview composables как приемник для collectAsLazyPagingItems() для предварительного просмотра.
    • Поддержка всех ленивых макетов, таких как LazyVerticalGrid и HorizontalPager , а также пользовательских ленивых компонентов из библиотек Wear и TV. Это было достигнуто благодаря новым низкоуровневым методам расширения LazyPagingItems itemKey и itemContentType , которые помогают реализовать параметры key и contentType в стандартных API items , уже существующих для LazyColumn , LazyVerticalGrid , а также их эквивалентов в API, таких как HorizontalPager .
    • items(lazyPagingItems) и itemsIndexed(lazyPagingItems) , которые поддерживают только LazyListScope , устарели.
  • Новый артефакт paging-testing , предоставляющий API, разработанные для модульного тестирования каждого слоя вашего приложения и его изолированной интеграции с пейджингом. Например, он включает:
    • Класс TestPager , который позволяет вам проверять поведение вашей собственной реализации PagingSource независимо от Pager и реального пользовательского интерфейса.
    • API-интерфейсы asPagingSourceFactory для преобразования 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 . Эту фабрику можно использовать для создания экземпляра пейджера.

Версия 3.2.0-rc01

21 июня 2023 г.

Выпущена androidx.paging:paging-*:3.2.0-rc01 . Версия 3.2.0-rc01 содержит следующие изменения.

Внешний вклад

  • Спасибо Veyndan за вклад в отход пейджинга от специфики Android/JVM. ( #553 , #554 , #555 , #559 )

Версия 3.2.0-beta01

7 июня 2023 г.

Выпущена androidx.paging:paging-*:3.2.0-beta01 . Версия 3.2.0-beta01 содержит следующие изменения.

Пейджинговое сообщение

  • API Paging Compose официально достигло стабильности. В связи с этим версия была обновлена с 1.0.0-alpha20 и теперь соответствует версии всех остальных артефактов Paging.

Изменения API

Версия 3.2.0-альфа06

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 в тестировании страниц теперь аннотируются @VisibleForTesting , чтобы гарантировать, что эти API используются только в тестах. ( I7db6e )
  • API asSnapshot больше не требует передачи CoroutineScope . Теперь по умолчанию используется контекст, унаследованный от родительской области действия. ( Id0a78 , b/282240990 )
  • Изменен порядок параметров конструктора TestPager для интуитивного соответствия порядку реальных параметров конструктора Pager ( I6185a ).
  • Использование типа лямбда () -> PagingSource<Key, Value> в paging-testing перенесено на тип PagingSourceFactory<Key, Value> . ( I4a950 , b/280655188 )

Изменения поведения

  • Для запуска тестов asSnapshot Paging больше не требуется главный диспетчер. Его установка больше не вносит никаких изменений в поведение теста. ( Ie56ea )

Версия 3.2.0-альфа05

3 мая 2023 г.

Выпущена androidx.paging:paging-*:3.2.0-alpha05 . Версия 3.2.0-alpha05 содержит следующие изменения.

Изменения API

  • API тестирования страниц asSnapshot теперь по умолчанию использует для параметра loadOperations пустое лямбда-выражение. Это позволяет вызывать asSnapshot без передачи каких-либо операций загрузки для извлечения данных из начальной загрузки обновления. ( Ied354 , b/277233770 )

Улучшения документации

  • Обновлена документация по asPagingSourceFactory() с целью уточнения того, что это метод расширения Flow , который возвращает повторно используемую фабрику для генерации экземпляров PagingSource . ( I5ff4f , I705b5 )
  • Обновлена документация по конструктору LoadResult.Page с целью пояснения необходимости переопределения itemsBefore и itemsAfter для поддержки переходов. ( Ied354 )

Внешние взносы

Версия 3.2.0-альфа04

8 февраля 2023 г.

Выпущена androidx.paging:paging-*:3.2.0-alpha04 . Версия 3.2.0-alpha04 содержит следующие изменения.

Тестирование пейджинга

  • Артефакт paging-testing теперь содержит метод asPagingSourceFactory для создания pagingSourceFactory из Flow<List<Value>> который будет передан пейджеру. Каждый List<Value>> создаваемый потоком, представляет собой генерацию постраничных данных. Это упрощает тестирование постраничного обмена, например, преобразований PagingData , имитируя источник данных, из которого пейджер будет собирать данные. ( 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 values

    asSnapshot — это метод 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-альфа03

24 октября 2022 г.

Выпущена androidx.paging:paging-*:3.2.0-alpha03 . Версия 3.2.0-alpha03 содержит следующие изменения.

Тестирование пейджинга

Этот выпуск содержит новый артефакт: paging-testing . Этот артефакт предоставляет API, разработанные для модульного тестирования каждого слоя вашего приложения и его изолированной интеграции с пейджингом.

Например, этот первый выпуск включает класс TestPager , который позволяет вам проверять поведение вашей собственной реализации PagingSource независимо от Pager и реального пользовательского интерфейса, которые обычно требуются для моделирования сквозной интеграции Paging.

TestPager следует считать подделкой — тестовым двойником , который зеркально отражает реальную реализацию Pager , предоставляя при этом упрощённый API для тестирования PagingSource . Эти API являются API suspend и должны запускаться в runTest , как описано в руководстве по тестированию сопрограмм Kotlin на Android .

Пример использования этих API можно найти в тестах room-paging , которые были переработаны для использования TestPager .

Изменения API

  • Обеспечивает удобную итерацию по LoadResult.Page.data через LoadResult.Page.iterator() . Это косвенно позволяет использовать метод flatten стандартной библиотеки Kotlin при наличии List<LoadResult.Page> например, со свойством pages объекта PagingState , которое передается методу PagingSource.getRefreshKey . ( Ie0718 )

Версия 3.2.0-альфа02

10 августа 2022 г.

Выпущена androidx.paging:paging-*:3.2.0-alpha02 . Версия 3.2.0-alpha02 содержит следующие изменения.

Новые функции

  • Пейджинг теперь предоставляет журналы через классы AsyncPagingDataDiffer или PagingDataAdapter для предоставления отладочной информации, собранной из PagingData .
  • Журналы можно включить с помощью команды adb shell adb shell setprop log.tag.Paging [DEBUG|VERBOSE]. ( b/235527159 )

Исправления ошибок

  • Исправлена ошибка отсутствующего конструктора PagingDataDiffer при использовании paging-common:3.2.0-alpha01 с версией среды paging-runtime:3.1.1 или более ранней. ( b/235256201 )

Версия 3.2.0-альфа01

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 )

Внешний вклад

  • Обновлен :compose:ui:ui-test api (updateApi) в связи с миграцией test-coroutines-lib ( I3366d )

Версия 3.1

Версия 3.1.1

9 марта 2022 г.

Выпущена androidx.paging:paging-*:3.1.1 . Версия 3.1.1 содержит следующие изменения.

Исправления ошибок

  • Удалены промежуточные события LoadState.NotLoading между поколениями, которые были неправильно вставлены с помощью .cachedIn() . Это изменение значительно упрощает реагирование на изменения LoadState за счёт удаления избыточных событий LoadState.NotLoading , которые возникали между попытками неудачной загрузки, при обновлении или аннулировании.

Версия 3.1.0

17 ноября 2021 г.

Выпущена androidx.paging:paging-*:3.1.0 . Версия 3.1.0 содержит следующие изменения.

Важные изменения с версии 3.0.0

  • API Flow<PagingData>.observable и Flow<PagingData>.flowable больше не являются экспериментальными.
  • Изменения поведения LoadState :
    • endOfPaginationReached теперь всегда false для LoadType.REFRESH как для PagingSource , так и для RemoteMediator
    • LoadStates из 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 при отсутствии наблюдателей или в период, когда наблюдатель переключался на новый 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-альфа04

29 сентября 2021 г.

Выпущена androidx.paging:paging-*:3.1.0-alpha04 . Версия 3.1.0-alpha04 содержит следующие изменения.

Изменения API

  • API Flow<PagingData>.observable и Flow<PagingData>.flowable больше не являются экспериментальными. ( Ie0bdd )

Исправления ошибок

  • Для LoadStates endOfPaginationReached теперь всегда имеет false для LoadType.REFRESH . Ранее endOfPaginationReached мог иметь true для RemoteMediator REFRESH , но не для PagingSource . Теперь это поведение консолидировано и всегда возвращает false , поскольку REFRESH никогда не имеет смысла быть конечным, и документировано как часть контракта API в LoadStates. При принятии решения о завершении пагинации всегда следует делать это с учетом направления APPEND или PREPEND . ( I047b6 )

  • LoadStates из Paging теперь ожидают допустимых значений как от PagingSource, так и от RemoteMediator, прежде чем передавать данные ниже по цепочке между поколениями. Это предотвращает отправку NotLoading новыми поколениями PagingData в CombinedLoadStates.source.refresh, если они уже находятся в состоянии Loading; новые поколения PagingData теперь всегда будут корректно начинать обновление с состояния Loading, а не сбрасываться в NotLoading, что в некоторых случаях было некорректно.

    Отмена предыдущих поколений теперь происходит быстро при аннулировании/новой генерации. Использование .collectLatest для Flow<PagingData> больше не требуется, хотя это по-прежнему настоятельно рекомендуется. ( I0b2b5 , b/177351336 , b/195028524 )

  • .loadStateFlow и .addLoadStateListener в API презентера больше не отправляют избыточно начальный CombinedLoadStates , в котором состояния медиатора всегда установлены в null , а состояния источника — в NotLoading(endOfPaginationReached = false) . Это означает, что:

    1. Если вы используете RemoteMediator, состояния посредника всегда будут заполнены.
    2. Регистрация нового прослушивателя loadState или нового сборщика в .loadStateFlow больше не будет немедленно выдавать текущее значение, если не получено действительное значение CombinedLoadStates от PagingData . Это может произойти, если сборщик или прослушиватель запускается до отправки PagingData . ( I1a748 )

Версия 3.1.0-альфа03

21 июля 2021 г.

Выпущена androidx.paging:paging-*:3.1.0-alpha03 . Версия 3.1.0-alpha03 содержит следующие изменения.

Изменения API

  • Третий тип возвращаемого значения LoadResult — LoadResult.Invalid — добавлен в PagingSource. Когда PagingSource.load возвращает LoadResult.Invalid, пагинация отменяет загруженные данные и делает PagingSource недействительным. Этот тип возвращаемого значения предназначен для обработки потенциально недействительных или устаревших данных, которые могут быть возвращены из базы данных или сети.

    Например, если выполняется запись в базовую базу данных, но PagingSource не становится инвалидированным вовремя, он может возвращать несогласованные результаты, если его реализация зависит от неизменности исходного набора данных, из которого он загружается (например, реализации баз данных в стиле LIMIT OFFSET). В этом случае рекомендуется проверять данные на инвалидацию после загрузки и возвращать LoadResult.Invalid, что заставляет PagingSource отменять все ожидающие или будущие запросы на загрузку к этому PagingSource и делать его инвалидированным.

    Этот тип возвращаемых данных также поддерживается API Paging2, использующим LivePagedList или RxPagedList. При использовании PagingSource с API PagedList от Paging2, PagedList немедленно отсоединяется, что останавливает дальнейшие попытки загрузки данных в этот PagedList и приводит к аннулированию PagingSource.

    LoadResult — это запечатанный класс, что означает, что это изменение несовместимо с исходным кодом, поэтому в случаях, когда результаты PagingSource.load напрямую используются, необходимо обрабатывать LoadResult.Invalid во время компиляции. Например, пользователям Kotlin, использующим исчерпывающую проверку возвращаемого типа, придётся добавить проверку на недопустимый тип. ( Id6bd3 , b/191806126 , b/192013267 )

Исправления ошибок

  • Обратные вызовы для аннулирования, добавленные через PagingSource.registerInvalidatedCallback или DataSource.addInvalidatedCallback, теперь автоматически срабатывают, если они были зарегистрированы в PagingSource/DataSource, который уже был недействительным. Это устраняет состояние гонки, из-за которого Paging пропускал сигналы аннулирования и зависал при предоставлении Source, который уже был недействительным во время первоначальной загрузки. Кроме того, обратные вызовы для аннулирования теперь корректно удаляются после срабатывания, поскольку они гарантированно будут вызваны не более одного раза. ( I27e69 )
  • Отправка начального значения заполнителя (InitialPagedList) из вновь созданного потока PagedList, например, LivePagedListBuilder или RxPagedListBuilder, больше не будет очищать ранее загруженные данные.

Версия 3.1.0-альфа02

1 июля 2021 г.

Выпущена androidx.paging:paging-*:3.1.0-alpha02 . Версия 3.1.0-alpha02 содержит следующие коммиты.

Новые функции

  • Добавлены API-интерфейсы прослушивателя onPagesPresented и презентатора потока, которые срабатывают сразу после обновления представленных страниц в пользовательском интерфейсе.

    Поскольку эти обновления синхронны с пользовательским интерфейсом, вы можете вызывать методы адаптера, такие как .snapshot и .getItemCount, для проверки состояния после применения обновления. Обратите внимание, что метод .snapshot() был оставлен для явного вызова, поскольку его выполнение при каждом обновлении может быть ресурсоёмким.

    Обновления страниц могут происходить в следующих сценариях:

    • Первоначальная загрузка нового поколения PagingData завершается независимо от того, содержит ли новое поколение какие-либо изменения в представленных элементах, т. е. новое поколение, завершающее первоначальную загрузку без обновлений, поскольку список точно такой же, все равно вызовет этот обратный вызов.
    • Страница вставляется, даже если вставленная страница не содержит новых элементов.
    • Страница удаляется, даже если удаленная страница была пустой ( I272c9 , b/189999634 )

Исправления ошибок

  • Доступ к PagedList.dataSource из начального значения, созданного LivePagedList или RxPagedList, больше не будет приводить к ошибочному возникновению исключения IllegalStateException ( I96707 ).

Версия 3.1.0-альфа01

2 июня 2021 г.

Выпущена androidx.paging:paging-*:3.1.0-alpha01 . Версия 3.1.0-alpha01 содержит следующие изменения.

Изменения API

  • Классы, предоставляемые paging-rxjava3 теперь находятся в пакете androidx.paging.rxjava3 , чтобы не конфликтовать с paging-rxjava2 ( Ifa7f6 )

Исправления ошибок

  • Исправлена ошибка, из-за которой Paging иногда отправлял события no-op different в RecyclerView, что могло приводить к раннему срабатыванию некоторых прослушивателей. ( Ic507f , b/182510751 )

Внешний вклад

  • Добавлены устаревшие совместимые с PagedList API в артефакт rxjava3 ( Id1ce2 , b/182497591 ).

Пейджинговая версия Compose 1.0.0

Версия 1.0.0-альфа20

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-альфа19

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 обновил свою зависимость от составления 1,0,5 до сочинения 1.2.1. ( IB1918 , B/255283378 )

Версия 1.0.0-Alpha18

8 февраля 2023 г.

androidx.paging:paging-compose:1.0.0-alpha18 выпускается без изменений. Версия 1.0.0-Alpha18 содержит эти коммиты.

Версия 1.0.0-Alpha17

24 октября 2022 г.

androidx.paging:paging-compose:1.0.0-alpha17 выпускается. Версия 1.0.0-Alpha17 содержит эти коммиты.

Новые функции

  • Добавьте поддержку для пользовательского CoroutineContext при вызове collectLazyPagingItems . ( I7a574 , b/243182795 , b/233783862 )

Версия 1.0.0-Alpha16

10 августа 2022 г.

androidx.paging:paging-compose:1.0.0-alpha16 выпускается. Версия 1.0.0-Alpha16 содержит эти коммиты.

Новые функции

  • Paging теперь предоставляет журналы через класс LazyPagingItems для раскрытия отладки информации, собранной в PagingData.
  • Журналы могут быть включены через команду adb shell adb shell setprop log.tag.Paging [DEBUG|VERBOSE] . ([b/235527159} (https://issuetracker.google.com/issues/235527159)))

Исправления ошибок

  • Исправлено отсутствующая ошибка конструктора PagingDataDiffer при использовании paging-compose:1.0.0-alpha15 с paging-common:3.1.1 или старше. ( B/235256201 , b/239868768 )

Версия 1.0.0-Alpha15

1 июня 2022 г.

androidx.paging:paging-compose:1.0.0-alpha15 выпускается. Версия 1.0.0-Alpha15 содержит эти коммиты.

API меняется

  • Добавлены конструкторы для PagingDataAdapter и AsyncPagingDataDiffer , которые принимают CoroutineContext вместо CoroutineDispatcher . ( IDC878 )

Исправления ошибок

  • LazyPagingItems теперь устанавливает начальный loadState на LoadState.Loading Загрузка обновления. ( I55043 , b/2248555902 )

Версия 1.0.0-Alpha14

13 октября 2021 г.

androidx.paging:paging-compose:1.0.0-alpha14 выпускается. Версия 1.0.0-Alpha14 содержит эти коммиты.

Версия 1.0.0-Alpha13

29 сентября 2021 г.

androidx.paging:paging-compose:1.0.0-alpha13 выпускается. Версия 1.0.0-Alpha13 содержит эти коммиты.

API меняется

  • Функция LazyPagingItems.snapshot() была заменена на свойство LazyPagingItems.itemSnapshotList ( IE2DA8 )
  • Установлен LazyPagingItems.getAsState() был удален ( IE65E4 )

Версия 1.0.0-Alpha12

21 июля 2021 года

androidx.paging:paging-compose:1.0.0-alpha12 выпускается. Версия 1.0.0-Alpha12 содержит эти коммиты.

API меняется

  • items(lazyPagingItems) и itemsIndexed(lazyPagingItems) используемые для подключения подключения к LazyColumn/Row теперь принимают параметр опции, который позволяет вам указать стабильный ключ, представляющий элемент. Вы можете прочитать больше о ключах здесь. ( I7986d )
  • Функция lazyPagingItems.getAsState(index) теперь устарела. Вместо этого используйте lazyPagingItems[index] . ( I086CB , B/187339372 )

Версия 1.0.0-Альфа11

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 содержит эти коммиты.

Исправления ошибок

  • LazypagingItems 'Itemcount и Getter atemter теперь наблюдаются, что позволяет использовать его и с LazyverticalGrid ( IE2446 , B/171872064 , B/168285687 )

Составьте совместимость

  • androidx.paging:paging-compose:1.0.0-alpha09 совместим только с Compose Version 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 содержит эти коммиты.

Исправления ошибок

Обновлено, чтобы зависеть от сочинения 1.0.0-альфа11.

Версия 1.0.0-альфа05

13 января 2021 г.

androidx.paging:paging-compose:1.0.0-alpha05 выпускается. Версия 1.0.0-Alpha05 содержит эти коммиты.

Обновлено, чтобы зависеть от сочинения 1.0.0-альфа10.

Версия 1.0.0-альфа04

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-альфа03

2 декабря 2020 г.

androidx.paging:paging-compose:1.0.0-alpha03 выпускается. Версия 1.0.0-Alpha03 содержит эти коммиты.

  • Обновлено в соответствии с Compose 1.0.0-Alpha08.

Версия 1.0.0-Alpha02

11 ноября 2020 года

androidx.paging:paging-compose:1.0.0-alpha02 выпускается. Версия 1.0.0-Alpha02 содержит эти коммиты.

API меняется

  • Добавлено .peek() , .snapshot() , .retry() и .refresh() методы LazyPagingItem s, которые выявляют ту же функциональность, доступную в AsyncPagingDataDiffer / PagingDataAdapter ( IDDFE8 , B / 172041660 )

Версия 1.0.0-альфа01

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 больше не будет неправильно бросить незаконное статей ( I96707 )

Версия 3.0.0

Версия 3.0.0

5 мая 2021 г.

androidx.paging:paging-*:3.0.0 выпускается. Версия 3.0.0 содержит эти коммиты.

Основные особенности 3.0.0

Большинство существующих API от Paging 2.xx установилось в пользу новых API -интерфейсов Paging 3, чтобы принести следующие улучшения:

  • Первоклассная поддержка косяков и потока котлин
  • Поддержка отмены
  • Встроенное состояние нагрузки и сигналы ошибок
  • Повторная функциональность повторения + обновления
  • Все три подкласса данных были объединены в класс Unified Pagingsource
  • Пользовательские преобразования страниц, включая встроенный для добавления сепараторов
  • Загрузка заголовков и нижних колонтитулов

Версия 3.0.0-RC01

21 апреля 2021 г.

androidx.paging:paging-*:3.0.0-rc01 выпускается. Версия 3.0.0-RC01 содержит эти коммиты.

Исправления ошибок

  • Исправлена проблема, в которой пейджинг иногда отправляет неоперацию различных событий в переработку, что может привести к тому, что определенные слушатели запускают рано. ( IC507F , B/182510751 )

Версия 3.0.0-бета03

24 марта 2021 г.

androidx.paging:paging-*:3.0.0-beta03 выпускается. Версия 3.0.0-BETA03 содержит эти коммиты.

Исправления ошибок

  • Мы обновили, как заполнители обрабатываются, когда список перезагружается, чтобы предотвратить неожиданные скачки в переработке. См. Nullpaddeddiffing.md для деталей. ( IF1490 , B/170027529 , B/177338149 )
  • Различные строители PageDlist (старый путь совместимости) больше не неправильно синхронно вызовы DataSource.Factory.create() в основном потоке, когда называется .build() . ( б/182798948 )

Версия 3.0.0-бета02

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, могли предотвратить получение пейджинга снова, чтобы выполнить prefetchDistance , вызывая подкидка для «застрявшего».

Версия 3.0.0-бета01

10 февраля 2021 г.

androidx.paging:paging-*:3.0.0-beta01 выпускается. Версия 3.0.0-BETA01 содержит эти коммиты.

API меняется

  • Обертки RX2 и RX3 теперь подвергают экспериментальную аннотацию, от которой это зависит. Если вы используете обертки RX Compat в Paging-Rxjava2 или Paging-Rxjava3, теперь вам нужно будет аннотировать использование с помощью @OptIn(ExperimentalCoroutinesApi::class) ( ib1f9d )

Исправления ошибок

  • Фиксированное IndexOutOfBoundsException: Inconsistency detected , иногда выбрасываемая при использовании API DataSource через пути совместимости
  • Вызов isInvalid во время инициализации DataSource при использовании через пути совместимости теперь правильно запускается на FetchDispatcher, а не в основном потоке. Это исправляет IllegalStateException из -за доступа DB в основной потоке при использовании внедрения PagingSource .

Версия 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 )
  • Разрешить поведение конфигурации сепаратора терминала (заголовок / нижний колонтитул) с помощью дополнительного необязательного параметра сепаратипе. Два варианта:
    • FULLY_COMPLETE - существующее поведение; Подождите, пока как Pagingsource, так и отдаленного среднего, чтобы отметить эндофагинированную обработку перед добавлением терминальных сепараторов. Если дистанционная среда не используется, удаленное нагрузочное состояние игнорируется. Это в первую очередь полезно, если вы хотите отображать разделения раздела, когда раздел полностью загружен, включая извлечение из удаленного источника, например, сети.
    • SOURCE_COMPLETE - ждать только Pagingsource отметить эндофагинированную обработку, даже если используется дистанционная среда. Это позволяет синхронно представлять заголовки и нижние колонтитулы с начальной нагрузкой, которая не позволяет пользователям необходимо прокрутить прокрутку, чтобы увидеть терминальные сепараторы. ( 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 вместо жизненного цикла или Coroutinescope для пользователей Java. ( I97D81 , B/175332619 )
  • Позвольте абонентам Java -абонентам использовать операции преобразования PagingData асинхронным образом, приняв аргументов исполнителя в аргументы оператора преобразования. У всех операторов -синс -преобразования теперь есть суффикс -сиксус, а пользователи Kotlin Coroutine должны будут устроиться на устранение устранения диски, вызывая функцию расширения, которая вместо этого принимает приостановленный блок. Все операторы трансформации PagingData были перенесены на расширения в рамках статического класса PagingDatatransforms. Пользователи Java должны будут позвонить им через статические помощники, например, PagingDataTransforms.map(pagingData, transform) для пользователей Kotlin, синтаксис такой же, но вам нужно импортировать функцию. ( IF6885 , B/172895919 )

Исправления ошибок

  • Исправлена ошибка, в которой RemoteMediator.load() не будет вызван во время adapter.refresh() , если бы конец страниц уже был достигнут.

Версия 3.0.0-Alpha11

16 декабря 2020 г.

androidx.paging:paging-*:3.0.0-alpha11 . Версия 3.0.0-Alpha11 содержит эти коммиты.

Новые функции

  • Сохраненная поддержка состояния добавлена для следующих базовых вариантов использования (полная поддержка, особенно в сложном исходном случае, все еще находится в стадии разработки):
    • Поток кэшируется, а применение не убит (например, поток кэшируется в модели просмотра, а деятельность воссоздана в процессе)
    • Считается источник пейджинга, заполнители включены, а макет не ошеломлен.

API меняется

  • PagingSource.getRefreshKey() теперь стабильный API ( i22f6f , b/173530980 )
  • PagingSource.invalidate больше не является открытой функцией. Если вам нужно получить уведомление, когда происходит аннулирование, рассмотрите возможность вызова метода RegisterInvalidatedCallback вместо того, чтобы переоценить недействительную. ( I628D9 , B/173029013 , B/137971356 )
  • Pager теперь имеет единый экспериментальный конструктор наряду со своим обычным конструктором, а не протекает экспериментальные API в неэкспериментальный общественный API через аннотацию. ( I9dc61 , b/174531520 )
  • Обновлено удобные свойства, CombinedLoadStates.refresh , CombinedLoadStates.prepend , CombinedLoadStates.append для перехода только от Loading к NotLoading после того, как как медиатор, так и состояния исходной нагрузки NotLoading , чтобы гарантировать, что удаленное обновление было применено. ( I65619 )

  • LoadParAms.PadeSize был удален (он уже устарел). Рекомендация состоит в том, чтобы использовать LoadParams.loadSize в вашем PagingSource.

    LoadParams.loadSize всегда равен PagingConfig.pageSize , за исключением начального нагрузочного вызова, где он равен PagingConfig.initialLoadSize .

    Если вы тестируете свой дат данных Paging2 без использования пейджера или PageDlist, pageSize может не соответствовать PagingConfig.pageSize , если вы также устанавливаете initialLoadSize . Если это важно для ваших тестов, попробуйте вместо этого использовать пейджер/Pagedlist, который внутренне установит правильный размер страниц для ваших методов загрузки данных. ( I98AC7 , B/149157296 )

Исправления ошибок

  • Исправлена авария из -за нелегальной статовой эктриэкцепции при использовании сепараторов с набором PagingConfig.MaxSize. ( I0ed33 , b/174787528 )
  • Исправлена ошибка, в которой состояние загрузки для Prepend / Append не обновляется до NotLoading(endOfPaginationReached = true) сразу после начальной нагрузки, если был установлен удаленная лиц ( i8cf5a )
  • Исправлена ошибка, в которой API на стороне докладчика, такие как .snapshot (), .peek () и т. Д., Получили бы предыдущий (устаревший) список в обновлениях ListUpdateCallback.
  • Исправлена ошибка, в которой операторы разделителей не будут добавлять заголовки или нижние колонтитулы при использовании с удаленным средством.
  • Исправлена ошибка, в которой обновления Loadstate для NotLoading для удаленного среднего, застрявшего в состоянии загрузки
  • Исправлена ошибка, в которой API совместимости Paging2.0 .asPagingSourceFactory() может привести к инициализации DataSource о данных на основе неверного CoroutInedIspatcher. Это разрешает аварию и возможные случаи ANR, особенно при использовании текущей реализации Promation Pagingsource, которая использует этот путь совместимости.

Версия 3.0.0-Alpha10

2 декабря 2020 г.

androidx.paging:paging-*:3.0.0-alpha10 выпускается. Версия 3.0.0-Alpha10 содержит эти коммиты.

API меняется

  • Установленные API dataRefreshFlow и dataRefreshListener были удалены, так как они избыточно с обновлениями LoadStateFlow / Helloger. Для тех, кто мигрирует, эквивалент Loadstateflow - это:

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

    ( IB5570 , B/173530908 )

Исправления ошибок

  • EndofPaginationReached для REFRESH удаленного регистрации теперь правильно распространяется для Loadstate обновлений и предотвращает удаленное APPEND и PREPEND от запуска. ( I94a3f , b/155290248 )
  • Представление пустого списка либо из -за пустой начальной страницы, либо тяжелой фильтрации больше не помешает Paging от Paging PREPEND или APPEND нагрузки. ( I3e702 , b/168169730 )
  • Исправлена проблема, в которой getRefreshKey не обращается к последующим поколениям PagingSource, когда признаются признания недействительных. ( I45460 , B/170027530 )

Внешний вклад

  • Новый абстрактный класс InvalidatingPagingSourceFactory был добавлен с помощью API .invalidate() , который пересылает недействительную ко всем излучаемым он издает. Спасибо @claraf3 ! ( IE71FC , B/160716447 )

Известные проблемы

  • Заголовки и нижние колонтитулы из преобразования .InsertSeparators () могут не появиться сразу же при использовании удаленного регистрации B/172254056
  • Использование удаленного среднего может привести к тому, что удаленная 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 меняется

  • Полностью установите методы DataReshflow / слушателя с помощью пункта замены. ( I6e2dd )

Исправления ошибок

  • Исправлено для того, чтобы IllegalArgumentException бросает при использовании сепараторов с помощью дистанционногоедиатора, а недействительная запускается, в то время как удаленная нагрузка, которая будет возвращать Endofpagination, все еще работает ( i3a260 )

Версия 3.0.0-Alpha08

28 октября 2020 г.

androidx.paging:paging-*:3.0.0-alpha08 выпускается. Версия 3.0.0-Alpha08 содержит эти коммиты.

API меняется

  • Варианты Kotlin / Java of DataSource.InvalidatedCallback были объединены путем включения SAM-конверсии в Kotlin через функциональный интерфейс (доступный в Kotlin 1.4). Это также исправляет ошибку, в которой вариант Kotlin of Invalidate обратных вызовов не был вызван после преобразования .map или .mapByPage . ( I1F244 , B/165313046 )

Исправления ошибок

  • Взаимодействие Пейджинг с ViewPager значительно улучшилось. В частности, пейджинг больше не будет отменять RemoteMediator#load из -за недействительной страницы. Он также больше не будет делать запрос на загрузку приложения/приготовление загрузки, если требуется обновление , пока запрос обновления успешно не завершится. ( I6390B , B/162252536 )
  • Проверка API Lint для пропущенного detgetmatchingbuilder включена для Androidx ( i4bbea , b/138602561 )
  • Исправлена ошибка, где .withLoadState* Помощники ConcatAdapter сбой из -за уведомления переработки из фонового потока ( I18BB5 , B/170988309 )
  • Исправлена ошибка, при которой загрузка очень маленькой непустых страниц иногда предотвращает правильную предварительную фиксацию нагрузки. Iffda3 b/169259468

Версия 3.0.0-Alpha07

1 октября 2020 г.

androidx.paging:paging-*:3.0.0-alpha07 выпускается. Версия 3.0.0-Alpha07 содержит эти коммиты.

API меняется

  • Async PagingData Operators на основе гуавы теперь принимают исполнителя в качестве параметра, чтобы управлять контекстом выполнения. ( ID4372 )

Исправления ошибок

  • Исключение фиксированного индексаута, добавленное в удаленное медиатор из -за условия гонки. ( I00b7f , b/165821814 )
  • Исправлена условие гонки в конверсии данных о данных -> преобразование Pagingsource, которое может привести к тому, что результирующий Pagingsource игнорирует сигналы недействительной из DataSource.
  • Исправлена проблема в логике страниц, которая иногда приводит к тому, что она не сможет поднять новые поколения Pagingsource до тех пор, пока не будет вызван PagingDataAdapter.refresh ()
  • Исправлена проблема, которая иногда может привести к потере прокрутки при использовании данных, преобразованного в PagingSource (например, в комнате), в сочетании с дистанционным средством.

Внешний вклад

  • Спасибо @Simonschiller за добавление RXJAVA2, RXJAVA3 и асинхронных операторов Async на основе гуавы для PagingData!

Версия 3.0.0-Alpha06

2 сентября 2020 г.

androidx.paging:paging-*:3.0.0-alpha06 выпускается. Версия 3.0.0-Alpha06 содержит эти коммиты.

API меняется

  • UnsupportedOperationException с более четкими сообщениями об отсутствии поддержки стабильных идентификаторов теперь бросается всякий раз, когда называется PagingDataAdapter.setHasStableIds . ( IB3890 , B/158801427 )

Исправления ошибок

  • Вставки параметры больше не фильтруют пустые страницы, позволяющие уважать расстояние в предварительном расстоянии даже в тех случаях, когда вставлено много пустых страниц. ( I9cff6 , b/162538908 )

Версия 3.0.0-Alpha05

19 августа 2020 г.

androidx.paging:paging-*:3.0.0-alpha05 выпускается. Версия 3.0.0-Alpha05 содержит эти коммиты.

Исправления ошибок

  • Пейджинг теперь правильно предварительно выфетчатся страницами, даже когда представленные данные сильно отфильтрованы
  • Возвращение LoadResult.Error в повторную нагрузку больше не заставляет доступ к элементам.

Внешний вклад

  • Спасибо Clara F за помощь в очистке некоторых тестов! ( 549612 )

Версия 3.0.0-Alpha04

5 августа 2020 г.

androidx.paging:paging-*:3.0.0-alpha04 выпускается. Версия 3.0.0-Alpha04 содержит эти коммиты.

API меняется

  • Добавлен API peek() API в AsyncPagingDataDiffer и PagingDataAdapter , чтобы разрешить представленный доступ к данным без нагрузок страниц. ( I38898 , B/159104197 )
  • Добавлен API snapshot() в PagingDataAdapter и AsyncPagingDataDiffer , чтобы разрешить извлекать представленные элементы без запуска построения страниц. ( I566b6 , b/159104197 )
  • Добавлен конструктор PagingData.from(List<T>) , чтобы разрешить представлять статические списки, которые можно объединить с общим потоком PagingData, чтобы показать статические списки в определенных состояниях, например, перед начальным обновлением или просто для тестирования преобразований. ( ID134D )
  • Установите API DataResh Flow / Helliser API, так как они предназначались для выставки представленного состояния элементов на обновлении, но с улучшениями к срокам обратного вызова потока / слушателя и свойства Itemcount, оно избыточно ( IA19F3 )
  • Добавлены обертки совместимости Rxjava3 для PagingSource и RemoteMediator ( I49EF3 , B/161480176 )

Исправления ошибок

  • PositionalDataSource превратился в PagingSource через toPagingSourceFactory Helper, в том числе PagingSource , созданный комнатой, теперь правильно отмечает себя, чтобы поддержать прыжки. ( I3e84c , b/162161201 )
  • Исправлена ошибка, в которой использование синхронного варианта отправки, иногда приводит к гонке, вызывая 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 )
  • HID DataSource Kotlin Map варианты от Java, чтобы разрешить неоднозначность между оригинальными и котлинскими вариантами. ( If7b23 , b/161150011 )
  • Избыточные API, предназначенные в качестве удобств для пользователей Kotlin, были отмечены @jvmsynthetic ( i56ae5 )
  • Добавлены перегрузки для Constructor. Page, который по умолчанию по умолчанию.
  • Сделанные существующие операторы PagingData принимают приостановленные методы и представили новые операторы MapSync, Flatmapsync и Filtersync, не связанные с подвигами для пользователей Java. Существующие методы преобразования были перемещены на функции расширения, поэтому пользователям Kotlin теперь необходимо импортировать их. ( I34239 , B/159983232 )

Исправления ошибок

  • PagingSources в комнате (и Positionaldatasource) будет отображать ведущий сепаратор как часть первой страницы, поэтому пользователю не нужно прокручивать его, чтобы раскрыть его. ( I6f747 , b/160257628 )
  • Доступ к предметам на заполнителе теперь правильно запускает загрузки Pagingsource до тех пор, пока страница не будет возвращена, которая выполняет запрошенный индекс после преобразования с помощью PagingData.Filter () ( I95625 , B/158763195 )
  • Исправление для ошибки, где иногда прокрутка после возврата PagingSource Ошибка может помешать повторной попытке PagingDataAdapter.retry (). ( I1084f , b/160194384 )
  • Исправляет проблему, когда доступ к элементу после сброса страницы может не загружать страницы, хотя доступ к элементу находился в рамках предварительной добычи ( 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 )
  • Добавлены Rxjava и Guava APIS для отдаленного среднего класса - RxRemoTemediator и HellockableFuturerEmoTemediator
  • Добавлены помощники в Pagingstate для общего доступа к предметам, таким как isEmpty() и firstItemOrNull() ( i3b5b6 , b/158892717 )

Исправления ошибок

  • Пейджер теперь проверяет повторное использование PagingSource на заводе, чтобы предотвратить случайное повторное использование недействительных пигрингс -саунов, что дало неясную ошибку ( I99809 , B/158486430 )
  • Сбои от обновления с дистанционным средством больше не предотвращают загрузку PagingSource ( I38B1B , B/158892717 )
  • Версия отправки submitData , не связанная с SUSPODEND, больше не вызывает сбою из-за одновременной коллекции в нескольких PagingData при вызове после приостановленной версии submitData . ( I26358 , B/158048877 )
  • Исправлено фиксированное исключение "не может сбраться дважды из пейджера", которое может произойти после изменения конфигурации ( i58bcc , b/158784811 )

Версия 3.0.0-Alpha01

10 июня 2020 г.

androidx.paging:paging-*:3.0.0-alpha01 выпускается. Версия 3.0.0-Alpha01 содержит эти коммиты.

Библиотека Paging обновила 3,0, чтобы включить несколько крупных новых функций.

Новые функции 3.0

Известные проблемы

  • Paging 3 Javadocs еще не доступны. Тем временем, пожалуйста, используйте руководства, связанные выше, или документы Kotlin. ( B/158614050 )

Версия 2.1.2

Версия 2.1.2

18 марта 2020 года

androidx.paging:paging:2.1.2 выпускается. Версия 2.1.2 содержит эти коммиты против 2.1.0 .

Исправления ошибок

  • Исправлено для IndexOutOfBoundsException в редких случаях при преобразовании позиции во время недействительной.

Выпуск выпуска

  • Пейджинг версия 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 содержит эти коммиты .

Исправления ошибок

  • Сметные начальные нагрузки от PoseleAldatasources теперь сосредоточены на последнем доступе, когда заполнители отключены

Версия 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() в качестве альтернативы Kotlin для PagedList.Config.Builder
  • Добавлен androidx.paging.PagedList() в качестве альтернативы Kotlin для PagedList.Builder
  • Добавлен DataSourceFactory.toLiveData() в качестве альтернативы Kotlin для LivePagedListBuilder
  • Добавлен DataSourceFactory.toObservable() и toFlowable() в качестве альтернативы Kotlin для RxPagedListBuilder
  • Добавлен AsyncPagedListDiffer.addPagedListListener() для прослушивания, когда заменяется PagedList. B/111698609
  • Добавлен вариант PagedListAdapter.onCurrentListChanged() , который проходит старый и новый список, устаревший предыдущий вариант.
  • Добавлены варианты PagedListAdapter/AsyncPagedListDiffer.submitList() , которые проводят дополнительный обратный вызов, который триггеры, если/когда отображается 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
  • (Уже выпущенные в 1.0.1 ) Фиксированные сбои, в которых PagedListAdapter и AsyncPagedListDiffer не будут сигнализировать о событиях перемещения. B/110711937

Зависимости до антирода

Для последующих версий Preging Vaging включают эти зависимости:

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 1.0.0 . Пожалуйста, обновите свои проекты, чтобы использовать 1.0.0-rc1 и помогать нам сражаться с ним, чтобы мы могли отправить скалу Solid 1.0.0 .

В этом выпуске нет изменений, это то же самое, что 1.0.0-beta1 .

Версия 1.0.0-бета1

5 апреля 2018 года

Пейджинг будет в бета -версии в течение короткого времени, прежде чем выпустить кандидата. Мы не планируем дальнейшие изменения API для Paging 1.0 , а полоса для любых изменений API очень высока.

Поддержка Alpha Rxjava2 для пейджинга выпускается в виде отдельного необязательного модуля ( android.arch.paging:rxjava2:1.0.0-alpha1 ) и будет временно версировать отдельно до тех пор, пока не стабилизируется.

Эта новая библиотека предоставляет альтернативу Rxjava2 LivePagedListBuilder , способную построить Observable S и Flowable S, принимая Scheduler S вместо Executor S:

Котлин 

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

Ява 

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

Новые функции

  • RxPagedListBuilder добавляется через новый android.arch.paging:rxjava2 Artifact.

API меняется

  • API изменяется, чтобы прояснить роль исполнителей в строителях:

    • Переименованное setBackgroundThreadExecutor() в setFetchExecutor() (в PagedList.Builder и LivePagedListBuilder )

    • Переименован setMainThreadExecutor() в setNotifyExecutor() (в PagedList.Builder ).

  • Fixed PagedList.mCallbacks участник был частным.

Исправления ошибок

  • LivePagedListBuilder запускает первоначальную нагрузку PagedList на указанного исполнителя, а не в пул резьбы для ввода арх.

  • Фиксированное поведение недействительной во внутренних обертках DataSource (используется для реализации DataSource.map , а также загрузку PositionalDataSource с заполнителем) b/77237534

Версия 1.0.0-Alpha7

21 марта 2018 года

Paging 1.0.0-alpha7 выпускается вместе с жизненными циклами 1.1.1 . Поскольку Paging Alpha7 зависит от перемещения класса Function , упомянутого выше, вам нужно будет обновить свой lifecycle:runtime до android.arch.lifecycle:runtime:1.1.1 .

Paging alpha7 планируется стать окончательным выпуском, прежде чем Paging попадет в бета -версию.

API меняется

  • DataSource.LoadParams objects now have a public constructor and DataSource.LoadCallback objects are now abstract. This enables wrapping a DataSource or directly testing a DataSource with a mock callback. b/72600421
  • Mappers for DataSource and DataSource.Factory
    • map(Function<IN,OUT>) allows you to transform, wrap, or decorate results loaded by a DataSource .
    • mapByPage(<List<IN>,List<OUT>>) enables the same for batch processing (eg if items loaded from SQL need to additionally query a separate database, that can be done as a batch.)
  • PagedList#getDataSource() is added as a convenience method b/72611341
  • All deprecated classes have been removed from the API, including the remains of recyclerview.extensions package, and the LivePagedListProvider .
  • DataSource.Factory is changed from an interface to an abstract class to enable map functionality.

Исправления ошибок

  • Changed Builders to be final. b/70848565
  • Room DataSource implementation is now fixed to handle multi-table queries - this fix is contained within Room 1.1.0-beta1, see above.
  • Fixed a bug where BoundaryCallback.onItemAtEndLoaded would not be invoked for PositionalDataSource if placeholders are enabled and the total size is an exact multiple of the page size.

Version 1.0.0-alpha5

22 января 2018 г.

Исправления ошибок

  • Fix page loading when placeholders are disabled b/70573345
  • Additional logging for tracking down IllegalArgumentException bug b/70360195 (and speculative Room-side fix)
  • Javadoc sample code fixes b/70411933 , b/71467637