android学习之路(一)--Glide学习

一、Glide3.0新特性
1.动态的GIF图片加载：

Glide.with(context).load(...).asBitmap() //显示gif静态图片
Glide.with(context).load(...).asGif() //显示gif动态图片

2.本地视频快照：
   除了解码gif,Glide现在还可以从视频解码设备,就像gif,同样Glide.with(…).load(…)功能调用将为任何本地视频Android可以解码工作。
3.对缩略图的支持:

Glide.with(yourFragment).load(yourUrl).thumbnail(0.1f).into(yourView)
//加载yourView1/10尺寸的缩略图，然后加载全图

4.生命周期集成
      现在请求会在onStop的时候自动暂停，然后在onStart的时候重新启动,gif的动画也会在onStop的时候停止，以免在后台消耗电量， 此外，当设备的链接状态发生改变的时候，所有失败的请求会自动重启，保证数据的正确性。
5.转码
      除了解码资源以外，Glide的.toBytes()和.transcode()方法允许在后台获取、解码和转换一个图片，你可以将一张图片转换成更多有用的图片格式，比如，上传一张250*250的图片

Glide.with(context)
    .load(“/user/profile/photo/path”)
    .asBitmap()
    .toBytes()
    .centerCrop()
    .into(new SimpleTarget<byte[]>(250, 250) {
        @Override
        public void onResourceReady(byte[] data, GlideAnimation anim) {
            // Post your bytes to a background thread and upload them here.
        }
    });

5.动画：3.x加入了cross fades和View的属性动画的支持，比如

(.animate(ViewPropertyAnimation.Animator)),

6. 网络模块可以选择OkHttp或者Volley的支持: You can now choose to use either OkHttp, or Volley, or Glide’s HttpUrlConnection default as your network stack.
      Volley和OkHttp可以在gradle文件当中添加依赖，注册相应的ModelLoaderFactory
二、图片的缓存和缓存的时效机制
1.图片缓存的键值
      图片缓存的键值主要用于DiskCacheStrategy.RESULT，Glide当中的键值主要包含三个部分：
      1.1 通过DataFetcher.getId()方法返回的String数据作为键值。一般的DataFetchers会简单返回数据模型data model的toString()结果，如果是URL/File会返回相应的路径
      1.2 图片的尺寸，主要是通过override(width,height)或者通过Target’s getSize()方法确定的尺寸信息
      1.3 包含一个可选的签名所有的这些东西会通过一种散列算法生成一个独有、安全的文件名，通过此文件名将图片缓存在disk中

2.缓存失效
      因为Glide当中图片缓存key的生成是通过一个散列算法来实现的，所以很难手动去确定哪些文件可以从缓存当中进行删除，通常的做法就是当内容（url，file path）改变的时候，改变相应的标识符就可以了，通常标识符的改变可能很困难，Glide当中也提供了signature()方法，可以将一个附加的数据加入到缓存key当中，
—-多媒体存储数据，可以使用MediaStoreSignature类作为标识符，会将文件的修改时间、mimeType等信息作为cacheKey的一部分
—-文件，可以使用StringSignature
—-Urls ,可以使用StringSignature

Glide.with(yourFragment)
    .load(yourFileDataModel)
    .signature(new StringSignature(yourVersionMetadata))
.into(yourImageView);

Glide.with(fragment)
    .load(mediaStoreUri)
    .signature(new MediaStoreSignature(mimeType, dateModified, orientation))
    .into(view);

也可以自定义标识符来，

public class IntegerVersionSignature implements Key {
    private int currentVersion;
    public IntegerVersionSignature(int currentVersion) {
         this.currentVersion = currentVersion;
    }
    @Override
    public boolean equals(Object o) {
        if (o instanceof IntegerVersionSignature) {
            IntegerVersionSignature other = (IntegerVersionSignature) o;
            return currentVersion = other.currentVersion;
        }
        return false;
    }
    @Override
    public int hashCode() {
        return currentVersion;
    }
    @Override
    public void updateDiskCacheKey(MessageDigest md) {
        messageDigest.update(ByteBuffer.allocate(Integer.SIZE)
.putInt(signature).array());
    }
}

      不缓存可以通过diskCacheStrategy(DiskCacheStrategy.NONE.)实现
