Gilde是一个常用图片加载框架,其功能强大使用简单,更是得到google的推荐,这篇文章基于3.x版本介绍其简单用法。
库的引入及混淆配置
Glide库的引入很简单,如下一行即可:
dependencies {
compile 'com.github.bumptech.glide:glide:3.7.0'
}
混淆配置如下:
-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
**[] $VALUES;
public *;
}
# for DexGuard only
-keepresourcexmlelements manifest/application/meta-data@value=GlideModule
基本使用
- 图片加载
Glide.with(context).load(url).into(imageView);
如上是一行最简单的图片加载代码,涉及的三个函数是Glide的核心。
第一个函数:with,参数为各种context,可传入Activity,Fragment等对象,这里传入的Context不同会影响图片加载的生命周期,比如传入一个activity,那当这个activity的onPause的时候会停止加载,onReusme时再恢复加载。
第二个函数:load,参数为定位图片资源的路径,有多种重载参数,如图片地址的Uri对象,int类型的本地资源id,本地图片的文件对象及指向assets、raw、本地存储等路径下图片的String类型。
第三个函数:into,参数为一个ImageView或Taget对象,Taget对象可以理解为一个回调,这块下面单独介绍。
- 占位图
为了给用户更好的体验,在图片加载完成前和出错后给一个占位图是不错的选择。
Glide.with(context)
.load(url)
.placeholder(R.drawable.ic_launcher_background)
.error(R.mipmap.ic_launcher)
.fallback(R.mipmap.ic_launcher_round);
如上是三个设置占位图的函数:placeholder为设置图片加载前占位图;error为设置加载出错后占位图;fallback为设置load函数传入null时的占位图,需要注意的是,这几个函数的参数类型只能为int的资源id或者Drawable类型,因为占位图使用本地资源是更恰当的。
- 图片剪裁
有时候直接加载过来的图片的大小并不能满足我们使用的要求,或者为了不浪费内存,这时候就需要在展示前改变其大小。
Glide.with(this)
.load(url)
.override(300,100);
.fitCenter()
.centerCrop()
这几个函数就是用来设置图片大小的,override可以直接指定图片大小;fitCenter可以根据imageview的大小按比例缩小图片,让图片完全显示出来,但是如果图片宽高比和imageview不同,就会造成imageview留白;centerCrop可以根据imageview大小按比例放大图片,让图片完全充满imageview,如果图片宽高比和imageview不同就会显示不全。需要注意的是,Glide这些函数设置的是图片的大小,只是会根据imageview的大小进行计算,但是最终展示效果是计算后的图片和imageview的scanType再次叠加的效果。比如调用fitCenter函数将图片进行了缩小,但是imageview的scanType是fitXY,那缩小后的图片依然会拉伸铺满整个imageview。
- 加载动画
加载动画可以使我们图片加载过程效果更平滑顺畅。
Glide.with(this)
.load(url)
.crossFade(300)
.animate(R.anim.move)
.dontAnimate();
Glide默认使用crossFade动画,时间是300毫秒,当然可以设置其他时间;animate函数可以传入自定义动画,参数为Animator,Animation或者动画资源id;dontAnimate为不使用任何动画。
- 缩略图
当图片比较大,不能很快加载,或者像listview等快速浏览控件中展示,或者网络比较慢的时候大图需要长时间下载等情况,我们可以使用缩略图先进行大概展示,等原图完全加载到内存再高清展示。缩略图跟占位图的差别:1 缩略图一般是原图的低品质图,是原图已在本地后进行提取的,2 缩略图可以从网络动态加载,展位图只能是本地资源。
DrawableRequestBuilder requestBuilder = Glide.with(this).load(url);
Glide.with(this)
.load(url)
.thumbnail(0.1f)
.thumbnail(requestBuilder)
缩略图函数thumbnail有两个重载函数,1 参数为浮点型,代表缩略图取原图大小的百分比,0.1f即原图大小*0.1,在原图比较大的时候会先显示一个其十分之一大小的低品质图;2 参数类型为DrawableRequestBuilder ,缩略图从网络下载,当原图太大需要长时间下载,则可以先加载一个小图。总之可以理解缩略图为一种更好的占位图,让我们预先了解到原图的梗概。
- 显示GIF和MP4
glide可以用非常简单的代码展示GIF图和MP4,这算是Glide的优势之一,其他框架有的不支持,有的会比较麻烦。
Glide.with(this)
.load(url)
.asGif()
.into(imageView);
如上代码即可展示GIF图,如果图片不是GIF格式则会按error处理,如果是GIF但是只想显示一帧,则可以将asGif改为asBitmap。
File mp4 = new File(Environment.getExternalStorageDirectory()+File.separator+"test.mp4");
Uri mp4uri = Uri.fromFile(mp4);
Glide.with(this)
.load(mp4uri)
.into(imageView);
如上是显示MP4的代码,只能是本地文件。
- 缓存设置和下载优先级
缓存可以减少不必要的网络请求,快速加载。下载优先级能在多个图片同时下载时重要的先下载。
Glide.with(this)
.load(url)
.diskCacheStrategy(DiskCacheStrategy.SOURCE)
.priority(Priority.HIGH)
.into(imageView);
diskCacheStrategy函数可以制定缓存策略,缓存策略有如下几种:
ALL:缓存原始图片和转换后图片
NONE:不缓存
SOURCE:只缓存原始图片
RESULT:只缓存转换后图片
priority函数指定加载优先级,优先级高的优先加载。优先级分为:
IMMEDIATE, HIGH, NORMAL, LOW
- 回调的使用
Glide最简单的加载图片方式是直接将图片从下载、处理到最后的展示都封装了起来,最后直接展示到ImageView上,如果我们想在中间做些处理的话,可以使用回调,比如只下载不立即展示,或者下载后设置到一个非ImageView的自定义View中,或者对请求过程的错误结果或成功结果进行拦截。
RequestListener listener = new RequestListener<String, GlideDrawable>() {
@Override
public boolean onException(Exception e, String model, Target<GlideDrawable> target, boolean isFirstResource) {
return false;
}
@Override
public boolean onResourceReady(GlideDrawable resource, String model, Target<GlideDrawable> target, boolean isFromMemoryCache, boolean isFirstResource) {
return false;
}
};
Target<Bitmap> target = new SimpleTarget<Bitmap>() {
@Override
public void onResourceReady(Bitmap resource, GlideAnimation glideAnimation) {
}
};
Glide.with(this)
.load(url)
.listener(listener)
.into(target);
如上代码,Glide可以设置两种回调,RequestListener和Target,RequestListener是对过程进行拦截的,可以拦截错误状态和成功的结果。在onException中如果返回true则说明错误被处理了,不会向下进行传递,可以根据错误和其他传入参数进行一些处理。返回false则错误会继续由Glide进行处理。onResourceReady也是同理,可以在结果最终返回之前,进行各种处理。Target是接受最终结果的地方,这里举了一个SimpleTarget的类型,它可以把最终的Bitmap或其他类型自己处理而不是直接显示到ImageView中。
以上是Glide的简单使用,当然Glide还支持扩展各种特效,比如高斯模糊、蒙版、各种过滤器等这些高级用法,一般和GitHub的https://github.com/wasabeef/glide-transformations这个特效库联合使用,后面文章会具体介绍。