ImageLoader

项目地址:hss01248/ImageLoader
简介:图片加载框架的 api 封装,完全隔离第三方框架,api 设计参考 glide,目前底层依赖 fresco,如果要切换其他图片加载框架,实现 ILoader 接口即可.
更多:作者   提 Bug   
标签:
图片加载-fresco-imageloader-

图片加载框架的 api 封装

api 设计参考 glide,目前底层依赖 fresco 和 glide,可自由切换.如果要用其他图片加载框架,实现 ILoader 接口即可.

更新日志

https://raw.githubusercontent.com/hss01248/ImageLoader/master/LOG.md

public interface ILoader {

    void init(Context context,int cacheSizeInM);//初始化

    void request(SingleConfig config);//核心方法

    //图片加载的暂停和继续
    void pause();

    void resume();

    //下面是操作磁盘缓存的一些方法
    void clearDiskCache();

    void clearCacheByUrl(String url);

    File getFileFromDiskCache(String url);

    boolean  isCached(String url);

    //下面是内存的优化-响应 app 的内存事件,做出相应的处理
    void trimMemory(int level);

    void clearAllMemoryCaches();

}

初始化

Application 中:

oncreate 方法中:

传入全局 context 和定义缓存文件夹的大小

默认底层使用 fresco
init(final Context context, int cacheSizeInM)


//useFrescoOrGlide 为 true 时,底层使用 fresco,false 时使用 glide
init( Context context, int cacheSizeInM,boolean useFrescoOrGlide)

响应 app 的内存事件,预防 OOM:


    @Override
    public void onTrimMemory(int level) {
        super.onTrimMemory(level);
        ImageLoader.trimMemory(level);
    }

    @Override
    public void onLowMemory() {
        super.onLowMemory();
        ImageLoader.clearAllMemoryCaches();
    }

入口方法

该方法返回 SingleConfig.ConfigBuilder

ImageLoader.with(this)

自定义设置

几种不同的图片源

.url(String url)

.file(String filePath)

.res(int resId)

.content(String contentProvider)

https 时是否忽略证书校验

默认不忽略

.ignoreCertificateVerify(boolean ignoreCertificateVerify)

传入宽高,用于 resize,以节省内存

一般,传如用于显示的那���view 的宽高就行,单位为 dp.内部已自行转换为 px

框架能根据这两个参数去把图片流解压成这个大小的 bitmap,可以节约内存空间

widthHeight(int width,int height)

占位图/默认图

placeHolder(int placeHolderResId)

圆角矩形

可以设置圆角的半径,以及当图片是 gif 动图时,用什么颜色来盖一层,以实现动图时的圆角

rectRoundCorner(int rectRoundRadius,int overlayColorWhenGif)

设置图片为圆形

asCircle(int overlayColorWhenGif)

图片的边框(glide 不支持)

border(int borderWidth,int borderColor)

缩放模式

参考 fresco 的模式设置,取值为 ScaleMode.xxx.

这个模式只会改变 bitmap 展示在 view 上面的模式,而不会改变 bitmap 在内存中的大小

scale(int scaleMode)
类型 描述
center 居中,无缩放。
centerCrop 保持宽高比缩小或放大,使得两边都大于或等于显示边界,且宽或高契合显示边界。居中显示。
focusCrop 同 centerCrop, 但居中点不是中点,而是指定的某个点。
centerInside 缩放图片使两边都在显示边界内,居中显示。和 fitCenter 不同,不会对图片进行放大。如果图尺寸大于显示边界,则保持长宽比缩小图片。
fitCenter 保持宽高比,缩小或者放大,使得图片完全显示在显示边界内,且宽或高契合显示边界。居中显示。
fitStart 同上。但不居中,和显示边界左上对齐。
fitEnd 同 fitCenter, 但不居中,和显示边界右下对齐。
fitXY 不保存宽高比,填充满显示边界。

配置高斯模糊

传入的参数 blurRadius 为模糊度,越大就越模糊,实际效果要自己调试好相应的数字

blur(int blurRadius)

最终的出口方法有两个

显示到某一个 view 中

into(View targetView)

或者,只拿 bitmap 引用

