Android开源框架Universal-Image-Loader学习使用1

时间：2015-04-20 18:34:16 阅读：256 评论：0 收藏：0 [点我收藏+]

一、工作流程：

1、当请求显示图片，调用ImageLoader.displayImage()，首先会

1）计算显示图片的尺寸大小

2）判断该图片是否已存在缓存中，若No，跳到步骤3，若Yes，跳到步骤9

3）判断图片是否已存在本地，若No，跳到步骤4；若Yes，跳到步骤6

4）判断图片允许存储在本地，若No，跳转到步骤6；若Yes，跳到步骤5

5）将图片存储至本地

6）将Image文件decode成Bitmap文件

7）判断是否允许图片存储到缓存中，若No，跳到步骤9；若yes，跳到步骤8

8）将图片存储至缓存中

9）将图片数据从缓存中取出，显示到ImageView控件上

2、每一个图片的加载和显示任务都运行在独立的线程中，除非这个图片缓存在内存中，这种情况下图片会立即显示。如果需要的图片缓存在本地，他们会开启一个独立的线程队列。如果在缓存中没有正确的图片，任务线程会从线程池中获取，因此，快速显示缓存图片时不会有明显的障碍

3、应用环境：

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

二、使用教程：

1、设置权限

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

2、新建一个Android项目，下载JAR包添加到工程libs目录下

新建一个MyApplication继承Application，并在onCreate()中创建ImageLoader的配置参数，并初始化到ImageLoader中代码如下：

1）使用默认的配置

//创建默认的ImageLoader配置参数
ImageLoaderConfiguration configuration = ImageLoaderConfiguration
.createDefault(this);

  //Initialize ImageLoader with configuration.
ImageLoader.getInstance().init(configuration);

2）自己进行配置：

1>定义缓存路径

File cacheDir = StorageUtils.getCacheDirectory(context);

或者自定义缓存路径：

File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), "imageloader/Cache");

//这个是你希望的缓存文件的目录：imageloader/Cache

之后在ImageLoaderConfiguration的配置文件中通过设置：

.discCache(new UnlimitedDiscCache(cacheDir))//自定义缓存路径

2>配置

