Android 图片加载框架Glide

一：概述
Glide是目前在Android的开发中非常的受欢迎，几乎是随便开一个项目都会想到使用Glide当图片加载框架
1.主要特点：
（1）支持Memory和Disk图片缓存
（2）支持gif和webp格式图片
（3）根据Activity/Fragment生命周期自动管理请求
（4）使用Bitmap Pool可以使用Bitmap复用
（5）对于回收的Bitmap会主动调用recycle，减少系统回收压力
2.依赖
高版本

//这是对于Glide 4的依赖和之前Glide 有一些区别
 implementation 'com.github.bumptech.glide:glide:4.11.0'
  annotationProcessor 'com.github.bumptech.glide:compiler:4.11.0'
  //相比于Glide 3，这里要多添加一个compiler的库，这个库是用于生成Generated API的

对于Kolin
如果你在 Kotlin 编写的类里使用 Glide 注解，你需要引入一个 kapt 依赖，以代替常规的 annotationProcessor 依赖

dependencies {
 implementation 'com.github.bumptech.glide:glide:4.11.0'
 kapt 'com.github.bumptech.glide:compiler:4.11.0'
}

低版本

implementation 'com.github.bumptech.glide:glide:3.7.0'

我们针对于Glide 3的一些方法使用讲解
二：基本使用
在AndroidManifest文件添加权限
<uses-permission android:name="android.permission.INTERNET"/>


public class ElevenActivity extends AppCompatActivity implements View.OnClickListener {
    private Button btn;
    private ImageView imageView;
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_eleven);
        imageView= findViewById(R.id.iv_img);
        btn=findViewById(R.id.btn_click);
        btn.setOnClickListener(this::onClick);
    }

    @Override
    public void onClick(View v) {
        String url = "http://guolin.tech/book.png";
        Glide.with(this).load(url).into(imageView);//Glide请求加载图片的最简单
    }
}

1.加载图片

Glide.with(this).load(url).into(imageView)；

加载网络图片，从文件中加载，加载资源id等

File file = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES),"Test.jpg");
Glide.with(context).load(file).into(imageViewFile);

2.占位符placeholder加载时候未加载出来前先有一个占位图，error加载失败图片,fallback 在Drawable 在请求的url/model为 null 时展示。

Glide.with(this).load(url).centerCrop().placeholder(R.mipmap.ic_launcher).error(R.mipmap.login_icon).into(imageView);//占位符
 Glide.with(this).load(url).fallback(R.mipmap.ic_launcher).into(imageView);// 如果请求的url/model为 null 的时候展示的图片 （如果没有设置，还是展示placeholder的占位符）

3.asGif(),asBitmap()显示gif动画,asGif()判断是否是gif动画，asBitmap()可以加载静态gif图即gif图的第一帧

 Glide.with(this).load(url).asGif().into(imageView);//显示Gif动画
 Glide.with(this).load(url).asBitmap().into(imageView);//显示Bitmap图片

4.设置动画
.crossFade() ：Glide提供淡如淡出；
crossFade(int duration)//设置动画时间
crossFade(Animation animation, int duration)//自定义动画和时间
.dontAnimate()//取消动画
.animate(android.R.anim.slide_in_left)：Android系统提供，从左到右滑出加载动画

  Glide.with(this).load(url).crossFade().into(imageView);
  Glide.with(this).load(url).animate(android.R.anim.slide_in_left).into(imageView);//从左到右加载图片

5.调整图片大小
单位是像素，裁剪你的图片大小。其实Glide已经会自动根据你ImageView裁剪照片来放在缓存中了。但是不想适应ImageView大小的时候，可以调用这个方法.override()为ImageView指定大小

 Glide.with(this).load(url).override(100,100).animate(android.R.anim.slide_in_left).into(imageView);

6.裁剪图片.fitCenter()和.CenterCrop()
当需要裁剪大小时，有个.centerCrop方法，这个方法的裁剪会让你的ImageView周围不会留白，还有一个.fitCenter()方法，表示让你的Image完全显示，尺寸不对时，周围会留白。

 Glide.with(this).load(url).fitCenter().animate(android.R.anim.slide_in_left).into(imageView);

