Sync

Apache Ant 1.6 以降

説明

1 つまたは複数の リソースコレクション に定義されたファイルからターゲットディレクトリを同期させます。

ネストされたリソースコレクションのいずれとも一致しないターゲットディレクトリのファイルはすべて削除されます。つまり、ソースからファイルを排除して、その名前のファイルがターゲットディレクトリにある場合、ターゲットから削除されます。

パラメーター

属性 説明 必須
todir リソースコレクションと同期するターゲットディレクトリ はい
overwrite 宛先ファイルが新しい場合でも既存ファイルを上書きします。 いいえ。デフォルトは false です。
includeEmptyDirs リソースコレクションに含まれる空のディレクトリをすべてコピーします。
注意: この属性は、ネストされた <preserveintarget> 要素の動作も制御します。この属性が false（デフォルト）の場合、ターゲットディレクトリにのみ存在する空のディレクトリは、<preserveintarget> のパターンと一致しても削除されます。<preserveintarget> の preserveEmptyDirs 属性でこれをオーバーライドできます。		 いいえ。デフォルトは false です。
failonerror この値を false に設定すると、警告メッセージが記録されますが、ネストされたファイルセットのいずれかが存在しないディレクトリを指している場合、ビルドは停止しません。 いいえ。デフォルトは true です。
verbose コピーするファイルをログに記録します。 いいえ。デフォルトは false です。
granularity ファイルが古くなったと判断するまでの猶予ミリ秒数です。これは、すべてのファイルシステムがミリ秒レベルで最終更新時刻を追跡できるわけではないからです。これは、ソースファイルとターゲットファイルが、時計の同期がずれた別々のマシンにある場合にも役立ちます。Ant 1.6.2 以降。 いいえ。デフォルトは 0 ミリ秒で、DOS システムでは 2 秒です。

ネストされた要素として指定されたパラメーター

すべてのリソースコレクション

リソースコレクション は、コピーするファイルのグループを選択するために使用されます。

Ant 1.7 より前は、<fileset> のみネストされた要素としてサポートされていました。

preserveInTarget

Ant 1.7.0 以降

ソースディレクトリのいずれかに存在しない場合でもターゲットディレクトリに保持する必要があるファイルまたはディレクトリを指定します。

このネストされた要素は FileSet のようなものですが、dir 属性をサポートせず、usedefaultexcludes 属性のデフォルトは false です。

追加のパラメーター
属性 説明 必須
preserveEmptyDirs この要素と一致するディレクトリの includeEmptydirs 設定をオーバーライドします。ソースディレクトリにない空のディレクトリを保持する場合、タスクの includeemptydirs 属性またはこの属性を設定できます。2 つの属性値が競合する場合、この属性が「優先」されます。 いいえ; タスクのincludeemptydirs属性の値にデフォルトで設定

例

siteにあるすべてのファイルをgenerated-siteの新しいファイルで上書きし、generated-siteに存在しないsiteのファイルを削除します。

<sync todir="site">
  <fileset dir="generated-site"/>
</sync>

siteにあるすべてのファイルをgenerated-siteの新しいファイルで上書きし、generated-siteに存在しないsiteのファイルを削除しますが、CVSサブディレクトリにあるすべてのファイルを維持します。

<sync todir="site">
  <fileset dir="generated-site"/>
  <preserveintarget>
    <include name="**/CVS/**"/>
  </preserveintarget>
</sync>