*** Snapshots and Pre-Releases for FlexibleAdapter v5.0.0 ***

davideas / FlexibleAdapter

Fast and versatile Adapter for RecyclerView which regroups several features into one library to considerably improve the user experience :-)

Apache License 2.0

3.55k stars 548 forks source link

* Snapshots and Pre-Releases for FlexibleAdapter v5.0.0 * #39

Closed davideas closed 6 years ago

davideas commented 8 years ago

This is an open discussion to keep track of all the work in progress of the next coming pre-releases in order to arrive to a stable and final version.

In this major release (5.0.0) there will be lot of new features, while trying to simplify the configuration to speed up the development. A full list of the features and improvements, with their status, can be found here Milestone 5.0.0. However we can identify them in:

Expandable item with selection coherence.
Predefined ViewHolders.
Adapter Animations.
Drag&Drop and Swipe actions.
New concept of Item.
Simplify the constructor.
New FastScroller to include in the library.
Rewrite filtering and restore methods.
Headers/Sections
etc..

In order to do them, I am completely changing and refactoring the code, names and how the Adapter will be extended to override its methods.

Gradle configuration

allprojects {
    repositories {
        // For [pre-]releases
        jcenter()
        // For SNAPSHOT
        maven { url "https://oss.sonatype.org/content/repositories/snapshots/" }
    }
}

// Don't cache SNAPSHOT (changing) dependencies.
configurations.all {
    resolutionStrategy.cacheChangingModulesFor 0, 'seconds'
}

dependencies {
    // JCenter for PreReleases
    compile 'eu.davidea:flexible-adapter:5.0.0-rc3'
    compile 'eu.davidea:flexible-adapter-livedata:1.0.0-b1'
    compile 'eu.davidea:flexible-adapter-databinding:1.0.0-b2'

    // Maven for SNAPSHOT
    compile ('eu.davidea:flexible-adapter:5.0.0-SNAPSHOT') {
        changing = true;
    }
}

As soon as a new SNAPSHOT is ready and usable I will communicate it here.

Suggestions

Feel free to Fork but better to advise me in advance what are you going to modify in order to coordinates the commits and the work.
Also, feel free to test and report back here or by opening a new Issue.

Naming convention adopted

Version	Reason for publishing	Description
`5.0.0-SNAPSHOT`	continuous development	A library with many changes that might be unstable, nice to have to early benefit of the latest bug fix, improvements and new features as soon as they are implemented. It will replace the existent library (with that name) in the maven snapshot repository. So you don't have to manually change the version in the dependencies, but expect to upgrade your code in order to continue to compile your project. Gradle has internal caching system with default time of 24h. Passed this time it will fetch the new Snapshot file from repository, if a new exists.
`5.0.0-bX`	beta pre-release	Usable beta library with some new features to test.
`5.0.0-rcX`	release candidates	Nearly completed library with good stability and improved features
`5.0.0`	release	The stable library with all new features confirmed and tested.

davideas commented 8 years ago

While importing the library v5.0.0-b2 in another project, I got some difficulties implementation. Please be patient since I am working hard to simplify them for next beta: I'm changing the signature of the classes and reviewing the Item interfaces.

davideas commented 8 years ago

New pre-release v5.0.0-b3 with new functionalities, many fixes and improvements. (You can download the apk from the release page). Now it is really usable. Suggestions are welcome.

dependencies {
    compile 'eu.davidea:flexible-adapter:5.0.0-b3'
}

For next pre-release:

I will focus on header/sections methods to work in combination with add/delete/move item that is attached to.
I will add sticky functionality.
I will evaluate to create more interfaces like IFilterable, IAnimable for Items.
I would like to review the Restore, because it doesn't work well in all situations.

davideas commented 8 years ago

New 5.0.0-SNAPSHOT.

Fixes

Fixed crash problem with SelectAll and improved method logic.
Fixed last expandable item in expandAll().
Restoring all items, now it's much faster in case of restoreSelection is enabled.

Headers

Headers are shown/hidden during expand/collapse if they belongs to children.
Headers work in combination with restore items, in all situations (... the ones I have foreseen).
Headers can also be deleted and restored in any situations: they are relinked all the time with the item below it.
Headers can be dragged, swapped and receive the new swapped item.
Support to swap headers only.

Others additions and improvements

FlexibleAdapter is not anymore abstract.
Added support for AndroidStudio 2.0 InstantRun: updated Gradle plugin.
Added support for isSelectable() it should now be usable.
Added methods addSubItems() and addAllSubItemsFrom().
Transformed all "add" methods in a chain of calls. Modified the signature of getCurrentChildren() to accept an IExpandable object.
Added minimal support for isEnabled().
Completely changed the logic how a removed item saves restoration info (now a removed item has an internal reference that should never fail, adjustRemoved() became obsolete and has been removed).
Included in the library Utils class the method setHighlightText() Useful to highlight text coming from a search action.
Made a better use of Payload when notifyItemChanged is triggered.

davideas commented 8 years ago

Note: Currently Headers are ISectionable objects containing the attached item which is updated if an event on this item occurs, the headers are scanned to identify if one of them has that item and so it is updated. I'm thinking/working to invert how a header is recognized and assigned, in such way: any item can be an ISectionable object containing the reference to another item that WILL BE the Header. This could simplify the logic and reduce bugs and maintenance, I need to analyse this point.

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published. Related Apk is avalable under the latest release.

