ANT가 어떻게 움직이는 건지 궁금해서 알아보았다.

비록 가장 기초적인 것이지만 뭐든 기초가 중요한 것이고

한 번 해봤다고 별거 아니네 뭐.. 하고 접어뒀다간

나중에 필요할 때 다시 자료 찾아보느라 시간만 허비하는걸

조금이라도 줄이고자 이렇게 메모로 남긴다.

인터넷에서 자료를 찾아보니 아래의 링크에 좋은 내용의 자료가 있어서 링크해 두었다.

참고 웹페이지 : http://www.javastudy.co.kr/docs/lec_oop/ant/ant1.htm

                       http://www.javastudy.co.kr/docs/lec_oop/ant/ant2.htm

                       * 솔직히 고백하는데 현재의 이 문서는 위의 링크문서의

                          반정도만 따라해 본 것을 메모한 것일 뿐이라는 것을

                          미리 고백한다.

                          ( 좀 더 공부해서 이 문장이 빨리 지워지길 고대하면서...)

ANT 공식 페이지 : http://ant.apache.org/

설치,사용 환경

    운영체제 : Windows2000

    JAVA : JDK5.0 Update 8

    * 이 문서에서는 위의 환경을 위주로 설명을 한다.

ANT 설치

    위의 링크를 참조하여 ANT를 다운받았는데

    파일이름이 apache-ant-1.6.5-bin.zip(9.60MB) 이다.

    다운로드 받는데 찾는 시간이 아까운 사람은 아래 링크를 누르면

    바로 받을 수 있다.

                          apache-ant-1.6.5-bin.zip

    이 파일의 압축을 적당한 곳에 풀어 놓았다.

    이걸로 설치 끝.

    적당한 곳이라고 해서 아무곳이나 괜찮지만

    D: emp 의 밑에 같은 곳은 좀 그렇겠다.

    다음의 폴더들이 있다.

    /bin : Ant 실행을 위한 배치 파일이 있다(유닉스나 리눅스의 경우 셸 파일 사용)
    /lib : jar 파일들
    /docs : 매뉴얼과 API 문서가 있다.

    /etc : 설명이 없다.(알아봐야 한다.)

ANT를 환경변수에 등록

   압축을 풀었으면 ANT를 이용하기 편하게 환경변수에 등록을 해 둔다.

   환경변수의 Path에 JAVA의 bin과 ANT의 bin을 포함시킨다.

   ( 환경변수 설정법은 이 문서에서 설명하지 않습니다.

    단지, 환경변수 설정하는 곳까지 가는 방법의 하나로서

              바탕화면->내컴퓨터(마우스 오른쪽 클릭)->등록정보->고급-> 환경변수

     만 적어둡니다.

     나머지는 각자 알아서 하시길...

   )

   환경변수의 Path에 Ant의 bin 폴더를 추가했으면 적용시키기 위해 컴퓨터를

   재시작해야 한다.

   ( 난, 이 부분, 즉, 컴퓨터 재시작하느 것이 아주 불만인데

      환경변수 설정 후 재부팅하지 않고

      바로 적용시키는 방법을 찾아봤는데 눈에 띄질 않는다.

      분명히 어떤 방법이 있을 것 같은데...

   )

   재부팅(=재시작,재기동...)을 했으면

   명령 프롬프트에서

   >ant -help[엔터]

   를 해 본다.

   ANT의 도움말이 나오면 환경변수에 등록하기는 성공이다.

간단한 예제 컴파일 해 보기

연습할 폴더를 만든다.

이 문서에서는 이렇게 만들었다.

    -ant_test

          -classes

          -doc

          -jar

          -src

컴파일할 자바소스를 만든다.

    이 문서에서는 ant_test/src 에 HelloAnt.java라는 파일을 아래의 내용으로 만들었다.

    [HelloAnt.java]

    public class HelloAnt{
        public static void main(String args[]){
            System.out.println("Hello,Ant");
        }
    }

