Android開源架構Universal-Image-Loader詳解，androidsdkloader

Android開源架構Universal-Image-Loader詳解，androidsdkloader

如果說評價一下哪個圖片開源庫最被廣泛使用的話，我想應該可以說是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() {@Overridepublic void onLoadingStarted(String arg0, View arg1) {//開始載入}@Overridepublic void onLoadingFailed(String arg0, View arg1,FailReason arg2) {//載入失敗}@Overridepublic void onLoadingComplete(String arg0, View arg1,Bitmap arg2) {//載入成功}@Overridepublic void onLoadingCancelled(String arg0, View arg1) {//載入取消}}, new ImageLoadingProgressListener() {@Overridepublic 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()建立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)顯示圖片

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的各個應用情境

源碼下載：點擊