圖檔異步加載之 Android-Universal-Image-Loader

今天在做項目的時候用了之前寫的圖檔加載類，雖然也能實作緩存什麼的，但是在加載大圖的時候很慢很慢，于是上網找解決方案，準備優化一下，無意中發現了 Android-Universal-Image-Loader，用過的人都說好，一開始我是拒絕的，但是耐不住網友的評論，于是嘗試用了一下，結果我duang了，真的好好吃啊，哦，不，是好好用啊。下面就講解一下使用過程吧。

其實有位網友已經寫的很詳細了，我也是參考他的：http://blog.csdn.net/vipzjyno1/article/details/23206387，有需要的可以直接看他的，我這裡隻是簡單記錄下學習記錄罷了。

首先是GITHUB上的下載下傳路徑為：https://github.com/nostra13/Android-Universal-Image-Loader 

一、既然是通過網絡擷取圖檔，并涉及緩存，那麼肯定需要兩個權限： 

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

  二、配置ImageLoaderConfiguration這個類，可以在Application中初始化設定該類。

ImageLoaderConfiguration config = new ImageLoaderConfiguration  
    .Builder(context)  
    .memoryCacheExtraOptions(480, 800) // max width, max height，即儲存的每個緩存檔案的最大長寬  
    .discCacheExtraOptions(480, 800, CompressFormat.JPEG, 75, null) // Can slow ImageLoader, use it carefully (Better don't use it)/設定緩存的詳細資訊，最好不要設定這個  
    .threadPoolSize(3)//線程池内加載的數量  
    .threadPriority(Thread.NORM_PRIORITY - 2)  
    .denyCacheImageMultipleSizesInMemory()  
    .memoryCache(new UsingFreqLimitedMemoryCache(2 * 1024 * 1024)) // You can pass your own memory cache implementation/你可以通過自己的記憶體緩存實作  
    .memoryCacheSize(2 * 1024 * 1024)    
    .discCacheSize(50 * 1024 * 1024)    
    .discCacheFileNameGenerator(new Md5FileNameGenerator())//将儲存的時候的URI名稱用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)逾時時間  
    .writeDebugLogs() // Remove for release app  
    .build();//開始建構  
    // Initialize ImageLoader with configuration.  
           

以上配置按需選擇，無需全部配置

記得在你的Manifest中為你的application寫上name屬性

<application
        android:name="com.cwenhui.chowhound.config.UILApplication"
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@android:style/Theme.Light.NoTitleBar" >
           

......
           

</application>
           

配置好ImageLoaderConfiguration後，調用以下方法來實作初始化：

[java]  view plain copy

1. ImageLoader.getInstance().init(config);//全局初始化此配置  

注1：ImageLoaderConfiguration 配置中的.discCacheFileNameGenerator()方法是将緩存下來的檔案以什麼方式命名

          裡面可以調用的方法有  1.new Md5FileNameGenerator() //使用MD5對UIL進行加密命名

                                                2.new HashCodeFileNameGenerator()//使用HASHCODE對UIL進行加密命名

注2：關于 設定緩存的目錄，可以通過以下方法：

[java]  view plain copy

1. File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), "imageloader/Cache");  

//這個是你希望的緩存檔案的目錄：imageloader/Cache

之後在ImageLoaderConfiguration的配置檔案中通過設定

[java]  view plain copy

1. .discCache(new UnlimitedDiscCache(cacheDir))//自定義緩存路徑  

方法來設定該應用的圖檔緩存路徑。

三、使用ImageLoader進行圖檔加載的時候，先要執行個體化ImageLoader，調用以下方法進行執行個體化，在每個布局裡面都要執行個體化後再使用。

[java]  view plain copy

1. protected ImageLoader imageLoader = ImageLoader.getInstance();  

之後進行顯示的圖檔的各種格式DisplayImageOptions 的設定：

[java]  view plain copy

