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

如果说评价一下哪个图片开源库最被广泛使用的话,我想应该可以说是Universal-Image-Loader,在主流的应用中如

果你随便去反编译几个,基本都能看到他的身影,它就像个图片加载守护者,默默的守护着图片加载。相信很多人对

这个异步加载图片框架还不是很熟,再加上最近它更改优化了好几个地方,而网上的大部分资料还是以前的,于是花

了几天时间专门的研究了下开源框架Universal-Image-Loader(实际上是近期项目刚好用到,且仔细的考虑过各种情

况),希望对新手能有所帮助,也希望大神能指点下。

该项目的Github地址链接:https://github.com/nostra13/Android-Universal-Image-Loader

Github登陆不了的可以链接这里下载:点击

一、功能特性:

1、多线程异步加载和显示图片(图片来源于网络、sd卡、assets文件夹,drawable文件夹(不能加载9patch),新增加载视频缩略图)

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

2、支持通过“listener”监视加载的过程,可以暂停加载图片,在经常使用的ListView、GridView中,可以设置滑动时暂

停加载,停止滑动时加载图片(便于节约流量,在一些优化中可以使用)

3、缓存图片至内存时,可以更加高效的工作

4、高度可定制化(可以根据自己的需求进行各种配置,如:线程池,图片下载器,内存缓存策略等)

5、支持图片的内存缓存,SD卡(文件)缓存

6、在网络速度较慢时,还可以对图片进行加载并设置下载监听

二、配置详解

1、下载jar包放在libs文件夹中

注:Maven dependency:

<dependency>
    <groupId>com.nostra13.universalimageloader</groupId>
    <artifactId>universal-image-loader</artifactId>
    <version>1.9.3</version>
</dependency>

Gradle dependency:

compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.3'

2、AndroidManifest.xml

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.INTERNET" />

3、在应用中配置ImageLoaderConfiguration参数(只能配置一次,如多次配置,则默认第一次的配置参数)

a、使用默认设置

	ImageLoaderConfiguration configuration = ImageLoaderConfiguration.createDefault(this);  

b、自己配置参数

	File cacheDir = StorageUtils.getCacheDirectory(context);  //缓存文件夹路径
	ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)
	        .memoryCacheExtraOptions(480, 800) // default = device screen dimensions 内存缓存文件的最大长宽
	        .diskCacheExtraOptions(480, 800, null)  // 本地缓存的详细信息(缓存的最大长宽),最好不要设置这个
	        .taskExecutor(...)
	        .taskExecutorForCachedImages(...)
	        .threadPoolSize(3) // default  线程池内加载的数量
	        .threadPriority(Thread.NORM_PRIORITY - 2) // default 设置当前线程的优先级
	        .tasksProcessingOrder(QueueProcessingType.FIFO) // default
	        .denyCacheImageMultipleSizesInMemory()
	        .memoryCache(new LruMemoryCache(2 * 1024 * 1024)) //可以通过自己的内存缓存实现
	        .memoryCacheSize(2 * 1024 * 1024)  // 内存缓存的最大值
	        .memoryCacheSizePercentage(13) // default
	        .diskCache(new UnlimitedDiscCache(cacheDir)) // default 可以自定义缓存路径
	        .diskCacheSize(50 * 1024 * 1024) // 50 Mb sd卡(本地)缓存的最大值
	        .diskCacheFileCount(100)  // 可以缓存的文件数量
	        // default为使用HASHCODE对UIL进行加密命名, 还可以用MD5(new Md5FileNameGenerator())加密
	        .diskCacheFileNameGenerator(new HashCodeFileNameGenerator())
	        .imageDownloader(new BaseImageDownloader(context)) // default
	        .imageDecoder(new BaseImageDecoder()) // default
	        .defaultDisplayImageOptions(DisplayImageOptions.createSimple()) // default
	        .writeDebugLogs() // 打印debug log
	        .build(); //开始构建 

