이클립스에서 Ant를 이용한 빌드 자동화

Ant 빌드 파일은 XML로 작성되며, 하나의 project 요소를 가진다. project 요소는 target 요소를 포함하고, 각 target 요소는 여러 개의 태스크 요소를 포함한다. 간략하게 구졸르 보면 다음과 같다.

<project name="project_name" default="all" basedir=".">
  <target name="all" depends="compile,dist,clean">
    ...
  </target>
  <target name="compile">
    ...
  </target>
  <target name="dist" depends="compile">
    ...
  </target>
  <target name="clean">
    ...
  </target>
</project>

타깃 간의 의존 관계는 target 요소의 depends 속성으로 기술한다. 위의 빌드 스크립트에서 dist 타킷은 compile 타깃에 의존한다.

• property
  이름과 값으로 속성을 지정한다. 속성에서는 대소문자를 구별한다.

  <property name="foo.src" value="src"/>

  빌드 스크립트의 다른 부분에서 이 속성을 참조하려면 “${foo.src}”와 같이 쓰면 된다.

  <javac srcdir="${foo.src}" destdir="${build}"/>

  다음과 같이 파일을 읽어 속성을 설정할 수도 있다.

  <property file="foo.properties"/>

• mkdir
  새로운 디렉터리를 만들 때 사용되며 다음과 같은 식으로 사용한다.

  <mkdir dir="${dist}"/>
  <mkdir dir="${dist}/lib"/>

• copy
  디렉터리나 파일을 복사하는 데 사용한다. 파일 하나를 복사할 때는 다음과 같이 한다.

  <copy file="myfile.txt" tofile="mycopy.txt"/>

  디렉터리를 다른 디렉터리로 복사하는 스크립트는 다음과 같다.

  <copy todir="../new/dir">
    <fileset dir="src_dir">
  </copy>

  특정 디렉터리의 원하는 파일만 지정(*.java 파일을 제외한 나머지 파일)해 복사한다.

  <copy todir="../dest/dir">
    <fileset dir="src_dir">
      <exclude name="**/*.java"/>
    </fileset>
  </copy>

  위의 내용을 다음과 같이 쓸 수도 있다.

  <copy todir="../dest/dir">
    <fileset dir="src_dir" exclude="**/*.java"/>
  </copy>

• javac
  Java 소스 파일을 컴파일하는 데 사용한다. 소스 디렉터리는 재귀적으로 탐색되며, class 파일이 없거나 class 파일이 java 파일보다 오래된 경우에만 컴파일을 한다.${src}와 그 하위 디렉터리에 있는 모든 java 파일을 컴파일하여 그 결과를 ${build} 디렉터리에 저장한다. 클래스패스에는 xyz.jar가 포함되고, 디버깅 옵션을 켜고 컴파일한다.

  <javac srcdir="${src}" destdir="${build}" classpath="xyz.jar" debug="on"/>

  ${src}와 ${src2} 및 그 하위 디렉터리에 있는 java 파일을 컴파일하여 그 결과를 ${build} 디렉터리에 저장한다. 컴파일할 때 mypackage/p1과 mypackage/p2에 있는 파일만을 사용하고, 클래스패스에 xyz.jar가 포함된다.

  <javac srcdir="${src}:${src2}" destdir="${build}" include="mypackage/p1/**,mypackage/p2/**"
      exclude="mypackage/p1/testpackage/**" classpath="xyz.jar" debug="on"/>

  위의 예제는 아래와 같이 표현할 수도 있다.

  <javac destdir="${build}" classpath="xyz.jar" debug="on">
    <src path="${src}"/>
    <src path="${src2}"/>
    <include name="mypackage/p1/**"/>
    <include name="mypackage/p2/**"/>
    <exclude name="mypackage/p1/testpackage/**"/>
  </java>

