Glide使用手册

Posted by HaoChen Blog on August 29, 2016

作者:邓浩宸

Glide简介:

 Glide 是 Google 员工的开源项目, Google I/O 上被推荐使用,一个高效、开源、Android设备上的媒体管理框架,它遵循BSD、MIT以及Apache 2.0协议发布。Glide具有获取、解码和展示视频剧照、图片、动画等功能,它还有灵活的API,这些API使开发者能够将Glide应用在几乎任何网络协议栈里。创建Glide的主要目的有两个,一个是实现平滑的图片列表滚动效果,另一个是支持远程图片的获取、大小调整和展示。

Glide特点

  • 使用简单
  • 可配置度高,自适应程度高
  • 支持常见图片格式 JPG PNG GIF WEBP
  • 支持多种数据源 网络、本地、资源、Assets 等
  • 高效缓存策略 支持Memory和Disk图片缓存 默认Bitmap格式采用RGB_565内存使用至少减少一半
  • 生命周期集成 根据Activity/Fragment生命周期自动管理请求
  • 高效处理Bitmap 使用Bitmap Pool使Bitmap复用,主动调用recycle回收需要回收的Bitmap,减小系统回收压力

    Glide简单使用

    1. 添加引用 build.gradle 中添加配置 compile 'com.github.bumptech.glide:glide:3.7.0'
    2. 设置绑定生命周期
      Glide.with(Context context);// 绑定Context Glide.with(Activity activity);// 绑定Activity Glide.with(FragmentActivity activity);// 绑定FragmentActivity Glide.with(Fragment fragment);// 绑定Fragment
    3. 简单的加载图片实例 Glide.with(this).load(imageUrl).into(imageView);
    4. 设置下载优先级 Glide.with(this).load(imageUrl).priority(Priority.NORMAL).into(imageView);
    5. 设置缓存策略 Glide.with(this).load(imageUrl).diskCacheStrategy(DiskCacheStrategy.ALL).into(imageView); 策略解说:

    all:缓存源资源和转换后的资源

    none:不作任何磁盘缓存

    source:缓存源资源

    result:缓存转换后的资源 6. 设置加载动画 Glide.with(this).load(imageUrl).animate(R.anim.item_alpha_in).into(imageView); ## R.anim.item_alpha_in ## #
    7. 设置缩略图支持

这样会先加载缩略图 然后在加载全图 Glide.with(this).load(imageUrl).thumbnail(0.1f).into(imageView);

  1. 设置加载尺寸

Glide.with(this).load(imageUrl).override(800, 800).into(imageView);

  1. 设置动态转换(用的比较多)

    Glide.with(this).load(imageUrl).centerCrop().into(imageView);

api提供了比如:centerCrop()、fitCenter()等函数也可以通过自定义Transformation,举例说明:比如一个人圆角转化器 这里也有现成的开源库 https://github.com/wasabeef/glide-transformations

public class GlideRoundTransform extends BitmapTransformation {
    private float radius = 0f;
    public GlideRoundTransform(Context context) {
        this(context, 4);
    }

    public GlideRoundTransform(Context context, int dp) {
        super(context);
        this.radius = Resources.getSystem().getDisplayMetrics().density * dp;
    }

    @Override
    protected Bitmap transform(BitmapPool pool, Bitmap toTransform, int outWidth, int outHeight) {
        return roundCrop(pool, toTransform);
    }

    private Bitmap roundCrop(BitmapPool pool, Bitmap source) {
        if (source == null) return null;

        Bitmap result = pool.get(source.getWidth(), source.getHeight(), Bitmap.Config.ARGB_8888);
        if (result == null) {
            result = Bitmap.createBitmap(source.getWidth(), source.getHeight(), Bitmap.Config.ARGB_8888);
        }
        Canvas canvas = new Canvas(result);
        Paint paint = new Paint();
        paint.setShader(new BitmapShader(source, BitmapShader.TileMode.CLAMP, BitmapShader.TileMode.CLAMP));
        paint.setAntiAlias(true);
        RectF rectF = new RectF(0f, 0f, source.getWidth(), source.getHeight());
        canvas.drawRoundRect(rectF, radius, radius, paint);
        return result;
    }

    @Override
    public String getId() {
        return getClass().getName() + Math.round(radius);
    }
}

具体使用
Glide.with(this).load(imageUrl).transform(new GlideRoundTransform(this)).into(imageView); 10. 设置要加载的内容	

项目中有很多需要先下载图片然后再做一些合成的功能,比如项目中出现的图文混排,该如何实现目标下

 Glide.with(this).load(imageUrl).centerCrop().into(new SimpleTarget<GlideDrawable>() {
        @Override
        public void onResourceReady(GlideDrawable resource, GlideAnimation<? super GlideDrawable> glideAnimation) {
            imageView.setImageDrawable(resource);
        }
    }); 11. 设置监听请求接口
Glide.with(this).load(imageUrl).listener(new RequestListener<String, GlideDrawable>() {
        @Override
        public boolean onException(Exception e, String model, Target<GlideDrawable> target, boolean isFirstResource) {
            return false;
        }

        @Override
        public boolean onResourceReady(GlideDrawable resource, String model, Target<GlideDrawable> target, boolean isFromMemoryCache, boolean isFirstResource) {
            //imageView.setImageDrawable(resource);
            return false;
        }
    }).into(imageView);

