Apache Ant Tasks - Copy
描述
Copy 任务将文件/资源集合复制到新文件或目录。 仅当源文件比目标文件新或目标文件不存在时才会复制文件。
属性
| 序号 | 属性 & 描述 |
|---|---|
| 1 | File 要复制的文件。 （强制的） |
| 2 | Preservelastmodified 为复制的文件提供与原始源文件相同的最后修改时间。 |
| 3 | Tofile 要复制到的文件。 |
| 4 | Todir 要复制到的目录。 |
| 5 | Overwrite 即使目标文件较新，也要覆盖现有文件。 |
| 6 | Force 覆盖只读目标文件。 |
| 7 | Filtering 指示是否应在复制期间使用全局构建文件过滤器进行令牌过滤。 |
| 8 | Flatten 忽略源文件的目录结构，将所有文件复制到 todir 属性指定的目录中。 |
| 9 | includeEmptyDirs 复制文件集中包含的任何空目录。 |
| 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