Refactor IFlexibleItem to IFlexible. Sorry for this, but it's now more coherent with the others interfaces names.

Improvements Cast optimization: removed unnecessary 8 casts by changing some parameters of methods from generic object T to IFlexible and IExpandable types, this should be transparent.

Headers

Finally, I have evaluated better the Headers/Sections items and decided to invert how a header is created and recognized by the Adapter. Benefits of this change:

It reduces maintenance and potential future bugs, It should have higher performance Less memory usage (removed the internal list of headers).
IHeader interface has been added to identify the fact the item is a Header item.
ISectionable interface now has to be assigned to the items(!!) in order for them to hold the reference to the IHeader item.
Dragging items, it automatically re-links the header in almost all situations (the logic can be improved).
Deleting all items under a header, when the headers are visible and hidden, it makes the header orphan, an option has been added to delete the orphan headers as well. Currently the orphan headers, ones hidden, cannot be shown anymore (they are lost, food for the gc), you should re-link it manually (I might create a list of orphan headers and create some methods around that list, I need to analyse this point).

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published. Related Apk is available under the latest release.

Filter Added IFilterable item interface. New clean way to filter items, Items now can implement filter() method in order to be collected for the filtered list.

Headers Added support for Orphan Headers.

Fixes Fixed hidden header silent un-linkage when deleting an item with a header.

davideas commented 8 years ago

New pre-release v5.0.0-b4 with new functionalities (Sections and Sticky headers included) and lot of improvements. (You can download the apk from the release page).

dependencies {
    compile 'eu.davidea:flexible-adapter:5.0.0-b4'
}

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published.

Headers

Now headers are checked to be shown when adding items.
Added getItemCountOfTypesUntil() useful to retrieve the correct position where to insert the new items.
Added removeItemsOfType() removes only specific items by type

farfromrefug commented 8 years ago

Wanted to say how amazing that lib is! Just discovered it and already digging it a lot. I forked it so will try to help as much as i can. Thanks

davideas commented 8 years ago

@farfromrefug Thanks a lot! I'm working hard.

Feel free to Fork but be sure to modify the dev branch. Also, advise me in advance what are you going to modify in order to coordinates the commits and the work.

boldijar commented 8 years ago

Hello. I think that it would be better if the examples are completely separated. Currently i'm trying to understand how the sticky headers work in the beta version, and it's pretty hard.

Awesome lib btw.

davideas commented 8 years ago

Yes @BoldijarPaul, thank you for your message, another Activity showing how headers/sections work has to be done, and not only that, however, I have very few time in this period, maybe in April or later.

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published. Related Apk is available under the latest release.

Refactor setHeader(header) in ISectionable interface is changed to void method.

Headers

Now headers are clickable when sticky! StickyHeaders can now benefit of the existing click listeners in FlexibleViewHolder.
StickyHeaderDecoration is now deprecated, as consequence enableStickyHeaders(maxCachedHeaders) is also deprecated: use enableStickyHeaders().
Pay attention at the method getStickySectionHeadersHolder() (comment is exhaustive).

Improvements Multiple code improvements with SonarQube tool, thanks to @georgekankava

Fixes Fixed NPE in isEnabled(position) when position is unknown.

maxoreli commented 8 years ago

Good job davideas. On Mar 26, 2016 8:19 PM, "Davide Steduto" notifications@github.com wrote:

New 5.0.0-SNAPSHOT has been published. Related Apk is available under the latest release https://github.com/davideas/FlexibleAdapter/releases.

Refactor setHeader(header) in ISectionable interface is changed to void method.

Headers

Now headers are clickable when sticky! StickyHeaders can now benefit of the existing click listeners in FlexibleViewHolder.

StickyHeaderDecoration is now deprecated, as consequence enableStickyHeaders(maxCachedHeaders) is also deprecated: use enableStickyHeaders().

Pay attention at the method getStickySectionHeadersHolder() (comment is exhaustive).

Improvements Multiple code improvements with SonarQube tool, thanks to @georgekankava https://github.com/georgekankava

Fixes Fixed NPE in isEnabled(position) when position is unknown.

— You are receiving this because you are subscribed to this thread. Reply to this email directly or view it on GitHub https://github.com/davideas/FlexibleAdapter/issues/39#issuecomment-201913207

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published.

Refactor Refactored constructor of AbstractSectionableItem that now accepts the IHeader item.

Headers

The Adapter now supports an IHeader item combined with IExpandable item.
Added AbstractExpandableHeaderItem, an Expandable section item with Header ready to be used.
Added a new Wiki page about how to implement sections with sticky headers and expandable sections. Direct link: Headers and Sections.

Improvements Added new method hasNewSearchText().

Fixes

Fixed header linkage when deleting/restore items with header. It's important now that all sectionable items must initialize the own header at startup.
Bug fixing on SearchView and FilterMethods.
Resolved crash bug when the sticky header is collapsed by preventing new header to be sticky. RecyclerView raised an exception not under my control.

Demo App

Added an example of FlexibleItemHolder to use simultaneously the same modelData object in multiple RecyclerView/Adapters.
New example app supporting multiple fragments #19. Use of NavigationView and VectorDrawables.
Adapted code for Expandable Sections with headers. Enabled demo option for FragmentExpandableSections.
Demo app has more clear DatabaseService. It shows how to create item interfaces.
Unfortunately the demo app has an unknown bug on FastScroller when changing Fragment, but FastScroller is planned to be changed.

