Gradle 指南之从 Groovy 迁移到 Kotlin

前言

最近写 Kotlin 写的有些着魔了,正好看到 Gradle 4.10 版本支持使用 Kotlin DSL 构建脚本,然后心血来潮的尝鲜了下,因为刚出来,相关的资料实在太少,实际在迁移过程遇到不少问题,所以本文可能是第一篇非官方迁移指导文档,希望可以 save your time !

好了,话不多说,马上开始迁移(踩坑)之旅

准备工作

  1. 确认你的 IDE 是否最新版本,如不是,请升级到最新版本,本文是基于 Android Studio 3.1.4 版本进行的迁移

  2. 迁移过程可能会出现一些意想不到的坑,建议找个空闲时间,买杯咖啡,然后做好......和丫死磕的准备 :)

不建议在实际项目中直接迁移,毕竟对于 Kotlin 的支持刚出来,还不太稳定,可以拉个分支或者弄个Demo工程体验一下。

开始迁移

步骤一. 升级 Gradle 4.10,建议通过以下命令进行升级:

./gradlew wrapper --gradle-version=4.10

需要等待一段下载时间,更新完成后,点击 sync 按钮,好了,不出意外,这里会遇到第一个问题,如下图:


image

我们看下异常描述

Configuration on demand is not supported by the current version of the Android Gradle plugin since you are using Gradle version 4.6 or above. Suggestion: disable configuration on demand by setting org.gradle.configureondemand=false in your gradle.properties file or use a Gradle version less than 4.6.

简单来讲,Android Gradle 插件不支持基于新版本的 Gradle 的按需配置,异常描述里也提供两个解决办法:

  1. gradle.properties 增加 org.gradle.configureondemand=false 设置
  2. 使用低于 Gradle 4.6 以下的版本

ok,首先降版本的方案肯定被 pass 了,那就在我们项目的 gradle.properties 加上一段配置貌似就可以了,大功告成,so easy ~

too navie,当你加上这段配置后,你会发现仍旧无法通过编译,错误依旧,为此,我专门检查了好几遍是不是少了个字母之类的,显然和这个没有一毛钱关系,这里不应该质疑自己作为一名 CV 战士的专业性。

其实是被异常描述里给误导了,至少我直觉上是直接去修改工程里的 gradle.properties ,实际上,你需要修改的是 ${HOME}/.gradle/gradle.properties,当然也有更简单的方式,如图:

image

更多信息可以看这个回答:configuration-on-demand-is-not-supported

确认 sync 成功后,接下来就可以正式进行 Kotlin DSL 迁移了

步骤二. 使用 Kotlin 重写 Groovy

需要注意的地方是:

  • Groovy DSL script files use the .gradle file name extension.
  • Kotlin DSL script files use the .gradle.kts file name extension.

这里,我直接对原有的 build.gradle 脚本通过重命名的方式,修改为 build.gradle.kts 的后缀名,可能会提示有冲突,这里不用管,直接点击 continu,然后你会发现脚本里一片飙红,不用担心,之前的 Groovy 语法在 Kotlin 报错了而已,推荐全部删掉,然后对照着用 Kotlin 重新写一遍,这样,会印象深刻一些。

这里以一个比较简单的示例工程说明一下:

image

我们分别对根目录的 settting.gradlebuild.gradle 以及 app 目录下的 build.gradle 进行重写,以我的操作路径为例(不同操作路径,可能遇到的问题不一样):

app/build.gradle -> setting.gradle -> build.gradle

说下几个需要注意的地方:

需要说明的一点,目前 Gradle 官方是支持 Groovy 脚本和 Kotlin 并存的,虽然我感觉支持的并不太好

1. android 配置项无法自动被识别出来,如图所示:

image

解决办法:不用管,直接写一个配置项出来,然后 sync 同步一下就可以了,如图:

image

2. signconfig release 配置变更

signingConfigs {
    create("release") {
        storeFile = file("your keystore path")
        storePassword = "your password"
        keyAlias = "your alias"
        keyPassword = "your password"
    }
    getByName("debug") {
        storeFile = file("your keystore path")
        storePassword = "your password"
        keyAlias = "your alias"
        keyPassword = "your password"
    }
}

3. 重命名生成的 apk 文件名

大部分开发当中应该都会有对输出的 apk 有重命名的需求,原来我在 Groovy 中是通过:

applicationVariants.all { variant ->
    variant.outputs.all {
        outputFileName = "${flavors}@app_$versionName}.apk"
    }
}

迁移到 Kotlin 发现无法直接使用 outputFileName 的属性了

解决办法:显式转为具体实现类

android.applicationVariants.all {
    outputs.all {
        if (this is ApkVariantOutputImpl) {
            this.outputFileName = "$flavors@app_$versionName.apk"
        }
    }
}

4. setting.gradle 配置指定 build.gradle.kts

    rootProject.buildFileName = "build.gradle.kts"

    include("app")

好了,如果你没遇到其他问题的话,到这里基本就已经大功告成了!

另外,本文的示例工程我已经放到 GitHub 上了,各位感兴趣的可以去看下~

总结

首先对于 Gradle 这么快就支持 Kotlin DSL,我还是感到很惊喜的,其实,费了不少时间这么折腾了一下,实际上,如果一定要说作用的话,可能确实没有什么作用。

但是,我觉得好处还是要说一说的,对于使用 Kotlin 开发的小伙伴来说,首先开发语言和构建语言统一了,之前想写构建脚本,还需要去学习 Groovy。现在直接可以愉快的用 Kotlin 去写 Gradle 构建脚本了。

示例 Demo

参考资料:

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,185评论 6 503
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,652评论 3 393
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,524评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,339评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,387评论 6 391
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,287评论 1 301
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,130评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,985评论 0 275
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,420评论 1 313
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,617评论 3 334
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,779评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,477评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,088评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,716评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,857评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,876评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,700评论 2 354

推荐阅读更多精彩内容