Glide v4 用法

设置Gradle

repositories {
  mavenCentral()
  maven { url 'https://maven.google.com' }
}

dependencies {
    compile 'com.github.bumptech.glide:glide:4.1.1'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.1.1'
}

Maven

<dependency>
  <groupId>com.github.bumptech.glide</groupId>
  <artifactId>glide</artifactId>
  <version>4.1.1</version>
  <type>aar</type>
</dependency>
<dependency>
  <groupId>com.google.android</groupId>
  <artifactId>support-v4</artifactId>
  <version>r7</version>
</dependency>
<dependency>
  <groupId>com.github.bumptech.glide</groupId>
  <artifactId>compiler</artifactId>
  <version>4.1.1</version>
  <optional>true</optional>
</dependency>

Proguard 混淆

-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public class * extends com.bumptech.glide.AppGlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
    **[] $VALUES;
    public *;
}

Kotlin

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

简单用法，和之前版本没区别

Glide.with(fragment)
    .load(myUrl)
    .into(imageView);

取消已下载的图片：

Glide.with(fragment).clear(imageView);

注：当Activity或Fragment被销毁时，Glide会自动清理缓存。clear 在ListView/RecycleView中需要替换图片的时候可以用上。

引用GlideApp：
自定义类继承AppGlideModule,package中会自动生成GlideApp类，然后我们就可以用GlideApp.with()代替Glide.with()了

package com.example.myapp;

import com.bumptech.glide.annotation.GlideModule;
import com.bumptech.glide.module.AppGlideModule;

@GlideModule
public final class MyAppGlideModule extends AppGlideModule {}

GlideApp.with(fragment)
   .load(myUrl)
   .fitCenter()
   .into(imageView);

placeHolder占位图：图片未加载时显示

GlideApp.with(fragment)
  .load(url)
  .placeholder(R.drawable.placeholder)
  //.placeholder(new ColorDrawable(Color.BLACK))
  .into(view);

error:图片加载失败时显示

GlideApp.with(fragment)
  .load(url)
  .error(R.drawable.error)
  //.error(new ColorDrawable(Color.RED))
  .into(view);

fallback:url/model为null时显示

GlideApp.with(fragment)
  .load(url)
  .fallback(R.drawable.fallback)
  //.fallback(new ColorDrawable(Color.GREY))
  .into(view);

RequestOptions 可添加四种参数： Placeholders、Transformations、Caching Strategies 以及组件特定的选项（编码质量，Bitmap解码设置）

Glide.with(fragment)
    .load(url)
    .apply(centerCropTransform(context))
    .into(imageView);、
RequestOptions cropOptions = new RequestOptions().centerCrop(context);
...
Glide.with(fragment)
    .load(url)
    .apply(cropOptions)
    .into(imageView);

注：RequestOptions可以被共享，apply()也可以多次调用，如果两个RequestOptions包含冲突设置，则后一个会覆盖前一个。

TransitionOptions 可添加三种参数：View淡入、交叉淡入淡出、没有任何效果:

Glide.with(fragment)
    .load(url)    .transition(DrawableTransitionOptions.withCrossFade())//淡入淡出
    .into(view);

注： TransitionOptions分为 BitmapTransitionOptions 和
DrawableTransitionOptions

RequestBuilder:用来整合options，图片的类型（Drawable/Bitmap）、url/model、需加载资源的view、RequestOption、TransitionOptions、thumbnail()

RequestBuilder<Drawable> requestBuilder = Glide.with(fragment);
requestBuilder.apply(requestOptions);
requestBuilder.transition(transitionOptions);
RequestOptions options = new RequestOptions();
options.centerCrop();

Glide.with(fragment)
    .load(url)
    .apply(options)
    .into(imageView);

RequestBuilders可以被重复使用

RequestBuilder<Drawable> requestBuilder =
        Glide.with(fragment)
            .asDrawable()
            .apply(requestOptions);

for (int i = 0; i < numViews; i++) {
   ImageView view = viewGroup.getChildAt(i);
   String url = urls.get(i);
   requestBuilder.load(url).into(view);
}
Transformations: CenterCrop、FitCenter、CircleCrop
Glide.with(fragment)
    .load(url)
    .apply(options)//RequestOptions
    .apply(fitCenterTransform())//静态方法
    .fitCenter()//generated API
    .into(imageView);

Targets:glide 的回调 ,封装了当图片请求完成后会调用的方法

@Override
        public void onResourceReady(Object resource, Transition transition) {

        }
        @Override
        public void getSize(SizeReadyCallback cb) {

        }
        @Override
        public void removeCallback(SizeReadyCallback cb) {

        }

