構成要素
大きく分けて、以下の4要素がある。
[1] project : 「build.xml」ファイルのトップレベルの要素
[2] target : task の集まりをまとめた要素
[3] task : 実行する具体的な処理
[4] property : build.xml 内で使用される定数
<?xml version="1.0" encoding="UTF-8" ?>
<project name="sample" basedir=".">
<!-- ここに記述 -->
</project>
project
`属性 | `説明 | 備考 |
name | プロジェクト名 | |
default | デフォルトで実行するタスク名 | |
basedir | パス指定のベースになるディレクトリ | |
サンプル
<?xml version="1.0" encoding="UTF-8" ?>
<project name="sample" basedir="." default="target1">
<target name="target1">
<echo message="Hello World!" level="info" />
</target>
</project>
target
`属性 | `説明 | 備考 |
name | ターゲット名 | |
depends | 依存しているターゲット名 | |
if | ターゲットを実行するにあたって設定されていなければならないプロパティ名 | |
unless | ターゲットを実行するにあたって設定されていてはダメなプロパティ名 | |
description | ターゲットの説明(コメント的な) | 以下「補足:用語について」を参照 |
サンプル
<?xml version="1.0" encoding="UTF-8" ?>
<project name="sample" basedir="." default="target0">
<target name="target0" depends="target1">
<echo message="From target0" level="info" />
</target>
<target name="target1">
<echo message="Hello World!" level="info" />
</target>
</project>
補足:用語について
* 公開ターゲット : ターゲットにdescriptionがついている場合
* 内部ターゲット : ターゲットにdescriptionがしていない場合または内部ターゲットの先頭にハイフンを追加
http://www.jajakarta.org/ant/ant-1.6.1/docs/ja/manual/using.html
property
`属性 | `説明 | 備考 |
name | 定数名 | |
value | 定数値 | 使用する際は「${【定数名】}」で使う |
location | ディレクトリ名やファイル名 | ※パスを扱う(特に相対パス)には、使用必須 |
サンプル
<?xml version="1.0" encoding="UTF-8" ?>
<project name="sample" basedir="." default="target0">
<target name="target0" depends="target1">
<echo message="Hello World, ${name1}" level="info" />
</target>
<target name="target1">
<property name="name1" value="Mike" />
</target>
</project>