Android Image-Loader简单使用介绍。

本文详细介绍Android-Universal-Image-Loader开源库的功能与使用方法,包括多线程下载、缓存策略配置、图片显示选项自定义等内容。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

一.Universal-Image-Loader概述:

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

二、使用效果图
设置没有加载出来时的效果:
这里写图片描述

加载成功后的图片:
这里写图片描述

在项目里导入jar包后,先要配置ImageLoaderConfiguration,这个是对全局图片缓存还有线程,缓存大小,解析等等进行配置,然后ImageLoader是具体实现下载图片、缓存图片显示图片的执行类,把配置好的ImageLoaderConfiguration传入ImageLoader,完成初始化工作,也就是初始化后才能使用ImageLoader.getInstance().displayImage()加载图片。

ImageLoader的初始化可以在Application中实现:
public class MyApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        initImageLoader1(getApplicationContext());

    }

    /*
     * 自定义配置
     */
    public static void initImageLoader(Context context) {
        ImageLoaderConfiguration.Builder config = new ImageLoaderConfiguration.Builder(
                context);
        config.threadPoolSize(3);//线程池内加载的数量 
        config.threadPriority(Thread.NORM_PRIORITY - 2);
        config.denyCacheImageMultipleSizesInMemory();// 不缓存图片的多种尺寸在内存中
        config.diskCacheFileNameGenerator(new Md5FileNameGenerator());// 将保存的时候的URI名称用MD5
        config.diskCacheSize(50 * 1024 * 1024); // 50 MiB
        config.tasksProcessingOrder(QueueProcessingType.LIFO);
        config.writeDebugLogs();// Remove for release app
        // 初始化ImageLoader
        ImageLoader.getInstance().init(config.build());
    }

    /*
     * 默认的配置,一般没有特殊的要求的时候就使用默认就好了。
     */
    public static void initImageLoader1(Context context) {
        // 创建默认的ImageLoader配置参数
        ImageLoaderConfiguration configuration = ImageLoaderConfiguration
                .createDefault(context);
        // 初始化ImageLoader
        ImageLoader.getInstance().init(configuration);
    }
}

在diskCacheFileNameGenerator();这是表示将缓存下来的文件以什么方式命名,有以下两种方式:
1.new Md5FileNameGenerator() //使用MD5对UIL进行加密命名
2.new HashCodeFileNameGenerator()//使用HASHCODE对UIL进行加密命名

<!-- 网络权限和缓存权限 -->
    <span style="color:#ff0000;"><uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /></span>
    <application
        android:name="com.example.androidimageview.MyApp"
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            <span style="color:#ff0000;">android:name="com.example.androidimageview.MainActivity"</span>
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

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

定义布局文件:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
     >
   <ListView 
    android:id="@+id/listview1"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent" />

</RelativeLayout>

图片加载使用DisplayImageOptions,这时我们可以配置一下这个图片显示的选项,比如图片加载完成之前先显示什么图片,加载失败显示什么图片等等:

<span style="font-size:24px;">options = new DisplayImageOptions.Builder()
                    .showImageOnLoading(R.drawable.ic_stub)//设置图片在下载期间显示的图片 
                    .showImageForEmptyUri(R.drawable.ic_empty)//设置图片Uri为空或是错误的时候显示的图片 
                    .showImageOnFail(R.drawable.ic_error)//设置图片加载/解码过程中错误时候显示的图片
                    .delayBeforeLoading(1000)//设置延时多少时间后开始下载
                    .cacheInMemory(true)//设置下载的图片是否缓存在内存中
                    .cacheOnDisk(true)// 设置下载的资源是否缓存在SD卡中
                    .considerExifParams(true)// 是否考虑JPEG图像EXIF参数(旋转,翻转)
                    .imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2)//设置图片以何种编码方式显示
                    .bitmapConfig(Bitmap.Config.RGB_565) // 设置图片的解码类型
                    .displayer(new RoundedBitmapDisplayer(20))//是否设置为圆角,弧度为多少
                    .displayer(new FadeInBitmapDisplayer(1000))//是否图片加载好后渐入的动画时间
                    .build();</span>

图片的显示大小会根据你ImageView的狂傲在上边的配置中:
imageScaleType(ImageScaleType imageScaleType):
缩放类型mageScaleType:
(1). EXACTLY :图像将完全按比例缩小的目标大小。
(2). EXACTLY_STRETCHED:图片会缩放到目标大小完全
(3). IN_SAMPLE_INT:图像将被二次采样的整数倍
(4). IN_SAMPLE_POWER_OF_2:图片将降低2倍,直到下一减少步骤,使图像更小的目标大小
(5). NONE:图片不会调整
item的布局:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <ImageView
        android:id="@+id/image"
        android:layout_width="72dp"
        android:layout_height="72dp"
        android:layout_margin="3dip"
        android:adjustViewBounds="true"
        android:contentDescription="@string/descr_image"
        android:scaleType="centerCrop" />

    <TextView
        android:id="@+id/text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="start|center_vertical"
        android:layout_marginLeft="20dip"
        android:textSize="22sp" />

</LinearLayout>
主界面实现:
public class MainActivity extends Activity {

    private static final String TEST_FILE_NAME = "Universal Image Loader @#&=+-_.,!()~'%20.png";

