安卓基础开发库，让开发简单点。

DevRing & Demo地址：

学习/参考地址：

https://blog.csdn.net/column/details/15318.html

https://blog.csdn.net/u013005791/article/details/74532091

https://www.jianshu.com/p/325bd2f56ca7

前言

距离上次发新篇已经有五个月了，趁现在无业游民一个，赶紧写多几篇完善一下这个系列。

今天给大家带来的是图片加载框架Glide的使用介绍。这里首推郭神的，配合了源码讲解得很详细清晰。下面算是对学习实践后做的一个归纳总结，不涉及源码分析，仅涉及相关用法。 Glide相比起要轻量很多，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识别。如下：

@GlideModulepublic 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中对磁盘缓存和内存缓存进行相关配置

@Overridepublic 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中进行了组件替换.

@Overridepublic 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根据图片资源智能地选择使用哪一种缓存策略（默认选项）。

另外再补充两点：

1. 网络图片缓存是根据url地址进行存储的，对于同一张图片但其url地址不同(可变动)的情况，则无法起到缓存作用。这个时候可以通过自定义Url来应对这种情况，具体方案请参考的“高级技巧”小节。
2. 清空缓存数据

//清空内存缓存，要求在主线程中执行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
      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。 要求：

1. 类上方加入@GlideExtension注解。
2. 自定义的方法上方加入@GlideOption注解。
3. 自定义的方法须为静态方法，且第一个参数必须是RequestOptions，后面可以加入任意多个你想自定义的参数。

@GlideExtensionpublic 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结束复制代码

---