android 加载图片资源,一个Android快速图片加载框架BaseImageLoader

作者AlexFugui，源码BaseImageLoader，这是一个Android快速图片加载框架BaseImageLoader。

说明

支持加载网络图片(String格式url)/本地资源(mipmap和drawable)/网络.9图片/gif加载/自定义样式(圆形/圆角/centerCrop)/dataBinding

v1.1.0起支持读取zip中图片加载至任意View中,无需解压.

更多使用方法和示例代码请下载demo源码查看

github : BaseImageLoader

设计说明

根据BaseImageLoader持有图片View层的context和BaseImageConfig类实现Glide原生的生命周期感知和多样化的自定义配置加载

BaseImageConfig使用建造者模式,使用更灵活更方便,也可自行继承BaseImageConfig减少类名长度和实现自定义功能

主要功能loadImage 动态配置config加载你需求的资源图片

loadImageAs 获取网络url返回的资源,可获取drawable/bitmap/file/gif四种文件格式,可控知否获取资源的同时加载到View上

clear 取消加载或清除内存/储存中的缓存

BaseImageView 与动态config完全相同功能的自定义ImageView,支持xml中自定义属性配置各种加载需求

autoLoadImage 开发者自行指定zip压缩包的路径.并绑定当前View的根布局,配合View的tag字段自动加载zip中符合tag中图片名称的图片

添加依赖

implementation 'com.alex:BaseImageLoader:1.1.0'

使用的依赖库api 'com.github.bumptech.glide:glide:4.11.0'

annotationProcessor 'com.github.bumptech.glide:compiler:4.11.0'

开发者如需剔除重复依赖自行处理

使用说明

1.添加权限

需要添问网络和内存读写权限

2.项目通用配置

功能配置全部可选,如不配置则:

默认内存缓存大小20mb

默认bitmap池缓存30mb

默认硬盘缓存250mb

默认缓存文件夹名称BaseImageLoaderCache

默认缓存策略为AUTOMATIC,自动模式BaseImageSetting.getInstance()

.setMemoryCacheSize(30)//设置内存缓存大小 单位mb

.setBitmapPoolSize(50)//设置bitmap池缓存大小 单位mb

.setDiskCacheSize(80)//设置储存储存缓存大小 单位mb

.setLogLevel(Log.ERROR)//设置log等级

.setPlaceholder(R.drawable.ic_baseline_adb_24)//设置通用占位图片,全项目生效

.setErrorPic(R.mipmap.ic_launcher)//设置通用加载错误图片,全项目生效

.setCacheFileName("BaseImageLoaderDemo")//设置储存缓存文件夹名称,api基于Glide v4

.setCacheStrategy(CacheStrategy.AUTOMATIC)//设置缓存策略

.setCacheSize(50)//设置自动加载图片缓存数量,默认50

;

3.使用

1.获取BaseImageLoader对象

根据开发者项目设计模式,MVC/MVP/MVVM自行获取BaseImageLoader类对象,并自行管理生命周期.

BaseImageLoader自行提供单例,BaseImageLoader.getInstance();

2.加载至ImageView(包括但不限于任何继承于View或ViewGroup的view)BaseImageLoader mImageLoader = new BaseImageLoader();

mImageLoader.loadImage(this, ImageConfig.builder()

.url(Uri.parse(imageUrl))//url

.imageView(img1)//imageView

.placeholder(R.drawable.ic_baseline_adb_24)//占位图

.errorPic(R.mipmap.ic_launcher)//加载错误图片

.cacheStrategy(CacheStrategy.ALL)//缓存策略

.centerCrop(true)//centerCrop

.crossFade(true)//淡出淡入

.isCircle(true)//是否圆形显示

.setAsBitmap(true)//是否以bitmap加载图片,默认为drawable格式

.setRadius(30)//设置通用圆角,单位dp

.setTopRightRadius(10)//左上圆角,单位dp

.setTopLeftRadius(20)//右上圆角,单位dp

.setBottomRightRadius(30)//左下圆角,单位dp

.setBottomLeftRadius(40)//右下圆角,单位dp

.show());

注意:

避免过度绘制和二次绘制,其中优先级

isCircle(true) > setRadius(int) > setTopRightRadius(int) = setTopLeftRadius(int) = setBottomRightRadius(int) = setBottomLeftRadius(int)设置isCircle(true)会使通用圆角设置不生效,减少绘制次数

设置setRadius()会使分别控制单独圆角不生效,减少绘制次数

3.资源文件直出

方法一:/**

* 加载图片同时获取不同格式的资源

* @param context {@link Context}

* @param url 资源url或资源文件

* @param listener 获取的资源回调结果

*/

void loadImageAs(@NonNull Context context, @NonNull Object url, @NonNull L listener);

/**

* 根据图片类型直出对象

* 需要根据参数类型判断获取的字段,比如使用OnBitmapResult,就只有getBitmap方法不为null

* 根据是否传入imageView是否直接显示图片,如果想自己处理过资源再加载则不传入imageView

*

*/

mImageLoader.loadImageAs(this, imageUrlTest, new OnBitmapResult() {

@Override

public void OnResult(ImageResult result) {

Log.e("result", result.getBitmap() + "");

}

});

方法二:/**

*

* @param context {@link Context}

* @param url 资源url或资源文件

* @param imageView 显示的imageView

* @param listener 获取的资源回调结果

*/

void loadImageAs(@NonNull Context context, @NonNull Object url, @Nullable ImageView imageView, @NonNull L listener);

/**

* 加载图片且获得bitmap格式图片 且以 imageView.setImageBitmap(bitmap) 模式加载图片

*/

mImageLoader.loadImageAs(this, imageUrlTest, img14, new OnBitmapResult() {

@Override

public void OnResult(ImageResult result) {

Log.e("result", result.getBitmap() + "");

}

});

