安卓基础开发库,让开发简单点。
DevRing & Demo地址:github.com/LJYcoder/De…
学习/参考地址:
https://blog.csdn.net/column/details/15318.html
https://blog.csdn.net/u013005791/article/details/74532091
https://www.jianshu.com/p/325bd2f56ca7
前言
距离上次发新篇已经有五个月了,趁现在无业游民一个,赶紧写多几篇完善一下这个系列。
今天给大家带来的是图片加载框架Glide的使用介绍。这里首推郭神的Glide系列教程,配合了源码讲解得很详细清晰。下面算是对学习实践后做的一个归纳总结,不涉及源码分析,仅涉及相关用法。
Glide相比起Fresco要轻量很多,api调用起来也很简洁,对图片加载要求不是很高的话建议使用Glide。 关于Fresco与Glide的对比可以参考这里
本文介绍涉及的Glide版本为4.x
介绍
下面还是和以前一样,分几个模块来进行介绍:配置、加载图片、获取Bitmap、下载图片、Generated API、混淆。
1. 配置
1.1 添加依赖
compile 'com.github.bumptech.glide:glide:4.4.0'
annotationProcessor 'com.github.bumptech.glide:compiler:4.4.0' //注解处理器
复制代码
1.2 自定义模块
自定义模块包括:修改默认配置 和 替换组件。
实现方式是通过继承AppGlideModule类并重写相关方法实现的。记得在该类上方加上@GlideModule注解以便Glide识别。如下:
@GlideModule
public class GlideConfigModule extends AppGlideModule {
@Override
public void applyOptions(@NonNull Context context, @NonNull GlideBuilder builder) {
//修改默认配置,如缓存配置
}
@Override
public void registerComponents(@NonNull Context context, @NonNull Glide glide, @NonNull Registry registry) {
//替换组件,如网络请求组件
}
}
复制代码
1.2.1 缓存
在applyOption中对磁盘缓存和内存缓存进行相关配置
@Override
public void applyOptions(@NonNull Context context, @NonNull GlideBuilder builder) {
//磁盘缓存配置(默认缓存大小250M,默认保存在内部存储中)
//设置磁盘缓存保存在外部存储,且指定缓存大小
builder.setDiskCache(new ExternalCacheDiskCacheFactory(context, diskCacheSize);
//设置磁盘缓存保存在自己指定的目录下,且指定缓存大小
builder.setDiskCache(new DiskLruCacheFactory(new DiskLruCacheFactory.CacheDirectoryGetter() {
@Override
public File getCacheDirectory() {
return diskCacheFolder;
}
}, diskCacheSize);
//内存缓存配置(不建议配置,Glide会自动根据手机配置进行分配)
//设置内存缓存大小
builder.setMemoryCache(new LruResourceCache(memoryCacheSize));
//设置Bitmap池大小
builder.setBitmapPool(new LruBitmapPool(bitmapPoolSize));
}
复制代码
1.2.2 替换组件
比如替换网络组件为okhttp。
添加相关依赖即可。
compile 'com.squareup.okhttp3:okhttp:3.9.0'
compile 'com.github.bumptech.glide:okhttp3-integration:4.3.1'
复制代码
它内部实现其实就是在registerComponents中进行了组件替换.
@Override
public void registerComponents(@NonNull Context context, @NonNull Glide glide, @NonNull Registry registry) {
registry.replace(GlideUrl.class, InputStream.class, new OkHttpUrlLoader.Factory());
}
复制代码
当然还有很多组件可以替换,但一般没这种需求。
//Glide中默认组件
register(File.class, ParcelFileDescriptor.class, new FileDescriptorFileLoader.Factory());
register(File.class, InputStream.class, new StreamFileLoader.Factory());
register(int.class, ParcelFileDescriptor.class, new FileDescriptorResourceLoader.Factory());
register(int.class, InputStream.class, new StreamResourceLoader.Factory());
register(Integer.class, ParcelFileDescriptor.class, new FileDescriptorResourceLoader.Factory());
register(Integer.class, InputStream.class, new StreamResourceLoader.Factory());
register(String.class, ParcelFileDescriptor.class, new FileDescriptorStringLoader.Factory());
register(String.class, InputStream.class, new StreamStringLoader.Factory());
register(Uri.class, ParcelFileDescriptor.class, new FileDescriptorUriLoader.Factory());
register(Uri.class, InputStream.class, new StreamUriLoader.Factory());
register(URL.class, InputStream.class, new StreamUrlLoader.Factory());
register(GlideUrl.class, InputStream.class, new HttpUrlGlideUrlLoader.Factory());
register(byte[].class, InputStream.class, new StreamByteArrayLoader.Factory());
...
复制代码
1.2.3 注意
一个项目(包含主项目与依赖库)中只能存在一个继承AppGlideModule的自定义模块,如果有多个,则会报com.android.dex.DexException: Multiple dex files define Lcom/bumptech/glide/GeneratedAppGlideModuleImpl异常。
但是允许有多个继承LibraryGlideModule的自定义模块(用于重写registerComponents进行组件替换)。
2. 加载图片
2.1 常用操作
2.1.1 加载图片到ImageView
Glide.with(context)
.load(url)
.into(imageView);
复制代码
其中,
with()方法的参数可以是Activity、Fragment等。将用于图片加载的生命周期,比如传入的是activity,那么在activity销毁时将对相关图片资源进行回收。
load()方法的参数可以为String、Uri、File、资源ID等。
into()方法的参数可以是ImageView,Target、图片的宽高。
2.1.2 加载图片到ImageView,并指定占位图
RequestOptions requestOptions = new RequestOptions();
requestOptions.placeholder(loadingResId) //设置“加载中”状态时显示的图片
.error(errorResId); //设置“加载失败”状态时显示的图片
Glide.with(context)
.load(url)
.apply(requestOptions)
.into(imageView);
复制代码
2.1.3 加载图片到ImageView,并指定缓存策略
RequestOptions requestOptions = new RequestOptions();
requestOptions.skipMemoryCache(true) //不加入内存缓存,默认会加入
.diskCacheStrategy(DiskCacheStrategy.NONE); //不加入磁盘缓存
Glide.with(context)
.load(url)
.apply(requestOptions)
.into(imageView);
复制代码
磁盘缓存策略有以下几种:
DiskCacheStrategy.NONE: 表示不缓存任何内容。
DiskCacheStrategy.DATA: 表示只缓存原始图片。
DiskCacheStrategy.RESOURCE: 表示只缓存转换过后的图片。
DiskCacheStrategy.ALL : 表示既缓存原始图片,也缓存转换过后的图片。
DiskCacheStrategy.AUTOMATIC: 表示让Glide根据图片资源智能地选择使用哪一种缓存策略(默认选项)。
另外再补充两点:
- 网络图片缓存是根据url地址进行存储的,对于同一张图片但其url地址不同(可变动)的情况,则无法起到缓存作用。这个时候可以通过自定义Url来应对这种情况,具体方案请参考这里的“高级技巧”小节。
- 清空缓存数据
//清空内存缓存,要求在主线程中执行
Glide.get(mContext).clearMemory();
//清空磁盘缓存,要求在后台线程中执行
Glide.get(mContext).clearDiskCache();
复制代码
####2.1.4 加载图片到ImageView,并指定图片大小
RequestOptions requestOptions = new RequestOptions();
requestOptions.override(300, 200); //指定大小为300*200,无视imageView大小
//requestOptions.override(Target.SIZE_ORIGINAL); //指定大小为图片原始大小,有更高OOM风险
Glide.with(context)
.load(url)
.apply(requestOptions)
.into(imageView);
复制代码
2.1.5 加载图片到ImageView,并配置过渡动画
Glide.with(context)
.load(url)
.transition(DrawableTransitionOptions.withCrossFade(600))//适用于Drawable,过渡动画持续600ms
// .transition(BitmapTransitionOptions.withCrossFade(600))//适用于Bitmap,过渡动画持续600ms
// .transition(GenericTransitionOptions.with(animationId))//适用于自定义过渡效果,传入animationId
.into(imageView);
复制代码
2.1.6 加载图片到ImageView,并加入图片变换
确保已添加图片变换库依赖:
compile 'jp.wasabeef:glide-transformations:3.1.1@aar'//图片转换工具
复制代码
应用单个变换
RequestOptions requestOptions = new RequestOptions();
//加入圆角变换
requestOptions.transform(new RoundedCornersTransformation(radius, margin));
//加入模糊变换
//requestOptions.transform(new BlurTransformation(blurRadius));
//加入灰白变换
//requestOptions.transform(new GrayscaleTransformation());
....
Glide.with(context)
.load(url)
.apply(requestOptions)
.into(imageView);
复制代码
同时应用多个变换
List list = new ArrayList<>();
list.add(new RoundedCornersTransformation(radius, margin));
list.add(new BlurTransformation(blurRadius));
list.add(new GrayscaleTransformation());
MultiTransformation multiTransformation = new MultiTransformation(list);
RequestOptions requestOptions = new RequestOptions();
//同时应用圆角、模糊、灰白的变换效果
requestOptions.transform(multiTransformation);
Glide.with(context)
.load(url)
.apply(requestOptions)
.into(imageView);
复制代码
更多变换效果请查看https://github.com/wasabeef/glide-transformations。
另外,可以通过dontTransform()禁用图片变换。
RequestOptions requestOptions = new RequestOptions();
requestOptions.dontTransform();
Glide.with(context)
.load(url)
.apply(requestOptions)
.into(imageView);
复制代码
2.2 预加载
有时为了更流畅的体验,可以使用预加载功能先把图片准备好,等到要显示时加载速度就很快了。
Glide.with(context)
.load(url)
.preload();
复制代码
2.3 监听加载结果
如果你需要知道加载的结果,可以使用listener()进行监听。
Glide.with(context)
.load(url)
.listener(new RequestListener() {
@Override
public boolean onLoadFailed(@Nullable GlideException e, Object model, Target target, boolean isFirstResource) {
//加载失败
return false;
}
@Override
public boolean onResourceReady(Drawable resource, Object model, Target target, DataSource dataSource, boolean isFirstResource) {
//加载成功,resource为加载到的图片
//如果return true,则不会再回调Target的onResourceReady(也就是不再往下传递),imageView也就不会显示加载到的图片了。
return false;
}
}).into(imageView);
复制代码
3. 获取Bitmap
有些时候,我们需要拿到加载回来的Bitmap对象,下面介绍两种实现方式。
3.1 通过listener()实现
Glide.with(context)
.asBitmap() //指定格式为Bitmap
.load(url)
.listener(new RequestListener() {
@Override
public boolean onLoadFailed(@Nullable GlideException e, Object model, Target target, boolean isFirstResource) {
//加载失败
return false;
}
@Override
public boolean onResourceReady(Bitmap resource, Object model, Target target, DataSource dataSource, boolean isFirstResource) {
//加载成功,resource为加载到的bitmap
return false;
}
})
.into(Target.SIZE_ORIGINAL, Target.SIZE_ORIGINAL);//加载原图大小
复制代码
3.2 通过SimpleTarget实现
Glide.with(context)
.asBitmap()
.load(url)
.into(new SimpleTarget() {
@Override
public void onResourceReady(Bitmap resource, Transition super Bitmap> transition) {
//加载成功,resource为加载到的bitmap
}
});
//这种实现方式就无法监听到加载失败的结果
复制代码
4. 下载图片
使用submit()方法实现图片的下载。
下载图片并保存到指定的文件中:
public void downLoadImage(final Context context, final String url, final File targetFile, final ImageListener imageListener) {
if (cacheThreadPool == null) {
cacheThreadPool = Executors.newCachedThreadPool();
}
cacheThreadPool.execute(new Runnable() {
@Override
public void run() {
try {
File sourceFile = Glide.with(context).asFile().load(url).submit().get();
if (FileUtil.copyFile(sourceFile, targetFile) && imageListener != null) {
imageListener.onSuccess(targetFile);//通过回调传递File,回调在后台线程
}
} catch (Exception exception) {
if (imageListener != null) {
imageListener.onFail(exception);//回调在后台线程
}
}
}
});
}
复制代码
5. Generated API
Glide4.x之后引入的新功能。
5.1 作用1:可以继续像3.x那样链式调用加载
前提是项目中需要有一个自定义模块(参照1.2节)
然后便可以像3.x那样加载图片
GlideApp.with(context)
.load(url)
.placeholder(R.mipmap.loading)
.error(R.mipmap.error)
.override(300,300)
.transition(DrawableTransitionOptions.withCrossFade(600))
.tranform(new GrayscaleTransformation())
.skipMemoryCache(true)
.diskCacheStrategy(DiskCacheStrategy.NONE)
....
.into(imageView);
复制代码
5.2 作用2:定制属于你的API
假设现在需要每次加载图片都开启过渡动画效果,可以每次加载时加入.transition(DrawableTransitionOptions.withCrossFade(duration))来实现,但每次都写这么长的代码难免不太方便,这时可以通过定制API来实现。
自定义一个类,用于定制API。
要求:
- 类上方加入@GlideExtension注解。
- 自定义的方法上方加入@GlideOption注解。
- 自定义的方法须为静态方法,且第一个参数必须是RequestOptions,后面可以加入任意多个你想自定义的参数。
@GlideExtension
public class MyGlideExtension {
private MyGlideExtension() {
}
@GlideOption
public static void useTransition(RequestOptions options) {
options.transition(DrawableTransitionOptions.withCrossFade(600))
}
}
复制代码
ReBuild项目后,便可如下调用:
GlideApp.with(context)
.load(url)
.useTransition() //使用过渡动画效果
.into(imageView);
复制代码
6. 混淆
在proguard-rules.pro文件中添加以下内容进行混淆配置
#glide开始
-keep public class * implements com.bumptech.glide.module.AppGlideModule
-keep public class * implements com.bumptech.glide.module.LibraryGlideModule
-keep class com.bumptech.glide.** { *; }
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
**[] $VALUES;
public *;
}
#glide结束
复制代码