Unzip タスク

  • [アーティクル]

指定した場所に .zip アーカイブを解凍します。

Note

Unzip タスクは MSBuild 15.8 以降でのみ使用できます。

パラメーター

Unzip タスクのパラメーターの説明を次の表に示します。

パラメーター 説明
DestinationFolder 必須の ITaskItem パラメーター

ファイルの解凍先のフォルダーを指定します。
OverwriteReadOnlyFiles 省略可能な Boolean 型のパラメーターです。

true の場合、読み取り専用ファイルが上書きされます。 既定値は false です。
SkipUnchangedFiles 省略可能な Boolean 型のパラメーターです。

true の場合、変更されていないファイルの解凍がスキップされます。 既定値は true です。 Unzip タスクでは、ファイルのサイズが等しく、最終更新時刻が等しい場合、ファイルは変更されていないと見なされます。
SourceFiles 必須の ITaskItem[] 型のパラメーターです。

解凍する、1 つまたは複数のファイルを指定します。 複数のファイルを指定すると、同じフォルダーに整理されて解凍されます。

解説

上記のパラメーター以外に、このタスクは TaskExtension クラスからパラメーターを継承します。このクラス自体は、Task クラスから継承されます。 これらの追加のパラメーターの一覧とその説明については、「TaskExtension Base Class」を参照してください。

例

次の例では、アーカイブを解凍し、任意の読み取り専用ファイルを上書きします。

<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>

関連項目