升级到Android Studio3.0遇到的问题

前些天，google正式发布了Android Studio3.0。看这个版本号，这次是个大更新。升级后发现编译确实有很大的提升，还有最新的错误调试工具，总之，这次的更新google还是很有诚意的。

下载

Andriod Studio3.0下载

遇到的问题

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编译

android.enableAapt2=false

---

5.其他

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

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