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

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

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

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

二、配置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屬性

......

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

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

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

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

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

  注2：關於設置緩存的目錄，可以通過以下方法：
  1. FilecacheDir=StorageUtils.getOwnCacheDirectory(getApplicationContext(),"imageloader/Cache");

     //這個是你希望的緩存文件的目錄：imageloader/Cache
     
     之後在ImageLoaderConfiguration的配置文件中通過設置

  2. .discCache(newUnlimitedDiscCache(cacheDir))//自定義緩存路徑

     方法來設置該應用的圖片緩存路徑。

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

  3. protectedImageLoaderimageLoader=ImageLoader.getInstance();

     之後進行顯示的圖片的各種格式DisplayImageOptions的設置：

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

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

      注：
      
      以上配置中的：

      1）.imageScaleType(ImageScaleTypeimageScaleType)是設置圖片的縮放方式
      縮放類型mageScaleType:
      
      EXACTLY:圖像將完全按比例縮小的目標大小
      
      EXACTLY_STRETCHED:圖片會縮放到目標大小完全
      
      IN_SAMPLE_INT:圖像將被二次采樣的整數倍
      
      IN_SAMPLE_POWER_OF_2:圖片將降低2倍，直到下一減少步驟，使圖像更小的目標大小
      
      NONE:圖片不會調整
      2）.displayer(BitmapDisplayerdisplayer)是設置圖片的顯示方式
      
      顯示方式displayer：
      
      RoundedBitmapDisplayer（introundPixels）設置圓角圖片
      
      FakeBitmapDisplayer（）這個類什麼都沒做
      
      FadeInBitmapDisplayer（intdurationMillis）設置圖片漸顯的時間
      
      　　　　　　　SimpleBitmapDisplayer()正常顯示一張圖片　　

      之後按照需求調用

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

      publicvoiddisplayImage(Stringuri,ImageViewimageView){}

      具體實現：

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

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

      publicvoiddisplayImage(Stringuri,ImageViewimageView,DisplayImageOptionsoptions){}

      具體實現：

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

      3.圖片加載時候帶加載情況的監聽
      
      方法：

      publicvoiddisplayImage(Stringuri,ImageAwareimageAware,DisplayImageOptionsoptions,ImageLoadingListenerlistener){｝

      ImageLoadingListener用於監聽圖片的下載情況。

      具體實現：

  24. imageLoader.displayImage(imageUrl,imageView,options,newImageLoadingListener(){
  25. @Override
  26. publicvoidonLoadingStarted(){
  27. //開始加載的時候執行
  28. }
  29. @Override
  30. publicvoidonLoadingFailed(FailReasonfailReason){
  31. //加載失敗的時候執行
  32. }
  33. @Override
  34. publicvoidonLoadingComplete(BitmaploadedImage){
  35. //加載成功的時候執行
  36. }
  37. @Override
  38. publicvoidonLoadingCancelled(){
  39. //加載取消的時候執行
  40.  
  41. }});

      4.圖片加載時候，帶監聽又帶加載進度條的情況
      調用：
      public void loadImage(String uri, ImageSize targetImageSize, DisplayImageOptions options,
      ImageLoadingListener listener, ImageLoadingProgressListener progressListener) {}
      具體實現：

  42. imageLoader.displayImage(imageUrl,imageView,options,newImageLoadingListener(){
  43. @Override
  44. publicvoidonLoadingStarted(){
  45. //開始加載的時候執行
  46. }
  47. @Override
  48. publicvoidonLoadingFailed(FailReasonfailReason){
  49. //加載失敗的時候執行
  50. }
  51. @Override
  52. publicvoidonLoadingComplete(BitmaploadedImage){
  53. //加載成功的時候執行
  54. }
  55. @Override
  56. publicvoidonLoadingCancelled(){
  57. //加載取消的時候執行
  58. },newImageLoadingProgressListener(){
  59. @Override
  60. publicvoidonProgressUpdate(StringimageUri,Viewview,intcurrent,inttotal){
  61. //在這裡更新ProgressBar的進度信息
  62. }
  63. });
      

      四、注意事項
      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();
      
      對於如何加載本地圖片：

  64. StringimageUri="http://site.com/image.png";//fromWeb
  65. StringimageUri="file:///mnt/sdcard/image.png";//fromSDcard
  66. StringimageUri="content://media/external/audio/albumart/13";//fromcontentprovider
  67. StringimageUri="assets://image.png";//fromassets
  68. StringimageUri="drawable://"+R.drawable.image;//fromdrawables(onlyimages,non-9patch)