Android Studio 3.0 升级一些坑

2,517 阅读3分钟

前几天,期待已久的 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.propertiesgradle-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 {        minifyEnabled false        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'        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 {        minifyEnabled false        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'        applicationVariants.all { variant ->            if (variant.buildType.name == 'release') {                variant.outputs.all { output ->                    def outputFile = output.outputFile                    if (outputFile != null && outputFile.name.endsWith('.apk')) {                        def fileName = "Sample_v${defaultConfig.versionName}_${releaseTime()}_${variant.flavorName}.apk"                        output.outputFileName = new File(outputFile.parent, fileName)                    }                }            }        }    }}

补充

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

推荐阅读

Gradle for Android(一)基本配置、依赖管理 Gradle for Android(二)全局设置、自定义BuildConfig、混淆 Gradle for Android(三)多渠道打包、配置签名信息

最后

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