Universal-Image-Loader 基本使用

简介

https://github.com/nostra13/Android-Universal-Image-Loader

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





控制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)

我们在使用该框架的时候尽量的使用displayImage()方法去加载图片，loadImage()是将图片对象回调到ImageLoadingListener接口的onLoadingComplete()方法中，需要我们手动去设置到ImageView上面，displayImage()方法中，对ImageView对象使用的是Weak references，方便垃圾回收器回收ImageView对象，如果我们要加载固定大小的图片的时候，使用loadImage()方法需要传递一个ImageSize对象，而displayImage()方法会根据ImageView对象的测量值，或者android:layout_width 和 android:layout_height设定的值，或者android:maxWidth 和/或 android:maxHeight设定的值来裁剪图片。


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

Application

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        //在Application中创建默认的ImageLoaderConfiguration配置参数，并初始化到ImageLoader中
        ImageLoaderConfiguration.Builder configuration = new ImageLoaderConfiguration.Builder(this);
        configuration.diskCacheSize(100 * 1024 * 1024); // 100 MiB
        ImageLoader.getInstance().init(configuration.build());

        // 也可以自己设置配置参数，很多设置在新版中已经被废弃了
        //    initImageLoader(getApplicationContext());
    }

    public static void initImageLoader(Context context) {
        ImageLoaderConfiguration.Builder config = new ImageLoaderConfiguration.Builder(context);
        config.threadPriority(Thread.NORM_PRIORITY - 2);
        config.denyCacheImageMultipleSizesInMemory();
        config.diskCacheFileNameGenerator(new Md5FileNameGenerator());
        config.diskCacheSize(50 * 1024 * 1024); // 50 MiB
        config.tasksProcessingOrder(QueueProcessingType.LIFO);
        config.writeDebugLogs(); // 打印log信息，Remove for release APP
        ImageLoader.getInstance().init(config.build());
    }

}

Activity

public class MainActivity extends Activity {
    private static final String imageUrl1 = "http://img.ivsky.com/img/bizhi/co/201601/19/linyun-001.jpg";//330*225
    private static final String imageUrl2 = "http://image52.360doc.com/DownloadImg/2012/06/0316/24581213_1.jpg";//1280*720
    private static final String imageUrl3 = "http://img.bimg.126.net/photo/rl0IM2SIJK8jWXgIgxhJsw==/2871889187379358521.jpg";//3216*2028
    private static final String imageUrl4 = "http://img.bimg.126.net/photo/rl0IM2SIJK8jWXgIgxhJsw==/2871889187379358521.jpg";
    private static final String imageUrl5 = "http://img.ivsky.com/img/bizhi/co/201601/19/fireworks-005.jpg";
    private static final String imageUrl6 = Scheme.FILE.wrap(Environment.getExternalStorageDirectory().getPath() + "/very_big.jpg");//超级大图6000*8000
    private static final String imageUrl7 = "file:///mnt/sdcard/video.mp4";//可以是视频文件，此工具会自动加载视频的缩略图
    private static final String imageUrl8 = "assets://big.jpg";//超大图，3600*5400
    private static final String imageUrl9 = "drawable://" + R.drawable.ic_launcher;
    private static final String imageUrl10 = "content://media/external/audio/albumart/a";//加载失败
    private static final int[] ids = { R.id.iv1, R.id.iv2, R.id.iv3, R.id.iv4, R.id.iv5, R.id.iv6, R.id.iv7, R.id.iv8, R.id.iv9, R.id.iv10 };
    private ImageView[] imageViews = new ImageView[ids.length];

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        for (int i = 0; i < ids.length; i++) {
            imageViews[i] = (ImageView) findViewById(ids[i]);
        }



        //1、默认，330*225
        ImageLoader.getInstance().loadImage(imageUrl1, 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) {
                imageViews[0].setImageBitmap(loadedImage);
                Log.i("bqt", loadedImage.getWidth() + "-1-" + loadedImage.getHeight());//330*225。和原图大小一致
            }

