This project aims to provide a reusable instrument for asynchronous image loading, caching and displaying. It is originally based on Fedor Vlasov's project and has been vastly refactored and improved since then.

• Multithread image loading
• Possibility of wide tuning ImageLoader's configuration (thread pool size, HTTP options, memory and disc cache, display image options, and others)
• Possibility of image caching in memory and/or on device's file sysytem (or SD card)
• Possibility to "listen" loading process
• Possibility to customize every display image call with separated options
• Widget support

Android 1.5+ support

• universal-image-loader-1.7.1.jar (library; contains *.class files)
• universal-image-loader-1.7.1-sources.jar (sources; contains *.java files)
• universal-image-loader-1.7.1-javadoc.jar (Java docs; contains *.html files)
• universal-image-loader-1.7.1-with-sources.jar (library with sources inside; contains *.class and *.java files)
  Prefer to use this JAR so you can see Java docs in Eclipse tooltips.
• universal-image-loader-sample-1.7.1.apk (sample application)

• Universal Image Loader. Part 1 - Introduction [RU | EN]
• Universal Image Loader. Part 2 - Configuration [RU | EN]
• Universal Image Loader. Part 3 - Usage [RU | EN]

(*) a bit outdated

1. Look into Useful Info
2. Search problem solution on StackOverFlow
3. Ask your own question on StackOverFlow.
   Be sure to mention following information in your question:

• your configuration (ImageLoaderConfiguration)
• display options (DisplayImageOptions)
• getView() method code of your adapter (if you use it)
• XML layout of your ImageView you load image into

Bugs and feature requests put here.

Manual:

• Download JAR
• Put the JAR in the libs subfolder of your Android project

or

Maven dependency:

<dependency>
	<groupId>com.nostra13.universalimageloader</groupId>
	<artifactId>universal-image-loader</artifactId>
	<version>1.7.1</version>
</dependency>

<manifest>
	<uses-permission android:name="android.permission.INTERNET" />
	<!-- Include next permission if you want to allow UIL to cache images on SD card -->
	<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
	...
	<application android:name="MyApplication">
		...
	</application>
</manifest>

public class MyApplication extends Application {
	@Override
	public void onCreate() {
		super.onCreate();

		// Create global configuration and initialize ImageLoader with this configuration
		ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(getApplicationContext())
			...
			.build();
		ImageLoader.getInstance().init(config);
	}
}

• ImageLoader Configuration (ImageLoaderConfiguration) is global for application. You should set it once.
• Display Options (DisplayImageOptions) are local for every display task (ImageLoader.displayImage(...)).

All options in Configuration builder are optional. Use only those you really want to customize.
See default values for config options in Java docs for every option.

// DON'T COPY THIS CODE TO YOUR PROJECT! This is just example of ALL options using.
File cacheDir = StorageUtils.getCacheDirectory(context);
ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)
		.memoryCacheExtraOptions(480, 800) // default = device screen dimensions
		.discCacheExtraOptions(480, 800, CompressFormat.JPEG, 75)
		.threadPoolSize(3) // default
		.threadPriority(Thread.NORM_PRIORITY - 1) // default
		.denyCacheImageMultipleSizesInMemory()
		.offOutOfMemoryHandling()
		.memoryCache(new UsingFreqLimitedMemoryCache(2 * 1024 * 1024)) // default
		.discCache(new UnlimitedDiscCache(cacheDir)) // default
		.discCacheSize(50 * 1024 * 1024)
		.discCacheFileCount(100)
		.discCacheFileNameGenerator(new HashCodeFileNameGenerator()) // default
		.imageDownloader(new URLConnectionImageDownloader()) // default
		.tasksProcessingOrder(QueueProcessingType.FIFO) // default
		.defaultDisplayImageOptions(DisplayImageOptions.createSimple()) // default
		.enableLogging()
		.build();

Display Options can be applied to every display task (ImageLoader.displayImage(...) call).

Note: If Display Options wasn't passed to ImageLoader.displayImage(...)method then default Display Options from configuration (ImageLoaderConfiguration.defaultDisplayImageOptions(...)) will be used.

// DON'T COPY THIS CODE TO YOUR PROJECT! This is just example of ALL options using.
DisplayImageOptions options = new DisplayImageOptions.Builder()
		.showStubImage(R.drawable.stub_image)
		.showImageForEmptyUri(R.drawable.image_for_empty_url)
		.resetViewBeforeLoading()
		.cacheInMemory()
		.cacheOnDisc()
		.imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2) // default
		.bitmapConfig(Bitmap.Config.ARGB_8888) // default
		.delayBeforeLoading(1000)
		.displayer(new SimpleBitmapDisplayer()) // default
		.build();

