ImageLoader的使用

Posted 2022-11-28 xiaoleiacm

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了ImageLoader的使用相关的知识，希望对你有一定的参考价值。

使用配置：

1 导入工程jar包：

https://github.com/nostra13/android-Universal-Image-Loader，找到universal-image-loader-1.9.5.jar

2 写入权限：

<!-- Include following permission if you load images from Internet -->
    <uses-permission android:name="android.permission.INTERNET" />
    <!-- Include following permission if you want to cache images on SD card -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
3 可导入ImageLoaderUtils进行相关参数配置 :http://download.csdn.net/detail/xiaoleiacm/9535639

ImageLoader相关：

1 初始化ImageLoaderConfiguration

初始化ImageLoaderConfiguration包括内存缓存设置，SD卡缓存设置，以及下载线程相关设置，进行初始化时需要获取屏幕宽高，以及分配给该应用程序的内存大小（总APP内存的八分一）

 /**
     * 初始化ImageLoaderConfiguration
     */
    private void InitImageLoaderConfiguration() 


        /**************** 获得屏幕宽高 start **************************/
        DisplayMetrics displayMetrics = new DisplayMetrics();
        mContext.getWindowManager().getDefaultDisplay().getMetrics(displayMetrics);
        int widthPixels = displayMetrics.widthPixels;
        int heightPixels = displayMetrics.heightPixels;
//        System.out.println("widthPixels :" + widthPixels + " heightPixels :" + heightPixels);
        /***************  获得屏幕宽高 end ****************************/

        /***************  获取内存缓存的1/8 开始 ************************/
        int maxMemory = (int) Runtime.getRuntime().maxMemory();
        int cacheSize = maxMemory / 8;
        /**************  获取内存缓存的1/8 结束 ************************/


        /************设置SD卡缓存储存路径 File Dir 开始 ***********************************/
        File cacheDirectory = StorageUtils.getOwnCacheDirectory(mContext, "imageloader/Cache");
        System.out.println(cacheDirectory); //storage/emulated/legacy/imageloader/Cache
        /************设置SD卡缓存储存路径 File Dir 结束 ***********************************/


        ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(mContext)


                /****************************** 内存缓存设置 ****************************/
                .memoryCacheExtraOptions(widthPixels, heightPixels) // 屏幕宽高
                .memoryCache(new UsingFreqLimitedMemoryCache(cacheSize)) // 可选择不同的内存缓存方式UsingFreqLimitedMemoryCache
                .memoryCacheSize(cacheSize)
                .denyCacheImageMultipleSizesInMemory() // 拒绝在缓存中缓存多个URL相同的图片
                        /****************************** 内存缓存设置 ****************************/


                        /******************************   SD卡缓存设置 ****************************/
                .diskCacheExtraOptions(widthPixels, heightPixels, new BitmapProcessor() 
                    @Override
                    public Bitmap process(Bitmap bitmap) 
                        System.out.println("Bitmap :" + bitmap);
                        return null;
                    
                ) //储存到SD卡时，对Bitmap进行相应处理,
                .diskCache(new UnlimitedDiskCache(cacheDirectory)) //无限制大小缓存 ,同时设置缓存储存路径
                .diskCacheSize(50 * 1024 * 1024)// 缓存大小
                .diskCacheFileCount(100) //缓存文件数量
                .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //对于缓存的图片名进行MD5加密
                        /******************************   SD卡缓存设置 ****************************/


                        /******************************  线程 开始 ****************************/
                .threadPoolSize(3)
                .threadPoolSize(Thread.NORM_PRIORITY - 2)
                .tasksProcessingOrder(QueueProcessingType.LIFO)
                 /*不需要外部调用，是线程池相关，在ImageLoaderEngine中调用
                .taskExecutor()
                .taskExecutorForCachedImages()
                */
                .defaultDisplayImageOptions(options) // 设置默认图片显示选项 下面的option对象DisplayImageOptions.createSimple()
                .imageDownloader(new BaseImageDownloader(mContext, 5 * 1000, 30 * 1000))// connectTimeout (5 s), readTimeout (30 s)超时时间

                        /******************************  线程 结束 ****************************/


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

