# Universal Image Loader

# Basic usage

  • Load an image, decode it into a bitmap, and display the bitmap in an `ImageView` (or any other view which implements the `ImageAware` interface):
    ImageLoader.getInstance().displayImage(imageUri, imageView);
  • Load an image, decode it into a bitmap, and return the bitmap to a callback:
    ImageLoader.getInstance().loadImage(imageUri, new SimpleImageLoadingListener() {
        public void onLoadingComplete(String imageUri, View view, Bitmap loadedImage) {
            // Do whatever you want with the bitmap.
  • Load an image, decode it into a bitmap and return the bitmap synchronously:
    Bitmap bmp = ImageLoader.getInstance().loadImageSync(imageUri);
  • # Initialize Universal Image Loader

  • Add the following dependency to the **build.gradle** file:
    compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.5'
  • Add the following permissions to the **AndroidManifest.xml** file:
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  • Initialize the Universal Image Loader. This must be done before the first usage:
    ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(this)
        // ...

    The full configuration options can be found here (opens new window).

  • # Remarks

    Acceptable URI examples:

    "http://www.example.com/image.png" // from Web
    "file:///mnt/sdcard/image.png" // from SD card
    "file:///mnt/sdcard/video.mp4" // from SD card (video thumbnail)
    "content://media/external/images/media/13" // from content provider
    "content://media/external/video/media/13" // from content provider (video thumbnail)
    "assets://image.png" // from assets
    "drawable://" + R.drawable.img // from drawables (non-9patch images)