此时,scale 的配置是无效的,因为没有 view 去给它展示

asBitmap(BitmapListener bitmapListener)

加载大图

内部采用的是https://github.com/Piasy/BigImageViewer,确实很给力.

ImageLoader.loadBigImage(BigImageView imageView,String path)
//说明: path 可以是网络 url,文件路径或者 content://格式的路径
当是网络 url 时,注意应该以 http 开头,这里内部不提供拼接功能

如果本地没有缓存,则先显示 loading 界面,图片下载完后显示图片.

如果本地有缓存,则直接显示图片.

loading

viewpager 加载大图的处理

用户只需要传入单纯的 viewPager 应用,框架会替调用者设置好特定的 adapter.

pageradapter 内部只构建 4 个 BigImageView,滑动时复用此 view,则对应的 bitmap 能够被不断创建和回收.

ImageLoader.loadBigImages(ViewPager viewPager, List<String> urls)//urls

经测试,效果非常不错.几十张超级大图(4000*3000 像素左右),快速滑动和快速缩放时,内存占用偶尔冲上五六十 M,但很快会降到 40M 左右.

memoryr

内存优化的几个策略的说明

bitmap 编码

将 fresco 框架默认的 RGB_888 改成 RGB_565,每张图片内存能减小一半,而显示效果相差并不大.

初始化时 ImagePipelineConfig 设置 setBitmapsConfig(Bitmap.Config.RGB_565)

downsampling 和 resization 配合

图片向下采样,将图片采样成设定的宽高的 bitmap,而不是加载原图.

初始化时 ImagePipelineConfig.Builder 设置 setDownsampleEnabled(true)//同时支持 PNG,JPG 以及 WEP 格式的图片

每次加载图片时,指定宽高,即可执行 resization,将图片解析成该宽高的 bitmap.

预防 OOM

参见 Fresco 5.0 以上内存持续增长问题优化

自定义控制 fresco 的内存对象池大小

初始化时 ImagePipelineConfig.Builder 设置 setBitmapMemoryCacheParamsSupplier(new MyBitmapMemoryCacheParamsSupplier(activityManager))

并且响应 app 的内存事件,在内存不够时进行清除内存缓存.

Application 的回调中调用方法:

@Override
    public void onTrimMemory(int level) {
        super.onTrimMemory(level);
        ImageLoader.trimMemory(level);
    }

    @Override
    public void onLowMemory() {
        super.onLowMemory();
        ImageLoader.clearAllMemoryCaches();
    }

外部辅助

如果图片用的是七牛云存储或者阿里云,那么利用他们的图片处理的 api,请求时带上目标宽高等参数,让他们裁剪成你要的小图后返回,不仅省内存,而且省流量.

示例代码:

ImageLoader.with(this)
        .url("https://pic1.zhimg.com/v2-7868c606d6ddddbdd56f0872e514925c_b.jpg")
        .placeHolder(R.mipmap.ic_launcher)
        .widthHeight(250,150)
        .asCircle(R.color.colorPrimary)
        .into(ivUrl);

ImageLoader.with(this)
                .placeHolder(R.mipmap.ic_launcher)
                .res(R.drawable.thegif)
                .widthHeight(250,150)
                .rectRoundCorner(15,R.color.colorPrimary)
                .asBitmap(new SingleConfig.BitmapListener() {
                    @Override
                    public void onSuccess(Bitmap bitmap) {
                        Log.e("bitmap",bitmap.getWidth()+"---height:"+bitmap.getHeight()+"--"+bitmap.toString());
                    }

                    @Override
                    public void onFail() {
                        Log.e("bitmap","fail");

                    }
                });

usage

gradle

Step 1. Add the JitPack repository to your build file

Add it in your root build.gradle at the end of repositories:

    allprojects {
        repositories {
            ...
            maven { url "https://jitpack.io" }
        }
    }

Step 2. Add the dependency

    dependencies {
            compile 'com.github.hss01248:ImageLoader:0.0.5'
    }

thanks

https://github.com/facebook/fresco

https://github.com/Piasy/BigImageViewer

Fresco 5.0 以上内存持续增长问题优化

Android 开发经验分享
Android 开发经验分享