davideas commented 8 years ago

New pre-release v5.0.0-b5 many improvements and fixes. (You can download the apk from the release page).

dependencies {
    compile 'eu.davidea:flexible-adapter:5.0.0-b5'
}

For the next beta(6), I will focus on Endless Scrolling, Helpers and a new FastScroller.

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published. Related Apk is available under the latest release.

Deprecation

Removed isSelected() and setSelected() from IFlexible interface
Deprecated and removed getSectionableOf() in favor of the new getSectionItems().
Improved instance state on rotation.

Improvements

New methods: addSection(), addItemToSection() (not tested yet).
Modified DividerItemDecoration to show a gap between the sections #60.
Improved isEnabled() on IExpandable items.

Multi-level expansion

Added possibility to chain Expandable items into others expandable.
Item restoration works in multi-level expansion: expanded children are forced to collapse before restoration.
Selection coherence in multi-level expansion.

FastScroller

Added a small gap between bubble and handle.
Auto handling a change of a new LayoutManager when FastScroller is configured. Now FastScroller should work in every situations.
Added SmoothScroll for GridLayoutManager and optimized smooth scrolling classes.

Fixes

Fixed the delay on the 1st item when animating the view.
Fixed inconsistency bug when expanding/collapsing sticky header items not fully visible:
Fixed StickyHeaders with GridLayoutManager when all sub-items of a section fit the single row of span count #61.
Fixed NPE when setting a null FastScroller instance #66.

Demo App

Big code reorganization using fragments (unfinished!)
Fixed issue #64 for demo app for API < 23.

davideas commented 8 years ago

New pre-release v5.0.0-b6 many improvements and fixes. (You can download the apk from the release page). With this pre-release, the code is available in master branch as well.

dependencies {
    compile 'eu.davidea:flexible-adapter:5.0.0-b6'
}

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published. Related Apk is available under the latest release.

Deprecation

Experimenting TreeSet instead of ArrayList for mSelectedPositions. As consequence getSelectedPositions() returns a copied List from the Set (already sorted, no duplication)!

Improvements

Dragging and swiping can be enabled by type #80. Items are NOT Draggable and Swipeable by default.
Added new method getItemTouchHelperCallback() to customize Swipe and Drag behaviors.
Added class UndoHelper.SimpleActionListener to simplify the development.
Utils.colorAccent is now public.
Better selection management: made public addSelection(), removeSelection().
Upgrade to SupportLib 23.4.0

Fixes

Fixed ArrayIndexOutOfBoundsException with StaggeredGridLayoutManager #87.
Fixed headers showing after rotation #88.
Fix for StaggeredGridLayoutManager in DividerItemDecoration.
Fixed addItemToSection when Header is hidden: item is now added to the unique visible list.

Demo App

Fix for SwipeRefreshLayout to be displayed on the top of StickyHeaders Layout #83.

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published. Related Apk is available under the latest release.

Deprecation

Refactored method moveItem() to swapItem().
Separated the initialization of expanded items at start up #86: expandItemsAtStartUp() must be explicitly called by the user in Activity creation phase, expandItemsAtStartUp() method now uses the existent expand() method with initialization info.

Improvements

Alpha animation, when enabling / disabling sticky headers.
Added new method moveItem() that simply moves an item without swapping them.
Added method calculatePositionFor().
Improved method updateDataSet(), optionally items can be animated, when false a notifyDataSetChanged() will be executed.
Chaining the Adapter for all initialization and configuration methods (sets).
Added calculatePositionFor() useful for new items of every type, a custom Comparator is needed.
Added applyAndAnimateMovedItems() when using animateTo() (in filter and updateDataSet()).
Added new base interface OnActionStateListener for OnItemMoveListener and OnItemSwipeListener to overcome the drag issue with the SwipeRefreshLayout, issues #104 and #83.
Added full support for StaggeredGridLayout #107
Added possibility to change mode how DividerItemDecorator is drawn, over or (default) underneath the item #106
onUpdateEmptyView() is now called only if there was a change from 0 / to 0 itemCount #113
Added 2 new overload methods for expand() series #110.

Fixes

Temporary solution to improve ViewHolder with sticky behaviour, (user has to pass true as new parameter to the FVH super.constructor). Issues #78, #79 and #92. THIS IS NOT YET THE FINAL SOLUTION.
Fixed hidden status when removing a Header item.
Removed useless call in onChanged(), causing duplication of subItems when updating the data set, issues #95 and #96.
Fixed #94 - Item does not updated after updateDataSet().
Fixed NPE bug #103 during filter and null subList.
Fixed expansion status after filtering expandable items.
Fixed animation changes.
Adjusted selection flags when removing items and fixed small bug when restoring items after applying the filter and vice-versa.
Filter on restore instance state bug #111
Small bug in highlightText #112

Demo App

SwipeRefresh with StickyHeader is not compatible with Dragging feature, added comments in the layout to show the difference #83: User must disable the SwipeRefreshLayout programmaticaly, to do it, I added a new callback function and relative listener OnActionStateListener.
Adjusted demo App behavior when filtering with Endless Scrolling
Minor changes in the demo App.

davideas commented 8 years ago

Road map for final release:

