Android基础(13)—常用第三方库 Glide

开发框架——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()方法的时序图：

with()时序图.png

Glide的基本使用

自定义模块

自定义模块包括：修改默认配置(比如缓存) 和 替换组件(比如网络组件)。实现方式是通过继承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那样链式调用加载

前提是项目中需要有一个自定义模块，然后便可以像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);

作用二：定制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

精彩内容不够看？更多精彩内容，请到微信搜索 “危君子频道” 订阅号，每周更新，欢迎大家关注订阅！

微信公众号