如果說評價一下哪個圖檔開源庫最被廣泛使用的話，我想應該可以說是Universal-Image-Loader，在主流的應用中如
果你随便去反編譯幾個，基本都能看到他的身影，它就像個圖檔加載守護者，默默的守護着圖檔加載。相信很多人對
這個異步加載圖檔架構還不是很熟，再加上最近它更改優化了好幾個地方，而網上的大部分資料還是以前的，于是花
了幾天時間專門的研究了下開源架構Universal-Image-Loader（實際上是近期項目剛好用到，且仔細的考慮過各種情
況），希望對新手能有所幫助，也希望大神能指點下。
該項目的Github位址連結：https://github.com/nostra13/Android-Universal-Image-Loader
Github登陸不了的可以連結這裡下載下傳：點選
一、功能特性：
1、多線程異步加載和顯示圖檔（圖檔來源于網絡、sd卡、assets檔案夾，drawable檔案夾（不能加載9patch），新增加載視訊縮略圖）
"http://site.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)
2、支援通過“listener”監視加載的過程，可以暫停加載圖檔，在經常使用的ListView、GridView中，可以設定滑動時暫
停加載，停止滑動時加載圖檔（便于節約流量，在一些優化中可以使用）
3、緩存圖檔至記憶體時，可以更加高效的工作
4、高度可定制化（可以根據自己的需求進行各種配置，如：線程池，圖檔下載下傳器，記憶體緩存政策等）
5、支援圖檔的記憶體緩存，SD卡（檔案）緩存
6、在網絡速度較慢時，還可以對圖檔進行加載并設定下載下傳監聽
二、配置詳解
1、下載下傳jar包放在libs檔案夾中
注：Maven dependency:
<dependency>
<groupId>com.nostra13.universalimageloader</groupId>
<artifactId>universal-image-loader</artifactId>
<version>1.9.3</version>
</dependency>
Gradle dependency:
compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.3'
2、AndroidManifest.xml
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET" />
3、在應用中配置ImageLoaderConfiguration參數（隻能配置一次，如多次配置，則預設第一次的配置參數）
a、使用預設設定
ImageLoaderConfiguration configuration = ImageLoaderConfiguration.createDefault(this);
b、自己配置參數
File cacheDir = StorageUtils.getCacheDirectory(context); //緩存檔案夾路徑
ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)
.memoryCacheExtraOptions(480, 800) // default = device screen dimensions 記憶體緩存檔案的最大長寬
.diskCacheExtraOptions(480, 800, null) // 本地緩存的詳細資訊(緩存的最大長寬)，最好不要設定這個
.taskExecutor(...)
.taskExecutorForCachedImages(...)
.threadPoolSize(3) // default 線程池内加載的數量
.threadPriority(Thread.NORM_PRIORITY - 2) // default 設定目前線程的優先級
.tasksProcessingOrder(QueueProcessingType.FIFO) // default
.denyCacheImageMultipleSizesInMemory()
.memoryCache(new LruMemoryCache(2 * 1024 * 1024)) //可以通過自己的記憶體緩存實作
.memoryCacheSize(2 * 1024 * 1024) // 記憶體緩存的最大值
.memoryCacheSizePercentage(13) // default
.diskCache(new UnlimitedDiscCache(cacheDir)) // default 可以自定義緩存路徑
.diskCacheSize(50 * 1024 * 1024) // 50 Mb sd卡(本地)緩存的最大值
.diskCacheFileCount(100) // 可以緩存的檔案數量
// default為使用HASHCODE對UIL進行加密命名， 還可以用MD5(new Md5FileNameGenerator())加密
.diskCacheFileNameGenerator(new HashCodeFileNameGenerator())
.imageDownloader(new BaseImageDownloader(context)) // default
.imageDecoder(new BaseImageDecoder()) // default
.defaultDisplayImageOptions(DisplayImageOptions.createSimple()) // default
.writeDebugLogs() // 列印debug log
.build(); //開始建構
配置好ImageLoaderConfiguration，一定不要忘記進行初始化操作（一般在application中進行初始化）
ImageLoader.getInstance().init(config);
注：上面的配置請根據自己的需要進行配置，不是所有的都要進行配置的
4、圖檔顯示操作
a、首先要得到ImageLoader的執行個體(使用的單例模式)
ImageLoader imageLoader = ImageLoader.getInstance();
注：在每個顯示任務（布局中都需執行個體化才能進行相關操作
b、相關顯示參數配置
DisplayImageOptions options = new DisplayImageOptions.Builder()
.showImageOnLoading(R.drawable.ic_stub) // 設定圖檔下載下傳期間顯示的圖檔
.showImageForEmptyUri(R.drawable.ic_empty) // 設定圖檔Uri為空或是錯誤的時候顯示的圖檔
.showImageOnFail(R.drawable.ic_error) // 設定圖檔加載或解碼過程中發生錯誤顯示的圖檔
.resetViewBeforeLoading(false) // default 設定圖檔在加載前是否重置、複位
.delayBeforeLoading(1000) // 下載下傳前的延遲時間
.cacheInMemory(false) // default 設定下載下傳的圖檔是否緩存在記憶體中
.cacheOnDisk(false) // default 設定下載下傳的圖檔是否緩存在SD卡中
.preProcessor(...)
.postProcessor(...)
.extraForDownloader(...)
.considerExifParams(false) // default
.imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2) // default 設定圖檔以如何的編碼方式顯示
.bitmapConfig(Bitmap.Config.ARGB_8888) // default 設定圖檔的解碼類型
.decodingOptions(...) // 圖檔的解碼設定
.displayer(new SimpleBitmapDisplayer()) // default 還可以設定圓角圖檔new RoundedBitmapDisplayer(20)
.handler(new Handler()) // default
.build();
注：如果DisplayImageOption沒有傳遞給ImageLoader.displayImage(…)方法，那麼從配置預設顯示選項
(ImageLoaderConfiguration.defaultDisplayImageOptions(…))将被使用。
1）.imageScaleType(ImageScaleType imageScaleType) //設定圖檔的縮放方式
縮放類型mageScaleType:
EXACTLY :圖像将完全按比例縮小的目标大小
EXACTLY_STRETCHED:圖檔會縮放到目标大小完全
IN_SAMPLE_INT:圖像将被二次采樣的整數倍
IN_SAMPLE_POWER_OF_2:圖檔将降低2倍，直到下一減少步驟，使圖像更小的目标大小
NONE:圖檔不會調整
2）.displayer(BitmapDisplayer displayer) //設定圖檔的顯示方式
顯示方式displayer：
RoundedBitmapDisplayer（int roundPixels）設定圓角圖檔
FakeBitmapDisplayer（）這個類什麼都沒做
FadeInBitmapDisplayer（int durationMillis）設定圖檔漸顯的時間
SimpleBitmapDisplayer()正常顯示一張圖檔
參數補充:
.considerExifParams(true) //是否考慮JPEG圖像EXIF參數（旋轉，翻轉）
.displayer(new FadeInBitmapDisplayer(100))// 圖檔加載好後漸入的動畫時間
c、顯示圖檔
1、 ImageLoader.getInstance().displayImage(uri, imageView);
2、 ImageLoader.getInstance().displayImage(uri, imageView, options);
3、 ImageLoader.getInstance().displayImage(uri, imageView, listener);
4、 ImageLoader.getInstance().displayImage(uri, imageView, options, listener);
5、 ImageLoader.getInstance().displayImage(uri, imageView, options, listener, progressListener);
參數解析：
imageUrl 圖檔的URL位址
imageView 顯示圖檔的ImageView控件
options DisplayImageOptions配置資訊
listener 圖檔下載下傳情況的監聽
progressListener 圖檔下載下傳進度的監聽
1)方法1:最簡單的方式，我們隻需要定義要顯示的圖檔的URL和要顯示圖檔的ImageView。這種情況下，圖檔的顯示選項會使用預設的配置
2)方法2:加載自定義配置的一個圖檔
3)方法3:加載帶監聽的一個圖檔
4)方法4:加載自定義配置且帶監聽的一個圖檔
5) 方法5:加載自定義配置且帶監聽和進度條的一個圖檔
ImageLoader.getInstance().displayImage(uri, imageView, options,
new ImageLoadingListener() {
@Override
public void onLoadingStarted(String arg0, View arg1) {
//開始加載
}
@Override
public void onLoadingFailed(String arg0, View arg1,
FailReason arg2) {
//加載失敗
}
@Override
public void onLoadingComplete(String arg0, View arg1,
Bitmap arg2) {
//加載成功
}
@Override
public void onLoadingCancelled(String arg0, View arg1) {
//加載取消
}
}, new ImageLoadingProgressListener() {
@Override
public void onProgressUpdate(String imageUri, View view,
int current, int total) {
//加載進度
}
});
三、提示和技巧
1、隻有在你需要讓Image的尺寸比目前裝置的尺寸大的時候，你才需要配置maxImageWidthForMemoryCach(...)和
maxImageHeightForMemoryCache(...)這兩個參數，比如放大圖檔的時候。其他情況下，不需要做這些配置，因為默
認的配置會根據螢幕尺寸以最節約記憶體的方式處理Bitmap。
2、在設定中配置線程池的大小是非常明智的。一個大的線程池會允許多條線程同時工作，但是也會顯著的影響到UI
線程的速度。但是可以通過設定一個較低的優先級來解決：當ImageLoader在使用的時候，可以降低它的優先級，這
樣UI線程會更加流暢。在使用List的時候，UI 線程經常會不太流暢，是以在你的程式中最好設定threadPoolSize(...)和
threadPriority(...)這兩個參數來優化你的應用。
3、memoryCache(...)和memoryCacheSize(...)這兩個參數會互相覆寫，是以在ImageLoaderConfiguration中使用一個就好了
4、diskCacheSize(...)、diskCache(...)和diskCacheFileCount(...)這三個參數會互相覆寫，隻使用一個
注：不要使用discCacheSize(...)、discCache(...)和discCacheFileCount(...)這三個參數已經棄用
5、如果你的程式中使用displayImage（）方法時傳入的參數經常是一樣的，那麼一個合理的解決方法是，把這些選項
配置在ImageLoader的設定中作為預設的選項（通過調用defaultDisplayImageOptions(...)方法）。之後調用
displayImage(...)方法的時候就不必再指定這些選項了，如果這些選項沒有明确的指定給
defaultDisplayImageOptions(...)方法，那調用的時候将會調用UIL的預設設定。
四、注意事項
1、如果你經常出現oom，你可以嘗試:
1)禁用在記憶體中緩存cacheInMemory(false)，如果oom仍然發生那麼似乎你的應用程式有記憶體洩漏，使用MemoryAnalyzer來檢測它。否則嘗試以下步驟(嘗試所有或幾個)
2)減少配置的線程池的大小(
.threadPoolSize(...)
)，建議1~5
3)在顯示選項中使用 .bitmapConfig(Bitmap.Config.RGB_565) . RGB_565模式消耗的記憶體比ARGB_8888模式少兩倍.
4)配置中使用.diskCacheExtraOptions(480, 320, null)
5)配置中使用 .memoryCache(newWeakMemoryCache()) 或者完全禁用在記憶體中緩存(don't call .cacheInMemory()).
6)在顯示選項中使用.imageScaleType(ImageScaleType.EXACTLY) 或 .imageScaleType(ImageScaleType.IN_SAMPLE_INT)
7)避免使用 RoundedBitmapDisplayer. 調用的時候它使用ARGB-8888模式建立了一個新的Bitmap對象來顯示，對于記憶體緩存模式 (ImageLoaderConfiguration.memoryCache(...)) 你可以使用已經實作好的方法.
2、ImageLoader是根據ImageView的height，width确定圖檔的寬高
3、一定要對ImageLoaderConfiguration進行初始化,否則會報錯
4、開啟緩存後預設會緩存到外置SD卡如下位址(/sdcard/Android/data/[package_name]/cache).如果外置SD卡不存在，會緩存到手機. 緩存到Sd卡需要在AndroidManifest.xml檔案中進行如下配置
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
5、記憶體緩存模式可以使用以下已實作的方法 (ImageLoaderConfiguration.memoryCache(...))
1)緩存隻使用強引用
LruMemoryCache (緩存大小超過指定值時，删除最近最少使用的bitmap) --預設情況下使用
2)緩存使用弱引用和強引用
UsingFreqLimitedMemoryCache (緩存大小超過指定值時,删除最少使的bitmap)
LRULimitedMemoryCache (緩存大小超過指定值時,删除最近最少使用的<span style="font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif;">bitmap) --預設值</span>
FIFOLimitedMemoryCache (緩存大小超過指定值時,按先進先出規則删除的<span style="font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif;">bitmap)</span>
LargestLimitedMemoryCache (緩存大小超過指定值時,删除最大的bitmap)
LimitedAgeMemoryCache (緩存對象超過定義的時間後删除)
3)緩存使用弱引用
WeakMemoryCache（沒有限制緩存）
6、本地緩存模式可以使用以下已實作的方法 (ImageLoaderConfiguration.diskCache(...))
UnlimitedDiskCache 不限制緩存大小（預設）
TotalSizeLimitedDiskCache (設定總緩存大小，超過時删除最久之前的緩存)
FileCountLimitedDiskCache (設定總緩存檔案數量，當到達警戒值時，删除最久之前的緩存。如果檔案的大小都一樣的時候，可以使用該模式)
LimitedAgeDiskCache (不限制緩存大小，但是設定緩存時間，到期後删除)
五、完美例子(參考源碼)
1、項目結構圖
Constans主要用來存放圖檔的url位址的
2、項目效果圖
3、代碼講解
1)權限添加
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET" />
2)初始化配置
package com.xwj.imageloaderdemo;
import java.io.File;
import android.app.Application;
import android.content.Context;
import com.nostra13.universalimageloader.cache.disc.impl.UnlimitedDiscCache;
import com.nostra13.universalimageloader.cache.disc.naming.Md5FileNameGenerator;
import com.nostra13.universalimageloader.cache.memory.impl.UsingFreqLimitedMemoryCache;
import com.nostra13.universalimageloader.core.ImageLoader;
import com.nostra13.universalimageloader.core.ImageLoaderConfiguration;
import com.nostra13.universalimageloader.core.assist.QueueProcessingType;
import com.nostra13.universalimageloader.core.download.BaseImageDownloader;
import com.nostra13.universalimageloader.utils.StorageUtils;
public class ImageLoaderApplication extends Application {
public void onCreate() {
super.onCreate();
initImageLoader(getApplicationContext());
}
public static void initImageLoader(Context context) {
//緩存檔案的目錄
File cacheDir = StorageUtils.getOwnCacheDirectory(context, "imageloader/Cache");
ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)
.memoryCacheExtraOptions(480, 800) // max width, max height，即儲存的每個緩存檔案的最大長寬
.threadPoolSize(3) //線程池内加載的數量
.threadPriority(Thread.NORM_PRIORITY - 2)
.denyCacheImageMultipleSizesInMemory()
.diskCacheFileNameGenerator(new Md5FileNameGenerator()) //将儲存的時候的URI名稱用MD5 加密
.memoryCache(new UsingFreqLimitedMemoryCache(2 * 1024 * 1024)) // You can pass your own memory cache implementation/你可以通過自己的記憶體緩存實作
.memoryCacheSize(2 * 1024 * 1024) // 記憶體緩存的最大值
.diskCacheSize(50 * 1024 * 1024) // 50 Mb sd卡(本地)緩存的最大值
.tasksProcessingOrder(QueueProcessingType.LIFO)
// 由原先的discCache -> diskCache
.diskCache(new UnlimitedDiscCache(cacheDir))//自定義緩存路徑
.imageDownloader(new BaseImageDownloader(context, 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)逾時時間
.writeDebugLogs() // Remove for release app
.build();
//全局初始化此配置
ImageLoader.getInstance().init(config);
}
}
注：1.記得在AndroidManifest.xml中添加android:name="com.xwj.imageloaderdemo.ImageLoaderApplication"
2.自定義了緩存目錄
3)初始化顯示配置
// 使用DisplayImageOptions.Builder()建立DisplayImageOptions
options = new DisplayImageOptions.Builder()
.showImageOnLoading(R.drawable.ic_stub) // 設定圖檔下載下傳期間顯示的圖檔
.showImageForEmptyUri(R.drawable.ic_empty) // 設定圖檔Uri為空或是錯誤的時候顯示的圖檔
.showImageOnFail(R.drawable.ic_error) // 設定圖檔加載或解碼過程中發生錯誤顯示的圖檔
.cacheInMemory(true) // 設定下載下傳的圖檔是否緩存在記憶體中
.cacheOnDisk(true) // 設定下載下傳的圖檔是否緩存在SD卡中
.displayer(new RoundedBitmapDisplayer(20)) // 設定成圓角圖檔
.build(); // 建構完成
4)顯示圖檔
imageLoader.displayImage(imageUrls[position],
viewHolder.image, options);
5)清除緩存
public void onClearMemoryClick(View view) {
Toast.makeText(this, "清除記憶體緩存成功", Toast.LENGTH_SHORT).show();
ImageLoader.getInstance().clearMemoryCache(); // 清除記憶體緩存
}
public void onClearDiskClick(View view) {
Toast.makeText(this, "清除本地緩存成功", Toast.LENGTH_SHORT).show();
ImageLoader.getInstance().clearDiskCache(); // 清除本地緩存
}
其餘是比較正常的代碼，就不多做介紹了，下一篇将較長的描述Universal-Image-Loader的各個應用場景
源碼下載下傳：點選