[x] Soon, I will create a new pre-release beta7 that I will publish to the master branch after a small period of test including all the recent fixes from the last Snapshots. - After this pre-release I will try to add as much documentation as possible in the wiki pages.
[x] Since library is becoming more and more stable, I will evaluate to create the release-candite rc1 after beta7 - This rc1 will include a new way to set the background programmatically for different state and with ripple included - I will create an "Animator Helper" or a new easy way to add adapter/scrolling animation - Also ItemAnimators have to be reviewed to be coherent with the overall animations, this will add the possibility to have nice effects when expanding/collapsing subItems different from any other item addition/removals. - I will add more Fragment demos for several use cases (to cover merging & splitting / checkBoxes / radioBoxes / calculatedPosition insertion / IHolder / butterKnife / headers & footers).
[ ] Before a final release another release-candidate rc2 might be created - For an eventual rc2, I will try to add some unit tests (I know, I had to do them before starting any piece of code).

briangbrown commented 8 years ago

Looks like a sweet library. I'm going to start using this on a new project today. Thanks!

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published. Related Apk is available under the latest release.

Deprecation and Refactoring

Deprecated method addSection() with refHeader.
Refactored class signature for IHeader and IExpandable and their abstract implementation.

Improvements

Added DrawableUtils to manage the background Drawables at runtime without XML configuration #35.
Added new method addSection() with Comparator object.
Improved the methods addItemToSection() see JavaDoc.

Fixes

Method onUpdateEmptyView() is now called when passing null or empty new list in updateDataSet().
Fixed #112 - NPE on originalText in Utils.hightlightText().
Merge Fixed #116 - Header View params > Item view params
Fixed #117 - Constraint on FlexibleViewHolder when using StickyHeader functionality, as consequence changed class signature of IHeader item interface and its implementation. Also changed the class signature of IExpandable item interface and its implementation to have a ViewHolder of type ExpandableViewHolder as well.

Demo App

Added new example Fragment for StaggeredLayout with multiple functionalities:
- merge/split items at runtime (position are recalculated);
- move item with animation taking care of the groups using the new function calculatePositionFor();
- automatic sorting when adding new items using the new function addItemToSection();
- example of Comparator object;
- change Drawable background at runtime, maintaining the ripple effect (no XML is used).

davideas commented 8 years ago

New pre-release v5.0.0-b7 many improvements and fixes. (You can download the apk from the release page).

dependencies {
    compile 'eu.davidea:flexible-adapter:5.0.0-b7'
}

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published. No Apk of this version is provided.

Deprecation and Refactoring

Refactoring behaviour of setPermanentDelete(): default value starts with true. Creating the UndoHelper instance, the value will be set to false automatically.

Improvements

Added @since for all methods.
Added new method getSectionItemPositions(). It resolves #132.
Added new method setAnimateToLimit().
Improved performance while filtering high numbers of items. This resolves #133 part 1: call notifyDataSetChanged(). Animation during filtering will be performed if the total items are below the limit of 600 (modifiable value) "current items" OR "filtered items"; Above this limit, notifyDataSetChanged() will be called with no animation. Note: updateDataSet() is also affected by this limit, it improves performance during the refresh operation with big list.
Option to display entry animation only. See #125.
Method in FlexibleViewHolder.setDragHandleView() is not final anymore!
Improvement performance when resetting filter flags for Expandables.
Upgrade to Android N (API 24), SupportLib 24.0.0, Java8.
Reviewed the comments for AutoMap.

Fixes

Fixed #130 - An unnecessary call to super.onBindViewHolder() caused loop-calls throwing StackOverflowError. As consequence, method onLoadMore() is now protected to be manually called only when METHOD B (binding items in classic way) is implemented.
Fixed #128 - getStickySectionHeadersHolder() should return a ViewGroup with LayoutParams coherent and initialized by the user who knows how these params has to be initialized. An exception will be raised if params are nulls.
Fixed #126 - onUpdateEmptyView() is not being correctly called in updateDataSet() if size > 0.
Fixed #121 - Sticky header glitch when header layout has height set to "wrap_content"
Modified FastScroller bubble padding.

Demo App

BackPressed now goes back to overall View. App entry fade animation?
StaggeredLayout is the default at startUp.
Using Method B to bind the FragmentOverall instead of the AutoMap view item interfaces.
Fixed bug that triggered the filter when searchView is initially opened.

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published. This time the Apk is available under the latest release. It includes all the changes of the previous SNAPSHOT plus the following.

Deprecation and Refactoring

Refactored shouldAnimate default value from true to false. Items are not animated anymore by default, you need to enable the scrolling animations with .setAnimationOnScrolling(true).
When setOnlyEntryAnimation() is set true, shouldAnimate is automatically set true, however when the screen is filled with last visible item, shouldAnimate is again false.
Marked some methods with //TODO: deprecation?. Those methods are under evaluation and could disappear in the final release.

DividerItemDecoration

Added new method withOffset().
Fixing NPE when no divider is provided.
Fixed normal item offset.

Improvements

Added new method setNotifyMoveOfFilteredItems().
Experimental: Added AsyncTask with synchronization animations. Fixed #133 part 2: AsyncFilter. Really lot of items can be filtered in a very short time. Adapter need to be configured accordingly, new Fragment in the demoApp helps to understand how to.
Experimental: updateDataSet() is now run Asynchronously too.
Experimental: Improved performance when collapseAll() with big list.
Experimental: Improved performance on showAllHeader() and hideAllHeaders().
Added Payload enumeration, this resolves #134.
New methods in Utils class findFirst/LastCompletelyVisibleItemPosition().

