码迷,mamicode.com
首页 > 移动开发 > 详细

Android开源框架 Android-Universal-Image-Loader

时间:2016-05-26 10:27:34      阅读:612      评论:0      收藏:1      [点我收藏+]

标签:

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( )这三个参数,因为他们已经弃用了。

Android开源框架 Android-Universal-Image-Loader

标签:

原文地址:http://blog.csdn.net/smartbetter/article/details/51504506

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!