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.glidegroupId>
<artifactId>glideartifactId>
<version>4.1.1version>
<type>aartype>
dependency>
<dependency>
<groupId>com.google.androidgroupId>
<artifactId>support-v4artifactId>
<version>r7version>
dependency>
<dependency>
<groupId>com.github.bumptech.glidegroupId>
<artifactId>compilerartifactId>
<version>4.1.1version>
<optional>trueoptional>
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 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 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 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 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.GeneratedAppGlideModuleImplGlide允许应用程序通过实现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 target, boolean isFirstResource) {
// Log errors here.
}
@Override
boolean onResourceReady(R resource, Object model, Target target,
DataSource dataSource, boolean isFirstResource) {
// Log successes here or use DataSource to keep track of cache hits and misses.
}
})
.into(imageView);