展开使用 GZip、BZip2 或 XZ 打包的资源。
如果 dest 是一个目录,目标文件的名字与 src 相同(如果存在,则删除 .gz
、.bz2
或 .xz
扩展名)。如果省略 dest,则使用 src 的父目录。只有当源资源比目标文件更新,或者目标文件不存在时,才会展开文件。
XZ 压缩支持已在 Apache Ant 1.10.1 之后 添加,并且依赖于 Ant 分发版中未包含的外部库。有关更多信息,请参阅 库依赖项。
属性 | 描述 | 必需 |
---|---|---|
src | 要展开的文件。 | 是,或嵌套资源集合 |
dest | 目标文件或目录。 | 否 |
指定的资源将用作 src。
将 test.tar.gz 展开到 test.tar
<gunzip src="test.tar.gz"/>
将 test.tar.bz2 展开到 test.tar
<bunzip2 src="test.tar.bz2"/>
将 test.tar.xz 展开到 test.tar
<unxz src="test.tar.xz"/>
将 test.tar.gz 展开到 test2.tar
<gunzip src="test.tar.gz" dest="test2.tar"/>
将 test.tar.gz 展开到 subdir/test.tar(假设 subdir 是一个目录)。
<gunzip src="test.tar.gz" dest="subdir"/>
下载 https://example.org/archive.tar.gz 并将其展开到项目 basedir 中的 archive.tar。
<gunzip dest="."> <url url="https://example.org/archive.tar.gz"/> </gunzip>
以下
<gunzip src="some-archive.gz" dest="some-dest-dir"/>
与
<copy todir="some-dest-dir"> <gzipresource> <file file="some-archive.gz"/> </gzipresource> <mapper type="glob" from="*.gz" to="*"/> </copy>
相同。对于 <bunzip2>
和 <bzip2resource>
或 <unxz>
和 <xzresource>
也是如此。<copy>
提供了其他功能,例如 动态过滤文件,允许将一个文件映射到多个目标,保留最后修改时间或可配置的文件系统时间戳粒度。