Paging
La seguente tabella elenca tutti gli elementi nel gruppo androidx.paging.
| Artefatto | Release stabile | Candidato per la release | Release beta | Release alpha |
|---|---|---|---|---|
| paging-* | 3.5.3 | - | - | 3.6.0-alpha01 |
| paging-compose | 3.5.3 | - | - | 3.6.0-alpha01 |
Dichiara le dipendenze
Per aggiungere una dipendenza da Paging, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.
Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per
la tua app o il tuo modulo:
Trendy
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") }
Per informazioni sull'utilizzo delle estensioni Kotlin, consulta la documentazione di ktx.
Per saperne di più sulle dipendenze, consulta Aggiungi dipendenze di build.
Feedback
Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.
Per saperne di più, consulta la documentazione di Issue Tracker.
Versione 3.6
Versione 3.6.0-alpha01
18 novembre 2026
androidx.paging:paging-*:3.6.0-alpha01 è stato rilasciato. La versione 3.6.0-alpha01 contiene questi commit.
Modifiche alle API
- Aggiunte
ItemSnapshotListestensioni per Lazy foundations. Ora puoi chiamareItemSnapshotList#itemKeyeItemSnapshotList#itemContentTypeper generare automaticamenteitemKeyecontentTypeper Lazy Foundation. (I73455, b/560754841)
Contributo esterno
- Grazie Kamal per aver aggiunto le estensioni
ItemSnapshotList.
Versione 3.5
Versione 3.5.3
12 ottobre 2026
androidx.paging:paging-*:3.5.3 è stato rilasciato. La versione 3.5.3 contiene questi commit.
Correzioni di bug
ItemSnapshotListFlownon genererà piùIllegalArgumentExceptionquando unRemoteMediatorha raggiunto la fine della paginazione in entrambe le direzioni e un'intestazione o un piè di pagina viene convertito in un separatore terminale. (I821c7, b/566336825)- Quando le pagine caricate superano
PagingConfig.maxSize, non scenderanno al di sotto di due pagine per garantire che l'area visibile sia compilata correttamente con i dati. (I037a0, b/565835910)
Contributo esterno
Grazie a Igor per aver inviato la correzione di bug b/565835910
Versione 3.5.2
7 ottobre 2026
androidx.paging:paging-*:3.5.2 è stato rilasciato. La versione 3.5.2 contiene questi commit.
Correzioni di bug
- Le chiamate
Pager.append()prima del completamento dell'aggiornamento iniziale non genereranno piùNoSuchElementException. La chiamata di aggiunta non verrà eseguita. (Ide387, b/556780796)
Versione 3.5.1
12 agosto 2026
androidx.paging:paging-*:3.5.1 è stato rilasciato. La versione 3.5.1 contiene questi commit.
Correzioni di bug
- Risolto il problema per cui
PagingSource.getRefreshKeyforniva unanchorPositionerrato troppo grande durante l'aggiornamento di una pagina con separatori durante lo scorrimento nei segnaposto. (I475f0, b/516565503)
Versione 3.5.0
6 maggio 2026
androidx.paging:paging-*:3.5.0 è stato rilasciato. La versione 3.5.0 contiene questi commit.
Modifiche importanti rispetto alla versione 3.4.0:
È stato aggiunto l'operatore
Flow<PagingData>.asItemSnapshotListFlowper convertireFlow<PagingData>inFlow<ItemSnapshotList>. Ciò significa che ora è possibile accedere ai dati caricati al di fuori del livello UI, il che ti consente di combinareFlow<ItemSnapshotList>con altre origini dati, memorizzare nella cache e modificare i dati impaginati localmente o esporre i dati impaginati come parte di uno stato UI e altro ancora.Sono state aggiunte le funzioni di estensione
Pager.appendePager.prependper caricare manualmente più dati senza scorrere.Sono state aggiunte le funzioni di estensione
Pager.refreshePaging.retryper il recupero dagli errori di caricamento quando si utilizza l'APIasItemSnapshotListFlow.
Versione 3.5.0-rc01
22 aprile 2026
androidx.paging:paging-*:3.5.0-rc01 è stato rilasciato. La versione 3.5.0-rc01 contiene questi commit.
Nessuna modifica
- Non sono presenti modifiche significative rispetto alla versione
3.5.0-beta01.
Versione 3.5.0-beta01
8 aprile 2026
androidx.paging:paging-*:3.5.0-beta01 è stato rilasciato. La versione 3.5.0-beta01 contiene questi commit.
Modifiche alle API
- L'API
Flow<PagingData>.asStateè stata rinominata inFlow<PagingData>.asItemSnapshotListFlow(I0dc11, b/496548025)
Versione 3.5.0-alpha01
11 marzo 2026
androidx.paging:paging-*:3.5.0-alpha01 è stato rilasciato. La versione 3.5.0-alpha01 contiene questi commit.
Nuove funzionalità
L'artefatto
paging-commonora contiene un nuovo operatore di flussoasStatesuFlow<PagingData>per convertirlo in unFlow<ItemSnapshotList>. In questo modo, sblocchi funzionalità come:- combinare il flusso di
ItemSnapshotListcon altre origini dati - condividere il flusso con più raccoglitori senza
cachedIn - memorizzare nella cache i dati impaginati localmente
- modificare i dati impaginati in memoria
- esporre i dati impaginati come parte di uno stato della UI
// In your ViewModel val pager = Pager(pagingConfig, pagingSourceFactory) val pagerFlow = pager.flow.asState() // alterantively convert the flow to a SharedFlow val pagerFlow = pager.flow.asState().stateIn() // In presenter layer val snapshotFlow = viewModel.pagerFlow.collectAsStateWithLifecycle(initialList) val snapshot = itemsFlow.value LazyColumn { items(items = snapshot.items) { ... } }- combinare il flusso di
L'artefatto
paging-commonha anche aggiunto le APIPager.appendePager.prependper attivare manualmente i caricamenti su entrambi i lati degli elementi caricati.- Se utilizzato con
paging-runtimeopaging-compose, fornisce un'alternativa per caricare più dati oltre allo scorrimento - Se utilizzata con la nuova API
asState, è l'unico modo per caricare più dati
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() } } }- Se utilizzato con
Sono stati aggiunti
Pager.refreshePager.retryper risolvere gli errori di caricamento quando si utilizza l'APIasState. Consulta questo documento per altri esempi di utilizzo delle nuove API. (I1e1e9, If3c87, Idbd48, Id1e1d, I816fe)
Versione 3.4
Versione 3.4.2
11 marzo 2026
androidx.paging:paging-*:3.4.2 è stato rilasciato. La versione 3.4.2 contiene questi commit.
Nessuna modifica
- Questa release non presenta modifiche alle API o al comportamento rispetto alla versione 3.4.1.
Versione 3.4.1
11 febbraio 2026
androidx.paging:paging-*:3.4.1 è stato rilasciato. La versione 3.4.1 contiene questi commit.
Aggiornamento delle dipendenze
- È stata aggiornata la dipendenza guava di paging-guava dalla versione 31.1 alla versione 32.0.1.
Versione 3.4.0
28 gennaio 2026
androidx.paging:paging-*:3.4.0 è stato rilasciato. La versione 3.4.0 contiene questi commit.
Modifiche importanti rispetto alla versione 3.3.0:
- Sono stati aggiunti altri target KMP a
paging-common,paging-testingepaging-compose. In totale, ora supportano tutti JVM (Android e computer), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) e Web (JavaScript, WasmJS) paging-common,paging-testingepaging-composehanno rimosso il supporto dimacosX64,iosX64,watchosX64etvosX64per allinearsi al ritiro dei target macosX64 da parte di Jetbrains.- È stata aggiunta una nuova API
PagingStateclosestItemAroundPositionper recuperare l'elemento caricato più vicino alla posizione target e corrispondente al predicato di input. Questo può essere utilizzato per generare chiavi di aggiornamento basate sugli elementi in cui l'elemento ancorabile ideale si trova vicino, ma non nella posizione target esatta.
Versione 3.4.0-rc01
14 gennaio 2026
androidx.paging:paging-*:3.4.0-rc01 è stato rilasciato. La versione 3.4.0-rc01 contiene questi commit.
Nuove funzionalità
- È stato rimosso il supporto per le seguenti piattaforme KMP:
macosX64,iosX64,watchosX64etvosX64per l'allineamento con il ritiro dei target macosX64 da parte di Jetbrains. (7cb9a4)
Versione 3.4.0-beta01
17 dicembre 2025
androidx.paging:paging-*:3.4.0-beta01 è stato rilasciato. La versione 3.4.0-beta01 contiene questi commit.
Correzioni di bug
- Risolto il problema di race condition tra i caricamenti di
RecyclerVieweRefreshche causavaIndexOutOfBoundsExceptioninRecyclerView. Gli aggiornamenti della UI interrotti a causa di caricamenti continui diRefreshpossono causare la desincronizzazione dello stato di Paging conRecyclerView. Questo problema viene risolto ripristinando lo stato di impaginazione precedente all'aggiornamento se un aggiornamento viene interrotto (ad es. da un caricamentoRefreshconsecutivo). (I771b0, b/409809768)
Versione 3.4.0-alpha04
10 settembre 2025
androidx.paging:paging-*:3.4.0-alpha04 è stato rilasciato. La versione 3.4.0-alpha04 contiene questi commit.
Modifiche alle API
- È stata aggiunta una nuova API
PagingStateclosestItemAroundPositionper recuperare l'elemento caricato più vicino alla posizione target e corrispondente al predicato di input. Questo può essere utilizzato per generare chiavi di aggiornamento basate sugli elementi in cui l'elemento ancorabile ideale si trova vicino, ma non nella posizione target esatta. (I96e5c, b/440187139)
Versione 3.4.0-alpha03
27 agosto 2025
androidx.paging:paging-*:3.4.0-alpha03 è stato rilasciato. La versione 3.4.0-alpha03 contiene questi commit.
Nuove funzionalità
- Paging-common ha aggiunto il desktop come nuovo target Kotlin Multiplatform (KMP). In totale, ora supporta JVM (Android e computer), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) e Web (JavaScript, WasmJS). (Id2483, b/436884811)
- Paging-testing ha aggiunto nuovi target Kotlin Multiplatform (KMP). In totale, ora supporta JVM (Android e computer), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) e Web (JavaScript, WasmJS). (I0c543, b/435014650)
- Paging-compose ha aggiunto nuovi target Kotlin Multiplatform (KMP). In totale, ora supporta JVM (Android e computer), Native (Linux, iOS, watchOS, tvOS, macOS, MinGW) e Web (JavaScript, WasmJS). (I70d44, b/436884801)
Modifiche alle API
- Spostamento del valore minSdk predefinito dall'API 21 all'API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)
Versione 3.4.0-alpha02
30 luglio 2025
androidx.paging:paging-*:3.4.0-alpha02 è stato rilasciato. La versione 3.4.0-alpha02 contiene questi commit.
Modifiche alle API
PagingData.fromora consente di impostareplaceholdersBeforeeplaceholdersAfter. Tieni presente che lo scorrimento di questi segnaposto non attiva i caricamenti. (I06983)
Versione 3.4.0-alpha01
2 luglio 2025
androidx.paging:paging-*:3.4.0-alpha01 è stato rilasciato. La versione 3.4.0-alpha01 contiene questi commit.
Nuove funzionalità
- Paging ha aggiunto i seguenti target KMP: watchos, tvos, mingwX64, watchosDeviceArm64 e linuxArm64. (I237dd, Ia62b3, b/368046982, Icf15d, b/364652024, I139d3, b/338268719)
Correzioni di bug
- I test delle unità Android che utilizzano Paging 3.3 o versioni successive non genereranno più errori da
PagingLogger(Ia9400, b/331684448) - È stato corretto un bug per cui
RecyclerViewgeneraIndexOutOfBoundsExceptionquando l'utente scorre durante l'aggiornamento diRecyclerView(Id1f16, b/381024738) - È stato corretto un bug per cui l'impaginazione non riusciva ad attivare altri caricamenti durante l'aggiornamento durante lo scorrimento. (I60ca5, b/352586078)
- Risolto un arresto anomalo durante lo scorrimento durante l'aggiornamento degli elementi di impaginazione. (I8c65a, b/347649763)
Versione 3.3
Versione 3.3.6
12 febbraio 2025
androidx.paging:paging-*:3.3.6 è stato rilasciato. La versione 3.3.6 contiene questi commit.
Correzioni di bug
- I segnali di aggiornamento e di nuovo tentativo inviati durante un aggiornamento iniziale verranno ora memorizzati e inviati di nuovo automaticamente non appena il presentatore di Paging sarà pronto.
Contributo esterno
Versione 3.3.5
11 dicembre 2024
androidx.paging:paging-*:3.3.5 è stato rilasciato. La versione 3.3.5 contiene questi commit.
Correzioni di bug
- È stato corretto un bug per cui
RecyclerViewgeneraIndexOutOfBoundsExceptionquando l'utente scorre durante l'aggiornamento diRecyclerView. (Id1f16, b/381024738)
Versione 3.3.4
13 novembre 2024
androidx.paging:paging-*:3.3.4 è stato rilasciato. La versione 3.3.4 contiene questi commit.
Correzioni di bug
- I test delle unità Android che utilizzano Paging 3.3 o versioni successive non genereranno più un errore come
Method isLoggable in android.util.Log not mocked. (Ia9400, b/331684448)
Versione 3.3.2
7 agosto 2024
androidx.paging:paging-*:3.3.2 è stato rilasciato. La versione 3.3.2 contiene questi commit.
Nuove funzionalità
paging-commonepaging-testinghanno aggiunto nuove destinazioni Kotlin-Multiplatform:watchos,tvoselinuxArm64(90c9768), (53e0eca)
Versione 3.3.1
24 luglio 2024
androidx.paging:paging-*:3.3.1 è stato rilasciato. La versione 3.3.1 contiene questi commit.
Correzioni di bug
- Risolto un problema per cui
AsyncPagingDataDiffero le API basate su di essa, comePagingDataAdapterutilizzata conRecyclerView, non erano in grado di attivare altri caricamenti quando l'origine dati di supporto veniva aggiornata durante lo scorrimento. (I60ca5, b/352586078) - Risolto un arresto anomalo che si verifica quando gli elementi vengono rimossi dall'origine dati di supporto durante lo scorrimento di un
RecyclerViewutilizzando unPagingDataAdaptero unAsyncPagingDataDiffer. (I8c65a, b/347649763)
Versione 3.3.0
14 maggio 2024
androidx.paging:paging-*:3.3.0 è stato rilasciato. La versione 3.3.0 contiene questi commit.
Modifiche importanti dalla versione 3.2.0
PagingDataPresenterè ora un corso pubblico. I presenter multipiattaforma ora possono essere creati suPagingDataPresenteranziché richiedere API di paging interne oAsyncPagingDataDifferdipaging-runtime.- Sono stati aggiunti i nuovi metodi helper
LoadStateseCombinedLoadStatesinhasErroreisIdleper verificare seLoadStatesè rispettivamente in stato di errore oNotLoading. È stato inoltre aggiunto un nuovo metodo di estensione KotlinawaitNotLoading()suFlow<CombinedLoadStates>che attende che un caricamento si stabilizzi nello statoNotLoadingo di errore. PagingData.empty()ora invia gli statiNotLoadingper impostazione predefinita, a meno che non vengano passatiLoadStatespersonalizzati al suo costruttore. Questo comportamento si discosta da quello esistente, in cui non viene inviatoLoadStatesquando viene inviato a unPagingDataAdaptero vengono inviati stati di caricamento quando viene raccolto comeLazyPagingItems. Quando viene raccolto comeLazyPagingItems, ora mostrerà anche un elenco vuoto immediatamente dopo la composizione iniziale.
Compatibilità con Kotlin Multiplatform
Paging ora include artefatti compatibili con Kotlin Multiplatform, in gran parte grazie al lavoro di upstream del progetto multiplatform-paging di CashApp.
paging-commonha spostato tutte le API Paging 3 incommone ora è compatibile con JVM e iOS, oltre che con Android.paging-testingha spostato il suo codice incommone ora è compatibile con JVM e iOS, oltre che con Android.paging-composeha spostato il suo codice incommone fornisce un artefatto Android, che corrisponde al supporto multipiattaforma diandroidx.compose.paging-runtime,paging-guava,paging-rxjava2epaging-rxjava3rimarranno disponibili solo su Android.
Versione 3.3.0-rc01
1° maggio 2024
androidx.paging:paging-*:3.3.0-rc01 viene rilasciata senza modifiche in Paging 3.3.0-beta01. La versione 3.3.0-rc01 contiene questi commit.
Versione 3.3.0-beta01
3 aprile 2024
androidx.paging:paging-*:3.3.0-beta01 viene rilasciato senza modifiche significative. La versione 3.3.0-beta01 contiene questi commit.
Versione 3.3.0-alpha05
20 marzo 2024
androidx.paging:paging-*:3.3.0-alpha05 è stato rilasciato. La versione 3.3.0-alpha05 contiene questi commit.
Modifiche alle API
- Paging ora utilizza l'annotazione
@MainThreaddi AndroidX Annotation per il codice comune. (I78f0d, b/327682438)
Versione 3.3.0-alpha04
6 marzo 2024
androidx.paging:paging-*:3.3.0-alpha04 è stato rilasciato. La versione 3.3.0-alpha04 contiene questi commit.
Correzioni di bug
- Sono stati corretti errori di documentazione minori relativi all'aggiunta della compatibilità multipiattaforma di Kotlin. (aosp/2950785)
Versione 3.3.0-alpha03
7 febbraio 2024
androidx.paging:paging-*:3.3.0-alpha03 è stato rilasciato. La versione 3.3.0-alpha03 contiene questi commit.
Nuove funzionalità
PagingDataPresenterè ora un corso pubblico. I presenter multipiattaforma ora possono essere creati suPagingDataPresenteranziché richiedere API di paging interne oAsyncPagingDataDifferdipaging-runtime. (Id1f74, b/315214786)- Sono stati aggiunti i nuovi metodi helper
LoadStateseCombinedLoadStatesper verificare seLoadStatesè in stato di errore oNotLoading. È stata inoltre aggiunta una nuova API che attende su unLoadStateFlowfinché un caricamento non si stabilizza in uno statoNotLoadingo di errore. (Id6c67)
Cambiamento del comportamento
PagingData.empty()ora invia gli statiNotLoadingper impostazione predefinita, a meno che non vengano passatiLoadStatespersonalizzati al suo costruttore. Questo comportamento si discosta da quello esistente, in cui non viene inviatoLoadStatesquando viene inviato a unPagingDataAdaptero vengono inviati stati di caricamento quando viene raccolto comeLazyPagingItems. Quando viene raccolto comeLazyPagingItems, ora mostrerà anche un elenco vuoto immediatamente dopo la composizione iniziale. (I4d11d, b/301833847)
Versione 3.3.0-alpha02
20 settembre 2023
androidx.paging:paging-*:3.3.0-alpha02 è stato rilasciato. La versione 3.3.0-alpha02 contiene questi commit.
Compatibilità con Kotlin Multiplatform
Paging ora include artefatti compatibili con Kotlin Multiplatform, in gran parte grazie al lavoro di upstream del progetto multiplatform-paging di CashApp. In questo modo, eviteremo la divergenza tra i due repository e li manterremo compatibili.
paging-commonha spostato tutte le API Paging 3 incommone ora è compatibile con JVM e iOS, oltre che con Android.paging-testingha spostato il suo codice incommone ora è compatibile con JVM e iOS, oltre che con Android.paging-composeha spostato il suo codice incommone fornisce un artefatto Android, che corrisponde al supporto multipiattaforma diandroidx.compose.paging-runtime,paging-guava,paging-rxjava2epaging-rxjava3rimarranno disponibili solo su Android.
Modifiche alle API
- L'interfaccia Logger pubblica destinata solo all'utilizzo interno è stata ritirata (I16e95, b/288623117)
Contributo esterno
- Grazie a veyndan di Cash App per aver contribuito a spostare Paging in Kotlin Multiplatform (#560, #561, #562, #573, #576, #577, #578, #579, #580, #581, #583, #584, #586, #609)
Versione 3.3.0-alpha01
20 settembre 2023
- Questa è la prima release multipiattaforma delle librerie androidx.paging. Questa versione contiene solo artefatti
*-jvme*-android. Per le varianti di macOS, iOS e Linux, utilizza3.3.0-alpha02.
Versione 3.2
Versione 3.2.1
6 settembre 2023
androidx.paging:paging-*:3.2.1 è stato rilasciato. La versione 3.2.1 contiene questi commit.
Correzioni di bug
- È stato risolto un problema per cui l'API
asSnapshot()dell'artefatto Paging Testing si bloccava quando veniva passato un Flow creato utilizzandoPagingData.from(List), poichéasSnapshot()non aveva informazioni su quando il caricamento era terminato (a differenza dell'overload diPagingData.from(List, LoadStates)). Questa soluzione alternativa funziona solo per i flussi completabili (ad es. unflowOf(PagingData.from(...))). Per i flussi non completabili (ad es.MutableStateFlow), utilizza l'overloadPagingData.fromche fornisceLoadStates. (I502c3) - Paging Compose ora utilizza internamente
AndroidUiDispatcher.Mainper garantire che i nuovi dati siano disponibili nello stesso frame al termine del caricamento. (Ia55af)
Versione 3.2.0
26 luglio 2023
androidx.paging:paging-*:3.2.0 è stato rilasciato. La versione 3.2.0 contiene questi commit.
Modifiche importanti dalla versione 3.1.0
- Paging Compose ha raggiunto la stabilità dell'API ed è stato unito al resto di Paging, dove la sua versione ora corrisponde a tutti gli altri elementi di Paging. Le modifiche rispetto alla versione 3.1.0 includono:
- Supporto per l'anteprima di un elenco di dati fittizi creando un
PagingData.from(fakeData)e inserendoPagingDatain unMutableStateFlow(ad es.MutableStateFlow(PagingData.from(listOf(1, 2, 3)))). Passa questo flusso ai componibili@Previewcome ricevitore per l'anteprima dicollectAsLazyPagingItems(). - Supporto per tutti i layout lazy come
LazyVerticalGrideHorizontalPager, nonché per i componenti lazy personalizzati delle librerie Wear e TV. Questo è stato possibile grazie ai nuovi metodi di estensioneLazyPagingItemsdi livello inferioreitemKeyeitemContentType, che ti aiutano a implementare i parametrikeyecontentTypenelle APIitemsstandard già esistenti perLazyColumn,LazyVerticalGride i loro equivalenti in API comeHorizontalPager. items(lazyPagingItems)eitemsIndexed(lazyPagingItems), che supportano soloLazyListScope, sono stati ritirati.
- Supporto per l'anteprima di un elenco di dati fittizi creando un
- Nuovo artefatto
paging-testingche fornisce API progettate per i test delle unità di ogni livello dell'app e la sua integrazione con Paging in modo isolato. Ad esempio, include:- Classe
TestPagerche ti consente di convalidare il comportamento della tua implementazionePagingSourcepersonalizzata indipendentemente dal pager e dalla UI reale. - API
asPagingSourceFactoryper trasformare unFlow<List<Value>>o unList<Value>statico in unPagingSourceFactoryche può essere passato a un pager nei test - Estensione Kotlin
asSnapshotsuFlow<PagingData<Value>>, che traduceFlow<PagingData<Value>>in unList<Value>diretto.asSnapshot lambdati consente di simulare la UI della tua app tramite API comescrollTooappendScrollWhilein modo da poter verificare che l'istantanea dei dati sia corretta in qualsiasi punto del set di dati impaginati.
- Classe
- Sono stati aggiunti log predefiniti per esporre le informazioni di debug di Paging in due livelli:
VERBOSEeDEBUG. I log possono essere abilitati tramite il comandoadb shell setprop log.tag.Paging [DEBUG|VERBOSE]. Questo vale sia per Paging con visualizzazioni sia per Paging con Compose. - Sono stati aggiunti costruttori per
PagingDataAdaptereAsyncPagingDataDifferche accettanoCoroutineContextanzichéCoroutineDispatcher. - È stata aggiunta una nuova interfaccia funzionale
PagingSourceFactoryche fornisce una superficie API più esplicita rispetto alle precedenti lambda () ->PagingSource. Questa factory può essere utilizzata per creare un'istanza di un pager.
Versione 3.2.0-rc01
21 giu 2023
androidx.paging:paging-*:3.2.0-rc01 è stato rilasciato. La versione 3.2.0-rc01 contiene questi commit.
Contributo esterno
- Grazie a Veyndan per aver contribuito ad allontanare Paging dalle specifiche di Android/JVM. (#553, #554, #555, #559)
Versione 3.2.0-beta01
7 giugno 2023
androidx.paging:paging-*:3.2.0-beta01 è stato rilasciato. La versione 3.2.0-beta01 contiene questi commit.
Paging Compose
- Paging Compose ha ufficialmente raggiunto la stabilità dell'API. Pertanto, la versione è stata aggiornata da
1.0.0-alpha20in modo che corrisponda alla versione di tutti gli altri artefatti di Paging.
Modifiche alle API
- Sono state rimosse le API
items(LazyPagingItems)eitemsIndexed(LazyPagingItems)deprecate da Paging Compose. Consulta le note di rilascio di Paging Compose1.0.0-alpha20per un esempio delle API sostitutive. (I9626e)
Versione 3.2.0-alpha06
24 maggio 2023
androidx.paging:paging-*:3.2.0-alpha06 è stato rilasciato. La versione 3.2.0-alpha06 contiene questi commit.
Nuove funzionalità
- È stata aggiunta una nuova interfaccia funzionale
PagingSourceFactoryche fornisce una superficie API più esplicita rispetto alle lambda() -> PagingSourceesistenti. Questa factory può essere utilizzata per creare un'istanza di unPager. (I33165, b/280655188) - È stata aggiunta una nuova API
paging-testingdiList<Value>.asPagingSourceFactory()per ottenere unPagingSourceFactoryche viene caricato solo da un elenco immutabile di dati. L'estensione esistente suFlow<List<Value>>deve essere ancora utilizzata per i test con più generazioni di dati statici. (Id34d1, b/280655188)
Modifiche alle API
- Tutte le API pubbliche in paging-testing sono ora annotate con
@VisibleForTestingper garantire che vengano utilizzate solo nei test. (I7db6e) - L'API
asSnapshotnon richiede più il passaggio di unCoroutineScope. Ora, per impostazione predefinita, utilizza il contesto ereditato dall'ambito principale. (Id0a78, b/282240990) - I parametri del costruttore
TestPagersono stati riordinati per corrispondere in modo intuitivo all'ordine dei parametri del costruttorePagerreali (I6185a) - È stato eseguito il passaggio dell'utilizzo del tipo lambda
() -> PagingSource<Key, Value>da parte di paging-testing al tipoPagingSourceFactory<Key, Value>. (I4a950, b/280655188)
Modifiche del comportamento
- Il dispatcher principale non è più necessario per eseguire i test di paging di
asSnapshot. L'impostazione non apporta più modifiche al comportamento del test. (Ie56ea)
Versione 3.2.0-alpha05
3 maggio 2023
androidx.paging:paging-*:3.2.0-alpha05 è stato rilasciato. La versione 3.2.0-alpha05 contiene questi commit.
Modifiche alle API
- L'API Paging Testing di
asSnapshotora imposta il parametroloadOperationssu un'espressione lambda vuota per impostazione predefinita. In questo modo, puoi chiamareasSnapshotsenza passare operazioni di caricamento per recuperare i dati dal caricamento di aggiornamento iniziale. (Ied354, b/277233770)
Miglioramenti alla documentazione
- È stata aggiornata la documentazione su
asPagingSourceFactory()per chiarire che si tratta di un metodo di estensione su unFlowche restituisce una factory riutilizzabile per generare istanzePagingSource. (I5ff4f, I705b5) - È stata aggiornata la documentazione sul costruttore
LoadResult.Pageper chiarire la necessità di eseguire l'override diitemsBeforeeitemsAfterper supportare il salto. (Ied354)
Contributi esterni
- Grazie a Veyndan per aver contribuito ad allontanare Paging dalle specifiche di Android/JVM. (#525, #523, #520, #519, #507, #506, #505, #499, #497, #496, #493)
Versione 3.2.0-alpha04
8 febbraio 2023
androidx.paging:paging-*:3.2.0-alpha04 è stato rilasciato. La versione 3.2.0-alpha04 contiene questi commit.
Test di paging
- L'artefatto
paging-testingora contiene un metodoasPagingSourceFactoryper creare unpagingSourceFactoryda unFlow<List<Value>>da fornire a un pager. OgniList<Value>>emesso dal flusso rappresenta una generazione di dati impaginati. In questo modo, è più facile eseguire test di paginazione, ad esempio, suPagingDatatrasformazioni simulando un'origine dati da cui il pager può raccogliere i dati. (I6f230, b/235528239) L'artefatto
paging-testingè stato ampliato con nuove API adatte a verificare che i dati contenuti in unFlow<PagingData<T>>siano corretti. Questo può essere utilizzato, ad esempio, per confermare l'output di unFlow<PagingData<T>>dal livello ViewModel.Questo avviene tramite l'estensione Kotlin
asSnapshotsuFlow<PagingData<Value>>, che traduceFlow<PagingData<Value>>in unList<Value>diretto. La funzione lambdaasSnapshotti consente di simulare la UI della tua app tramite API comescrollTooappendScrollWhilein modo ripetibile e coerente, così puoi verificare che lo snapshot dei dati sia corretto in qualsiasi punto del set di dati impaginati.// Create your ViewModel instance val viewModel = … // Get the Flow of PagingData from the ViewModel val data< Flow<PagingData<String>> = viewModel.data val snapshot: List<String> = data.asSnapshot { // Each operation inside the lambda waits for the data to settle before continuing scrollTo(index = 50) // While you can’t view the items within the asSnapshot call, // you can continuously scroll in a direction while some condition is true // i.e., in this case until you hit a placeholder item appendScrollWhile { item: String -> item != “Header 1” } } // With the asSnapshot complete, you can now verify that the snapshot // has the expected valuesasSnapshotè un metodosuspendche dovrebbe essere eseguito all'interno dirunTest. Per saperne di più, consulta Test delle coroutine Kotlin su Android. (I55fd2, I5bd26, I7ce34, I51f4d, I2249f, Id6223, Ic4bab, Ib29b9, Ic1238, I96def, b/235528239)
Modifiche alle API
- Le chiamate UI a
getItemepeekinAsyncPagingDataDifferePagingDataAdaptersono ora contrassegnate correttamente come richiamabili solo sul thread principale. (I699b6) - Sono stati rimossi i caratteri jolly dai tipi generici utilizzati da
TestPager, semplificando l'utilizzo dei risultati di questi metodi nel codice scritto nel linguaggio di programmazione Java. (I56c42)
Versione 3.2.0-alpha03
24 ottobre 2022
androidx.paging:paging-*:3.2.0-alpha03 è stato rilasciato. La versione 3.2.0-alpha03 contiene questi commit.
Test di paging
Questa release contiene un nuovo artefatto: paging-testing. Questo artefatto fornisce API progettate per i test delle unità di ogni livello dell'app e la sua integrazione con Paging in modo isolato.
Ad esempio, questa prima release include una classe TestPager che ti consente di convalidare il comportamento della tua implementazione PagingSource personalizzata indipendentemente da Pager e dalla UI reale che normalmente ti servirebbe per simulare l'integrazione di Paging end-to-end.
TestPager deve essere considerato un falso, un test double che rispecchia l'implementazione reale di Pager, fornendo al contempo una superficie API semplificata per testare un PagingSource. Queste API sono API suspend e devono essere eseguite all'interno di runTest, come descritto nella guida per testare le coroutine Kotlin su Android.
Un esempio di utilizzo di queste API è disponibile nei test room-paging, che sono stati rifattorizzati per utilizzare TestPager.
Modifiche alle API
- Consente una comoda iterazione su
LoadResult.Page.datatramiteLoadResult.Page.iterator(). In questo modo, è possibile utilizzare indirettamente il metodoflattendella libreria standard di Kotlin quando viene fornito unList<LoadResult.Page>, ad esempio con la proprietàpagesdiPagingStateche viene passata al metodoPagingSource.getRefreshKey. (Ie0718)
Versione 3.2.0-alpha02
10 agosto 2022
androidx.paging:paging-*:3.2.0-alpha02 è stato rilasciato. La versione 3.2.0-alpha02 contiene questi commit.
Nuove funzionalità
- Paging ora fornisce i log tramite le classi
AsyncPagingDataDifferoPagingDataAdapterper esporre le informazioni di debug raccolte daPagingData. - I log possono essere abilitati tramite il comando
adb shelladb shell setprop log.tag.Paging [DEBUG|VERBOSE].(b/235527159)
Correzioni di bug
- È stato corretto l'errore del costruttore
PagingDataDiffermancante quando si utilizzapaging-common:3.2.0-alpha01con il runtimepaging-runtime:3.1.1o versioni precedenti.(b/235256201)
Versione 3.2.0-alpha01
1° giugno 2022
androidx.paging:paging-*:3.2.0-alpha01 è stato rilasciato. La versione 3.2.0-alpha01 contiene questi commit.
Modifiche alle API
- Sono stati aggiunti costruttori per
PagingDataAdaptereAsyncPagingDataDifferche accettanoCoroutineContextanzichéCoroutineDispatcher. (Idc878) - Per impostazione predefinita,
PagingData.from()ePagingData.empty()non influiranno più suCombinedLoadStatessul lato del presentatore. È stato aggiunto un nuovo overload che consente di passaresourceLoadStateseremoteLoadStatesa questi costruttori per mantenere il comportamento esistente di impostazione diLoadStatesin modo che sia completamente terminale (ovvero,NotLoading(endOfPaginationReached = false)), con la possibilità di includere anche gli stati remoti, se necessario. SeLoadStatesnon vengono passati, iCombinedLoadStatesprecedenti verranno mantenuti sul lato del presentatore quando riceve ilPagingDatastatico. (Ic3ce5, b/205344028)
Correzioni di bug
- Il risultato di
PagingSource.getRefreshKey()ora ha correttamente la priorità suinitialKeynei casi in cui restituirebbe null, ma è stato impostato uninitialKeynon null. (Ic9542, b/230391606)
Contributo esterno
- Aggiornamento dell'API :compose:ui:ui-test (updateApi) a causa della migrazione di test-coroutines-lib (I3366d)
Versione 3.1
Versione 3.1.1
9 marzo 2022
androidx.paging:paging-*:3.1.1 è stato rilasciato. La versione 3.1.1 contiene questi commit.
Correzioni di bug
- Sono stati rimossi gli eventi
LoadState.NotLoadingintermedi tra le generazioni che erano stati inseriti in modo errato da.cachedIn(). Questa modifica semplifica notevolmente la reazione alle modifiche diLoadStaterimuovendo gli eventiLoadState.NotLoadingridondanti generati tra i nuovi tentativi di caricamento non riusciti, durante l'aggiornamento o durante l'annullamento della convalida.
Versione 3.1.0
17 novembre 2021
androidx.paging:paging-*:3.1.0 è stato rilasciato. La versione 3.1.0 contiene questi commit.
Modifiche importanti dalla versione 3.0.0
- Le API
Flow<PagingData>.observableeFlow<PagingData>.flowablenon sono più sperimentali - Modifiche al comportamento di
LoadState:endOfPaginationReachedora è semprefalseperLoadType.REFRESHperPagingSourceeRemoteMediatorLoadStatesdi Paging ora attende valori validi sia daPagingSourceche daRemoteMediatorprima di emettere downstream. Le nuove generazioni diPagingDataora inizieranno sempre correttamente conLoadingper lo stato di aggiornamento, anziché reimpostarsi suNotLoadingin modo errato in alcuni casi..loadStateFlowe.addLoadStateListenersulle API del presentatore non inviano più in modo ridondante unCombinedLoadStatesiniziale che ha sempre gli stati del mediatore impostati sunull
- L'annullamento delle generazioni precedenti ora avviene immediatamente in caso di annullamento/nuove generazioni. Non dovrebbe più essere necessario utilizzare
.collectLatestsuFlow<PagingData>, anche se è comunque consigliato. PagingSource.LoadResult.Invalidè stato aggiunto come nuovo tipo restituito daPagingSource.load, il che fa sì che Paging elimini tutte le richieste di caricamento in attesa o future per questoPagingSourcee lo annulli. Questo tipo restituito è progettato per gestire dati potenzialmente non validi o obsoleti che possono essere restituiti dal database o dalla rete.- Sono state aggiunte le API di presentazione
.onPagesPresentede.addOnPagesUpdatedListener, che vengono attivate in modo sincrono quando le pagine vengono presentate nell'UI. Gli aggiornamenti delle pagine possono avvenire nei seguenti scenari:- Il caricamento iniziale di una nuova generazione di PagingData viene completato, indipendentemente dal fatto che la nuova generazione contenga o meno modifiche agli elementi presentati, ad esempio Una nuova generazione che completa il caricamento iniziale senza aggiornamenti perché l'elenco è esattamente lo stesso attiverà comunque questo callback.
- Viene inserita una pagina, anche se non contiene nuovi elementi.
- Una pagina viene eliminata, anche se era vuota.
Versione 3.1.0-rc01
3 novembre 2021
androidx.paging:paging-*:3.1.0-rc01 è stato rilasciato. La versione 3.1.0-rc01 contiene questi commit.
Correzioni di bug
- Risolta una race condition e una perdita di memoria in .cachedIn() nei casi in cui più eventi di caricamento venivano inviati da Paging downstream quando non erano presenti osservatori o tra il momento in cui un osservatore passa a un nuovo PagingData. (Ib682e)
Versione 3.1.0-beta01
13 ottobre 2021
androidx.paging:paging-*:3.1.0-beta01 è stato rilasciato. La versione 3.1.0-beta01 contiene questi commit.
Correzioni di bug
- È stato risolto un problema per cui molti accessi rapidi agli elementi potevano causare la loro esclusione dalla considerazione in prefetchDistance, causando il blocco dei caricamenti pagina. Questo è un problema soprattutto quando molti elementi vengono disposti contemporaneamente in un ordine che darebbe la priorità al caricamento rispetto alla direzione di scorrimento dell'utente. Questi accessi agli elementi vengono ora memorizzati nel buffer e viene assegnata loro una priorità in modo sincrono per evitare che vengano eliminati. (aosp/1833273)
Versione 3.1.0-alpha04
29 settembre 2021
androidx.paging:paging-*:3.1.0-alpha04 è stato rilasciato. La versione 3.1.0-alpha04 contiene questi commit.
Modifiche alle API
- Le API
Flow<PagingData>.observableeFlow<PagingData>.flowablenon sono più sperimentali. (Ie0bdd)
Correzioni di bug
- Per LoadStates,
endOfPaginationReachedora è semprefalseperLoadType.REFRESH. In precedenza, era possibile che endOfPaginationReached fossetrueper RemoteMediatorREFRESH, ma non per PagingSource. Questo comportamento è ora consolidato per restituire semprefalse, poiché non ha mai senso che REFRESH sia terminale, ed è ora documentato come parte del contratto API in LoadStates. Quando decidi se la paginazione è terminata, devi sempre farlo in relazione alle direzioni APPEND o PREPEND. (I047b6) I LoadState di Paging ora attendono valori validi sia da PagingSource che da RemoteMediator prima di emettere downstream tra le generazioni. In questo modo, le nuove generazioni di PagingData non inviano NotLoading in CombinedLoadStates.source.refresh se era già Loading; le nuove generazioni di PagingData ora inizieranno sempre correttamente con Loading per lo stato di aggiornamento, anziché reimpostarsi prima su NotLoading in modo errato in alcuni casi.
L'annullamento delle generazioni precedenti ora avviene immediatamente in caso di annullamento della convalida/nuove generazioni. Non dovrebbe più essere necessario utilizzare .collectLatest su
Flow<PagingData>, anche se è comunque vivamente consigliato. (I0b2b5, b/177351336, b/195028524).loadStateFlowe.addLoadStateListenernelle API del presentatore non inviano più in modo ridondante unCombinedLoadStatesiniziale che ha sempre gli stati del mediatore impostati sunulle gli stati di origine impostati suNotLoading(endOfPaginationReached = false). Ciò significa che:- Gli stati del mediatore verranno sempre compilati se utilizzi RemoteMediator.
- La registrazione di un nuovo listener loadState o di un nuovo raccoglitore su
.loadStateFlownon emetterà più immediatamente il valore corrente se non ha ricevuto unCombinedLoadStatesreale daPagingData. Questo può accadere se un raccoglitore o un listener viene avviato prima dell'invio di unPagingData. (I1a748)
Versione 3.1.0-alpha03
21 luglio 2021
androidx.paging:paging-*:3.1.0-alpha03 è stato rilasciato. La versione 3.1.0-alpha03 contiene questi commit.
Modifiche alle API
Un terzo tipo restituito LoadResult, LoadResult.Invalid, viene aggiunto a PagingSource. Quando un PagingSource.load restituisce LoadResult.Invalid, l'impaginazione ignora i dati caricati e invalida il PagingSource. Questo tipo restituito è progettato per gestire dati potenzialmente non validi o obsoleti che possono essere restituiti dal database o dalla rete.
Ad esempio, se il database sottostante viene scritto, ma PagingSource non viene invalidato in tempo, potrebbe restituire risultati incoerenti se la sua implementazione dipende dall'immutabilità del set di dati di supporto da cui viene caricato (ad es. implementazioni di database in stile LIMIT OFFSET). In questo scenario, ti consigliamo di verificare l'annullamento della convalida dopo il caricamento e di restituire LoadResult.Invalid, che fa sì che Paging elimini eventuali richieste di caricamento in attesa o future per questo PagingSource e ne annulli la convalida.
Questo tipo restituito è supportato anche dall'API Paging2 che utilizza LivePagedList o RxPagedList. Quando utilizzi un PagingSource con le API PagedList di Paging2, PagedList viene scollegato immediatamente, interrompendo ulteriori tentativi di caricamento dei dati su questo PagedList e attivando l'annullamento della convalida su PagingSource.
LoadResult è una classe sealed, il che significa che si tratta di una modifica incompatibile con l'origine, per cui i casi d'uso che utilizzano direttamente i risultati di PagingSource.load dovranno gestire LoadResult.Invalid in tempo di compilazione. Ad esempio, gli utenti Kotlin che utilizzano exhaustive-when per controllare il tipo restituito dovranno aggiungere un controllo per il tipo non valido. (Id6bd3, b/191806126, b/192013267)
Correzioni di bug
- I callback di annullamento della convalida aggiunti tramite PagingSource.registerInvalidatedCallback o DataSource.addInvalidatedCallback ora vengono attivati automaticamente se sono stati registrati su un PagingSource/DataSource già non valido. In questo modo viene risolta una race condition che causava l'eliminazione dei segnali di annullamento della convalida da parte di Paging e il blocco quando veniva fornita un'origine già non valida durante il caricamento iniziale. Inoltre, i callback di annullamento della convalida ora vengono rimossi correttamente dopo l'attivazione, poiché è garantito che vengano chiamati al massimo una volta. (I27e69)
- L'invio del valore iniziale del segnaposto (InitialPagedList) da uno stream PagedList appena istanziato, ad esempio LivePagedListBuilder o RxPagedListBuilder, non cancellerà più i dati caricati in precedenza.
Versione 3.1.0-alpha02
1° luglio 2021
androidx.paging:paging-*:3.1.0-alpha02 è stato rilasciato. La versione 3.1.0-alpha02 contiene questi commit.
Nuove funzionalità
Sono state aggiunte le API onPagesPresented listener e flow presenter, che vengono attivate immediatamente dopo l'aggiornamento delle pagine presentate nella UI.
Poiché questi aggiornamenti sono sincroni con la UI, puoi chiamare i metodi dell'adattatore, come .snapshot, .getItemCount, per ispezionare lo stato dopo l'applicazione dell'aggiornamento. Tieni presente che .snapshot() è stato lasciato per essere chiamato esplicitamente perché può essere costoso da eseguire a ogni aggiornamento.
Gli aggiornamenti delle pagine possono verificarsi nei seguenti scenari:
- Il caricamento iniziale di una nuova generazione di PagingData viene completato, indipendentemente dal fatto che la nuova generazione contenga o meno modifiche agli elementi presentati, ad esempio Una nuova generazione che completa il caricamento iniziale senza aggiornamenti perché l'elenco è esattamente lo stesso attiverà comunque questo callback.
- Viene inserita una pagina, anche se non contiene nuovi elementi
- Una pagina viene eliminata, anche se era vuota (I272c9, b/189999634)
Correzioni di bug
- L'accesso a PagedList.dataSource dal valore iniziale prodotto da LivePagedList o RxPagedList non genererà più un'eccezione IllegalStateException (I96707)
Versione 3.1.0-alpha01
2 giugno 2021
androidx.paging:paging-*:3.1.0-alpha01 è stato rilasciato. La versione 3.1.0-alpha01 contiene questi commit.
Modifiche alle API
- Le classi fornite da
paging-rxjava3ora si trovano nel pacchettoandroidx.paging.rxjava3, in modo da non entrare in conflitto conpaging-rxjava2(Ifa7f6)
Correzioni di bug
- È stato risolto un problema per cui Paging a volte inviava eventi differ no-op a RecyclerView, il che poteva causare l'attivazione anticipata di determinati listener. (Ic507f, b/182510751)
Contributo esterno
- Sono state aggiunte API di compatibilità PagedList deprecate all'artefatto rxjava3 (Id1ce2, b/182497591)
Paging Compose versione 1.0.0
Versione 1.0.0-alpha20
24 maggio 2023
androidx.paging:paging-compose:1.0.0-alpha20 è stato rilasciato. La versione 1.0.0-alpha20 contiene questi commit.
Nuove funzionalità
- Paging Compose ora supporta l'anteprima di un elenco di dati fittizi creando un
PagingData.from(fakeData)e inserendoPagingDatain unMutableStateFlow(ad es.MutableStateFlow(PagingData.from(listOf(1, 2, 3)))). Utilizzando questi dati come input per@Preview, le chiamate acollectAsLazyPagingItems()fornirannoLazyPagingItemsvisualizzabili in anteprima. (I8a78d, b/194544557)
Correzioni di bug
- I dati memorizzati nella cache da
pager.flow.cachedInche sono stati raccolti inLazyPagingItemssaranno ora immediatamente disponibili dopo il ripristino dello stato, senza richiedere la raccolta asincrona. Ciò significa che i dati memorizzati nella cache saranno pronti per la presentazione immediatamente dopo la composizione iniziale, una volta ripristinato lo stato. (I97a60, b/177245496)
Versione 1.0.0-alpha19
3 maggio 2023
androidx.paging:paging-compose:1.0.0-alpha19 è stato rilasciato. La versione 1.0.0-alpha19 contiene questi commit.
Supporto di tutti i layout lazy
In precedenza, Paging Compose forniva estensioni items e itemsIndexed personalizzate su LazyListScope, il che significava che non potevi utilizzare Paging Compose con altri layout lazy come LazyVerticalGrid, HorizontalPager o altri componenti lazy personalizzati forniti dalle librerie Wear e TV. L'aggiornamento principale di questa release riguarda proprio questa rigidità.
Per supportare più layout lazy, abbiamo dovuto creare API a un livello diverso: anziché fornire un'API items personalizzata per ogni layout lazy, Paging Compose ora fornisce metodi di estensione di livello leggermente inferiore su LazyPagingItems in itemKey e itemContentType. Queste API si concentrano sull'aiutarti a implementare i parametri key e contentType nelle API items standard già esistenti per LazyColumn, LazyVerticalGrid e i loro equivalenti in API come HorizontalPager. (Ifa13b, Ib04f0, b/259385813)
Ciò significa che il supporto di un LazyVerticalGrid sarebbe simile a:
// 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)
}
}
Per altri esempi di utilizzo di queste nuove API, consulta i nostri esempi.
Sebbene queste modifiche rendano gli esempi di LazyColumn e LazyRow più lunghi di alcune righe, abbiamo ritenuto che la coerenza tra tutti i layout lazy fosse un fattore importante per chi utilizzerà Paging Compose in futuro. Per questo motivo, le estensioni esistenti di LazyListScope sono state ritirate. (I0c459, I92c8f, b/276989796)
Modifiche alle API
- Per facilitare la migrazione alle nuove API, le funzioni di estensione
itemseitemsIndexedsuLazyListScopeora supportano un parametrocontentType, che rispecchia il supporto nelle nuove API. (Ib1918, b/255283378)
Aggiornamenti delle dipendenze
- Paging Compose ha aggiornato la sua dipendenza da Compose 1.0.5 a Compose 1.2.1. (Ib1918, b/255283378)
Versione 1.0.0-alpha18
8 febbraio 2023
androidx.paging:paging-compose:1.0.0-alpha18 viene rilasciata senza modifiche. La versione 1.0.0-alpha18 contiene questi commit.
Versione 1.0.0-alpha17
24 ottobre 2022
androidx.paging:paging-compose:1.0.0-alpha17 è stato rilasciato. La versione 1.0.0-alpha17 contiene questi commit.
Nuove funzionalità
- Aggiungi il supporto per un
CoroutineContextpersonalizzato quando chiamicollectLazyPagingItems. (I7a574, b/243182795, b/233783862)
Versione 1.0.0-alpha16
10 agosto 2022
androidx.paging:paging-compose:1.0.0-alpha16 è stato rilasciato. La versione 1.0.0-alpha16 contiene questi commit.
Nuove funzionalità
- Paging ora fornisce i log tramite la classe
LazyPagingItemsper esporre le informazioni di debug raccolte da PagingData. - I log possono essere abilitati tramite il comando
adb shelladb shell setprop log.tag.Paging [DEBUG|VERBOSE]. ([b/235527159}(https://issuetracker.google.com/issues/235527159))
Correzioni di bug
- È stato corretto l'errore del costruttore
PagingDataDiffermancante quando si utilizzapaging-compose:1.0.0-alpha15conpaging-common:3.1.1o versioni precedenti.(b/235256201,b/239868768)
Versione 1.0.0-alpha15
1° giugno 2022
androidx.paging:paging-compose:1.0.0-alpha15 è stato rilasciato. La versione 1.0.0-alpha15 contiene questi commit.
Modifiche alle API
- Sono stati aggiunti costruttori per
PagingDataAdaptereAsyncPagingDataDifferche accettanoCoroutineContextanzichéCoroutineDispatcher. (Idc878)
Correzioni di bug
LazyPagingItemsora imposta l'loadStateiniziale in modo che abbia un aggiornamentoLoadState.Loading. (I55043, b/224855902)
Versione 1.0.0-alpha14
13 ottobre 2021
androidx.paging:paging-compose:1.0.0-alpha14 è stato rilasciato. La versione 1.0.0-alpha14 contiene questi commit.
Versione 1.0.0-alpha13
29 settembre 2021
androidx.paging:paging-compose:1.0.0-alpha13 è stato rilasciato. La versione 1.0.0-alpha13 contiene questi commit.
Modifiche alle API
- La funzione
LazyPagingItems.snapshot()è stata sostituita con la proprietàLazyPagingItems.itemSnapshotList(Ie2da8) - La proprietà deprecata
LazyPagingItems.getAsState()è stata rimossa (Ie65e4)
Versione 1.0.0-alpha12
21 luglio 2021
androidx.paging:paging-compose:1.0.0-alpha12 è stato rilasciato. La versione 1.0.0-alpha12 contiene questi commit.
Modifiche alle API
items(lazyPagingItems)eitemsIndexed(lazyPagingItems)utilizzati per connettere Paging conLazyColumn/Rowora accettano il parametro della chiave facoltativo che consente di specificare una chiave stabile che rappresenta l'elemento. Puoi scoprire di più sulle chiavi qui. (I7986d)- La funzione
lazyPagingItems.getAsState(index)è ora deprecata. Usa invece il descrittorelazyPagingItems[index]. (I086cb, b/187339372)
Versione 1.0.0-alpha11
30 giugno 2021
androidx.paging:paging-compose:1.0.0-alpha11 è stato rilasciato. La versione 1.0.0-alpha11 contiene questi commit.
Versione 1.0.0-alpha10
2 giugno 2021
androidx.paging:paging-compose:1.0.0-alpha10 è stato rilasciato. La versione 1.0.0-alpha10 contiene questi commit.
Versione 1.0.0-alpha09
18 maggio 2021
androidx.paging:paging-compose:1.0.0-alpha09 è stato rilasciato. La versione 1.0.0-alpha09 contiene questi commit.
Correzioni di bug
- itemCount e il getter degli elementi di LazyPagingItems sono ora osservabili, il che consente di utilizzarli anche con LazyVerticalGrid (Ie2446, b/171872064, b/168285687)
Compatibilità di Compose
androidx.paging:paging-compose:1.0.0-alpha09è compatibile solo con Compose versione1.0.0-beta07e successive.
Versione 1.0.0-alpha08
24 febbraio 2021
androidx.paging:paging-compose:1.0.0-alpha08 è stato rilasciato. La versione 1.0.0-alpha08 contiene questi commit.
È stato effettuato un aggiornamento per l'integrazione con Compose 1.0.0-beta01.
Versione 1.0.0-alpha07
10 febbraio 2021
androidx.paging:paging-compose:1.0.0-alpha07 è stato rilasciato. La versione 1.0.0-alpha07 contiene questi commit.
È stato effettuato un aggiornamento per l'integrazione con Compose alpha12.
Versione 1.0.0-alpha06
28 gennaio 2021
androidx.paging:paging-compose:1.0.0-alpha06 è stato rilasciato. La versione 1.0.0-alpha06 contiene questi commit.
Correzioni di bug
È stato effettuato un aggiornamento in modo che dipenda da Compose 1.0.0-alpha11.
Versione 1.0.0-alpha05
13 gennaio 2021
androidx.paging:paging-compose:1.0.0-alpha05 è stato rilasciato. La versione 1.0.0-alpha05 contiene questi commit.
È stato effettuato un aggiornamento in modo che dipenda da Compose 1.0.0-alpha10.
Versione 1.0.0-alpha04
16 dicembre 2020
androidx.paging:paging-compose:1.0.0-alpha04 è stato rilasciato. La versione 1.0.0-alpha04 contiene questi commit.
Correzioni di bug
- Aggiornate le proprietà di convenienza,
CombinedLoadStates.refresh,CombinedLoadStates.prepend,CombinedLoadStates.appendper passare daLoadingaNotLoadingsolo dopo che gli stati di caricamento del mediatore e dell'origine sonoNotLoadingper garantire che l'aggiornamento remoto sia stato applicato. (I65619)
Versione 1.0.0-alpha03
2 dicembre 2020
androidx.paging:paging-compose:1.0.0-alpha03 è stato rilasciato. La versione 1.0.0-alpha03 contiene questi commit.
- È stato effettuato un aggiornamento per la corrispondenza con Compose 1.0.0-alpha08.
Versione 1.0.0-alpha02
11 novembre 2020
androidx.paging:paging-compose:1.0.0-alpha02 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.
Modifiche alle API
- Sono stati aggiunti i metodi
.peek(),.snapshot(),.retry()e.refresh()aLazyPagingItemche espongono la stessa funzionalità disponibile inAsyncPagingDataDiffer/PagingDataAdapter(Iddfe8, b/172041660)
Versione 1.0.0-alpha01
28 ottobre 2020
androidx.paging:paging-compose:1.0.0-alpha01 è stato rilasciato. La versione 1.0.0-alpha01 contiene questi commit.
Nuove funzionalità
L'artefatto paging-compose fornisce l'integrazione tra la libreria Paging e Jetpack Compose. Un semplice esempio di utilizzo:
@Composable
@OptIn(ExperimentalLazyDsl::class)
fun ItemsDemo(flow: Flow<PagingData<String>>) {
val lazyPagingItems = flow.collectAsLazyPagingItems()
LazyColumn {
items(lazyPagingItems) {
Text("Item is $it")
}
}
}
Versione 3.0.1
Versione 3.0.1
21 luglio 2021
androidx.paging:paging-*:3.0.1 è stato rilasciato. La versione 3.0.1 contiene questi commit.
Correzioni di bug
- L'accesso a
PagedList.dataSourcedal valore iniziale prodotto daLivePagedListoRxPagedListnon genererà più erroneamente un'eccezione IllegalStateException (I96707)
Versione 3.0.0
Versione 3.0.0
5 maggio 2021
androidx.paging:paging-*:3.0.0 è stato rilasciato. La versione 3.0.0 contiene questi commit.
Funzionalità principali della versione 3.0.0
La maggior parte dell'API esistente di Paging 2.x.x è stata ritirata a favore delle nuove API Paging 3 per apportare i seguenti miglioramenti:
- Supporto di prima classe per le coroutine e i flussi Kotlin
- Assistenza per l'annullamento
- Indicatori di stato di caricamento ed errore integrati
- Funzionalità di aggiornamento e ripetizione
- Tutte e tre le sottoclassi DataSource sono state combinate in una classe PagingSource unificata
- Trasformazioni di pagine personalizzate, inclusa una integrata per l'aggiunta di separatori annunci
- Intestazioni e piè di pagina dello stato di caricamento
Versione 3.0.0-rc01
21 aprile 2021
androidx.paging:paging-*:3.0.0-rc01 è stato rilasciato. La versione 3.0.0-rc01 contiene questi commit.
Correzioni di bug
- È stato risolto un problema per cui Paging a volte inviava eventi differ no-op a RecyclerView, il che poteva causare l'attivazione anticipata di determinati listener. (Ic507f, b/182510751)
Versione 3.0.0-beta03
24 marzo 2021
androidx.paging:paging-*:3.0.0-beta03 è stato rilasciato. La versione 3.0.0-beta03 contiene questi commit.
Correzioni di bug
- Abbiamo rinnovato il modo in cui vengono gestiti i segnaposto quando l'elenco viene ricaricato per evitare salti imprevisti in RecyclerView. Per maggiori dettagli, consulta NullPaddedDiffing.md. (If1490, b/170027529, b/177338149)
- I vari builder PagedList (percorso di compatibilità precedente) non chiamano più in modo errato
DataSource.Factory.create()in modo sincrono sul thread principale quando viene chiamato.build(). (b/182798948)
Versione 3.0.0-beta02
10 marzo 2021
androidx.paging:paging-*:3.0.0-beta02 è stato rilasciato. La versione 3.0.0-beta02 contiene questi commit.
Modifiche alle API
- Le estensioni Rx3 ora propagano correttamente il requisito di attivazione di
@ExperimentalCoroutinesApi. In precedenza erano contrassegnate sul metodo@get, che viene ignorato dal compilatore Kotlin a causa di: https://youtrack.jetbrains.com/issue/KT-45227 (I5733c)
Correzioni di bug
- Applicazione di limitazioni all'utilizzo pubblico delle API sperimentali (I6aa29, b/174531520)
- Risolto un bug che causava l'impostazione di
PagingStatesempre sunullquando viene chiamato l'aggiornamento remoto. - Risolto un bug per cui le pagine vuote restituite da PagingSource potevano impedire a Paging di eseguire nuovamente il recupero per soddisfare
prefetchDistance, causando il "blocco" di Paging.
Versione 3.0.0-beta01
10 febbraio 2021
androidx.paging:paging-*:3.0.0-beta01 è stato rilasciato. La versione 3.0.0-beta01 contiene questi commit.
Modifiche alle API
- I wrapper Rx2 e Rx3 ora espongono l'annotazione sperimentale da cui dipendono. Se utilizzi i wrapper di compatibilità Rx in paging-rxjava2 o paging-rxjava3, ora dovrai annotare gli utilizzi con
@OptIn(ExperimentalCoroutinesApi::class)(Ib1f9d)
Correzioni di bug
- Risolto il problema per cui a volte veniva generato
IndexOutOfBoundsException: Inconsistency detectedquando si utilizzavano le APIDataSourcev2 tramite percorsi di compatibilità - La chiamata
isInvaliddurante l'inizializzazione diDataSourcequando viene utilizzata tramite i percorsi di compatibilità ora viene avviata correttamente su fetchDispatcher anziché sul thread principale. In questo modo viene corretto unIllegalStateExceptiondovuto all'accesso al database nel thread principale quando si utilizza l'implementazionePagingSourcedi Room.
Versione 3.0.0-alpha13
27 gennaio 2021
androidx.paging:paging-*:3.0.0-alpha13 è stato rilasciato. La versione 3.0.0-alpha13 contiene questi commit.
Modifiche alle API
- L'implementazione di
PagingSource.getRefreshKeynon è più facoltativa, ora è una funzione astratta senza un'implementazione predefinita. Gli utenti che eseguono la migrazione possono continuare a restituire l'implementazione predefinita, che restituisce semplicementenull, magetRefreshKey()dovrebbe avere un'implementazione reale che restituisce una chiave basata sulla posizione di scorrimento corrente dell'utente che consente a Paging di continuare a caricare i dati centrati sulla viewport tramitePagingState.anchorPosition, se possibile. (I4339a) InvalidatingPagingSourceFactoryè ora una classe finale (Ia3b0a)- Consenti la configurazione del comportamento del separatore del terminale (intestazione/piè di pagina) con un parametro SeparatorType facoltativo aggiuntivo. Le due opzioni sono:
FULLY_COMPLETE: comportamento esistente; attendi che sia PagingSource sia RemoteMediator contrassegnino endOfPaginationReached prima di aggiungere i separatori terminali. Se RemoteMediator non viene utilizzato, il loadState remoto viene ignorato. Questo è utile principalmente se vuoi mostrare i separatori di sezione solo quando la sezione è completamente caricata, incluso il recupero da un'origine remota, ad esempio la rete.SOURCE_COMPLETE: attende solo che PagingSource contrassegni endOfPaginationReached anche se viene utilizzato RemoteMediator. In questo modo, le intestazioni e i piè di pagina vengono presentati in modo sincrono con il caricamento iniziale, evitando agli utenti di dover scorrere per visualizzare i separatori finali. (Ibe993, b/174700218)
Correzioni di bug
- Risolta una rara perdita di memoria che si verifica quando un PagingSource viene invalidato prima che PageFetcher possa iniziare a caricare i dati. (I9606b, b/174625633)
Versione 3.0.0-alpha12
13 gennaio 2021
androidx.paging:paging-*:3.0.0-alpha12 è stato rilasciato. La versione 3.0.0-alpha12 contiene questi commit.
Modifiche alle API
- InvalidatingPagingSourceFactory non è più una classe astratta, poiché non ha mai avuto metodi astratti. (I4a8c4)
- È stato aggiunto un overload di .cachedIn() che accetta ViewModel anziché Lifecycle o CoroutineScope per gli utenti Java. (I97d81, b/175332619)
- Consenti ai chiamanti Java di utilizzare le operazioni di trasformazione di PagingData in modo asincrono, accettando un Executor negli argomenti dell'operatore di trasformazione. Tutti gli operatori di trasformazione -Sync ora non hanno più il suffisso -Sync e gli utenti di coroutine Kotlin dovranno risolvere l'ambiguità chiamando la funzione di estensione che accetta un blocco di sospensione.
Tutti gli operatori di trasformazione PagingData sono stati spostati nelle estensioni
nella classe statica PagingDataTransforms. Gli utenti Java dovranno chiamarli tramite helper statici, ad esempio
PagingDataTransforms.map(pagingData, transform). Per gli utenti Kotlin, la sintassi è la stessa, ma dovranno importare la funzione. (If6885, b/172895919)
Correzioni di bug
- È stato corretto un bug per cui
RemoteMediator.load()non veniva chiamato duranteadapter.refresh()se era già stata raggiunta la fine dell'impaginazione.
Versione 3.0.0-alpha11
16 dicembre 2020
androidx.paging:paging-*:3.0.0-alpha11 è stato rilasciato. La versione 3.0.0-alpha11 contiene questi commit.
Nuove funzionalità
- Aggiunto il supporto dello stato salvato per i seguenti casi d'uso di base (il supporto completo, in particolare nel caso dell'origine a livelli, è ancora in fase di sviluppo):
- il flusso viene memorizzato nella cache e l'applicazione non viene terminata (ad esempio, il flusso viene memorizzato nella cache in un modello di visualizzazione e l'attività viene ricreata nel processo)
- viene conteggiata l'origine di paging, i segnaposto sono attivati e il layout non è sfalsato.
Modifiche alle API
PagingSource.getRefreshKey()è ora un'API stabile (I22f6f, b/173530980)PagingSource.invalidatenon è più una funzione aperta. Se devi ricevere una notifica quando si verifica l'annullamento della convalida, valuta la possibilità di chiamare il metodo registerInvalidatedCallback anziché eseguire l'override di invalidate. (I628d9, b/173029013, b/137971356)- Pager ora ha un singolo costruttore sperimentale insieme ai suoi costruttori normali, anziché esporre le API sperimentali nell'API pubblica non sperimentale tramite l'annotazione di attivazione. (I9dc61, b/174531520)
- Aggiornate le proprietà di convenienza,
CombinedLoadStates.refresh,CombinedLoadStates.prepend,CombinedLoadStates.appendper passare daLoadingaNotLoadingsolo dopo che gli stati di caricamento del mediatore e dell'origine sonoNotLoadingper garantire che l'aggiornamento remoto sia stato applicato. (I65619) LoadParams.pageSize è stato rimosso (era già deprecato). Il consiglio è di utilizzare
LoadParams.loadSizein PagingSource.LoadParams.loadSizeè sempre uguale aPagingConfig.pageSize, ad eccezione della chiamata di caricamento iniziale, in cui è uguale aPagingConfig.initialLoadSize.Se stai testando il tuo DataSource Paging2 senza utilizzare un Pager o un PagedList,
pageSizepotrebbe non corrispondere aPagingConfig.pageSizese stai impostando ancheinitialLoadSize. Se è importante per i tuoi test, prova a utilizzare un Pager/PagedList, che imposterà internamente il PageSize corretto per i metodi di caricamento DataSource. (I98ac7, b/149157296)
Correzioni di bug
- Risolto un arresto anomalo dovuto a IllegalStateException quando si utilizzano i separatori con PagingConfig.maxSize impostato. (I0ed33, b/174787528)
- È stato corretto un bug per cui lo stato di caricamento per PREPEND/APPEND non veniva aggiornato immediatamente a
NotLoading(endOfPaginationReached = true)dopo il caricamento iniziale se era impostato RemoteMediator (I8cf5a) - Risolto un bug per cui le API lato presentatore come .snapshot(), .peek() e così via restituivano l'elenco precedente (non aggiornato) all'interno degli aggiornamenti di ListUpdateCallback.
- È stato corretto un bug per cui gli operatori Separators non aggiungevano intestazioni o piè di pagina se utilizzati con RemoteMediator
- È stato corretto un bug per cui gli aggiornamenti di LoadState a NotLoading per RemoteMediator si bloccavano nello stato Loading
- Risolto un bug per cui l'API di compatibilità Paging2.0,
.asPagingSourceFactory(), poteva causare l'inizializzazione delDataSourcedi supporto sul CoroutineDispatcher errato. In questo modo si risolve un arresto anomalo e possibili casi di ANR, soprattutto quando si utilizza l'implementazione attuale di PagingSource di Room, che utilizza questo percorso di compatibilità.
Versione 3.0.0-alpha10
2 dicembre 2020
androidx.paging:paging-*:3.0.0-alpha10 è stato rilasciato. La versione 3.0.0-alpha10 contiene questi commit.
Modifiche alle API
Le API
dataRefreshFlowedataRefreshListenerdeprecate sono state rimosse perché ridondanti con gli aggiornamenti di loadStateFlow/Listener. Per chi esegue la migrazione, l'equivalente di loadStateFlow è:loadStateFlow.distinctUntilChangedBy { it.refresh } .filter { it.refresh is NotLoading }
Correzioni di bug
- endOfPaginationReached per RemoteMediator
REFRESHora si propaga correttamente agli aggiornamenti di LoadState e impedisce l'attivazione diAPPENDePREPENDremoti. (I94a3f, b/155290248) - La visualizzazione di un elenco vuoto a causa di una pagina iniziale vuota o di un filtro pesante non impedirà più l'avvio dei caricamenti
PREPENDoAPPENDdi Paging. (I3e702, b/168169730) - Risolto un problema per cui
getRefreshKeynon veniva chiamato nelle generazioni successive di PagingSource quando le invalidazioni si verificavano rapidamente. (I45460, b/170027530)
Contributo esterno
- È stata aggiunta una nuova classe astratta InvalidatingPagingSourceFactory con un'API
.invalidate()che inoltra l'annullamento della convalida a tutti i PagingSource che emette. Grazie a @claraf3. (Ie71fc, b/160716447)
Problemi noti
- Le intestazioni e i piè di pagina della trasformazione .insertSeparators() potrebbero non essere visualizzati immediatamente quando si utilizza RemoteMediator b/172254056
- L'utilizzo di RemoteMediator può causare il blocco di
LoadStateremoto se l'annullamento della convalida ePagingSource.load(LoadParams.Refresh(...))vengono completati prima cheRemoteMediator.load()restituisca b/173717820
Versione 3.0.0-alpha09
11 novembre 2020
androidx.paging:paging-*:3.0.0-alpha09 è stato rilasciato. La versione 3.0.0-alpha09 contiene questi commit.
Modifiche alle API
- Ritiro completo dei metodi dataRefreshFlow/Listener con una clausola replaceWith. (I6e2dd)
Correzioni di bug
- Correzione di un problema per cui veniva generato
IllegalArgumentExceptionquando si utilizzavano i separatori con RemoteMediator e veniva attivata un'invalidazione mentre era ancora in esecuzione un caricamento remoto che restituiva endOfPagination (I3a260)
Versione 3.0.0-alpha08
28 ottobre 2020
androidx.paging:paging-*:3.0.0-alpha08 è stato rilasciato. La versione 3.0.0-alpha08 contiene questi commit.
Modifiche alle API
- Le varianti Kotlin/Java di
DataSource.InvalidatedCallbacksono state combinate abilitando le conversioni SAM in Kotlin tramite l'interfaccia funzionale (disponibile in Kotlin 1.4). In questo modo viene anche corretto un bug per cui la variante Kotlin dei callback di annullamento della convalida non veniva chiamata dopo la trasformazione da parte di.mapo.mapByPage. (I1f244, b/165313046)
Correzioni di bug
- L'interazione di Paging con ViewPager è stata notevolmente migliorata. In particolare, Paging non annullerà più una chiamata
RemoteMediator#loada causa di un'invalidazione della pagina. Inoltre, non effettuerà più una richiesta di caricamento di aggiunta/anteposizione, se è richiesto REFRESH, finché la richiesta REFRESH non viene completata correttamente. (I6390b, b/162252536) - Il controllo lint dell'API per MissingGetterMatchingBuilder è abilitato per androidx (I4bbea, b/138602561)
- È stato corretto un bug per cui gli helper
.withLoadState*ConcatAdaptersi arrestavano in modo anomalo a causa della notifica di RecyclerView dal thread in background (I18bb5, b/170988309) - Risolto un bug per cui il caricamento di una pagina non vuota molto piccola a volte impediva al precaricamento di attivare i caricamenti correttamente.Iffda3 b/169259468
Versione 3.0.0-alpha07
1° ottobre 2020
androidx.paging:paging-*:3.0.0-alpha07 è stato rilasciato. La versione 3.0.0-alpha07 contiene questi commit.
Modifiche alle API
- Gli operatori basati su Guava di Async PagingData ora accettano un Executor come parametro per controllare il contesto di esecuzione. (Id4372)
Correzioni di bug
- Risolta l'eccezione IndexOutOfBounds generata in RemoteMediator a causa di una race condition. (I00b7f, b/165821814)
- È stata corretta una race condition nella conversione da DataSource a PagingSource che poteva causare l'annullamento dei segnali di annullamento della convalida da DataSource da parte della PagingSource risultante.
- Risolto un problema nella logica di recupero della pagina che a volte impediva di rilevare nuove generazioni di PagingSource fino a quando non veniva richiamato PagingDataAdapter.refresh()
- Risolto un problema che causava la perdita della posizione di scorrimento quando si utilizzava un DataSource convertito in un PagingSource (come quello prodotto da Room), insieme a RemoteMediator
Contributo esterno
- Grazie a @simonschiller per aver aggiunto gli operatori di trasformazione asincrona basati su RxJava2, RxJava3 e Guava per PagingData.
Versione 3.0.0-alpha06
2 settembre 2020
androidx.paging:paging-*:3.0.0-alpha06 è stato rilasciato. La versione 3.0.0-alpha06 contiene questi commit.
Modifiche alle API
UnsupportedOperationExceptioncon messaggi più chiari sulla mancanza di supporto per gli ID stabili viene ora generata ogni volta che viene chiamatoPagingDataAdapter.setHasStableIds. (Ib3890, b/158801427)
Correzioni di bug
- insertSeparators non filtra più le pagine vuote, consentendo al presentatore di rispettare la distanza di precaricamento anche nei casi in cui vengono inserite molte pagine vuote. (I9cff6, b/162538908)
Versione 3.0.0-alpha05
19 agosto 2020
androidx.paging:paging-*:3.0.0-alpha05 è stato rilasciato. La versione 3.0.0-alpha05 contiene questi commit.
Correzioni di bug
- La paginazione ora esegue correttamente il precaricamento delle pagine anche quando i dati presentati sono molto filtrati
- La restituzione di
LoadResult.Errora un caricamento ritentato non causa più l'attivazione errata di un nuovo tentativo di accesso agli elementi
Contributo esterno
- Grazie a Clara F per aver contribuito a ripulire alcuni test. (549612)
Versione 3.0.0-alpha04
5 agosto 2020
androidx.paging:paging-*:3.0.0-alpha04 è stato rilasciato. La versione 3.0.0-alpha04 contiene questi commit.
Modifiche alle API
- Aggiunta l'API
peek()aAsyncPagingDataDifferePagingDataAdapterper consentire l'accesso ai dati presentati senza attivare i caricamenti pagina. (I38898, b/159104197) - È stata aggiunta un'API
snapshot()aPagingDataAdaptereAsyncPagingDataDifferper consentire il recupero degli elementi presentati senza attivare il recupero della pagina. (I566b6, b/159104197) - È stato aggiunto un costruttore
PagingData.from(List<T>)per consentire la presentazione di elenchi statici, che possono essere combinati con il flusso PagingData complessivo per mostrare elenchi statici in determinati stati, ad esempio prima del completamento del REFRESH iniziale o semplicemente per testare le trasformazioni. (Id134d) - Ritira le API Flow/Listener dataRefresh, poiché erano destinate a esporre lo stato degli elementi presentati su REFRESH, ma con i miglioramenti alla tempistica di callback Flow/Listener loadState e alla proprietà itemCount, sono ridondanti (Ia19f3)
- Sono stati aggiunti wrapper di compatibilità RxJava3 per
PagingSourceeRemoteMediator(I49ef3, b/161480176)
Correzioni di bug
PositionalDataSourceconvertito inPagingSourcetramite l'helpertoPagingSourceFactory, inclusoPagingSourcegenerato da Room, ora si contrassegna correttamente per supportare il salto. (I3e84c, b/162161201)- È stato corretto un bug per cui l'utilizzo della variante sincrona di submitData a volte causava una race condition che generava un
ClosedSendChannelException(I4d702, b/160192222)
Contributo esterno
- Grazie a Zac Sweers per aver aggiunto i wrapper di compatibilità RxJava3 per conto di Slack. (I49ef3, b/161480176)
Versione 3.0.0-alpha03
22 luglio 2020
androidx.paging:paging-*:3.0.0-alpha03 è stato rilasciato. La versione 3.0.0-alpha03 contiene questi commit.
Modifiche alle API
- Il costruttore di PagingState è ora pubblico, il che dovrebbe semplificare le implementazioni di test di getRefreshKey() (I8bf15)
- Sono state nascoste le varianti della funzione di mappa kotlin DataSource da Java per risolvere l'ambiguità tra le varianti originali e kotlin. (If7b23, b/161150011)
- Le API ridondanti destinate a semplificare l'utilizzo di Kotlin sono state contrassegnate con @JvmSynthetic (I56ae5)
- Sono stati aggiunti overload per il costruttore di LoadResult.Page, che imposta itemsBefore e itemsAfter su COUNT_UNDEFINED (I47849)
- Gli operatori PagingData esistenti ora accettano i metodi di sospensione e sono stati introdotti i nuovi operatori non di sospensione mapSync, flatMapSync e filterSync per gli utenti Java. I metodi di trasformazione esistenti sono stati spostati nelle funzioni di estensione, pertanto gli utenti di Kotlin dovranno ora importarli. (I34239, b/159983232)
Correzioni di bug
- Le classi PagingSource di Room (e PositionalDataSource) ora mostreranno un separatore iniziale come parte della prima pagina, in modo che l'utente non debba scorrere per visualizzarlo. (I6f747, b/160257628)
- Gli accessi agli elementi sui segnaposto ora attivano correttamente i caricamenti di PagingSource finché non viene restituita una pagina che soddisfa l'indice richiesto dopo essere stata trasformata da PagingData.filter() (I95625, b/158763195)
- Correzione di un bug per cui a volte lo scorrimento dopo che PagingSource restituisce un errore poteva impedire a PagingDataAdapter.retry() di riprovare. (I1084f, b/160194384)
- Risolve un problema per cui gli accessi agli elementi dopo l'eliminazione di una pagina potrebbero non caricare le pagine anche se l'accesso agli elementi era compreso in prefetchDistance (Ie95ae, b/160038730)
- L'impostazione di PagingConfig.maxSize non attiva più i segnaposto dopo un evento di eliminazione (I2be29, b/159667766)
Versione 3.0.0-alpha02
24 giugno 2020
androidx.paging:paging-*:3.0.0-alpha02 è stato rilasciato. La versione 3.0.0-alpha02 contiene questi commit.
Modifiche alle API
- Sono stati aggiunti overload per il costruttore di
PagingConfigcon valori predefiniti comuni (I39c50, b/158576040) - Sono stati aggiunti overload per i costruttori di
PagingDataAdaptereAsyncPagingDataDiffercon valori predefiniti comuni (Ie91f5) - Le API dell'adattatore,
dataRefreshFlowedataRefreshListener, ora passano un valore booleano per segnalare se unPagingDataè vuoto (I6e37e, b/159054196) - Sono state aggiunte le API RxJava e Guava per RemoteMediator: RxRemoteMediator e ListenableFutureRemoteMediator
- Sono stati aggiunti helper a PagingState per l'accesso agli elementi comuni, ad esempio
isEmpty()efirstItemOrNull()(I3b5b6, b/158892717)
Correzioni di bug
- Pager ora verifica il riutilizzo di PagingSource nella factory per impedire il riutilizzo accidentale di PagingSource non valide, che generava un errore non chiaro (I99809, b/158486430)
- Gli errori di REFRESH di RemoteMediator non impediscono più il caricamento di PagingSource (I38b1b, b/158892717)
- La versione non sospesa di
submitDatanon causa più un arresto anomalo dovuto alla raccolta simultanea su piùPagingDataquando viene chiamata dopo la versione sospesa disubmitData. (I26358, b/158048877) - Risolta l'eccezione "cannot collect twice from pager" che poteva verificarsi dopo la modifica della configurazione (I58bcc, b/158784811)
Versione 3.0.0-alpha01
10 giugno 2020
androidx.paging:paging-*:3.0.0-alpha01 è stato rilasciato. La versione 3.0.0-alpha01 contiene questi commit.
La libreria Paging è stata aggiornata alla versione 3.0 per attivare diverse nuove funzionalità importanti.
Nuove funzionalità della versione 3.0
- Supporto di prima classe per le coroutine e i flussi Kotlin.
- Supporto per il caricamento asincrono con funzioni di sospensione delle coroutine, primitive RxJava Single o Guava ListenableFuture.
- Indicatori di stato di caricamento ed errori integrati per un design dell'interfaccia utente adattabile, incluse le funzionalità di nuovo tentativo e aggiornamento.
- Miglioramenti al livello del repository
- Interfaccia semplificata dell'origine dati
- Paginazione semplificata di rete e database
- Assistenza per l'annullamento
- Miglioramenti al livello di presentazione
Problemi noti
- I javadoc di Paging 3 non sono ancora disponibili. Nel frattempo, utilizza le guide collegate sopra o la documentazione di Kotlin. (b/158614050)
Versione 2.1.2
Versione 2.1.2
18 marzo 2020
androidx.paging:paging:2.1.2 è stato rilasciato. La versione 2.1.2 contiene questi commit rispetto alla versione 2.1.0.
Correzioni di bug
- Correzione di
IndexOutOfBoundsExceptionin rari casi durante la conversione di una posizione durante l'annullamento della convalida.
Problema relativo alla release
La versione
2.1.1di Paging è stata rilasciata erroneamente da un branch configurato in modo errato, esponendo API e funzionalità parzialmente implementate che verranno introdotte in una release futura.Paging
2.1.2contiene la correzione per la centralizzazione del caricamento originariamente rilasciata nella versione 2.1.1, ma questa volta è stata selezionata correttamente in cima alla versione 2.1.0. Se attualmente utilizzi la versione 2.1.1, ti consigliamo vivamente di eseguire l'upgrade a questa release.
Versione 2.1.1
Versione 2.1.1
18 dicembre 2019
androidx.paging:paging-*:2.1.1 è stato rilasciato. La versione 2.1.1 contiene questi commit.
Correzioni di bug
- I caricamenti iniziali contigui da PositionalDataSource ora sono incentrati sull'ultimo accesso quando i segnaposto sono disattivati
Versione 2.1.0
Versione 2.1.0
25 gennaio 2019
Paging 2.1.0 viene rilasciato senza modifiche rispetto a 2.1.0-rc01.
Versione 2.1.0-rc01
6 dicembre 2018
Paging 2.1.0-rc01 viene rilasciato senza modifiche rispetto a 2.1.0-beta01.
Versione 2.1.0-beta01
1 novembre 2018
Paging 2.1.0-beta01 viene rilasciato senza modifiche rispetto a 2.1.0-alpha01.
Versione 2.1.0-alpha01
12 ottobre 2018
Paging 2.1.0-alpha01 include due aggiunte principali, ovvero l'eliminazione delle pagine e le librerie di estensioni KTX per ogni artefatto, oltre a diverse altre modifiche alle API e correzioni di bug.
Modifiche alle API
- Aggiunto
PagedList.Config.Builder.setMaxSize()per limitare il numero di elementi caricati in memoria. - È stato aggiunto
androidx.paging.Config()come alternativa Kotlin perPagedList.Config.Builder - È stato aggiunto
androidx.paging.PagedList()come alternativa Kotlin perPagedList.Builder - È stato aggiunto
DataSourceFactory.toLiveData()come alternativa Kotlin perLivePagedListBuilder - Sono stati aggiunti
DataSourceFactory.toObservable()etoFlowable()come alternative Kotlin perRxPagedListBuilder - Aggiunto
AsyncPagedListDiffer.addPagedListListener()per l'ascolto quando PagedList viene scambiato. b/111698609 - Aggiunta la variante
PagedListAdapter.onCurrentListChanged()che passa l'elenco precedente e quello nuovo, ritirata la variante precedente. - Sono state aggiunte varianti di
PagedListAdapter/AsyncPagedListDiffer.submitList()che accettano un callback aggiuntivo che si attiva se/quando viene visualizzato l'elenco di pagine, dopo il diffing. In questo modo puoi sincronizzare uno scambio di PagedList con altri aggiornamenti della UI. b/73781068 - È stato aggiunto
PagedList.getLoadedCount()per farti sapere quanti elementi sono presenti nella memoria. Tieni presente che il valore restituito è sempre uguale a.size()se i segnaposto sono disattivati.
Correzioni di bug
- È stata corretta una race condition durante il diffing se gli elenchi vengono riutilizzati b/111591017
PagedList.loadAround()ora generaIndexOutOfBoundsExceptionquando l'indice non è valido. In precedenza, poteva verificarsi un arresto anomalo con un'altra eccezione non chiara.- Risolto un problema per cui una dimensione di caricamento iniziale estremamente ridotta, insieme a dati invariati, non comportava un ulteriore caricamento b/113122599
Versione 2.0.0
Versione 2.0.0
1° ottobre 2018
Paging 2.0.0 viene rilasciato con una singola correzione di bug.
Correzioni di bug
- Risolto un arresto anomalo che poteva verificarsi con lo scorrimento molto rapido utilizzando
PositionalDataSourcee i segnaposto b/114635383.
Versione 2.0.0-beta01
2 luglio 2018
Correzioni di bug
- Risolto il problema della scomparsa dei contenuti in alcuni casi di aggiunta all'inizio (segnaposto disattivati, PositionalDataSource) b/80149146
- (Già rilasciato in
1.0.1) Sono stati corretti gli arresti anomali in cuiPagedListAdaptereAsyncPagedListDiffernon riuscivano a segnalare gli eventi di spostamento. b/110711937
Dipendenze pre-AndroidX
Per le versioni di Paging precedenti ad AndroidX, includi le seguenti dipendenze:
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"
}
Versione 1.0.1
Versione 1.0.1
26 giugno 2018
Paging 1.0.1 viene rilasciato con un singolo bug correttivo in runtime. Ti consigliamo vivamente di utilizzare 1.0.1 per garantire la stabilità. È stata rilasciata anche la versione 1.0.1 di Paging RxJava2, che è identica a 1.0.0-rc1.
Correzioni di bug
- Risolti gli arresti anomali in cui
PagedListAdaptereAsyncPagedListDiffernon riuscivano a segnalare gli eventi di spostamento. b/110711937
RxJava2 versione 1.0.0
RxJava2 versione 1.0.0-rc1
16 maggio 2018
Paging RxJava2 1.0.0-rc1 sta passando alla fase di candidato per la release senza modifiche rispetto alla versione alpha iniziale.
Versione 1.0.0
Versione 1.0.0-rc1
19 aprile 2018 Candidato per la release di Paging
Non abbiamo altri problemi noti o nuove funzionalità in programma per la release di Paging 1.0.0. Esegui l'upgrade dei tuoi progetti per utilizzare 1.0.0-rc1 e aiutaci a testarlo in modo da poter rilasciare una versione 1.0.0 solida.
Non sono presenti modifiche in questa release, che è uguale a 1.0.0-beta1.
Versione 1.0.0-beta1
5 aprile 2018
Paging sarà in versione beta per un breve periodo prima di passare alla fase di candidato per la release.
Non prevediamo ulteriori modifiche alle API per Paging 1.0 e la soglia per eventuali modifiche alle API è molto alta.
Il supporto alpha di RxJava2 per Paging viene rilasciato come modulo facoltativo separato (android.arch.paging:rxjava2:1.0.0-alpha1)
e verrà temporaneamente sottoposto a controllo di versione separatamente fino alla stabilizzazione.
Questa nuova libreria fornisce un'alternativa RxJava2 a LivePagedListBuilder, in grado di creare
Observable e Flowable, accettando Scheduler anziché 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();
Nuove funzionalità
RxPagedListBuilderviene aggiunto tramite il nuovo artefattoandroid.arch.paging:rxjava2.
Modifiche alle API
Modifiche all'API per chiarire il ruolo degli esecutori nei builder:
setBackgroundThreadExecutor()rinominato insetFetchExecutor()(inPagedList.BuildereLivePagedListBuilder)setMainThreadExecutor()rinominato insetNotifyExecutor()(inPagedList.Builder).
Il membro
PagedList.mCallbacksè stato corretto in modo che sia privato.
Correzioni di bug
LivePagedListBuilderattiva il caricamento iniziale diPagedListsull'esecutore specificato, anziché sul pool di thread di I/O dei componenti di architettura.È stato corretto il comportamento di annullamento della convalida nei wrapper
DataSourceinterni (utilizzati per implementareDataSource.map, nonché il caricamento diPositionalDataSourcecon segnaposto disattivato) b/77237534
Versione 1.0.0-alpha7
21 marzo 2018
Paging 1.0.0-alpha7 viene rilasciato insieme a Lifecycles 1.1.1. Poiché Paging alpha7 dipende dallo spostamento della classe Function menzionata sopra, dovrai aggiornare la dipendenza lifecycle:runtime a android.arch.lifecycle:runtime:1.1.1.
Paging alpha7 dovrebbe essere la release finale prima che Paging passi alla versione beta.
Modifiche alle API
- Gli oggetti
DataSource.LoadParamsora hanno un costruttore pubblico e gli oggettiDataSource.LoadCallbackora sono astratti. In questo modo è possibile eseguire il wrapping di unDataSourceo testare direttamente unDataSourcecon un callback fittizio. b/72600421 - Mapper per DataSource e DataSource.Factory
map(Function<IN,OUT>)consente di trasformare, aggregare o decorare i risultati caricati da unDataSource.mapByPage(<List<IN>,List<OUT>>)consente di fare lo stesso per l'elaborazione batch (ad esempio, se gli elementi caricati da SQL devono eseguire query aggiuntive su un database separato, l'operazione può essere eseguita come batch).
PagedList#getDataSource()viene aggiunto come metodo di convenienza b/72611341- Tutte le classi ritirate sono state rimosse dall'API, inclusi i resti del pacchetto
recyclerview.extensionseLivePagedListProvider. DataSource.Factoryviene modificata da un'interfaccia a una classe astratta per abilitare la funzionalità della mappa.
Correzioni di bug
- Modifica dei builder in modo che siano finali. b/70848565
- L'implementazione di Room
DataSourceè stata corretta per gestire le query su più tabelle. Questa correzione è contenuta in Room 1.1.0-beta1, vedi sopra. - È stato corretto un bug per cui
BoundaryCallback.onItemAtEndLoadednon veniva richiamato perPositionalDataSourcese i segnaposto erano abilitati e la dimensione totale era un multiplo esatto della dimensione della pagina.
Versione 1.0.0-alpha5
22 gennaio 2018
Correzioni di bug
- Risolvi il problema di caricamento della pagina quando i segnaposto sono disattivati b/70573345
- Logging aggiuntivo per rintracciare il bug IllegalArgumentException b/70360195 (e correzione speculativa lato Room)
- Correzioni del codice campione Javadoc b/70411933, b/71467637