【Android】glide：3.7.0->4.8.0 升級導入——踩坑

You can change or stay the same.There are no rules to this thing.          ——本傑明.巴頓

---

正文 

官方文檔 https://muyangmin.github.io/glide-docs-cn/doc/download-setup.html

準備工作

gradle添加依賴：

dependencies {
  implementation ("com.github.bumptech.glide:glide:4.8.0") {
    exclude group: "com.android.support"
  }
  implementation "com.android.support:support-fragment:26.1.0"
  //注意java和kotlin的依賴compiler的不同
  //java
  annotationProcessor 'com.github.bumptech.glide:compiler:4.8.0'
  //kotlin
  //kapt 'com.github.bumptech.glide:compiler:4.8.0'
}

環境：

Min Sdk Version - 使用 Glide 需要 min SDK 版本 API 14 (Ice Cream Sandwich) 或更高。

Compile Sdk Version - Glide 必須使用 API 27 (Oreo MR1) 或更高版本的 SDK 來編譯。

Support Library Version - Glide 使用的支持庫版本爲 27。

可以使用不同支持庫版本，但根據官方文檔，不建議

官方聲明

如果你需要使用不同的支持庫版本，你需要在你的 build.gradle 文件裏去從 Glide 的依賴中去除 "com.android.support"。例如，假如你想使用 v26 的支持庫：

dependencies {
  implementation ("com.github.bumptech.glide:glide:4.8.0") {
    exclude group: "com.android.support"
  }
  implementation "com.android.support:support-fragment:26.1.0"
}

使用與 Glide 依賴的支持庫不同的版本可能會導致一些運行時異常 ，例如：

java.lang.NoSuchMethodError: No static method getFont(Landroid/content/Context;ILandroid/util/TypedValue;ILandroid/widget/TextView;)Landroid/graphics/Typeface; in class Landroid/support/v4/content/res/ResourcesCompat; or its super classes (declaration of 'android.support.v4.content.res.ResourcesCompat' 
at android.support.v7.widget.TintTypedArray.getFont(TintTypedArray.java:119)

也可能造成 Glide 的 API 生成器失敗，從而不能正確地生成 GlideApp 類.

生成GlideApp

Glide 4.0之上多數使用GlideApp進行Api操作。

@GlideModule
public final class MyAppGlideModule extends AppGlideModule {}

簡略步驟：

1.創建某個繼承於 AppGlideMoudle 的類

2.使用 @GlideModule 註解 （原理就是使用了annotationProcessor生成，也就是依賴com.github.bumptech.glide:compiler:4.8.0的作用）

3.Make Module app，或者暴力Rebuild，生成GlideApp

踩坑：

• compileSdkVersion： 本來使用26，報錯，後改成27
• com.android.support:design：本來使用27.0.0，報錯，後改爲:27.1.0
• Make Module app：報紅出錯時，彆着急。先Make Module或者Rebuild下。先使項目成功編譯通過，才能產生GlideApp，因爲Glide新版採用的是編譯生成代碼的方式，否則無法找到引用類。

新老版本用法差異()：官方文檔 從v3遷移到v4

	舊	新
淡入淡出	.crossFade	.transition(DrawableTransitionOptions.withCrossFade())
圖片加載監聽	如下方代碼
圖片轉換成bitmap,gif	asBitmap放在load之後	asBitmap放在with之後
緩存	.diskCacheStrategy(DiskCacheStrategy.SOURCE)	.diskCacheStrategy(DiskCacheStrategy. AUTOMATIC)//默認策略
高斯模糊	// 設置模糊度(在0.0到25.0之間)，默認”25";   圖片縮放比例,默認“1”。 .bitmapTransform(new BlurTransformation(context, 5, 1))	如下方代碼創建BlurTransformation類

緩存策略：

• DiskCacheStrategy.NONE： 表示不緩存任何內容
• DiskCacheStrategy.DATA： 表示只緩存原始圖片
• DiskCacheStrategy.RESOURCE： 表示只緩存轉換過後的圖片
• DiskCacheStrategy.ALL ： 表示既緩存原始圖片，也緩存轉換過後的圖片
• DiskCacheStrategy.AUTOMATIC： 表示讓Glide根據圖片資源智能地選擇使用哪一種緩存策略（默認選項）一般採用此選項即可

實例對比：

舊：

Glide.with(context)
            .load(resouce)
            .diskCacheStrategy(DiskCacheStrategy.SOURCE)//緩存
            // 設置模糊度(在0.0到25.0之間)，默認”25";   圖片縮放比例,默認“1”。
            .bitmapTransform(new BlurTransformation(context, 5, 1))
            .crossFade()//淡入淡出
            .listener(new LoadListen())
            .into(imageView);


//圖片加載監聽器
static class LoadListen implements RequestListener<Object, GlideDrawable> {

        @Override
        public boolean onException(Exception e, Object model, Target<GlideDrawable> target, boolean isFirstResource) {
            return false;
        }

        @Override
        public boolean onResourceReady(GlideDrawable resource, Object model, Target<GlideDrawable> target, boolean isFromMemoryCache, boolean isFirstResource) {
            return false;
        }
    }
}

