Android-Universal-Image-Loader是一个开源的UI组件程序,该项目的目的是提供一个可重复使用的仪器为异步图像加载,缓存和显示。所以,如果你的程序里需要这个功能的话,那么不妨试试它。因为已经封装好了一些类和方法。我们可以直接拿来用了。而不用重复去写了。其实,写一个这方面的程序还是比较麻烦的,要考虑多线程缓存,内存溢出等很多方面。
Android-Universal-Image-Loader中有三大组件,分别是ImageLoaderConfiguration、ImageLoader和DisplayImageOptions
功能特性
- 多线程异步加载和显示图片(图片的来源:网络、sd卡、assets文件夹,drawable文件夹(不能加载9patch),新增加载视频缩略图)
- 支持通过“listener”监视加载的过程,可以暂停加载图片,在经常使用的ListView、GridView中,可以设置滑动时暂停加载,停止滑动时加载图片(便于节约流量,在一些优化中可以使用)
- 缓存图片至内存时,可以更加高效的工作
- 高度可定制化(可以根据自己的需求进行各种配置,如:线程池,图片下载器,内存缓存策略等)
- 支持图片的内存缓存,SD卡(文件)缓存
- 在网络速度较慢时,还可以对图片进行加载并设置下载监听
配置详解
下载jar包放在libs文件夹中
Gradle dependency
compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.3'
AndroidManifest.xml
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.INTERNET" />
三大组件的配置
ImageLoaderConfiguration
ImageLoaderConfiguration是针对图片缓存的全局配置,主要有线程类、缓存大小、磁盘大小、图片下载与解析、日志方面的配置。在应用中配置ImageLoaderConfiguration参数(只能配置一次,如多次配置,则默认第一次的配置参数)
使用默认设置
ImageLoaderConfiguration configuration = ImageLoaderConfiguration.createDefault(context);
自己配置参数
File cacheDir = StorageUtils.getCacheDirectory(context); //缓存文件夹路径 ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context) //内存缓存文件的最大长宽 default = device screen dimensions .memoryCacheExtraOptions(480, 800) //本地缓存的详细信息(缓存的最大长宽),最好不要设置这个 .diskCacheExtraOptions(480, 800, null) .taskExecutor(...) .taskExecutorForCachedImages(...) //线程池内加载的数量 default .threadPoolSize(3) //设置当前线程的优先级 default .threadPriority(Thread.NORM_PRIORITY - 1) // default .tasksProcessingOrder(QueueProcessingType.FIFO) .denyCacheImageMultipleSizesInMemory() //可以通过自己的内存缓存实现 .memoryCache(new LruMemoryCache(2 * 1024 * 1024)) //内存缓存的最大值 .memoryCacheSize(2 * 1024 * 1024) // default .memoryCacheSizePercentage(13) //可以自定义缓存路径 default .diskCache(new UnlimitedDiscCache(cacheDir)) // 50Mb sd卡(本地)缓存的最大值 .diskCacheSize(50 * 1024 * 1024) // 可以缓存的文件数量 .diskCacheFileCount(100) //default为使用HASHCODE对UIL进行加密命名, 还可以用MD5(new Md5FileNameGenerator())加密 .diskCacheFileNameGenerator(new HashCodeFileNameGenerator()) // default .imageDownloader(new BaseImageDownloader(context)) // default .imageDecoder(new BaseImageDecoder()) // default .defaultDisplayImageOptions(DisplayImageOptions.createSimple()) //打印debug log .writeDebugLogs() //开始构建 .build();
配置好ImageLoaderConfiguration,一定不要忘记进行初始化操作(一般在application中进行初始化)
ImageLoader.getInstance().init(config);
注:上面的配置请根据自己的需要进行配置,不是所有的都要进行配置的
DisplayImageOptions
DisplayImageOptions用于指导每一个Imageloader根据网络图片的状态(空白、下载错误、正在下载)显示对应的图片,是否将缓存加载到磁盘上,下载完后对图片进行怎么样的处理。
配置相关的显示参数
DisplayImageOptions options = new DisplayImageOptions.Builder()
//设置(图片下载期间)显示的图片 resource or drawable
.showImageOnLoading(R.drawable.ic_loading)
//设置(图片Uri为空或是错误的时候)显示的图片 resource or drawable
.showImageForEmptyUri(R.drawable.ic_empty)
//设置(图片加载或解码过程中发生错误的时候)显示的图片 resource or drawable
.showImageOnFail(R.drawable.ic_error)
//设置图片在加载前是否重置、复位 default
.resetViewBeforeLoading(false)
//下载前的延迟时间 1000ms
.delayBeforeLoading(1000)
//设置下载的图片是否缓存在内存中 default
.cacheInMemory(false)
//设置下载的图片是否缓存在SD卡中 default
.cacheOnDisk(false)
.preProcessor(...)
.postProcessor(...)
.extraForDownloader(...)
// default
.considerExifParams(false)
//设置图片以如何的编码方式显示 default
.imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2)
//设置图片的解码类型 default
.bitmapConfig(Bitmap.Config.ARGB_8888)
//图片的解码设置
.decodingOptions(...)
//还可以设置圆角图片new RoundedBitmapDisplayer(20)
.displayer(new SimpleBitmapDisplayer())
// default
.handler(new Handler())
.build();
注:如果DisplayImageOption没有传递给ImageLoader.displayImage(…)方法,那么从配置默认显示选项
(ImageLoaderConfiguration.defaultDisplayImageOptions(…))将被使用。
1).imageScaleType(ImageScaleType imageScaleType) //设置图片的缩放方式
缩放类型ImageScaleType:
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()正常显示一张图片
参数补充:
.considerExifParams(true) //是否考虑JPEG图像EXIF参数(旋转,翻转)
.displayer(new FadeInBitmapDisplayer(100))// 图片加载好后渐入的动画时间
ImageLoader
ImageLoader是具体下载图片,缓存图片,显示图片的具体执行类,它有两个具体的方法displayImage(…)、loadImage(…),但是其实最终他们的实现都是displayImage(…)。
得到ImageLoader的实例(使用的单例模式)
ImageLoader imageLoader = ImageLoader.getInstance();
显示图片
1.imageLoader.displayImage(uri, imageView);
2.imageLoader.displayImage(uri, imageView, options);
3.imageLoader.displayImage(uri, imageView, listener);
4.imageLoader.displayImage(uri, imageView, options, listener);
5.imageLoader.displayImage(uri, imageView, options, listener, progressListener);
1)方法1:最简单的方式,我们只需要定义要显示的图片的URL和要显示图片的ImageView。这种情况下,图片的显示选项会使用默认的配置
2)方法2:加载自定义配置的一个图片
3)方法3:加载带监听的一个图片
4)方法4:加载自定义配置且带监听的一个图片
5)方法5:加载自定义配置且带监听和进度条的一个图片
imageLoader.displayImage(uri, imageView, options,
new ImageLoadingListener() {
@Override
public void onLoadingStarted(String arg0, View arg1) {
//开始加载
}
@Override
public void onLoadingFailed(String arg0, View arg1,
FailReason arg2) {
//加载失败
}
@Override
public void onLoadingComplete(String arg0, View arg1,
Bitmap arg2) {
//加载成功
}
@Override
public void onLoadingCancelled(String arg0, View arg1) {
//加载取消
}
}, new ImageLoadingProgressListener() {
@Override
public void onProgressUpdate(String imageUri, View view,
int current, int total) {
//加载进度
}
});
提示和技巧
1、只有在你需要让Image的尺寸比当前设备的尺寸大的时候,你才需要配置maxImageWidthForMemoryCach(…)和
maxImageHeightForMemoryCache(…)这两个参数,比如放大图片的时候。其他情况下,不需要做这些配置,因为默
认的配置会根据屏幕尺寸以最节约内存的方式处理Bitmap。
2、在设置中配置线程池的大小是非常明智的。一个大的线程池会允许多条线程同时工作,但是也会显著的影响到UI
线程的速度。但是可以通过设置一个较低的优先级来解决:当ImageLoader在使用的时候,可以降低它的优先级,这
样UI线程会更加流畅。在使用List的时候,UI 线程经常会不太流畅,所以在你的程序中最好设置threadPoolSize(…)和
threadPriority(…)这两个参数来优化你的应用。
3、memoryCache(…)和memoryCacheSize(…)这两个参数会互相覆盖,所以在ImageLoaderConfiguration中使用一个就好了
4、diskCacheSize(…)、diskCache(…)和diskCacheFileCount(…)这三个参数会互相覆盖,只使用一个
注:不要使用discCacheSize(…)、discCache(…)和discCacheFileCount(…)这三个参数已经弃用
5、如果你的程序中使用displayImage()方法时传入的参数经常是一样的,那么一个合理的解决方法是,把这些选项配置在ImageLoader的设置中作为默认的选项(通过调用defaultDisplayImageOptions(…)方法)。之后调用displayImage(…)方法的时候就不必再指定这些选项了,如果这些选项没有明确的指定给defaultDisplayImageOptions(…)方法,那调用的时候将会调用UIL的默认设置。
注意事项
1,如果你经常出现oom,你可以尝试:
1)禁用在内存中缓存cacheInMemory(false),如果oom仍然发生那么似乎你的应用程序有内存泄漏,使用MemoryAnalyzer来检测它。否则尝试以下步骤(尝试所有或几个)
2)减少配置的线程池的大小(.threadPoolSize(...)),建议1~5
3)在显示选项中使用 .bitmapConfig(Bitmap.Config.RGB_565) . RGB_565模式消耗的内存比ARGB_8888模式少两倍.
4)配置中使用.diskCacheExtraOptions(480, 320, null)
5)配置中使用 .memoryCache(newWeakMemoryCache()) 或者完全禁用在内存中缓存(don't call .cacheInMemory()).
6)在显示选项中使用.imageScaleType(ImageScaleType.EXACTLY) 或 .imageScaleType(ImageScaleType.IN_SAMPLE_INT)
7)避免使用 RoundedBitmapDisplayer. 调用的时候它使用ARGB-8888模式创建了一个新的Bitmap对象来显示,对于内存缓存模式 (ImageLoaderConfiguration.memoryCache(...)) 你可以使用已经实现好的方法.
2,ImageLoader是根据ImageView的height,width确定图片的宽高
3,一定要对ImageLoaderConfiguration进行初始化,否则会报错
4,开启缓存后默认会缓存到外置SD卡如下地址(/sdcard/Android/data/[package_name]/cache).如果外置SD卡不存在,会缓存到手机. 缓存到Sd卡需要在AndroidManifest.xml文件中进行如下配置
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
5,内存缓存模式可以使用以下已实现的方法 (ImageLoaderConfiguration.memoryCache(…))
1)缓存只使用强引用
LruMemoryCache (缓存大小超过指定值时,删除最近最少使用的bitmap) --默认情况下使用
2)缓存使用弱引用和强引用
UsingFreqLimitedMemoryCache (缓存大小超过指定值时,删除最少使的bitmap)
LRULimitedMemoryCache (缓存大小超过指定值时,删除最近最少使用的bitmap)
FIFOLimitedMemoryCache (缓存大小超过指定值时,按先进先出规则删除的bitmap)
LargestLimitedMemoryCache (缓存大小超过指定值时,删除最大的bitmap)
LimitedAgeMemoryCache (缓存对象超过定义的时间后删除)
3)缓存使用弱引用
WeakMemoryCache(没有限制缓存)
6,本地缓存模式可以使用以下已实现的方法 (ImageLoaderConfiguration.diskCache(…))
UnlimitedDiskCache 不限制缓存大小(默认)
TotalSizeLimitedDiskCache (设置总缓存大小,超过时删除最久之前的缓存)
FileCountLimitedDiskCache (设置总缓存文件数量,当到达警戒值时,删除最久之前的缓存。如果文件的大小都一样的时候,可以使用该模式)
LimitedAgeDiskCache (不限制缓存大小,但是设置缓存时间,到期后删除)
代码讲解
1,添加权限
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET" />
2,初始化配置
public class ImageLoaderApplication extends Application {
public void onCreate() {
super.onCreate();
initImageLoader(getApplicationContext());
}
public static void initImageLoader(Context context) {
//缓存文件的目录
File cacheDir = StorageUtils.getOwnCacheDirectory(context, "imageloader/Cache");
ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)
// max width, max height,即保存的每个缓存文件的最大长宽
.memoryCacheExtraOptions(480, 800)
//线程池内加载的数量
.threadPoolSize(3)
.threadPriority(Thread.NORM_PRIORITY - 2)
.denyCacheImageMultipleSizesInMemory()
//将保存的时候的URI名称用MD5 加密
.diskCacheFileNameGenerator(new Md5FileNameGenerator())
// You can pass your own memory cache implementation/你可以通过自己的内存缓存实现
.memoryCache(new UsingFreqLimitedMemoryCache(2 * 1024 * 1024))
// 内存缓存的最大值
.memoryCacheSize(2 * 1024 * 1024)
// 50 Mb sd卡(本地)缓存的最大值
.diskCacheSize(50 * 1024 * 1024)
.tasksProcessingOrder(QueueProcessingType.LIFO)
// 由原先的discCache -> diskCache
//自定义缓存路径
.diskCache(new UnlimitedDiscCache(cacheDir))
// connectTimeout (5 s), readTimeout (30 s)超时时间
.imageDownloader(new BaseImageDownloader(context, 5 * 1000, 30 * 1000))
// Remove for release app
.writeDebugLogs()
.build();
//全局初始化此配置
ImageLoader.getInstance().init(config);
}
}
注:
1)在AndroidManifest.xml的application标签中添加android:name=”xxx.ImageLoaderApplication”
2)自定义了缓存目录
3,初始化显示配置
// 使用DisplayImageOptions.Builder()创建DisplayImageOptions
options = new DisplayImageOptions.Builder()
.showImageOnLoading(R.drawable.ic_stub) // 设置图片下载期间显示的图片
.showImageForEmptyUri(R.drawable.ic_empty) // 设置图片Uri为空或是错误的时候显示的图片
.showImageOnFail(R.drawable.ic_error) // 设置图片加载或解码过程中发生错误显示的图片
.cacheInMemory(true) // 设置下载的图片是否缓存在内存中
.cacheOnDisk(true) // 设置下载的图片是否缓存在SD卡中
.displayer(new RoundedBitmapDisplayer(20)) // 设置成圆角图片
.build(); // 构建完成
4,显示图片
imageLoader.displayImage(imageUrls[position], viewHolder.image, options);
5,清除缓存
public void onClearMemoryClick(View view) {
Toast.makeText(this, "清除内存缓存成功", Toast.LENGTH_SHORT).show();
ImageLoader.getInstance().clearMemoryCache(); // 清除内存缓存
}
public void onClearDiskClick(View view) {
Toast.makeText(this, "清除本地缓存成功", Toast.LENGTH_SHORT).show();
ImageLoader.getInstance().clearDiskCache(); // 清除本地缓存
}
总结
从三者的协作关系上看,他们有点像厨房规定、客户个人口味、厨师之间的关系。
ImageLoaderConfiguration就像是厨房里面的规定,每一个厨师要怎么着装,要怎么保持厨房的干净,这是针对每一个厨师都适用的规定,而且不允许个性化改变。
DisplayImageOptions就像每个客户的偏好,根据客户是重口味还是清淡,每一个imageLoader根据DisplayImageOptions的要求具体执行。
ImageLoader就像是具体做菜的厨师,负责具体菜谱的制作。