该文章基于Glide v3.7.0版本
Glide v4版本详解请移步: http://blog.csdn.net/shangmingchao/article/details/78219558
在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'
然后配置混淆规则:
-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
**[] $VALUES;
public *;
}
其中第一个混淆规则表明不混淆所有的GlideModule
。
如果需要的话,还需添加相应的权限:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
Glide Repo:bumptech/glide
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. 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);
返回关联了相应上下文的RequestManager
实例。
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")
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 modelLoader, Class
,using(final StreamModelLoader
,using(StreamByteArrayLoader modelLoader)
,using(final FileDescriptorModelLoader
。
返回GenericRequestBuilder实例。
GenericRequestBuilder
是最顶层的Request Builder,用于处理选项设置和开始一般resource类型资源的加载。其中ModelType
是指代表资源的类型,如"https://img-my.csdn.net/uploads/201508/05/1438760757_3588.jpg"这个String就代表了一张图片资源,所以这个ModelType就是String。DataType
是指ModelLoader提供的,可以被ResourceDecoder解码的数据类型。ResourceType
是指将要加载的resource类型。TranscodeType
是指已解码的资源将要被转成的资源类型。
onResourceReady(R resource, T model, Target target, boolean isFromMemoryCache, boolean isFirstResource)
和onException(Exception e, T model, Target<R> target, boolean isFirstResource)
,但不要每次请求都使用新的监听器,要避免不必要的内存申请,可以使用单例进行统一的异常监听和处理。.error()
。禁止内存缓存:
.skipMemoryCache(true)
清除内存缓存:
// 必须在UI线程中调用
Glide.get(context).clearMemory();
禁止磁盘缓存:
.diskCacheStrategy(DiskCacheStrategy.NONE)
清除磁盘缓存:
// 必须在后台线程中调用,建议同时clearMemory()
Glide.get(applicationContext).clearDiskCache();
获取缓存大小:
new GetDiskCacheSizeTask(textView).execute(new File(getCacheDir(), DiskCache.Factory.DEFAULT_DISK_CACHE_DIR));
class 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;
}
}
指定资源的优先加载顺序:
//优先加载
Glide
.with(context)
.load(heroImageUrl)
.priority(Priority.HIGH)
.into(imageViewHero);
//后加载
Glide
.with(context)
.load(itemImageUrl)
.priority(Priority.LOW)
.into(imageViewItem);
先显示缩略图,再显示原图:
//用原图的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);
对图片进行裁剪、模糊、滤镜等处理:
推荐使用独立的图片处理库: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);
//其它变换...
可根据情况使用GenericRequestBuilder子类DrawableRequestBuilder的bitmapTransform(Transformation
,transform(BitmapTransformation... transformations)
,transform(Transformation
,或其子类BitmapRequestBuilder的transform(BitmapTransformation... transformations)
,transform(Transformation
方法。
当然如果想自己写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";
}
}
transform()
或bitmapTransform()
方法即可:Glide.with(yourFragment)
.load(yourUrl)
.asBitmap()
.transform(new MyTransformation(context))
.into(yourView);
自定义图片处理时Glide会自动计算View/Target大小,我们不需要传View的宽高,当然你可以使用
override(int, int)
去改变这种行为。
自定义图片处理时,为了避免创建大量Bitmap以及减少GC,可以考虑重用Bitmap,这就需要BitmapPool
,典型地就是,从Bitmap池中拿一个Bitmap,用这个Bitmap生成一个Canvas, 然后在这个Canvas上画初始的Bitmap并使用Matrix、Paint、或者Shader处理这张图片。
为了有效并正确重用Bitmap需要遵循以下三条准则:
transform()
传给你的原始resource或原始Bitmap给recycle()
了,更不要放回BitmapPool
,因为这些都自动完成了。值得注意的是,任何从BitmapPool
取出的用于自定义图片变换的辅助Bitmap,如果不经过transform()
方法返回,就必须主动放回BitmapPool
或者调用recycle()
回收。 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";
}
}
也可以直接实现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 transform(Resource 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 + ")";
}
}
对请求状态进行监听:
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();
Glide
.with(this)
.load("http://inthecheesefactory.com/uploads/source/nestedfragment/fragments.png")
.listener(mCommonRequestListener)
.into(iv_0);
}
}
/**
* @param model类型
* @param resource类型
*/
public class LoggingListener<A, B> implements RequestListener<A, B> {
private final int level;
private final String name;
private final RequestListener 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 delegate) {
this(Log.VERBOSE, "", delegate);
}
public LoggingListener(int level, @NonNull String name, RequestListener delegate) {
this.level = level;
this.name = name;
this.delegate = delegate == null ? NoOpRequestListener.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]+)+\\.", "");
}
}
public final class NoOpRequestListener<A, B> implements RequestListener<A, B> {
private static final RequestListener INSTANCE = new NoOpRequestListener();
@SuppressWarnings("unchecked")
public static RequestListener 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;
}
}
通过GenericRequestBuilder的listener()
方法添加一个RequestListener
实现,但要注意,最好不要用匿名类,也不要每次都创建新的监听器,要使用单例进行统一监听处理,以避免不必要的内存申请和不必要的引用。方法最好返回false,以便Glide能继续进行后续处理(如显示error占位符)。
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)
标记请求,你就不能重复调用了。 setTag(int key, final Object tag)
及getTag(int key)
方法,其中key必须是合法的资源ID以确保key的唯一性,典型做法就是在资源文件中声明type="id"的item资源。.placeholder()
方法在某些情况下会导致图片显示的时候出现图片变形的情况。这是因为Glide默认开启的crossFade动画导致的TransitionDrawable绘制异常,详细描述和讨论可以看一下这个#363 issue。根本原因就是你的placeholder图片和你要加载显示的图片宽高比不一样,而Android的TransitionDrawable无法很好地处理不同宽高比的过渡问题,这的确是个Bug,是Android的也是Glide的。 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);
}
scaleType
默认为fitCenter
模式,如果你想设置成centerInside
,不好意思,3.x还没有这个方法,参见这个#591 issue,折中的解决办法就是放弃使用centerInside
,或者结合android:scaleType="centerInside"
和.dontTransform()
使用以禁止Glide对资源进行转换。 wrap_comtent
),那么你就必须明确告诉Glide我想加载原始资源:使用android:scaleType="center"
,或者.dontTransform()
,或者.override(Target.SIZE_ORIGINAL, Target.SIZE_ORIGINAL)
。 fitXY
,因为这样Glide会加载全尺寸图像到内存中而造成不必要的内存占用。异步线程完成后加载图片的崩溃问题
问题描述:通常情况下,异步线程会被约束在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()
进行限制(不建议这种处理方式)。
GlideModule
使用PREFER_ARGB_8888
(Glide4.X已经默认使用该模式了),虽然内存占用比RGB565更多一点,但可以更好地处理有透明度Bitmap的复用问题。或者禁用Bitmap复用setBitmapPool(new BitmapPoolAdapter())
来修复这个问题(不推荐这种处理方式)。Dalvik和ART都没有使用compacting garbage collector垃圾回收模式,这种模式中GC会遍历堆,同时把活跃对象移到相邻内存区域,让更大的内存块可以用在后续的分配中。因为安卓没有这种模式,就可能会出现被分配的对象分散在各处,对象之间只有很小的内存可用。如果应用试图分配一个大于邻近的闲置内存块空间的对象,就会导致OOM崩溃,即使总的空余内存空间大于要分配的对象的大小。
而且,同步GC时会暂停所有线程(包括UI主线程)以便进行GC,虽然暂停时间很短,但频繁的同步GC会造成页面卡顿,从而影响用户体验。
因此为了避免频繁的创建以及回收Bitmap对象,进而减少GC的出现,可以使用BitmapPool统一的管理Bitmap的创建以及重用。 BitmapPool
接口就是用来重用Bitmap对象的。
该接口定义的方法:
getDirty(int, int, Bitmap.Config)
方法略慢一点。如果Bitmap用于BitmapFactory或其它每个像素都被覆盖或清除的场景,用
getDirty(int, int, Bitmap.Config)
显然更快一点。当然,为了确保正确性用该方法也可以。
get(int, int, Bitmap.Config)
方法一样,只是返回的任何非空Bitmap对象都可能包含未擦除的像素数据或随机数据。