            @Override
            public void onLoadingCancelled(String imageUri, View view) {
            }
        });
        //2、指定图片的大小。注意，这里的大小并不一定有用，因为图片的宽高只会同时被缩放为2的n次幂的倍数。这是一个在很多地方都通用的规则。
        ImageLoader.getInstance().loadImage(imageUrl2, new ImageSize(100, 100), new SimpleImageLoadingListener() {//使用缺省适配器
                    @Override
                    public void onLoadingComplete(String imageUri, View view, Bitmap loadedImage) {
                        imageViews[1].setImageBitmap(loadedImage);
                        Log.i("bqt", loadedImage.getWidth() + "-2-" + loadedImage.getHeight());//320*180。原图大小1280*720
                    }
                });
        //3、配置一些图片显示的选项。测试时发现加载中以及加载失败时设置显示的图片均没有显示出来！
        DisplayImageOptions options = new DisplayImageOptions.Builder().cacheInMemory(true).cacheOnDisk(true)//将图片缓存到内存和硬盘中
                .showImageOnLoading(R.drawable.loading).showImageOnFail(R.drawable.failed)//设置加载中以及图片加载出现错误时显示的图片
                .bitmapConfig(Bitmap.Config.RGB_565).build();
        ImageLoader.getInstance().loadImage(imageUrl3, options, new SimpleImageLoadingListener() {
            @Override
            public void onLoadingComplete(String imageUri, View view, Bitmap loadedImage) {
                super.onLoadingComplete(imageUri, view, loadedImage);
                Log.i("bqt", loadedImage.getWidth() + "-3-" + loadedImage.getHeight());//1608*1014。原图3216*2028。宽高自动缩放为1/2
                imageViews[2].setImageBitmap(loadedImage);
            }
        });

        //**********************************************************建议用displayImage加载图片************************************************************
        ImageLoader.getInstance().displayImage(imageUrl4, imageViews[3], options);
        ImageLoader.getInstance().displayImage(imageUrl5, imageViews[4], options, null, new ImageLoadingProgressListener() {//设置图片加载进度监听
                    @Override
                    public void onProgressUpdate(String imageUri, View view, int current, int total) {
                        Log.i("bqt", current + "----" + total);
                    }
                });
        ImageLoader.getInstance().displayImage(imageUrl6, imageViews[5], options, new SimpleImageLoadingListener() {
            @Override
            public void onLoadingComplete(String paramString, View paramView, Bitmap loadedImage) {
                Log.i("bqt", loadedImage.getWidth() + "-6-" + loadedImage.getHeight());//750*1000。原图6000*8000。宽高自动缩放为1/8。
            }
        });
        ImageLoader.getInstance().displayImage(imageUrl7, imageViews[6], options);
        ImageLoader.getInstance().displayImage(imageUrl8, imageViews[7], options);//或使用【Scheme.ASSETS.wrap("a.png")】
        ImageLoader.getInstance().displayImage(imageUrl9, imageViews[8], options);
        ImageLoader.getInstance().displayImage(imageUrl10, imageViews[9], options);
    }

}

布局、样式

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

    <LinearLayout
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:background="#fff"
        android:orientation="vertical" >

        <ImageView
            android:id="@+id/iv1"
            style="@style/ImageStyle" />

        <ImageView
            android:id="@+id/iv2"
            style="@style/ImageStyle" />

        <ImageView
            android:id="@+id/iv3"
            style="@style/ImageStyle" />

        <ImageView
            android:id="@+id/iv4"
            style="@style/ImageStyle" />

        <ImageView
            android:id="@+id/iv5"
            style="@style/ImageStyle" />

        <ImageView
            android:id="@+id/iv6"
            style="@style/ImageStyle" />

        <ImageView
            android:id="@+id/iv7"
            style="@style/ImageStyle" />

        <ImageView
            android:id="@+id/iv8"
            style="@style/ImageStyle" />

        <ImageView
            android:id="@+id/iv9"
            style="@style/ImageStyle" />

        <ImageView
            android:id="@+id/iv10"
            style="@style/ImageStyle" />
    </LinearLayout>


</ScrollView>



<style name="ImageStyle" >
        <item name="android:layout_width">wrap_content</item>
        <item name="android:layout_height">wrap_content</item>
        <item name="android:layout_gravity">center</item>
        <item name="android:background">#2000</item>

        <item name="android:padding">1dp</item>
</style>

常用方法

1、ImageLoader 显示图片的方法






2、ImageLoader 其他的方法








3、ImageLoaderConfiguration.Builder 的方法




4、DisplayImageOptions 的方法




5、监听
下载过程监听 ImageLoadingListener和SimpleImageLoadingListener


滑动时暂停加载监听 PauseOnScrollListener


6、ImageSize 设置宽高及旋转



7、加载圆形或圆角图片

来自为知笔记(Wiz)