让你快速上手的Glide4.x教程

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

学习/参考地址：
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<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;
        }

        @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);

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;
          }
          @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);//加载原图大小

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

最后编辑于：2018.04.02 00:02:43

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 158,117评论 4赞 360
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 66,963评论 1赞 290
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 107,897评论 0赞 240
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 43,805评论 0赞 203
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 52,208评论 3赞 286
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 40,535评论 1赞 216
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 31,797评论 2赞 311
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 30,493评论 0赞 197
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 34,215评论 1赞 241
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 30,477评论 2赞 244
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 31,988评论 1赞 258
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 28,325评论 2赞 252
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 32,971评论 3赞 235
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 26,055评论 0赞 8
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 26,807评论 0赞 194
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 35,544评论 2赞 271
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 35,455评论 2赞 266