Universal-Image-Loader圖片異步加載類庫
這是?一個(gè)開源的Android關(guān)于下載顯示圖片的工具類，在這個(gè)下載包里面jar文件，用于我們導(dǎo)入項(xiàng)目使用，具體使用方法在包里面也含有。下面是一個(gè)例子：
雙擊代碼復(fù)制
1
2
?
由于是使用過程中會圖片獲取要通過網(wǎng)絡(luò)，并且有緩存設(shè)置，所以這2個(gè)權(quán)限必須要有。
很多人想知道如何設(shè)置緩存的目錄，可以通過以下方法：
雙擊代碼復(fù)制
1
File?cacheDir?=?StorageUtils.getOwnCacheDirectory(getApplicationContext(),?"imageloader/Cache");
//這個(gè)是你希望的緩存文件的目錄：imageloader/Cache
之后在ImageLoaderConfiguration的配置文件中通過設(shè)置
雙擊代碼復(fù)制
1
.discCache(new?UnlimitedDiscCache(cacheDir))//自定義緩存路徑
?
方法來設(shè)置該應(yīng)用的圖片緩存路徑。
下面我們就來開始看如何使用這個(gè)圖片異步加載庫把：
一.
先要配置ImageLoaderConfiguration這個(gè)類實(shí)現(xiàn)全局ImageLoader的實(shí)現(xiàn)情況。
可以選擇在Application中初始化設(shè)置該類。
雙擊代碼復(fù)制
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
ImageLoaderConfiguration?config?=?new?ImageLoaderConfiguration??
????.Builder(context)??
????.memoryCacheExtraOptions(480,?800)?//?max?width,?max?height，即保存的每個(gè)緩存文件的最大長寬??
????.discCacheExtraOptions(480,?800,?CompressFormat.JPEG,?75,?null)?//?Can?slow?ImageLoader,?use?it?carefully?(Better?don't?use?it)/設(shè)置緩存的詳細(xì)信息，最好不要設(shè)置這個(gè)??
????.threadPoolSize(3)//線程池內(nèi)加載的數(shù)量??
????.threadPriority(Thread.NORM_PRIORITY?-?2)??
????.denyCacheImageMultipleSizesInMemory()??
????.memoryCache(new?UsingFreqLimitedMemoryCache(2?*?1024?*?1024))?//?You?can?pass?your?own?memory?cache?implementation/你可以通過自己的內(nèi)存緩存實(shí)現(xiàn)??
????.memoryCacheSize(2?*?1024?*?1024)????
????.discCacheSize(50?*?1024?*?1024)????
????.discCacheFileNameGenerator(new?Md5FileNameGenerator())//將保存的時(shí)候的URI名稱用MD5?加密??
????.tasksProcessingOrder(QueueProcessingType.LIFO)??
????.discCacheFileCount(100)?//緩存的文件數(shù)量??
????.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();//開始構(gòu)建??
????//?Initialize?ImageLoader?with?configuration.
?
以上的配置看個(gè)人需求進(jìn)行選擇，不是所有都要進(jìn)行配置。
配置好ImageLoaderConfiguration后，調(diào)用以下方法來實(shí)現(xiàn)初始化：
雙擊代碼復(fù)制
1
ImageLoader.getInstance().init(config);//全局初始化此配置
?
注：ImageLoaderConfiguration?配置中的.discCacheFileNameGenerator()方法是將緩存下來的文件以什么方式命名
里面可以調(diào)用的方法有??1.new?Md5FileNameGenerator()?//使用MD5對UIL進(jìn)行加密命名
2.new?HashCodeFileNameGenerator()//使用HASHCODE對UIL進(jìn)行加密命名
二.
????????使用ImageLoader進(jìn)行圖片加載的時(shí)候，先要實(shí)例化ImageLoader，調(diào)用以下方法進(jìn)行實(shí)例化，在每個(gè)布局里面都要實(shí)例化后再使用。
雙擊代碼復(fù)制
1
protected?ImageLoader?imageLoader?=?ImageLoader.getInstance();
之后進(jìn)行顯示的圖片的各種格式DisplayImageOptions?的設(shè)置：
雙擊代碼復(fù)制
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
DisplayImageOptions?options;??
options?=?new?DisplayImageOptions.Builder()??
?.showImageOnLoading(R.drawable.ic_launcher)?//設(shè)置圖片在下載期間顯示的圖片??
?.showImageForEmptyUri(R.drawable.ic_launcher)//設(shè)置圖片Uri為空或是錯(cuò)誤的時(shí)候顯示的圖片??
.showImageOnFail(R.drawable.ic_launcher)??//設(shè)置圖片加載/解碼過程中錯(cuò)誤時(shí)候顯示的圖片
.cacheInMemory(true)//設(shè)置下載的圖片是否緩存在內(nèi)存中??
.cacheOnDisc(true)//設(shè)置下載的圖片是否緩存在SD卡中??
.considerExifParams(true)??//是否考慮JPEG圖像EXIF參數(shù)（旋轉(zhuǎn)，翻轉(zhuǎn)）
.imageScaleType(ImageScaleType.EXACTLY_STRETCHED)//設(shè)置圖片以如何的編碼方式顯示??
.bitmapConfig(Bitmap.Config.RGB_565)//設(shè)置圖片的解碼類型//??
.decodingOptions(android.graphics.BitmapFactory.Options?decodingOptions)//設(shè)置圖片的解碼配置??
//.delayBeforeLoading(int?delayInMillis)//int?delayInMillis為你設(shè)置的下載前的延遲時(shí)間
//設(shè)置圖片加入緩存前，對bitmap進(jìn)行設(shè)置??
//.preProcessor(BitmapProcessor?preProcessor)??
.resetViewBeforeLoading(true)//設(shè)置圖片在下載前是否重置，復(fù)位??
.displayer(new?RoundedBitmapDisplayer(20))//是否設(shè)置為圓角，弧度為多少??
.displayer(new?FadeInBitmapDisplayer(100))//是否圖片加載好后漸入的動畫時(shí)間??
.build();//構(gòu)建完成
?
按照你所需要的配置去設(shè)置，如果不需要的就可以不做配置。
注：
以上配置中的：
?1）.imageScaleType(ImageScaleType?imageScaleType)??是設(shè)置?圖片的縮放方式
縮放類型mageScaleType:
EXACTLY?:圖像將完全按比例縮小的目標(biāo)大小
EXACTLY_STRETCHED:圖片會縮放到目標(biāo)大小完全
IN_SAMPLE_INT:圖像將被二次采樣的整數(shù)倍
IN_SAMPLE_POWER_OF_2:圖片將降低2倍，直到下一減少步驟，使圖像更小的目標(biāo)大小
NONE:圖片不會調(diào)整
2）.displayer(BitmapDisplayer?displayer)???是設(shè)置?圖片的顯示方式
顯示方式displayer：
RoundedBitmapDisplayer（int?roundPixels）設(shè)置圓角圖片
FakeBitmapDisplayer（）這個(gè)類什么都沒做
FadeInBitmapDisplayer（int?durationMillis）設(shè)置圖片漸顯的時(shí)間
SimpleBitmapDisplayer()正常顯示一張圖片
之后按照需求調(diào)用
1.純粹為了加載默認(rèn)配置的一個(gè)圖片的
方法:
??public?void?displayImage(String?uri,?ImageView?imageView)?{}
??具體實(shí)現(xiàn)：
雙擊代碼復(fù)制
1
ImageLoader.getInstance().displayImage(imageUrl,?imageView);?//?imageUrl代表圖片的URL地址，imageView代表承載圖片的IMAGEVIEW控件
?
2.加載自定義配置的一個(gè)圖片的
方法:
??public?void?displayImage(String?uri,?ImageView?imageView,?DisplayImageOptions?options)?{}
??具體實(shí)現(xiàn)：
雙擊代碼復(fù)制
1
ImageLoader.getInstance().displayImage(imageUrl,?imageView，options);?//?imageUrl代表圖片的URL地址，imageView代表承載圖片的IMAGEVIEW控件?，?options代表DisplayImageOptions配置文件
?
3.圖片加載時(shí)候帶加載情況的監(jiān)聽
方法：
?public?void?displayImage(String?uri,?ImageAware?imageAware,?DisplayImageOptions?options,ImageLoadingListener?listener)?{｝
??ImageLoadingListener?用于監(jiān)聽圖片的下載情況。
??具體實(shí)現(xiàn)：
雙擊代碼復(fù)制
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
imageLoader.displayImage(imageUrl,?imageView,?options,?new?ImageLoadingListener()?{??
????@Override?
????public?void?onLoadingStarted()?{??
???????//開始加載的時(shí)候執(zhí)行??
????}??
????@Override?
????public?void?onLoadingFailed(FailReason?failReason)?{????????
???????//加載失敗的時(shí)候執(zhí)行??
????}???
????@Override??
????public?void?onLoadingComplete(Bitmap?loadedImage)?{??
???????//加載成功的時(shí)候執(zhí)行??
????}???
????@Override??
????public?void?onLoadingCancelled()?{??
???????//加載取消的時(shí)候執(zhí)行??
???
????}});
4.圖片加載時(shí)候，帶監(jiān)聽又帶加載進(jìn)度條的情況
調(diào)用：
public?void?loadImage(String?uri,?ImageSize?targetImageSize,?DisplayImageOptions?options,
ImageLoadingListener?listener,?ImageLoadingProgressListener?progressListener)?{}
具體實(shí)現(xiàn)：
雙擊代碼復(fù)制
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
imageLoader.displayImage(imageUrl,?imageView,?options,?new?ImageLoadingListener()?{??
????@Override?
????public?void?onLoadingStarted()?{??
???????//開始加載的時(shí)候執(zhí)行??
????}??
????@Override?
????public?void?onLoadingFailed(FailReason?failReason)?{????????
???????//加載失敗的時(shí)候執(zhí)行??
????}??????
????@Override?????
????public?void?onLoadingComplete(Bitmap?loadedImage)?{??
???????//加載成功的時(shí)候執(zhí)行??
????}??????
????@Override?????
????public?void?onLoadingCancelled()?{??
???????//加載取消的時(shí)候執(zhí)行??
????},new?ImageLoadingProgressListener()?{????????
??????@Override?
??????public?void?onProgressUpdate(String?imageUri,?View?view,?int?current,int?total)?{?????
??????//在這里更新?ProgressBar的進(jìn)度信息??
??????}??
????});
四、注意事項(xiàng)
1.上述提到的2個(gè)權(quán)限必須加入，否則會出錯(cuò)
2.ImageLoaderConfiguration必須配置并且全局化的初始化這個(gè)配置ImageLoader.getInstance().init(config);??否則也會出現(xiàn)錯(cuò)誤提示
3.ImageLoader是根據(jù)ImageView的height，width確定圖片的寬高。
4.如果經(jīng)常出現(xiàn)OOM（別人那邊看到的，覺得很有提的必要）
①減少配置之中線程池的大小，(.threadPoolSize).推薦1-5；
②使用.bitmapConfig(Bitmap.config.RGB_565)代替ARGB_8888;
③使用.imageScaleType(ImageScaleType.IN_SAMPLE_INT)或者????????try.imageScaleType(ImageScaleType.EXACTLY)；
④避免使用RoundedBitmapDisplayer.他會創(chuàng)建新的ARGB_8888格式的Bitmap對象；
⑤使用.memoryCache(new?WeakMemoryCache())，不要使用.cacheInMemory();
下載文檔
