开发框架——Glide 4.X
介绍
Glide是一个快速高效的Android图片加载库,注重于平滑的滚动。Glide提供了易用的API,高性能、可扩展的图片解码管道(decode pipeline
),以及自动的资源池技术。Glide 支持拉取,解码和展示视频快照,图片,和GIF动画。Glide的Api是如此的灵活,开发者甚至可以插入和替换成自己喜爱的任何网络栈。默认情况下,Glide使用的是一个定制化的基于HttpUrlConnection
的栈,但同时也提供了与Google Volley和Square OkHttp快速集成的工具库。
虽然Glide 的主要目标是让任何形式的图片列表的滚动尽可能地变得更快、更平滑,但实际上,Glide几乎能满足你对远程图片的拉取/缩放/显示的一切需求。
为了让用户拥有良好的App使用体验,图片不仅要快速加载,而且还不能因为过多的主线程I/O或频繁的垃圾回收导致页面的闪烁和抖动现象。Glide使用了多个步骤来确保在Android上加载图片尽可能的快速和平滑:
1、自动、智能地下采样(downsampling
)和缓存(caching
),以最小化存储开销和解码次数;
2、积极的资源重用,例如字节数组和Bitmap,以最小化昂贵的垃圾回收和堆碎片影响;
3、深度的生命周期集成,以确保仅优先处理活跃的Fragment和Activity的请求,并有利于应用在必要时释放资源以避免在后台时被杀掉。
引入Glide
Min Sdk Version - 使用 Glide 需要 min SDK 版本 API 14 (Ice Cream Sandwich) 或更高。
Compile Sdk Version - Glide 必须使用 API 27 (Oreo MR1) 或更高版本的 SDK 来编译。
Support Library Version - Glide 使用的支持库版本为 27。
方式一:下载Jar包手动加入到项目中(需要包含 Android v4支持库 的 jar 包)
方式二:Android Studio中的Maven集成
<dependency
<groupIdcom.github.bumptech.glide</groupId
<artifactIdglide</artifactId
<version4.8.0</version
<typeaar</type
</dependency
<dependency
<groupIdcom.google.android</groupId
<artifactIdsupport-v4</artifactId
<versionr7</version
</dependency
<dependency
<groupIdcom.github.bumptech.glide</groupId
<artifactIdcompiler</artifactId
<version4.8.0</version
<optionaltrue</optional
</dependency
方式三:Android Studio中的Gradle集成
repositories {
mavenCentral()
maven { url 'https://maven.google.com' }
}
dependencies {
compile 'com.github.bumptech.glide:glide:4.8.0'
annotationProcessor 'com.github.bumptech.glide:compiler:4.8.0'
}
如果使用 Gradle,可从 Maven Central 或 JCenter 中添加对 Glide 的依赖。
注意:无论使用哪种方式,都需要添加Android 支持库的依赖。
如果需要从URL或一个网络连接中加载数据,需要添加以下权限到AndroidManifest.xml中:
<uses-permission android:name="android.permission.INTERNET"/
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/
要从本地文件夹或 DCIM 或图库中加载图片,需要添加 READ_EXTERNAL_STORAGE
权限:
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /
而如果要使用 ExternalPreferredCacheDiskCacheFactory来将 Glide 的缓存存储到公有 SD 卡上,你还需要添加 WRITE_EXTERNAL_STORAGE
权限:
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /
Glide原理
这里面源码代码较多,不打算详细讲解,有兴趣的小伙伴可以自行去查看源码。UML的学习以及Glide源码的学习量较多,以后继续学习。下图为Glide的with()方法的时序图:
Glide的基本使用
自定义???/strong>
自定义??榘ǎ?strong>修改默认配置(比如缓存) 和 替换组件(比如网络组件)。实现方式是通过继承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) {
//替换组件,如网络请求组件
}
}
修改缓存配置
在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));
}
替换组件
比如替换网络组件为OkHttp,添加相关依赖即可。
compile "com.github.bumptech.glide:okhttp3-integration:4.8.0"
查看代码后可以发现,它内部实现其实就是在registerComponents方法中进行了组件替换.
@Override
public void registerComponents(@NonNull Context context, @NonNull Glide glide, @NonNull Registry registry) {
registry.replace(GlideUrl.class, InputStream.class, new OkHttpUrlLoader.Factory());
}
注意
一个项目(包含主项目与依赖库)中只能存在一个继承AppGlideModule的自定义???,如果有多个,则会报com.android.dex.DexException: Multiple dex files define Lcom/bumptech/glide/GeneratedAppGlideModuleImpl异常。但是允许有多个继承LibraryGlideModule的自定义模块(用于重写registerComponents进行组件替换)。
加载图片
加载图片到ImageView
Glide.with(context).load(url).into(imageView);
with()方法的参数可以是Activity、Fragment等。将用于图片加载的生命周期,比如传入为Activity,那么在Activity销毁时将对相关图片资源进行回收。
load()方法的参数可以为String、Uri、File、资源ID等。
into()方法的参数可以是ImageView,Target、图片的宽高。
指定占位图
加载过程中的占用(Placeholder)
Glide.with(fragment).load(url).placeholder(R.drawable.placeholder).into(view);
加载失败后显示的图片(Error)
Glide.with(fragment).load(url).error(R.drawable.error).into(view);
指定缓存策略
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根据图片资源智能地选择使用哪一种缓存策略(默认选项)。
清空缓存数据:
//清空内存缓存,要求在主线程中执行
Glide.get(mContext).clearMemory();
//清空磁盘缓存,要求在后台线程中执行
Glide.get(mContext).clearDiskCache();
加载圆形图片
Glide.with(this)
.load(url)
.apply(RequestOptions.circleCropTransform())
.into(ivTest);
指定图片大小
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);
配置过渡动画
Glide.with(context)
.load(url)
.transition(DrawableTransitionOptions.withCrossFade(600))
//适用于Drawable,过渡动画持续600ms
//.transition(BitmapTransitionOptions.withCrossFade(600))
//适用于Bitmap,过渡动画持续600ms
//.transition(GenericTransitionOptions.with(animationId))
//适用于自定义过渡效果,传入animationId
.into(imageView);
加入图片变换
可以加入图像变换,加入图片变换库依赖:
//Gradle
repositories {
jcenter()
}
dependencies {
implementation 'jp.wasabeef:glide-transformations:4.x.x'
// If you want to use the GPU Filters
implementation 'jp.co.cyberagent.android:gpuimage:2.x.x'
}
应用单个变换
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<Transformation 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);
可以通过dontTransform()禁用图片变换
RequestOptions requestOptions = new RequestOptions();
requestOptions.dontTransform();
Glide.with(context)
.load(url)
.apply(requestOptions)
.into(imageView);
取消加载
Glide.with(fragment).clear(imageView);
预加载
为了更流畅的体验,可以使用预加载功能先把图片准备好,等到要显示时加载速度就很快了
Glide.with(context)
.load(url)
.preload();
监听加载结果
如果需要知道加载的结果,可以使用listener()进行监听。
Glide.with(context)
.load(url)
.listener(new RequestListener<Drawable() {
@Override
public boolean onLoadFailed(@Nullable GlideException e, Object model, Target<Drawable target, boolean isFirstResource) {
//加载失败
return false;
}
@Override
public boolean onResourceReady(Drawable resource, Object model, Target<Drawable target, DataSource dataSource, boolean isFirstResource) {
//加载成功,resource为加载到的图片
//如果return true,则不会再回调Target的onResourceReady(也就是不再往下传递),imageView也就不会显示加载到的图片了。
return false;
}
}).into(imageView);
在RecyclerView中使用
@Override
public void onBindViewHolder(ViewHolder holder, int position) {
String url = urls.get(position);
Glide.with(fragment)
.load(url)
.into(holder.imageView);
}
获取Bitmap
有些时候,我们需要拿到加载回来的Bitmap对象,下面介绍两种实现方式。
通过listener()实现
Glide.with(context)
.asBitmap() //指定格式为Bitmap
.load(url)
.listener(new RequestListener<Bitmap() {
@Override
public boolean onLoadFailed(@Nullable GlideException e, Object model, Target<Bitmap target, boolean isFirstResource) {
//加载失败
return false;
}
@Override
public boolean onResourceReady(Bitmap resource, Object model, Target<Bitmap target, DataSource dataSource, boolean isFirstResource) {
//加载成功,resource为加载到的bitmap
return false;
}
})
.into(Target.SIZE_ORIGINAL, Target.SIZE_ORIGINAL);//加载原图大小
通过SimpleTarget实现
Glide.with(context)
.asBitmap()
.load(url)
.into(new SimpleTarget<Bitmap() {
@Override
public void onResourceReady(Bitmap resource, Transition<? super Bitmap transition) {
//加载成功,resource为加载到的bitmap
}
});
//这种实现方式就无法监听到加载失败的结果
下载图片
使用submit()方法实现图片的下载。下载图片并保存到指定的文件中:
public void downLoadImage(final Context context, final String url, final File targetFile, final ImageListener<File 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);//回调在后台线程
}
}
}
});
}
Generated API
作用一:可以继续像3.X那样链式调用加载
前提是项目中需要有一个自定义??椋缓蟊憧梢韵?.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);
作用二:定制API
假设现在需要每次加载图片都开启过渡动画效果,可以每次加载时加入transition(DrawableTransitionOptions.withCrossFade(duration))来实现,但每次都自定义一个类,用于定制API。
要求:
1.类上方加入@GlideExtension注解。
2.自定义的方法上方加入@GlideOption注解。
3.自定义的方法须为静态方法,且第一个参数必须是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);
混淆
#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结束
上一篇:Android基础(12)—常用第三方库 OKHttp
下一篇:Android基础(14)—常用第三方库 EventBus
精彩内容不够看?更多精彩内容,请到微信搜索 “危君子频道” 订阅号,每周更新,欢迎大家关注订阅!