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?
-
Add Smoothie's jar as a dependency to your project.
-
Add an
AsyncListVieworAsyncGridViewto your layout. -
Implement an
SimpleItemLoader. You're only required to override three methods:
getItemParams(),loadItem(), anddisplayItem(). You can override more
methods if you want to handle loading items from memory, preloading items,
resetting item views, etc. -
On Activity/Fragment creation, attach an
ItemManagerinstance to your
AsyncListView/AsyncGridView: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 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:
<dependency>
<groupId>org.lucasr.smoothie</groupId>
<artifactId>smoothie</artifactId>
<version>0.1.0</version>
</dependency>
or Gradle:
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.