// Load image, decode it to Bitmap and display Bitmap in ImageView
imageLoader.displayImage(imageUri, imageView);

// Load image, decode it to Bitmap and return Bitmap to callback
imageLoader.loadImage(context, imageUri, new SimpleImageLoadingListener() {
	@Override
	public void onLoadingComplete(Bitmap loadedImage) {
		// Do whatever you want with loaded Bitmap
	}
});

// Load image, decode it to Bitmap and display Bitmap in ImageView
imageLoader.displayImage(imageUri, imageView, displayOptions, new ImageLoadingListener() {
	@Override
	public void onLoadingStarted() {
		...
	}
	@Override
	public void onLoadingFailed(FailReason failReason) {
		...
	}
	@Override
	public void onLoadingComplete(Bitmap loadedImage) {
		...
	}
	@Override
	public void onLoadingCancelled() {
		...
	}
});

// Load image, decode it to Bitmap and return Bitmap to callback
ImageSize targetSize = new ImageSize(120, 80); // result Bitmap will be fit to this size
imageLoader.loadImage(context, imageUri, targetSize, displayOptions, new SimpleImageLoadingListener() {
	@Override
	public void onLoadingComplete(Bitmap loadedImage) {
		// Do whatever you want with loaded Bitmap
	}
});

Other useful methods and classes to consider.

ImageLoader |
			| - getMemoryCache()
			| - clearMemoryCache()
			| - getDiscCache()
			| - clearDiscCache()
			| - pause()
			| - resume()
			| - stop()
			| - getLoadingUriForView(ImageView)
			| - cancelDisplayTask(ImageView)

MemoryCacheUtil |
				| - findCachedBitmapsForImageUri(...)
				| - findCacheKeysForImageUri(...)
				| - removeFromCache(...)

StorageUtils |
			 | - getCacheDirectory(Context)
			 | - getIndividualCacheDirectory(Context)
			 | - getOwnCacheDirectory(Context, String)

PauseOnScrollListener

Also look into more detailed Library Map

1. Caching is NOT enabled by default. If you want loaded images will be cached in memory and/or on disc then you should enable caching in DisplayImageOptions this way:

// Create default options which will be used for every 
//  displayImage(...) call if no options will be passed to this method
DisplayImageOptions defaultOptions = new DisplayImageOptions.Builder()
			...
            .cacheInMemory()
            .cacheOnDisc()
            ...
            .build();
ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(getApplicationContext())
            ...
            .defaultDisplayImageOptions(defaultOptions)
            ...
            .build();
ImageLoader.getInstance().init(config); // Do it on Application start

// Then later, when you want to display image
ImageLoader.getInstance().displayImage(imageUrl, imageView); // Default options will be used

or this way:

DisplayImageOptions options = new DisplayImageOptions.Builder()
			...
            .cacheInMemory()
            .cacheOnDisc()
            ...
            .build();
ImageLoader.getInstance().displayImage(imageUrl, imageView, options); // Incoming options will be used

2. If you enabled disc caching then UIL try to cache images on external storage (/sdcard/Android/data/[package_name]/cache). If external storage is not available then images are cached on device's filesytem. To provide caching on external storage (SD card) add following permission to AndroidManifest.xml:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

3. How UIL define Bitmap size needed for exact ImageView? It searches defined parameters:

• Get android:layout_width and android:layout_height parameters
• Get android:maxWidth and/or android:maxHeight parameters
• Get maximum width and/or height parameters from configuration (memoryCacheExtraOptions(int, int) option)
• Get width and/or height of device screen

So try to set android:layout_width|android:layout_height or android:maxWidth|android:maxHeight parameters for ImageView if you know approximate maximum size of it. It will help correctly compute Bitmap size needed for this view and save memory.

4. If you often got OutOfMemoryError in your app using Universal Image Loader then try next (all of them or several):

