Glide 使用说明

Myth丶恋晨 2022-06-07 00:25 257阅读 0赞

### **一. 下载** ###

在build.gradle中添加依赖：

compile 'com.github.bumptech.glide:glide:3.7.0'
       
        
         1

需要support-v4库的支持，如果你的项目没有support-v4库(项目默认已经添加了)，还需要添加support-v4依赖：

compile 'com.android.support:support-v4:23.3.0'
       
        
         1

然后配置混淆规则：

-keep public class * implements com.bumptech.glide.module.GlideModule -keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** { 
          **[] $VALUES;
          public *;
        }
       
        
         1
         2
         3
         4
         5

其中第一个混淆规则表明不混淆所有的`GlideModule`。  
如果需要的话，还需添加相应的权限：

<uses-permission android:name="android.permission.INTERNET" />
 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 
 
 1
 2

Glide Repo：[bumptech/glide][bumptech_glide]

### **二. 集成网络框架OkHttp（可选）** ###

Glide的网络请求部分可以使用当前最流行的网络请求框架Volley或OkHttp，也可以通过Glide的ModelLoader接口自己写网络请求。  
Glide默认使用`HttpUrlConnection`进行网络请求，为了让APP保持一致的网络请求形式，可以让Glide使用我们指定的网络请求形式请求网络资源，这里我们选[OkHttp][] (具有支持HTTP/2、利用连接池技术减少请求延迟、缓存响应结果等等优点)，需要添加一个集成库：

//OkHttp 2.x
        //compile 'com.github.bumptech.glide:okhttp-integration:1.4.0@aar'
        //compile 'com.squareup.okhttp:okhttp:2.7.5'
    
        //OkHttp 3.x
        compile 'com.github.bumptech.glide:okhttp3-integration:1.4.0@aar'
        compile 'com.squareup.okhttp3:okhttp:3.2.0'
       
        
         1
         2
         3
         4
         5
         6
         7

> 注意：  
> 1. OkHttp 2.x和OkHttp 3.x需使用不同的集成库。  
> 2. Gradle会自动将OkHttpGlideModule合并到应用的manifest文件中。  
> 3. 如果你没有对所有的`GlideModule`配置混淆规则(即没有使用`-keep public class * implements com.bumptech.glide.module.GlideModule`)，则需要把OkHttp的`GlideModule`进行防混淆配置：
> 
>     -keep class com.bumptech.glide.integration.okhttp.OkHttpGlideModule
>         
>          
>           1

### **三. 使用** ###

#### **简单使用**： ####

Glide
        .with(this)
        .load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png")
        .into(imageView);
       
        
         1
         2
         3
         4

#### **Glide.with()使用** ####

1.  with(Context context). 使用Application上下文，Glide请求将不受Activity/Fragment生命周期控制。
2.  with(Activity activity).使用Activity作为上下文，Glide的请求会受到Activity生命周期控制。
3.  with(FragmentActivity activity).Glide的请求会受到FragmentActivity生命周期控制。
4.  with(android.app.Fragment fragment).Glide的请求会受到Fragment 生命周期控制。
5.  with(android.support.v4.app.Fragment fragment).Glide的请求会受到Fragment生命周期控制。

返回关联了相应上下文的`RequestManager`实例。

#### **requestManager.load()使用** ####

