Android-Universal-Image-Loader的简单使用

╰+攻爆jí腚メ 2022-09-27 06:34 77阅读 0赞

## 1.特点 ##

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

## 2.github地址 ##

[https://github.com/nostra13/Android-Universal-Image-Loader][https_github.com_nostra13_Android-Universal-Image-Loader]

## 3.使用步骤 ##

1）导入universal-image-loader-1.9.5.jar到项目中  
2）创建MyApplication继承Application，在oncreate()中初始化ImageLoader

ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)
            .threadPriority(Thread.NORM_PRIORITY - 2)               // 线程优先级
            .denyCacheImageMultipleSizesInMemory()                  // 当同一个Uri获取不同大小的图片，缓存到内存时，只缓存一个。默认会缓存多个不同的大小的相同图片
            .discCacheFileNameGenerator(new Md5FileNameGenerator()) // 将保存的时候的URI名称用MD5
            .tasksProcessingOrder(QueueProcessingType.LIFO)         // 设置图片下载和显示的工作队列排序
            .writeDebugLogs()                                       // 打印debug log
            .build();

3）ImageLoader全局配置

// 全局初始化此配置
    ImageLoader.getInstance().init(config);

4）初始化DisplayImageOptions

DisplayImageOptions options = new DisplayImageOptions.Builder()
            .showStubImage(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(); // 创建配置过得DisplayImageOption对象

5）获取ImageLoader实例

private ImageLoader imageLoader = ImageLoader.getInstance();

6）显示加载的图片

// 参数1:图片url; 参数2:显示图片的控件; 参数3:显示图片的设置; 参数4:监听器
    imageLoader.displayImage(Constants.IMAGES[position], holder.image, options, mFirstLoadImageListener);

## 4.在ListView中的使用 ##

主要的Adapter代码

public class ImageloaderListviewAdapter extends BaseAdapter { 
        private Context mContext;
        private final ImageLoader imageLoader;
        private DisplayImageOptions options = new DisplayImageOptions.Builder()
                .showStubImage(R.drawable.atguigu_logo)          // 设置图片下载期间显示的图片
                .showImageForEmptyUri(R.drawable.atguigu_logo)  // 设置图片Uri为空或是错误的时候显示的图片
                .showImageOnFail(R.drawable.atguigu_logo)       // 设置图片加载或解码过程中发生错误显示的图片
                .cacheInMemory(true)                        // 设置下载的图片是否缓存在内存中
                .cacheOnDisk(true)                          // 设置下载的图片是否缓存在SD卡中
                .displayer(new RoundedBitmapDisplayer(20))  // 设置成圆角图片
                .build();                                   // 创建配置过得DisplayImageOption对象;
    
        public ImageloaderListviewAdapter(Context context) {
            mContext = context;
    
            // 初始化imageloader
            imageLoader = ImageLoader.getInstance();
        }
    
        @Override
        public int getCount() {
            return Constants.IMAGES.length;
        }
    
        @Override
        public Object getItem(int position) {
            return Constants.IMAGES[position];
        }
    
        @Override
        public long getItemId(int position) {
            return position;
        }
    
        @Override
        public View getView(int position, View convertView, ViewGroup parent) {
            // 获取或创建viewhoder
            Viewholder holder;
    
            if(convertView == null) {
                convertView = View.inflate(mContext, R.layout.item_imageloader_listview, null);
    
                holder = new Viewholder(convertView);
    
                convertView.setTag(holder);
            }else {
                holder = (Viewholder) convertView.getTag();
            }
    
            // 获取当前item数据
    
            // 显示数据
            holder.name.setText("item"+(position + 1));
    
            imageLoader.displayImage(Constants.IMAGES[position],holder.iv,options);
    
            return convertView;
        }
    
        class Viewholder{
            @Bind(R.id.iv_imageloader_listview)
            ImageView iv;
    
            @Bind(R.id.tv_imageloader_name)
            TextView name;
    
            public Viewholder(View view) {
                ButterKnife.bind(this,view);
            }
        }
    }

## 5.在ViewPager中的使用 ##

主要的Adapter代码

public class ImageloaderViewpagerAdapter extends PagerAdapter { 
    
        private Context mContext;
        private final ImageLoader imageLoader;
        private DisplayImageOptions options = new DisplayImageOptions.Builder()
                .showImageForEmptyUri(R.drawable.atguigu_logo)  // 设置图片Uri为空或是错误的时候显示的图片
                .showImageOnFail(R.drawable.atguigu_logo)       // 设置图片加载或解码过程中发生错误显示的图片
                .resetViewBeforeLoading(true)               // 设置图片在下载前是否重置，复位
                .cacheOnDisc(true)                          // 设置下载的图片是否缓存在SD卡中
                .imageScaleType(ImageScaleType.EXACTLY)     // 设置图片以如何的编码方式显示
                .bitmapConfig(Bitmap.Config.RGB_565)        // 设置图片的解码类型
                .displayer(new FadeInBitmapDisplayer(300))  // 设置图片渐变显示
                .build();
        ;
    
        public ImageloaderViewpagerAdapter(Context context) {
            mContext = context;
    
            // 初始化Imageloader
            imageLoader = ImageLoader.getInstance();
        }
    
        @Override
        public Object instantiateItem(ViewGroup container, int position) {
            // 添加布局文件
            View view = View.inflate(mContext, R.layout.item_imageloader_viewpager, null);
    
            // 获取控件对象
            ImageView iv = (ImageView) view.findViewById(R.id.iv_imageloader_viewpager);
    
            // 显示图片
            imageLoader.displayImage(Constants.IMAGES[position], iv, options);
    
            ((ViewPager) container).addView(view, 0);
    
            return view;
        }
    
        @Override
        public void destroyItem(ViewGroup container, int position, Object object) {
            ((ViewPager) container).removeView((View) object);
        }
    
        @Override
        public int getCount() {
            return Constants.IMAGES.length;
        }
    
        @Override
        public boolean isViewFromObject(View view, Object object) {
            return view.equals(object);
        }
    }

## 6.ImageLoader 内存溢出解决办法 ##

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

[https_github.com_nostra13_Android-Universal-Image-Loader]: https://github.com/nostra13/Android-Universal-Image-Loader