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

打印页面