build.xml 을 작성한다.

    이 문서에서는 ant_test 에 build.xml 파일을 아래의 내용으로 작성했다.

    [build.xml]

    <?xml version="1.0"?>

    <!--
    name : 프로젝트 이름
    default : 초기치로 설정되는 작업, 아무 것도 지정하지 않고 실행하면 이 작업을 수행
    basedir : 프로젝트에 대한 기준 폴더를 지정
    property : 프로젝트에서 사용할 각 폴더들의 위치를 지정
    ${basedir} : 이미 앞에서 설정된 값을 읽어온다
    -->

    <project name="HelloAnt" default="javadoc" basedir="." >
    <property name="src.dir" value="${basedir}/src" />
    <property name="classes.dir" value="${basedir}/classes" />
    <property name="jar.dir" value="${basedir}/jar" />
    <property name="javadoc.dir" value="${basedir}/doc" />

    <!--
    target : 각각의 타겟을 지정, 타겟이란 프로젝트를 이루는 하나 하나의 작업 단위
    srcdir : 컴파일 하기 위한 자바 소스 파일의 위치를 지정
    destdir : 어느 폴더에 클래스 파일들을 위치 시킬지 지정
    -->

    <target name="compile" >
    <javac srcdir="${src.dir}" destdir="${classes.dir}" />
    </target>

    <!--
    jar : 파일을 만든다
    depends : compile 정상적으로 수행되어야만 진행
    jarfile : jar 파일의 위치와 파일 이름 지정
    basedir : jar로 묶을 클래스 파일의 위치
    includes : 모든 폴더에서 클래스 파일들만 포함
    -->

    <target name="jar" depends="compile">
    <jar jarfile="${jar.dir}/hello.jar"
    basedir="${classes.dir}"
    includes="**/*.class"
    />
    </target>

    <!--
    javadoc을 실행
    depends : compile과 jar 수행이 정상적으로 끝나야만 실행
    sourcepath : 소스 폴더 지정
    sourcefiles : 소스 파일 지정
    windowtitle : 제목 지정
    destdir : 파일 생성후 저장할 폴더 지정
    -->

    <target name="javadoc" depends="compile, jar" >
    <javadoc
    sourcepath="${src.dir}"
    sourcefiles="${src.dir}/HelloAnt.java"
    windowtitle="HelloAnt API"
    destdir="${javadoc.dir}"
    />
    </target>

    <!--
    소스 코드를 제외한 모든 작업 파일들과 폴더를 삭제한다
    -->

    <target name="clean" >
    <delete dir="${classes.dir}/classes/*"/>
    <delete dir="${jar.dir}/jar/*"/>
    <delete dir="${javadoc.dir}/doc/*"/>
    </target>

    </project>

    * 참조한 페이지에서

       위의 build.xml을 사용하려면 주석처리된 부분을 제거하고 사용해야 한다.

       라고 적혀있다.

      처음 이 주석처리된 부분을 제거하라고 해서

      딴에는 아는척하면 주석처리가 <!-- 과 --> 으로 둘러싸인 부분이니까

      <!-- 과 -->을 지우면 되겠군하고 그리 했지만 에러만 나왔다.

      원래 뜻은 <!-- 부터 --> 부분까지를 소스에서 삭제하라는 의미였다.

      한국말의 어려움이 느껴지는 부분이었다.

      처음엔 힘들여 작성한 것을 완전히 지우라는 뜻으로는 받아들여지지 않는다.

      더군다나 타자가 느린사람이 열심히 입력한 것인 경우에는 삭제해 버리기에는

      맘도 아플것이다.

      설명을 위해 친절히 주석을 붙여 둔 것이니 따로 저장해 두고 제대로 숙지해야

      할 것이다.

      이 build.xml 에 대한 설명은 위의 주석으로 대신한다.

      이제 설명 페이지 몇개 보고 따라하기식으로 하는 내 실력으론 도저히

      조리있게 설명할 수 없다.

    컴파일 한다.

        명령 프롬프트에서 위의 ant_test 폴더까지 들어가서

        >ant[엔터]

        하면 된다.

        이 문서에서는 결과가 아래처럼 나왔다.

        [ANT 실행 결과]

        D:TESTant_test>ant
        Buildfile: build.xml

        compile:
            [javac] Compiling 1 source file to D:TESTant_testclasses

        jar:
              [jar] Building jar: D:TESTant_testjarhello.jar

        javadoc:
          [javadoc] Generating Javadoc
          [javadoc] Javadoc execution
          [javadoc] Loading source file D:TESTant_testsrcHelloAnt.java...
          [javadoc] Constructing Javadoc information...
          [javadoc] Standard Doclet version 1.5.0_08
          [javadoc] Building tree for all the packages and classes...
          [javadoc] Building index for all the packages and classes...
          [javadoc] Building index for all classes...

        BUILD SUCCESSFUL
        Total time: 34 seconds

        실행메세지를 보니 build.xml을 자동으로 읽어들이는 것 같다.

        그 다음 컴파일해서 classes에 넣고

        jar 파일도 생성해서 넣고

        javadoc 도 생성해서 넣는다.

        마지막엔 기분좋게 BUILD SUCCESSFUL 이라는 메세지도 보여준다.

    아까 만들어둔 폴더들을 하나씩 열어보면 파일들이 들어있을 것이다.

    자바파일 실행

    명령 프롬프트에서 test_ant/classes 를 보면 위의 ant 실행에 의해

    HelloAnt.class 라는 파일이 있을 것이다.

    >java HelloAnt[엔터]

     Hello,Ant

     라고 실행이 된다.

이제 ANT가 무었인지 알겠다.

다 알았다는 것은 아니다.

문두에 붙여놓은 참고링크 문서의 반 만 따라 해 본 것인데  

이 뒤의 내용은 현재의 나에겐 좀 어렵다.

오늘은 여기까지만 하고 다시 필이 꽂힐 때 이어서 좀 더 어려운(?) 레벨에

도전해 봐야 겠다.

정말?

- 끝 -