Gradle指南之从Groovy迁移到Kotlin(3)

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

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

开始迁移

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

./gradlew wrapper --gradle-version=4.10

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

我们看下异常描述

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，当然也有更简单的方式，如图：

更多信息可以看这个回答：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 重新写一遍，这样，会印象深刻一些。

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

我们分别对根目录的 settting.gradle 和 build.gradle 以及 app 目录下的 build.gradle 进行重写，以我的操作路径为例（不同操作路径，可能遇到的问题不一样）：

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

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

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

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

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

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 = “KaTeX parse error: Expected group after '_' at position 14: {flavors}@app_̲versionName}.apk”
}
}

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

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

android.applicationVariants.all {

最后

对于很多初中级Android工程师而言，想要提升技能，往往是自己摸索成长，不成体系的学习效果低效漫长且无助。整理的这些架构技术希望对Android开发的朋友们有所参考以及少走弯路，本文的重点是你有没有收获与成长，其余的都不重要，希望读者们能谨记这一点。

同时我经过多年的收藏目前也算收集到了一套完整的学习资料以及高清详细的Android架构进阶学习导图及笔记分享给大家，希望对想成为架构师的朋友有一定的参考和帮助。

下面是部分资料截图，诚意满满：特别适合有开发经验的Android程序员们学习。

不论遇到什么困难，都不应该成为我们放弃的理由！

如果你看到了这里，觉得文章写得不错就给个赞呗？如果你觉得那里值得改进的，请给我留言，一定会认真查询，修正不足，谢谢。
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门，即可获取！
的，请给我留言，一定会认真查询，修正不足，谢谢。
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门，即可获取！