• jar
  지정된 파일들을 jar로 묶는다. ${build}/classes 밑에 있는 파일을 app.jar로 묶는다.

  <jar destfile="${dist}/lib/app.jar" basedir="${build}/classes"/>

  ${build}/clases 밑에 있는 파일을 app.jar로 묶되, mypackage/test 밑에 있는 파일만을 묶고, Test.class는 제외한다.

  <jar destfile="${dist}/lib/app.jar" basedir="${build}/classes" include="mypackage/test/**" exclude="**/Test.class"/>

  ${build}/classes와 ${src}/resources 밑에 있는 파일을 app.jar로 묶되, Test.class는 제외한다.

  <jar destfile="${dist}/lib/app.jar">
    <fileset dir="${build}/classes" exclude="**/Test.class"/>
    <fileset dir="${src}/resources"/>
  </jar>

• javadoc
  javadoc 문서를 생성한다. 다음 예제는 src 디렉터리 밑에 있는 소스 파일을 읽어 javadoc 문서를 생성하여 ${doc} 디렉터리에 저장한다.

  <javadoc destdir="${doc}">
    <fileset dir="${src}">
    </fileset>
  </javadoc>

• delete
  하나의 파일 또는 디렉터리와 그 하위 디렉터리, FileSet에 지정된 파일을 삭제한다. /lib/ant.jar 파일을 삭제한다.

  <delete file="/lib/ant.jar"/>

  lib 디렉터리와 그 하위 디렉터리를 삭제한다.

  <delete dir="lib"/>

  현재 디렉터리와 그 하위 디렉터리에서 확장자가 bak인 모든 파일을 삭제한다.

  <delete>
    <fileset dir="." include="**/*.bak"/>
  </delete>

  build 디렉터리와 그 하위 디렉터리를 삭제한다. includeEmptyDirs를 “true”로 설정하면 fileset을 사용할 때 빈 디렉터리도 포함하도록 한다.

  <delete includeEmptyDirs="true">
    <fileset dir="build"/>
  </delete>

<project name="DummyChatter" default="dist-client" basedir=".">
<target name="init" description="initialize the properties.">
<tstamp/>
<property name="src" location="src"/>
<property name="build" location="build"/>
<property name="lib" location="lib"/>
<property name="dist" location="dist"/>
<property name="doc" location="doc"/>
</target>

    <!-- ================================= 
          target: compile              
         ================================= -->
    <target name="compile" depends="init" description="--> compile the source files">
        <mkdir dir="${build}"/>
    <javac srcdir="${src}" destdir="${build}" classpath="${lib}"/>
    <copy todir="${build}">
<fileset dir="${build}">
    <include name="**/*.properties"/>
</fileset>
    </copy>
    </target>

    <!-- ================================= 
          target: dist-client              
         ================================= -->
    <target name="dist-client" depends="compile" description="--> chat client packging">
        <mkdir dir="${dist}"/>
    <jar jarfile="${dist}/chat-client${DSTAMP}.jar">
    <fileset dir="${build}">
    <exclude name="chat/server/*.*"/>
    </fileset>
    </jar>
    </target>

    <!-- ================================= 
          target: dist-server              
         ================================= -->
    <target name="dist-server" depends="compile" description="--> chat server packging">
        <mkdir dir="${dist}"/>
    <jar jarfile="${dist}/chat-server${DSTAMP}.jar">
    <fileset dir="${build}">
    <exclude name="chat/client/*.*"/>
    </fileset>
    </jar>
    </target>

    <!-- ================================= 
          target: javadoc              
         ================================= -->
    <target name="javadoc" depends="init" description="--> create java doc">
        <mkdir dir="${doc}"/>
    <javadoc destdir="${doc}">
    <fileset dir="${src}"></fileset>
    </javadoc>
    </target>

    <!-- ================================= 
          target: clean              
         ================================= -->
    <target name="clean" depends="init" description="--> clean up">
        <delete dir="${build}"></delete>
    </target>
</project>