轻量级前端框架助力开发者提升项目效率与性能
855
2022-10-22
ImageLoader:Android图片加载框架的api封装
ImageLoader
图片加载框架的api封装
特点
api设计参考glide,链式调用目前底层依赖fresco和glide,picasso,直接gradle改一下就切换了能够以同样api获取bitmap,所设置的宽高,高斯模糊,圆角或圆形效果均生效.解决了fresco最新版中,获取到的bitmap是recycled,不能用的问题基于subsampling-scale-image-view的大图预览功能,带进度和失败状态,能轮播,极致的高清无码,更重要的是非常省内存,绝不泄漏丰富便捷的api: 暂停和继续图片加载,获取磁盘缓存大小和清空缓存,响应内存事件等等.可以设置placeHolder,loadingDrawable,errorHolder,并且均可以自定义其scaleType.
TODO
自动识别gif并加载适配wrap_centent适配focus_face
一条龙地支持fresco和glide
图片加载:ImageLoader -->> 图片选择: PhotoPicker -->>拍照/选图/裁剪/压缩: PhotoOut
效果图:
更新日志
https://github.com/hss01248/ImageLoader/blob/master/LOG.md
public interface ILoader { void init(Context context,int cacheSizeInM);//初始化 void request(SingleConfig config);//核心方法,仅供内部调用 //图片加载的暂停和继续 void pause(); void resume(); //缓存大小与清除 void clearDiskCache(); void clearMomoryCache(); long getCacheSize(); //下面是操作磁盘缓存的一些方法(glide无法同步获取,fresco可以) void clearCacheByUrl(String url); File getFileFromDiskCache(String url); boolean isCached(String url); //下面是内存的优化-响应app的内存事件,做出相应的处理 void trimMemory(int level); void clearAllMemoryCaches();}
初始化
Application中:
oncreate方法中:
传入全局context和定义缓存文件夹的大小
init(final Context context, int cacheSizeInM,ILoader loader)//指定缓存大小,以及使用哪个loader
响应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)
占位图/默认图
本方法的生效规则: 当容器view可复用(在recycleview,或者可复用的viewpager中)时,一定会设置占位图,否则会出现两幅实际图片快速切换闪烁的情况 当容器view不复用时,当且仅当图片源为网络图片且本地没有缓存时,才会设置placeholder.以避免placehoder和正式图片的快速切换闪烁
placeHolder(int placeHolderResId,boolean reuseable)
error图
error(int errorResId)
圆角矩形
可以设置圆角的半径,以及当图片是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去给它展示. 而其他设置的宽高,高斯模糊,圆角或圆形效果,都能生效,最终给你一个你想要的bitmap
asBitmap(BitmapListener bitmapListener)
加载大图
内部采用的是 https://github.com/davemorrissey/subsampling-scale-image-view
加载单张大图:
ImageLoader.loadBigImage(BigImageView imageView,String path)//说明: path可以是网络url,文件路径或者content://格式的路径当是网络url时,注意应该以http开头,这里内部不提供拼接功能
内置了placeholder,progressbar,errorview.
加载多张大图:
用户只需要传入单纯的viewPager对象,框架会替调用者设置好特定的adapter.pageradapter内部只构建4个BigImageView,滑动时复用此view,则对应的bitmap能够被不断回收.
ImageLoader.loadBigImages(ViewPager viewPager, List
之前BigImageView有内存泄漏时,.几十张超级大图(4000*3000像素左右),快速滑动和快速缩放时,内存占用偶尔冲上五六十M,但很快会降到40M左右,关掉activity内存一直不下,解决内存泄漏后,十分清爽:
前一次的activity泄漏:多次进出,基线维持在40M水平![memory in viewpager](memory in viewpager.jpg)
解决了内存泄漏后:20M左右
注意,如果是使用Picasso,请在viewpager所在的activity的ondestroy方法中调用:(清除磁盘缓存)
PicassoBigLoader.clearCache()
内存优化的几个策略的说明
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:fresco:1.0.8'//如果使用fresco compile 'com.github.hss01248.ImageLoader:glide:1.0.8'//如果使用glide compile 'com.github.hss01248.ImageLoader:picasso:1.0.8'//如果使用picasso }
脸部识别
因为耗时长,需要依赖com.google.android.gms:play-services,国内阉割版rom用不了.所以没有引入到包中,但已预留相关接口需要的自行打开那一行代码注释即可试用
https://github.com/aryarohit07/GlideFaceDetectionTransformation
https://github.com/aryarohit07/PicassoFaceDetectionTransformation
https://github.com/aryarohit07/FrescoFaceDetectionProcessor
thanks
https://github.com/facebook/fresco
https://github.com/Piasy/BigImageViewer
Fresco 5.0以上内存持续增长问题优化
https://github.com/AlexMofer/RecyclePagerAdapter
bitmap转换器:
https://github.com/wasabeef/fresco-processors
https://github.com/wasabeef/glide-transformations
https://github.com/wasabeef/picasso-transformations
extend:
https://github.com/JakeWharton/picasso2-okhttp3-downloader
https://github.com/amitshekhariitbhu/GlideBitmapPool
https://github.com/peng8350/LoadingProgress
版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。
发表评论
暂时没有评论,来抢沙发吧~