作者：歡醉

博客：https://cloud.tencent.com/developer/article/1026386

 Android-Universal-Image-Loader是一個(gè)開(kāi)源的UI組件程序，該項目的目的是提供一個(gè)可重復使用的儀器為異步圖像加載，緩存和顯示。所以，如果你的程序里需要這個(gè)功能的話(huà)，那么不妨試試它。因為已經(jīng)封裝好了一些類(lèi)和方法。我們 可以直接拿來(lái)用了。而不用重復去寫(xiě)了。其實(shí)，寫(xiě)一個(gè)這方面的程序還是比較麻煩的，要考慮多線(xiàn)程，緩存，內存溢出等很多方面。但是，你也可以參考這個(gè)例子來(lái)自己寫(xiě)出更好的程序。在此為大家介紹一下：

多線(xiàn)程的圖像加載 的可能性的寬調諧對ImageLoader的配置（線(xiàn)程池的大小，HTTP選項，內存和光盤(pán)高速緩存，顯示圖像，以及其他） 的圖像的可能性中的緩存存儲器和/或設備的文件器系統（或SD卡） 可以“聽(tīng)”加載過(guò)程中 可自定義每個(gè)顯示的圖像調用分隔的選項 Widget支持 Android 1.5以上支持 簡(jiǎn)單描述一下這個(gè)項目的結構：每一個(gè)圖片的加載和顯示任務(wù)都運行在獨立的線(xiàn)程中，除非這個(gè)圖片緩存在內存中，這種情況下圖片會(huì )立即顯示。

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

由于是使用過(guò)程中會(huì )圖片獲取要通過(guò)網(wǎng)絡(luò )，并且有緩存設置，所以這2個(gè)權限必須要有。

很多人想知道如何設置緩存的目錄，可以通過(guò)以下方法：

File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), "imageloader/Cache");  
//這個(gè)是你希望的緩存文件的目錄：imageloader/Cache

之后在ImageLoaderConfiguration的配置文件中通過(guò)設置

1. discCache(new UnlimitedDiscCache(cacheDir)) //自定義緩存路徑方法來(lái)設置該應用的圖片緩存路徑。

下面我們就來(lái)開(kāi)始看如何使用這個(gè)圖片異步加載庫把：

1）配置

先要配置ImageLoaderConfiguration這個(gè)類(lèi)實(shí)現全局ImageLoader的實(shí)現情況。

可以選擇在A(yíng)pplication中初始化設置該類(lèi)。