    ListView listview1 ;
    public static final String[] IMAGES = new String[] {"http://img.dapixie.com/uploads/allimg/111105/1-111105145231.jpg"};
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        listview1 = (ListView)findViewById(R.id.listview1);
        listview1.setAdapter(new ImageAdapter(this));
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        AnimateFirstDisplayListener.displayedImages.clear();
        ImageLoader.getInstance().clearMemoryCache();
        ImageLoader.getInstance().stop();
    }

    private static class ImageAdapter extends BaseAdapter {

        private static final String[] IMAGE_URLS = MainActivity.IMAGES;

        private LayoutInflater inflater;
        private ImageLoadingListener animateFirstListener = new AnimateFirstDisplayListener();

        private DisplayImageOptions options;

        ImageAdapter(Context context) {
            inflater = LayoutInflater.from(context);

            options = new DisplayImageOptions.Builder()
                    .showImageOnLoading(R.drawable.ic_stub)//设置图片在下载期间显示的图片 
                    .showImageForEmptyUri(R.drawable.ic_empty)//设置图片Uri为空或是错误的时候显示的图片 
                    .showImageOnFail(R.drawable.ic_error)//设置图片加载/解码过程中错误时候显示的图片
                    .delayBeforeLoading(1000)//设置延时多少时间后开始下载
                    .cacheInMemory(true)//设置下载的图片是否缓存在内存中
                    .cacheOnDisk(true)// 设置下载的资源是否缓存在SD卡中
                    .considerExifParams(true)// 是否考虑JPEG图像EXIF参数(旋转,翻转)
                    .imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2)//设置图片以何种编码方式显示
                    .bitmapConfig(Bitmap.Config.RGB_565) // 设置图片的解码类型
                    .displayer(new RoundedBitmapDisplayer(20))//是否设置为圆角,弧度为多少
                    .displayer(new FadeInBitmapDisplayer(1000))//是否图片加载好后渐入的动画时间
                    .build();
        }

        @Override
        public int getCount() {
            return IMAGE_URLS.length;
        }

        @Override
        public Object getItem(int position) {
            return position;
        }

        @Override
        public long getItemId(int position) {
            return position;
        }

        @Override
        public View getView(final int position, View convertView, ViewGroup parent) {
            View view = convertView;
            final ViewHolder holder;
            if (convertView == null) {
                view = inflater.inflate(R.layout.listview_item, parent, false);
                holder = new ViewHolder();
                holder.text = (TextView) view.findViewById(R.id.text);
                holder.image = (ImageView) view.findViewById(R.id.image);
                view.setTag(holder);
            } else {
                holder = (ViewHolder) view.getTag();
            }

            holder.text.setText("Item " + (position + 1));

            ImageLoader.getInstance().displayImage(IMAGE_URLS[position], holder.image, options, animateFirstListener);

            return view;
        }
    }

    static class ViewHolder {
        TextView text;
        ImageView image;
    }

    private static class AnimateFirstDisplayListener extends SimpleImageLoadingListener {

        static final List<String> displayedImages = Collections.synchronizedList(new LinkedList<String>());

        @Override
        public void onLoadingComplete(String imageUri, View view, Bitmap loadedImage) {
            if (loadedImage != null) {
                ImageView imageView = (ImageView) view;
                boolean firstDisplay = !displayedImages.contains(imageUri);
                if (firstDisplay) {
                    FadeInBitmapDisplayer.animate(imageView, 500);
                    displayedImages.add(imageUri);
                }
            }
        }
    }
}

在使用,主要是这几个ImageLoader.getInstance().displayImage(),ImageLoader.getInstance().loadImage(),ImageLoader.getInstance().loadImageSync(),ImageLoader.getInstance().loadImageSync()方法是同步的,android4.0有个特性,网络操作不能在主线程,所以ImageLoader.getInstance().loadImageSync()方法我们就不去使用。
主要介绍ImageLoader.getInstance().displayImage()其中三种重载方法:
(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.getInstance().displayImage(IMAGE_URLS[position], holder.image, options, animateFirstListener):这就是上面代码中使用的一种方式。animateFirstListener图片加载监听的。
图片下载监听还有可以用ImageLoadingListener,这种方式就是比较复杂,可以使用简单点的SimpleImageLoadingListener。
new ImageLoadingListener(){

            @Override
            public void onLoadingCancelled(String arg0, View arg1) {
                //加载取消的时候执行  
            }

            @Override
            public void onLoadingComplete(String arg0, View arg1,
                    Bitmap arg2) {
                //加载成功的时候执行  
            }

            @Override
            public void onLoadingFailed(String arg0, View arg1,
                    FailReason arg2) {
                //加载失败的时候执行 
            }

            @Override
            public void onLoadingStarted(String arg0, View arg1) {
                //开始加载的时候执行 
            }

         };

三.加载其他来源的图片:
String imageUri = “http://site.com/image.png“; // from Web
String imageUri = “file:///mnt/sdcard/image.png”; // from SD card
String imageUri = “content://media/external/audio/albumart/13”; // from content provider
String imageUri = “assets://image.png”; // from assets
String imageUri = “drawable://” + R.drawable.image; // from drawables (only images, non-9patch)

四.避免oom
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)
通过上面这些,相信大家对Universal-Image-Loader框架的使用已经非常的了解了,我们在使用该框架的时候尽量的使用displayImage()方法去加载图片,loadImage()是将图片对象回调到ImageLoadingListener接口的onLoadingComplete()方法中,需要我们手动去设置到ImageView上面,displayImage()方法中,对ImageView对象使用的是Weak references,方便垃圾回收器回收ImageView对象,如果我们要加载固定大小的图片的时候,使用loadImage()方法需要传递一个ImageSize对象,而displayImage()方法会根据ImageView对象的测量值,或者android:layout_width and android:layout_height设定的值,或者android:maxWidth and/or android:maxHeight设定的值来裁剪图片

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值