三、配置–GlideModules
      可以通过GlideModule接口懒配置Glide的配置文件，并且像ModelLoaders一样注册相关组件。
      1.包含一个GlideMode
第一步、To use and register a GlideModule, first implement the interface with your configuration and components:

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.
    }
}

第二步、然后将上面的实现了加入到proguard.cfg当中：

-keepnames class * com.mypackage.MyGlideModule

第三步、在AndroidManifest.xml文件中祖册，以便Glide能够找到你的Module

data
 android:name="com.bumptech.glide.samples.flickr.FlickrGlideModule"
    android:value="GlideModule" />

四、Library项目
      一个Library项目可能会定义一个或者多个GlideModules,如果一个Library项目添加一个Module到他的manifest当中，依赖于此Library的应用就会自动加载依赖库当中的Module。当然，如果manifest的合并不正确，那么Library里面Module就必须手动地在应用当中添加进去

五、GlideModules冲突
      虽然Glide允许一个应用当中存在多个GlideModules,Glide并不会按照一个特殊的顺序去调用已注册的GlideModules，如果一个应用的多个依赖工程当中有多个相同的Modules，就有可能会产生冲突。
      如果一个冲突是不可避免的，应用应该默认去定义一个自己的Module,用来手动地处理这个冲突，在进行Manifest合并的时候，可以用下面的标签排除冲突的module

<meta-data android:name=”com.mypackage.MyGlideModule” tools:node=”remove”/>

六、通过GlideBuilder配置全局配置文件
      Glide允许开发者配置一些不同的全局操作应用于所有的请求，这个部分可以通过GlideModule→applyOptions方法里面的GlideBuilder参数实现
1.DiskCache
      1.1开发者能够通过GlideBuilder的setDiskCache(DiskCache.Factory df)方法设置存储的位置和大小，也可以通过传入DiskCacheAdapter或者自定义一个DiskCache来完全禁用缓存，硬盘缓存是在一个后台鲜城当中，通过一个DiskCache.Factory接口进行缓存的。
      Glide默认是用InternalCacheDiskCacheFactory类来创建硬盘缓存的，这个类会在应用的内部缓存目录下面创建一个最大容量250MB的缓存文件夹，使用这个缓存目录而不用sd卡，意味着除了本应用之外，其他应用是不能访问缓存的图片文件的。

1.2.设置disk缓存的大小 : InternalCacheDiskCacheFactory

new GlideBuilder(context)
    .setDiskCache(new InternalCacheDiskCacheFactory(context, yourSizeInBytes));

1.3.设置缓存的路径
      可以通过实现DiskCache.Factory，然后使用DiskLruCacheWrapper创建一个新的缓存目录，比如，可以通过如下方式在外存当中创建缓存目录：

new GlideBuilder(context)
    .setDiskCache(new DiskCache.Factory() {
        @Override
        public DiskCache build() { 
            // Careful: the external cache directory doesn't enforce permissions
            File cacheLocation = new File(context.getExternalCacheDir(), "cache_dir_name");
            cacheLocation.mkdirs();
            return DiskLruCacheWrapper.get(cacheLocation, yourSizeInBytes);
        }
    });
);

2.内存当中的缓存和POOLS
      GlideBuilder当中，允许开发者去设置内存当中图片缓存区的大小，主要涉及到的类包括MemoryCache和BitmapPool
2.1 大小的设置
      默认内存缓存的大小是用过MemorySizeCalculator来实现的，这个类会根据设备屏幕的大小，计算出一个合适的size，开发者可以获取到相关的默认设置信息：

MemorySizeCalculator calculator = new MemorySizeCalculator(context);
int defaultMemoryCacheSize = calculator.getMemoryCacheSize();
int defaultBitmapPoolSize = calculator.getBitmapPoolSize();

如果在应用当中想要调整内存缓存的大小，开发者可以通过如下方式：
Glide.get(context).setMemoryCategory(MemoryCategory.HIGH);

2.2 Memory Cache
      Glide内存缓存的目的是减少I/O，提高效率
      可以通过GlideBuidler的setMemoryCache(MemoryCache memoryCache)去设置缓存的大小，开发者可以通过LruResourceCache去设置缓存区的大小

new GlideBuilder(context)
   .setMemoryCache(new LruResourceCache(yourSizeInBytes));

