安卓gradle打包包含java8语法糖的库（脱糖打包）

现在安卓开发有些人已经开始使用java8语法糖和使用jdk1.8打包的库（没启用兼容编译模式，class版本是52）。然而，我还依然使用java7（class版本是51）开发和打包，这样就会在合并打包时出现dx错误。
若你开始就是使用java8开发，则ide已经配置好，基本不会遇到这类打包问题。我这里主要说一下，之前工程一直使用java7开发，然后突然引用了包含java8语法糖的第三方库出现的问题。
以下会讲解如何打包java8的代码，其实也是把工程升级到java8模式。若你只是想升级工程编译级别，那看配置文件就行，不用去拷贝脱糖的中间结果，因为这个脱糖结果是打包的中间过程。若你只想获得脱糖的代码，只要新建一个测试工程来处理这部分代码就行，不用升级旧工程，毕竟这个步骤只是获得中间结果。

gradle代码默认是使用java7编译和打包的。若要使用java8语法糖（或者包含这类库），需要配置编译级别为JavaVersion.VERSION_1_8：

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

同时，gradle版本至少得到4，编译工具版本至少得到3。目前我用的是gradle 4.4和3.1.4的编译工具。顺便提一点，sdk的编译工具至少得到26，否则dx无法识别java8的class（class版本是52）。当然，若脱糖是gradle处理的（我说的就是这类），则用旧的dx也可以，毕竟输出到dx都是java7的class（class版本是51）。我还是直接给我的配置，这样好理解点：

buildscript {
    repositories {
        jcenter()
        mavenCentral()
        google()
    }
    dependencies {
        //classpath 'com.android.tools.build:gradle:1.1.2'
        //classpath 'com.android.tools.build:gradle:2.3.3'
        classpath 'com.android.tools.build:gradle:3.1.4'
    }
}
allprojects {
    repositories {
        jcenter()
        mavenCentral()
        google()
    }
}
apply plugin: 'com.android.application'

dependencies {
    api fileTree(dir: 'libs', include: '*.jar')
}

android {
    compileSdkVersion 28
    buildToolsVersion "28.0.1"

    sourceSets {
        main {
            manifest.srcFile 'AndroidManifest.xml'
            java.srcDirs = ['src']
            resources.srcDirs = ['src']
            aidl.srcDirs = ['src']
            renderscript.srcDirs = ['src']
            res.srcDirs = ['res']
            assets.srcDirs = ['assets']
        }

        // Move the tests to tests/java, tests/res, etc...
        //instrumentTest.setRoot('tests')
        // gradle 4.4+ NOT use above code, please change to below code!
        androidTest.setRoot('tests')

        // Move the build types to build-types/<type>
        // For instance, build-types/debug/java, build-types/debug/AndroidManifest.xml, ...
        // This moves them out of them default location under src/<type>/... which would
        // conflict with src/ being used by the main source set.
        // Adding new build types or product flavors should be accompanied
        // by a similar customization.
        debug.setRoot('build-types/debug')
        release.setRoot('build-types/release')
    }

    // if the project uses Java 8 features, you MUST use gradle 4.4+ to assemble it.
    // the android build tools MUST use "3.1.4" or above.
    // we NOT use gradle 3.5+ with jack to assemble, because jack has problems!
    // Java 8 super bit is 52 at class file. it will desugar to Java 7 by d8 or converter.
    // CAUTION: your code may be changed if it uses converted code!
    // you can add google() to build script repositories for using Google's Maven repo.
    // of course, please uncomment below options to open Java 8 compiler!
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    lintOptions {
        // please assure that it is no crash for error points!
        checkReleaseBuilds false
        abortOnError false
    }
}

我们这里暂时不谈sdk提供d8来打包java8代码的功能，因为这样我们就无法获得脱糖的中间结果（d8可以直接转换包含java8语法糖的class，dx则不能转换这类语法糖，但是26以上的dx可以解析java8的class）。我们依然使用dx来打包代码。
gradle打包java8代码前，会进行脱糖处理，即把java8代码和库转换成java7的。之后再使用dx打包这部分脱糖库。脱糖的中间结果在build\intermediates\transforms\desugar。我现在就是拷贝这里面脱糖后的结果再去使用。转换后的class版本是java7的，即51。

说到这里，有人就会纳闷：既然可以直接打包，为何还要拷贝脱糖的库？
其实，以上过程是按照java8配置打包的，换句话说，已经将工程升级为java8模式。但是，我前面已经说了，我们工程依然要使用java7的版本（很贱的思想）。这样有什么好处了？很简单，java7兼容范围更广！使用java7的代码，你可以使用更低的编译工具来打包，例如25。

补充一点，若你使用的库class版本是52，但是里面没用到java8的语法糖，则不用进行脱糖操作。目前，sdk编译工具版本25以下无法识别java8的class，需要到26。这类库的打包，你只要升级sdk编译工具版本就行，不用升级gradle。对于这类库，我一般是先dx到子包里面，之后打包都不用再关心dx操作（需要自己分包）。

若你自己使用脱糖后的库（自己拷贝出来，而不是gradle处理），有几个问题要注意：
1、脱糖后的代码是有改变的（用到语法糖的部分）！若你刚好使用这部分代码，你要注意代码不要直接使用，否则就无法打包。我一般是自己增加中间class来处理这些调用。这个class引用包含语法糖的代码。然后把这个class加到库里面，一起去进行脱糖处理。这样，你代码引用中间class就不会出现打包前后代码不一致问题。

2、脱糖后可能会遇到无法找到类的问题：com.google.devtools.build.android.desugar.runtime.ThrowableExtension
这个类是脱糖后，代码里面转换try_with_resources的工具类。包含这个类的库在build\intermediates\processing-tools\runtime-deps\debug\desugar_try_with_resources.jar。gradle不会自动把这个类打包到jar，因为没法这样做（很多jar都可能用到）。所以，拷贝脱糖库后，记得把这个也拷贝出来一起打包！我这里也发一份，有的人可能懒得再去打包一次java8代码来提取这个。
链接：https://pan.baidu.com/s/1h_66EyPHGqae80BMVnBZMg
提取码：eirx

总结一下，以上自己使用脱糖库过程是麻烦且不讨好的操作。若你不想去兼容java7代码，直接升级到java8吧。另外，上面也简单说到d8，若你是自己分包，则可以先用d8直接打包这部分代码，之后就不用再打包，也就不会影响旧工程代码。