专栏首页一个会写诗的程序员的博客《Kotin 极简教程》第12章 使用 Kotlin 集成Gradle 开发 第12章 使用 Kotlin 集成Gradle 开发《Kotlin极简教程》正式上架:

《Kotin 极简教程》第12章 使用 Kotlin 集成Gradle 开发 第12章 使用 Kotlin 集成Gradle 开发《Kotlin极简教程》正式上架:

第12章 使用 Kotlin 集成Gradle 开发


《Kotlin极简教程》正式上架:

点击这里 > 去京东商城购买阅读 点击这里 > 去天猫商城购买阅读

非常感谢您亲爱的读者,大家请多支持!!!有任何问题,欢迎随时与我交流~


由于 Kotlin 具有丰富的功能,如一等函数和扩展方法等,因此它可以保留和改进 Gradle 构建脚本的最佳部分——包括简明的声明式语法以及轻松制作 DSL 的能力。

Gradle 团队与 Kotlin 团队密切合作,为 Gradle 开发了新的基于 Kotlin 脚本的构建配置语言,我们称之为 Gradle Script Kotlin,支持使用 Kotlin 编写构建和配置文件。同时,还支持在 IDE 中实现自动完成和编译检查等功能。有了Gradle Script Kotlin,我们可以使用 Kotlin 来写配置文件,就跟写普通代码一样。

我们在前面的章节中,已经有很多示例项目使用了 Gradle 来构建我们的 Kotlin 工程。本章我们将系统地来介绍一下使用 Kotlin 集成Gradle 开发的相关内容。

12.1 使用 Gradle 构建 Kotlin工程

12.1.1 kotlin-gradle 插件

为了用 Gradle 构建 Kotlin工程,我们需要设置好 kotlin-gradle 插件:

buildscript {
    ext {
        kotlinVersion = '1.1.3-2'
    }
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:${kotlinVersion}")
                ...
    }
}

apply plugin: 'kotlin'

并且添加 kotlin-stdlib 依赖:

dependencies {
    compile("org.jetbrains.kotlin:kotlin-stdlib-jre8:${kotlinVersion}")
    compile("org.jetbrains.kotlin:kotlin-reflect:${kotlinVersion}")
}

当然,这些操作在我们新建项目的时候,通常我们只需要选择相应的选项, IntelliJ IDEA 就会直接帮我们完成了基本的配置了。

我们使用 kotlin-gradle-plugin 编译 Kotlin 源代码和模块。使用的 Kotlin 版本通常定义为 kotlinVersion 属性。

针对 JVM,我们需要应用 Kotlin 插件:

apply plugin: "kotlin"

12.1.2 Kotlin 与 Java 混合编程

Kotlin 源代码可以与同一个文件夹或不同文件夹中的 Java 源代码混用。默认约定是使用不同的文件夹:

sourceSets {
    main.kotlin.srcDirs += 'src/main/kotlin'
    main.java.srcDirs += 'src/main/java'
}

如果使用默认的目录,上面的配置可以省去不写。

如果不使用默认约定,那么应该更新相应的 sourceSets 属性

sourceSets {
    main.kotlin.srcDirs += 'src/main/myKotlin'
    main.java.srcDirs += 'src/main/myJava'
}

12.1.3 配置 Gradle JavaScript 项目

当针对 JavaScript 时,须应用不同的插件:

apply plugin: "kotlin2js"

除了输出的 JavaScript 文件,该插件默认会创建一个带二进制描述符的额外 JS 文件。

如果是构建其他 Kotlin 模块可以依赖的可重用库,那么该文件是必需的,并且与转换结果一起分发。

二进制描述符文件的生成由 kotlinOptions.metaInfo 选项控制:

compileKotlin2Js {
    kotlinOptions.metaInfo = true
}

提示:示例工程可以参考 https://github.com/EasyKotlin/chapter2_hello_world_kotlin2js

12.1.4 配置 Gradle Android项目

Android 的 Gradle 模型与普通 Gradle 有点不同,所以如果我们要构建一个用 Kotlin 编写的 Android 项目,我们需要用 kotlin-android 插件取代 kotlin 插件:

