Apache Antの使い方

Apache Antをダウンロードします。

http://ant.apache.org/

ダウンロードしたら、C:\[インストールディレクトリ]\binにPathを通します。

パスが通っているかは以下で確認します。

C:\>ant -version
Apache Ant(TM) version 1.8.2 compiled on December 20 2010

1 2	C:\>ant -version Apache Ant(TM) version 1.8.2 compiled on December 20 2010

デフォルトのbuild.xmlの場所は、-fileオプションで指定します。

C:\>ant -file D:\sample\build.xml

1	C:\>ant -file D:\sample\build.xml

以下、例です。

<?xml version="1.0" encoding="UTF-8"?>
<project name="Sample" default="clean" basedir=".">
<property name="webapp" value="${basedir}/webapp"/>
<property name="compile.dest" location="${webapp}/WEB-INF/classes"/>
<!-- =================================
target: clean
================================= -->
<target name="clean" description="clean up">
<delete dir="${compile.dest}"/>
</target>
</project>

<?xml version="1.0" encoding="UTF-8"?>

<!-- =================================

target: clean

================================= -->

</target>

</project>

<delete dir=ディレクトリ名/>で、指定のディレクトリを削除します。以下、例です。

<delete dir="C:\test\" />

1	<delete dir="C:\test\" />

javacコマンドのよくあるエラーです。

Unable to find a javac compiler;

環境変数にJAVA_HOMEを追加します。

Pathに「%JAVA_HOME%\bin」を追加し、コマンドラインを立ち上げなおすと解決します。antのbinよりも前にこのパスを追加します。

[javac] D:\～～\Sample.java:163: シンボルを見つけられません。
[javac] シンボル: クラス Logger
[javac] 場所 : jp.co.confrage.Sample の クラス
[javac] public static void setLogger(Logger logger) {
[javac]                              ^

[javac] D:\～～\Sample.java:163: シンボルを見つけられません。

[javac] シンボル: クラス Logger

[javac] 場所 : jp.co.confrage.Sample のクラス

[javac] public static void setLogger(Logger logger) {

[javac] ^

クラスパスが通ってない場合に上記エラーとなります。

<javac srcdir="${compile.src}" destdir="${compile.dest}" encoding="UTF-8"
includeantruntime="false">
<classpath>
<fileset dir="${webapp}/WEB-INF/lib">
<include name="*.jar"/>
</fileset>
</classpath>
</javac>

<javac srcdir="${compile.src}" destdir="${compile.dest}" encoding="UTF-8"

includeantruntime="false">

</fileset>

</classpath>

</javac>

javac内でclasspathを通します。

<?xml version="1.0" encoding="UTF-8"?>
<project name="Jenkins" default="compile" basedir=".">
<property name="webapp" value="${basedir}/webapp"/>
<property name="compile.src" location="${basedir}/src/jp/co/confrage/"/>
<property name="compile.dest" location="${webapp}/WEB-INF/classes"/>
<!-- =================================
target: clean
================================= -->
<target name="clean" description="clean up">
<delete dir="${compile.dest}"/>
</target>
<!-- =================================
target: compile
================================= -->
<target name="compile" depends="clean">
<mkdir dir="${compile.dest}"/>
<javac srcdir="${compile.src}" destdir="${compile.dest}" encoding="UTF-8"
includeantruntime="false">
<classpath>
<fileset dir="${webapp}/WEB-INF/lib">
<include name="*.jar"/>
</fileset>
</classpath>
</javac>
</target>
</project>

<?xml version="1.0" encoding="UTF-8"?>

<!-- =================================

target: clean

================================= -->

</target>

<!-- =================================

target: compile

================================= -->

<javac srcdir="${compile.src}" destdir="${compile.dest}" encoding="UTF-8"

includeantruntime="false">

</fileset>

</classpath>

</javac>

</target>

</project>

このファイルでantを実行します。

C:\>ant -file D:\sample\build.xml

1	C:\>ant -file D:\sample\build.xml

以下のメッセージが表示されればビルドOKです。

BUILD SUCCESSFUL
Total time: 26 seconds

1 2	BUILD SUCCESSFUL Total time: 26 seconds

zipで圧縮する

Antのzipタスクで圧縮することができます。

<zip destfile="${server_dir}/${module_name}.zip"
basedir="${server_dir}/${module_name}"
update="yes"
/>

<zip destfile="${server_dir}/${module_name}.zip"

basedir="${server_dir}/${module_name}"

update="yes"

update=”yes”とすると、既に同名の圧縮ファイルが存在する場合、上書きされるようです。

が、Ant1.8.2でテストすると、上書きしてくれません。

update=”true”としても、上書きはしてくれません。

代替案として、ファイル削除してから圧縮します。

ファイル（フォルダ）を削除する

<delete file="${server_dir}/${module_name}.zip"/>

1	<delete file="${server_dir}/${module_name}.zip"/>

上記でファイルを削除することができます。

ファイル内の文字列を置換する

replaceタスクでファイル内の特定の文字を置換することができます。

<replace file="a.txt" token="aaa" value="bbb" />

1	<replace file="a.txt" token="aaa" value="bbb" />

上記は、a.txt内のaaaという文字列をbbbに全部変換します。

コピーする

copyタスクでtodir属性でコピー先を指定し、<copy>～</copy>内でコピー元を指定します。

<copy todir="${dest}">
  <fileset dir="${src}"/>
</copy>

</copy>

コピー時に「due to can’t write to read-only destination file」とエラーが出たら読み取り専用の為にコピーが出来ないというエラーなので、force=true属性を追加します。(Ant1.8.2より追加された属性)

<copy todir="${dest}" force="true">
  <fileset dir="${src}"/>
</copy>

</copy>

コピー時に特定ファイルを除外する

コピーする時に特定のファイルのみコピーしたくない場合があります。

そういう場合は

<copy todir="${dest}" >
<fileset dir="${src}" excludes="**/a.properties"/>
</copy>

</copy>

excludes=で指定します。この時、「**/ファイル名」とします。これでa.propertiesのみコピーされません。

Antのメモリサイズを増やす

環境変数を指定することにより、Antが使用するメモリを指定することができます。

JenkinsでAntを使用するとUNCがサポートされない不具合がある

なんとJenkins2.46.1+Ant Plugin1.4で、UNCがサポートされないという致命的な不具合があります。

JenkinsのUNC不具合は以下でなおっているので、Ant Plugin1.4のバグかと思われます。

https://issues.jenkins-ci.org/browse/JENKINS-19821

Unable to locate tools.jar. Expected to find it

Ant実行時に「Unable to locate tools.jar. Expected to find it」とエラーが出たら、%JAVA_HOME%を環境変数に設定されていないのが原因です。

%JAVA_HOME%を設定することでこのエラーは出なくなります。

C:\Documents and Settings\Administrator>ant -version
Apache Ant(TM) version 1.8.2 compiled on December 20 2010

C:\Documents and Settings\Administrator>