Universal-Image-Loader使用

weixin_42863760

于 2018-12-05 15:08:18 发布

阅读量568

点赞数 1

文章标签： android

Universal-Image-Loader这个开源框架又来给我们造福了，它是一个图片加载框架，主要强大在于可以用于网络等图片源的加载，并且有多重缓存机制。先给出其项目地址：https://github.com/nostra13/Android-Universal-Image-Loader

一、简要说明：

1.多线程下载图片，图片可以来源于网络，文件系统，项目文件夹assets中以及drawable中等
2.支持随意的配置ImageLoader，例如线程池，图片下载器，内存缓存策略，硬盘缓存策略，图片显示选项以及其他的一些配置
3.支持图片的内存缓存，文件系统缓存或者SD卡缓存
4.支持图片下载过程的监听
5.根据控件(ImageView)的大小对Bitmap进行裁剪，减少Bitmap占用过多的内存
6.较好的控制图片的加载过程，例如暂停图片加载，重新开始加载图片，一般使用在ListView,GridView中，滑动过程中暂停加载图片，停止滑动的时候去加载图片
7.提供在较慢的网络下对图片进行加载

二、配置和使用

1.新建一个类继承Application，实现初始化ImageLoader

ImageLoader是一个配置方案，主要是一次性的配置项目中的缓存策略，这样独立的配置很便于模块化。

复制代码
@Override
public void onCreate() {
// TODO 自动生成的方法存根
super.onCreate();

    //通过配置方案来初始化ImageLoader  
    ImageLoader.getInstance().init(ImageLoaderConfiguration configuration);  
}

复制代码

这里的参数是一个ImageLoaderConfiguration，这个对象可以设置缓存，缓存路径等等，下面我们先得到一个默认的配置好的对象。

它使用了Build模式，这样我们就可以很方便的来得到一个默认的配置好的ImageLoaderConfiguration对象

复制代码
/**
* 创建默认的ImageLoader配置参数，这里创建了一个默认的配置方案
* @return
*/
private ImageLoaderConfiguration getDefaultConfig() {
ImageLoaderConfiguration config = ImageLoaderConfiguration.createDefault(getApplicationContext());
return config;
}

复制代码

当然，ImageLoaderConfiguration有多重选项可以配置。下面是各种属性和自己的默认值

复制代码
ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)
.memoryCacheExtraOptions(480, 800) // default = device screen dimensions
.diskCacheExtraOptions(480, 800, CompressFormat.JPEG, 75, null)
.taskExecutor(…)
.taskExecutorForCachedImages(…)
.threadPoolSize(3) // default
.threadPriority(Thread.NORM_PRIORITY - 1) // 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)
.diskCacheFileCount(100)
.diskCacheFileNameGenerator(new HashCodeFileNameGenerator()) // default
.imageDownloader(new BaseImageDownloader(context)) // default
.imageDecoder(new BaseImageDecoder()) // default
.defaultDisplayImageOptions(DisplayImageOptions.createSimple()) // default
.writeDebugLogs()
.build();
复制代码

example：

