最近 Android Studio 3.0 版本正式推出，趁着项目刚发完版本，赶紧更新试试水，结果发现项目完全跑不起来，折腾了几个小时才搞好。记录一下填坑过程，希望能帮助其他同学。
1. gradle 和 buildToolsVersion 版本
Android Studio 3.0 要求 gradle 版本为 4.1 ，对应的 buildToolsVersion 为 26.0.2 ，然后记得在项目最外层的 build.gradle 添加 google() ，如果不添加将会导致某些官方依赖下载不了。
buildscript {
repositories {
...
google()
}
}
2. module 依赖方式变更
原先依赖 module 使用的是 compile ，现在需要替换为 api 或 implementation。
api : module 编译时可用，module 的使用者编译和运行时可用，这个和过时的 compile 一样的。
implementation : module 编译时可用，module 的使用者运行时可用,对于大量使用 library 的项目，可以显著提高编译时间，因为它可以减少构建系统重新编译一些 module 。
那么什么时候用 api ，什么时候用 implementation 呢？由于公司项目采用的是组件化开发，有个 common module 需要被各个组件依赖，一开始采用的是 implementation ，结果发现会导致别的组件无法引用 common 中的库（ common -> A module ，A module 无法引用 common 依赖的库 ）。
试验过后得出结论，当这个 module 会被多次引用应该使用 api，不会被别的 module 引用使用 implementation 。
发一下我现在使用的方式
dependencies {
api fileTree(include: ['*.jar'], dir: 'libs')
api 'com.squareup.okhttp3:okhttp:3.4.2'
...
debugApi 'com.squareup.leakcanary:leakcanary-android:1.5.1'
releaseApi 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.1'
}
compileOnly 替换了 provided，runtimeOnly 替换了 apk。
3. apt 插件更换
apt 插件已被废弃，需更换为 annotationProcessor 。
//apply plugin: 'android-apt'
dependencies {
...
annotationProcessor 'com.jakewharton:butterknife-compiler:8.5.1'
}
4.第三方库不兼容问题
· retrolambda
Android Studio 3.0 已经支持 Java 8 了，不需要第三方库来支持，因此需要去掉 retrolambda 库。
项目最外层的 build.gradle
buildscript {
...
dependencies {
...
//classpath 'me.tatarka:gradle-retrolambda:3.2.5'
}
}
module 中的 build.gradle
//apply plugin: 'me.tatarka.retrolambda'
android {
...
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
dependencies {
...
//retrolambdaConfig 'net.orfjackal.retrolambda:retrolambda:2.3.0'
}
· butterknife
butterknife 最新版本为 8.8.0，与 Android Studio 3.0 不兼容，会提示
Caused by: java.lang.NoSuchMethodError: com.android.build.gradle.tasks.ProcessAndroidResources.getPackageForR()Ljava/lang/String;
官方 issue 已经有人提过这个问题，貌似是 gradle 的问题。解决办法：版本降级到 8.5.1 即可解决。
· 项目中同一个第三库有多个版本导致编译失败
不知道是不是 Android Studio 3.0 编译现在比以前严格了，以前有的库没有统一过版本，现在直接编译不过了。解决办法：统一第三方库的版本。
在 Terminal 中输入 gradle app:dependencies （gradle环境配置可以百度）
...
+--- com.meituan.android.walle:library:1.1.5
| +--- com.android.support:support-annotations:24.1.1 -> 25.2.0
| \--- com.meituan.android.walle:payload_reader:1.1.5
...
如果出现了 com.android.support:support-annotations:24.1.1 -> 25.2.0 代表该库中有自己依赖的库被升级了，需要去除这个依赖。
dependencies {
...
api('com.meituan.android.walle:library:1.1.5') {
exclude(group: 'com.android.support', module: 'support-annotations')
}
}
group 是 : 前面的包名，: 后面的是 module 名字。
如果依赖的是 jar 包，写法为 exclude(module: 'libs/xxx.jar')。
exclude(group: 'com.android.support') 是忽略所有 com.android.support 的module。
另外 apk 的输出目录变了，多了一层目录结构 debug 。
由 app/build/outputs/apk 变为 app/build/outputs/apk/debug，如果是用 Jenkins 打包项目拷贝文件的脚本需要修改下。
