Shutterbug - Remote image loader with caching for Android
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 ImageView
(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 LruCache
and 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.
How to use
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.
Basic usage
You only need a context, an url and an ImageView
:
ShutterbugManager.getSharedImageManager(context).download(url, imageView);
Using FetchableImageView
- Instantiate the subclass (either in your code or in an xml file, for example by replacing
ImageView
bycom.applidium.shutterbug.FetchableImageView
). - Fetch the image (
setImage(String url)
orsetImage(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.
Using ShutterbugManager
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.