Target<Bitmap> target = Glide.with(fragment)
        .asBitmap()
        .load(url)
        .into(imageView);
...
// 记得clear
Glide.with(fragment).clear(target);

自定义target:
简单的作为实例变量

private class WidgetHolder {
  private final Fragment fragment;
  private final Target<Widget> widgetTarget;

  public WidgetHolder(Fragment fragment, Widget widget) {
    this.fragment = fragment;
    widgetTarget = new CustomWidgetTarget(widget);
  }

  public void showInWidget(Uri uri) {
    Glide.with(fragment)
        .load(uri)
        .into(widgetTarget);
  }
}

注：
- Glide能够使用getRequest()和setRequest()方法查找和取消对Targets的请求。所以可以继承BaseTarget.
- Glide优先使用由Targets提供的getSize()大小作为请求的目标大小

Transformations转换：
CenterCrop：缩放图像，使图像的宽度与给定的宽度匹配，并且图像的高度大于给定的高度，反之亦然，然后裁剪较大的尺寸以匹配给定的尺寸。不保持图像的纵横比
FitCenter：使图像均匀（保持图像的纵横比），使图像的尺寸之一等于给定的尺寸，另一个将小于给定的尺寸。
CircleCrop：，绕圈裁剪一个图像，所产生的图像被蒙上一个圆圈

RequestOptions options = new RequestOptions();
options.centerCrop();
Glide.with(fragment)
    .load(url)
    .apply(options)
    .into(imageView);

import static com.bumptech.glide.request.RequestOptions.fitCenterTransform;

Glide.with(fragment)
    .load(url)
    .apply(fitCenterTransform())
    .into(imageView);

GlideApp.with(fragment)
  .load(url)
  .fitCenter()
  .into(imageView);

Mutiple Transformations ：多重转换按顺序执行