Fixes

Fixed #143 - calculatePositionFor() doesn't work correctly when used for addItem().
Fixed #142 - 1st item is displayed under sticky header at start up and after updateDataSet().
Fixed #139 - Sticky header is not resized on automatic configuration change.
Fixed #135 - The AsyncTask changes made obsolete the fix of missing parenthesis generating a NPE.
Fixed filter: when no headers are displayed, headers were displayed too. Now the result is coherent with the last state.
Fixed some NPEs when null is passed to the constructor.
Fixed scrolling animation flags.

Demo App

Experimental: Added a real(!) SplashActivity.
Added new FragmentAsyncFilter, here you can customize the Adapter and the database dynamically.
Added DatabaseType enumeration and created ConfigurationDatabase.
Changed layout for drawer and updated the menu with check boxes.

davideas commented 8 years ago

New 5.0.0-SNAPSHOT has been published. The Apk is available under the latest release. It includes all the changes of the previous SNAPSHOT plus the following.

Deprecation and Refactoring

Enabled shouldMoveItem() callback in OnItemMoveListener.

Improvements

144 - Adapter initialization and updateDataSet() with no notifyItemXXX() on headers.
146 - Improved calls to setDisplayHeadersAtStartUp() and showAllHeaders() to avoid duplication of headers by a non correct initialization. As consequence 2 effects are now possible when calling setDisplayHeadersAtStartUp() read method comment, documentation will follow.
Adapter can be initialized with a null or empty list: addItems() can be safely called, but no scrolling animation on loading can be performed.
Expand items at startup can now expand all Levels of Expandable, if expanded is initially set true. updateDataSet() is also compatible with the last status of sub levels.
Added AnimationDuration (configurable) for Drag and Swipe.
151 - Added SmoothScrollStaggeredLayoutManager + configurable millisecondsPerInch.

Fixes

Fixed #148 - Support for Drag&Drop in GridLayout with Automatic header linkage and headers rebound.
Fixed #143 - calculatePositionFor() doesn't work correctly when used with addItem().
When sticky header is enabled, element header at position 0, can now be dragged: layout for sticky header is cleared out, before it was not possible.

Demo App

Reviewed menu items options with check boxes.
Added menu item for toggleFastScroller()
Added menu items persistent through some example fragments.
- For update data set (refresh to see different result);
- For scrolling animation (reopen the page from the drawer menu to see different result).
More JUnit test for ItemComparator
Fixed NPE when closing app before the execution of Runnable.
Resolved the problem when Layout for sticky header is customized and the header disappeared.

davideas commented 8 years ago

New pre-release v5.0.0-b8 many improvements and fixes. (You can download the apk from the release page).

dependencies {
    compile 'eu.davidea:flexible-adapter:5.0.0-b8'
}

frozts91 commented 8 years ago

Hi davideas, i get this error while i add your library to my project.

Error:(24, 13) Failed to resolve: eu.davidea:flexible-adapter:5.0.0-b8

i use jcenter for repository

I've figured it out, at url

https://dl.bintray.com/davideas/maven/eu/davidea/flexible-adapter/

version b8 not exists, thats why gradle report error

davideas commented 8 years ago

@frozts91, now should work as normal. The plugin didn't upload at the correct position, before.

davideas commented 7 years ago

New 5.0.0-SNAPSHOT has been published. The Apk is available under the latest release. It includes the release beta8, plus the following.

Improvements

Issue #168 - Added Info log for parameters and listeners initialization (to see, enable logs as usual).
Issue #176 - Drop event, without swapItems on move (ItemTouchHelperCallback can now be set).
Issue #179 - Added method to manually set a stickyContainer ViewGroup to use mostly in ViewPager.
Issue #190 - Added method to change the SnackBar Action color.
Issue #198 - Added onPostFilter() and onPostUpdate() that allow to modify the list just after the Asynchronous filter and update.
Added new methods to support DiffUtil and to animate changes with this new Android class, after an update or filter operations, BUT it's strongly suggested to use the default calculation. See demoApp in Async Filter example to compare the 2 solutions: the Default results faster at least of the double!

Fixes

Fixed #184 - Problem with endless scrolling and LOAD_MORE_RESET delay.
Fixed #191 - AsyncFilter fatal error (Empty string will skip the search).
Fixed #210 - Problem with item content change animation.
Resolved the high delay for scroll animation on the first visible item after rotation.

Demo App

Added example with ViewPager.
Added example for Item Model Holder.
Added option for DiffUtil in Async Filter example, to compare the 2 solutions implemented. (Refreshing the some lists will update the subtitle of the items, with the numbers of the refreshes).

davideas commented 7 years ago

New 5.0.0-SNAPSHOT has been published. The Apk is available under the latest release. It includes the release beta8, all previous points, and the following.

Improvements

Added methods clear() and clearAllBut(viewTypesToRetain), see #201.
Added method addItem(item), see #201.
Reviewed how the internal Handler can be overridden: new internal class HandlerCallback has been created.
Optimized selection coherence for a parent with a selected sub item at any level.
Reviewed javaDoc.

Fixes

