微信公众号

Android Studio 3.0 升级一些坑

前几天,期待已久的 Android Studio 3.0 release 版来临了,根据以往经验,每次大版本升级肯定要折腾一番,况且公司最近项目紧,因此我没有着急升级。10 月 31 号项目交了第一个版本,有同事离职了,我接了 NDK 的锅,到现在终于有空了,手痒痒点了升级。

Android Studio 3.0

官方更新日志:https://developer.android.google.cn/studio/releases/index.html ,我截图了,用的 Chrome 自带翻译功能,有些翻译不到位,但比我这半吊子英语看省事多了。



增量升级

点击 Check for Updates 增量更新:

下载完成,会提示更新 您将 Gradle 更新至 4.1:

这里建议您对老项目先暂时点击 Don’t remind me on this project,以防有坑。当然我不入地狱谁入地狱,我点 Update,于是问题来了,一直处于下载中,不过,莫担心,我下载好了,公众号聊天界面回复「gradle-4.1-all」,下载 gradle-4.1-all.zip 文件,放到:

重启 Android Studio。

gradle 目录:

Mac系统默认:/Users/(用户名)/.gradle

Windows系统默认:C:\Users(用户名).gradle

修改旧项目

首先我们新建项目,看看发生了哪些变化。

1、app/build.gradle

buildToolsVersion:这里没有构建工具的版本 buildToolsVersion 属性了,Android Studio 3.0 默认情况下,插件会自动为您使用的 Android 插件版本使用最低要求的构建工具版本;

implementation:由以前的 compile 改成了 implementation。老版本的构建关键字 compile 被废弃了,而是改成了这两个:api:同 compile 作用一样,即认为本 module 将会泄露其依赖的 module 的内容;
implementation:本 module 不会通过自身的接口向外部暴露其依赖 module 的内容。

2、项目 build.gradle

google():Android Studio 3.0 现在默认使用 Google 的 Maven 存储库,而不是依赖于 Android SDK Manager 来获取 Android 支持库,Google Play 服务,Firebase 和其他依赖项的更新;

build.gradle:指定的是Gradle插件的版本,由之前的 2.3.3 改成了 3.0.0。

3、gradle-wrapper.properties
gradle-wrapper.properties 中配置的是的 Gradle 的版本。

可以对老项目就以上几点进行修改。

butterknife

如果您在 lib 里使用了 butterknife,会遇到以下错误:

网上说将 apply plugin: ‘com.jakewharton.butterknife’ 注掉,是能解决问题,但是对于 lib 里使用了 butterknife 依旧报 R2 找不到,还得放开 apply plugin: ‘com.jakewharton.butterknife’,最后我只能退而求其次,将 build.gradle 中 3.0.0 改成之前的 2.3.3,解决。

打包自定义 APK 文件名

打包时,要是自定义输出 APK 文件名可以这样做:

buildTypes {
release {
//……
applicationVariants.all { variant ->
if (variant.buildType.name == 'release') {
variant.outputs.each { output ->
def outputFile = output.outputFile
if (outputFile != null && outputFile.name.endsWith('.apk')) {
def fileName = "Sample_v${defaultConfig.versionName}_${releaseTime()}_${variant.flavorName}.apk"
output.outputFile = new File(outputFile.parent, fileName)
}
}
}
}
}
}

使用 Gradle Plugin 3.0.0 时报错:

Cannot set the value of read-only property 'outputFile' for ApkVariantOutputImpl_Decorated{apkData=Main{type=MAIN, fullName=release, filters=[]}} of type com.android.build.gradle.internal.api.ApkVariantOutputImpl. Open File

需要修改 each() 和 outputFile() 方法为 all() 和 outputFileName,输出文件写法也有点不一样:

buildTypes {
release {
//……
applicationVariants.all { variant ->
if (variant.buildType.name == 'release') {
variant.outputs.all {
def apkName = "gradle4android_v${variant.versionName}"
if (!variant.flavorName.isEmpty()) {
apkName += "_${variant.flavorName}"
}
outputFileName = apkName + "_${releaseTime()}.apk"
}
}
}
}
}

输出的路径也有点不一样,根目录是 release,如果有渠道 xiaomi,那根目录是 xiaomi/release。

补充

build.gradle 和 gradle-wrapper.properties 区别,了解更多:https://developer.android.com/studio/releases/gradle-plugin.html

最后

目前遇到这些坑,欢迎一起吐槽您在升级开发遇到的坑,这次升级又折腾了很久。另外如果需要gradle-4.1-all.zip 文件,公众号「吴小龙同学」聊天界面回复「gradle-4.1-all」获取。