Android Studio 3.0项目迁移所遇到的坑

最近 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 打包项目拷贝文件的脚本需要修改下。