Fixed collapsing bug for a parent with selected sub items.
Fixed #229 - Calling hideAllHeaders() might lead to NullPointerException (Fixed NPE and modified behavior when hiding headers: now, it doesn't disable anymore the sticky flag)

davideas commented 7 years ago

New 5.0.0-SNAPSHOT has been published. The Apk is available under the latest release. It includes the release beta8, all previous points, and the following (rc1 ready).

Note: If you come from previous versions, update your code following the Wiki page Migrations.

New features

Resolves #236 - Scrollable Headers and Footers: items that lay respectively at the top and at the bottom of the main items.
Resolves #233 brand new Endless Scrolling with pageSize and targetCount. Wiki page will be adapted shortly, for the moment, check the demoApp code.

Deprecation and Refactoring

Refactored and Deprecated all marked methods in issue #200.

Improvements

Resolves #227 - Elevated header items and Elevated sticky header items.
Resolves #248 - Surgery precision for transparency and elevation for sticky headers.
Resolves #228 - No XML layout configuration for sticky headers.
Resolves #201 - Added method shouldNotifyParentOnClick().
Runtime background, changing state has short enter-exit fade animation.
Added version log at startup and Info on animation when changing LayoutManager.
Upgrade to API 25 and Android Studio project to 2.2.3.
Selection methods clearAll() and selectAll() don't notify change anymore.
Added new method getAllBoundViewHolders().
Imported the last ActivatedPosition in the ActionModeHelper, which has a new method: getActivatedPosition()

Fixes

Fixed #244, header item doesn't swap if it matches with the first layout position.
Fix for adjustSelection() when adding new items and some items are already selected.
Decided to adopt Solution 2 for scrolling animation; Solution 1 has been removed. Fixed a couple of scrolling animation issues, now scrolling are animated properly in all situations. Scrollable Headers will now scroll animate. Scrollable Footers cannot scroll animate, when inserted the very first time.

Demo App

Removed some calls of deprecated methods.
Modified demoApp to showcase Scrollable Expandable Headers and Footers.
Modified demoApp to showcase the new Endless Scroll.

davideas commented 7 years ago

First release candidate v5.0.0-rc1: new features, improvements and fixes. (You can download the apk from the release page).

dependencies {
    compile 'eu.davidea:flexible-adapter:5.0.0-rc1'
}

davideas commented 7 years ago

New 5.0.0-SNAPSHOT has been published.

Improvements

Added generic type param when returning FlexibleAdapter object
Resolved #269 - Setting to load more at startup when adapter list is initially empty/null.
Resolved #281 - Delegate spanSize to IFlexible item
Resolved #288 - UndoHelper.remove(...) return type reverted to Snackbar

Fixes

Fixed #268 - Sticky headers don't work when all headers are initially collapsed
Fixed #284 - removeAllScrollableFooters() seems to notify incorrect item range

davideas commented 7 years ago

New 5.0.0-SNAPSHOT has been published.

Improvements

Resolved #293 - getItemViewType now returns zero when item not found.

Fixes

Fixed #291 - progressItem not hidden automatically if delay is zero and no items loaded or Endless is disabled.
Fixed #292 - HandlerCallback mistakenly erases default Runnables posted on it's mHandler.
Fixed #294 - Expandable header is not resized / redrawn on automatic configuration change when sticky headers are enabled.
Fixed #295 - Items not notified on auto collapse (using normal List instead of Hash to avoid Inconsistency detection. It will be slower on big List when collapsing).
Fixed #296 - autoCollapseOnExpand(true) seems not notify the header.
Fixed #297 - Empty (Invisible) Header Item when Using Sticky Headers
Fixed #299 - ClassCastException after click on expanded sticky header when AutoCollapse is enabled.
Fixed #322 - Loop in getSectionItemPositions().

davideas commented 7 years ago

New 5.0.0-SNAPSHOT has been published.

Note: With this update you MUST review your code, see deprecations below here and if you come from previous versions/snapshots, update your code following the Wiki page Migrations.

The Apk is available under the latest release. It includes the release rc1, all previous points, and the following:

Deprecations / New Behaviors