配置好ImageLoaderConfiguration,一定不要忘记进行初始化操作(一般在application中进行初始化)

ImageLoader.getInstance().init(config);

注:上面的配置请根据自己的需要进行配置,不是所有的都要进行配置的

4、图片显示操作

a、首先要得到ImageLoader的实例(使用的单例模式)

ImageLoader imageLoader = ImageLoader.getInstance(); 

注:在每个显示任务(布局中都需实例化才能进行相关操作

b、相关显示参数配置

DisplayImageOptions options = new DisplayImageOptions.Builder()
		.showImageOnLoading(R.drawable.ic_stub) // 设置图片下载期间显示的图片
		.showImageForEmptyUri(R.drawable.ic_empty) // 设置图片Uri为空或是错误的时候显示的图片
		.showImageOnFail(R.drawable.ic_error) // 设置图片加载或解码过程中发生错误显示的图片
		.resetViewBeforeLoading(false)  // default 设置图片在加载前是否重置、复位
		.delayBeforeLoading(1000)  // 下载前的延迟时间
		.cacheInMemory(false) // default  设置下载的图片是否缓存在内存中
		.cacheOnDisk(false) // default  设置下载的图片是否缓存在SD卡中
		.preProcessor(...)
		.postProcessor(...)
		.extraForDownloader(...)
		.considerExifParams(false) // default
		.imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2) // default 设置图片以如何的编码方式显示
		.bitmapConfig(Bitmap.Config.ARGB_8888) // default 设置图片的解码类型
		.decodingOptions(...)  // 图片的解码设置
		.displayer(new SimpleBitmapDisplayer()) // default  还可以设置圆角图片new RoundedBitmapDisplayer(20)
		.handler(new Handler()) // default
		.build();

注:如果DisplayImageOption没有传递给ImageLoader.displayImage(…)方法,那么从配置默认显示选项

(ImageLoaderConfiguration.defaultDisplayImageOptions(…))将被使用。

    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()正常显示一张图片

参数补充:

.considerExifParams(true)  //是否考虑JPEG图像EXIF参数(旋转,翻转)
.displayer(new FadeInBitmapDisplayer(100))// 图片加载好后渐入的动画时间  

c、显示图片

	1、	ImageLoader.getInstance().displayImage(uri, imageView);
	2、	ImageLoader.getInstance().displayImage(uri, imageView, options);
	3、	ImageLoader.getInstance().displayImage(uri, imageView, listener);
	4、	ImageLoader.getInstance().displayImage(uri, imageView, options, listener);
	5、	ImageLoader.getInstance().displayImage(uri, imageView, options, listener, progressListener);

参数解析:

imageUrl   图片的URL地址
imageView  显示图片的ImageView控件
options    DisplayImageOptions配置信息
listener   图片下载情况的监听
progressListener  图片下载进度的监听

1)方法1:最简单的方式,我们只需要定义要显示的图片的URL和要显示图片的ImageView。这种情况下,图片的显示选项会使用默认的配置

2)方法2:加载自定义配置的一个图片

3)方法3:加载带监听的一个图片

4)方法4:加载自定义配置且带监听的一个图片

5)方法5:加载自定义配置且带监听和进度条的一个图片

		ImageLoader.getInstance().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 (缓存大小超过指定值时,删除最近最少使用的<span style="font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif;">bitmap) --默认值</span>
FIFOLimitedMemoryCache (缓存大小超过指定值时,按先进先出规则删除的<span style="font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif;">bitmap)</span>
LargestLimitedMemoryCache (缓存大小超过指定值时,删除最大的bitmap)
LimitedAgeMemoryCache (缓存对象超过定义的时间后删除)

3)缓存使用弱引用

WeakMemoryCache(没有限制缓存)

6、本地缓存模式可以使用以下已实现的方法 (ImageLoaderConfiguration.diskCache(...))

