快速上手的Glide4.x教程

mac2022-06-30  21

安卓基础开发库,让开发简单点。DevRing & Demo地址:https://github.com/LJYcoder/DevRing

学习/参考地址:https://blog.csdn.net/column/details/15318.htmlhttps://blog.csdn.net/u013005791/article/details/74532091https://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<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);

更多变换效果请查看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<Drawable>() { @Override public boolean onLoadFailed(@Nullable GlideException e, Object model, Target<Drawable> target, boolean isFirstResource) { //加载失败 return false; } <span class="hljs-meta">@Override</span> <span class="hljs-function"><span class="hljs-keyword">public</span> <span class="hljs-keyword">boolean</span> <span class="hljs-title">onResourceReady</span><span class="hljs-params">(Drawable resource, Object model, Target<Drawable> target, DataSource dataSource, <span class="hljs-keyword">boolean</span> isFirstResource)</span> </span>{ <span class="hljs-comment">//加载成功,resource为加载到的图片</span> <span class="hljs-comment">//如果return true,则不会再回调Target的onResourceReady(也就是不再往下传递),imageView也就不会显示加载到的图片了。</span> <span class="hljs-keyword">return</span> <span class="hljs-keyword">false</span>; } }).into(imageView);

3. 获取Bitmap

有些时候,我们需要拿到加载回来的Bitmap对象,下面介绍两种实现方式。

3.1 通过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; } @Overridepublic boolean onResourceReady(Bitmap resource, Object model, Target<Bitmap> 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<Bitmap>() { @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<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);//回调在后台线程 } } } }); }

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。 要求: 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);

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结束

转载于:https://www.cnblogs.com/JasonLGJnote/p/11159862.html

相关资源:JAVA上百实例源码以及开源项目
最新回复(0)