7.设置缩略图.thumbnail()

.thumbnail()方法的目的就是让用户先看到一个低解析度的图，点开后，再加载一个高解析度的图。

Glide.with(this).load(url).fitCenter().thumbnail(0.1f).animate(android.R.anim.slide_in_left).into(imageView);

一种更高级的缩略图加载方式：

当缩略图也需要通过网络加载全部解析度的时候。

private void loadImageThumbnailRequest() {
    DrawableRequestBuilder<String> thumbnailRequest = Glide.with(context.load(eatFoodyImages[2]);
    Glide.with(context).load(UsageExampleGifAndVideos.gifUrl).thumbnail(thumbnailRequest).into(imageView);
}

8.设置图片显示效果（圆角、圆形、高斯模糊、蒙板、裁剪等等）.bitmapTransform（）

Glide.with(this).load(R.mipmap.ic_image_sample)
    //模糊
    .bitmapTransform(new BlurTransformation(this))
    //圆角
    .bitmapTransform(new RoundedCornersTransformation(this, 24, 0, RoundedCornersTransformation.CornerType.ALL))
    //遮盖
    .bitmapTransform(new MaskTransformation(this, R.mipmap.ic_launcher))
    //灰度
    .bitmapTransform(new GrayscaleTransformation(this))
    //圆形
    .bitmapTransform(new CropCircleTransformation(this))
    .into(imageView);

除此之外还有实现诸如马赛克、明暗度等更多滤镜处理：

ToonFilterTransformation
SepiaFilterTransformation
ContrastFilterTransformation
InvertFilterTransformation
PixelationFilterTransformation
SketchFilterTransformation
SwirlFilterTransformation
BrightnessFilterTransformation
KuwaharaFilterTransformation
VignetteFilterTransformation

9.Gilde的缓存
缓存是为了减少或者杜绝多的网络请求。为了避免缓存，Glide用了内存缓存和‘外存缓存机制’,并且提供了相应的方法，完全封装，不需要处理细节。Glide会自动缓存到内存，除非调用.skipMemoryCache( true )。尽管调用了这个，Glide还是会缓存到外存，还有一种情形，就是有一张图片，但是这张图变化非常快，这个时候可能并不想缓存到外存中，就使用.diskCacheStrategy( DiskCacheStrategy.NONE )。如果你两种都不需要，可以两个方法组合着一起使用。

DiskCacheStrategy.NONE 什么都不缓存
DiskCacheStrategy.SOURCE 仅仅只缓存原来的全分辨率的图像
DiskCacheStrategy.RESULT 仅仅缓存最终的图像，即降低分辨率后的（或者是转换后的）

DiskCacheStrategy.ALL 缓存所有版本的图像（默认行为）

 //设置跳过内存缓存
 Glide.with(this).load(url).animate(android.R.anim.slide_in_left).skipMemoryCache(true).into(imageView);
 
//设置硬盘缓存没有
Glide.with(this).load(url).animate(android.R.anim.slide_in_left).diskCacheStrategy(DiskCacheStrategy.NONE).into(imageView);

10.请求的优先级.priority()
载图片肯定也是有先后顺序，Glide提供了.priority()这个方法，它接收以下几个参数：

Priority.LOW
Priority.NORMAL
Priority.HIGH
Priority.IMMEDIATE

Glide.with(this).load(url).animate(android.R.anim.slide_in_left).diskCacheStrategy(DiskCacheStrategy.NONE).priority(Priority.LOW).into(imageView);

11.监听器配置.listener()

  @Override
    public void onClick(View v) {
        String url = "http://guolin.tech/book.png";
        Glide.with(this).load(url).animate(android.R.anim.slide_in_left).listener(mRequestListener).into(imageView);


    }
    private RequestListener<String, GlideDrawable> mRequestListener = new RequestListener<String, GlideDrawable>() {
        @Override
        public boolean onException(Exception e, String model, com.bumptech.glide.request.target.Target<GlideDrawable> target, boolean isFirstResource) {
            //显示错误信息
            Log.w("TAG", "onException: ", e);
            //打印请求URL
            Log.d("TAG", "onException: " + model);
            //打印请求是否还在进行
            Log.d("TAG", "onException: " + target.getRequest().isRunning());
            return false;
        }

        @Override
        public boolean onResourceReady(GlideDrawable resource, String model, com.bumptech.glide.request.target.Target<GlideDrawable> target, boolean isFromMemoryCache, boolean isFirstResource) {
            return false;
        }


    };

}