2.3 Bitmap Pool
      可以通过GlideBuilder的setBitmapPool()方法设置池子的大小，LruBitmapPool是Glide的默认实现，使用如下:

new GlideBuilder(context)
    .setBitmapPool(new LruBitmapPool(sizeInBytes));

3.图片格式
      GlideBuilder允许开发者设置一个全局的默认图片格式，
在默认情况下，Glide使用RGB_565格式加载图片，如果想要使用高质量的图片，可以通过如下方式设置系统的图片格式：

new GlideBuilder(context)
    .setDecodeFormat(DecodeFormat.ALWAYS_ARGB_8888);

七、自定义显示控件
      除了可以将图片、视频快照和GIFS显示在View上面之外，开发者也可以在自定义的Target上面显示这些媒体文件
1.SimpleTarget
重点内容如果你想简单地加载一个Bitmap,你可以通过以下简单的方式而不是直接地显示给用户，可能是显示一个notification,或者上传一个头像，Glide都能很好地实现
**重点内容**SimpleTarget提供了对Target的简单实现，并且让你专注于对加载结果的处理
重点内容为了使用SimpleTarget,开发者需要提供一个宽和高的像素值，用来加载你的资源文件，并且你需要去实现

onResourceReady(R resource,GlideAnimationsuper R> glideAnimation)
int myWidth = 512;
int myHeight = 384;

Glide.with(yourApplicationContext))
    .load(youUrl)
    .asBitmap()
    .into(new SimpleTarget(myWidth, myHeight) {
        @Override
        public void onResourceReady(Bitmap bitmap, GlideAnimation anim) {
            // Do something with bitmap here.
        }
    };

      说明：通常你去加载资源的时候，是将他们加载到一个view当中，当fragment或者activity失去焦点或者distroyed的时候，Glide会自动停止加载相关资源，确保资源不会被浪费
      在大多数SimpleTarget的实现当中，如果需要资源的加载不受组件生命周期的影响，Glide.width(context)当中的context是application context而不是fragment或者activity
      另外，由于一些long running operations可能会导致内存泄露，如果你打算使用一个这样的操作，可以考虑使用一个静态的内部类而不是一个动态的内部类。

2.ViewTarget
      如果你想加载一张图片到一个view当中，但是又想改变或者监听Glide默认的部分设置，就可以通过重写ViewTarget或者他的子类来实现
      如果你想Gidle加载图片的时候可以自定义图片的大小，或者想要设置一个自定义的显示动画，就可以通过ViewTarget来实现，可以通过一个静态的ViewTarget或者动态的内部类来实现相关的功能

Glide.with(yourFragment)
    .load(yourUrl)
    .into(new ViewTarget(yourViewObject) {
        @Override
        public void onResourceReady(GlideDrawable resource, GlideAnimation anim) {
            YourViewClass myView = this.view;
            // Set your resource on myView and/or start your animation here.
        }
    });

说明：如果想要加载一张静态的图片或者一张GIF动态图，可以在load后面加上asBitmap()/asGif(),
.Load(url)会通过asXXX()替换ViewTarget当中的GlideDrawable,也可以通过实现LifecycleLisener，给target设置一个回调。

3.覆盖默认的相关设置
      如果只是想使用Glide的默认配置，可以使用Glide当中ImageViewTargets的两个默认API：
      GlideDrawableImageViewTarget 默认的实现，可以通过asGif()加载动态图片
      BitmapImageViewTarget 可以通过asBitmap()加载静态图片
      如果想要使用Glide默认实现，可以在他们的子类方法当中使用super.xx()即可,例如:

Glide.with(yourFragment)
    .load(yourUrl)
    .asBitmap()
    .into(new BitmapImageViewTarget(yourImageView)) {
        @Override
        public void onResourceReady(Bitmap bitmap, GlideAnimation anim) {
            super.onResourceReady(bitmap, anim);
            Palette.generateAsync(bitmap, new Palette.PaletteAsyncListener() {  
                @Override
                public void onGenerated(Palette palette) {
                    // Here's your generated palette
                }
            });
        }
    });