Adapter now makes a copy of the provided list at startup, updateDataSet and filterItems, before applying features (from support #316), as consequence you should remove the copy of the list in these 3 situations.
onPostUpdate() and onPostFilter() now require to call super() otherwise the emptyView won't get notified!
Starting or resetting the Filter will empty the bin of the deletedItems (see #341 and #342).

Improvements

Resolved #34 - New Customizable Fastscroller is now available, thanks to arpinca.
Optimized updateDataSet() and filterItems(): now hidden items are restored before applying the feature, so they won't get notified for removing and adding same items, but only for updating. This will improve performance avoiding useless notifications.
Resolved #259 - Endless scrolling in both directions. If activated, items can only be inserted at the top of the list, top endless is complementary to the bottom endless.
Resolved #293 - getItemViewType now returns zero when item not found.
Resolved #321 - Now Items can have option to be notified for a change if unfiltered.
Resolved #333 - StateListDrawable with state_pressed for API < 21.
Resolved #339 - Sticky headers in filtered list (might be removed if creates new issues). (https://github.com/arpinca).
Created new method isFiltering(), returns true if the AsyncTask is currently running.
Created new method getCurrentItems(), returns the current internal list unmodifiable.
Added unit tests for updateDataSet()
Increased ANIMATE_TO_LIMIT to 1000 items.
Support lib to 25.3.1 (from question #331).

Fixes

Fixed #320 - point 1) Sometimes the sticky header view losses it's background.
Fixed #320 - point 2) Sometimes the sticky header is not shown correctly when is being collapsed.
Fixed #328 - Filtering issue during delete search query (make sure index is in bounds).

Notes

Sample App has new package signature, please manually uninstall the previous to avoid duplication.

davideas commented 7 years ago

New 5.0.0-SNAPSHOT has been published.

Note: With this update you MUST review your code, see deprecations below here and if you come from previous versions/snapshots, update your code following the Wiki page Migrations.

The Apk is available under the latest release. It includes the release rc1, all previous points, and the following:

Deprecations / New Behaviors

Resolved #344 - Get rid of Method B to create and bind ViewHolders. From now on, we will use only Method A: we will delegate the previous operations to the item interfaces. Item interfaces will now mandatory implement the following methods: getLayoutRes(), createViewHolder() and bindViewHolder().
Renamed DividerItemDecoration to FlexibleItemDecoration.
Renamed Utils to FlexibleUtils.

Improvements

Resolved #302 - Allow to use custom LayoutManagers on the RecyclerView.
Resolved #348 - Customizable minimum scroll amount to show the FastScroller.
Resolved #348 - FastScroller can now be enabled/disabled at runtime again with a better toggle to enable/disable FastScroller.
Resolved #343 - Allow to unbind ViewHolder.
Resolved #357 - Allow usage of Parcelable for IHeaders and IFlexible.

Fixes

Fixed #352 - Multilevel expandable list - Sub-Sub-Items are now filtered
Fixed #350 - LayoutManager is now independent to be initialized before/after setting adapter.
Fixed #347 - Sticky Header doesn't update selected view state correct for Single & Multi selection.

DemoApp

Modified demoApp to not show LayoutInfo at each use case.
Fixed ButterKnife binding.

Notes

If swipe does not properly animate: please be sure that FrontView is at lower level in the layout to support API < 21.

davideas commented 7 years ago

Second release candidate v5.0.0-rc2: new features, improvements and fixes. (You can download the apk from the release page).

dependencies {
    compile 'eu.davidea:flexible-adapter:5.0.0-rc2'
    compile 'eu.davidea:flexible-adapter-databinding:1.0.0-b1@aar'
}

davideas commented 7 years ago

New 5.0.0-SNAPSHOT has been published.

Deprecations / New Behaviors

Resolved #393 - Provided last sticky header position in the callback OnStickyHeaderChangeListener.
Resolved #400 - Removal of all deprecated functions.
setStickyHeaderElevation now accepts only dpi value.
Added getBubbleText() in IFlexible. For who inherits from AbstractFlexibleItem, this change has default implementation returning position + 1. For who implements directly from IFlexible this method must be implemented.

Improvements

Resolved #397 - Support for fully recursive lists (expansion, collapsing, and update).
Resolved #401 - Multilevel option to collapse or keep expanded status to sub-expandables.
SmoothScroll layout managers now implement IFlexibleLayoutManager.
BubbleTextCreator can be set in FastScroller.
Added Log when attaching/detaching RecyclerView.

Fixes

Fixed #387 - Proguard issue with "SourceCode" and line numbers.
Fixed #389 - Removed advancement of position beyond subItems such that now all subItem positions will be checked for nested expansion during update.
Fixed #392 - FlexibleItemDecoration withOffset not working correctly for section headers (use of spanSize).
Fixed #394 - Add subItem doesn't account for others expanded subItems.
Fixed #395 - Use of MarginLayoutParams instead of LayoutParams when init StickyHeadersHolder layout.
Fixed #404 - Expandable Sticky Header becomes invalid after updateDataSet.

davideas commented 7 years ago

New 5.0.0-SNAPSHOT has been published. The Apk is available under the latest release. It includes the release rc2, all previous points, and the following (rc3 ready).

Note: If you come from previous versions, update your code following the Wiki page Migrations.

New Behaviors

Resolved #430 - FlexibleAdapter auto-mapping is now based on the return value of getItemViewType in IFlexible. This gives flexibility to reuse same Layout for multiple item types as explained in #430. For who inherits from AbstractFlexibleItem, this change is transparent. For who implements directly from IFlexible this method must be implemented.

Temporary Revised `UndoHelper`

⚠️ Warning: This is a temporary state of work and might change in the near future, depends by the work in progress to support the new swipe capability.
Resolves #438 - Deprecated OnActionListener in UndoHelper also onPreAction() and onPostAction().
New comprehensive methods name: Renamed the 2 callbacks methods in OnUndoListener and renamed also the method remove series:
.withAction(int action, OnActionListener listener) >>> .withAction(@Action int action)
.remove(...) >>> .start(...) // Still returns Snackbar object

OnActionListener >>> !!deprecated!! // Please read related javaDoc

OnUndoListener.onDeleteConfirmed(int action) >>> onActionConfirmed(@Action int action, int event) OnUndoListener.onUndoConfirmed(int action) >>> onActionCanceled(@Action int action)

- Resolves #434 - Consecutive Undo requests option & improved the general stability. New method to commit one by one the swiped items and undo only the latest action. Also, it will clear the internal memory references at the end of the dismissal event!
``` java
.withConsecutive(true/false) // Default value is false (accumulate items to undo)

Added the type of event with the following cases:


onActionConfirmed(@Action int action, int event);

DISMISS_EVENT_SWIPE = 0; // Snackbar was dismissed via a swipe.
DISMISS_EVENT_TIMEOUT = 2; // Snackbar was dismissed via a timeout.
DISMISS_EVENT_MANUAL = 3; // Snackbar was dismissed via a call to dismiss().
DISMISS_EVENT_CONSECUTIVE = 4; // Snackbar was dismissed from a new Snackbar being shown.
While the onActionCanceled is always called because of event type "action" only (user pressed on snackbar action button) and therefore not provided.
```
onActionCanceled(@Action int action);
```
DISMISS_EVENT_ACTION = 1; // Snackbar was dismissed via an action click.

Improvements

Resolved #450 - New method highlightWords().
Resolved #443 - highlightText() with multi-span in same text.
Resolved #437 - Upgrade to Support Library v26.
Resolved #431 - CustomTags: Different TAGs for each Adapter instance.
Resolved #428 - Option to disable swipe/drag capabilities when ActionMode is activated.
Resolved #427 - Dynamically add and remove listeners.
Scripts with GrabVer.

Fixes

Fixed #409 - setEndlessScrollListener crashes when logging is enabled.

davideas commented 6 years ago

New 5.0.0-SNAPSHOT has been published.

Improvements

Upgrade to Android Studio 3.0.0 and Support Lib 27.0.2.

Fixes

Fixed #475 - Custom and default divider gone in RC3.
Fixed #477 - ExpandableViewHolder#onClick should always call super().
Fixed #481 - highlightText and highlightWords text loose the upper case during the scan.
Fixed #484 - bindViewHolder method is causing a problem with GreenDao.
Fixed #490 - Automatically fetch first result on load more, scrolls the RecyclerView.
Fixed #492 - NPE when expanding item with auto-scroll.
Fixed #499 - Sticky Header can only be updated once.

davideas commented 6 years ago

New 5.0.0-SNAPSHOT has been published. New beta2 UI and beta2 LiveData extenstions.

Improvements

Resolved #384 - Ability to recognize child (👶) view click.
Resolved #507 - New filter results callback: support for observing the current state of filtering.
Resolved #523 - Swipe delete, UnsupportedOperationException for immutable list on sort.
Resolved #540 - Multi filter: filter object can be of any type, not just String.
Resolved #543 - DiffUtil is back 😉
Added new method setHeadersShown(boolean) to manually change the flag to indicate that headers are already inserted in the main list by the user.
Removed deprecated functions in AnimatorAdapter.
Improved nullity of FastScroller instance.

Fixes

Fixed #512 - NPE in initStickyHeadersHolder on orientation change.
Fixed #521 - Fixed Sticky Headers swapping with Staggered Layout.
Fixed #516 - Better section gap when expand/collapse the last item of section.
Fixed #514 - Removed @NonNull annotation for parameter in addListener and removeListener methods.
Fixed #547 - Invalid first page number when initializing with empty list/null.
Fixed #552 - Scrollable Header appears under main items in endlessly scrolling list.

UI extension

Added EmptyViewHelper #439.

LiveData extension

Added Comparator to sort items when using FlexibleItemProvider with LiveData.

davideas / FlexibleAdapter

* Snapshots and Pre-Releases for FlexibleAdapter v5.0.0 * #39

Gradle configuration

Suggestions

Naming convention adopted

144 - Adapter initialization and `updateDataSet()` with no notifyItemXXX() on headers.

146 - Improved calls to `setDisplayHeadersAtStartUp()` and `showAllHeaders()` to avoid duplication of headers by a non correct initialization. As consequence 2 effects are now possible when calling `setDisplayHeadersAtStartUp()` read method comment, documentation will follow.

151 - Added SmoothScrollStaggeredLayoutManager + configurable millisecondsPerInch.

Deprecations / New Behaviors

Improvements

Fixes

New Behaviors

Temporary Revised `UndoHelper`

Improvements

Fixes

Improvements

Fixes

Improvements

Fixes

UI extension

LiveData extension

davideas / FlexibleAdapter

*** Snapshots and Pre-Releases for FlexibleAdapter v5.0.0 *** #39

Gradle configuration

Suggestions

Naming convention adopted

144 - Adapter initialization and updateDataSet() with no notifyItemXXX() on headers.

146 - Improved calls to setDisplayHeadersAtStartUp() and showAllHeaders() to avoid duplication of headers by a non correct initialization. As consequence 2 effects are now possible when calling setDisplayHeadersAtStartUp() read method comment, documentation will follow.

151 - Added SmoothScrollStaggeredLayoutManager + configurable millisecondsPerInch.

Deprecations / New Behaviors

Improvements

Fixes

New Behaviors

Temporary Revised UndoHelper

Improvements

Fixes

Improvements

Fixes

Improvements

Fixes

UI extension

LiveData extension

* Snapshots and Pre-Releases for FlexibleAdapter v5.0.0 * #39

144 - Adapter initialization and `updateDataSet()` with no notifyItemXXX() on headers.

146 - Improved calls to `setDisplayHeadersAtStartUp()` and `showAllHeaders()` to avoid duplication of headers by a non correct initialization. As consequence 2 effects are now possible when calling `setDisplayHeadersAtStartUp()` read method comment, documentation will follow.

Temporary Revised `UndoHelper`