這個圖片異步加載並緩存的類已經被很多開發者所使用,是最常用的幾個開源庫之一,主流的應用,隨便反編譯幾個火的項目,都可以見到它的身影。
可是有的人並不知道如何去使用這庫如何進行配置,網上查到的信息對於剛接觸的人來說可能太少了,下面我就把我使用過程中所知道的寫了下來,希望可以幫助自己和別人更深入瞭解這個庫的使用和配置。
GITHUB上的下載路徑爲:https://github.com/nostra13/Android-Universal-Image-Loader ,下載最新的庫文件,並且導入到項目的LIB下便可以使用。
該庫以及DEMO本地下載鏈接:下載地址
一、介紹
Android-Universal-Image-Loader是一個開源的UI組件程序,該項目的目的是提供一個可重複使用的儀器爲異步圖像加載,緩存和顯示。所以,如果你的程序裏需要這個功能的話,那麼不妨試試它。因爲已經封裝好了一些類和方法。我們 可以直接拿來用了。而不用重複去寫了。其實,寫一個這方面的程序還是比較麻煩的,要考慮多線程,緩存,內存溢出等很多方面。但是,你也可以參考這個例子來自己寫出更好的程序。在此爲大家介紹一下:
二、特點
多線程的圖像加載
的可能性的寬調諧對ImageLoader的配置(線程池的大小,HTTP選項,內存和光盤高速緩存,顯示圖像,以及其他)
的圖像的可能性中的緩存存儲器和/或設備的文件器系統(或SD卡)
可以“聽”加載過程中
可自定義每個顯示的圖像調用分隔的選項
Widget支持
Android 1.5以上支持
簡單描述一下這個項目的結構:每一個圖片的加載和顯示任務都運行在獨立的線程中,除非這個圖片緩存在內存中,這種情況下圖片會立即顯示。如果需要的圖片緩存在本地,他們會開啓一個獨立的線程隊列。如果在緩存中沒有正確的圖片,任務線程會從線程池中獲取,因此,快速顯示緩存圖片時不會有明顯的障礙。(別人那邊借鑑的這段)
流程圖:
三、使用方法
這是 一個開源的Android關於下載顯示圖片的工具類,在這個下載包裏面jar文件,用於我們導入項目使用,具體使用方法在包裏面也含有。下面是一個例子:
[java] view plaincopy
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
由於是使用過程中會圖片獲取要通過網絡,並且有緩存設置,所以這2個權限必須要有。
很多人想知道如何設置緩存的目錄,可以通過以下方法:
[java] view plaincopy
File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), "p_w_picpathloader/Cache");
//這個是你希望的緩存文件的目錄:p_w_picpathloader/Cache
之後在ImageLoaderConfiguration的配置文件中通過設置
[java] view plaincopy
.discCache(new UnlimitedDiscCache(cacheDir))//自定義緩存路徑
方法來設置該應用的圖片緩存路徑。
下面我們就來開始看如何使用這個圖片異步加載庫把:
一.
先要配置ImageLoaderConfiguration這個類實現全局ImageLoader的實現情況。
可以選擇在Application中初始化設置該類。
[java] view plaincopy
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())
.p_w_picpathDownloader(new BaseImageDownloader(context, 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超時時間
.writeDebugLogs() // Remove for release app
.build();//開始構建
// Initialize ImageLoader with configuration.
以上的配置看個人需求進行選擇,不是所有都要進行配置。
配置好ImageLoaderConfiguration後,調用以下方法來實現初始化:
[java] view plaincopy
ImageLoader.getInstance().init(config);//全局初始化此配置
注:ImageLoaderConfiguration 配置中的.discCacheFileNameGenerator()方法是將緩存下來的文件以什麼方式命名
裏面可以調用的方法有 1.new Md5FileNameGenerator() //使用MD5對UIL進行加密命名
2.new HashCodeFileNameGenerator()//使用HASHCODE對UIL進行加密命名
二.
使用ImageLoader進行圖片加載的時候,先要實例化ImageLoader,調用以下方法進行實例化,在每個佈局裏面都要實例化後再使用。
[java] view plaincopy
protected ImageLoader p_w_picpathLoader = ImageLoader.getInstance();
之後進行顯示的圖片的各種格式DisplayImageOptions 的設置:
[java] view plaincopy
DisplayImageOptions options;
options = new DisplayImageOptions.Builder()
.showImageOnLoading(R.drawable.ic_launcher) //設置圖片在下載期間顯示的圖片
.showImageForEmptyUri(R.drawable.ic_launcher)//設置圖片Uri爲空或是錯誤的時候顯示的圖片
.showImageOnFail(R.drawable.ic_launcher) //設置圖片加載/解碼過程中錯誤時候顯示的圖片
.cacheInMemory(true)//設置下載的圖片是否緩存在內存中
.cacheOnDisc(true)//設置下載的圖片是否緩存在SD卡中
.considerExifParams(true) //是否考慮JPEG圖像EXIF參數(旋轉,翻轉)
.p_w_picpathScaleType(ImageScaleType.EXACTLY_STRETCHED)//設置圖片以如何的編碼方式顯示
.bitmapConfig(Bitmap.Config.RGB_565)//設置圖片的解碼類型//
.decodingOptions(android.graphics.BitmapFactory.Options decodingOptions)//設置圖片的解碼配置
//.delayBeforeLoading(int delayInMillis)//int delayInMillis爲你設置的下載前的延遲時間
//設置圖片加入緩存前,對bitmap進行設置
//.preProcessor(BitmapProcessor preProcessor)
.resetViewBeforeLoading(true)//設置圖片在下載前是否重置,復位
.displayer(new RoundedBitmapDisplayer(20))//是否設置爲圓角,弧度爲多少
.displayer(new FadeInBitmapDisplayer(100))//是否圖片加載好後漸入的動畫時間
.build();//構建完成
按照你所需要的配置去設置,如果不需要的就可以不做配置。
注:
以上配置中的:
1).p_w_picpathScaleType(ImageScaleType p_w_picpathScaleType) 是設置 圖片的縮放方式
縮放類型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 p_w_picpathView) {}
具體實現:
[java] view plaincopy
ImageLoader.getInstance().displayImage(p_w_picpathUrl, p_w_picpathView); // p_w_picpathUrl代表圖片的URL地址,p_w_picpathView代表承載圖片的IMAGEVIEW控件
2.加載自定義配置的一個圖片的
方法:
public void displayImage(String uri, ImageView p_w_picpathView, DisplayImageOptions options) {}
具體實現:
[java] view plaincopy
ImageLoader.getInstance().displayImage(p_w_picpathUrl, p_w_picpathView,options); // p_w_picpathUrl代表圖片的URL地址,p_w_picpathView代表承載圖片的IMAGEVIEW控件 , options代表DisplayImageOptions配置文件
3.圖片加載時候帶加載情況的監聽
方法:
public void displayImage(String uri, ImageAware p_w_picpathAware, DisplayImageOptions options,ImageLoadingListener listener) {}
ImageLoadingListener 用於監聽圖片的下載情況。
具體實現:
[java] view plaincopy
p_w_picpathLoader.displayImage(p_w_picpathUrl, p_w_picpathView, options, new ImageLoadingListener() {
@Override
public void onLoadingStarted() {
//開始加載的時候執行
}
@Override
public void onLoadingFailed(FailReason failReason) {
//加載失敗的時候執行
}
@Override
public void onLoadingComplete(Bitmap loadedImage) {
//加載成功的時候執行
}
@Override
public void onLoadingCancelled() {
//加載取消的時候執行
}});
4.圖片加載時候,帶監聽又帶加載進度條的情況
調用:
public void loadImage(String uri, ImageSize targetImageSize, DisplayImageOptions options,
ImageLoadingListener listener, ImageLoadingProgressListener progressListener) {}
具體實現:
[java] view plaincopy
p_w_picpathLoader.displayImage(p_w_picpathUrl, p_w_picpathView, options, new ImageLoadingListener() {
@Override
public void onLoadingStarted() {
//開始加載的時候執行
}
@Override
public void onLoadingFailed(FailReason failReason) {
//加載失敗的時候執行
}
@Override
public void onLoadingComplete(Bitmap loadedImage) {
//加載成功的時候執行
}
@Override
public void onLoadingCancelled() {
//加載取消的時候執行
},new ImageLoadingProgressListener() {
@Override
public void onProgressUpdate(String p_w_picpathUri, View view, int current,int total) {
//在這裏更新 ProgressBar的進度信息
}
});
四、注意事項
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;
③使用.p_w_picpathScaleType(ImageScaleType.IN_SAMPLE_INT)或者 try.p_w_picpathScaleType(ImageScaleType.EXACTLY);
④避免使用RoundedBitmapDisplayer.他會創建新的ARGB_8888格式的Bitmap對象;
⑤使用.memoryCache(new WeakMemoryCache()),不要使用.cacheInMemory();
String p_w_picpathUri = "http://site.com/p_w_picpath.png"; // from Web
String p_w_picpathUri = "file:///mnt/sdcard/p_w_picpath.png"; // from SD card
String p_w_picpathUri = "content://media/external/audio/albumart/13"; // from content provider
String p_w_picpathUri = "assets://p_w_picpath.png"; // from assets
String p_w_picpathUri = "drawable://" + R.drawable.p_w_picpath; // from drawables (only p_w_picpaths, non-9patch)
大致就說到這裏,可能有的地方不足歡迎提出,希望大家可以更加容易入手、使用這個庫。