12.设置动态GIF加载方式

	     Glide.with(this).load(imageUrl).asBitmap().into(imageView);//显示gif静态图片
		 Glide.with(this).load(imageUrl).asGif().into(imageView);//显示gif动态图片 13.缓存的动态清理

 Glide.get(this).clearDiskCache();//清理磁盘缓存 需要在子线程中执行
 Glide.get(this).clearMemory();//清理内存缓存  可以在UI主线程中进行

#GlideModule使用:

Glide是一个抽象类,全局改变Glide行为的一个方式,通过全局GlideModule 配置Glide,用GlideBuilder设置选项,用Glide注册ModelLoader等。

  1. 自定义一个GlideModule

     public class MyGlideModule implements GlideModule {
    
     @Override
      public void applyOptions(Context context, GlideBuilder builder) {
         // Apply options to the builder here.
     }
    
     @Override
      public void registerComponents(Context context, Glide glide) {
         // register ModelLoaders here.
     	}
     }
    
  2. AndroidManifest.xml注册

     <manifest ...>
     <!-- ... permissions -->
     <application ...>
         <meta-data
             android:name="com.mypackage.MyGlideModule"
             android:value="GlideModule" />
     	    <!-- ... activities and other components -->
     	</application>
     </manifest>
    
  3. 添加混淆处理

     -keepnames class com.mypackage.MyGlideModule
     # or more generally:
     #-keep public class * implements com.bumptech.glide.module.GlideModule
    
  4. 避免多个GlideModule冲突问题

     <meta-data android:name=”com.mypackage.MyGlideModule” tools:node=”remove” />
    
  5. 设置一个用来检索cache中没有的Resource的ExecutorService

    为了使缩略图请求正确工作,实现类必须把请求根据Priority优先级排好序。

     builder.setDiskCacheService(ExecutorService service);
     builder.setResizeService(ExecutorService service);
    
  6. CustomCachingGlideModule具体实现

     /**
      * 创建者     邓浩宸
      * 创建时间   2016/8/26 11:59
      * 描述	      ${自定义的Glide的缓存策略}
      * <p/>
      * 更新者     $Author$
      * 更新时间   $Date$
      * 更新描述   ${TODO}
      */
     public class CustomCachingGlideModule implements GlideModule {
    	
    	
         @Override
         public void applyOptions(Context context, GlideBuilder builder) {
    	
             //设置图片格式,默认是RGB565格式,不支持透明
             builder.setDecodeFormat(DecodeFormat.PREFER_ARGB_8888);
             //获取MemorySizeCalculator内存缓存计算器
             MemorySizeCalculator memorySizeCalculator=new MemorySizeCalculator(context);
             //获取内存缓存大小的默认值
            int defaultMemoryCacheSize= memorySizeCalculator.getMemoryCacheSize();
             //获取内存缓存池的数量
            int defaultBitmapPoolSize= memorySizeCalculator.getBitmapPoolSize();
             //重新计算缓存的大小
             int  customMemoryCacheSize=(int)(1.2 * defaultMemoryCacheSize);
             //重新计算缓存池的大小
             int customBitmapPoolSize = (int) (1.2 * defaultBitmapPoolSize);
             //重新设置
             builder.setMemoryCache(new LruResourceCache(customMemoryCacheSize));
             builder.setBitmapPool(new LruBitmapPool(customBitmapPoolSize));
         }
    	
         @Override
         public void registerComponents(Context context, Glide glide) {
    	
         }
     }
    

小结: 以上是Glide的常规用法,基本上满足开发需要了,然后再去学习一下其他相关知识。

#Glide升级版使用

#1. 图片请求的优先级

了解 Priority (优先级)枚举
  • Priority.LOW 低
  • Priority.NORMAL 默认
  • Priority.HIGH 高
  • Priority.IMMEDIATE 最大

    使用实例:英雄元素和子图像

应用场景:比如在一个用户需要你的 App 将会需要在同一时间内加载多个图像。让我们假设你正在构建一个信息屏幕,这里有一张很大的英雄图片在顶部,还有两个小的,在底部还有一些不那么重要的图片。对于最好的用户体验来说,应用图片元素是显示要被加载和显示的,然后才是底部不紧急的 ImageView

		private void loadImageWithHighPriority() {  
		    Glide
		        .with( context )
		        .load( UsageExampleListViewAdapter.eatFoodyImages[0] )
		        .priority( Priority.HIGH )
		        .into( imageViewHero );
		}
		
		private void loadImagesWithLowPriority() {  
		    Glide
		        .with( context )
		        .load( UsageExampleListViewAdapter.eatFoodyImages[1] )
		        .priority( Priority.LOW )
		        .into( imageViewLowPrioLeft );
		
		    Glide
		        .with( context )
		        .load( UsageExampleListViewAdapter.eatFoodyImages[2] )
		        .priority( Priority.LOW )
		        .into( imageViewLowPrioRight );
		} #2. 缩略图优势

  // setup Glide request without the into() method
    DrawableRequestBuilder<String> thumbnailRequest = Glide
        .with( context )
        .load( eatFoodyImages[2] );

    // pass the request as a a parameter to the thumbnail request
    Glide
        .with( context )
        .load( UsageExampleGifAndVideos.gifUrl )
        .thumbnail( thumbnailRequest )
        .into( imageView3 );