buildscript {
    ext.kotlin_version = '1.1.2-4'
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.3.1'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

通常我们使用 Android Studio,都是生成一个带 app 子项目的工程。多项目配置的实现通常是在一个根项目路径下将所有项目作为子文件夹包含进去。例如我们在项目根路径下面的settings.gradle中如下配置:

include ':app'

每一个子项目都拥有自己的build.gradle文件来声明自己如何构建。

例如,我们在子项目app的构建配置文件 build.gradle 中一个完整的配置如下:

apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'

android {
    compileSdkVersion 25
    buildToolsVersion "25.0.2"
    defaultConfig {
        applicationId "com.kotlin.easy.kotlinandroid"
        minSdkVersion 14
        targetSdkVersion 25
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    compile 'com.android.support:appcompat-v7:25.3.1'
    compile 'com.android.support.constraint:constraint-layout:1.0.2'
    testCompile 'junit:junit:4.12'
    compile "org.jetbrains.kotlin:kotlin-stdlib-jre7:$kotlin_version"
}
repositories {
    mavenCentral()
}

其中,

apply plugin: 'kotlin-android' 是 Kotlin Android 插件。 compile "org.jetbrains.kotlin:kotlin-stdlib-jre7:$kotlin_version" 是 Kotlin 运行标准库。

另外, Android Studio 默认加载源码的目录是 src/main/java,如果想指定 Kotlin 代码在src/main/kotln目录,可以在 android 下添加以下内容:

android {
  ……
  sourceSets {
    main.java.srcDirs += 'src/main/kotlin'
  }
}

提示: 关于 Kotlin Android 的 Gradle 完整配置实例可参考 https://github.com/EasyKotlin/KotlinAndroid

12.1.5 配置Kotlin 标准库依赖

除了上面的 kotlin-gradle-plugin 依赖之外,我们还需要添加 Kotlin 标准库的依赖:

repositories {
    mavenCentral()
}

dependencies {
    compile "org.jetbrains.kotlin:kotlin-stdlib"
}

如果针对 JavaScript,使用 compile "org.jetbrains.kotlin:kotlin-stdlib-js" 替代之。

如果是针对 JDK 7 或 JDK 8,那么可以使用扩展版本的 Kotlin 标准库,其中包含为新版 JDK 增加的额外的扩展函数。使用以下依赖之一来取代 kotlin-stdlib

compile "org.jetbrains.kotlin:kotlin-stdlib-jre7"
compile "org.jetbrains.kotlin:kotlin-stdlib-jre8"

如果项目中使用 Kotlin 反射,添加反射依赖:

compile "org.jetbrains.kotlin:kotlin-reflect"

如果项目中使用测试框架,我们添加相应的测试库依赖:

testCompile "org.jetbrains.kotlin:kotlin-test"
testCompile "org.jetbrains.kotlin:kotlin-test-junit"

12.1.6 增量编译

Kotlin 支持 Gradle 中可选的增量编译。增量编译跟踪构建之间源文件的改动,因此只有受这些改动影响的文件才会被编译。从 Kotlin 1.1.1 起,默认启用增量编译。

12.1.7 编译器选项

要指定附加的编译选项,可以使用 Kotlin 编译任务compileKotlin的 kotlinOptions 属性。

配置单个任务示例:

compileKotlin {
    kotlinOptions {
        suppressWarnings = true
    }
}

12.2 使用 Kotlin 编写构建和配置文件

一个基于 Kotlin 来写 Gradle 构建脚本及插件的方式可能会是什么样的? 它对团队的帮助如何——尤其是大型团队——加快工作速度并编写结构更好、更易于维护的构建脚本?

这些可能性非常诱人。

因为 Kotlin 是一种静态类型语言,在 IDEA 和 Eclipse 中都有深入的支持,所以可以从自动补全到重构,以及其间的一切都能为 Gradle 用户提供适当的 IDE 支持。 而且由于 Kotlin 具有丰富的功能,如一等函数和扩展方法,因此它可以保留和改进 Gradle 构建脚本的最佳部分——包括简明的声明式语法以及轻松制作 DSL 的能力。

Gradle 团队认真地考察了这些可能性,与 Kotlin 团队密切合作,为 Gradle 开发一种新的基于 Kotlin 的构建语言——我们称之为 Gradle Script Kotlin。

下面我们就来简要介绍一下使用 Kotlin 脚本来编写 Gradle 的配置文件。

我们就以上一章中的 chapter11_kotlin_springboot 工程为例。

首先我们在根目录下新建一个settings.gradle 配置文件:

rootProject.name = 'chapter11_kotlin_springboot'
rootProject.buildFileName = 'build.gradle.kts'

指定 gradle 构建文件名是 'build.gradle.kts' 。 然后,我们新建 'build.gradle.kts' , 完整的内容如下:

buildscript {
    val kotlinVersion = "1.1.3-2"
    val springBootVersion = "2.0.0.M2"
    extra["kotlinVersion"] = kotlinVersion

    repositories {
        mavenCentral()
        maven { setUrl("https://repo.spring.io/snapshot") }
        maven { setUrl("https://repo.spring.io/milestone") }
    }
    dependencies {
        classpath("org.springframework.boot:spring-boot-gradle-plugin:$springBootVersion")
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion")
        classpath("org.jetbrains.kotlin:kotlin-allopen:$kotlinVersion")
    }
}

apply {
    plugin("kotlin")
    plugin("kotlin-spring")
    plugin("eclipse")
    plugin("org.springframework.boot")
    plugin("io.spring.dependency-management")
}

version = "0.0.1-SNAPSHOT"

configure<JavaPluginConvention> {
    setSourceCompatibility(1.8)
    setTargetCompatibility(1.8)
}


repositories {
    mavenCentral()
    maven { setUrl("https://repo.spring.io/snapshot") }
    maven { setUrl("https://repo.spring.io/milestone") }
}

val kotlinVersion = extra["kotlinVersion"] as String

dependencies {
    compile("org.springframework.boot:spring-boot-starter-actuator")
    compile("org.springframework.boot:spring-boot-starter-data-jpa")
    compile("org.springframework.boot:spring-boot-starter-freemarker")
    compile("org.springframework.boot:spring-boot-starter-web")
    compile("org.jetbrains.kotlin:kotlin-stdlib-jre8:${kotlinVersion}")
    compile("org.jetbrains.kotlin:kotlin-reflect:${kotlinVersion}")
    runtime("org.springframework.boot:spring-boot-devtools")
    runtime("mysql:mysql-connector-java")
    testCompile("org.springframework.boot:spring-boot-starter-test")
}

提示: 按照上述步骤,新建完文件build.gradle.kts后,IDEA 可能识别不了这些 DSL 函数,这个时候我们重启一下 IDEA 即可(这是一个 bug,后面会修复)。

这里面的 Gradle DSL 的相关函数与类都在 Gradle 软件包的 lib 目录下: lib/gradle-script-kotlin-(版本号).jar 。我们简单用下面的表格说明:

函数(类)

对应的gradle-script-kotlin代码

buildscript

open fun buildscript(@Suppress("unused_parameter") block: ScriptHandlerScope.() -> Unit) = Unit

repositories

fun ScriptHandler.repositories(configuration: RepositoryHandler.() -> Unit) =repositories.configuration()

buildscript.dependencies

DependencyHandlerScope(scriptHandler.dependencies)

configure

inline fun <reified T : Any> Project.configure(noinline configuration: T.() -> Unit)

Project.dependencies

DependencyHandlerScope(dependencies).configuration()

也就是说,其实这些配置函数背后都是由 Gradle 的 DSL 来实现的。

其实,这些配置语法看起跟 Groovy 的很像。例如:

Groovy :

    repositories {
        mavenCentral()
        maven { url "https://repo.spring.io/snapshot" }
        maven { url "https://repo.spring.io/milestone" }
    }

Kotlin:

repositories {
    mavenCentral()
    maven { setUrl("https://repo.spring.io/snapshot") }
    maven { setUrl("https://repo.spring.io/milestone") }
}

再例如: Groovy:

sourceCompatibility = 1.8
targetCompatibility = 1.8

Kotlin:

configure<JavaPluginConvention> {
    setSourceCompatibility(1.8)
    setTargetCompatibility(1.8)
}

提示: 本节示例工程源码 https://github.com/EasyKotlin/chapter11_kotlin_springboot/tree/build.gradle.kts

本章小结

本章我们简要介绍了使用 Kotlin 集成 Gradle 开发过程中的一些常用的配置方法。Gradle 是一个非常好用的构建工具,当我们的 Kotlin 工程的配置文件也是 Kotlin 代码的时候,我们的工作又更加单纯了许多,只需要专注 Kotlin 即可。

在下一章中,我们将学习使用 Kotlin 和 Anko 来进行Android开发的相关内容。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 《Kotin 编程思想·实战》

    1.2 程序执行的三种方式 1.2.1 编译执行 1.2.2 解释执行 1.2.3 虚拟机执行

    一个会写诗的程序员
  • 《Kotlin 程序设计》第九章 Kotlin与Java混合调用

    虽然 Kotlin 的开发很方便,但当你与他人协作时,总会碰到 Java 与 Kotlin 代码共存的代码项目。本章就教你如何优雅的实现 Kotlin 与 Ja...

    一个会写诗的程序员
  • Kotlin 企业级应用开发教程(Spring 5 + Spring Boot 2.0 + MyBatis)

    Kotlin编程语言是一种现代语言,它简洁,安全,实用,同时专注于与Java代码的互操作性。它几乎可以在使用Java的所有地方使用:服务器端开发,Android...

    一个会写诗的程序员
  • 现有项目接入Kotlin开发实战

    众所周知,Google强力推出了Kotlin作为Android开发的第一语言,那么我们现有用Java语言开发的项目,如何去接入Kotlin开发呢?

    Clayman Twinkle
  • 基于 Node.js 环境的 KotlinJs 工程的完美搭建

    我们知道 Kotlin 对 Jvm 的支持实在是太好了,以至于我们创建一个 Java 工程,配置一下 Kotlin 的编译插件和标准库就可以很轻松愉快的开始玩耍...

    bennyhuo
  • js中获取时间new date()的用法 原

    得到的结果:1280977330000 注意:这里得到的结果将后三位(毫秒)转换成了000显示,使用时可能会出现问题。例如动态添加页面元素id的时候,不建议使用...

    山河木马
  • 托管UITableView多样式cell的第三方库ZHTableViewGroup

    之前遇到过很多复杂的UITableView的结构,里面包含了很多复杂的cell,甚至一个Section包含很多种类的cell。通常在代理

    君赏
  • Python 刷题笔记:贪心算法专题一

    LeetCode 每月都会搞每日一题活动,昨天的题目是贪心算法类型,折腾好久才做出来,索性今天就围绕贪心算法多看几道。

    TTTEED
  • LocalStorage 的一个漏洞

    LocalStorage 是 html5 的本地存储,其中的内容以文件的形式保存在本地磁盘中。

    ApacheCN_飞龙
  • 方法的定义及调用

    葆宁

扫码关注云+社区

领取腾讯云代金券