Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lucasr/smoothie
[DEPRECATED] Easy async loading for Android's ListView/GridView
https://github.com/lucasr/smoothie
Last synced: 2 months ago
JSON representation
[DEPRECATED] Easy async loading for Android's ListView/GridView
- Host: GitHub
- URL: https://github.com/lucasr/smoothie
- Owner: lucasr
- Archived: true
- Created: 2012-12-25T23:54:26.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2015-01-31T23:15:39.000Z (almost 10 years ago)
- Last Synced: 2024-04-15T02:45:36.055Z (9 months ago)
- Language: Java
- Homepage:
- Size: 847 KB
- Stars: 986
- Watchers: 78
- Forks: 163
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome - smoothie - [DEPRECATED] Easy async loading for Android's ListView/GridView (etc)
- awesome - smoothie - [DEPRECATED] Easy async loading for Android's ListView/GridView (etc)
README
NOTE: Smoothie's API is not final yet. Although the library is fairly
funcional, this is still beta-quality code. Do not rely on it for production
code just yet. Feedback is very welcome!
What is it?
===========
Smoothie provides a simple API to load ListView/GridView items asynchronously, off the UI thread.
Features
========
* Tiny API to implement asynchonous loading of items in Android's
ListView and GridView.
* Multi-part item support: split the loading of each item into separate
asynchronous operations with different global priorities.
* Tight integration between user interaction and async loading of items i.e.
stops loading items on fling, enables loading when panning with finger
down, etc.
* Prefetch items beyond the currently visible items to reduce the number of
placeholder-type items while scrolling.
How do I use it?
================
1. Add Smoothie's jar as a dependency to your project.
2. Add an `AsyncListView` or `AsyncGridView` to your layout.
2. Implement an `SimpleItemLoader`. You're only required to override three methods:
`getItemParams()`, `loadItem()`, and `displayItem()`. You can override more
methods if you want to handle loading items from memory, preloading items,
resetting item views, etc.
3. On Activity/Fragment creation, attach an `ItemManager` instance to your
AsyncListView/AsyncGridView:
```java
ItemManager.Builder builder = new ItemManager.Builder(yourItemLoader);
builder.setPreloadItemsEnabled(true).setPreloadItemsCount(5);
builder.setThreadPoolSize(4);
ItemManager itemManager = builder.build();
AsyncListView listView = (AsyncListView) findViewById(R.id.list);
listView.setItemManager(itemManager);
```
The sample app has an example of an ItemEngine powered by
[Android-BitmapCache](https://github.com/chrisbanes/Android-BitmapCache) that
fades images in as they finish loading on a ListView.
The API docs contain a more detailed overview of the API.
Download
--------
Grab via Maven:
```xml
org.lucasr.smoothie
smoothie
0.1.0
```
or Gradle:
```groovy
compile 'org.lucasr.smoothie:smoothie:0.1.0'
```
Want to help?
=============
File new issues to discuss specific aspects of the API and to propose new
features.
License
=======
Copyright 2012 Lucas Rocha
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.