Glide.with(fragment)
  .load(url)
  .transform(new MultiTransformation(new FitCenter(), new YourCustomTransformation())
  .into(imageView);
  或
  GlideApp.with(fragment)
  .load(url)
  .transforms(new FitCenter(), new YourCustomTransformation())
  .into(imageView);

注：
- 最好创建Transformation一次，然后将其传递给多个加载。
- glide会根据图片的比例类型（如：FIT_CENTER、CENTER_INSIDE）自动转换
- 适用Bitmap Transformations于BitmapDrawable，GifDrawable和Bitmap

Transitions 动画：
- 单次网络请求中占位图与加载图的转变或图片尺寸的转变。
- 与v3不同，v4没有默认转变，每次请求都要定义。
- 如果从Glide的内存缓存中加载数据，则Glide的内置转换不会运行。但是，如果从Glide的磁盘缓存，本地源文件或Uri或远程源Url或Uri加载数据，则Glide的内置转换将会运行。如果要改变可自定义transition。
- 使用动画会使加载看起来缓慢，应尽量避免在列表时使用动画，必须要用时使用预加载

Configuration：为了使Glide的配置正常工作，库和应用程序需要执行一定步骤。不注册其他组件的库不需要这样做。
Libraries():
- 添加一个或多个LibraryGlideModule实现。
- 将@GlideModule注释添加到每个LibraryGlideModule实现
- 在Glide的注释处理器上添加依赖关系。
以okhttp为例：

@GlideModule
public final class OkHttpLibraryGlideModule extends LibraryGlideModule {
  @Override
  public void registerComponents(Context context, Glide glide, Registry registry) {
    registry.replace(GlideUrl.class, InputStream.class, new OkHttpUrlLoader.Factory());
  }
}

使用@GlideModule注释需要依赖于Glide的注释：

compile 'com.github.bumptech.glide:annotations:4.1.1'

Applications:
- 添加一个AppGlideModule实现
- 可选地，添加一个或多个LibraryGlideModule实现。
- 将@GlideModule注释添加到AppGlideModule和所有LibraryGlideModule。
- 在Glide的注释处理器上添加依赖关系。
- 为AppGlideModules添加混淆。
glidesamples有个Flickr的例子：

@GlideModule
public class FlickrGlideModule extends AppGlideModule {
  @Override
  public void registerComponents(Context context, Glide glide, Registry registry) {
    registry.append(Photo.class, InputStream.class, new FlickrModelLoader.Factory());
  }
}

注释依赖：

compile 'com.github.bumptech.glide:annotations:4.1.1'
annotationProcessor 'com.github.bumptech.glide:compiler:4.1.1'

混淆添加到proguard.cfg：

-keep public class * extends com.bumptech.glide.module.AppGlideModule
-keep class com.bumptech.glide.GeneratedAppGlideModuleImpl

Glide允许应用程序通过实现AppGlideModule来完全控制Glide的内存和磁盘缓存的使用。
自定义内存缓存：LruResourceCache是MemoryCache的默认实现interface，LruResourceCache通过MemorySizeCalculator这个检查设备内存的类来确定size。

@GlideModule
public class YourAppGlideModule extends AppGlideModule {
  @Override
  public void applyOptions(Context context, GlideBuilder builder) {
    MemorySizeCalculator calculator = new MemorySizeCalculator.Builder(context)
        .setMemoryCacheScreens(2)
        .build();
    builder.setMemoryCache(new LruResourceCache(calculator.getMemoryCacheSize()));
  }
}
//or 直接覆盖缓存大小
@GlideModule
public class YourAppGlideModule extends AppGlideModule {
  @Override
  public void applyOptions(Context context, GlideBuilder builder) {
    int memoryCacheSizeBytes = 1024 * 1024 * 20; // 20mb
    builder.setMemoryCache(new LruResourceCache(memoryCacheSizeBytes));
  }
}
//or 自己实现MemoryCache
@GlideModule
public class YourAppGlideModule extends AppGlideModule {
  @Override
  public void applyOptions(Context context, GlideBuilder builder) {
    builder.setMemoryCache(new YourAppMemoryCacheImpl());
  }
}

磁盘缓存：DiskLruCacheWrapper默认磁盘缓存大小为250 MB，并放置在应用程序的缓存文件夹中的特定目录中。
改成外部磁盘存储：

@GlideModule
public class YourAppGlideModule extends AppGlideModule {
  @Override
  public void applyOptions(Context context, GlideBuilder builder) {
    builder.setDiskCache(new ExternalDiskCacheFactory(context));
  }
}

改变磁盘大小：

@GlideModule
public class YourAppGlideModule extends AppGlideModule {
  @Override
  public void applyOptions(Context context, GlideBuilder builder) {
    int diskCacheSizeBytes = 1024 * 1024 * 100; // 100 MB
    builder.setDiskCache(new InternalDiskCacheFactory(context, diskCacheSizeBytes));
  }
}

更改存储文件夹名：

@GlideModule
public class YourAppGlideModule extends AppGlideModule {
  @Override
  public void applyOptions(Context context, GlideBuilder builder) {
    int diskCacheSizeBytes = 1024 * 1024 * 100; // 100 MB
    builder.setDiskCache(
        new InternalDiskCacheFactory(context, "cacheFolderName", diskCacheSizeBytes));
  }
}

设置默认requestoptions

@GlideModule
public class YourAppGlideModule extends AppGlideModule {
  @Override
  public void applyOptions(Context context, GlideBuilder builder) {
    builder.setDefaultRequestOptions(
        new RequestOptions()
          .format(DecodeFormat.RGB_565)
          .disallowHardwareBitmaps());
  }
}

注：有冲突设置，builder中的option会被覆盖
为activity或fragment单独设置默认requestoptions:

Glide.with(fragment)
  .applyDefaultRequestOptions(
      new RequestOptions()
          .format(DecodeFormat.RGB_565)
          .disallowHardwareBitmaps());

注册组件：
1. ModelLoader加载自定义模型（Urls，Uris，任意POJO）和Data（InputStreams，FileDescriptors）。
2. ResourceDecoder以解码新的资源（Drawables，Bitmaps）或新类型的数据（InputStreams，FileDescriptors）。
3. Encoders将Data（InputStreams，FileDescriptors）写入Glide的磁盘缓存。
4. ResourceTranscoder将资源（BitmapResource）转换为其他类型的资源（DrawableResource）。
5. ResourceEncoder将资源（BitmapResource，DrawableResource）写入Glide的磁盘缓存。

@GlideModule
public class YourAppGlideModule extends AppGlideModule {
  @Override
  public void registerComponents(Context context, Glide glide, Registry registry) {
    registry.append(...);
  }
}
//or

@GlideModule
public class YourLibraryGlideModule extends LibraryGlideModule {
  @Override
  public void registerComponents(Context context, Glide glide, Registry registry) {
    registry.append(...);
  }
}

例:一个可以获取新的自定义Model对象的InputStream的ModelLoader

//append()将确保你的的ModelLoader或ResourceDecoder仅在Glide的默认值尝试之后才会调用。
@GlideModule
public class YourAppGlideModule extends AppGlideModule {
  @Override
  public void registerComponents(Context context, Glide glide, Registry registry) {
    registry.append(Photo.class, InputStream.class, new CustomModelLoader.Factory());
  }
}
//prepend()将确保你的ModelLoader或ResourceDecoder在所有其他先前注册的组件之前被调用，并且可以先运行。
@GlideModule
public class YourAppGlideModule extends AppGlideModule {
  @Override
  public void registerComponents(Context context, Glide glide, Registry registry) {
    registry.prepend(String.class, InputStream.class, new CustomUrlModelLoader.Factory());
  }
}
//replace()完全替代Glide的默认行为并确保它不会运行。适用于像OkHttp或Volley这样的库来交换Glide的网络逻辑
@GlideModule
public class YourAppGlideModule extends AppGlideModule {
  @Override
  public void registerComponents(Context context, Glide glide, Registry registry) {
    registry.replace(GlideUrl.class, InputStream.class, new OkHttpUrlLoader.Factory());
  }
}

冲突排除：

@Excludes({com.example.unwanted.GlideModule.class, com.example.conflicing.GlideModule.class})
@GlideModule
public final class MyAppGlideModule extends AppGlideModule { }

注：从Glide v3迁移过程中，可以将其用于排除LibraryGlideModules旧版和旧版的GlideModule实现。

Glide v4可以完全禁用清单解析。这样做可以改善Glide的初始启动时间，并避免尝试分析元数据时出现一些潜在的问题。

@GlideModule
public final class MyAppGlideModule extends AppGlideModule {
  @Override
  public boolean isManifestParsingEnabled() {
    return false;
  }
}

Caching 高速缓存：默认情况下，Glide会在启动对图像的新请求之前检查多层缓存：
- 活跃资源 - 此图像是否显示在另一个视图中？
- 内存缓存 - 这张图像最近是否加载并仍在内存中？
- 资源 - 此图像是否已经被解码，转换和写入磁盘缓存之前？
- 数据 - 此图像是否从写入磁盘缓存获取的数据？
前两个步骤检查资源是否在内存中，如果是，请立即返回图像。第二个步骤检查图像是否在磁盘上，并快速返回，但异步。
如果所有四个步骤都找不到图像，则Glide将返回原始来源以检索数据（原始文件，Uri，Url等）。
磁盘缓存策略：默认为DiskCacheStrategy.AUTOMATIC，加载远程数据时，只存储原始数据，加载本地数据时，存储缩略图。DiskCacheStrategy有五种值：
DiskCacheStrategy.ALL 使用DATA和RESOURCE缓存远程数据，仅使用RESOURCE来缓存本地数据。
DiskCacheStrategy.NONE 不使用磁盘缓存
DiskCacheStrategy.DATA 将原始数据写入磁盘缓存
DiskCacheStrategy.RESOURCE 在资源解码后将数据（缩略图）写入磁盘缓存。
DiskCacheStrategy.AUTOMATIC 根据原始图片数据和资源编码策略来自动选择磁盘缓存策略。

GlideApp.with(fragment)
  .load(url)
  .diskCacheStrategy(DiskCacheStrategy.ALL)
  .into(imageView);

只从缓存加载

GlideApp.with(fragment)
  .load(url)
  .onlyRetrieveFromCache(true)
  .into(imageView);

跳过缓存加载

GlideApp.with(fragment)
  .load(url)
  .skipMemoryCache(true)//跳过内存缓存
  .diskCacheStrategy(DiskCacheStrategy.NONE)//跳过磁盘缓存
  .into(view);

暂时允许Glide在应用的某些部分使用更多或更少的内存：

Glide.get(context).setMemoryCategory(MemoryCategory.LOW);
// Or:
Glide.get(context).setMemoryCategory(MemoryCategory.HIGH);
//离开后需重新设置内存
Glide.get(context).setMemoryCategory(MemoryCategory.NORMAL);

清除内存缓存

// This method must be called on the main thread.
Glide.get(context).clearMemory();

清除磁盘缓存

new AsyncTask<Void, Void, Void> {
  @Override
  protected Void doInBackground(Void... params) {
    // This method must be called on a background thread.
    Glide.get(applicationContext).clearDiskCache();
    return null;
  }
}

Debugging：

Glide.with(fragment)
   .load(url)
   .listener(new RequestListener() {
       @Override
       boolean onLoadFailed(@Nullable GlideException e, Object model,
           Target<R> target, boolean isFirstResource) {
         // Log errors here.
       }

       @Override
       boolean onResourceReady(R resource, Object model, Target<R> target,
           DataSource dataSource, boolean isFirstResource) {
         // Log successes here or use DataSource to keep track of cache hits and misses.
       }
    })
    .into(imageView);