不建议在实际项目中直接迁移,毕竟对于 Kotlin 的支持刚出来,还不太稳定,可以拉个分支或者弄个Demo工程体验一下。
开始迁移
步骤一. 升级 Gradle 4.10,建议通过以下命令进行升级:
./gradlew wrapper --gradle-version=4.10
需要等待一段下载时间,更新完成后,点击 sync 按钮,好了,不出意外,这里会遇到第一个问题,如下图:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-47t6oSy4-1637904132372)(https://user-gold-cdn.xitu.io/2018/8/30/1658991cc4adba93?imageView2/0/w/1280/h/960/ignore-error/1)]
我们看下异常描述
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
,当然也有更简单的方式,如图:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-4GT3EmkU-1637904132384)(https://user-gold-cdn.xitu.io/2018/8/30/1658992dc6bbdf63?imageView2/0/w/1280/h/960/ignore-error/1)]
更多信息可以看这个回答: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,然后你会发现脚本里一片飙红,不用担心,之前
《Android学习笔记总结+最新移动架构视频+大厂安卓面试真题+项目实战源码讲义》
【docs.qq.com/doc/DSkNLaERkbnFoS0ZF】 完整内容开源分享
的 Groovy 语法在 Kotlin 报错了而已,推荐全部删掉,然后对照着用 Kotlin 重新写一遍,这样,会印象深刻一些。
这里以一个比较简单的示例工程说明一下:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ca4teHx0-1637904132385)(https://user-gold-cdn.xitu.io/2018/8/30/165899a19b69041f?imageView2/0/w/1280/h/960/ignore-error/1)]
我们分别对根目录的 settting.gradle
和 build.gradle
以及 app
目录下的 build.gradle
进行重写,以我的操作路径为例(不同操作路径,可能遇到的问题不一样):
app/build.gradle
-> setting.gradle
-> build.gradle
说下几个需要注意的地方:
需要说明的一点,目前 Gradle 官方是支持 Groovy 脚本和 Kotlin 并存的,虽然我感觉支持的并不太好
1. android
配置项无法自动被识别出来,如图所示:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-mgjjUfPB-1637904132386)(https://user-gold-cdn.xitu.io/2018/8/30/165899c11c8fe959?imageView2/0/w/1280/h/960/ignore-error/1)]
解决办法:不用管,直接写一个配置项出来,然后 sync 同步一下就可以了,如图:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-xfskb8Yn-1637904132389)(https://user-gold-cdn.xitu.io/2018/8/30/16589a272d0a779f?imageView2/0/w/1280/h/960/ignore-error/1)]
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 {
outputs.all {
if (this is ApkVariantOutputImpl) {
了
解决办法:显式转为具体实现类
android.applicationVariants.all {
outputs.all {
if (this is ApkVariantOutputImpl) {