Kotlin 为 Ant 提供了三个任务:
kotlinc
: 面向 JVM 的 Kotlin 编译器kotlin2js
: 面向 JavaScript 的 Kotlin 编译器withKotlin
: 使用标准 javac Ant 任务时编译 Kotlin 文件的任务
这仨任务在 kotlin-ant.jar 库中定义,该库位于 Kotlin 编译器包中的
lib
文件夹中。 需要 Ant 1.8.2+ 版本。
当项目由 Kotlin 专用源代码组成时,编译项目的最简单方法是使用 kotlinc
任务:
<project name="Ant Task Test" default="build">
<typedef resource="org/jetbrains/kotlin/ant/antlib.xml" classpath="${kotlin.lib}/kotlin-ant.jar"/>
<target name="build">
<kotlinc src="hello.kt" output="hello.jar"/>
</target>
</project>
其中 ${kotlin.lib}
指向解压缩 Kotlin 独立编译器所在文件夹。
如果项目由多个源代码根组成,那么使用 src
作为元素来定义路径:
<project name="Ant Task Test" default="build">
<typedef resource="org/jetbrains/kotlin/ant/antlib.xml" classpath="${kotlin.lib}/kotlin-ant.jar"/>
<target name="build">
<kotlinc output="hello.jar">
<src path="root1"/>
<src path="root2"/>
</kotlinc>
</target>
</project>
如果项目由 Kotlin 和 Java 源代码组成,虽然可以使用 kotlinc
来避免任务参数的重复,但是建议使用 withKotlin 任务:
<project name="Ant Task Test" default="build">
<typedef resource="org/jetbrains/kotlin/ant/antlib.xml" classpath="${kotlin.lib}/kotlin-ant.jar"/>
<target name="build">
<delete dir="classes" failonerror="false"/>
<mkdir dir="classes"/>
<javac destdir="classes" includeAntRuntime="false" srcdir="src">
<withKotlin/>
</javac>
<jar destfile="hello.jar">
<fileset dir="classes"/>
</jar>
</target>
</project>
还可以将正在编译的模块的名称指定为 moduleName
属性:
<withKotlin moduleName="myModule"/>
<project name="Ant Task Test" default="build">
<typedef resource="org/jetbrains/kotlin/ant/antlib.xml" classpath="${kotlin.lib}/kotlin-ant.jar"/>
<target name="build">
<kotlin2js src="root1" output="out.js"/>
</target>
</project>
<project name="Ant Task Test" default="build">
<taskdef resource="org/jetbrains/kotlin/ant/antlib.xml" classpath="${kotlin.lib}/kotlin-ant.jar"/>
<target name="build">
<kotlin2js src="root1" output="out.js" outputPrefix="prefix" outputPostfix="postfix" sourcemap="true"/>
</target>
</project>
如果要将翻译结果作为 Kotlin/JavaScript 库分发,那么 metaInfo
选项会很有用。
如果 metaInfo
设置为 true
,则在编译期间将创建具有二进制元数据的额外的 JS 文件。该文件应该与翻译结果一起分发:
<project name="Ant Task Test" default="build">
<typedef resource="org/jetbrains/kotlin/ant/antlib.xml" classpath="${kotlin.lib}/kotlin-ant.jar"/>
<target name="build">
<!-- 会创建 out.meta.js,其中包含二进制元数据 -->
<kotlin2js src="root1" output="out.js" metaInfo="true"/>
</target>
</project>
元素和属性的完整列表如下:
名称 | 描述 | 必需 | 默认值 |
---|---|---|---|
src |
要编译的 Kotlin 源文件或目录 | 是 | |
nowarn |
禁止所有编译警告 | 否 | false |
noStdlib |
不要将 Kotlin 标准库包含进 classpath | 否 | false |
failOnError |
在编译期间检测到错误时,会导致构建失败 | 否 | true |
名称 | 描述 | 必需 | 默认值 |
---|---|---|---|
output |
目标目录或 .jar 文件名 | 是 | |
classpath |
编译类路径 | 否 | |
classpathref |
编译类路径引用 | 否 | |
includeRuntime |
Kotlin 运行时库是否包含在 jar 中,如果 output 是 .jar 文件的话 |
否 | true |
moduleName |
编译的模块的名称 | 否 | 目标(如果指定的话)或项目的名称 |
名称 | 描述 | 必需 |
---|---|---|
output |
目标文件 | 是 |
libraries |
Kotlin 库的路径 | 否 |
outputPrefix |
生成的 JavaScript 文件所用前缀 | 否 |
outputSuffix |
生成的 JavaScript 文件所用后缀 | 否 |
sourcemap |
是否要生成 sourcemap 文件 | 否 |
metaInfo |
是否要生成具有二进制描述符的元数据文件 | 否 |
main |
编译器是否生成调用 main 函数的代码 | 否 |
如需传递原始编译器参数,可以使用带 value
或 line
属性的 <compilerarg>
元素。
可以放在 <kotlinc>
、 <kotlin2js>
与 <withKotlin>
任务元素内,如下所示:
<kotlinc src="${test.data}/hello.kt" output="${temp}/hello.jar">
<compilerarg value="-Xno-inline"/>
<compilerarg line="-Xno-call-assertions -Xno-param-assertions"/>
<compilerarg value="-Xno-optimize"/>
</kotlinc>
当运行 kotlinc -help
时,会显示可以使用的参数的完整列表。