android图片加载库Glide4使用教程(项目中如何快速将Glide3替换成Glide4)

我想大多数人在自己的项目中还是使用Glide3.7.1这个版本吧!不过Glide版本现在已经到4.4.0了!

当我们把Glide3更换成Glide4,会发现大部分地方都报错了,那么该怎样快速替换Glide3为Glide4呢?

下面我们一起来看看怎样实现Glide3到Glide4的快速替换。

Glide4的基本用法:

  • 引入Glide
  implementation 'com.github.bumptech.glide:glide:4.4.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.4.0'

compiler:包含各种注解的使用,Glide3快速替换成Glide4时要用到。

  • 添加网络权限
<uses-permission android:name="android.permission.INTERNET" />

在这个地方可能你的项目会报个错:java.lang.NoSuchMethodError

这是因为Glide4中已经引入了appcompat-v7包,版本不一致引起。

解决方法:

Glide4.4.0引入的是27.0.2版本,所以把你项目中的appcompat-v7更换为:

 implementation 'com.android.support:appcompat-v7:27.0.2'

详细请看:Glide4.4.0报java.lang.NoSuchMethodError


  • 普通加载图片
 Glide.with(this.getApplicationContext())
                        .load(url)
                        .into(mImage);
  • 占位图和错误时显示图片
 RequestOptions options = new RequestOptions();
                options.placeholder(R.drawable.ic_launcher_background);
                options.error(R.mipmap.load_error);
                //禁用掉Glide的缓存功能
                options.diskCacheStrategy(DiskCacheStrategy.NONE);
                Glide.with(this.getApplicationContext())
                        .load(url)
                        .apply(options)
                        .into(mImage);

这里就是Glide4和Glide3的最大不同,他将部分API功能封装在RequestOptions 中,在通过apply方法,传递给Glide使用,这样我们就可以很方便的在需要的地方可以进行不同的配置了,不用像Glide3一样传递很多参数!

  • 指定图片大小
RequestOptions options1 = new RequestOptions();
                //指定大小为200*100
                //options1.override(200, 100);
                //加载一张图片的原始尺寸的图片
                options1.override(Target.SIZE_ORIGINAL);
                Glide.with(this.getApplicationContext())
                        .load(url)
                        //请求给定系数的缩略图。如果缩略图比全尺寸图先加载完,
                        // 就显示缩略图,否则就不显示。
                        // 系数sizeMultiplier必须在(0,1)之间,
                        // 可以递归调用该方法。
                        .thumbnail(0.1f)
                        .apply(options1)
                        .into(mImage);
  • 禁用内存缓存&硬盘缓存功能

 // DiskCacheStrategy.NONE: 表示不缓存任何内容。
                // DiskCacheStrategy.DATA: 表示只缓存原始图片。
                // DiskCacheStrategy.RESOURCE: 表示只缓存转换过后的图片。
                // DiskCacheStrategy.ALL : 表示既缓存原始图片,也缓存转换过后的图片。
                // DiskCacheStrategy.AUTOMATIC: 表示让Glide根据图片资源智能地选择使用哪一种缓存策略(默认选项)。
                RequestOptions options2 = new RequestOptions()
                        //禁用内存缓存
                        .skipMemoryCache(true)
                        //硬盘缓存功能
                        .diskCacheStrategy(DiskCacheStrategy.NONE);
                Glide.with(this.getApplicationContext())
                        .load(url)
                        .apply(options2)
                        .into(mImage);
  • 指定加载格式GIF
  Glide.with(this.getApplicationContext())
                        .load("file:///android_asset/jdfw.gif")
                        .into(mImage);
  • 获取gif第一帧
 /**
                 * 注意:在Glide 3中的语法是先load()再asBitmap()的,
                 *
                 * 而在Glide 4中是先asBitmap()再load()的
                 *
                 * 如果写错了顺序就肯定会报错了
                 */
                Glide.with(this.getApplicationContext())
                        //.asBitmap()//强制指定加载静态图片
                        //.asGif()//强制指定加载动态图片
                        //.asFile()//强制指定文件格式的加载
                        .asDrawable()//强制指定Drawable格式的加载
                        .load("file:///android_asset/jdfw.gif")
                        .into(mImage);
  • 回调与监听
 /**
     * 回调与监听
     */
    SimpleTarget simpleTarget = new SimpleTarget() {
        @Override
        public void onResourceReady(Drawable resource, Transitionsuper Drawable> transition) {
            mImage.setImageDrawable(resource);
        }
    };
 Glide.with(this.getApplicationContext())
                        .load(url)
                        .into(simpleTarget);
  • 预加载后显示
