Android图片加载框架 Universal-Image-Loader 妙用

Android开源框架Universal-Image-Loader就像图片加载守护者，为我们提供了丰富的功能特性：
（1）多线程加载图像（异步或同步）；
（2）高度可定制化imageloader配置（线程池、图片下载器、解码器、内存和磁盘缓存、显示图像选项等）；
（3）每一个显示图像有许多自定义选项（存根图片，缓存开关，解码选项，位图处理和显示等）；
（4）支持内存和磁盘上的图像缓存（设备的文件系统和SD卡）；
（5）监听加载过程（包括下载进度）；

下来我们详解如何配置使用Universal-Image-Loader来加载网络图片

1.下载Universal-Image-Loader

Github下载：
https://github.com/nostra13/Android-Universal-Image-Loader
Maven下载：
http://central.maven.org/maven2/com/nostra13/universalimageloader/universal-image-loader/

2.使用Universal-Image-Loader

（1）首先关联Universal-Image-Loader的库文件。然后在Application的onCreate中初始化ImageLoader

public class MyApplication extends Application{
    @Override
    public void onCreate() {
        super.onCreate();
        initImageLoader(this);
    }

    public static void initImageLoader(Context context) {
        // This configuration tuning is custom. You can tune every option, you may tune some of them,
        // or you can create default configuration by
        ImageLoaderConfiguration.Builder config = new ImageLoaderConfiguration.Builder(context);
        config.threadPriority(Thread.NORM_PRIORITY - 2);
        config.denyCacheImageMultipleSizesInMemory(); // 不会在内存中缓存多个大小的图片
        config.diskCacheFileNameGenerator(new Md5FileNameGenerator()); // 为了保证图片名称唯一
        config.diskCacheSize(50 * 1024 * 1024); // 50 MiB
        // 内存缓存大小默认是：app可用内存的1/8
        config.tasksProcessingOrder(QueueProcessingType.LIFO);
        config.writeDebugLogs(); // Remove for release app
        // Initialize ImageLoader with configuration.
        ImageLoader.getInstance().init(config.build());
    //ImageLoader.getInstance().init(ImageLoaderConfiguration.createDefault(this));
    }
}

（2）在AndroidManifest中配置Application

（3）在MyImageApadter中加载图片，初始化DisplayImageOptions（为了方便使用，我们将其抽取成一个类）

/**
 * Universal-Image-Loader-master options参数
 */
public interface ImageLoaderOptions {
    DisplayImageOptions options = new DisplayImageOptions.Builder() 
        .showImageOnLoading(R.drawable.ic_default)// 加载图片过程中显示哪张图片
        .showImageForEmptyUri(R.drawable.ic_default)// url为空的话显示哪张图片
        .showImageOnFail(R.drawable.ic_default)// 加载图片失败显示哪张图片
        .cacheInMemory(true)// 在内存中缓存该图片
        .cacheOnDisk(true)// 在硬盘中缓存该图片
        .imageScaleType(ImageScaleType.EXACTLY)// 将会对图片进一步缩放，缩放的程度参考ImageVIew的宽高
        .bitmapConfig(Bitmap.Config.RGB_565)// 该种渲染模式也是比较节省内存的
        .considerExifParams(true)// 会识别图片的方向信息
        // .displayer(new FadeInBitmapDisplayer(800)).build();//渐渐显示的动画效果
        .displayer(new RoundedBitmapDisplayer(28)).build();// 圆角的效果
    // 显示大图的options
    DisplayImageOptions pager_options = new DisplayImageOptions.Builder()
        .showImageOnLoading(R.drawable.ic_default)// 加载图片过程中显示哪张图片
        .showImageForEmptyUri(R.drawable.ic_default)// url为空的话显示哪张图片
        .showImageOnFail(R.drawable.ic_default)// 加载图片失败显示哪张图片
        .cacheInMemory(false)// 不在内存中缓存该图片
        .cacheOnDisk(true)// 在硬盘中缓存该图片
        .imageScaleType(ImageScaleType.EXACTLY)// 将会对图片进一步缩放，缩放的程度参考ImageVIew的宽高
        .bitmapConfig(Bitmap.Config.RGB_565)// 该种渲染模式也是比较节省内存的
        .considerExifParams(true)// 会识别图片的方向信息
        .displayer(new FadeInBitmapDisplayer(500)).build();// 渐渐显示的动画效果
    // .displayer(new RoundedBitmapDisplayer(28)).build();// 圆角的效果
}

（4）在getView方法中调用加载图片

/**
 * displayImage(uri, imageView, options, listener, progressListener);  
 * 参数解析：
 *      imageUrl : 图片的URL地址  
 *      imageView : 显示图片的ImageView控件    
 *      options : DisplayImageOptions配置信息   
 *      listener : 图片下载情况的监听  
 *      progressListener : 图片下载进度的监听  
 */
