GUnzip/BUnzip2/UnXZ

描述

展开使用 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> 提供了其他功能,例如 动态过滤文件,允许将一个文件映射到多个目标,保留最后修改时间或可配置的文件系统时间戳粒度。