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() {                    @Override                    public 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() {                    @Override                    public 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 ImageView
• Get android:layout_width and android:layout_height parameters
• Get android:maxWidth and/or android:maxHeight parameters
• Get maximum width and/or height parameters from configuration (memoryCacheExtraOptions(int, int) option)
• Get width and/or height of device screen

So try to set android:layout_width|android:layout_height orandroid:maxWidth|android:maxHeight parameters for 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 in your 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 than in 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)