Kotlin使用Ant

獲取 Ant 任務(wù)

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

• kotlinc: 針對 JVM 的 Kotlin 編譯器
• kotlin2js: 針對 JavaScript 的 Kotlin 編譯器
• withKotlin: 使用標準 javac Ant 任務(wù)時編譯 Kotlin 文件的任務(wù)

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

針對 JVM 只用 Kotlin 源代碼

當項目由 Kotlin 專用源代碼組成時，編譯項目的最簡單方法是使用 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 獨立編譯器所在文件夾。

針對 JVM 只用 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>

針對 JVM 使用 Kotlin 和 Java 源代碼

如果項目由 Kotlin 和 Java 源代碼組成，雖然可以使用 kotlinc 來避免任務(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ù)。
當運行 kotlinc -help 時，會顯示可以使用的參數(shù)的完整列表。
還可以將正在編譯的模塊的名稱指定為 moduleName 屬性：

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

針對 JavaScript 用單個源文件夾

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

針對 JavaScript 用 Prefix、 PostFix 以及 sourcemap 選項

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

針對 JavaScript 用單個源文件夾以及 metaInfo 選項

如果要將翻譯結(jié)果作為 Kotlin/JavaScript 庫分發(fā)，那么 metaInfo 選項會很有用。
如果 metaInfo 設(shè)置為 true，則在編譯期間將創(chuàng)建具有
二進制元數(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">
        <!-- 會創(chuàng)建 out.meta.js，其中包含二進制元數(shù)據(jù) -->
        <kotlin2js src="root1" output="out.js" metaInfo="true"/>
    </target>
</project>

參考

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

kotlinc 和 kotlin2js 的公共屬性

kotlinc 屬性

kotlin2js 屬性