= Oomph Unzip Setup Task
== Purpose
The oomph-unzip-task
is an extension for the https://projects.eclipse.org/proposals/oomph[Eclipse Oomph Installer] that allows to unarchive resources during the setup. The unzipTask
uses the https://commons.apache.org/proper/commons-compress/[apache-commons-compress] library to unarchive the resources.
Despite it's name the oomph-unizp-task
handles a wide range of archives besides +.zip+ (e.g. +.tar.gz+)
== Usage
http://maybeec.github.io/oomph-task-unzip/1.0 https://raw.githubusercontent.com/maybeec/oomph-task-unzip/master/task-unzip-updatesite/model/Oomph-task-unzip.ecore
at xsi:schemaLocation
in your Setup file so that the oomph installer can find the required packages.Now you can add the following snippet to your Setup file [source, xml] <setupTask xsi:type="com.github.maybeec.oomph.task:unzip"
zipFile="your/path/arch.ive" destinationDir="your/tempFolder" priority="500" />
zipFile
specifies the archive file you want to be unarchived. This file must not be encrypted. We support a wide range of archive types (namely most of the apache-commons-compress supported extensions).
destinationDir
specifies the folder the data should be stored in. The safest is to specify a full path