简介
Android Studio升级到3.0后，有不少的改动和新特性，先贴出官方的迁移说明。
本文会持续收集与总结本人在使用Android Studio 3.0进行开发的过程中所遇到的问题。
版本配置
Gradle版本
- Android Studio 3.0需要的Gradle版本至少为4.1。
- 如果是使用gradle wrapper，则工程根目录/gradle/wrapper/gradle-wrapper.properties中的distributionUrl字段为https://services.gradle.org/distributions/gradle-4.1-all.zip。
Android Gradle插件版本
Android Studio 3.0需要Android Gradle插件版本为3.0.0。
Android Studio 3.0默认使用Google’s Maven Repository来下载Android Support Library，所以在脚本中要使用google()来加入谷歌仓库。
工程根目录/build.gradle的相关配置如下。
代码语言：javascript复制buildscript {
repositories {
google()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.0.0'
}
}使用annotationProcessor
从Android Studio 3.0开始，使用annotationProcessor代替apt。不可再使用apt，否则会编译报错。
Error:android-apt plugin is incompatible with the Android Gradle plugin. Please use ‘annotationProcessor’ configuration instead.
比如在Android Studio 3.0之前在application模块导入ButterKnife 8.4.0的gradle配置如下。
代码语言：javascript复制buildscript {
dependencies {
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
}
}apply plugin: 'com.neenbedankt.android-apt'
dependencies {
compile 'com.jakewharton:butterknife:8.4.0'
apt 'com.jakewharton:butterknife-compiler:8.4.0'
}而在Android Studio 3.0中，使用annotationProcessor代替apt，不用再导入android-apt插件。
代码语言：javascript复制dependencies {
compile 'com.jakewharton:butterknife:8.4.0'
annotationProcessor 'com.jakewharton:butterknife-compiler:8.4.0'
}修改apk名称
常用的修改输出的apk文件的名称的脚本如下。
代码语言：javascript复制def apkBaseName() {
// 先查找project.ext.apkName变量，若无则使用项目名
if(project.hasProperty("apkName")) {
return project.apkName
} else {
return project.name
}
}
def buildTime() {
return new Date().format("yyyyMMdd")
}
def delUnderline(String str) {
def result = str.startsWith("_") ? str.substring(1) : str
return result.endsWith("_") ? result.substring(0, result.length() - 1) : result
}
android.applicationVariants.all { variant - // ApplicationVariant
variant.outputs.each { output - // BaseVariantOutput
def file = output.outputFile
if(file != null && file.name.endsWith(".apk")) {
def flavorName = delUnderline(variant.flavorName)
def buildTypeName = delUnderline(variant.buildType.name)
def apkFile = new File(file.parent, "${apkBaseName()}_"
"${buildTypeName.empty ? "" : buildTypeName "_"}"
"${flavorName.empty ? "" : flavorName "_"}"
"v${variant.versionName}_"
"${buildTime()}.apk")
output.outputFile = apkFile
}
}
}在Android Studio 3.0中执行此脚本会报错如下，原因是ApkVariantOutputImpl的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
不再设置outputFile属性，而是设置outputFileName。同时把each()改为all()。
代码语言：javascript复制android.applicationVariants.all { variant - // ApplicationVariant
variant.outputs.all {
if (outputFileName.endsWith(".apk")) {
def flavorName = delUnderline(variant.flavorName)
def buildTypeName = delUnderline(variant.buildType.name)
outputFileName = "fileName"
}
}
}AAPT2
为了改进增量资源处理，Android Gradle插件3.0默认开启AAPT2。
在旧项目中开启AAPT2，有时候会报错，如：
Error: java.util.concurrent.ExecutionException: com.android.tools.aapt2.Aapt2Exception: AAPT2 error: check logs for details 可在gradle.properties中加入以下配置来禁用AAPT2。
代码语言：javascript复制android.enableAapt2=false新的依赖配置
Gradle 3.4推出了新的Java Library Plugin配置，而Android Gradle插件3.0是使用Gradle 4.1的，因此，需要注意更改为新的依赖配置。
旧的依赖配置，如compile project(‘:base-library’)，会导致如下错误。应该修改为implementation project(‘:base-library’)。
代码语言：javascript复制Error:Cannot choose between the following configurations of project :base-library:
- debugApiElements
- debugRuntimeElements
- releaseApiElements
- releaseRuntimeElementsflavor
从Android Gradle插件3.0开始，如果build.gradle中有自定义的productFlavors配置，需要添加自定义的flavorDimensions（风味维度），否则会编译报错。
Error:All flavors must now belong to a named flavor dimension. The flavor ‘flavor_name’ is not assigned to a flavor dimension.
解决方法是：先定义一个flavorDimensions，之后在每个flavor中指定为这个dimension。
代码语言：javascript复制android {
flavorDimensions 'core'
productFlavors {
beta {
dimension 'core'
}
production {
dimension 'core'
}
}
}在设置flavorDimensions之前，最终的Build Variant = Product Flavor Build Type。而设置之后，最终的Build Variant = 维度1 维度2 … 维度n Build Type。
Kotlin支持
在Android Studio 3.0之前，使用Kotlin需要进行额外的配置。而Android Studio 3.0开始，默认内置支持Kotlin，无需额外配置。
使用Android Studio工具栏中的Code – Convert Java File To Kotlin File，可将.java文件转为.kt文件。
Java8支持
从Android Studio 2.1起，官方通过Jack来支持Java8，从而开发者能使用Lambda等特性。
代码语言：javascript复制android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
defaultConfig {
jackOptions {
enabled true
}
}
}可在Android Studio工具栏，File – Project Structure，修改Source Compatibility和Target Compatibility为1.8。
Project Structure
从Android Studio 3.0起，默认支持Java8，无需额外进行JackOptions配置。
Android Profiler
从Android Studio 3.0起，新增Android Profiler来代替旧的Android Monitor工具。
Android Profiler提供了CPU、Memory和network等三个调试分析工具。
Android Profiler
Android Profiler的详细使用方法参考官方文档。
CPU Profiler Memory Profiler Network Profiler
Device File Explorer
在Android Studio 3.0主界面的右下角，点开”Device File Explorer”，可访问当前连接设备的文件。
以上就是本文的全部内容，希望对大家的学习有所帮助。