预加载

   Glide.with(this)
                        .load("https://unsplash.it/200/200?random&22")
                        .preload();

预加载后显示

 Glide.with(this.getApplicationContext())
                        .load("https://unsplash.it/200/200?random&22")
                        .into(mImage);
  • submit()方法:类似Glide3中的downloadOnly
 new Thread(new Runnable() {
                    @Override
                    public void run() {
                        try {
                            final Context context = getApplicationContext();
                            FutureTarget target = Glide.with(context)
                                    //.asDrawable()
                                    .asFile()
                                    .load(url)
                                    .submit();
                            //final Drawable drawable = target.get();
                            final File imageFile = target.get();
                            runOnUiThread(new Runnable() {
                                @Override
                                public void run() {
                                    mTextview.setText(imageFile.getPath());
                                }
                            });
                        } catch (Exception e) {
                            e.printStackTrace();
                        }
                    }
                }).start();
  • listener()方法
  Glide.with(this.getApplicationContext())
                        .load(url)
                        .listener(new RequestListener() {
                            @Override
                            public boolean onLoadFailed(@Nullable GlideException e, Object model, Target target, boolean isFirstResource) {
                                mTextview.setText("加载失败");
                                return false;
                            }

                            @Override
                            public boolean onResourceReady(Drawable resource, Object model, Target target, DataSource dataSource, boolean isFirstResource) {
                                mTextview.setText("加载成功");
                                return false;
                            }
                        })
                        .into(mImage);
  • 图片变换(圆角等)
  RequestOptions options3 = new RequestOptions();
                //options3.centerCrop();
                // options3.fitCenter();
                options3.circleCrop();
                Glide.with(this.getApplicationContext())
                        .load("https://unsplash.it/200/200?random&55")
                        .apply(options3)
                        .into(mImage);

自定义模块

在Glide3中定义了自定义模块之后,还必须在AndroidManifest.xml文件中去注册它才能生效,而在Glide 4中是不需要的,因为@GlideModule这个注解已经能够让Glide识别到这个自定义模块了(记得Build -> Rebuild Project)!

package tsou.com.simple.glide4test.glidemodule;

import android.content.Context;

import com.bumptech.glide.Glide;
import com.bumptech.glide.GlideBuilder;
import com.bumptech.glide.Registry;
import com.bumptech.glide.annotation.GlideModule;
import com.bumptech.glide.load.DecodeFormat;
import com.bumptech.glide.load.engine.cache.ExternalPreferredCacheDiskCacheFactory;
import com.bumptech.glide.module.AppGlideModule;