八、使用Glide下载自定义尺寸的图片
      Glide的ModelLoader接口为开发者提供了装在图片的view的尺寸，并且允许开发者使用这些尺寸信息去选择合适的URL去下载图片。选用适当的尺寸可以节省宽带和设备的空间开销，提高app的性能
      2014年googleI/o大会发表了一篇文章，阐述了他们如何使用ModelLoader接口去适配图片的尺寸，见下面的连接：https://github.com/google/iosched/blob/master/doc/IMAGES.md
      通过http/https下载图片，可以通过继承BaseGlideUtlLoader来实现：

public interface MyDataModel {
    public String buildUrl(int width, int height);
} 
public class MyUrlLoader extends BaseGlideUrlLoader<MyDataModel> {
    @Override
    protected String getUrl(MyDataModel model, int width, int height) {
        // Construct the url for the correct size here.
        return model.buildUrl(width, height);
    }
}

      接下来你就可以使用你自定义的ModelLoader去加载图片了，

Glide.with(yourFragment)
    .using(new MyUrlLoader())
    .load(yourModel)
    .into(yourView);

      如果你想避免每次加载图片都要使用.using(new MyUrlLoader()) ，可以实现是一个
ModelLoaderFactory然后使用Glide将它注册到GlideModule当中

public class MyGlideModule implements GlideModule {
    ...
    @Override
    public void registerComponents(Context context, Glide glide) {
        glide.register(MyDataModel.class, InputStream.class, 
            new MyUrlLoader.Factory());
    }
}

这样你就可以跳过.using()了

Glide.with(yourFragment)
    .load(yourModel)
    .into(yourView);

九、集成库
1.什么是集成库
      Glide包含一些小的、可选的集成库，目前Glide集成库当中包含了访问网络操作的Volley和OkHttp
2.为什么要包含集成库
      这些集成库，和Glide的ModelLoader系统允许开发者使用一致地框架去进行网络相关的操作
3.如何将一个库集成到Glide当中，
      将一个库集成到Glide当中需要两步操作，第一、需要包含正确的dependency,第二 确保包含了该集成库的GlideModule,比如，将Volley集成到Glide当中，
第一步、添加依赖

dependencies {
    compile 'com.github.bumptech.glide:volley-integration:1.2.2'
    compile 'com.mcxiaoke.volley:library:1.0.5'
}

第二步、创建Volley集成库的GlideModule

data
 android:name="com.bumptech.glide.integration.volley.VolleyGlideModule"
    android:value="GlideModule" />

然后改变混淆文件：

-keep class com.bumptech.glide.integration.volley.VolleyGlideModule
#or
-keep public class * implements com.bumptech.glide.module.GlideModule

将OkHttp集成到Glide当中
第一步、添加依赖

dependencies {
    compile 'com.github.bumptech.glide:okhttp-integration:1.2.2'
    compile 'com.squareup.okhttp:okhttp:2.0.0'
}

第二步、

"com.bumptech.glide.integration.okhttp.OkHttpGlideModule"
android:value="GlideModule" />

-keep class com.bumptech.glide.integration.okhttp.OkHttpGlideModule
#or
-keep public class * implements com.bumptech.glide.module.GlideModule

十、在后台线程当中进行加载和缓存
      为了保证Glide在后台线程当中加载资源文件更加容易，Glide除了Glide.with(fragment).load(url).into(view)之外还提供了

downloadOnly(int width, int height)
downloadOnly(Y target)// Y extends Target<File>
into(int width, int height)

1.downloadOnly
       Glide的downloadOnly()允许开发者将Image的二进制文件下载到硬盘缓存当中，以便在后续使用，可以在UI线程当中异步下载，也可以在异步线程当中同步调用下载，值得注意的是，如果在同步线程当中，
downloadOnly使用一个target作为参数，而在异步线程当中则是使用width和height
      在后台线程当中下载图片，可以通过如下的方式：

FutureTarget future = Glide.with(applicationContext)
    .load(yourUrl)
    .downloadOnly(500, 500);
File cacheFile = future.get();

      当future返回的时候，image的二进制文件信息就存入了disk缓存了，值得注意的是downloadOnly API只是保证图片个bytes数据在disk当中是有效的。
      下载完毕之后如果想要进行显示，可以通过如下方式进行调用：