UnlimitedDiskCache   不限制缓存大小(默认)
TotalSizeLimitedDiskCache (设置总缓存大小,超过时删除最久之前的缓存)
FileCountLimitedDiskCache (设置总缓存文件数量,当到达警戒值时,删除最久之前的缓存。如果文件的大小都一样的时候,可以使用该模式)
LimitedAgeDiskCache (不限制缓存大小,但是设置缓存时间,到期后删除)

五、完美例子(参考源码)

1、项目结构图

Constans主要用来存放图片的url地址的

2、项目效果图

 
   

3、代码讲解

1)权限添加

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.INTERNET" />

2)初始化配置

package com.xwj.imageloaderdemo;

import java.io.File;

import android.app.Application;
import android.content.Context;

import com.nostra13.universalimageloader.cache.disc.impl.UnlimitedDiscCache;
import com.nostra13.universalimageloader.cache.disc.naming.Md5FileNameGenerator;
import com.nostra13.universalimageloader.cache.memory.impl.UsingFreqLimitedMemoryCache;
import com.nostra13.universalimageloader.core.ImageLoader;
import com.nostra13.universalimageloader.core.ImageLoaderConfiguration;
import com.nostra13.universalimageloader.core.assist.QueueProcessingType;
import com.nostra13.universalimageloader.core.download.BaseImageDownloader;
import com.nostra13.universalimageloader.utils.StorageUtils;

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)
				.memoryCacheExtraOptions(480, 800) // max width, max height,即保存的每个缓存文件的最大长宽
				.threadPoolSize(3) //线程池内加载的数量
				.threadPriority(Thread.NORM_PRIORITY - 2)
				.denyCacheImageMultipleSizesInMemory()
				.diskCacheFileNameGenerator(new Md5FileNameGenerator()) //将保存的时候的URI名称用MD5 加密
				.memoryCache(new UsingFreqLimitedMemoryCache(2 * 1024 * 1024)) // You can pass your own memory cache implementation/你可以通过自己的内存缓存实现
				.memoryCacheSize(2 * 1024 * 1024) // 内存缓存的最大值
				.diskCacheSize(50 * 1024 * 1024)  // 50 Mb sd卡(本地)缓存的最大值
				.tasksProcessingOrder(QueueProcessingType.LIFO)
				// 由原先的discCache -> diskCache
				.diskCache(new UnlimitedDiscCache(cacheDir))//自定义缓存路径
				.imageDownloader(new BaseImageDownloader(context, 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超时时间
				.writeDebugLogs() // Remove for release app
				.build();
		//全局初始化此配置
		ImageLoader.getInstance().init(config);
	}
}

注:1.记得在AndroidManifest.xml中添加android:name="com.xwj.imageloaderdemo.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();  // 清除本地缓存
    } 

其余是比较常规的代码,就不多做介绍了,下一篇将详细描述Universal-Image-Loader的各个应用场景

源码下载:点击

时间: 2024-12-30 10:37:17

Android开源框架Universal-Image-Loader详解的相关文章

Android 网络框架之Retrofit2使用详解及从源码中解析原理

就目前来说Retrofit2使用的已相当的广泛,那么我们先来了解下两个问题: 1 . 什么是Retrofit? Retrofit是针对于Android/Java的.基于okHttp的.一种轻量级且安全的.并使用注解方式的网络请求框架. 2 . 我们为什么要使用Retrofit,它有哪些优势? 首先,Retrofit使用注解方式,大大简化了我们的URL拼写形式,而且注解含义一目了然,简单易懂: 其次,Retrofit使用简单,结构层次分明,每一步都能清晰的表达出之所以要使用的寓意: 再者,Retr

开源框架:DBUtils使用详解

一.先熟悉DBUtils的API:  简介:DbUtils是一个为简化JDBC操作的小类库. (一)整个dbutils总共才3个包: 1.包org.apache.commons.dbutils    接口摘要 ResultSetHandler    将ResultSet转换为别的对象的工具. RowProcessor        将ResultSet行转换为别的对象的工具. 类摘要 BasicRowProcessor   RowProcessor接口的基本实现类. BeanProcessor

