Share via


Tarefa de descompactação

Descompacta um arquivo .zip no local especificado.

Observação

A tarefa Unzip está disponível apenas no MSBuild 15.8 e superiores.

Parâmetros

A tabela a seguir descreve os parâmetros da tarefa Unzip.

Parâmetro Descrição
DestinationFolder Parâmetro ITaskItem necessário

Especifica a pasta de destino para descompactar o arquivo.
OverwriteReadOnlyFiles Parâmetro Boolean opcional.

Se true, substitui os arquivos somente leitura. Assume o padrão de false.
SkipUnchangedFiles Parâmetro Boolean opcional.

Se ele for true, ignorará a descompactação de arquivos inalterados. Assume o padrão de true. A tarefa Unzip considera os arquivos como inalterados se eles têm o mesmo tamanho e a mesma hora da última modificação.
SourceFiles Parâmetro ITaskItem[] obrigatório.

Especifica um ou mais arquivos a serem descompactados. Quando vários arquivos são especificados, eles são descompactados em ordem na mesma pasta.

Comentários

Além dos parâmetros listados acima, essa tarefa herda parâmetros da classe TaskExtension, que herda da classe Task. Para obter uma lista desses parâmetros adicionais e suas descrições, confira Classe base TaskExtension.

Exemplo

O exemplo a seguir descompacta um arquivo morto e substitui os arquivos somente leitura.

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

Confira também