一个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'
使用的依赖库
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() | int | v1.0.0版本仅支持resource类型int参数 |
| errorPic() | int | v1.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() | int | v1.0.0版本仅支持resource类型int参数 |
| errorPic() | int | v1.0.0版本仅支持resource类型int参数 |
| cacheStrategy() | int<360> | 设置缓存策略,详看CacheStrategy类与Glide v4文档 |
| setRadius() | int | 设置通用圆角 单位dp |
| setTopRightRadius() | int | 设置左上圆角 单位dp |
| setTopLeftRadius() | int | 设置右上圆角 单位dp |
| setBottomRightRadius() | int | 设置左下圆角 单位dp |
| setBottomLeftRadius() | int | 设置右下圆角 单位dp |
| centerCrop() | Boolean | true为居中裁剪 |
| crossFade() | Boolean | true为开启淡出淡入 |
| isCircle() | Boolean | true为开启圆形裁剪 |
| setAsBitmap() | Boolean | true为以bitmap格式加载图片 |
| clearMemory() | Boolean | true为清除内存中缓存,仅在BaseImageLoader.clear()中生效 |
| clearDiskCache() | Boolean | true为清除储存中缓存,仅在BaseImageLoader.clear()中生效 |
| show() | 无 | BaseImageConfig使用建造者模式,用于new BaseImageConfig对象 |
1.支持的urlModel类型 : Bitmap/Drawable/String/Uri/File/Integer resourceId/URL/byte[]/Object2.ImageView的子类使用Glide默认的 setImageDrawable() 方式实现; 其他继承VIew或ViewGroup的以setBackground() 方式实现
©软件著作权归作者所有。本站所有内容均来源于网络，不得违法使用，仅供学习使用，请支持正版！
转载请注明出处： 662P » 一个Android快速图片加载框架BaseImageLoader
发表评论 取消回复