ImageLoader的使用

使用配置：

1 导入工程jar包： https://github.com/nostra13/Android-Universal-Image-Loader，找到universal-image-loader-1.9.5.jar

2 写入权限：

<!-- Include following permission if you load images from Internet -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- Include following permission if you want to cache images on SD card -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

3 可导入ImageLoaderUtils进行相关参数配置 :http://download.csdn.net/detail/xiaoleiacm/9535639

ImageLoader相关：

1 初始化ImageLoaderConfiguration

初始化ImageLoaderConfiguration包括内存缓存设置，SD卡缓存设置，以及下载线程相关设置，进行初始化时需要获取屏幕宽高，以及分配给该应用程序的内存大小（总APP内存的八分一）

 /*** 初始化ImageLoaderConfiguration*/private void InitImageLoaderConfiguration() {/**************** 获得屏幕宽高 start **************************/DisplayMetrics displayMetrics = new DisplayMetrics();mContext.getWindowManager().getDefaultDisplay().getMetrics(displayMetrics);int widthPixels = displayMetrics.widthPixels;int heightPixels = displayMetrics.heightPixels;//        System.out.println("widthPixels :" + widthPixels + " heightPixels :" + heightPixels);/***************  获得屏幕宽高 end ****************************//***************  获取内存缓存的1/8 开始 ************************/int maxMemory = (int) Runtime.getRuntime().maxMemory();int cacheSize = maxMemory / 8;/**************  获取内存缓存的1/8 结束 ************************//************设置SD卡缓存储存路径 File Dir 开始 ***********************************/File cacheDirectory = StorageUtils.getOwnCacheDirectory(mContext, "imageloader/Cache");System.out.println(cacheDirectory); //storage/emulated/legacy/imageloader/Cache/************设置SD卡缓存储存路径 File Dir 结束 ***********************************/ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(mContext)/****************************** 内存缓存设置 ****************************/.memoryCacheExtraOptions(widthPixels, heightPixels) // 屏幕宽高.memoryCache(new UsingFreqLimitedMemoryCache(cacheSize)) // 可选择不同的内存缓存方式UsingFreqLimitedMemoryCache.memoryCacheSize(cacheSize).denyCacheImageMultipleSizesInMemory() // 拒绝在缓存中缓存多个URL相同的图片/****************************** 内存缓存设置 ****************************//******************************   SD卡缓存设置 ****************************/.diskCacheExtraOptions(widthPixels, heightPixels, new BitmapProcessor() {@Overridepublic Bitmap process(Bitmap bitmap) {System.out.println("Bitmap :" + bitmap);return null;}}) //储存到SD卡时，对Bitmap进行相应处理,.diskCache(new UnlimitedDiskCache(cacheDirectory)) //无限制大小缓存 ,同时设置缓存储存路径.diskCacheSize(50 * 1024 * 1024)// 缓存大小.diskCacheFileCount(100) //缓存文件数量.diskCacheFileNameGenerator(new Md5FileNameGenerator()) //对于缓存的图片名进行MD5加密/******************************   SD卡缓存设置 ****************************//******************************  线程 开始 ****************************/.threadPoolSize(3).threadPoolSize(Thread.NORM_PRIORITY - 2).tasksProcessingOrder(QueueProcessingType.LIFO)/*不需要外部调用，是线程池相关，在ImageLoaderEngine中调用.taskExecutor().taskExecutorForCachedImages()*/.defaultDisplayImageOptions(options) // 设置默认图片显示选项 下面的option对象DisplayImageOptions.createSimple().imageDownloader(new BaseImageDownloader(mContext, 5 * 1000, 30 * 1000))// connectTimeout (5 s), readTimeout (30 s)超时时间/******************************  线程 结束 ****************************/.build();ImageLoader.getInstance().init(config);}

在设置diskCache时 有以下内存缓存可选项：1. 只使用的是强援用缓存 LruMemoryCache（这个类就是这个开源框架默许的内存缓存类，缓存的是bitmap的强援用）2.使用强援用和弱援用相结合的缓存有UsingFreqLimitedMemoryCache（如果缓存的图片总量超过限定值，先删除使用频率最小的bitmap）LRULimitedMemoryCache（这个也是使用的lru算法，和LruMemoryCache不同的是，他缓存的是bitmap的弱援用）FIFOLimitedMemoryCache（先进先出的缓存策略，当超过设定值，先删除最早加入缓存的bitmap）LargestLimitedMemoryCache(当超过缓存限定值，先删除最大的bitmap对象)LimitedAgeMemoryCache（当 bitmap加入缓存中的时间超过我们设定的值，将其删除）3.只使用弱援用缓存WeakMemoryCache（这个类缓存bitmap的总大小没有限制，唯1不足的地方就是不稳定，缓存的图片容易被回收掉）

2  DisplayImageOptions是进行图片显示的参数，总的包括 图片适配设置，以及显示方式设置

 private DisplayImageOptions InitDisplayImageOptions() {options = new DisplayImageOptions.Builder().showImageOnLoading(R.mipmap.ic_launcher)  //设置在下载期间的图片.showImageForEmptyUri(R.mipmap.ic_launcher) //.showImageOnFail(R.mipmap.ic_launcher).cacheInMemory(true).cacheOnDisk(true)/************ 图片适配设置 开始************************///UIL为了避免将原图放到内存，会根据ImageView的参数来缩小图片的尺寸，这些参数包括//maxWidth 、maxHeight 、layout_width 、layout_height，另外图片是等比压缩的，为了让图片填满整个view，可以设置ImageView的android:scaleType="fitXY"，不过这样如果等比压缩后的图片小于容器的宽和高，会被拉伸变形。.considerExifParams(true)  //是否考虑JPEG图像EXIF参数（旋转，翻转）.imageScaleType(ImageScaleType.EXACTLY_STRETCHED)//设置图片以如何的编码方式显示.bitmapConfig(Bitmap.Config.RGB_565)//设置图片的解码类型///************ 图片适配设置 结束************************//********************* 显示方式 开始****************************/.displayer(new CircleBitmapDisplayer(Color.WHITE, 5))//                    .resetViewBeforeLoading(true)//设置图片在下载前是否重置，复位.displayer(new FadeInBitmapDisplayer(5000)).displayer(new RoundedBitmapDisplayer(100, 5))//是否设置为圆角，弧度为多少/********************* 显示方式 结束****************************/.build();return options;}

note：返回的option传给了ImageLoaderConfiguration 的defaultDisplayImageOptions(options)

以上配置中的：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()正常显示一张图片　　之后按照需求调用

3 图片的加载：

1 单独加载1张图片时：

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

2  使用相应配置文件加载时：（常用）

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

3 加载图片需要监听时：

imageLoader.displayImage(imageUrl, imageView, options, new ImageLoadingListener() {@Overridepublic void onLoadingStarted() {//开始加载的时候执行}@Overridepublic void onLoadingFailed(FailReason failReason) {//加载失败的时候执行}@Overridepublic void onLoadingComplete(Bitmap loadedImage) {//加载成功的时候执行}@Overridepublic void onLoadingCancelled() {//加载取消的时候执行}});  

以下是完整的配置Utils,可作为接口调用：

package com.example.admin.myapplication;import android.app.Activity;import android.content.Context;import android.graphics.Bitmap;import android.graphics.Color;import android.util.DisplayMetrics;import com.nostra13.universalimageloader.cache.disc.impl.UnlimitedDiskCache;import com.nostra13.universalimageloader.cache.disc.naming.Md5FileNameGenerator;import com.nostra13.universalimageloader.cache.memory.impl.UsingFreqLimitedMemoryCache;import com.nostra13.universalimageloader.core.DisplayImageOptions;import com.nostra13.universalimageloader.core.ImageLoader;import com.nostra13.universalimageloader.core.ImageLoaderConfiguration;import com.nostra13.universalimageloader.core.assist.ImageScaleType;import com.nostra13.universalimageloader.core.assist.QueueProcessingType;import com.nostra13.universalimageloader.core.display.CircleBitmapDisplayer;import com.nostra13.universalimageloader.core.display.FadeInBitmapDisplayer;import com.nostra13.universalimageloader.core.display.RoundedBitmapDisplayer;import com.nostra13.universalimageloader.core.download.BaseImageDownloader;import com.nostra13.universalimageloader.core.process.BitmapProcessor;import com.nostra13.universalimageloader.utils.StorageUtils;import java.io.File;/*** Created by admin on 2016/5/30.* note:使用步骤 1：初始化ImageLodaerUtils* 2 调用InitImageLoder* 3 在进行加载时，调用getOption获得DisplayImageOptions参数*/public class ImageLoaderUtils {private Activity mContext;public DisplayImageOptions options; // options选项public ImageLoaderUtils(Activity mContext) {this.mContext = mContext;}/*** 获取Option设置参数** @return*/public DisplayImageOptions getOption() {return options;}/*** 初始化ImageLodaer*/public void InitImageLoder() {InitDisplayImageOptions();InitImageLoaderConfiguration();}/*** 初始化DisplayImageOptions** @return*/private DisplayImageOptions InitDisplayImageOptions() {options = new DisplayImageOptions.Builder().showImageOnLoading(R.mipmap.ic_launcher)  //设置在下载期间的图片.showImageForEmptyUri(R.mipmap.ic_launcher) //.showImageOnFail(R.mipmap.ic_launcher).cacheInMemory(true).cacheOnDisk(true)/************ 图片适配设置 开始************************///UIL为了避免将原图放到内存，会根据ImageView的参数来缩小图片的尺寸，这些参数包括//maxWidth 、maxHeight 、layout_width 、layout_height，另外图片是等比压缩的，为了让图片填满整个view，可以设置ImageView的android:scaleType="fitXY"，不过这样如果等比压缩后的图片小于容器的宽和高，会被拉伸变形。.considerExifParams(true)  //是否考虑JPEG图像EXIF参数（旋转，翻转）.imageScaleType(ImageScaleType.EXACTLY_STRETCHED)//设置图片以如何的编码方式显示.bitmapConfig(Bitmap.Config.RGB_565)//设置图片的解码类型///************ 图片适配设置 结束************************//********************* 显示方式 开始****************************/.displayer(new CircleBitmapDisplayer(Color.WHITE, 5))//                    .resetViewBeforeLoading(true)//设置图片在下载前是否重置，复位.displayer(new FadeInBitmapDisplayer(5000)).displayer(new RoundedBitmapDisplayer(100, 5))//是否设置为圆角，弧度为多少/********************* 显示方式 结束****************************/.build();return options;}/*** 初始化ImageLoaderConfiguration*/private void InitImageLoaderConfiguration() {/**************** 获得屏幕宽高 start **************************/DisplayMetrics displayMetrics = new DisplayMetrics();mContext.getWindowManager().getDefaultDisplay().getMetrics(displayMetrics);int widthPixels = displayMetrics.widthPixels;int heightPixels = displayMetrics.heightPixels;//        System.out.println("widthPixels :" + widthPixels + " heightPixels :" + heightPixels);/***************  获得屏幕宽高 end ****************************//***************  获取内存缓存的1/8 开始 ************************/int maxMemory = (int) Runtime.getRuntime().maxMemory();int cacheSize = maxMemory / 8;/**************  获取内存缓存的1/8 结束 ************************//************设置SD卡缓存储存路径 File Dir 开始 ***********************************/File cacheDirectory = StorageUtils.getOwnCacheDirectory(mContext, "imageloader/Cache");System.out.println(cacheDirectory); //storage/emulated/legacy/imageloader/Cache/************设置SD卡缓存储存路径 File Dir 结束 ***********************************/ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(mContext)/****************************** 内存缓存设置 ****************************/.memoryCacheExtraOptions(widthPixels, heightPixels) // 屏幕宽高.memoryCache(new UsingFreqLimitedMemoryCache(cacheSize)) // 可选择不同的内存缓存方式UsingFreqLimitedMemoryCache.memoryCacheSize(cacheSize).denyCacheImageMultipleSizesInMemory() // 拒绝在缓存中缓存多个URL相同的图片/****************************** 内存缓存设置 ****************************//******************************   SD卡缓存设置 ****************************/.diskCacheExtraOptions(widthPixels, heightPixels, new BitmapProcessor() {@Overridepublic Bitmap process(Bitmap bitmap) {System.out.println("Bitmap :" + bitmap);return null;}}) //储存到SD卡时，对Bitmap进行相应处理,.diskCache(new UnlimitedDiskCache(cacheDirectory)) //无限制大小缓存 ,同时设置缓存储存路径.diskCacheSize(50 * 1024 * 1024)// 缓存大小.diskCacheFileCount(100) //缓存文件数量.diskCacheFileNameGenerator(new Md5FileNameGenerator()) //对于缓存的图片名进行MD5加密/******************************   SD卡缓存设置 ****************************//******************************  线程 开始 ****************************/.threadPoolSize(3).threadPoolSize(Thread.NORM_PRIORITY - 2).tasksProcessingOrder(QueueProcessingType.LIFO)/*不需要外部调用，是线程池相关，在ImageLoaderEngine中调用.taskExecutor().taskExecutorForCachedImages()*/.defaultDisplayImageOptions(options) // 设置默认图片显示选项 下面的option对象DisplayImageOptions.createSimple().imageDownloader(new BaseImageDownloader(mContext, 5 * 1000, 30 * 1000))// connectTimeout (5 s), readTimeout (30 s)超时时间/******************************  线程 结束 ****************************/.build();ImageLoader.getInstance().init(config);}}

在调用时使用：

 imageLoaderUtils = new ImageLoaderUtils(MainActivity.this);imageLoaderUtils.InitImageLoder();ImageLoader.getInstance().displayImage(Constants.IMAGES[position], viewHolder.image, imageLoaderUtils.getOption());

Note:

1 UIL会根据layout_height ,layout_width,maxWidth,maxHeight来适配相应图片的大小

How UIL define Bitmap size needed for exact ImageView? It searches defined parameters:Get actual measured width and height of ImageViewGet 

android:layout_width

 and 

android:layout_height

 parametersGet 

android:maxWidth

 and/or 

android:maxHeight

 parametersGet maximum width and/or height parameters from configuration (

memoryCacheExtraOptions(int, int)

 option)Get width and/or height of device screenSo try to set 

android:layout_width

|

android:layout_height

 or

android:maxWidth

|

android:maxHeight

 parametersfor ImageView if you know approximate maximum size of it. It will help correctly compute Bitmap size needed for this view and save memory.

2 OOM问题

 If you often got OutOfMemoryError inyour app using Universal Image Loader then:Disable caching in memory. If OOM is still occurs then it seems your app has a memory leak. Use MemoryAnalyzer to detect it. Otherwise try the following steps (all of them or several):Reduce thread pool size in configuration (

.threadPoolSize(...)

). 1 - 5 is recommended.Use 

.bitmapConfig(Bitmap.Config.RGB_565)

 in display options. Bitmaps in RGB_565 consume 2 times less memory thanin ARGB_8888.Use 

.imageScaleType(ImageScaleType.EXACTLY)

Use 

.diskCacheExtraOptions(480, 320, null)

 in configuration

3 URL example

"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)