ImageLoaderConfiguration config = new ImageLoaderConfiguration  
.Builder(context)  
.memoryCacheExtraOptions(480, 800) // max width, max height，即保存的每個(gè)緩存文件的最大長(cháng)寬
.discCacheExtraOptions(480, 800, CompressFormat.JPEG, 75, null) // Can slow ImageLoader, use it carefully (Better don't use it)/設置緩存的詳細信息，最好不要設置這個(gè)
.threadPoolSize(3)//線(xiàn)程池內加載的數量
.threadPriority(Thread.NORM_PRIORITY - 2)  
.denyCacheImageMultipleSizesInMemory()  
.memoryCache(new UsingFreqLimitedMemoryCache(2 * 1024 * 1024)) // You can pass your own memory cache implementation/你可以通過(guò)自己的內存緩存實(shí)現
.memoryCacheSize(2 * 1024 * 1024)    
.discCacheSize(50 * 1024 * 1024)    
.discCacheFileNameGenerator(new Md5FileNameGenerator())//將保存的時(shí)候的URI名稱(chēng)用MD5 加密
.tasksProcessingOrder(QueueProcessingType.LIFO)  
.discCacheFileCount(100) //緩存的文件數量
.discCache(new UnlimitedDiscCache(cacheDir))//自定義緩存路徑
.defaultDisplayImageOptions(DisplayImageOptions.createSimple())  
.imageDownloader(new BaseImageDownloader(context, 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超時(shí)時(shí)間
.writeDebugLogs() // Remove for release app
.build();//開(kāi)始構建
// Initialize ImageLoader with configuration.

以上的配置看個(gè)人需求進(jìn)行選擇，不是所有都要進(jìn)行配置。

配置好ImageLoaderConfiguration后，調用以下方法來(lái)實(shí)現初始化：

ImageLoader.getInstance().init(config);//全局初始化此配置
注：ImageLoaderConfiguration 配置中的.discCacheFileNameGenerator()方法是將緩存下來(lái)的文件以什么方式命名里面可以調用的方法有
1.newMd5FileNameGenerator()//使用MD5對UIL進(jìn)行加密命名
2.newHashCodeFileNameGenerator()//使用HASHCODE對UIL進(jìn)行加密命名

二. 加載

使用ImageLoader進(jìn)行圖片加載的時(shí)候，先要實(shí)例化ImageLoader，調用以下方法進(jìn)行實(shí)例化，在每個(gè)布局里面都要實(shí)例化后再使用。

protected ImageLoader imageLoader = ImageLoader.getInstance();

之后進(jìn)行顯示的圖片的各種格式DisplayImageOptions 的設置：

DisplayImageOptions options;  
options = new DisplayImageOptions.Builder()  
.showImageOnLoading(R.drawable.ic_launcher) //設置圖片在下載期間顯示的圖片
.showImageForEmptyUri(R.drawable.ic_launcher)//設置圖片Uri為空或是錯誤的時(shí)候顯示的圖片
.showImageOnFail(R.drawable.ic_launcher)  //設置圖片加載/解碼過(guò)程中錯誤時(shí)候顯示的圖片
.cacheInMemory(true)//設置下載的圖片是否緩存在內存中
.cacheOnDisc(true)//設置下載的圖片是否緩存在SD卡中
.considerExifParams(true)  //是否考慮JPEG圖像EXIF參數（旋轉，翻轉）
.imageScaleType(ImageScaleType.EXACTLY_STRETCHED)//設置圖片以如何的編碼方式顯示
.bitmapConfig(Bitmap.Config.RGB_565)//設置圖片的解碼類(lèi)型//
.decodingOptions(android.graphics.BitmapFactory.Options decodingOptions)//設置圖片的解碼配置
//.delayBeforeLoading(int delayInMillis)//int delayInMillis為你設置的下載前的延遲時(shí)間
//設置圖片加入緩存前，對bitmap進(jìn)行設置
//.preProcessor(BitmapProcessor preProcessor)
.resetViewBeforeLoading(true)//設置圖片在下載前是否重置，復位
.displayer(new RoundedBitmapDisplayer(20))//是否設置為圓角，弧度為多少
.displayer(new FadeInBitmapDisplayer(100))//是否圖片加載好后漸入的動(dòng)畫(huà)時(shí)間
.build();//構建完成

1）.imageScaleType(ImageScaleType imageScaleType) 是設置 圖片的縮放方式
縮放類(lèi)型mageScaleType:

              EXACTLY :圖像將完全按比例縮小的目標大小

              EXACTLY_STRETCHED:圖片會(huì )縮放到目標大小完全

              IN_SAMPLE_INT:圖像將被二次采樣的整數倍

              IN_SAMPLE_POWER_OF_2:圖片將降低2倍，直到下一減少步驟，使圖像更小的目標大小

              NONE:圖片不會(huì )調整

2）.displayer(BitmapDisplayer displayer)   是設置圖片的顯示方式

      顯示方式displayer：

              RoundedBitmapDisplayer（int roundPixels）設置圓角圖片

              FakeBitmapDisplayer（）這個(gè)類(lèi)什么都沒(méi)做

              FadeInBitmapDisplayer（int durationMillis）設置圖片漸顯的時(shí)間

　　　　　　　  SimpleBitmapDisplayer()正常顯示一張圖片　

縮放類(lèi)型mageScaleType:

              EXACTLY :圖像將完全按比例縮小的目標大小

              EXACTLY_STRETCHED:圖片會(huì )縮放到目標大小完全

              IN_SAMPLE_INT:圖像將被二次采樣的整數倍

              IN_SAMPLE_POWER_OF_2:圖片將降低2倍，直到下一減少步驟，使圖像更小的目標大小

              NONE:圖片不會(huì )調整

之后按照需求調用

1. 純粹為了加載默認配置的一個(gè)圖片的   方法:

 public void displayImage(String uri, ImageView imageView) {}

  具體實(shí)現：

ImageLoader.getInstance().displayImage(imageUrl, imageView); // imageUrl代表圖片的URL地址，imageView代表承載圖片的IMAGEVIEW控件

2. 加載自定義配置的一個(gè)圖片的   方法:

public void displayImage(String uri, ImageView imageView, DisplayImageOptions options) {}

  具體實(shí)現：

ImageLoader.getInstance().displayImage(imageUrl, imageView，options); // imageUrl代表圖片的URL地址，// imageView代表承載圖片的IMAGEVIEW控件 ， // options代表DisplayImageOptions配置文件

3. 圖片加載時(shí)候帶加載情況的監聽(tīng)   方法：

 public void displayImage(String uri, ImageAware imageAware, DisplayImageOptions options,ImageLoadingListener listener) {｝

  ImageLoadingListener 用于監聽(tīng)圖片的下載情況。

  具體實(shí)現：

imageLoader.displayImage(imageUrl, imageView, options, new ImageLoadingListener() {  
 @Override
public void onLoadingStarted() {  
//開(kāi)始加載的時(shí)候執行
}  
 @Override
public void onLoadingFailed(FailReason failReason) {        
//加載失敗的時(shí)候執行
}   
 @Override
public void onLoadingComplete(Bitmap loadedImage) {  
//加載成功的時(shí)候執行
}   
 @Override
public void onLoadingCancelled() {  
//加載取消的時(shí)候執行

}});

4. 圖片加載時(shí)候，帶監聽(tīng)又帶加載進(jìn)度條的情況    

調用：

public void loadImage(String uri, ImageSize targetImageSize, DisplayImageOptions options, ImageLoadingListener listener, ImageLoadingProgressListener progressListener) {}

具體實(shí)現：

imageLoader.displayImage(imageUrl, imageView, options, new ImageLoadingListener() {  
 @Override
public void onLoadingStarted() {  
//開(kāi)始加載的時(shí)候執行
}  
 @Override
public void onLoadingFailed(FailReason failReason) {        
//加載失敗的時(shí)候執行
}      
 @Override
public void onLoadingComplete(Bitmap loadedImage) {  
//加載成功的時(shí)候執行
}      
 @Override
public void onLoadingCancelled() {  
//加載取消的時(shí)候執行
},new ImageLoadingProgressListener() {        
 @Override
public void onProgressUpdate(String imageUri, View view, int current,int total) {     
//在這里更新 ProgressBar的進(jìn)度信息
}  
});

1. 上述提到的2個(gè)權限必須加入，否則會(huì )出錯

2. ImageLoaderConfiguration必須配置并且全局化的初始化這個(gè)配置ImageLoader.getInstance().init(config);  否則也會(huì )出現錯誤提示

3. ImageLoader是根據ImageView的height，width確定圖片的寬高。

4. 如果經(jīng)常出現OOM（別人那邊看到的，覺(jué)得很有提的必要）

① 減少配置之中線(xiàn)程池的大小，(.threadPoolSize).推薦1-5；

② 使用.bitmapConfig(Bitmap.config.RGB_565)代替ARGB_8888;

③ 使用imageScaleType(ImageScaleType.IN_SAMPLE_INT) ，

或者 try.imageScaleType(ImageScaleType.EXACTLY)；

④ 避免使用RoundedBitmapDisplayer.他會(huì )創(chuàng )建新的ARGB_8888格式的Bitmap對象；

⑤ 使用.memoryCache(new WeakMemoryCache())，不要使用.cacheInMemory();