新： 

GlideApp.with(context)
    .load(resouce)
    .diskCacheStrategy(DiskCacheStrategy.RESOURCE)//緩存
    .apply(RequestOptions.bitmapTransform(new BlurTransformation(5, 1)))
    .transition(DrawableTransitionOptions.withCrossFade())//淡入淡出
    .listener(new LoadListen())
    .into(imageView);


//圖片加載監聽器
 static class LoadListen implements RequestListener<Drawable> {

        @Override
        public boolean onLoadFailed(@Nullable GlideException e, Object model, Target target, boolean isFirstResource) {
            return false;
        }

        @Override
        public boolean onResourceReady(Drawable resource, Object model, Target<Drawable> target, DataSource dataSource, boolean isFirstResource) {
            return false;
        }
    }
  /**
     * 高斯模糊類，在glide升級到4.7後如果沒將glide-transformations升級就自己寫一個
     */
    public static class BlurTransformation extends BitmapTransformation {

        private static final int VERSION = 1;
        private static final String ID = "BlurTransformation." + VERSION;

        private static int MAX_RADIUS = 25;
        private static int DEFAULT_DOWN_SAMPLING = 1;

        private int radius;
        private int sampling;

        public BlurTransformation() {
            this(MAX_RADIUS, DEFAULT_DOWN_SAMPLING);
        }

        public BlurTransformation(int radius) {
            this(radius, DEFAULT_DOWN_SAMPLING);
        }

        public BlurTransformation(int radius, int sampling) {
            this.radius = radius;
            this.sampling = sampling;
        }

        @Override
        protected Bitmap transform(@NonNull BitmapPool pool, @NonNull Bitmap toTransform, int outWidth, int outHeight) {
            int width = toTransform.getWidth();
            int height = toTransform.getHeight();
            int scaledWidth = width / sampling;
            int scaledHeight = height / sampling;

            Bitmap bitmap = pool.get(scaledWidth, scaledHeight, Bitmap.Config.ARGB_8888);

            Canvas canvas = new Canvas(bitmap);
            canvas.scale(1 / (float) sampling, 1 / (float) sampling);
            Paint paint = new Paint();
            paint.setFlags(Paint.FILTER_BITMAP_FLAG);
            canvas.drawBitmap(toTransform, 0, 0, paint);
            bitmap = FastBlur.blur(bitmap, radius, true);

            return bitmap;
        }

        @Override
        public String toString() {
            return "BlurTransformation(radius=" + radius + ", sampling=" + sampling + ")";
        }

        @Override
        public boolean equals(Object o) {
            return o instanceof BlurTransformation &&
                ((BlurTransformation) o).radius == radius &&
                ((BlurTransformation) o).sampling == sampling;
        }

        @Override
        public int hashCode() {
            return ID.hashCode() + radius * 1000 + sampling * 10;
        }

        @Override
        public void updateDiskCacheKey(@NonNull MessageDigest messageDigest) {
            try {
                messageDigest.update((ID + radius + sampling).getBytes("utf-8"));
            } catch (UnsupportedEncodingException e) {
                e.printStackTrace();
            }
        }
    }

 

ps：報紅不可怕，可以直接運行起來(猜測先執行@註解生成java代碼(APT)，後再編譯)

擴展

忘了配套的第三方庫glide-transformations

例如：將 glide-transformations從2.0.2升級至jp.wasabeef:glide-transformations:4.0.1，就可使用高斯模糊

.apply(RequestOptions.bitmapTransform(new BlurTransformation(5,1)))高斯模糊