• Reduce thread pool size in configuration (.threadPoolSize(...)). 1 - 5 is recommended.
• Use .bitmapConfig(Bitmap.Config.RGB_565) in display options. Bitmaps in RGB_565 consume 2 times less memory than in ARGB_8888.
• Use .memoryCache(new WeakMemoryCache()) in configuration or disable caching in memory at all in display options (don't call .cacheInMemory()).
• Use .imageScaleType(ImageScaleType.IN_SAMPLE_INT) in display options. Or try .imageScaleType(ImageScaleType.EXACTLY).
• Avoid using RoundedBitmapDisplayer. It creates new Bitmap object with ARGB_8888 config for displaying during work.

5. For memory cache configuration (ImageLoaderConfiguration.Builder.memoryCache(...)) you can use already prepared implementations:

• UsingFreqLimitedMemoryCache (The least frequently used bitmap is deleted when cache size limit is exceeded) - Used by default
• LRULimitedMemoryCache (Least recently used bitmap is deleted when cache size limit is exceeded)
• FIFOLimitedMemoryCache (FIFO rule is used for deletion when cache size limit is exceeded)
• LargestLimitedMemoryCache (The largest bitmap is deleted when cache size limit is exceeded)
• LimitedAgeMemoryCache (Decorator. Cached object is deleted when its age exceeds defined value)
• WeakMemoryCache (Memory cache with only weak references to bitmaps)

6. For disc cache configuration (ImageLoaderConfiguration.Builder.discCache(...)) you can use already prepared implementations:

• UnlimitedDiscCache (The fastest cache, doesn't limit cache size) - Used by default
• TotalSizeLimitedDiscCache (Cache limited by total cache size. If cache size exceeds specified limit then file with the most oldest last usage date will be deleted)
• FileCountLimitedDiscCache (Cache limited by file count. If file count in cache directory exceeds specified limit then file with the most oldest last usage date will be deleted. Use it if your cached files are of about the same size.)
• LimitedAgeDiscCache (Size-unlimited cache with limited files' lifetime. If age of cached file exceeds defined limit then it will be deleted from cache.)

NOTE: UnlimitedDiscCache is 30%-faster than other limited disc cache implementations.

7. To display bitmap (DisplayImageOptions.Builder.displayer(...)) you can use already prepared implementations:

• RoundedBitmapDisplayer (Displays bitmap with rounded corners)
• FadeInBitmapDisplayer (Displays image with "fade in" animation)

8. To avoid list (grid, ...) scrolling lags you can use PauseOnScrollListener:

boolean pauseOnScroll = false; // or true
boolean pauseOnFling = true; // or false
PauseOnScrollListener listener = new PauseOnScrollListener(pauseOnScroll, pauseOnFling);
listView.setOnScrollListener(listener);

MediaHouse, UPnP/DLNA Browser | Деловой Киров | Бизнес-завтрак | Menu55 | SpokenPic | Kumir | EUKO 2012 | TuuSo Image Search | Газета Стройка | Prezzi Benzina (AndroidFuel) | [Quiz Guess The Guy] (https://play.google.com/store/apps/details?id=com.game.guesstheguy) | Volksempfänger (alpha) | ROM Toolbox Lite, Pro | London 2012 Games | 카톡 이미지 - 예쁜 프로필 이미지 | dailyPen | Mania! | Stadium Astro | Chef Astro | Lafemme Fashion Finder | FastPaleo | Sporee - Live Soccer Scores | friendizer | LowPrice lowest book price | bluebee | Game PromoBox | EyeEm - Photo Filter Camera | Festival Wallpaper | Gaudi Hall | Spocal | PhotoDownloader for Facebook | Вкладыши | Dressdrobe | mofferin | WordBoxer | EZ Imgur | Ciudad en línea | Urbanismo en línea | Waypost | Moonrise Kingdom Wallpapers HD | Chic or Shock? | Auto Wallpapers | Heyou | Brasil Notícias | ProfiAuto’s VideoBlog | CarteleraApp (Cine), AdsFree | Listonic - Zamów Zakupy | Topface - meeting is easy | Name The Meme | Name The World | Pregnancy Tickers - Widget | Hindi Movies & More | Telugu Movies & More | Jessica Alba HD Wallpaper | User Manager ROOT Android 4.2 | DNSHmob | Theke | SensibleJournal | PiCorner for Flickr, Instagram | Survey-n-More - Paid Surveys | STROBEL Verlag Basic | reddit is fun, golden platinum | iDukan Diet Tracker | Geek Hero Comic

You can support the project and thank the author for his hard work :)

• GitTip
• WebMoney (Z417203268219)

Copyright (c) 2011, Sergey Tarasevich

If you use Universal Image Loader code in your application you must inform the author about it ( email: nostra13[at]gmail[dot]com ) like this:

I use Universal Image Loader in [ApplicationName] - http://link_to_google_play. I [allow|don't allow] to mention my app in "Applications using Universal Image Loader" on GitHub.

Also you should mention it (but it is not required) in application UI with string "Using Universal-Image-Loader (c) 2011, Sergey Tarasevich" (e.g. in some "About" section).

Licensed under the BSD 3-clause