在设置diskCache时有以下内存缓存可选项：

1. 只使用的是强援用缓存

LruMemoryCache（这个类就是这个开源框架默许的内存缓存类，缓存的是bitmap的强援用）

2.使用强援用和弱援用相结合的缓存有

UsingFreqLimitedMemoryCache（如果缓存的图片总量超过限定值，先删除使用频率最小的bitmap）

LRULimitedMemoryCache（这个也是使用的lru算法，和LruMemoryCache不同的是，他缓存的是bitmap的弱援用）

FIFOLimitedMemoryCache（先进先出的缓存策略，当超过设定值，先删除最早加入缓存的bitmap）

LargestLimitedMemoryCache(当超过缓存限定值，先删除最大的bitmap对象)

LimitedAgeMemoryCache（当 bitmap加入缓存中的时间超过我们设定的值，将其删除）

3.只使用弱援用缓存

WeakMemoryCache（这个类缓存bitmap的总大小没有限制，唯1不足的地方就是不稳定，缓存的图片容易被回收掉）

2 DisplayImageOptions是进行图片显示的参数，总的包括图片适配设置，以及显示方式设置

 private DisplayImageOptions InitDisplayImageOptions() 


        options = new DisplayImageOptions.Builder()
                .showImageOnLoading(R.mipmap.ic_launcher)  //设置在下载期间的图片
                .showImageForEmptyUri(R.mipmap.ic_launcher) //
                .showImageOnFail(R.mipmap.ic_launcher)
                .cacheInMemory(true)
                .cacheOnDisk(true)


                        /************ 图片适配设置 开始************************/
                        //UIL为了避免将原图放到内存，会根据ImageView的参数来缩小图片的尺寸，这些参数包括
                        //maxWidth 、maxHeight 、layout_width 、layout_height，另外图片是等比压缩的，为了让图片填满整个view，可以设置ImageView的android:scaleType="fitXY"，不过这样如果等比压缩后的图片小于容器的宽和高，会被拉伸变形。
                .considerExifParams(true)  //是否考虑JPEG图像EXIF参数（旋转，翻转）
                .imageScaleType(ImageScaleType.EXACTLY_STRETCHED)//设置图片以如何的编码方式显示
                .bitmapConfig(Bitmap.Config.RGB_565)//设置图片的解码类型//
                        /************ 图片适配设置 结束************************/

                        /********************* 显示方式 开始****************************/
                .displayer(new CircleBitmapDisplayer(Color.WHITE, 5))
//                    .resetViewBeforeLoading(true)//设置图片在下载前是否重置，复位
                .displayer(new FadeInBitmapDisplayer(5000))
                .displayer(new RoundedBitmapDisplayer(100, 5))//是否设置为圆角，弧度为多少
                        /********************* 显示方式 结束****************************/


                .build();


        return options;

note：返回的option传给了ImageLoaderConfiguration 的defaultDisplayImageOptions(options)

以上配置中的：

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

 

之后按照需求调用

3 图片的加载：

1 单独加载1张图片时：

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

2 使用相应配置文件加载时：（常用）

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

3 加载图片需要监听时：

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() 
        //加载取消的时候执行  

        );

以下是完整的配置Utils,可作为接口调用：

package com.example.admin.myapplication;

import android.app.Activity;
import android.content.Context;
import android.graphics.Bitmap;
import android.graphics.Color;
import android.util.DisplayMetrics;

import com.nostra13.universalimageloader.cache.disc.impl.UnlimitedDiskCache;
import com.nostra13.universalimageloader.cache.disc.naming.Md5FileNameGenerator;
import com.nostra13.universalimageloader.cache.memory.impl.UsingFreqLimitedMemoryCache;
import com.nostra13.universalimageloader.core.DisplayImageOptions;
import com.nostra13.universalimageloader.core.ImageLoader;
import com.nostra13.universalimageloader.core.ImageLoaderConfiguration;
import com.nostra13.universalimageloader.core.assist.ImageScaleType;
import com.nostra13.universalimageloader.core.assist.QueueProcessingType;
import com.nostra13.universalimageloader.core.display.CircleBitmapDisplayer;
import com.nostra13.universalimageloader.core.display.FadeInBitmapDisplayer;
import com.nostra13.universalimageloader.core.display.RoundedBitmapDisplayer;
import com.nostra13.universalimageloader.core.download.BaseImageDownloader;
import com.nostra13.universalimageloader.core.process.BitmapProcessor;
import com.nostra13.universalimageloader.utils.StorageUtils;