这里的onException捕获异常，如果返回true表示我们自己处理掉了异常，false表示交给Glide去处理，因为我们定义了.error()那么就显示error里面的内容。

这里onResourceReady表示是否准备资源显示，返回true表示用户自己已经设置好资源，包括截取操作，动画操作之类的，准备好显示。false表示交给Glide

如此修改后，就能够看到图片加载日志了，方便我们调试

12.替换掉自带的HttpClient
导入需要替换的HttpClient，可以选择Volley也可以选择OkHttp，我们使用Okhttp，在Module的build.gradle文件中配置

implementation "com.github.bumptech.glide:okhttp3-integration:4.11.0"

13.Glide 4使用
而Glide 4中引入了一个RequestOptions对象，将这一系列的API都移动到了RequestOptions当中。这样做的好处是可以使我们摆脱冗长的Glide加载语句，而且还能进行自己的API封装，因为RequestOptions是可以作为参数传入到方法中的。

RequestOptions options = new RequestOptions()
        .placeholder(R.drawable.ic_launcher_background)
        .error(R.drawable.error)
        .diskCacheStrategy(DiskCacheStrategy.NONE);
Glide.with(this)
     .load(url)
     .apply(options)
     .into(imageView);

14.关于图片变换，最后我们再来看一个非常优秀的开源库，glide-transformations。它实现了很多通用的图片变换效果，如裁剪变换、颜色变换、模糊变换等等，使得我们可以非常轻松地进行各种各样的图片变换
添加库

dependencies {
    implementation 'jp.wasabeef:glide-transformations:3.0.1'
}

三：使用Generated API

Generated API是Glide 4中全新引入的一个功能，它的工作原理是使用注解处理器 (Annotation Processor) 来生成出一个API，在Application模块中可使用该流式API一次性调用到RequestBuilder，RequestOptions和集成库中所有的选项。
Generated API对于熟悉Glide 3的朋友来说那是再简单不过了，基本上就是和Glide 3一模一样的用法，只不过需要把Glide关键字替换成GlideApp关键字，如下所示：

GlideApp.with(this)
        .load(url)
        .placeholder(R.drawable.loading)
        .error(R.drawable.error)
        .skipMemoryCache(true)
        .diskCacheStrategy(DiskCacheStrategy.NONE)
        .override(Target.SIZE_ORIGINAL)
        .circleCrop()
        .into(imageView);

不过，有可能你的IDE中会提示找不到GlideApp这个类。这个类是通过编译时注解自动生成的，首先确保你的代码中有一个自定义的模块，并且给它加上了@GlideModule注解，也就是我们在上一节所讲的内容。然后在Android Studio中点击菜单栏Build -> Rebuild Project，GlideApp这个类就会自动生成了。

@GlideModule
public final class MyAppGlideModule extends AppGlideModule {

    @Override
    public boolean isManifestParsingEnabled() {
        return false;
    }

    @Override
    public void registerComponents(
            @NonNull Context context, @NonNull Glide glide, Registry registry) {
        // 配置glide网络加载框架
        registry.replace(GlideUrl.class, InputStream.class, new OkHttpUrlLoader.Factory());
    }

    @Override
    public void applyOptions(@NonNull Context context, @NonNull GlideBuilder builder) {
        builder.setDefaultRequestOptions(
                new RequestOptions().format(DecodeFormat.PREFER_ARGB_8888));
        if (BuildConfig.DEBUG) {
            builder.setLogLevel(Log.DEBUG);
        }
    }
}

