Ant

Ant 태스크 가져오기

Kotlin은 Ant를 위한 세 가지 태스크를 제공합니다:

• kotlinc: JVM을 대상으로 하는 Kotlin 컴파일러
• kotlin2js: JavaScript를 대상으로 하는 Kotlin 컴파일러
• withKotlin: 표준 javac Ant 태스크를 사용할 때 Kotlin 파일을 컴파일하는 태스크

이 태스크들은 Kotlin 컴파일러 아카이브의 lib 폴더에 있는 kotlin-ant.jar 라이브러리에 정의되어 있습니다. Ant 버전 1.8.2 이상이 필요합니다.

Kotlin 소스만으로 JVM 대상 지정

프로젝트가 오직 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 독립 실행형 컴파일러의 압축이 해제된 폴더를 가리킵니다.

Kotlin 소스만 사용하고 여러 루트로 JVM 대상 지정

프로젝트가 여러 소스 루트로 구성된 경우, 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 소스로 JVM 대상 지정

프로젝트가 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"/>

단일 소스 폴더로 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>

Prefix, PostFix 및 sourcemap 옵션으로 JavaScript 대상 지정

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

단일 소스 폴더와 metaInfo 옵션으로 JavaScript 대상 지정

metaInfo 옵션은 변환 결과(Kotlin/JavaScript 라이브러리)를 배포하려는 경우 유용합니다. 만약 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>

참조

요소와 속성의 전체 목록은 아래에 나열되어 있습니다:

kotlinc 및 kotlin2js에 공통된 속성

이름	설명	필수	기본값
src	컴파일할 Kotlin 소스 파일 또는 디렉터리	예
nowarn	모든 컴파일 경고를 억제합니다	아니요	false
noStdlib	Kotlin 표준 라이브러리를 클래스패스에 포함하지 않습니다	아니요	false
failOnError	컴파일 중에 오류가 감지되면 빌드를 실패시킵니다	아니요	true

kotlinc 속성

이름	설명	필수	기본값
output	대상 디렉터리 또는 .jar 파일 이름	예
classpath	컴파일 클래스패스	아니요
classpathref	컴파일 클래스패스 참조	아니요
includeRuntime	output이 .jar 파일인 경우, Kotlin 런타임 라이브러리가 .jar에 포함되는지 여부	아니요	true
moduleName	컴파일되는 모듈의 이름	아니요	대상 이름(지정된 경우) 또는 프로젝트 이름

kotlin2js 속성

이름	설명	필수
output	대상 파일	예
libraries	Kotlin 라이브러리 경로	아니요
outputPrefix	생성된 JavaScript 파일에 사용할 접두사	아니요
outputSuffix	생성된 JavaScript 파일에 사용할 접미사	아니요
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를 실행할 때 표시됩니다.