复制代码
/**
* 所有的配置参数举例
* @return
*/
private ImageLoaderConfiguration getWholeConfig() {
//设置默认的配置，设置缓存，这里不设置可以到别的地方设置
DisplayImageOptions defaultOptions = new DisplayImageOptions.Builder()
.cacheInMemory(true)
.cacheOnDisk(true)
.build();

    //设置缓存的路径
    File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), "imageloader/Cache"); 
       
    ImageLoaderConfiguration config = new ImageLoaderConfiguration  
            .Builder(getApplicationContext())  
            .memoryCacheExtraOptions(480, 800) //即保存的每个缓存文件的最大长宽  
            .threadPoolSize(3) //线程池内加载的数量  
            .threadPriority(Thread.NORM_PRIORITY - 2)  
            //解释：当同一个Uri获取不同大小的图片，缓存到内存时，只缓存一个。默认会缓存多个不同的大小的相同图片  
            .denyCacheImageMultipleSizesInMemory()  //拒绝缓存多个图片。
            .memoryCache(new WeakMemoryCache()) //缓存策略你可以通过自己的内存缓存实现 ，这里用弱引用，缺点是太容易被回收了，不是很好！
            .memoryCacheSize(2 * 1024 * 1024) //设置内存缓存的大小 
            .diskCacheSize(50 * 1024 * 1024) //设置磁盘缓存大小 50M    
            .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //将保存的时候的URI名称用MD5 加密  
            .tasksProcessingOrder(QueueProcessingType.LIFO) //设置图片下载和显示的工作队列排序  
            .diskCacheFileCount(100) //缓存的文件数量  
            .diskCache(new UnlimitedDiskCache(cacheDir)) //自定义缓存路径  
            .defaultDisplayImageOptions(defaultOptions) //显示图片的参数，默认：DisplayImageOptions.createSimple()
            .imageDownloader(new BaseImageDownloader(this, 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超时时间  
            .writeDebugLogs() //打开调试日志
            .build();//开始构建  


    return config;
}

复制代码

刚开始别被吓跑了，其实看起来多，我们一般只需要知道这是做什么的，然后根据自己的需求配置即可。

常用配置：

复制代码
/**
* 比较常用的配置方案
* @return
*/
private ImageLoaderConfiguration getSimpleConfig() {
//设置缓存的路径
File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), “imageloader/Cache”);

    ImageLoaderConfiguration config = new ImageLoaderConfiguration
        .Builder(getApplicationContext())
        .memoryCacheExtraOptions(480, 800) //即保存的每个缓存文件的最大长宽  
        .threadPriority(Thread.NORM_PRIORITY - 2) //线程池中线程的个数
        .denyCacheImageMultipleSizesInMemory() //禁止缓存多张图片
        .memoryCache(new LRULimitedMemoryCache(40*1024*1024)) //缓存策略
        .memoryCacheSize(50 * 1024 * 1024) //设置内存缓存的大小 
        .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //缓存文件名的保存方式
        .diskCacheSize(200 * 1024 * 1024) //磁盘缓存大小
        .tasksProcessingOrder(QueueProcessingType.LIFO) //工作队列
        .diskCacheFileCount(200) //缓存的文件数量  
        .diskCache(new UnlimitedDiskCache(cacheDir)) //自定义缓存路径  
        //.writeDebugLogs() // Remove for release app
        .build();
     return config;
}

复制代码

注：这里面有多个参数是有待商榷的，自己根据需求配置即可！

在Activity中清除缓存的方法：

    //清除缓存
    ImageLoader.getInstance().clearDiskCache();
    ImageLoader.getInstance().clearMemoryCache();

Manifest.xml 中加入权限，并且配置Application！

复制代码

<?xml version="1.0" encoding="utf-8"?>

<!-- 访问internet的权限 -->
<uses-permission android:name="android.permission.INTERNET" />  
<!-- Include next permission if you want to allow UIL to cache images on SD card -->  
<!-- 写入sd卡的权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  

<uses-sdk
    android:minSdkVersion="8"
    android:targetSdkVersion="18" />

<!-- 添加进自己的Application -->
<application
    android:name="com.kale.universalimageloadertest.application.MyApplication"
    android:allowBackup="true"
    android:icon="@drawable/ic_launcher"
    android:label="@string/app_name"
    android:theme="@style/AppTheme" >
    <activity
        android:name=".MainActivity"
        android:label="@string/app_name" >
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />

            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
    <activity android:name="com.kale.universalimageloadertest.UILListActivity"/>
</application>

复制代码

MyApplication.JAVA

复制代码
package com.kale.universalimageloadertest.application;

import java.io.File;

import android.app.Application;

import com.nostra13.universalimageloader.cache.disc.impl.UnlimitedDiskCache;
import com.nostra13.universalimageloader.cache.disc.naming.Md5FileNameGenerator;
import com.nostra13.universalimageloader.cache.memory.impl.FIFOLimitedMemoryCache;
import com.nostra13.universalimageloader.cache.memory.impl.LRULimitedMemoryCache;
import com.nostra13.universalimageloader.cache.memory.impl.WeakMemoryCache;
import com.nostra13.universalimageloader.core.DisplayImageOptions;
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;

