在build.gradle中添加依赖:
compile 'com.github.bumptech.glide:glide:3.7.0'
需要support-v4库的支持,如果你的项目没有support-v4库(项目默认已经添加了),还需要添加support-v4依赖:
compile 'com.android.support:support-v4:23.3.0'
混淆规则:其中第一个混淆规则表明不混淆所有的GlideModule。
-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
**[] $VALUES;
public *;
}
简单使用:
Glide
.with(this)
.load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png")
.into(imageView);
.load()使用
Glide基本可以load任何可以拿到的媒体资源,如:
SD卡资源
load("file://"+ Environment.getExternalStorageDirectory().getPath()+"/test.jpg")
assets资源
load("file:///android_asset/f003.gif")
raw资源
load("android.resource://com.frank.glide/raw/raw_1")或
load("android.resource://com.frank.glide/raw/"+R.raw.raw_1)
drawable资源
load("android.resource://com.frank.glide/drawable/news")或
load("android.resource://com.frank.glide/drawable/"+R.drawable.news)
ContentProvider资源
load("content://media/external/images/media/139469")
http资源
load("[http://img.my.csdn.net/uploads/201508/05/1438760757_3588.jpg](http://img.my.csdn.net/uploads/201508/05/1438760757_3588.jpg)")
简单设置
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。
priority(Priority priority). 指定加载的优先级,优先级越高越优先加载,但不保证所有图片都按序加载。枚举Priority.IMMEDIATE,Priority.HIGH,Priority.NORMAL,Priority.LOW。默认为Priority.NORMAL。
4、dontAnimate(). 移除所有的动画。
5、animate(int animationId). 在异步加载资源完成时会执行该动画。
6、animate(ViewPropertyAnimation.Animator animator). 在异步加载资源完成时会执行该动画。
7、placeholder(int resourceId). 设置资源加载过程中的占位Drawable。
8、placeholder(Drawable drawable). 设置资源加载过程中的占位Drawable。
9、fallback(int resourceId). 设置model为空时要显示的Drawable。如果没设置fallback,model为空时将显示error的Drawable,如果error的Drawable也没设置,就显示placeholder的Drawable。
10、fallback(Drawable drawable).设置model为空时显示的Drawable。
11、error(int resourceId).设置load失败时显示的Drawable。
12、error(Drawable drawable).设置load失败时显示的Drawable。
13、skipMemoryCache(boolean skip). 设置是否跳过内存缓存,但不保证一定不被缓存(比如请求已经在加载资源且没设置跳过内存缓存,这个资源就会被缓存在内存中)。
14、override(int width, int height). 重新设置Target的宽高值(单位为pixel)。
15、into(Y target).设置资源将被加载到的Target。
16、into(ImageView view). 设置资源将被加载到的ImageView。取消该ImageView之前所有的加载并释放资源。
17、into(int width, int height). 后台线程加载时要加载资源的宽高值(单位为pixel)。
18、preload(int width, int height). 预加载resource到缓存中(单位为pixel)。
19、asBitmap(). 无论资源是不是gif动画,都作为Bitmap对待。如果是gif动画会停在第一帧。
20、asGif().把资源作为GifDrawable对待。如果资源不是gif动画将会失败,会回调.error()。
技巧
1.禁止内存缓存
.skipMemoryCache(true)
2.清除内存缓存
// 必须在UI线程中调用
Glide.get(context).clearMemory();
3.禁止磁盘缓存
.diskCacheStrategy(DiskCacheStrategy.NONE)
4.清除磁盘缓存
// 必须在后台线程中调用,建议同时clearMemory()
Glide.get(applicationContext).clearDiskCache();
5.指定资源的优先加载顺序
//优先加载
Glide
.with(context)
.load(heroImageUrl)
.priority(Priority.HIGH)
.into(imageViewHero);
//后加载
Glide
.with(context)
.load(itemImageUrl)
.priority(Priority.LOW)
.into(imageViewItem);
6.先显示缩略图,再显示原图:
//用原图的1/10作为缩略图
Glide
.with(this)
.load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png")
.thumbnail(0.1f)
.into(iv_0);
//用其它图片作为缩略图
DrawableRequestBuilder 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);
7.对图片进行裁剪、模糊、滤镜等处理:推荐使用独立的图片处理库:wasabeef/glide-transformations,使用也很简单
compile 'jp.wasabeef:glide-transformations:2.0.0'
之后我们就可以使用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);
//其它变换...
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绘制异常,详细描述和讨论可以看一下这个#363issue。根本原因就是你的placeholder图片和你要加载显示的图片宽高比不一样,而Android的TransitionDrawable无法很好地处理不同宽高比的过渡问题,这的确是个Bug,是Android的也是Glide的。
解决办法:使用.dontAnimate()
方法禁用过渡动画,或者使用animate()
方法自己写动画,再或者自己修复TransitionDrawable的问题。
3、ImageView的资源回收问题
问题描述:默认情况下,Glide会根据with()
使用的Activity或Fragment的生命周期自动调整资源请求以及资源回收。但是如果有很占内存的Fragment或Activity不销毁而仅仅是隐藏视图,那么这些图片资源就没办法及时回收,即使是GC的时候。
解决办法:可以考虑使用WeakReference,如:
final WeakReference imageViewWeakReference = new WeakReference<>(imageView);
ImageView target = imageViewWeakReference.get();
if (target != null) {
Glide.with(context).load(uri).into(target);
}
4、ImageView的scaleType问题
scaleType
默认为fitCenter
模式,如果你想设置成centerInside
,不好意思,3.x还没有这个方法,参见这个#591issue,折中的解决办法就是放弃使用centerInside
,或者结合android:scaleType="centerInside"
和.dontTransform()
使用以禁止Glide对资源进行转换。如果你想要ImageView的宽高根据图片资源的大小而定(即使用wrap_comtent
),那么你就必须明确告诉Glide我想加载原始资源:使用android:scaleType="center"
,或者.dontTransform()
,或者
.override(Target.SIZE_ORIGINAL, Target.SIZE_ORIGINAL)
。
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)
解决办法:正确管理Background Threads(异步线程),当Activity停止或销毁时,停止所有相关的异步线程,停止所有后续的UI操作。或者加载前使用isFinishing()
或isDestroyed()
进行限制(不建议这种处理方式)。