Android studio升级3.0遇到的问题总结

遇到的问题

更新配置：首先要更换gradle版本，Android studio 3.0支持最低版本为gradle4.1，在gradle-wrapper.properties文件中更改gradle版本，同时在build.gradle中将gradle编译版本更改为3.0+

1.更新配置

Gradle需要更新到4.0-milestone-1，在gradle/wrapper/gradle-wrapper.properties中配置：

distributionUrl=
  https://services.gradle.org/distributions/gradle-4.0-milestone-1-all.zip

然后就配置Android Plugin的版本

buildscript {
    repositories {
        ...
        // You need to add the following repository to download the
        // new plugin.
        maven {
          url 'https://maven.google.com'
        }
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:3.0.0-alpha1'
    }
}

1.flavorDimensions

错误日志

Error:All flavors must now belong to a named flavor dimension. Learn more at https://d.android.com/r/tools/flavorDimensions-missing-error-message.html

原因：gradle3.0需要使用flavorDimensions做多版本打包，修改如下：

android {
    //...
    defaultConfig {
        //...
        flavorDimensions "dimen"
    }
}

然后在productFlavors中做相应的修改

productFlavors {
    productA { dimension "dimen" } 
    productB { dimension "dimen" }
}

配置多个flavorDimensions

android {
    //...
    defaultConfig {
        //...
        flavorDimensions "dimenA","dimenB"
    }
}
productFlavors {
    productA { dimension "dimenA" }
    productB { dimension "dimenB" }
    productC { dimension "dimenA" }
}

---

2.apk命名

错误日志

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

之前的代码：

applicationVariants.all { variant ->
        variant.outputs.each { output ->
            def outputFile = output.outputFile
            if (outputFile != null && outputFile.name.endsWith('.apk')) {
                def fileName = "XXX-${defaultConfig.versionCode}-${defaultConfig.versionName}-${releaseTime()}-${productFlavors.name[0]}"
                if (variant.buildType.name == 'release') {
                    fileName += '.apk'
                } else if (variant.buildType.name == 'debug') {
                    fileName += '_debug.apk'
                } else {
                    fileName += '_other.apk'
                }
                output.outputFile = new File(outputFile.parent, fileName)
            }
        }
    }

gradle3.0 each替换为all，output.outputFile替换为outputFileName，不需要new File了，修改后的代码：

applicationVariants.all { variant ->
        variant.outputs.all {
            def fileName = "XXX-${defaultConfig.versionCode}-${defaultConfig.versionName}-${releaseTime()}-${productFlavors.name[0]}"
            if (variant.buildType.name == 'release') {
                fileName += '.apk'
            } else if (variant.buildType.name == 'debug') {
                fileName += '_debug.apk'
            } else {
                fileName += '_other.apk'
            }
            outputFileName = fileName
        }
    }

需要注意的是，使用Build->Generate Signed APK…的时候，生成的apk包会放在一个以渠道名命名的文件夹下

---

3.Annotation processors must be explicitly declared now.Please add them to the annotationProcessor configuration.

错误日志

Error:Execution failed for task ':app:javaPreCompilePreProductDebug'.
> 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)
  Alternatively, set android.defaultConfig.javaCompileOptions.annotationProcessorOptions.includeCompileClasspath = true to continue with previous behavior.  Note that this option is deprecated and will be removed in the future.
  See https://developer.android.com/r/tools/annotation-processor-error-message.html for more details.

修复方案

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

---

4.Aapt2Exception

错误日志

Error:(113, 5) error: style attribute '@android:attr/windowEnterAnimation' not found.
Error:(113, 5) error: style attribute '@android:attr/windowExitAnimation' not found.
...
Error:java.util.concurrent.ExecutionException: java.util.concurrent.ExecutionException: com.android.tools.aapt2.Aapt2Exception: AAPT2 error: check logs for details
Error:java.util.concurrent.ExecutionException: com.android.tools.aapt2.Aapt2Exception: AAPT2 error: check logs for details
Error:com.android.tools.aapt2.Aapt2Exception: AAPT2 error: check logs for details
Error:Execution failed for task ':app:processPreProductDebugResources'.
> Failed to execute aapt

解决方案 在gradle.properties中添加如下代码，禁用aapt2编译

adnroid.enableAapt2 = false

---

5.其他

新版本gradle不需要配置buildToolsVersion
dependencies 引入包的时候是这样的

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    androidTestImplementation ...
    implementation project ...
    implementation files ...
    implementation ...
    testImplementation 'junit:junit:4.12'
}

整整搞了一天，在网上一直搜解决方案。终于解决了！ 遇到文件不能急，一急就容易盲目。一个一个问题的解决