/**

@author:Jack Tony
@tips :新建一个MyApplication继承Application，并在onCreate()
中创建ImageLoader的配置参数，并初始化到ImageLoader中代码
@date :2014-10-15
*/
public class MyApplication extends Application{

@Override
public void onCreate() {
// TODO 自动生成的方法存根
super.onCreate();
```
 //通过配置方案来初始化ImageLoader  
 ImageLoader.getInstance().init(getSimpleConfig());  
```
}

/**
- 创建默认的ImageLoader配置参数，这里创建了一个默认的配置方案
- @return
  */
  private ImageLoaderConfiguration getDefaultConfig() {
  ImageLoaderConfiguration config = ImageLoaderConfiguration
  .createDefault(getApplicationContext());
  return config;
  }
/**
- 所有的配置参数举例
- @return
  */
  private ImageLoaderConfiguration getWholeConfig() {
  //设置默认的配置，设置缓存，这里不设置可以到别的地方设置
  DisplayImageOptions defaultOptions = new DisplayImageOptions.Builder()
  .cacheInMemory(true)
  .cacheOnDisk(true)
  .build();
  
  //设置缓存的路径
  File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), “imageloader/Cache”);
  
  ImageLoaderConfiguration config = new ImageLoaderConfiguration
  .Builder(getApplicationContext())
  .memoryCacheExtraOptions(480, 800) //即保存的每个缓存文件的最大长宽
  .threadPoolSize(3) //线程池内加载的数量
  .threadPriority(Thread.NORM_PRIORITY - 2)
  //解释：当同一个Uri获取不同大小的图片，缓存到内存时，只缓存一个。默认会缓存多个不同的大小的相同图片
  .denyCacheImageMultipleSizesInMemory() //拒绝缓存多个图片。
  .memoryCache(new WeakMemoryCache()) //缓存策略你可以通过自己的内存缓存实现，这里用弱引用，缺点是太容易被回收了，不是很好！
  .memoryCacheSize(2 * 1024 * 1024) //设置内存缓存的大小
  .diskCacheSize(50 * 1024 * 1024) //设置磁盘缓存大小 50M
  .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //将保存的时候的URI名称用MD5 加密
  .tasksProcessingOrder(QueueProcessingType.LIFO) //设置图片下载和显示的工作队列排序
  .diskCacheFileCount(100) //缓存的文件数量
  .diskCache(new UnlimitedDiskCache(cacheDir)) //自定义缓存路径
  .defaultDisplayImageOptions(defaultOptions) //显示图片的参数，默认：DisplayImageOptions.createSimple()
  .imageDownloader(new BaseImageDownloader(getApplicationContext(), 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超时时间
  .writeDebugLogs() //打开调试日志
  .build();//开始构建
  return config;
  }
/**
- 比较常用的配置方案
- @return
  */
  private ImageLoaderConfiguration getSimpleConfig() {
  //设置缓存的路径
  File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), “imageloader/Cache”);
  
  ImageLoaderConfiguration config = new ImageLoaderConfiguration
  .Builder(getApplicationContext())
  .memoryCacheExtraOptions(480, 800) //即保存的每个缓存文件的最大长宽
  .threadPriority(Thread.NORM_PRIORITY - 2) //线程池中线程的个数
  .denyCacheImageMultipleSizesInMemory() //禁止缓存多张图片
  .memoryCache(new LRULimitedMemoryCache(50 * 1024 * 1024)) //缓存策略
  .memoryCacheSize(50 * 1024 * 1024) //设置内存缓存的大小
  .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //缓存文件名的保存方式
  .diskCacheSize(200 * 1024 * 1024) //磁盘缓存大小
  .tasksProcessingOrder(QueueProcessingType.LIFO) //工作队列
  .diskCacheFileCount(200) //缓存的文件数量
  .diskCache(new UnlimitedDiskCache(cacheDir)) //自定义缓存路径
  //.writeDebugLogs() // Remove for release app
  .build();
  return config;
  }

/* ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)
.memoryCacheExtraOptions(480, 800) // default = device screen dimensions
.diskCacheExtraOptions(480, 800, CompressFormat.JPEG, 75, null)
.taskExecutor(…)
.taskExecutorForCachedImages(…)
.threadPoolSize(3) // default
.threadPriority(Thread.NORM_PRIORITY - 1) // 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)
.diskCacheFileCount(100)
.diskCacheFileNameGenerator(new HashCodeFileNameGenerator()) // default
.imageDownloader(new BaseImageDownloader(context)) // default
.imageDecoder(new BaseImageDecoder()) // default
.defaultDisplayImageOptions(DisplayImageOptions.createSimple()) // default
.writeDebugLogs()
.build(); */
}
复制代码

Universal-Image-Loader的内存缓存策略

详细的缓存策略可以移步：http://blog.csdn.net/xiaanming/article/details/27525741，下方是总结的结果：

1.强引用缓存
LruMemoryCache（这个类就是这个开源框架默认的内存缓存类，缓存的是bitmap的强引用）

好处：滑动时图片不会容易被清除，体验好；坏处：容易出现OOM

2.使用强引用和弱引用相结合的缓存有
UsingFreqLimitedMemoryCache（如果缓存的图片总量超过限定值，先删除使用频率最小的bitmap）
LRULimitedMemoryCache（这个也是使用的lru算法，和LruMemoryCache不同的是，他缓存的是bitmap的弱引用）
FIFOLimitedMemoryCache（先进先出的缓存策略，当超过设定值，先删除最先加入缓存的bitmap）
LargestLimitedMemoryCache(当超过缓存限定值，先删除最大的bitmap对象)
LimitedAgeMemoryCache（当 bitmap加入缓存中的时间超过我们设定的值，将其删除）

3.只使用弱引用缓存
WeakMemoryCache（这个类缓存bitmap的总大小没有限制，唯一不足的地方就是不稳定，缓存的图片容易被回收掉）

好处：对缓存的bitmap总大小无限制；坏处：使得图片不稳定，图片极其容易被回收

注意：不要使用.cacheInMemory();

Universal-Image-Loader的硬盘缓存策略

详细的硬盘缓存策略可以移步：http://blog.csdn.net/xiaanming/article/details/27525741，下方是总结的结果：

FileCountLimitedDiscCache（可以设定缓存图片的个数，当超过设定值，删除掉最先加入到硬盘的文件）
LimitedAgeDiscCache（设定文件存活的最长时间，当超过这个值，就删除该文件）
TotalSizeLimitedDiscCache（设定缓存bitmap的最大值，当超过这个值，删除最先加入到硬盘的文件）
UnlimitedDiscCache（这个缓存类没有任何的限制）

在ImageLoaderConfiguration中配置了diskCacheSize和diskCacheFileCount，他就使用的是LruDiscCache，否则使用的是UnlimitedDiscCache

在最新的源码中还有一个硬盘缓存类可以配置，那就是LimitedAgeDiscCache，可以在ImageLoaderConfiguration.diskCache(…)配置

避免OOM

为了避免OOM，可以修改下面的配置方案：

.memoryCacheExtraOptions(480, 800) //即保存的每个缓存文件的最大长宽，大小自行配制

.threadPriority(Thread.NORM_PRIORITY - 2) //线程池中线程的个数，一般配置1-5，这里配的是3

.memoryCache(new LRULimitedMemoryCache(4010241024)) //改变缓存策略，可以用弱引用

weixin_42863760

关注

1
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Universal-Image-Loader使用

Universal-Image-Loader这个开源框架又来给我们造福了，它是一个图片加载框架，主要强大在于可以用于网络等图片源的加载，并且有多重缓存机制。先给出其项目地址：https://github.com/nostra13/Android-Universal-Image-Loader一、简要说明：1.多线程下载图片，图片可以来源于网络，文件系统，项目文件夹assets中以及drawabl...
复制链接

扫一扫