Glide基本可以load任何可以拿到的媒体资源，如： 
load **SD卡资源**：load(“file://”+ Environment.getExternalStorageDirectory().getPath()+”/test.jpg”) 
load **assets资源**：load(“file:///android\_asset/f003.gif”) 
load **raw资源**：load(“android.resource://com.frank.glide/raw/raw\_1”)或load(“android.resource://com.frank.glide/raw/”+R.raw.raw\_1) 
load **drawable资源**：load(“android.resource://com.frank.glide/drawable/news”)或load(“android.resource://com.frank.glide/drawable/”+R.drawable.news) 
load **ContentProvider资源**：load(“content://media/external/images/media/139469”) 
load **http资源**：load(“[https://img-my.csdn.net/uploads/201508/05/1438760757\_3588.jpg][https_img-my.csdn.net_uploads_201508_05_1438760757_3588.jpg]“) 
load **https资源**：load(“[https://img.alicdn.com/tps/TB1uyhoMpXXXXcLXVXXXXXXXXXX-476-538.jpg\_240x5000q50.jpg\_.webp][https_img.alicdn.com_tps_TB1uyhoMpXXXXcLXVXXXXXXXXXX-476-538.jpg_240x5000q50.jpg_.webp]”) 
当然，load不限于String类型，还可以： 
`load(Uri uri)`，`load(File file)`，`load(Integer resourceId)`，`load(URL url)`，`load(byte[] model)`，`load(T model)`，`loadFromMediaStore(Uri uri)`。 
load的资源也可以是本地视频，如果想要load网络视频或更高级的操作可以使用`VideoView`等其它控件完成。 
而且可以使用自己的`ModelLoader`进行资源加载： 
`using(ModelLoader<A, T> modelLoader, Class<T> dataClass)`，`using(final StreamModelLoader<T> modelLoader)`，`using(StreamByteArrayLoader modelLoader)`，`using(final FileDescriptorModelLoader<T> modelLoader)`。 
返回GenericRequestBuilder实例。

#### **GenericRequestBuilder使用** ####

`GenericRequestBuilder<ModelType,DataType,ResourceType,TranscodeType>`是最顶层的Request Builder，用于处理选项设置和开始一般resource类型资源的加载。其中`ModelType`是指代表资源的类型，如”[https://img-my.csdn.net/uploads/201508/05/1438760757\_3588.jpg][https_img-my.csdn.net_uploads_201508_05_1438760757_3588.jpg]“这个String就代表了一张图片资源，所以这个ModelType就是String。`DataType`是指ModelLoader提供的，可以被ResourceDecoder解码的数据类型。`ResourceType`是指将要加载的resource类型。`TranscodeType`是指已解码的资源将要被转成的资源类型。

1. thumbnail(float sizeMultiplier). 请求给定系数的缩略图。如果缩略图比全尺寸图先加载完，就显示缩略图，否则就不显示。系数sizeMultiplier必须在(0,1)之间，可以递归调用该方法。
2. sizeMultiplier(float sizeMultiplier). 在加载资源之前给Target大小设置系数。
3. diskCacheStrategy(DiskCacheStrategy strategy).设置缓存策略。DiskCacheStrategy.SOURCE：缓存原始数据，DiskCacheStrategy.RESULT：缓存变换(如缩放、裁剪等)后的资源数据，DiskCacheStrategy.NONE：什么都不缓存，DiskCacheStrategy.ALL：缓存SOURC和RESULT。默认采用DiskCacheStrategy.RESULT策略，对于download only操作要使用DiskCacheStrategy.SOURCE。
4. priority(Priority priority). 指定加载的优先级，优先级越高越优先加载，但不保证所有图片都按序加载。枚举Priority.IMMEDIATE，Priority.HIGH，Priority.NORMAL，Priority.LOW。默认为Priority.NORMAL。
5. dontAnimate(). 移除所有的动画。
6. animate(int animationId). 在异步加载资源完成时会执行该动画。
7. animate(ViewPropertyAnimation.Animator animator). 在异步加载资源完成时会执行该动画。
8. placeholder(int resourceId). 设置资源加载过程中的占位Drawable。
9. placeholder(Drawable drawable). 设置资源加载过程中的占位Drawable。
10. fallback(int resourceId). 设置model为空时要显示的Drawable。如果没设置fallback，model为空时将显示error的Drawable，如果error的Drawable也没设置，就显示placeholder的Drawable。
11. fallback(Drawable drawable).设置model为空时显示的Drawable。
12. error(int resourceId).设置load失败时显示的Drawable。
13. error(Drawable drawable).设置load失败时显示的Drawable。
14. listener(RequestListener<? super ModelType, TranscodeType> requestListener). 监听资源加载的请求状态，可以使用两个回调：`onResourceReady(R resource, T model, Target<R> target, boolean isFromMemoryCache, boolean isFirstResource)`和`onException(Exception e, T model, Target<R> target, boolean isFirstResource)`，但不要每次请求都使用新的监听器，要避免不必要的内存申请，可以使用单例进行统一的异常监听和处理。
15. skipMemoryCache(boolean skip). 设置是否跳过内存缓存，但不保证一定不被缓存（比如请求已经在加载资源且没设置跳过内存缓存，这个资源就会被缓存在内存中）。
16. override(int width, int height). 重新设置Target的宽高值（单位为pixel）。
17. into(Y target).设置资源将被加载到的Target。
18. into(ImageView view). 设置资源将被加载到的ImageView。取消该ImageView之前所有的加载并释放资源。
19. into(int width, int height). 后台线程加载时要加载资源的宽高值（单位为pixel）。
20. preload(int width, int height). 预加载resource到缓存中（单位为pixel）。
21. asBitmap(). 无论资源是不是gif动画，都作为Bitmap对待。如果是gif动画会停在第一帧。
22. asGif().把资源作为GifDrawable对待。如果资源不是gif动画将会失败，会回调`.error()`。

#### **技巧**： ####

1. 禁止内存缓存：
 
 .skipMemoryCache(true)
 
 
 1
2. 清除内存缓存：
 
 // 必须在UI线程中调用
 Glide.get(context).clearMemory();
 
 
 1
 2
3. 禁止磁盘缓存：
 
 .diskCacheStrategy(DiskCacheStrategy.NONE)
 
 
 1
4. 清除磁盘缓存：
 
 // 必须在后台线程中调用，建议同时clearMemory()
 Glide.get(applicationContext).clearDiskCache();
 
 
 1
 2
5. 获取缓存大小：
 
 new GetDiskCacheSizeTask(textView).execute(new File(getCacheDir(), DiskCache.Factory.DEFAULT_DISK_CACHE_DIR));
 
 
 1
 
 class GetDiskCacheSizeTask extends AsyncTask<File, Long, Long> {
 private final TextView resultView;
 
 public GetDiskCacheSizeTask(TextView resultView) {
 this.resultView = resultView;
 }
 
 @Override
 protected void onPreExecute() {
 resultView.setText("Calculating...");
 }
 
 @Override
 protected void onProgressUpdate(Long... values) { /* onPostExecute(values[values.length - 1]); */ }
 
 @Override
 protected Long doInBackground(File... dirs) {
 try {
 long totalSize = 0;
 for (File dir : dirs) {
 publishProgress(totalSize);
 totalSize += calculateSize(dir);
 }
 return totalSize;
 } catch (RuntimeException ex) {
 final String message = String.format("Cannot get size of %s: %s", Arrays.toString(dirs), ex);
 new Handler(Looper.getMainLooper()).post(new Runnable() {
 @Override
 public void run() {
 resultView.setText("error");
 Toast.makeText(resultView.getContext(), message, Toast.LENGTH_LONG).show();
 }
 });
 }
 return 0L;
 }
 
 @Override
 protected void onPostExecute(Long size) {
 String sizeText = android.text.format.Formatter.formatFileSize(resultView.getContext(), size);
 resultView.setText(sizeText);
 }
 
 private static long calculateSize(File dir) {
 if (dir == null) return 0;
 if (!dir.isDirectory()) return dir.length();
 long result = 0;
 File[] children = dir.listFiles();
 if (children != null)
 for (File child : children)
 result += calculateSize(child);
 return result;
 }
 }
 
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
6. 指定资源的优先加载顺序：
 
 //优先加载
 Glide
 .with(context)
 .load(heroImageUrl)
 .priority(Priority.HIGH)
 .into(imageViewHero);
 //后加载
 Glide
 .with(context)
 .load(itemImageUrl)
 .priority(Priority.LOW)
 .into(imageViewItem);
 
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
7. 先显示缩略图，再显示原图：
 
 //用原图的1/10作为缩略图
 Glide
 .with(this)
 .load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png")
 .thumbnail(0.1f)
 .into(iv_0);
 //用其它图片作为缩略图
 DrawableRequestBuilder<Integer> thumbnailRequest = Glide
 .with(this)
 .load(R.drawable.news);
 Glide.with(this)
 .load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png")
 .thumbnail(thumbnailRequest)
 .into(iv_0);
 
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
8. 对图片进行裁剪、模糊、滤镜等处理： 
 推荐使用独立的图片处理库：[wasabeef/glide-transformations][wasabeef_glide-transformations]，使用也很简单：
 
 compile 'jp.wasabeef:glide-transformations:2.0.0'
 
 
 1
 
 之后我们就可以使用GenericRequestBuilder或其子类的`transform()`或`bitmapTransform()`方法设置图片转换了：
 
 //圆形裁剪
 Glide.with(this)
 .load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png")
 .bitmapTransform(new CropCircleTransformation(this))
 .into(iv_0);
 //圆角处理
 Glide.with(this)
 .load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png")
 .bitmapTransform(new RoundedCornersTransformation(this,30,0, RoundedCornersTransformation.CornerType.ALL))
 .into(iv_0);
 //灰度处理
 Glide.with(this)
 .load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png")
 .bitmapTransform(new GrayscaleTransformation(this))
 .into(iv_0);
 //其它变换...
 
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 
 可根据情况使用GenericRequestBuilder子类DrawableRequestBuilder的`bitmapTransform(Transformation<Bitmap>... bitmapTransformations)`，`transform(BitmapTransformation... transformations)`，`transform(Transformation<GifBitmapWrapper>... transformation)`，或其子类BitmapRequestBuilder的`transform(BitmapTransformation... transformations)`，`transform(Transformation<Bitmap>... transformations)`方法。 
 当然如果想自己写Transformation： 
 最简单的方式就是继承`BitmapTransformation`：
 
 private static class MyTransformation extends BitmapTransformation { 
 
 public MyTransformation(Context context) {
 super(context);
 }
 
 @Override
 protected Bitmap transform(BitmapPool pool, Bitmap toTransform, 
 int outWidth, int outHeight) {
 Bitmap myTransformedBitmap = ... //对Bitmap进行各种变换处理。
 return myTransformedBitmap;
 }
 
 @Override
 public String getId() {
 // 返回代表该变换的唯一Id，会作为cache key的一部分。
 // 注意：最好不要用getClass().getName()，因为容易受混淆影响。如果变换过程不影响缓存数据，可以返回空字符串。
 return "com.example.myapp.MyTransformation";
 }
 }
 
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 
 使用时只需使用`transform()`或`bitmapTransform()`方法即可：
 
 Glide.with(yourFragment)
 .load(yourUrl)
 .asBitmap()
 .transform(new MyTransformation(context))
 .into(yourView);
 
 
 1
 2
 3
 4
 5
 
 > 自定义图片处理时Glide会自动计算View/Target大小，我们不需要传View的宽高，当然你可以使用`override(int, int)`去改变这种行为。
 
 自定义图片处理时，为了避免创建大量Bitmap以及减少GC，可以考虑重用Bitmap，这就需要`BitmapPool`，典型地就是，从Bitmap池中拿一个Bitmap，用这个Bitmap生成一个Canvas, 然后在这个Canvas上画初始的Bitmap并使用Matrix、Paint、或者Shader处理这张图片。 
 为了有效并正确重用Bitmap需要遵循以下三条准则：
 
 1. 永远不要把`transform()`传给你的原始resource或原始Bitmap给`recycle()`了，更不要放回`BitmapPool`，因为这些都自动完成了。值得注意的是，任何从`BitmapPool`取出的用于自定义图片变换的辅助Bitmap，如果不经过`transform()`方法返回，就必须主动放回`BitmapPool`或者调用`recycle()`回收。
 2. 如果你从BitmapPool拿出多个Bitmap或不使用你从BitmapPool拿出的一个Bitmap，一定要返回extras给BitmapPool。
 3. 如果你的图片处理没有替换原始resource(例如由于一张图片已经匹配了你想要的尺寸，你需要提前返回), transform()\`方法就返回原始resource或原始Bitmap。 
 如：
 
 private static class MyTransformation extends BitmapTransformation { 
 
 public MyTransformation(Context context) {
 super(context);
 }
 
 @Override
 protected Bitmap transform(BitmapPool pool, Bitmap toTransform, int outWidth, int outHeight) {
 Bitmap result = pool.get(outWidth, outHeight, Bitmap.Config.ARGB_8888);
 // 如果BitmapPool中找不到符合该条件的Bitmap，get()方法会返回null，就需要我们自己创建Bitmap了
 if (result == null) {
 // 如果想让Bitmap支持透明度，就需要使用ARGB_8888
 result = Bitmap.createBitmap(outWidth, outHeight, Bitmap.Config.ARGB_8888);
 }
 //创建最终Bitmap的Canvas.
 Canvas canvas = new Canvas(result);
 Paint paint = new Paint();
 paint.setAlpha(128);
 // 将原始Bitmap处理后画到最终Bitmap中
 canvas.drawBitmap(toTransform, 0, 0, paint);
 // 由于我们的图片处理替换了原始Bitmap，就return我们新的Bitmap就行。
 // Glide会自动帮我们回收原始Bitmap。
 return result;
 }
 
 @Override
 public String getId() {
 // Return some id that uniquely identifies your transformation.
 return "com.example.myapp.MyTransformation";
 }
 }
 
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 
 也可以直接实现`Transformation`接口，进行更灵活的图片处理，如进行简单地圆角处理：
 
 public class RoundedCornersTransformation implements Transformation<Bitmap> { 
 
 private BitmapPool mBitmapPool;
 private int mRadius;
 
 public RoundedCornersTransformation(Context context, int mRadius) {
 this(Glide.get(context).getBitmapPool(), mRadius);
 }
 
 public RoundedCornersTransformation(BitmapPool mBitmapPool, int mRadius) {
 this.mBitmapPool = mBitmapPool;
 this.mRadius = mRadius;
 }
 
 @Override
 public Resource<Bitmap> transform(Resource<Bitmap> resource, int outWidth, int outHeight) {
 //从其包装类中拿出Bitmap
 Bitmap source = resource.get();
 int width = source.getWidth();
 int height = source.getHeight();
 Bitmap result = mBitmapPool.get(width, height, Bitmap.Config.ARGB_8888);
 if (result == null) {
 result = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
 }
 Canvas canvas = new Canvas(result);
 //以上已经算是教科书式写法了
 Paint paint = new Paint();
 paint.setAntiAlias(true);
 paint.setShader(new BitmapShader(source, Shader.TileMode.CLAMP, Shader.TileMode.CLAMP));
 canvas.drawRoundRect(new RectF(0, 0, width, height), mRadius, mRadius, paint);
 //返回包装成Resource的最终Bitmap
 return BitmapResource.obtain(result, mBitmapPool);
 }
 
 @Override
 public String getId() {
 return "RoundedTransformation(radius=" + mRadius + ")";
 }
 }
 
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
9. 对请求状态进行监听：
 
 public class MainActivity extends AppCompatActivity { 
 
 private static final String TAG = "MainActivity";
 
 private ImageView iv_0;
 private LoggingListener mCommonRequestListener;
 @Override
 protected void onCreate(Bundle savedInstanceState) {
 super.onCreate(savedInstanceState);
 setContentView(R.layout.activity_main);
 iv_0 = (ImageView) findViewById(R.id.iv_0);
 mCommonRequestListener = new LoggingListener<String, GlideDrawable>();
 Glide
 .with(this)
 .load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png")
 .listener(mCommonRequestListener)
 .into(iv_0);
 }
 }
 
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 
 /** * @param <A> model类型 * @param resource类型 */
 public class LoggingListener<A, B> implements RequestListener<A, B> { 
 private final int level;
 private final String name;
 private final RequestListener<A, B> delegate;
 
 public LoggingListener() {
 this("");
 }
 
 public LoggingListener(@NonNull String name) {
 this(Log.VERBOSE, name);
 }
 
 public LoggingListener(int level, @NonNull String name) {
 this(level, name, null);
 }
 
 public LoggingListener(RequestListener<A, B> delegate) {
 this(Log.VERBOSE, "", delegate);
 }
 
 public LoggingListener(int level, @NonNull String name, RequestListener<A, B> delegate) {
 this.level = level;
 this.name = name;
 this.delegate = delegate == null ? NoOpRequestListener.<A, B>get() : delegate;
 }
 
 @Override
 public boolean onException(Exception e, A model, Target target, boolean isFirstResource) {
 android.util.Log.println(level, "GLIDE", String.format(Locale.ROOT,
 "%s.onException(%s, %s, %s, %s)\n%s",
 name, e, model, strip(target), isFirst(isFirstResource), android.util.Log.getStackTraceString(e)));
 return delegate.onException(e, model, target, isFirstResource);
 }
 
 @Override
 public boolean onResourceReady(B resource, A model, Target target, boolean isFromMemoryCache,
 boolean isFirstResource) {
 String resourceString = strip(getResourceDescription(resource));
 String targetString = strip(getTargetDescription(target));
 android.util.Log.println(level, "GLIDE", String.format(Locale.ROOT,
 "%s.onResourceReady(%s, %s, %s, %s, %s)",
 name, resourceString, model, targetString, isMem(isFromMemoryCache), isFirst(isFirstResource)));
 return delegate.onResourceReady(resource, model, target, isFromMemoryCache, isFirstResource);
 }
 
 private String isMem(boolean isFromMemoryCache) {
 return isFromMemoryCache ? "sync" : "async";
 }
 
 private String isFirst(boolean isFirstResource) {
 return isFirstResource ? "first" : "not first";
 }
 
 private String getTargetDescription(Target target) {
 String result;
 if (target instanceof ViewTarget) {
 View v = ((ViewTarget) target).getView();
 LayoutParams p = v.getLayoutParams();
 result = String.format(Locale.ROOT,
 "%s(params=%dx%d->size=%dx%d)", target, p.width, p.height, v.getWidth(), v.getHeight());
 } else {
 result = String.valueOf(target);
 }
 return result;
 }
 
 private String getResourceDescription(B resource) {
 String result;
 if (resource instanceof Bitmap) {
 Bitmap bm = (Bitmap) resource;
 result = String.format(Locale.ROOT,
 "%s(%dx%d@%s)", resource, bm.getWidth(), bm.getHeight(), bm.getConfig());
 } else if (resource instanceof BitmapDrawable) {
 Bitmap bm = ((BitmapDrawable) resource).getBitmap();
 result = String.format(Locale.ROOT,
 "%s(%dx%d@%s)", resource, bm.getWidth(), bm.getHeight(), bm.getConfig());
 } else if (resource instanceof GlideBitmapDrawable) {
 Bitmap bm = ((GlideBitmapDrawable) resource).getBitmap();
 result = String.format(Locale.ROOT,
 "%s(%dx%d@%s)", resource, bm.getWidth(), bm.getHeight(), bm.getConfig());
 } else if (resource instanceof Drawable) {
 Drawable d = (Drawable) resource;
 result = String.format(Locale.ROOT,
 "%s(%dx%d)", resource, d.getIntrinsicWidth(), d.getIntrinsicHeight());
 } else {
 result = String.valueOf(resource);
 }
 return result;
 }
 
 private static String strip(Object text) {
 return String.valueOf(text).replaceAll("(com|android|net|org)(\\.[a-z]+)+\\.", "");
 }
 }
 
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
 
 public final class NoOpRequestListener<A, B> implements RequestListener<A, B> { 
 private static final RequestListener INSTANCE = new NoOpRequestListener();
 
 @SuppressWarnings("unchecked")
 public static <A, B> RequestListener<A, B> get() {
 return INSTANCE;
 }
 
 private NoOpRequestListener() {
 }
 
 @Override public boolean onException(Exception e, A a, Target target, boolean b) {
 return false;
 }
 @Override public boolean onResourceReady(B b, A a, Target target, boolean b2, boolean b1) {
 return false;
 }
 }
 
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 
 通过GenericRequestBuilder的`listener()`方法添加一个`RequestListener`实现，但要注意，最好不要用匿名类，也不要每次都创建新的监听器，要使用单例进行统一监听处理，以避免不必要的内存申请和不必要的引用。方法最好返回false，以便Glide能继续进行后续处理(如显示error占位符)。
10. 对资源的下载进度进行监听： 
 可以借助OkHttp的拦截器进行进度监听。OkHttp的拦截器官方Sample请移步[这里][Link 1]。我们可以利用这个拦截器进行监听并处理，需要自定义ModelLoader和DataFetcher，具体请详见我的Git：[https://github.com/shangmingchao/ProgressGlide][https_github.com_shangmingchao_ProgressGlide]，欢迎Star啊，不过没有太大必要告诉用户图片加载的进度（sjudd和TWiStErRob他们说的）。同时也可以看一下TWiStErRob大神的[实现][Link 2]（自备梯子哈~.~）。

### **四. Glide有哪些“坑”？** ###

1. **ImageView的setTag问题** 
 **问题描述：**如果使用`Glide`的`into(imageView)`为ImageView设置图片的同时使用ImageView的`setTag(final Object tag)`方法，将会导致`java.lang.IllegalArgumentException: You must not call setTag() on a view Glide is targeting`异常。因为`Glide`的`ViewTarget`中通过`view.setTag(tag)`和`view.getTag()`标记请求的，由于Android 4.0之前Tag存储在静态map里，如果Glide使用`setTag(int key, final Object tag)`方法标记请求则可能会导致内存泄露，所以Glide默认使用`view.setTag(tag)`标记请求，你就不能重复调用了。 
 **解决办法：**如果你需要为ImageView设置Tag，**必须**使用`setTag(int key, final Object tag)`及`getTag(int key)`方法，其中key必须是合法的资源ID以确保key的唯一性，典型做法就是在资源文件中声明type=”id”的item资源。
2. **placeholder()导致的图片变形问题** 
 **问题描述：**使用`.placeholder()`方法在某些情况下会导致图片显示的时候出现图片变形的情况。这是因为Glide默认开启的crossFade动画导致的TransitionDrawable绘制异常，详细描述和讨论可以看一下这个[\#363][363] issue。根本原因就是你的placeholder图片和你要加载显示的图片宽高比不一样，而Android的TransitionDrawable无法很好地处理不同宽高比的过渡问题，这的确是个Bug，是Android的也是Glide的。 
 **解决办法：**使用.dontAnimate()方法禁用过渡动画，或者使用animate()方法自己写动画，再或者自己修复TransitionDrawable的问题。
3. **ImageView的资源回收问题** 
 **问题描述：**默认情况下，Glide会根据`with()`使用的Activity或Fragment的生命周期自动调整资源请求以及资源回收。但是如果有很占内存的Fragment或Activity不销毁而仅仅是隐藏视图，那么这些图片资源就没办法及时回收，即使是GC的时候。 
 **解决办法：**可以考虑使用`WeakReference`，如：
 
 final WeakReference<ImageView> imageViewWeakReference = new WeakReference<>(imageView);
 ImageView target = imageViewWeakReference.get();
 if (target != null) {
 Glide.with(context).load(uri).into(target);
 }
 
 
 1
 2
 3
 4
 5
4. **ImageView的scaleType问题** 
 `scaleType`默认为`fitCenter`模式，如果你想设置成`centerInside`，不好意思，3.x还没有这个方法，参见这个[\#591][591] issue，折中的解决办法就是放弃使用`centerInside`，或者结合`android:scaleType="centerInside"`和`.dontTransform()`使用以禁止Glide对资源进行转换。 
 如果你想要ImageView的宽高根据图片资源的大小而定(即使用`wrap_comtent`)，那么你就必须明确告诉Glide我想加载原始资源：使用`android:scaleType="center"`，或者`.dontTransform()`，或者`.override(Target.SIZE_ORIGINAL, Target.SIZE_ORIGINAL)`。 
 不推荐使用`fitXY`，因为这样Glide会加载全尺寸图像到内存中而造成不必要的内存占用。
5. **异步线程完成后加载图片的崩溃问题** 
 **问题描述：**通常情况下，异步线程会被约束在Activity生命周期内，所以异步线程完成后使用Glide加载图片是没有问题的。但如果你的异步线程在Activity销毁时没有取消掉，那么异步线程完成后就Glide就无法为一个已销毁的Activity加载图片资源，抛出的异常如下（在with()方法中就进行判断并抛出异常）：
 
 java.lang.IllegalArgumentException: You cannot start a load for a destroyed activity
 at com.bumptech.glide.manager.RequestManagerRetriever.assertNotDestroyed(RequestManagerRetriever.java:134)
 at com.bumptech.glide.manager.RequestManagerRetriever.get(RequestManagerRetriever.java:102)
 at com.bumptech.glide.Glide.with(Glide.java:653)
 at com.frank.glidedemo.TestActivity.onGetDataCompleted(TestActivity.java:23)
 at com.frank.glidedemo.TestActivity.access$000(TestActivity.java:10)
 at com.frank.glidedemo.TestActivity$BackgroundTask.onPostExecute(TestActivity.java:46)
 at com.frank.glidedemo.TestActivity$BackgroundTask.onPostExecute(TestActivity.java:28)
 at android.os.AsyncTask.finish(AsyncTask.java:632)
 at android.os.AsyncTask.access$600(AsyncTask.java:177)
 at android.os.AsyncTask$InternalHandler.handleMessage(AsyncTask.java:645)
 at android.os.Handler.dispatchMessage(Handler.java:102)
 at android.os.Looper.loop(Looper.java:157)
 at android.app.ActivityThread.main(ActivityThread.java:5356)
 at java.lang.reflect.Method.invokeNative(Native Method)
 at java.lang.reflect.Method.invoke(Method.java:515)
 at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:1265)
 at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1081)
 at dalvik.system.NativeStart.main(Native Method)
 }
 
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 
 **解决办法：**正确管理Background Threads(异步线程)，当Activity停止或销毁时，停止所有相关的异步线程，停止所有后续的UI操作。或者加载前使用`isFinishing()`或`isDestroyed()`进行限制（不建议这种处理方式）。
6. **由于Bitmap复用导致的在某些设备上图片错乱的问题** 
 **问题描述：** Glide默认使用BitmapPool的方式对应用中用到的Bitmap进行复用，以减少频繁的内存申请和内存回收，而且默认使用的Bitmap模式为RGB565以减少内存开销。但在某些设备上（通常在Galaxy系列5.X设备上很容易复现）某些情况下会出现图片加载错乱的问题，具体详见这个[\#601][601] issue。原因初步确定是OpenGL纹理渲染异常。 
 **解决办法：**`GlideModule`使用`PREFER_ARGB_8888`（Glide4.X已经默认使用该模式了），虽然内存占用比RGB565更多一点，但可以更好地处理有透明度Bitmap的复用问题。或者禁用Bitmap复用`setBitmapPool(new BitmapPoolAdapter())`来修复这个问题（不推荐这种处理方式）。

--------------------

想了解更多，可以看一下这几篇翻译：

*  [Glide使用详解（二）][Glide]
 *  [Glide之GlideModule][Glide_GlideModule]
 *  [Glide之Target][Glide_Target]
 *  [Glide之后台线程加载及缓存资源][Glide 1]

[bumptech_glide]: https://github.com/bumptech/glide
[OkHttp]: https://github.com/square/okhttp
[https_img-my.csdn.net_uploads_201508_05_1438760757_3588.jpg]: https://img-my.csdn.net/uploads/201508/05/1438760757_3588.jpg
[https_img.alicdn.com_tps_TB1uyhoMpXXXXcLXVXXXXXXXXXX-476-538.jpg_240x5000q50.jpg_.webp]: https://img.alicdn.com/tps/TB1uyhoMpXXXXcLXVXXXXXXXXXX-476-538.jpg_240x5000q50.jpg_.webp
[wasabeef_glide-transformations]: https://github.com/wasabeef/glide-transformations
[Link 1]: https://github.com/square/okhttp/blob/master/samples/guide/src/main/java/okhttp3/recipes/Progress.java
[https_github.com_shangmingchao_ProgressGlide]: https://github.com/shangmingchao/ProgressGlide
[Link 2]: https://gist.github.com/TWiStErRob/08d5807e396740e52c90
[363]: https://github.com/bumptech/glide/issues/363
[591]: https://github.com/bumptech/glide/issues/591
[601]: https://github.com/bumptech/glide/issues/601
[Glide]: http://blog.csdn.net/shangmingchao/article/details/51172972
[Glide_GlideModule]: http://blog.csdn.net/shangmingchao/article/details/51026742
[Glide_Target]: http://blog.csdn.net/shangmingchao/article/details/51038529
[Glide 1]: http://blog.csdn.net/shangmingchao/article/details/51058785