獲取 Ant 任務(wù)

Kotlin 為 Ant 提供了三個(gè)任務(wù)：

• kotlinc: 針對(duì) JVM 的 Kotlin 編譯器
• kotlin2js: 針對(duì) JavaScript 的 Kotlin 編譯器
• withKotlin: 使用標(biāo)準(zhǔn) javac Ant 任務(wù)時(shí)編譯 Kotlin 文件的任務(wù)

這仨任務(wù)在 kotlin-ant.jar 庫(kù)中定義，該庫(kù)位于 Kotlin 編譯器的 lib 文件夾中

針對(duì) JVM 只用 Kotlin 源代碼

當(dāng)項(xiàng)目由 Kotlin 專用源代碼組成時(shí)，編譯項(xiàng)目的最簡(jiǎn)單方法是使用 kotlinc 任務(wù)

<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 獨(dú)立編譯器所在文件夾。

針對(duì) JVM 只用 Kotlin 源代碼且多根

如果項(xiàng)目由多個(gè)源代碼根組成，那么使用 src 作為元素來(lái)定義路徑

<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>

針對(duì) JVM 使用 Kotlin 和 Java 源代碼

如果項(xiàng)目由 Kotlin 和 Java 源代碼組成，雖然可以使用 kotlinc 來(lái)避免任務(wù)參數(shù)的重復(fù)，但是
建議使用 withKotlin 任務(wù)

<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>

要為 <withKotlin> 指定額外的命令行參數(shù)，可以使用嵌套的 <compilerArg> 參數(shù)。
當(dāng)運(yùn)行 kotlinc -help 時(shí)，會(huì)顯示可以使用的參數(shù)的完整列表。
還可以將正在編譯的模塊的名稱指定為 moduleName 屬性：

<withKotlin moduleName="myModule">
    <compilerarg value="-no-stdlib"/>
</withKotlin>

針對(duì) JavaScript 用單個(gè)源文件夾

<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>

針對(duì) JavaScript 用 Prefix、 PostFix 以及 sourcemap 選項(xiàng)

<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>

針對(duì) JavaScript 用單個(gè)源文件夾以及 metaInfo 選項(xiàng)

如果要將翻譯結(jié)果作為 Kotlin/JavaScript 庫(kù)分發(fā)，那么 metaInfo 選項(xiàng)會(huì)很有用。
如果 metaInfo 設(shè)置為 true，則在編譯期間將創(chuàng)建具有
二進(jìn)制元數(shù)據(jù)的額外的 JS 文件。該文件應(yīng)該與翻譯
結(jié)果一起分發(fā)。

<project name="Ant Task Test" default="build">
    <typedef resource="org/jetbrains/kotlin/ant/antlib.xml" classpath="${kotlin.lib}/kotlin-ant.jar"/>

    <target name="build">
        <!-- 會(huì)創(chuàng)建 out.meta.js，其中包含二進(jìn)制元數(shù)據(jù) -->
        <kotlin2js src="root1" output="out.js" metaInfo="true"/>
    </target>
</project>

參考

元素和屬性的完整列表如下

kotlinc 和 kotlin2js 的公共屬性

kotlinc 屬性

kotlin2js 屬性