import java.io.File;

/**
 * Created by admin on 2016/5/30.
 * note:使用步骤 1：初始化ImageLodaerUtils
 * 2 调用InitImageLoder
 * 3 在进行加载时，调用getOption获得DisplayImageOptions参数
 */
public class ImageLoaderUtils 
    private Activity mContext;

    public DisplayImageOptions options; // options选项

    public ImageLoaderUtils(Activity mContext) 
        this.mContext = mContext;
    

    /**
     * 获取Option设置参数
     *
     * @return
     */
    public DisplayImageOptions getOption() 
        return options;
    

    /**
     * 初始化ImageLodaer
     */
    public void InitImageLoder() 
        InitDisplayImageOptions();
        InitImageLoaderConfiguration();
    

    /**
     * 初始化DisplayImageOptions
     *
     * @return
     */
    private DisplayImageOptions InitDisplayImageOptions() 


        options = new DisplayImageOptions.Builder()
                .showImageOnLoading(R.mipmap.ic_launcher)  //设置在下载期间的图片
                .showImageForEmptyUri(R.mipmap.ic_launcher) //
                .showImageOnFail(R.mipmap.ic_launcher)
                .cacheInMemory(true)
                .cacheOnDisk(true)


                        /************ 图片适配设置 开始************************/
                        //UIL为了避免将原图放到内存，会根据ImageView的参数来缩小图片的尺寸，这些参数包括
                        //maxWidth 、maxHeight 、layout_width 、layout_height，另外图片是等比压缩的，为了让图片填满整个view，可以设置ImageView的android:scaleType="fitXY"，不过这样如果等比压缩后的图片小于容器的宽和高，会被拉伸变形。
                .considerExifParams(true)  //是否考虑JPEG图像EXIF参数（旋转，翻转）
                .imageScaleType(ImageScaleType.EXACTLY_STRETCHED)//设置图片以如何的编码方式显示
                .bitmapConfig(Bitmap.Config.RGB_565)//设置图片的解码类型//
                        /************ 图片适配设置 结束************************/

                        /********************* 显示方式 开始****************************/
                .displayer(new CircleBitmapDisplayer(Color.WHITE, 5))
//                    .resetViewBeforeLoading(true)//设置图片在下载前是否重置，复位
                .displayer(new FadeInBitmapDisplayer(5000))
                .displayer(new RoundedBitmapDisplayer(100, 5))//是否设置为圆角，弧度为多少
                        /********************* 显示方式 结束****************************/


                .build();


        return options;

    

    /**
     * 初始化ImageLoaderConfiguration
     */
    private void InitImageLoaderConfiguration() 


        /**************** 获得屏幕宽高 start **************************/
        DisplayMetrics displayMetrics = new DisplayMetrics();
        mContext.getWindowManager().getDefaultDisplay().getMetrics(displayMetrics);
        int widthPixels = displayMetrics.widthPixels;
        int heightPixels = displayMetrics.heightPixels;
