如果說評價一下哪個圖片開源庫最被廣泛使用的話，我想應該可以說是Universal-Image-Loader，在主流的應用中如
果你隨便去反編譯幾個，基本都能看到他的身影，它就像個圖片加載守護者，默默的守護着圖片加載。相信很多人對
這個異步加載圖片框架還不是很熟，再加上最近它更改優化了好幾個地方，而網上的大部分資料還是以前的，於是花
了幾天時間專門的研究了下開源框架Universal-Image-Loader（實際上是近期項目剛好用到，且仔細的考慮過各種情
況），希望對新手能有所幫助，也希望大神能指點下。
一、功能特性：
1、多線程異步加載和顯示圖片（圖片來源於網絡、sd卡、assets文件夾，drawable文件夾（不能加載9patch），新增加載視頻縮略圖）
|
1
2
3
4
5
6
7
|
http://site.com/image.png
// from Webfile:///mnt/sdcard/image.png
// from SD cardfile:///mnt/sdcard/video.mp4
// from SD card (video thumbnail)content://media/external/images/media/13
// from content providercontent://media/external/video/media/13
// from content provider (video thumbnail)assets://image.png
// from assetsdrawable://
+ R.drawable.img // from drawables (non-9patch images) |
2、支持通過“listener”監視加載的過程，可以暫停加載圖片，在經常使用的ListView、GridView中，可以設置滑動時暫
停加載，停止滑動時加載圖片（便於節約流量，在一些優化中可以使用）
3、緩存圖片至內存時，可以更加高效的工作
4、高度可定製化（可以根據自己的需求進行各種配置，如：線程池，圖片下載器，內存緩存策略等）
5、支持圖片的內存緩存，SD卡（文件）緩存
6、在網絡速度較慢時，還可以對圖片進行加載並設置下載監聽
二、配置詳解
1、下載jar包放在libs文件夾中
注：Maven dependency:
|
1
2
3
4
5
|
<dependency> <groupid>com.nostra13.universalimageloader</groupid> universal-image-loader</artifactid> <version>1.9.3</version></dependency> |
Gradle dependency:
|
1
|
compile
'com.nostra13.universalimageloader:universal-image-loader:1.9.3' |
2、AndroidManifest.xml
|
1
2
|
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"><uses-permission
android:name="android.permission.INTERNET"></uses-permission></uses-permission> |
3、在應用中配置ImageLoaderConfiguration參數（只能配置一次，如多次配置，則默認第一次的配置參數）
a、使用默認設置
|
1
|
ImageLoaderConfiguration
configuration = ImageLoaderConfiguration.createDefault(this); |
b、自己配置參數
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
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中進行初始化）
|
1
|
ImageLoader.getInstance().init(config); |
4、圖片顯示操作
a、首先要得到ImageLoader的實例(使用的單例模式)
|
1
|
ImageLoader
imageLoader = ImageLoader.getInstance(); |
注：在每個顯示任務（佈局中都需實例化才能進行相關操作
b、相關顯示參數配置
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
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
2
3
4
5
6
7
8
9
10
11
12
13
|
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()正常顯示一張圖片 |
參數補充:
|
1
2
|
.considerExifParams(true)
//是否考慮JPEG圖像EXIF參數（旋轉，翻轉）.displayer(new
FadeInBitmapDisplayer(100))//
圖片加載好後漸入的動畫時間 |
c、顯示圖片
|
1
2
3
4
5
|
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); |
參數解析：
|
1
2
3
4
5
|
imageUrl
圖片的URL地址imageView
顯示圖片的ImageView控件 options
DisplayImageOptions配置信息 listener
圖片下載情況的監聽progressListener
圖片下載進度的監聽 |
1)方法1:最簡單的方式，我們只需要定義要顯示的圖片的URL和要顯示圖片的ImageView。這種情況下，圖片的顯示選項會使用默認的配置
2)方法2:加載自定義配置的一個圖片
3)方法3:加載帶監聽的一個圖片
4)方法4:加載自定義配置且帶監聽的一個圖片
5)方法5:加載自定義配置且帶監聽和進度條的一個圖片
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
|
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文件中進行如下配置
|
1
|
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission> |
5、內存緩存模式可以使用以下已實現的方法 (ImageLoaderConfiguration.memoryCache(...))
1)緩存只使用強引用
LruMemoryCache (緩存大小超過指定值時，刪除最近最少使用的bitmap) --默認情況下使用
2)緩存使用弱引用和強引用
|
1
2
3
4
5
|
UsingFreqLimitedMemoryCache
(緩存大小超過指定值時,刪除最少使的bitmap)LRULimitedMemoryCache
(緩存大小超過指定值時,刪除最近最少使用的<span helvetica=""
segoe=""
style="font-family:">bitmap)
--默認值</span>FIFOLimitedMemoryCache
(緩存大小超過指定值時,按先進先出規則刪除的<span helvetica=""
segoe=""
style="font-family:">bitmap)</span>LargestLimitedMemoryCache
(緩存大小超過指定值時,刪除最大的bitmap)LimitedAgeMemoryCache
(緩存對象超過定義的時間後刪除) |
3)緩存使用弱引用
WeakMemoryCache（沒有限制緩存）
6、本地緩存模式可以使用以下已實現的方法 (ImageLoaderConfiguration.diskCache(...))
|
1
2
3
4
|
UnlimitedDiskCache
不限制緩存大小（默認）TotalSizeLimitedDiskCache
(設置總緩存大小，超過時刪除最久之前的緩存)FileCountLimitedDiskCache
(設置總緩存文件數量，當到達警戒值時，刪除最久之前的緩存。如果文件的大小都一樣的時候，可以使用該模式)LimitedAgeDiskCache
(不限制緩存大小，但是設置緩存時間，到期後刪除) |
五、完美例子(參考源碼)
1、項目結構圖
Constans主要用來存放圖片的url地址的
2、項目效果圖
3、代碼講解
1)權限添加
|
1
2
|
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"><uses-permission
android:name="android.permission.INTERNET"></uses-permission></uses-permission> |
2)初始化配置
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
|
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); }} |
2.自定義了緩存目錄
3)初始化顯示配置
|
1
2
3
4
5
6
7
8
9
|
//
使用DisplayImageOptions.Builder()創建DisplayImageOptionsoptions
= 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)顯示圖片
|
1
2
|
imageLoader.displayImage(imageUrls[position], viewHolder.image,
options); |
5)清除緩存
|
1
2
3
4
5
6
7
8
9
|
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的各個應用場景