ImageLoaderConfiguration config = new ImageLoaderConfiguration
.Builder(context)
.memoryCacheExtraOptions(480, 800) // max width, max height，即保存的每个缓存文件的最大长宽
.discCacheExtraOptions(480, 800, CompressFormat.JPEG, 75, null) // Can slow ImageLoader, use it carefully (Better don‘t use it)/设置缓存的详细信息，最好不要设置这个
.threadPoolSize(3)//线程池内加载的数量
.threadPriority(Thread.NORM_PRIORITY - 2)
.denyCacheImageMultipleSizesInMemory()
.memoryCache(new UsingFreqLimitedMemoryCache(2 * 1024 * 1024)) // You can pass your own memory cache implementation/你可以通过自己的内存缓存实现
.memoryCacheSize(2 * 1024 * 1024)
.discCacheSize(50 * 1024 * 1024)
.discCacheFileNameGenerator(new Md5FileNameGenerator())//将保存的时候的URI名称用MD5 加密
.tasksProcessingOrder(QueueProcessingType.LIFO)
.discCacheFileCount(100) //缓存的文件数量
.discCache(new UnlimitedDiscCache(cacheDir))//自定义缓存路径
.defaultDisplayImageOptions(DisplayImageOptions.createSimple())
.imageDownloader(new BaseImageDownloader(context, 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超时时间
.writeDebugLogs() // Remove for release app
.build();//开始构建
  // Initialize ImageLoader with configuration.
ImageLoader.getInstance().init(config);//全局初始化此配置

上面的这些就是所有的选项配置，我们在项目中不需要每一个都自己设置，一般使用createDefault()创建的ImageLoaderConfiguration就能使用，然后调用ImageLoader的init（）方法将ImageLoaderConfiguration参数传递进去，ImageLoader使用单例模式。

3>在Android Mainfest文件中声明perimisssion及Application

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

3、使用进行加载图片

使用ImageLoader进行图片加载的时候，先要实例化ImageLoader，调用以下方法进行实例化，在每个布局里面都要实例化后再使用。

protected ImageLoader imageLoader = ImageLoader.getInstance(); (前面配置时有提到)

ImageLoader提供了几个图片加载的方法，主要是这几个displayImage(), loadImage(),loadImageSync()，loadImageSync()

方法是同步的，android4.0有个特性，网络操作不能在主线程，所以loadImageSync()方法我们就不去使用

1>首先用到DisplayImageOptions，可以配置一些图片显示的选项，比如图片在加载中ImageView显示的图片，是否需要使用内存缓存，是否需要使用文件缓存等等，可供我们选择的配置如下：

  DisplayImageOptions options;
options = new DisplayImageOptions.Builder()
.showImageOnLoading(R.drawable.ic_launcher) //设置图片在下载期间显示的图片
.showImageForEmptyUri(R.drawable.ic_launcher)//设置图片Uri为空或是错误的时候显示的图片
.showImageOnFail(R.drawable.ic_launcher)  //设置图片加载/解码过程中错误时候显示的图片
.cacheInMemory(true)//设置下载的图片是否缓存在内存中
.cacheOnDisc(true)//设置下载的图片是否缓存在SD卡中
.considerExifParams(true) //是否考虑JPEG图像EXIF参数（旋转，翻转）
.imageScaleType(ImageScaleType.EXACTLY_STRETCHED)//设置图片以如何的编码方式显示
.bitmapConfig(Bitmap.Config.RGB_565)//设置图片的解码类型//
.decodingOptions(android.graphics.BitmapFactory.Options decodingOptions)//设置图片的解码配置
//.delayBeforeLoading(int delayInMillis)//int delayInMillis为你设置的下载前的延迟时间
//设置图片加入缓存前，对bitmap进行设置
//.preProcessor(BitmapProcessor preProcessor)
.resetViewBeforeLoading(true)//设置图片在下载前是否重置，复位
.displayer(new RoundedBitmapDisplayer(20))//是否设置为圆角，弧度为多少
.displayer(new FadeInBitmapDisplayer(100))//是否图片加载好后渐入的动画时间
.build();//构建完成

2>先使用ImageLoader的loadImage()方法来加载网络图片

1.使用ImageLoadingListener()的onLoadingComplete的回调方法

ImageLoader.getInstance().loadImage(imageUrl, new ImageLoadingListener() {
  @Override
  public void onLoadingStarted(String imageUri, View view) {

}
  @Override
  public void onLoadingFailed(String imageUri, View view,
FailReason failReason) {
}
  @Override
  public void onLoadingComplete(String imageUri, View view, Bitmap loadedImage) {
  mImageView.setImageBitmap(loadedImage);
}
  @Override
  public void onLoadingCancelled(String imageUri, View view) {
}
});

2.由上可看到实际上只使用一个回调方法，可以使用SimpleImageLoadingListener类，该类提供了ImageLoaderListener接口方法的空实现，使用的是缺省适配器模式；

final ImageView mImageView = (ImageView) findViewById(R.id.image);
String imageUrl = "https://lh6.googleusercontent.com/-55osAWw3x0Q/URquUtcFr5I/AAAAAAAAAbs/rWlj1RUKrYI/s1024/A%252520Photographer.jpg";
ImageSize mImageSize = new ImageSize(100, 100);//设置图片大小

  //显示图片的配置
DisplayImageOptions options = new DisplayImageOptions.Builder()
.cacheInMemory(true)
.cacheOnDisk(true)
.bitmapConfig(Bitmap.Config.RGB_565)
.build();

ImageLoader.getInstance().loadImage(imageUrl, mImageSize, options, new SimpleImageLoadingListener(){

  @Override
  public void onLoadingComplete(String imageUri, View view,
Bitmap loadedImage) {
  super.onLoadingComplete(imageUri, view, loadedImage);
mImageView.setImageBitmap(loadedImage);
}
});

3>使用displayImage()

displayImage()方法中，对ImageView对象使用的是Weak references，方便垃圾回收器回收ImageView对象，如果我们要加载固定大小的图片的时候，使用loadImage()方法需要传递一个ImageSize对象，而displayImage()方法会根据ImageView对象的测量值，或者android:layout_width and android:layout_height设定的值，或者android:maxWidth and/or android:maxHeight设定的值来裁剪图片

1.纯粹为了加载默认配置的一个图片的

ImageLoader.getInstance().displayImage(imageUrl, imageView); // imageUrl代表图片的URL地址，imageView代表承载图片的IMAGEVIEW控件  

2.加载自定义配置的一个图片的

ImageLoader.getInstance().displayImage(imageUrl, imageView，options); // imageUrl代表图片的URL地址，imageView代表承载图片的IMAGEVIEW控件 ， options代表DisplayImageOptions配置文件  

3.图片加载时候带加载情况的监听ImageLoadingListener 用于监听图片的下载情况。

imageLoader.displayImage(imageUrl, imageView, options, new ImageLoadingListener() {
  @Override
  public void onLoadingStarted() {
//开始加载的时候执行
}
  @Override
  public void onLoadingFailed(FailReason failReason) {
//加载失败的时候执行
}
  @Override
  public void onLoadingComplete(Bitmap loadedImage) {
//加载成功的时候执行
}
  @Override
  public void onLoadingCancelled() {
//加载取消的时候执行
}});

4.图片加载时候，带监听又带加载进度条的情况

imageLoader.displayImage(imageUrl, imageView, options, new ImageLoadingListener() {
  
    @Override  

    public void onLoadingStarted() {
  
       //开始加载的时候执行  

    }  

    @Override  

    public void onLoadingFailed(FailReason failReason) {
        
       //加载失败的时候执行  

    }      

    @Override 
     
    public void onLoadingComplete(Bitmap loadedImage) {
  
       //加载成功的时候执行  

    }      

    @Override 
     
    public void onLoadingCancelled() {
  
       //加载取消的时候执行  

    },new ImageLoadingProgressListener() {
        
      @Override  

      public void onProgressUpdate(String imageUri, View view, int current,int total) {
     
      //在这里更新 ProgressBar的进度信息  

      }  

    });

4、加载其它来源的图片：

1>本地文件

String imagePath = "/mnt/sdcard/image.png";
String imageUrl = Scheme.FILE.wrap(imagePath);
imageLoader.displayImage(imageUrl, mImageView, options);

2>还有来源于Content provider,drawable,assets中，使用的时候也很简单，我们只需要给每个图片来源的地方加上Scheme包裹起来(Content provider除外)，然后当做图片的url传递到imageLoader中，Universal-Image-Loader框架会根据不同的Scheme获取到输入流

//图片来源于Content provider
String contentprividerUrl = "content://media/external/audio/albumart/13";
  //图片来源于assets
String assetsUrl = Scheme.ASSETS.wrap("image.png");
  //图片来源于
String drawableUrl = Scheme.DRAWABLE.wrap("R.drawable.image");

三、避免OOM

虽然这个框架有很好的缓存机制，有效的避免了OOM的产生，一般的情况下产生OOM的概率比较小，但是并不能保证OutOfMemoryError永远不发生，这个框架对于OutOfMemoryError做了简单的catch,保证我们的程序遇到OOM而不被crash掉，但是如果我们使用该框架经常发生OOM，我们应该怎么去改善呢？

减少线程池中线程的个数，在ImageLoaderConfiguration中的（.threadPoolSize）中配置，推荐配置1-5
在DisplayImageOptions选项中配置bitmapConfig为Bitmap.Config.RGB_565，因为默认是ARGB_8888，使用RGB_565会比使用ARGB_8888少消耗2倍的内存
在ImageLoaderConfiguration中配置图片的内存缓存为memoryCache(new WeakMemoryCache()) 或者不使用内存缓存
在DisplayImageOptions选项中设置.imageScaleType(ImageScaleType.IN_SAMPLE_INT)或者imageScaleType(ImageScaleType.EXACTLY)

Android开源框架Universal-Image-Loader学习使用1

原文：http://blog.csdn.net/woliuyunyicai/article/details/45152343

踩

(0)

评论一句话评论（0）

分享档案

更多>

2021年09月23日 (328)
2021年09月24日 (313)
2021年09月17日 (191)
2021年09月15日 (369)
2021年09月16日 (411)
2021年09月13日 (439)
2021年09月11日 (398)
2021年09月12日 (393)
2021年09月10日 (160)
2021年09月08日 (222)