可以看到，在MyAppGlideModule类当中，我们重写了applyOptions()和registerComponents()方法，这两个方法分别就是用来更改Glide配置以及替换Glide组件的。

注意在MyAppGlideModule类在上面，我们加入了一个@GlideModule的注解，这是Gilde 4和Glide 3最大的一个不同之处。在Glide 3中，我们定义了自定义模块之后，还必须在AndroidManifest.xml文件中去注册它才能生效，而在Glide 4中是不需要的，因为@GlideModule这个注解已经能够让Glide识别到这个自定义模块了
四：自定义自己的扩展类
定制自己的API需要借助@GlideExtension和@GlideOption这两个注解。创建一个我们自定义的扩展类，代码如下所示：

@GlideExtension
public class MyGlideExtension {

    private MyGlideExtension() {

    }

    @GlideOption
    @NonNull
    public static BaseRequestOptions<?> roundCorner(@NonNull BaseRequestOptions<?> options) {
        return options.transform(new RoundedCorners(SizeUtils.dp2px(5)));
    }

}

这里我们定义了一个MyGlideExtension类，并且给加上了一个@GlideExtension注解，然后要将这个类的构造函数声明成private，这都是必须要求的写法。

接下来就可以开始自定义API了，这里我们定义了一个cacheSource()方法，表示只缓存原始图片，并给这个方法加上了@GlideOption注解。注意自定义API的方法都必须是静态方法，而且第一个参数必须是RequestOptions，后面你可以加入任意多个你想自定义的参数

GlideApp.with(this)
        .load(url)
        .cacheSource()
        .into(imageView);

五：Glide 4使用添加依赖

    implementation 'com.github.bumptech.glide:glide:4.11.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.11.0'
    implementation "com.github.bumptech.glide:okhttp3-integration:4.11.0"

使用：

  Glide.with(this).load(R.mipmap.login_icon).placeholder(R.mipmap.ic_launcher).into(imageView);
  
  //或者使用
  RequestOptions options=new RequestOptions().placeholder(R.mipmap.ic_launcher);//questOptions 允许你一次指定一系列的选项，然后对多个加载重用它们
        Glide.with(this).load(R.mipmap.login_icon).apply(options).into(imageView);
        //这样抽取出来可以多次加载

自定义模块@GlideMoudule，这样的话就能创建一个自定模块类
我们重写了applyOptions()和registerComponents()方法，这两个方法分别就是用来更改Glide配置以及替换Glide组件的。

@GlideModule
public final class MyAppGlideModule extends AppGlideModule {

    @Override
    public boolean isManifestParsingEnabled() {
        return false;
    }

    @Override
    public void registerComponents(
            @NonNull Context context, @NonNull Glide glide, Registry registry) {
        // 配置glide网络加载框架
        registry.replace(GlideUrl.class, InputStream.class, new OkHttpUrlLoader.Factory());
    }

    @Override
    public void applyOptions(@NonNull Context context, @NonNull GlideBuilder builder) {
        builder.setDefaultRequestOptions(
                new RequestOptions().format(DecodeFormat.PREFER_ARGB_8888));
        if (BuildConfig.DEBUG) {
            builder.setLogLevel(Log.DEBUG);
        }
    }
}

然后Bulid-->Rebulid Project

//这样的话就是吧Glide 换成GlideApp
 GlideApp.with(this).load(R.mipmap.login_icon).into(imageView);

自定义Api： mini（）方法

@GlideExtension
public class MyGlideExtension {
    private MyGlideExtension() {

    }
    @GlideOption
    @NonNull
    public static BaseRequestOptions<?> mini(
            @NonNull BaseRequestOptions<?> options, int size) {
        return options.fitCenter().override(size);
    }
    //这是一个Api扩展，使用居中裁剪和调整图片size大小尺寸
}

然后Bulid-->Rebulid Project
最后调用

 GlideApp.with(this).load(R.mipmap.login_icon).mini(66).into(imageView);

Glide相关博客：https://guolin.blog.csdn.net/...

END:我开始在人世间漂流，选择过大大小小的梦想

Android 图片加载框架Glide