Android 史上最全gradle升级3.0+问题汇总（一）

Android Gradle3.0是一个大版本的升级，至于升级的好处，这里就不多说了。直接开干。

升级步骤

目前最新的gradle版本为3.2.0，对应gradle-4.6-all，并且build版本号要求28.0.2以上。但是28.0.2兼容上还是有挺多问题的，这里就不升级到最新的了。

这里升级为3.1.4，gradle4.4，buildToolsVersion为27.0.3，targetSdkVersion用27，compileSdkVersion用27。

修改版本号

build.gradle文件

dependencies {
    classpath 'com.android.tools.build:gradle:3.1.4'
    ....
}

allprojects {
    repositories {
        jcenter()
        google()//添加这句话
    }
}

gradle/wrapper/gradle-wrapper.properties文件 

distributionUrl=https\://services.gradle.org/distributions/gradle-4.4-all.zip

app/build.gradle文件

android {
    compileSdkVersion 27
    buildToolsVersion 27.0.3
    ....
    defaultConfig {
        targetSdkVersion 27
        ....
    }
}

//v4，v7包统一强制用27.1.0
dependencies {
    implementation("com.android.support:support-v4:27.1.0") {
        exclude group:'com.android.support', module:'support-v4'
    }
    implementation("com.android.support:appcompat-v7:27.1.0") {
        exclude group:'com.android.support', module:'appcompat-v7'
    }
}

 

然后运行编译，你会发现各种报错，下面我们慢慢来处理。

问题汇总

1、outputFile

Cannot set the value of read-only property 'outputFile' for ApkVariantOutputImpl_Decorated{apkData=Main{type=MAIN, fullName=debug, filters=[]}} of type com.android.build.gradle.internal.api.ApkVariantOutputImpl.

这是因为output.outputFile变成了只读属性，不能再往里面写东西了。所以这里需要修改更改打包名字的方式。以下是我这边的修改

原代码：

applicationVariants.all { variant ->
    variant.outputs.each { output ->
        def outputFile = output.outputFile
        if (outputFile != null && outputFile.name.endsWith('debug.apk')) {
        def fileName = "SFA_测试版.apk"
        output.outputFile = new File(outputFile.parent, fileName)
        }
    }
}

修改成：

applicationVariants.all { variant ->
    variant.outputs.all {
        if (outputFile != null && outputFile.name.endsWith('debug.apk')) {
        outputFileName = "SFA_测试版.apk"
        }
    }
}

2、incremental属性弃用，需要删掉设置

DSL element 'DexOptions.incremental' is obsolete and will be removed at the end of 2018.

 incremental属性弃用，需要删掉设置

dexOptions {
    //incremental true  //直接删除这个配置就可以了
    ...
}

3、compile属性名字更改

Configuration 'compile' is obsolete and has been replaced with 'implementation' and 'api'.

dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
    testCompile 'junit:junit:4.12'
    compile 'com.umeng.analytics:analytics:6.1.2'
    ....
}

修改如下：

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    testImplementation 'junit:junit:4.12'
    implementation 'com.umeng.analytics:analytics:6.1.2'
    ....
}

compile —> implementation或api    如果是依赖module的话，需要改成api

testCompile —> testImplementation或testApi

4、butterknife兼容

Annotation processors must be explicitly declared now.  The following dependencies on the compile classpath are found to contain annotation processor.  Please add them to the annotationProcessor configuration.
  - butterknife-7.0.1.jar (butterknife-7.0.1.jar)

针对这个问题，有一个快速解决办法，但不推荐使用

android {
    defaultConfig {
        javaCompileOptions {
            annotationProcessorOptions {
               includeCompileClasspath true
            }
        }
    }
}

因为在gradle 3.0以后不推荐使用这个插件，最好是更换最新的使用方法，如下：

在根目录的build.gradle文件加上这句：

dependencies {
    classpath 'com.jakewharton:butterknife-gradle-plugin:8.8.1'
}

在app/build.gradle中加上：

dependencies {
    implementation 'com.jakewharton:butterknife:8.8.1'
    annotationProcessor 'com.jakewharton:butterknife-compiler:8.8.1'
}

但是这样改之后，bind的使用方法跟之前的就不一样了，代码中肯定会报错，如：

错误: 找不到符号
符号:   类 Bind
位置: 程序包 butterknife

@Bind(R.id.et_employee_id)  需要改成  @BindView(R.id.et_employee_id)

如果代码涉及改动太多地方，可以使用第一种方式。

5、找不到依赖module引入的包

Compilation failed; see the compiler error output for details.

错误: 程序包com.loopj.android.http不存在

这是因为依赖的module里面用implementation的话会出现主module找不到该包，使用api才可以对外开放，如：

dependencies {
    implementation fileTree(dir: 'libs', include: '*.jar')
    implementation 'com.loopj.android:android-async-http:1.4.9'
}

需要改成：

dependencies {
    api fileTree(dir: 'libs', include: '*.jar')
    api 'com.loopj.android:android-async-http:1.4.9'
}

6、AAPT2错误

AAPT2 error: check logs for details

Error: java.util.concurrent.ExecutionException: com.android.builder.internal.aapt.v2.Aapt2Exception: AAPT2 error: check logs for details

 报这个错误的原因有很多，归根到底还是代码本身的错误。

参考了很多资料，其中一种方法就是在gradle.properties添加android.enableAapt2=false，然后添加了，有些项目是可以解决了，但是部分项目还是会出现另外一个错

The option 'android.enableAapt2' isdeprecated and should not be used anymore.
Use 'android.enableAapt2=true' to removethis warning.
It will be removed at the end of 2018..

这是因为选项“android.enableAapt2”已被弃用，不应再使用。
使用“android.enableAapt2=true”来删除这个警告。
它将在2018年底被移除。

而且这个设置也是治标不治本，还是要去找出代码中的错误。

那究竟怎么解决的，我发现我的项目是因为升级到28.0.2以上才会出现这个问题，那就尝试把buildToolsVersion版本号降低会27.0.3，重新编译。然后完美通过了。所以目前还是用27.0.3的版本就好。最新的AS对应的gradle是3.2.0，但是要求buildToolsVersion版本号是28.0.2以上，所以，我还是选了使用3.1.4的版本，对应4.4。

7、support包的类找不到问题

错误: 找不到符号
符号:   类 KeyEventCompat
位置: 程序包 android.support.v4.view

因为v4包用27.1.0的有可能部分类找不到，可以降为26.1.0，或者找替代类。

最后贴上我的配置：

ext {
    minSdkVersion = 15
    targetSdkVersion = 27
    compileSdkVersion = 27
    buildToolsVersion = '27.0.3'
    supportVersion = '27.1.0'//
}

8、调试错误Instant-Run

Installation failed with message Failed to establish session

总结以下两种解决办法：

1.如果是小米系统的手机，关掉小米手机开发者选项中的“miui优化”选项

2.关闭2.3的Instant-Run也解决了这个问题。File---Setting---Build---Instant-Run---Enable Instant Run to hot swap code (勾勾去掉)

均可有效解决上述问题。

 

目前遇到的问题就这么多，后面待续....

有问题欢迎交流....

关于功能业务方面的，请继续看Android 史上最全gradle升级3.0+问题汇总（二）