1、在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'
2、然后配置混淆规则:
-keeppublicclass
*implements
com.bumptech.glide.module.GlideModule
-keeppublic
enum
com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$**
{
**[] $VALUES;
public *;
}
其中第一个混淆规则表明不混淆所有的GlideModule。
如果需要的话,还需添加相应的权限:
3、 使用Glide.with(this).load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png").into(imageView);
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.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://cn.bing.com/az/hprichbg/rb/Dongdaemun_ZH-CN10736487148_1920x1080.jpg") load https资源:load(" http://cn.bing.com/az/hprichbg/rb/Dongdaemun_ZH-CN10736487148_1920x1080.jpg ")
当然,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(ModelLoadermodelLoader, ClassdataClass),using(final StreamModelLoadermodelLoader),using(StreamByteArrayLoader modelLoader),using(final FileDescriptorModelLoadermodelLoader)。
返回GenericRequestBuilder实例。
GenericRequestBuilder使用
GenericRequestBuilder是最顶层的Request Builder,用于处理选项设置和开始一般resource类型资源的加载。其中ModelType是指代表资源的类型,如"http://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(RequestListenerrequestListener). 监听资源加载的请求状态,可以使用两个回调:onResourceReady(R resource, T model, Targettarget, boolean isFromMemoryCache, boolean isFirstResource)和onException(Exception e, T model, Target 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()。
4、技巧
1、禁止内存缓存:
.skipMemoryCache(true)
2、清除内存缓存:
// 必须在UI线程中调用
Glide.get(context).clearMemory();
3、禁止磁盘缓存:
.diskCacheStrategy(DiskCacheStrategy.NONE)
4、清除磁盘缓存:
// 必须在后台线程中调用,建议同时clearMemory() Glide.get(applicationContext).clearDiskCache();
5、获取缓存大小:
new GetDiskCacheSizeTask(textView).execute(new File(getCacheDir(), DiskCache.Factory.DEFAULT_DISK_CACHE_DIR));11class GetDiskCacheSizeTask extends AsyncTask{
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;}
}
6、指定资源的优先加载顺序:
//优先加载
Glide
.with(context)
.load(heroImageUrl)
.priority(Priority.HIGH)
.into(imageViewHero);
//后加载
Glide
.with(context)
.load(itemImageUrl)
.priority(Priority.LOW)
.into(imageViewItem);
7、先显示缩略图,再显示原图:
//用原图的1/10作为缩略图 Glide
.with(this) .load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png") .thumbnail(0.1f) .into(iv_0); //用其它图片作为缩略图 DrawableRequestBuilderthumbnailRequest = Glide
.with(this)
.load(R.drawable.news);
Glide.with(this)
.load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png")
.thumbnail(thumbnailRequest)
.into(iv_0);
8、对图片进行裁剪、模糊、滤镜等处理:
推荐使用独立的图片处理库: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);
//其它变换...
5、 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 issue。根本原因就是你的placeholder图片和你要加载显示的图片宽高比不一样,而Android的TransitionDrawable无法很好地处理不同宽高比的过渡问题,这的确是个Bug,是Android的也是Glide的。 解决办法:使用.dontAnimate()方法禁用过渡动画,或者使用animate()方法自己写动画,再或者自己修复TransitionDrawable的问题。
3、ImageView的资源回收问题 问题描述:默认情况下,Glide会根据with()使用的Activity或Fragment的生命周期自动调整资源请求以及资源回收。但是如果有很占内存的Fragment或Activity不销毁而仅仅是隐藏视图,那么这些图片资源就没办法及时回收,即使是GC的时候。 解决办法:可以考虑使用WeakReference,如: final WeakReferenceimageViewWeakReference = 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还没有这个方法,参见这个#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)
}
解决办法:正确管理Background Threads(异步线程),当Activity停止或销毁时,停止所有相关的异步线程,停止所有后续的UI操作。或者加载前使用isFinishing()或isDestroyed()进行限制(不建议这种处理方式)。
6、由于Bitmap复用导致的在某些设备上图片错乱的问题
问题描述: Glide默认使用BitmapPool的方式对应用中用到的Bitmap进行复用,以减少频繁的内存申请和内存回收,而且默认使用的Bitmap模式为RGB565以减少内存开销。但在某些设备上(通常在Galaxy系列5.X设备上很容易复现)某些情况下会出现图片加载错乱的问题,具体详见这个#601 issue。原因初步确定是OpenGL纹理渲染异常。
解决办法:GlideModule使用PREFER_ARGB_8888(Glide4.X已经默认使用该模式了),虽然内存占用比RGB565更多一点,但可以更好地处理有透明度Bitmap的复用问题。或者禁用Bitmap复用setBitmapPool(new BitmapPoolAdapter())来修复这个问题(不推荐这种处理方式)
6、Picasso和Glide的区别
1、Glide比Picasso加载速度快
2、默认情况Glide更有利于减少OutOfMemoryError的发生,不过Picasso的图片质量更高
3、Glide支持gif,Picasso不支持