/**
 * Created by Administrator on 2017/12/22 0022.
 * 在Glide3中需要在AndroidManifest.xml中配置
 * 

* Glide4,只要有@GlideModule注解就好 */ @GlideModule public class MyAppGlideModule extends AppGlideModule { public static final int DISK_CACHE_SIZE = 500 * 1024 * 1024; public static final String DISK_CACHE_NAME = "huangxiaoguo"; @Override public void applyOptions(Context context, GlideBuilder builder) { super.applyOptions(context, builder); /** 将所有Glide加载的图片缓存到SD卡上, 默认硬盘缓存大小都是250M,这里改为500 * */ //builder.setDiskCache(new ExternalCacheDiskCacheFactory(context)); /** ExternalCacheDiskCacheFactory的默认缓存路径 是在sdcard/Android/data/包名/cache/image_manager_disk_cache目录当中 */ //builder.setDiskCache(new ExternalCacheDiskCacheFactory(context, DISK_CACHE_SIZE)); /** * 更改缓存最总文件夹名称 * * 是在sdcard/Android/data/包名/cache/DISK_CACHE_NAME目录当中 */ //此方法在Glide4已过时 // builder.setDiskCache(new ExternalCacheDiskCacheFactory(context, DISK_CACHE_NAME, DISK_CACHE_SIZE)); builder.setDiskCache(new ExternalPreferredCacheDiskCacheFactory(context, DISK_CACHE_NAME, DISK_CACHE_SIZE)); /** * Glide也能使用ARGB_8888的图片格式 * 虽然图片质量变好了,但同时内存开销也会明显增大 */ builder.setDecodeFormat(DecodeFormat.PREFER_ARGB_8888); } @Override public void registerComponents(Context context, Glide glide, Registry registry) { super.registerComponents(context, glide, registry); } }

  • 默认缓存路径

android图片加载库Glide4使用教程(项目中如何快速将Glide3替换成Glide4)_第1张图片

  • 设置缓存路径为SD卡

android图片加载库Glide4使用教程(项目中如何快速将Glide3替换成Glide4)_第2张图片

Glide3替换成Glide4(Generated API)

在自定义模块完成以后,就可以使用Glide的模式啦!请看:

//使用Generated API(类似Glide3用法)
                //使用GlideApp,首先确保你的代码中有一个自定义的模块,
                // 并且给它加上了@GlideModule注解,也就是自定义模块
                GlideApp.with(this.getApplicationContext())
                        .load(url)
                        .placeholder(R.drawable.ic_launcher_background)
                        .error(R.mipmap.load_error)
                        .skipMemoryCache(true)//清除缓存
                        .diskCacheStrategy(DiskCacheStrategy.NONE)//表示既缓存原始图片,也缓存转换过后的图片
                        .override(Target.SIZE_ORIGINAL)
                        .circleCrop()//切圆
                        .into(mImage);

把之前Glide替换成GlideApp,就可以使用Glide3的方式进行使用了!是不是很方便!

定制自己的API

定制自己的API需要借助@GlideExtension和@GlideOption这两个注解。创建一个我们自定义的扩展类

package tsou.com.simple.glide4test.glidemodule;

import com.bumptech.glide.annotation.GlideExtension;
import com.bumptech.glide.annotation.GlideOption;
import com.bumptech.glide.load.engine.DiskCacheStrategy;
import com.bumptech.glide.request.RequestOptions;

import tsou.com.simple.glide4test.R;

/**
 * Created by Administrator on 2017/12/25 0025.
 */
@GlideExtension
public class MyGlideExtension {
    /**
     * 将这个类的构造函数声明成private,这是必须要求的写法
     */
    private MyGlideExtension() {
    }

    @GlideOption
    public static void myGlideConfiguration(RequestOptions options) {
        //占位图
        options.placeholder(R.drawable.ic_launcher_background);
        //错误图片
        options.error(R.mipmap.load_error);
        //表示只缓存原始图片
        options.diskCacheStrategy(DiskCacheStrategy.DATA);
        //切圆
        options.circleCrop();
        //...等等所有的属性
    }
}

使用自定义API方式

 GlideApp.with(this.getApplicationContext())
                        .load(url)
                        .myGlideConfiguration()//自定义API
                        .into(mImage);

这样,我们就可以直接使用自己的API了,同时所有的Glide配置都在MyGlideExtension 进行配置,方便项目中的同意修改!

到此Glide4的基本使用到此结束,希望对你有所帮助!
同时欢迎大家的指教,谢谢!

Demo地址:http://download.csdn.net/download/huangxiaoguo1/10172358

Glide4的使用方式虽然和Glide3不同,但是主要的功能却和Glide3一样,其他关于Glide4的功能在这里没有详细给出,需要了解,请看:

整理Glide方法使用含义(毛玻璃效果,实现圆角等)

Glide使用高级技巧(解决Glide生成缓存Key问题)

Android图片加载框架:玩转Glide的回调与监听

android自定义Glide图片加载(以更改Glide缓存路径和使用ARGB_8888的图片格式为例)

android替换Glide通讯组件为Okhttp并监控加载进度

你可能感兴趣的:(Android图片加载)