Страницы

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

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

Объект Основная версия Релиз-кандидат Бета-версия Альфа-версия
paging-* 3.5.3 - - 3.6.0-alpha01
paging-compose 3.5.3 - - 3.6.0-alpha01
Последнее обновление библиотеки: 18 ноября 2026 г.

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

Чтобы добавить зависимость от 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 для восстановления после ошибок загрузки при использовании asItemSnapshotListFlow API.

Версия 3.5.0-rc01

22 апреля 2026 г.

Данные "androidx.paging:paging-*:3.5.0-rc01" опубликованы. Версия 3.5.0-rc01 содержит эти коммиты.

Пользователь не внес никаких изменений

  • Значимых изменений по сравнению с версией 3.5.0-beta01 нет.

Версия 3.5.0-beta01

8 апреля 2026 г.

Данные "androidx.paging:paging-*:3.5.0-beta01" опубликованы. Версия 3.5.0-beta01 содержит эти коммиты.

Изменения в API

  • 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 также добавлены API Pager.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 для восстановления после ошибок загрузки при использовании API asState. Примеры использования новых 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.
  • Добавлен новый PagingState API closestItemAroundPosition для получения загруженного элемента, который находится ближе всего к целевой позиции и соответствует входному предикату. Это можно использовать для создания ключей обновления на основе элементов, когда идеальный закрепляемый элемент находится рядом с целевой позицией, но не точно в ней.

Версия 3.4.0-rc01

14 января 2026 г.

Данные "androidx.paging:paging-*:3.4.0-rc01" опубликованы. Версия 3.4.0-rc01 содержит эти коммиты.

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

Версия 3.4.0-beta01

17 декабря 2025 г.

Данные "androidx.paging:paging-*:3.4.0-beta01" опубликованы. Версия 3.4.0-beta01 содержит эти коммиты.

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

  • Исправлено состояние гонки между загрузками RecyclerView и Refresh, которое приводило к IndexOutOfBoundsException в RecyclerView. Прерывание обновления интерфейса из-за непрерывной загрузки Refresh может привести к рассинхронизации состояния разбиения на страницы с RecyclerView. Чтобы устранить эту проблему, при прерывании обновления (например, при последовательной загрузке Refresh) разбивка на страницы возвращается в состояние, которое было до обновления. (I771b0, b/409809768)

Версия 3.4.0-alpha04

10 сентября 2025 г.

Данные "androidx.paging:paging-*:3.4.0-alpha04" опубликованы. Версия 3.4.0-alpha04 содержит эти коммиты.

Изменения в API

  • Добавлен новый PagingState API closestItemAroundPosition для получения загруженного элемента, который находится ближе всего к целевой позиции и соответствует входному предикату. Это можно использовать для создания ключей обновления на основе элементов, когда идеальный закрепляемый элемент находится рядом с целевой позицией, но не точно в ней. (I96e5c, b/440187139)

Версия 3.4.0-alpha03

27 августа 2025 года

Данные "androidx.paging:paging-*:3.4.0-alpha03" опубликованы. Версия 3.4.0-alpha03 содержит эти коммиты.

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

  • В Paging-common добавлена поддержка десктопных платформ в качестве новой цели Kotlin Multiplatform (KMP). Теперь он поддерживает JVM (Android и ПК), 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

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

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

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

  • Модульные тесты 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 будет готов.

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

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

Совместимость с Kotlin Multiplatform

Теперь библиотека Paging поставляется с артефактами, совместимыми с Kotlin Multiplatform. Это стало возможным благодаря работе, проделанной в рамках проекта multiplatform-paging от CashApp.

  • В paging-common все API Paging 3 перенесены в common. Теперь они совместимы с JVM и iOS, а не только с Android.
  • Код paging-testing перенесен в common. Теперь он совместим не только с 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 используется аннотация @MainThread AndroidX для общего кода. (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).

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

Версия 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 для стандартных API items, которые уже существуют для LazyColumn, LazyVerticalGrid, а также их эквивалентов в API, таких как HorizontalPager.
    • items(lazyPagingItems) и itemsIndexed(lazyPagingItems), которые поддерживают только LazyListScope, больше не поддерживаются.
  • Новый артефакт paging-testing, который предоставляет API, предназначенные для модульного тестирования каждого уровня приложения и его интеграции с Paging в изоляции. Например:
    • TestPager, который позволяет проверить поведение вашей собственной реализации PagingSource независимо от Pager и реального пользовательского интерфейса.
    • ​​asPagingSourceFactory API для преобразования 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

Версия 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)

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

Версия 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 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-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 shell adb shell setprop log.tag.Paging [DEBUG|VERBOSE].(b/235527159).

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

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

Версия 3.2.0-alpha01

1 июня 2022 г.

Данные "androidx.paging:paging-*:3.2.0-alpha01" опубликованы. Версия 3.2.0-alpha01 содержит эти коммиты.

Изменения в API

  • Добавлены конструкторы для PagingDataAdapter и AsyncPagingDataDiffer, которые принимают CoroutineContext вместо CoroutineDispatcher. (Idc878)
  • По умолчанию правила PagingData.from() и PagingData.empty() больше не влияют на правило CombinedLoadStates на стороне докладчика. Добавлена новая перегрузка, которая позволяет передавать sourceLoadStates и remoteLoadStates в эти конструкторы, чтобы сохранить существующее поведение настройки LoadStates как полностью терминального (т.е. NotLoading(endOfPaginationReached = false)). При необходимости можно также включить удаленные штаты. Если LoadStates не передаются, то предыдущие CombinedLoadStates будут поддерживаться на стороне презентатора, когда он получит статический PagingData. (Ic3ce5, b/205344028)

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

  • Теперь результат PagingSource.getRefreshKey() правильно приоритезируется над initialKey в случаях, когда он возвращает null, но задано ненулевое значение initialKey. (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 и 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 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 для RemoteMediator REFRESH, но не для 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). Вот что это значит:

    1. Состояния посредника всегда будут заполняться, если вы используете RemoteMediator.
    2. Регистрация нового прослушивателя 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 shell adb shell setprop log.tag.Paging [DEBUG|VERBOSE]. ([b/235527159}(https://issuetracker.google.com/issues/235527159))

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

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

Версия 1.0.0-alpha15

1 июня 2022 г.

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

Изменения в API

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

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

  • Теперь LazyPagingItems задает начальное значение loadState для обновления LoadState.Loading. (I55043, b/224855902)

Версия 1.0.0-alpha14

13 октября 2021 г.

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

Версия 1.0.0-alpha13

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

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

Изменения в API

  • Функция LazyPagingItems.snapshot() заменена свойством LazyPagingItems.itemSnapshotList (Ie2da8).
  • Удален устаревший метод LazyPagingItems.getAsState() (Ie65e4).

Версия 1.0.0-alpha12

21 июля 2021 г.

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

Изменения в API

  • items(lazyPagingItems) и itemsIndexed(lazyPagingItems), используемые для подключения 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, которая иногда возникала при использовании API DataSource версии 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 }
    

    (Ib5570, b/173530908)

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

  • Теперь 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 добавлен API snapshot(), позволяющий получать представленные элементы без запуска извлечения страницы. (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

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

  • Документация 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.