現在のロガーとリスナーにメッセージを出力しします。つまり System.out
です(オーバーライドされない限り)。level を指定して、どのロギングレベルでフィルターするか制御できます。
タスクはファイルに出力することもできます。その場合、ファイルに追記するか上書きするかのオプションが利用可能で、level オプションは無視されます。
属性 | 説明 | 必須 |
---|---|---|
message | 出力するメッセージ。 | いいえ。このエレメント内に文字セクションにテキストが含まれていない場合は、空白行 |
file | メッセージを書き込むファイル。 | いいえ。これらは 1 つのみ使用可能 |
output | メッセージを書き込む リソース(メモを参照してください)。Apache Ant 1.8 以降 | |
append | 既存のファイルに追加するか(新しいファイルを開くか既存のファイルをオーバーライド)しますか? | いいえ。output がファイルシステム宛先を示す場合のみ考慮され、デフォルトは false |
level | このメッセージが報告されるレベルを制御します。error、 warning、 info、 verbose、 debug(優先度の高い順)のいずれか |
いいえ。デフォルトは warning |
encoding | 使用するエンコーディング。Ant 1.7 以降 | いいえ。デフォルトは JVM の既定の文字エンコーディング |
force | 読み取り専用宛先ファイルを上書きします。Ant 1.8.2 以降 | いいえ。デフォルトは false |
基本的な使用
<echo message="Hello, world"/>
<echo message="Embed a line break:${line.separator}"/>
<echo>Embed another:${line.separator}</echo>
<echo>This is a longer message stretching over two lines. </echo>
<echo>
タグの直後に改行があると、それが出力に含まれます。エレメントのコンテンツ内にある文字データの改行は、XML パーサーでは破棄されません。
詳細については、W3C 推奨事項 2008 年 11 月 26 日 / 改行の処理 を参照してください。
<echo> This is a longer message stretching over three lines; the first line is a blank </echo>
-debug
モードでのみ表示されるメッセージ。
<echo message="Deleting drive C:" level="debug"/>
-quiet
モードでも表示されるメッセージ。
<echo level="error"> Imminent failure in the antimatter containment facility. Please withdraw to safe location at least 50km away. </echo>
ファイルに出力してシェルスクリプトを生成します。変数展開時に Ant が単一の $
をフィルタリングしないようにするために、二重の $
記号が使用されていることに注意してください。
<echo file="runner.csh" append="false">#\!/bin/tcsh java-1.3.1 -mx1024m ${project.entrypoint} $$* </echo>
Ant が実行されるログレベルに応じて、メッセージは出力されるか無視されます。
Ant コマンドライン | -quiet、-q | スイッチなし | -verbose、-v | -debug、-d |
---|---|---|---|---|
<echo message="This is error message." level="error"/> |
ok | ok | ok | ok |
<echo message="This is warning message."/> |
ok | ok | ok | ok |
<echo message="This is warning message." level="warning"/> |
ok | ok | ok | ok |
<echo message="This is info message." level="info"/> |
ログに記録されない | ok | ok | ok |
<echo message="This is verbose message." level="verbose"/> |
ログに記録されない | ログに記録されない | ok | ok |
<echo message="This is debug message." level="debug"/> |
ログに記録されない | ログに記録されない | ログに記録されない | ok |