Apache Ant 任務 - 複製



描述

Copy 任務將檔案/資源集合複製到新的檔案或目錄。只有當原始檔比目標檔案更新,或者目標檔案不存在時,才會複製檔案。

屬性

序號 屬性及描述
1

File

要複製的檔案。(必填)

2

Preservelastmodified

使複製檔案的最後修改時間與原始原始檔相同。

3

Tofile

複製到的檔案。

4

Todir

複製到的目錄。

5

Overwrite

即使目標檔案較新,也覆蓋現有檔案。

6

Force

覆蓋只讀目標檔案。

7

Filtering

指示在複製過程中是否應使用全域性構建檔案過濾器進行標記過濾。

8

Flatten

忽略原始檔的目錄結構,並將所有檔案複製到 todir 屬性指定的目錄中。

9

includeEmptyDirs

複製 FileSet 中包含的任何空目錄。

10

Failonerror

如果為 false,則在要複製的檔案不存在或巢狀檔案集之一指向不存在的目錄或複製過程中發生錯誤時,記錄警告訊息,但不停止構建。

11

Quiet

如果為 true 且 failonerror 為 false,則在要複製的檔案不存在或巢狀檔案集之一指向不存在的目錄或複製過程中發生錯誤時,不記錄警告訊息。

12

Verbose

記錄正在複製的檔案。

13

Encoding

過濾複製檔案時假定的編碼。

14

Outputencoding

寫入檔案時使用的編碼。

15

Enablemultiplemappings

如果為 true,則任務將處理給定源路徑的所有對映。如果為 false,則任務將僅處理第一個檔案或目錄。此屬性僅在存在對映子元素時才相關。

16

Granularity

在確定檔案已過期之前要給予的毫秒級寬限期。這是因為並非每個檔案系統都支援跟蹤到毫秒級的最後修改時間。如果原始檔和目標檔案位於時鐘不同步的不同機器上,這也很有用。

示例

用法

建立包含以下內容的 build.xml 檔案:

<?xml version="1.0"?>
<project name="TutorialPoint" default="info">
   <target name="info">
      <copy file="text.txt" tofile="textcopy.txt"></copy>
   </target>
</project>

以上指令碼將當前目錄中的檔案(例如 text.txt)複製為 textcopy.txt。

輸出

在上述構建檔案上執行 Ant 會產生以下輸出:

F:\tutorialspoint\ant>ant
Buildfile: F:\tutorialspoint\ant\build.xml

info:
   [echo] Copying 1 file to F:\tutorialspoint\ant

BUILD SUCCESSFUL
Total time: 1 second
廣告