//加载图片
ImageLoader.getInstance().displayImage(Url.IMAGE, holder.iv_icon, ImageLoaderOptions.options);

–>拓展
渐渐显示的动画效果和圆角的效果不能同时设置，解决方法：我们在（3）中设置圆角效果，然后舍弃（4）的方法加载图片，而采用下面方法，到此，我们鱼与熊掌兼得。

//加载图片
ImageLoader.getInstance().displayImage(Url.IMAGE,holder.iv_icon, options
        ,new SimpleImageLoadingListener(){
    @Override
    public void onLoadingComplete(String imageUri, View view,
            Bitmap loadedImage) {
        super.onLoadingComplete(imageUri, view, loadedImage);
        FadeInBitmapDisplayer.animate(view, 800);//渐渐显示的效果
    }
});

3.使用中常见问题与解决方法

（1）遇到横屏大图（width>height），低配置的手机或有的手机无法显示图片的问题

解决方法：在应用中配置ImageLoaderConfiguration参数，最好在Application中进行设置和配置（如上的MyApplication.java中），只能配置一次，如多次配置，则系统默认第一次的配置参数。

ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(
    getApplicationContext())
        .memoryCacheExtraOptions(480, 800) // 保存每个缓存图片的最大长和宽
        .threadPoolSize(3) // 线程池的大小 这个其实默认就是3
        .threadPriority(Thread. NORM_PRIORITY - 2) //设置线程优先级
        .denyCacheImageMultipleSizesInMemory() // 当同一个Uri获取不同大小的图片，缓存到内存时，只缓存一个。默认会缓存多个不同的大小的相同图片
        .memoryCache( new UsingFreqLimitedMemoryCache(2 * 1024 * 1024))
        .memoryCacheSize(2 * 1024 * 1024) // 设置缓存的最大字节
        .tasksProcessingOrder(QueueProcessingType. LIFO) //设置图片下载和显示的工作队列排序
        .defaultDisplayImageOptions(DisplayImageOptions. createSimple())
        .imageDownloader(new BaseImageDownloader(getApplicationContext(),
                5 * 1000, 30 * 1000))// connectTimeout ： 超时时间
        .writeDebugLogs().build(); // 开始构建
ImageLoader. getInstance().init(config); // 全局初始化此配置

按上面的设置和配置就解决了横屏大图在某些手机上不显示的问题，建议在Application中进行设置和配置，代码中配置的缺点：用一次配一次。

（2）低配置手机中大量图片时经常发生OOM的问题

项目中图片数量大、大小也大，在后台收集到的crash信息中看到发生了大量的OOM现象。

解决方法：
1）禁用在内存中缓存cacheInMemory(false)
2）减少配置的线程池的大小(.threadPoolSize(…))，建议1~5
3）在显示选项中使用 .bitmapConfig(Bitmap.Config.RGB_565) 因为RGB_565模式消耗的内存比ARGB_8888模式少两倍
4）配置中使用 .memoryCache(newWeakMemoryCache()) 或者完全禁用在内存中缓存
5）在显示选项中使用.imageScaleType(ImageScaleType.EXACTLY) 或 .imageScaleType(ImageScaleType.IN_SAMPLE_INT)
6）避免使用 RoundedBitmapDisplayer. 调用的时候它使用ARGB-8888模式创建了一个新的Bitmap对象来显示

上面的条件，不一定都这样设置，可能改变其中的一些选项进行设置就能解决问题，对此要灵活运用

4.相关使用技巧

（1）只有在你需要让Image的尺寸比当前设备的尺寸大的时候，你才需要配置maxImageWidthForMemoryCache( )和maxImageHeightForMemoryCache( )这两个参数，比如缩放图片的时候。其他情况下，不需要做这些配置，因为默认的配置会根据屏幕尺寸以最节约内存的方式处理Bitmap。

（2）在设置中配置线程池的大小。一个大的线程池会允许多条线程同时工作，但是也会显著的影响到UI线程的速度。但是可以通过设置一个较低的优先级来解决：当ImageLoader在使用的时候，可以降低它的优先级，这样UI线程会更加流畅。在使用ListView的时候，UI 线程经常会不太流畅，所以在你的程序中最好设置threadPoolSize( )和threadPriority( )这两个参数来优化你的应用。

（3）memoryCache( )和memoryCacheSize( )这两个参数会互相覆盖，所以在ImageLoaderConfiguration中使用一个即可。

（4）diskCacheSize( )、diskCache( )和diskCacheFileCount( )这三个参数会互相覆盖，只使用一个即可。

特别注意：不要使用discCacheSize( )、discCache( )和discCacheFileCount( )这三个参数，因为他们已经弃用了。