android鲁班压缩

如何使用Luban压缩图片

1.在项目中的build.gradle添加依赖(需要用到RxJava1.0) 

2.在代码中使用Luban压缩方法

1）Listerner方式。传入图片File，调用设置压缩监听setCompressListerner方法，处理压缩结果。 

2）Rxjava方式，传入图片File，调用asObservable方法返回一个Observable观察者对象，使用RxJava方式来处理压缩结果。 

项目地址

3.Luban源码分析

源码中最主要的方法就是thirdCompress(File file)，即如何计算得出理想的压缩后宽高，以及图片大小。

Luban压缩算法思路

1. 判断图片比例值，是否处于以下区间内； 
   • [1, 0.5625) 即图片处于 [1:1 ~ 9:16) 比例范围内
   • [0.5625, 0.5) 即图片处于 [9:16 ~ 1:2) 比例范围内
   • [0.5, 0) 即图片处于 [1:2 ~ 1:∞) 比例范围内
2. 判断图片最长边是否过边界值； 
   • [1, 0.5625) 边界值为：1664 * n（n=1）, 4990 * n（n=2）, 1280 * pow(2, n-1)（n≥3）
   • [0.5625, 0.5) 边界值为：1280 * pow(2, n-1)（n≥1）
   • [0.5, 0) 边界值为：1280 * pow(2, n-1)（n≥1）
3. 计算压缩图片实际边长值，以第2步计算结果为准，超过某个边界值则：width / pow(2, n-1)，height/pow(2, n-1)
4. 计算压缩图片的实际文件大小，以第2、3步结果为准，图片比例越大则文件越大。 
   size = (newW * newH) / (width * height) * m； 
   • [1, 0.5625) 则 width & height 对应 1664，4990，1280 * n（n≥3），m 对应 150，300，300；
   • [0.5625, 0.5) 则 width = 1440，height = 2560, m = 200；
   • [0.5, 0) 则 width = 1280，height = 1280 / scale，m = 500；注：scale为比例值
5. 判断第4步的size是否过小 
   • [1, 0.5625) 则最小 size 对应 60，60，100
   • [0.5625, 0.5) 则最小 size 都为 100
   • [0.5, 0) 则最小 size 都为 100
6. 将前面求到的值压缩图片 width, height, size 传入压缩流程，压缩图片直到满足以上数值

源码：

根据算法计算压缩后的宽高以及图片文件大小，在调用压缩方法compress，传入计算后的宽高以及图片大小 

开始进行压缩，这里分别执行了压缩图片大小compress方法，以及压缩图片质量saveImage方法 

压缩图片至预期大小，配置BitmapFactory.Options中inSampleSize的值来压缩图片的宽高 

图片质量压缩 

4.主要代码分析

清楚了第三档压缩的实现之后，再了解使用Luban压缩时用到几个方法：

get()、load(file)、putGear() 、setFileName()、setCompressListener()、launch()、asObservable()。

get(Context context)

首先调用的是get(this)，传入的是一个Context对象，调用私有的构造方法传入一个File对象创建一个Luban对象；File对象生成调用的是getPhotoCacheDir方法，来指定缓存目录。

路径为：app包名/cache/luban_disk_cache/文件名

load（File file）

public Luban load(File file) {
    mFile = file;
    return this;
}

这个方法比较容易理解，传入的是我们图片文件。

putGear(int gear)

public Luban putGear(int gear) {
        this.gear = gear;
        return this;
}

设置压缩等级，源码中只有两种等级：FIRST_GEAR 和 THIRD_GEAR，传入其他值无效。

    private static final int FIRST_GEAR = 1;
    public static final int THIRD_GEAR = 3;

setFileName(String fileName)

设置压缩后的图片名称

    public Luban setFilename(String filename) {
        this.filename = filename;
        return this;
    }

setCompressListener(OnCompressListener listener)

设置压缩监听 OnCompressListener是一个接口，里面有三个方法，对应三种状态

public Luban setCompressListener(OnCompressListener listener) {
        compressListener = listener;
        return this;
}

public interface OnCompressListener {

    /**
     * Fired when the compression is started, override to handle in your own code
     * 压缩开始
     */
    void onStart();

    /**
     * Fired when a compression returns successfully, override to handle in your own code
     * 压缩成功
     */
    void onSuccess(File file);

    /**
     * Fired when a compression fails to complete, override to handle in your own code
     * 压缩失败
     */
    void onError(Throwable e);
}

lanuch()

开始压缩，方法中使用的RxJava，根据设置的压缩等级来压缩图片

asObservable()

使用这个方法的话，采用的Rxjava方式返回一个观察者Observable。

    public Observable asObservable() {
        if (gear == FIRST_GEAR)//判断压缩等级 
            return Observable.just(mFile).map(new Func1() {
                @Override
                public File call(File file) {
                    return firstCompress(file); //调用第一档压缩方法
                }
            });
        else if (gear == THIRD_GEAR)
            return Observable.just(mFile).map(new Func1() {
                @Override
                public File call(File file) {
                    return thirdCompress(file);// 调用第三档压缩方法
                }
            });
        else return Observable.empty();
    }

Luban存在的不足

1.不能很好的支持多图片压缩。(出现问题：多图压缩出现OOM)

2.项目使用中必须添加RxJava依赖。（已在测试项目中剔除掉RxJava依赖 「链接」