Unzip 任务

将 .zip 存档解压缩到指定位置。

注意

仅在 MSBuild 15.8 及更高版本中提供 Unzip 任务。

参数

下表描述了 Unzip 任务的参数。

参数 描述
DestinationFolder ITaskItem 参数(必选)

指定文件要解压到的目的文件夹。
OverwriteReadOnlyFiles 可选 Boolean 参数。

如果为 true,则覆盖只读文件。 默认为 false
SkipUnchangedFiles 可选 Boolean 参数。

如果为 true,则跳过未更改的解压缩文件。 默认为 true。 如果文件的大小和上次修改时间相同,则 Unzip 任务认为文件保持不变。
SourceFiles 必选 ITaskItem[] 参数。

指定一个或多个文件进行解压缩。 指定多个文件时,它们将按顺序解压缩到同一文件夹中。

备注

除上面列出的参数外,此任务还从 TaskExtension 类继承参数,后者自身继承自 Task 类。 有关这些其他参数的列表及其说明的信息,请参阅 TaskExtension 基类

示例

以下示例将解压缩存档并覆盖所有只读文件。

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <Target Name="UnzipArchive" BeforeTargets="Build">
        <Unzip
            SourceFiles="MyArchive.zip"
            DestinationFolder="$(OutputPath)\unzipped"
            OverwriteReadOnlyFiles="true"
        />
    </Target>

</Project>

另请参阅