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