/**

* 使用File类型获取result时,默认result.getFile()是在设置的cache目录中

* 加载图片且获得File文件 但是以Glide默认方式加载图片(drawable格式) imageView.setImageDrawable(drawable);

*/

mImageLoader.loadImageAs(this, imageUrlTest, img14, new OnFileResult() {

@Override

public void OnResult(ImageResult result) {

Log.e("result", result.getFile() + "");

}

});

/**

* 加载gif且获得gif文件 以 imageView.setImageDrawable(GifDrawable); 模式加载图片

*/

mImageLoader.loadImageAs(this, gifUrl, img14, new OnGifResult() {

@Override

public void OnResult(ImageResult result) {

Log.e("result", result.getGif() + "");

}

});

/**

* 加载图片且获得drawable格式图片 以Glide默认方式加载图片(drawable格式) imageView.setImageDrawable(drawable);

*/

mImageLoader.loadImageAs(this, imageUrlTest, img14, new OnDrawableResult() {

@Override

public void OnResult(ImageResult result) {

Log.e("result", result.getDrawable() + "");

}

});

4.自定义BaseImageView

xml中:

api与代码设置相同

支持DataBinding:

详见demo中dataBinding简单使用 优先级规则同上

4.自动加载图片String ZIP_FILE_PATH = me.getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS).getAbsolutePath() + File.separator + "imgs.zip";

//ZIP_FILE_PATH真实路径为:/storage/emulated/0/Android/data/me.alex.baseimageloaderdemo/files/Documents/imgs.zip

ScrollView autoLoadViewGroup = findViewById(R.id.autoLoadViewGroup);

BaseImageLoader.getInstance().autoLoadImage(this, autoLoadViewGroup, ZIP_FILE_PATH);

xml中zip文件夹位置开发者自行设置,demo中是将assets中的imgs.zip复制至指定路径然后加载.

配合xml中View对象的tag参数匹配zip中的文件名称.

如使用BaseImageView+tag加载图片,支持自定义属性

Demo中加载6张图片耗时60ms左右

本功能开发本意是减少apk体积 , 减少重复资源下载 , 开发者可在业务流程中自行处理zip文件的下载和存放位置 , 自行处理数据安全

参数说明

1.BaseImageSetting:函数名入参类型参数说明setMemoryCacheSize()int设置内存缓存大小 单位mb

setBitmapPoolSize()int设置bitmap池缓存大小 单位mb

setDiskCacheSize()int设置储存储存缓存大小 单位mb

setLogLevel()int设置框架日志打印等级,详看android.util.Log类与Glide v4文档

placeholder()intv1.0.0版本仅支持resource类型int参数

errorPic()intv1.0.0版本仅支持resource类型int参数

setCacheFileName()String设置储存缓存文件夹名称,api基于Glide v4

2.BaseImageLoader:/**

* 加载图片 使用继承自BaseImageConfig的配置

*

* @param context {@link Context}

* @param config  {@link BaseImageConfig}  图片加载配置信息

*/

void loadImage(@NonNull Context context, @NonNull T config);/**

* 自动加载图片

* @param context {@link Context}

* @param viewGroup xml中的根标签View

* @param zipFileRealPath zip文件夹路径

*/

void autoLoadImage(@NonNull Context context, @NonNull ViewGroup viewGroup, @NonNull String zipFileRealPath);/**

* 加载图片同时获取不同格式的资源

* @param context {@link Context}

* @param url 资源url或资源文件

* @param listener 获取的资源回调结果

*/

void loadImageAs(@NonNull Context context, @NonNull Object url, @NonNull L listener);/**

*

* @param context {@link Context}

* @param url 资源url或资源文件

* @param imageView 显示的imageView

* @param listener 获取的资源回调结果

*/

void loadImageAs(@NonNull Context context, @NonNull Object url, @Nullable ImageView imageView, @NonNull L listener);/**

* 停止加载 或 清除缓存

*

* @param context {@link Context}

* @param config  {@link BaseImageConfig}  图片加载配置信息

*/

void clear(@NonNull Context context, @NonNull T config);

3.BaseImageConfig:函数名入参类型类型参数说明builder()无BaseImageConfig使用建造者模式,BaseImageConfig默认空构造方法

url() (代码使用)Object支持原生Glide中所有类型 *1

url() (xml中)Object支持原生Glide中所有类型,且支持resource类型

imageView()View支持任何继承与View和ViewGroup的View *2

placeholder()intv1.0.0版本仅支持resource类型int参数

errorPic()intv1.0.0版本仅支持resource类型int参数

cacheStrategy()int设置缓存策略,详看CacheStrategy类与Glide v4文档

setRadius()int设置通用圆角 单位dp

setTopRightRadius()int设置左上圆角 单位dp

setTopLeftRadius()int设置右上圆角 单位dp

setBottomRightRadius()int设置左下圆角 单位dp

setBottomLeftRadius()int设置右下圆角 单位dp

centerCrop()Booleantrue为居中裁剪

crossFade()Booleantrue为开启淡出淡入

isCircle()Booleantrue为开启圆形裁剪

setAsBitmap()Booleantrue为以bitmap格式加载图片

clearMemory()Booleantrue为清除内存中缓存,仅在BaseImageLoader.clear()中生效

clearDiskCache()Booleantrue为清除储存中缓存,仅在BaseImageLoader.clear()中生效

show()无BaseImageConfig使用建造者模式,用于new BaseImageConfig对象

1.支持的urlModel类型 : Bitmap/Drawable/String/Uri/File/Integer resourceId/URL/byte[]/Object2.ImageView的子类使用Glide默认的 setImageDrawable() 方式实现; 其他继承VIew或ViewGroup的以setBackground() 方式实现