1. DisplayImageOptions options;  
2. options = new DisplayImageOptions.Builder()  
3.  .showImageOnLoading(R.drawable.ic_launcher) //設定圖檔在下載下傳期間顯示的圖檔  
4.  .showImageForEmptyUri(R.drawable.ic_launcher)//設定圖檔Uri為空或是錯誤的時候顯示的圖檔  
5. .showImageOnFail(R.drawable.ic_launcher)  //設定圖檔加載/解碼過程中錯誤時候顯示的圖檔
6. .cacheInMemory(true)//設定下載下傳的圖檔是否緩存在記憶體中  
7. .cacheOnDisc(true)//設定下載下傳的圖檔是否緩存在SD卡中  
8. .considerExifParams(true)  //是否考慮JPEG圖像EXIF參數（旋轉，翻轉）
9. .imageScaleType(ImageScaleType.EXACTLY_STRETCHED)//設定圖檔以如何的編碼方式顯示  
10. .bitmapConfig(Bitmap.Config.RGB_565)//設定圖檔的解碼類型//  
11. .decodingOptions(android.graphics.BitmapFactory.Options decodingOptions)//設定圖檔的解碼配置  
12. //.delayBeforeLoading(int delayInMillis)//int delayInMillis為你設定的下載下傳前的延遲時間
13. //設定圖檔加入緩存前，對bitmap進行設定  
14. //.preProcessor(BitmapProcessor preProcessor)  
15. .resetViewBeforeLoading(true)//設定圖檔在下載下傳前是否重置，複位  
16. .displayer(new RoundedBitmapDisplayer(20))//是否設定為圓角，弧度為多少  
17. .displayer(new FadeInBitmapDisplayer(100))//是否圖檔加載好後漸入的動畫時間  
18. .build();//建構完成  

同樣是根據需求選擇性地配置

注：

  以上配置中的：

 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.純粹為了加載預設配置的一個圖檔的

  方法:

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

  具體實作：

[java]  view plain copy

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

2.加載自定義配置的一個圖檔的

  方法:

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

  具體實作：

[java]  view plain copy

1. ImageLoader.getInstance().displayImage(imageUrl, imageView，options); // imageUrl代表圖檔的URL位址，imageView代表承載圖檔的IMAGEVIEW控件 ， options代表DisplayImageOptions配置檔案  

3.圖檔加載時候帶加載情況的監聽

  方法：

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

  ImageLoadingListener 用于監聽圖檔的下載下傳情況。

  具體實作：

[java]  view plain copy

1. imageLoader.displayImage(imageUrl, imageView, options, new ImageLoadingListener() {  
2.     @Override  
3.     public void onLoadingStarted() {  
4.        //開始加載的時候執行  
5.     }  
6.     @Override  
7.     public void onLoadingFailed(FailReason failReason) {        
8.        //加載失敗的時候執行  
9.     }   
10.     @Override   
11.     public void onLoadingComplete(Bitmap loadedImage) {  
12.        //加載成功的時候執行  
13.     }   
14.     @Override   
15.     public void onLoadingCancelled() {  
16.        //加載取消的時候執行  
17.     }});  

4.圖檔加載時候，帶監聽又帶加載進度條的情況

   調用：

public void loadImage(String uri, ImageSize targetImageSize, DisplayImageOptions options,

                    ImageLoadingListener listener, ImageLoadingProgressListener progressListener) {}

   具體實作：

[java]  view plain copy

1. imageLoader.displayImage(imageUrl, imageView, options, new ImageLoadingListener() {  
2.     @Override  
3.     public void onLoadingStarted() {  
4.        //開始加載的時候執行  
5.     }  
6.     @Override  
7.     public void onLoadingFailed(FailReason failReason) {        
8.        //加載失敗的時候執行  
9.     }      
10.     @Override      
11.     public void onLoadingComplete(Bitmap loadedImage) {  
12.        //加載成功的時候執行  
13.     }      
14.     @Override      
15.     public void onLoadingCancelled() {  
16.        //加載取消的時候執行  
17.     },new ImageLoadingProgressListener() {        
18.       @Override  
19.       public void onProgressUpdate(String imageUri, View view, int current,int total) {     
20.       //在這裡更新 ProgressBar的進度資訊  
21.       }  
22.     });  

四、注意事項

  1.上述提到的2個權限必須加入，否則會出錯

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

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

  4.如果經常出現OOM（别人那邊看到的，覺得很有提的必要）

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

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

   ③使用.imageScaleType(ImageScaleType.IN_SAMPLE_INT)或者        try.imageScaleType(ImageScaleType.EXACTLY)；

   ④避免使用RoundedBitmapDisplayer.他會建立新的ARGB_8888格式的Bitmap對象；

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

對于如何加載本地圖檔：

1. String imageUri = "http://site.com/image.png"; // from Web  
2. String imageUri = "file:///mnt/sdcard/image.png"; // from SD card  
3. String imageUri = "content://media/external/audio/albumart/13"; // from content provider  
4. String imageUri = "assets://image.png"; // from assets  
5. String imageUri = "drawable://" + R.drawable.image; // from drawables (only images, non-9patch)  

參考：http://blog.csdn.net/vipzjyno1/article/details/23206387