Apache Ant Tasks 简明教程

Apache Ant Tasks - Copy

Description

Copy 任务将文件/资源集合复制到新文件或目录中。仅当源文件比目标文件新或目标文件不存在时,才复制文件。

Properties

Sr.No

Attributes & Description

1

File 要复制的文件。(必需)

2

Preservelastmodified 为所复制的文件指定与原始源文件相同的上一次修改时间。

3

Tofile 要复制到的文件。

4

Todir 要复制到的目录。

5

Overwrite 即使目标文件较新,也覆盖现有文件。

6

Force Overwrite read-only destination files.

7

Filtering 指出在复制过程中是否应使用全局构建文件筛选器进行标记筛选。

8

Flatten 忽略源文件的目录结构,并将所有文件复制到由 todir 属性指定的目录中。

9

includeEmptyDirs 复制 FileSet 中包含的任何空目录。

10

Failonerror 如果为假,在复制的文件不存在或者嵌套文件集之一指向不存在的目录或者在复制过程中发生错误时,记录一条警告消息,但不要停止构建。

11

Quiet 如果为 true 且 failonerror 为 false,则以下情况下不要记录警告消息:要复制的文件不存在,或者嵌套文件集之一指向不存在的目录,或者复制时出现错误。

12

Verbose 记录正在复制的文件。

13

Encoding 在过滤复制文件时假定的编码。

14

Outputencoding 写文件时使用的编码。

15

Enablemultiplemappings 如果为 true,则任务将处理给定源路径的所有映射。如果为 false,则任务仅处理第一个文件或目录。此属性仅当存在 mapper 子元素时才相关。

16

Granularity 在判定文件过时之前留有的毫秒数。这有必要,因为并非所有文件系统都支持毫秒级地跟踪最后修改时间。如果源文件和目标文件位于时钟不同步的不同机器上,这可能也有用。

Example

Usage

使用以下内容创建 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

Output

在上述构建文件上运行 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