一. 下载
在build.gradle中添加依赖:
需要support-v4库的支持,如果你的项目没有support-v4库(项目默认已经添加了),还需要添加support-v4依赖:
然后配置混淆规则:
二. 集成网络框架OkHttp(可选)
Glide的网络请求部分可以使用当前最流行的网络请求框架Volley或OkHttp,也可以通过Glide的ModelLoader接口自己写网络请求。
Glide默认使用HttpUrlConnection
进行网络请求,为了让APP保持一致的网络请求形式,可以让Glide使用我们指定的网络请求形式请求网络资源,这里我们选OkHttp (具有支持HTTP/2、利用连接池技术减少请求延迟、缓存响应结果等等优点),需要添加一个集成库:
注意:
1. OkHttp 2.x和OkHttp 3.x需使用不同的集成库。
2. Gradle会自动将OkHttpGlideModule合并到应用的manifest文件中。
3. 如果你没有对所有的GlideModule
配置混淆规则(即没有使用-keep public class * implements com.bumptech.glide.module.GlideModule
),则需要把OkHttp的GlideModule
进行防混淆配置:
三. 使用
简单使用:
Glide.with()使用
- with(Context context). 使用Application上下文,Glide请求将不受Activity/Fragment生命周期控制。
- with(Activity activity).使用Activity作为上下文,Glide的请求会受到Activity生命周期控制。
- with(FragmentActivity activity).Glide的请求会受到FragmentActivity生命周期控制。
- with(android.app.Fragment fragment).Glide的请求会受到Fragment 生命周期控制。
- 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("http://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")
当然,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
是指代表资源的类型,如"http://img.my.csdn.Net/uploads/201508/05/1438760757_3588.jpg"这个String就代表了一张图片资源,所以这个ModelType就是String。DataType
是指ModelLoader提供的,可以被ResourceDecoder解码的数据类型。ResourceType
是指将要加载的resource类型。TranscodeType
是指已解码的资源将要被转成的资源类型。
- thumbnail(float sizeMultiplier). 请求给定系数的缩略图。如果缩略图比全尺寸图先加载完,就显示缩略图,否则就不显示。系数sizeMultiplier必须在(0,1)之间,可以递归调用该方法。
- sizeMultiplier(float sizeMultiplier). 在加载资源之前给Target大小设置系数。
- 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。
- dontAnimate(). 移除所有的动画。
- animate(int animationId). 在异步加载资源完成时会执行该动画。
- animate(ViewPropertyAnimation.Animator animator). 在异步加载资源完成时会执行该动画。
- placeholder(int resourceId). 设置资源加载过程中的占位Drawable。
- placeholder(Drawable drawable). 设置资源加载过程中的占位Drawable。
- fallback(int resourceId). 设置model为空时要显示的Drawable。如果没设置fallback,model为空时将显示error的Drawable,如果error的Drawable也没设置,就显示placeholder的Drawable。
- fallback(Drawable drawable).设置model为空时显示的Drawable。
- error(int resourceId).设置load失败时显示的Drawable。
- error(Drawable drawable).设置load失败时显示的Drawable。
- 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)
,但不要每次请求都使用新的监听器,要避免不必要的内存申请,可以使用单例进行统一的异常监听和处理。 - skipMemoryCache(boolean skip). 设置是否跳过内存缓存,但不保证一定不被缓存(比如请求已经在加载资源且没设置跳过内存缓存,这个资源就会被缓存在内存中)。
- override(int width, int height). 重新设置Target的宽高值(单位为pixel)。
- into(Y target).设置资源将被加载到的Target。
- into(ImageView view). 设置资源将被加载到的ImageView。取消该ImageView之前所有的加载并释放资源。
- into(int width, int height). 后台线程加载时要加载资源的宽高值(单位为pixel)。
- preload(int width, int height). 预加载resource到缓存中(单位为pixel)。
- asBitmap(). 无论资源是不是gif动画,都作为Bitmap对待。如果是gif动画会停在第一帧。
- asGif().把资源作为GifDrawable对待。如果资源不是gif动画将会失败,会回调
.error()
。
Glide的缓存
用过手机的都知道,当划上划下一个ListView的时候,第二次都比第一次快,就是因为为GlideView对资源进行了缓存,而且封装的很好,甚至不需要自己去设定缓存大小,Glide会智能地自己给我们根据设备设置缓存大小。
placeHolder
听名字都知道这家伙是干嘛的,加载图片,但是图片还没有加载完的时候,总不能给用户看空白吧,这个就是用来填充着一段是时间的。
Glide.with(context).
load(UsageExampleListViewAdapter.eatFoodyImages[0])
.placeholder(R.mipmap.ic_launcher) *// 同样也可以是drawble
.into(imageViewPlaceholder);
这里只能用本地资源,不能用网络资源,因为网络资源也有可能加载不出来。
当加载出错,或者加载不出来的时候.error()方法来帮忙
其实大多数时候用placeHolder就可以了。
Glide.with(context)
.load("http://futurestud.io/non_existing_image.png")
.placeholder(R.mipmap.ic_launcher) // 同样也可以是drawble
.error(R.mipmap.future_studio_launcher)// 当不能加载时载入
.fallback
除了上面两种‘异常情况’,还有一种情形就是打开手机的通讯录的时候,可以看到你给有些喜欢的人设置了照片,然而有些可怜的人并没给有,总不能在那里留下一片空白吧,这个时候相当于传递了Null,传递null时,这个callback方法就会被调用,推荐在这里给我设置一张吴彦祖或者小贝的照片。嗯。。(QAQ)
Glide.with(context)
.load( null)//加载空指针的时候
.fallback( R.drawable.wuyanzu)//嗯,吴彦祖。
.into( imageViewNoFade );
加点动画
嗯,其实这个是默认的,但是你还是可以写出来,渐显动画
Glide.with(context)
.load().placeholder(R.mipmap.ic_launcher)
.error(R.mipmap.future_studio_launcher)
.crossFade()
.into(imageViewFade);
这里还有一个.fadeFade(int duration)
,设置动画时间。如果你不想要动画可以加上.dontAnimate()
调整图片大小.resize(int ,int )
单位是像素,裁剪你的图片大小。其实Glide已经会自动根据你mageView裁剪照片来放在缓存中了。但是不想适应ImageView大小的时候,可以调用这个方法.override()
。
Glide.with(context)
.load(image)
.override(600, 200)
.into(imageViewResize);
裁剪图片
就是上名讲的.fitCenter
和.CenterCrop
来点缩略图
缩略图有什么用就不说了,方正在一些条件下好处大大的,相当于一个动态的placeHolder。还有一种方法。
.thumbnail()
方法的目的就是让用户先看到一个低解析度的图,点开后,再加载一个高解析度的图。
Glide.
with( context )
.load(image)
.thumbnail( 0.1f )//表示为原图的十分之一
.into( imageView2 );
一种更高级的缩略图加载方式
当缩略图也需要通过网络加载全部解析度的时候。
private void loadImageThumbnailRequest() {
DrawableRequestBuilder<String> thumbnailRequest = Glide.with( context ).load( eatFoodyImages[2] );
Glide.with( context ).load( UsageExampleGifAndVideos.gifUrl ).thumbnail( thumbnailRequest ).into( imageView3 );
}
关于缓存
要想性能好,怎可以不用缓存。缓存就是为了减少或者杜绝多的网络请求。为了避免缓存,Glide用了内存缓存和‘外存缓存机制’,并且 提供了相应的方法,完全封装,不需要处理细节。Glide会自动缓存到内存,除非调用.skipMemoryCache( true )
。尽管调用了这个,Glide还是会缓存到外存,还有一种情形,就是有一张图片,但是这张图变化非常快,这个时候可能并不想缓存到外存中,就使用.diskCacheStrategy( DiskCacheStrategy.NONE )。
如果你两种都不需要,可以两个方法组合着一起使用。
自定义外存缓存机制
Glide默认会缓存Image的很多个版本,比如原图,如果你的imageView大小的缓存。.diskCacheStrategy( )
有以下几种缓存策略:
- DiskCacheStrategy.NONE 什么都不缓存
- DiskCacheStrategy.SOURCE 只缓存最高解析图的image
- DiskCacheStrategy.RESULT 缓存最后一次那个image,比如有可能你对image做了转化
- DiskCacheStrategy.ALL image的所有版本都会缓存
Glide .with( context ).load( image ) .diskCacheStrategy( DiskCacheStrategy.SOURCE ) .into( imageViewFile );
请求优先级
加载图片肯定也是有先后顺序,Glide提供了.request()
.request()
这个方法,它接收以下几个参数: - Priority.LOW
- Priority.NORMAL
- Priority.HIGH
- Priority.IMMEDIATE
但是Glide并不一定会按照你的顺序来,只是尽量按照你的顺序来。(比如给一张很大的图片最高的优先权,但是它并不一定比低优先级的图先加载出来,这个时候只有使用缩略图了)
利用callback在非标准情况下加载图片
上名所有的情况都是加载图片到ImageView中,但是并不是所有的情况都是这样。
Glide中的回调:Targets
从上面的介绍,已经可以看出Glide内部封装了所有的细节,什么网络请求,什么缓存机制,当所有都就绪过后,自动切换回UI线程,更新ImageView。Targets就是Glide中的回调,当异步线程中所有的工作做完过后返回结果。说白了就是,当请求图片完成后,需要回调的方法。
SimplerTarget
private SimpleTarget target = new SimpleTarget<Bitmap>() {
@Override
public void onResourceReady(Bitmap bitmap, GlideAnimation glideAnimation) {
// do something with the bitmap
// for demonstration purposes, let's just set it to an ImageView
imageView1.setImageBitmap( bitmap );
}
};
private void loadImageSimpleTarget() {
Glide.with( context ) *// could be an issue!*
.load( eatFoodyImages[0] )
.asBitmap()//强制Glide返回一个Bitmap
.into( target );}
注意事项:
- 上面这段代码不要写成匿名内部类的机制,原因就是java的自动垃圾回收机制可能在图片还没有加载好的时候就已经把你的Target回收了。
- 注意.with()里面的参数,Glide的请求是和传进去的Context共存亡的,如果传一个Activity进去,当Activity GG过后,你的请求也就GG了,但是如果这样传:
.with(context.getApplicationContext() ).
当你的Activity GG过后,请求还是会继续,回调还是会继续。有size的Target
如果传给.into()
的是一个ImageView,但是图片的size比ImageView的Size打,Glide为了节省时间,会加载小的那个size的Image。但是这对Target并不适用,以为这里并不知道SIze。但是如果知道image应该多大,可以传递给Target.就像下面这样:private SimpleTarget target2 = new SimpleTarget<Bitmap>( 250, 250 ) { @Override public void onResourceReady(Bitmap bitmap, GlideAnimation glideAnimation) {imageView2.setImageBitmap( bitmap ); } }; private void loadImageSimpleTargetApplicationContext() { Glide.with( context.getApplicationContext() ) *// safer!* .load( eatFoodyImages[1] ) .asBitmap() .into( target2 ); }
ViewTarget
适用于想Glide加载到自定义View中去,public class FutureStudioView extends FrameLayout { ImageView iv; TextView tv; public void nitialize(Context context) { inflate( context, R.layout.custom_view_futurestudio, this ); iv = (ImageView) findViewById( R.id.custom_view_image ); tv = (TextView) findViewById( R.id.custom_view_text ); } public FutureStudioView(Context context, AttributeSet attrs) { super( context, attrs ); initialize( context ); } public FutureStudioView(Context context,AttributeSet attrs,int defStyleAttr) { super( context, attrs, defStyleAttr ); initialize( context ); } public void setImage(Drawable drawable) { iv = (ImageView) findViewById( R.id.custom_view_image ); iv.setImageDrawable( drawable ); }}
四. Glide有哪些“坑”?
- 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资源。 - placeholder()导致的图片变形问题
问题描述:使用.placeholder()
方法在某些情况下会导致图片显示的时候出现图片变形的情况。这是因为Glide默认开启的crossFade动画导致的TransitionDrawable绘制异常,详细描述和讨论可以看一下这个#363issue。根本原因就是你的placeholder图片和你要加载显示的图片宽高比不一样,而Android的TransitionDrawable无法很好地处理不同宽高比的过渡问题,这的确是个Bug,是Android的也是Glide的。
解决办法:使用.dontAnimate()方法禁用过渡动画,或者使用animate()方法自己写动画,再或者自己修复TransitionDrawable的问题。 -
ImageView的资源回收问题
问题描述:默认情况下,Glide会根据with()
使用的Activity或Fragment的生命周期自动调整资源请求以及资源回收。但是如果有很占内存的Fragment或Activity不销毁而仅仅是隐藏视图,那么这些图片资源就没办法及时回收,即使是GC的时候。
解决办法:可以考虑使用WeakReference
,如: - ImageView的scaleType问题
scaleType
默认为fitCenter
模式,如果你想设置成centerInside
,不好意思,3.x还没有这个方法,参见这个#591 issue,折中的解决办法就是放弃使用centerInside
,或者结合android:scaleType="centerInside"
和.dontTransform()
使用以禁止Glide对资源进行转换。
如果你想要ImageView的宽高根据图片资源的大小而定(即使用wrap_comtent
),那么你就必须明确告诉Glide我想加载原始资源:使用android:scaleType="center"
,或者.dontTransform()
,或者.override(Target.SIZE_ORIGINAL, Target.SIZE_ORIGINAL)
。 -
异步线程完成后加载图片的崩溃问题
问题描述:正常情况下,异步线程会被约束在Activity生命周期内,所以异步线程完成后使用Glide加载图片是没有问题的。但如果你的异步线程在Activity销毁时没有取消掉,那么异步线程完成后就Glide就无法为一个已销毁的Activity加载图片资源,抛出的异常如下(在with()方法中就进行判断并抛出异常):解决办法:正确管理Background Threads(异步线程),当Activity停止或销毁时,停止所有相关的异步线程,停止所有后续的UI操作。或者加载前使用
isFinishing()
或isDestroyed()
进行限制(不建议这种处理方式)。
-
顶
- 1
-
踩
- ImageView的setTag问题