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

青旅半醒 2022-04-16 01:14 124阅读 0赞

**分享一下我老师大神的人工智能教程！零基础，通俗易懂！[http://blog.csdn.net/jiangjunshow][http_blog.csdn.net_jiangjunshow]**

**也欢迎大家转载本篇文章。分享知识，造福人民，实现我们中华民族伟大复兴！**

原文：[http://blog.csdn.net/wei18359100306/article/details/41920677][http_blog.csdn.net_wei18359100306_article_details_41920677]

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

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

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

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

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

该项目的Github地址链接：[https://github.com/nostra13/][https_github.com_nostra13][Android][]\-Universal-Image-Loader

Github登陆不了的可以链接这里下载：[点击][Link 1]

一、功能特性：

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

**\[java\]**  [view plain][view_plain]   [copy][view_plain]

1.  "http://site.com/image.png" // from Web  
2.  "file:///mnt/sdcard/image.png" // from SD card  
3.  "file:///mnt/sdcard/video.mp4" // from SD card (video thumbnail)  
4.  "content://media/external/images/media/13" // from content provider  
5.  "content://media/external/video/media/13" // from content provider (video thumbnail)  
6.  "assets://image.png" // from assets  
7.  "drawable://" + R.drawable.img // from drawables (non-9patch images)

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

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

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

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

5、支持图片的内存缓存，SD卡（文件）缓存

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

二、配置详解

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

注：Maven dependency:

**\[java\]**  [view plain][view_plain]   [copy][view_plain]

1.  <dependency>  
2.      <groupId>com.nostra13.universalimageloader</groupId>  
3.      <artifactId>universal-image-loader</artifactId>  
4.      <version>1.9.3</version>  
5.  </dependency>

Gradle dependency:

**\[java\]**  [view plain][view_plain]   [copy][view_plain]

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

2、AndroidManifest.xml

**\[java\]**  [view plain][view_plain]   [copy][view_plain]

1.  <uses-permission android:name="android.permission.WRITE\_EXTERNAL\_STORAGE" />  
2.  <uses-permission android:name="android.permission.INTERNET" />

3、在应用中配置ImageLoaderConfiguration参数（只能配置一次，如多次配置，则默认第一次的配置参数）

a、使用默认设置

**\[java\]**  [view plain][view_plain]   [copy][view_plain]

1.  ImageLoaderConfiguration configuration = ImageLoaderConfiguration.createDefault(this);

b、自己配置参数

**\[java\]**  [view plain][view_plain]   [copy][view_plain]

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

配置好ImageLoaderConfiguration，一定不要忘记进行初始化操作（一般在application中进行初始化）

**\[java\]**  [view plain][view_plain]   [copy][view_plain]

1.  ImageLoader.getInstance().init(config);

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

4、图片显示操作

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

**\[java\]**  [view plain][view_plain]   [copy][view_plain]

1.  ImageLoader imageLoader = ImageLoader.getInstance();

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

b、相关显示参数配置

**\[java\]**  [view plain][view_plain]   [copy][view_plain]

1.  DisplayImageOptions options = new DisplayImageOptions.Builder()  
2.          .showImageOnLoading(R.drawable.ic\_stub) // 设置图片下载期间显示的图片  
3.          .showImageForEmptyUri(R.drawable.ic\_empty) // 设置图片Uri为空或是错误的时候显示的图片  
4.          .showImageOnFail(R.drawable.ic\_error) // 设置图片加载或解码过程中发生错误显示的图片  
5.          .resetViewBeforeLoading(false)  // default 设置图片在加载前是否重置、复位  
6.          .delayBeforeLoading(1000)  // 下载前的延迟时间  
7.          .cacheInMemory(false) // default  设置下载的图片是否缓存在内存中  
8.          .cacheOnDisk(false) // default  设置下载的图片是否缓存在SD卡中  
9.          .preProcessor(...)  
10.         .postProcessor(...)  
11.         .extraForDownloader(...)  
12.         .considerExifParams(false) // default  
13.         .imageScaleType(ImageScaleType.IN\_SAMPLE\_POWER\_OF\_2) // default 设置图片以如何的编码方式显示  
14.         .bitmapConfig(Bitmap.Config.ARGB\_8888) // default 设置图片的解码类型  
15.         .decodingOptions(...)  // 图片的解码设置  
16.         .displayer(new SimpleBitmapDisplayer()) // default  还可以设置圆角图片new RoundedBitmapDisplayer(20)  
17.         .handler(new Handler()) // default  
18.         .build();

注：如果DisplayImageOption没有传递给ImageLoader.displayImage(…)方法，那么从配置默认显示选项  
(ImageLoaderConfiguration.defaultDisplayImageOptions(…))将被使用。

**\[java\]**  [view plain][view_plain]   [copy][view_plain]

1.    1）.imageScaleType(ImageScaleType imageScaleType)  //设置图片的缩放方式  
2.    缩放类型mageScaleType:  
3.  EXACTLY :图像将完全按比例缩小的目标大小  
4.        EXACTLY\_STRETCHED:图片会缩放到目标大小完全  
5.        IN\_SAMPLE\_INT:图像将被二次采样的整数倍  
6.        IN\_SAMPLE\_POWER\_OF\_2:图片将降低2倍，直到下一减少步骤，使图像更小的目标大小    
7.        NONE:图片不会调整  
8.    2）.displayer(BitmapDisplayer displayer)   //设置图片的显示方式  
9.    显示方式displayer：  
10.     RoundedBitmapDisplayer（int roundPixels）设置圆角图片  
11.     FakeBitmapDisplayer（）这个类什么都没做  
12.     FadeInBitmapDisplayer（int durationMillis）设置图片渐显的时间  
13.     SimpleBitmapDisplayer()正常显示一张图片

参数补充:

**\[java\]**  [view plain][view_plain]   [copy][view_plain]

1.  .considerExifParams(true)  //是否考虑JPEG图像EXIF参数（旋转，翻转）  
2.

[http_blog.csdn.net_jiangjunshow]: https://blog.csdn.net/jiangjunshow/article/details/77338485
[http_blog.csdn.net_wei18359100306_article_details_41920677]: http://www.mincoder.com/article/3800.shtml
[https_github.com_nostra13]: https://github.com/nostra13/Android-Universal-Image-Loader
[Android]: http://lib.csdn.net/base/15
[Link 1]: http://download.csdn.net/detail/wei18359100306/8257179
[view_plain]: http://blog.csdn.net/wei18359100306/article/details/41920677#