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 文件名可以这样做：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
android {
    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)
                        }
                    }
                }
            }
        }
    }
}
def releaseTime() {
    return new Date().format("yyyy-MM-dd", TimeZone.getTimeZone("UTC"))
}

使用 Gradle Plugin 3.0.0 时报错：

1
2
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，输出文件写法也有点不一样：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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。

style attribute ‘@android:attr/windowEnterAnimation’ not found.

1
2
3
4
Error:(22, 5) style attribute '@android:attr/windowEnterAnimation' not found
Error:(22, 5) style attribute '@android:attr/windowExitAnimation' not found
Error:(31, 5) style attribute '@android:attr/windowEnterAnimation' not found
Error:(31, 5) style attribute '@android:attr/windowExitAnimation' not found

这是aapt2导致的，3.0默认启用了aapt2。
解决办法：在project的根目录下的gradle.properties最后添加关闭aapt2的代码：

1
android.enableAapt2=false

补充

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

最后

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



联系作者

我的微信公众号：吴小龙同学，欢迎关注交流，公号回复关键字「1024」有惊喜哦。