//        System.out.println("widthPixels :" + widthPixels + " heightPixels :" + heightPixels);
        /***************  获得屏幕宽高 end ****************************/

        /***************  获取内存缓存的1/8 开始 ************************/
        int maxMemory = (int) Runtime.getRuntime().maxMemory();
        int cacheSize = maxMemory / 8;
        /**************  获取内存缓存的1/8 结束 ************************/


        /************设置SD卡缓存储存路径 File Dir 开始 ***********************************/
        File cacheDirectory = StorageUtils.getOwnCacheDirectory(mContext, "imageloader/Cache");
        System.out.println(cacheDirectory); //storage/emulated/legacy/imageloader/Cache
        /************设置SD卡缓存储存路径 File Dir 结束 ***********************************/


        ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(mContext)


                /****************************** 内存缓存设置 ****************************/
                .memoryCacheExtraOptions(widthPixels, heightPixels) // 屏幕宽高
                .memoryCache(new UsingFreqLimitedMemoryCache(cacheSize)) // 可选择不同的内存缓存方式UsingFreqLimitedMemoryCache
                .memoryCacheSize(cacheSize)
                .denyCacheImageMultipleSizesInMemory() // 拒绝在缓存中缓存多个URL相同的图片
                        /****************************** 内存缓存设置 ****************************/


                        /******************************   SD卡缓存设置 ****************************/
                .diskCacheExtraOptions(widthPixels, heightPixels, new BitmapProcessor() 
                    @Override
                    public Bitmap process(Bitmap bitmap) 
                        System.out.println("Bitmap :" + bitmap);
                        return null;
                    
                ) //储存到SD卡时，对Bitmap进行相应处理,
                .diskCache(new UnlimitedDiskCache(cacheDirectory)) //无限制大小缓存 ,同时设置缓存储存路径
                .diskCacheSize(50 * 1024 * 1024)// 缓存大小
                .diskCacheFileCount(100) //缓存文件数量
                .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //对于缓存的图片名进行MD5加密
                        /******************************   SD卡缓存设置 ****************************/


                        /******************************  线程 开始 ****************************/
                .threadPoolSize(3)
                .threadPoolSize(Thread.NORM_PRIORITY - 2)
                .tasksProcessingOrder(QueueProcessingType.LIFO)
                 /*不需要外部调用，是线程池相关，在ImageLoaderEngine中调用
                .taskExecutor()
                .taskExecutorForCachedImages()
                */
                .defaultDisplayImageOptions(options) // 设置默认图片显示选项 下面的option对象DisplayImageOptions.createSimple()
                .imageDownloader(new BaseImageDownloader(mContext, 5 * 1000, 30 * 1000))// connectTimeout (5 s), readTimeout (30 s)超时时间

                        /******************************  线程 结束 ****************************/


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

在调用时使用：

 imageLoaderUtils = new ImageLoaderUtils(MainActivity.this);
            imageLoaderUtils.InitImageLoder();
            ImageLoader.getInstance().displayImage(Constants.IMAGES[position], viewHolder.image, imageLoaderUtils.getOption());

Note:

1 UIL会根据layout_height ,layout_width,maxWidth,maxHeight来适配相应图片的大小

How UIL define Bitmap size needed for exact ImageView? It searches defined parameters:

Get actual measured width and height of ImageView
Get android:layout_width and android:layout_height parameters
Get android:maxWidth and/or android:maxHeight parameters
Get maximum width and/or height parameters from configuration (memoryCacheExtraOptions(int, int) option)
Get width and/or height of device screen

So try to set android:layout_width|android:layout_height orandroid:maxWidth|android:maxHeight parameters for ImageView if you know approximate maximum size of it. It will help correctly compute Bitmap size needed for this view and save memory.

2 OOM问题

If you often got OutOfMemoryError in your app using Universal Image Loader then:

Disable caching in memory. If OOM is still occurs then it seems your app has a memory leak. Use MemoryAnalyzer to detect it. Otherwise try the following steps (all of them or several):
Reduce thread pool size in configuration (.threadPoolSize(...)). 1 - 5 is recommended.
Use .bitmapConfig(Bitmap.Config.RGB_565) in display options. Bitmaps in RGB_565 consume 2 times less memory than in ARGB_8888.
Use .imageScaleType(ImageScaleType.EXACTLY)
Use .diskCacheExtraOptions(480, 320, null) in configuration

3 URL example

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

以上是关于ImageLoader的使用的主要内容，如果未能解决你的问题，请参考以下文章

翻翻git之---基于universalimageloader实现的图片加载控件BlurImageView

帝国cms内容页调用缩略图的原始尺寸图片

WPF_界面_图片模糊解决之道整理

Android imageloader imageLoader.displayImage显图片间长了内存缓慢上升导致溢出

ImageLoader在Listview中的使用

ImageLoader使用