Shutterbug is an Android library that lets you fetch remote images and cache them. It is particularly suited for displaying remote images in lists or grids as it includes a convenience subclass of
FetchableImageView) that make implementation a one-liner.
A dual memory and disk cache was implemented. It makes use of two backports of Android classes: LruCache for the memory part and DiskLruCache for the disk part.
LruCache was introduced by API Level 12, but we provide it here as a standalone class so you can use the library under lower level APIs. Both
DiskLruCache are licensed under the Apache Software License, 2.0.
Shutterbug was inspired by SDWebImage which does the same thing on iOS. It uses the same structure and interface. People who are familiar with
SDWebImage on iOS will feel at home with
Shutterbug on Android.
First, ensure that the following permissions were added to your AndroidManifest.xml file:
<uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
Then, you just have to add the jar or the library project to your project.
You only need a context, an url and an
- Instantiate the subclass (either in your code or in an xml file, for example by replacing
- Fetch the image (
setImage(String url, Drawable placeholderDrawable)if you need to add a placeholder while waiting for the image to be fetched)
- That's it!
We also provide you with a listener interface (
FetchableImageViewListener) which will help you refresh your UI if need.
If you need to do more advanced coding, you can use
ShutterbugManager. It is a singleton class whose instance is accessed by the static method
ShutterbugManager.getSharedManager(context). Downloading and caching is done by calling
download(String url, ShutterbugManagerListener listener) on this instance.