新聞動態(tài)
Universal-Image-Loader 圖片異步加載類庫還不熟?
網(wǎng)站建設(shè) 發(fā)布者:cya 2019-12-09 09:06 訪問量:167
作者:歡醉
博客:https://cloud.tencent.com/developer/article/1026386
寫在前面
一、介紹
Android-Universal-Image-Loader是一個開源的UI組件程序,該項目的目的是提供一個可重復(fù)使用的儀器為異步圖像加載,緩存和顯示。所以,如果你的程序里需要這個功能的話,那么不妨試試它。因為已經(jīng)封裝好了一些類和方法。我們 可以直接拿來用了。而不用重復(fù)去寫了。其實,寫一個這方面的程序還是比較麻煩的,要考慮多線程,緩存,內(nèi)存溢出等很多方面。但是,你也可以參考這個例子來自己寫出更好的程序。在此為大家介紹一下:
二、特點
多線程的圖像加載 的可能性的寬調(diào)諧對ImageLoader的配置(線程池的大小,HTTP選項,內(nèi)存和光盤高速緩存,顯示圖像,以及其他) 的圖像的可能性中的緩存存儲器和/或設(shè)備的文件器系統(tǒng)(或SD卡) 可以“聽”加載過程中 可自定義每個顯示的圖像調(diào)用分隔的選項 Widget支持 Android 1.5以上支持 簡單描述一下這個項目的結(jié)構(gòu):每一個圖片的加載和顯示任務(wù)都運行在獨立的線程中,除非這個圖片緩存在內(nèi)存中,這種情況下圖片會立即顯示。
三、使用方法
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
由于是使用過程中會圖片獲取要通過網(wǎng)絡(luò),并且有緩存設(shè)置,所以這2個權(quán)限必須要有。
很多人想知道如何設(shè)置緩存的目錄,可以通過以下方法:
File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), "imageloader/Cache");
//這個是你希望的緩存文件的目錄:imageloader/Cache
之后在ImageLoaderConfiguration的配置文件中通過設(shè)置
discCache(new UnlimitedDiscCache(cacheDir)) //自定義緩存路徑方法來設(shè)置該應(yīng)用的圖片緩存路徑。
下面我們就來開始看如何使用這個圖片異步加載庫把:
1)配置
先要配置ImageLoaderConfiguration這個類實現(xiàn)全局ImageLoader的實現(xiàn)情況。
可以選擇在Application中初始化設(shè)置該類。
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)/設(shè)置緩存的詳細信息,最好不要設(shè)置這個
.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)存緩存實現(xiàn)
.memoryCacheSize(2 * 1024 * 1024)
.discCacheSize(50 * 1024 * 1024)
.discCacheFileNameGenerator(new Md5FileNameGenerator())//將保存的時候的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)超時時間
.writeDebugLogs() // Remove for release app
.build();//開始構(gòu)建
// Initialize ImageLoader with configuration.
以上的配置看個人需求進行選擇,不是所有都要進行配置。
配置好ImageLoaderConfiguration后,調(diào)用以下方法來實現(xiàn)初始化:
ImageLoader.getInstance().init(config);//全局初始化此配置注:ImageLoaderConfiguration 配置中的.discCacheFileNameGenerator()方法是將緩存下來的文件以什么方式命名里面可以調(diào)用的方法有
1.newMd5FileNameGenerator()//使用MD5對UIL進行加密命名
2.newHashCodeFileNameGenerator()//使用HASHCODE對UIL進行加密命名
二. 加載
使用ImageLoader進行圖片加載的時候,先要實例化ImageLoader,調(diào)用以下方法進行實例化,在每個布局里面都要實例化后再使用。
protected ImageLoader imageLoader = ImageLoader.getInstance();
之后進行顯示的圖片的各種格式DisplayImageOptions 的設(shè)置:
DisplayImageOptions options;
options = new DisplayImageOptions.Builder()
.showImageOnLoading(R.drawable.ic_launcher) //設(shè)置圖片在下載期間顯示的圖片
.showImageForEmptyUri(R.drawable.ic_launcher)//設(shè)置圖片Uri為空或是錯誤的時候顯示的圖片
.showImageOnFail(R.drawable.ic_launcher) //設(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è)置圖片加入緩存前,對bitmap進行設(shè)置
//.preProcessor(BitmapProcessor preProcessor)
.resetViewBeforeLoading(true)//設(shè)置圖片在下載前是否重置,復(fù)位
.displayer(new RoundedBitmapDisplayer(20))//是否設(shè)置為圓角,弧度為多少
.displayer(new FadeInBitmapDisplayer(100))//是否圖片加載好后漸入的動畫時間
.build();//構(gòu)建完成
1).imageScaleType(ImageScaleType imageScaleType) 是設(shè)置 圖片的縮放方式
縮放類型mageScaleType:
EXACTLY :圖像將完全按比例縮小的目標大小
EXACTLY_STRETCHED:圖片會縮放到目標大小完全
IN_SAMPLE_INT:圖像將被二次采樣的整數(shù)倍
IN_SAMPLE_POWER_OF_2:圖片將降低2倍,直到下一減少步驟,使圖像更小的目標大小
NONE:圖片不會調(diào)整2).displayer(BitmapDisplayer displayer) 是設(shè)置圖片的顯示方式
顯示方式displayer:
RoundedBitmapDisplayer(int roundPixels)設(shè)置圓角圖片
FakeBitmapDisplayer()這個類什么都沒做
FadeInBitmapDisplayer(int durationMillis)設(shè)置圖片漸顯的時間
SimpleBitmapDisplayer()正常顯示一張圖片
縮放類型mageScaleType:
EXACTLY :圖像將完全按比例縮小的目標大小
EXACTLY_STRETCHED:圖片會縮放到目標大小完全
IN_SAMPLE_INT:圖像將被二次采樣的整數(shù)倍
IN_SAMPLE_POWER_OF_2:圖片將降低2倍,直到下一減少步驟,使圖像更小的目標大小
NONE:圖片不會調(diào)整
之后按照需求調(diào)用
1. 純粹為了加載默認配置的一個圖片的 方法:
public void displayImage(String uri, ImageView imageView) {}
具體實現(xiàn):
ImageLoader.getInstance().displayImage(imageUrl, imageView); // imageUrl代表圖片的URL地址,imageView代表承載圖片的IMAGEVIEW控件
2. 加載自定義配置的一個圖片的 方法:
public void displayImage(String uri, ImageView imageView, DisplayImageOptions options) {}
具體實現(xiàn):
ImageLoader.getInstance().displayImage(imageUrl, imageView,options); // imageUrl代表圖片的URL地址,// imageView代表承載圖片的IMAGEVIEW控件 , // options代表DisplayImageOptions配置文件
3. 圖片加載時候帶加載情況的監(jiān)聽 方法:
public void displayImage(String uri, ImageAware imageAware, DisplayImageOptions options,ImageLoadingListener listener) {}
ImageLoadingListener 用于監(jiān)聽圖片的下載情況。
具體實現(xiàn):
imageLoader.displayImage(imageUrl, imageView, options, new ImageLoadingListener() {
@Override
public void onLoadingStarted() {
//開始加載的時候執(zhí)行
}
@Override
public void onLoadingFailed(FailReason failReason) {
//加載失敗的時候執(zhí)行
}
@Override
public void onLoadingComplete(Bitmap loadedImage) {
//加載成功的時候執(zhí)行
}
@Override
public void onLoadingCancelled() {
//加載取消的時候執(zhí)行
}});
4. 圖片加載時候,帶監(jiān)聽又帶加載進度條的情況
調(diào)用:
public void loadImage(String uri, ImageSize targetImageSize, DisplayImageOptions options, ImageLoadingListener listener, ImageLoadingProgressListener progressListener) {}
具體實現(xiàn):
imageLoader.displayImage(imageUrl, imageView, options, new ImageLoadingListener() {
@Override
public void onLoadingStarted() {
//開始加載的時候執(zhí)行
}
@Override
public void onLoadingFailed(FailReason failReason) {
//加載失敗的時候執(zhí)行
}
@Override
public void onLoadingComplete(Bitmap loadedImage) {
//加載成功的時候執(zhí)行
}
@Override
public void onLoadingCancelled() {
//加載取消的時候執(zhí)行
},new ImageLoadingProgressListener() {
@Override
public void onProgressUpdate(String imageUri, View view, int current,int total) {
//在這里更新 ProgressBar的進度信息
}
});
四、注意事項
1. 上述提到的2個權(quán)限必須加入,否則會出錯
2. ImageLoaderConfiguration必須配置并且全局化的初始化這個配置ImageLoader.getInstance().init(config); 否則也會出現(xiàn)錯誤提示
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();
文章連接: http://www.hsjyfc.com.cn/wzjss/637.html
版權(quán)聲明:文章由 晨展科技 整理收集,來源于互聯(lián)網(wǎng)或者用戶投稿,如有侵權(quán),請聯(lián)系我們,我們會立即刪除。如轉(zhuǎn)載請保留