【Python框架】强大的轻量级开源框架web.py安装详解

Python现在非常火,语法简单而且功能强大,很多同学都想学Python!所以小的给各位看官们准备了高价值Python学习视频教程及相关电子版书籍,都放在了文章结尾,欢迎前来领取! web.py是一个非常强大,轻量的灵活的开源的web框架.著名的社区豆瓣网就使用了web.py开发.所以今天来分享一下web.py的安装... web.py的安装非常简单,几乎也不需要什么配置.是我用过的web框架里面安装配置最简单的了. 环境: Centos6.3 apache(这里也可以不要的,因为web.py自

Android 开源框架Universal-Image-Loader完全解析(二)--- 图片缓存策略详解

本篇文章继续为大家介绍Universal-Image-Loader这个开源的图片加载框架,介绍的是图片缓存策略方面的,如果大家对这个开源框架的使用还不了解,大家可以看看我之前写的一篇文章Android 开源框架Universal-Image-Loader完全解析(一)--- 基本介绍及使用,我们一般去加载大量的图片的时候,都会做缓存策略,缓存又分为内存缓存和硬盘缓存,我之前也写了几篇异步加载大量图片的文章,使用的内存缓存是LruCache这个类,LRU是Least Recently Used 近

Android Loader详解(官方文档翻译)

装载器从android3.0开始引进.它使得在activity或fragment中异步加载数据变得简单.装载器具有如下特性: 它们对每个Activity和Fragment都有效. 他们提供了异步加载数据的能力. 它们监视数据源的一将一动并在内容改变时传送新的结果. 当由于配置改变而被重新创建后,它们自动重连到上一个加载器的游标,所以不必重新查询数据. 装载器API概述 在使用装载器时,会涉及很多类和接口们,我们在下表中对它们总结一下: Class/Interface 说明 LoaderManag

开源项目Universal Image Loader for Android 说明文档 (1) 简介

 When developing applications for Android, one often facesthe problem of displaying some graphical content from the Internet. So, youshould provide image loading from the Web in an Android app, their processingand displaying with limited memory aga

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

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

Android 开源框架Universal-Image-Loader完全解析(三)---源代码解读

本篇文章主要是带大家从源码的角度上面去解读这个强大的图片加载框架,自己很久没有写文章了,感觉生疏了许多,距离上一篇文章三个月多了,确实是自己平常忙,换了工作很多东西都要去看去理解,然后加上自己也懒了,没有以前那么有激情了,我感觉这节奏不对,我要继续保持以前的激情,正所谓好记性不如烂笔头,有时候自己也会去翻看下之前写的东西,我觉得知识写下来比在脑海中留存的更久,今天就给大家来读一读这个框架的源码,我感觉这个图片加载框架确实写的很不错,读完代码自己也学到了很多.我希望大家可以先去看下Android

Android——开源框架Universal-Image-Loader + Fragment使用+轮播广告

原文地址: Android 开源框架Universal-Image-Loader完全解析(一)--- 基本介绍及使用 Android 开源框架Universal-Image-Loader完全解析(二)--- 图片缓存策略详解 Android Fragment使用(一) 基础篇 温故知新 Android Fragment使用(二) 嵌套Fragments (Nested Fragments) 的使用及常见错误 Android Fragment使用(三) Activity, Fragment, We

Android安卓书籍推荐《Android驱动开发与移植实战详解》下载

百度云下载地址:点我 Android凭借其开源性.优异的用户体验和极为方便的开发方式,赢得了广大用户和开发者的青睐,目前已经发展成为市场占有率很高的智能手机操作系统. <Android驱动开发与移植实战详解>分为18章,依次讲解了Android系统的基本知识, Linux内核的基本知识,分析了Android系统的源码,深入分析HAL层的基本知识,GoldFish下的驱动.MSM内核和驱动.OMAP内核和驱动.显示系统驱动.输入系统驱动.振动器系统驱动.音频系统驱动和视频输出系统驱动,多媒体框架