Gradle指南之从Groovy迁移到Kotlin

最新推荐文章于 2024-07-15 09:37:50 发布

2401_84413032

最新推荐文章于 2024-07-15 09:37:50 发布

阅读量570

点赞数 29

分类专栏：程序员文章标签： kotlin 开发语言 android

本文链接：https://blog.csdn.net/2401_84413032/article/details/138428056

版权

程序员专栏收录该内容

309 篇文章 0 订阅

订阅专栏

前言

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

好了，话不多说，马上开始迁移（踩坑）之旅

准备工作

确认你的 IDE 是否最新版本，如不是，请升级到最新版本，本文是基于 Android Studio 3.1.4 版本进行的迁移
迁移过程可能会出现一些意想不到的坑，建议找个空闲时间，买杯咖啡，然后做好…和丫死磕的准备 😃

不建议在实际项目中直接迁移，毕竟对于 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 的按需配置，异常描述里也提供两个解决办法：

在 gradle.properties 增加 org.gradle.configureondemand=false 设置
使用低于 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”

小结

有了这么多优秀的开发工具，可以做出更高质量的Android应用。

当然了，“打铁还需自身硬”，想要写出优秀的代码，最重要的一点还是自身的技术水平，不然用再好的工具也不能发挥出它的全部实力。

在这里我也分享一份大佬自己收录整理的Android学习PDF+架构视频+面试文档+源码笔记，还有高级架构技术进阶脑图、Android开发面试专题资料，高级进阶架构资料这些都是我闲暇还会反复翻阅的精品资料。在脑图中，每个知识点专题都配有相对应的实战项目，可以有效的帮助大家掌握知识点。

总之也是在这里帮助大家学习提升进阶，也节省大家在网上搜索资料的时间来学习，也可以分享给身边好友一起学习
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门，即可获取！
来学习，也可以分享给身边好友一起学习
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门，即可获取！