Glide.with(yourFragment)
    .load(yourUrl)
    .diskCacheStrategy(DiskCacheStrategy.ALL)
    .into(yourView);

      通过DiskCacheStrategy.ALL或者DiskCacheStrategy.SOURCE,可以保证程序会去读取缓存文件
2. 如果想要在后台线程当中获取某个URL对应的Bitmap，而不通过downloadOnly，可以使用into(),会返回一个FutureTarget对象，比如，想要得到一个URL对应的500*500的centerCrop裁剪图片，可以通过如下方式实现：

Bitmap myBitmap = Glide.with(applicationContext)
    .load(yourUrl)
    .asBitmap()
    .centerCrop()
    .into(500, 500)
    .get()

//值得注意的是：上面的调用只能在异步线程当中，如果在main Thread当中调用.get(),会阻塞主线

十一、转换器
1.默认的转换器
      Glide两个默认的转换器，fitCenter和CenterCrop,其他的转换器详见https://github.com/wasabeef/glide-transformations,可以将图片转为各种形状，例如圆形，圆角型等等
用法：

Glide.with(yourFragment)
    .load(yourUrl)
    .fitCenter()
    .into(yourView);

Glide.with(yourFragment)
    .load(yourUrl)
    .centerCrop()
    .into(yourView);

或者是：

// For Bitmaps:
Glide.with(yourFragment)
    .load(yourUrl)
    .asBitmap()
    .centerCrop()
    .into(yourView);
// For gifs:
Glide.with(yourFragment)
    .load(yourUrl)
    .asGif()
    .fitCenter()
    .into(yourView);

      甚至可以在两幅图片进行类型转换的时候进行transformed

Glide.with(yourFragment)
    .load(yourUrl)
    .asBitmap()
    .toBytes()
    .centerCrop()
    .into(new SimpleTarget(...) { ... });

2.自定义转换器
方法：
第一步、编写转换器类
继承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 = ... // apply some transformation here.
       return myTransformedBitmap;
    }
    @Override
    public String getId() {
        // Return some id that uniquely identifies your transformation.
        return "com.example.myapp.MyTransformation";
    }
}

第二步、在Glide方法链当中用.transform(…)替换fitCenter()/centerCrop()

Glide.with(yourFragment)
    .load(yourUrl)
    .transform(new MyTransformation(context))
    .into(yourView);
// For Bitmaps:
Glide.with(yourFragment)
    .load(yourUrl)
    .asBitmap()
    .transform(new MyTransformation(context))
    .into(yourView);
// For Gifs:
Glide.with(yourFragment)
    .load(yourUrl)
    .asGif()
    .transform(new MyTransformation(context))
    .into(yourView);

3.自定义转换器的尺寸
      在上面使用过程当中没有设置尺寸值，那么转换器转换的图片尺寸怎么确定呢，Glide实际上已经足够智能根据view的尺寸来确定转换图片的尺寸了，如果需要自定义尺寸，而不是用view和target当中的尺寸，那么可以使用override(int,int)设置相关的宽和高
4. Bitmap 再利用
      为了减少垃圾收集，可以通过BitmapPool接口去释放不需要的Bitmaps,当然也可以对里面的bitmap进行再利用，典型地，在一次转换中，可以从pool当中得到一个bitmap，将Bitmap回设给Canvas
然后使用Matrix、Paint在Canvas上面绘制原始的Bitmap,或者通过一个Shader来转换一个image
4.1 不要手动地去释放一个转换的bitmap资源，也不要将transform()之后的Bitmap重新放置到BitmapPool当中去

protected Bitmap transform(BitmapPool bitmapPool, Bitmap original, int width, int height) {
    Bitmap result = bitmapPool.get(width, height, Bitmap.Config.ARGB_8888);
    // If no matching Bitmap is in the pool, get will return null, so we should //allocate.
    if (result == null) {
        // Use ARGB_8888 since we're going to add alpha to the image.
        result = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
    }
    // Create a Canvas backed by the result Bitmap.
    Canvas canvas = new Canvas(result);
    Paint paint = new Paint();
    paint.setAlpha(128);
    // Draw the original Bitmap onto the result Bitmap with a transformation.
    canvas.drawBitmap(original, 0, 0, paint);
    // Since we've replaced our original Bitmap, we return our new Bitmap here. Glide will
    // will take care of returning our original Bitmap to the BitmapPool for us. 
    return result;
}