Creates a ZIP archive with the specified contents.
The task will create a ZIP archive based on the parameters passed to the task. The archive will be written to the specified location in the saker.zip.create subdirectory of the build directory.
By default, the archive is constructed in a deterministic manner, meaning that it will not include timestamps of the current build time, and the entries are put in the archive in a deterministic order.
Summary
| Includes | Specifies one or more archive entry inclusions which should be added to the output archive. |
| ModificationTime | Specifies the default modification time of the entries that are placed in the output archive. |
| Output | Specifies the output path of the created archive. |
| Resources | Specifies one or more resources which should be added to the created archive. |
| Transformers | Specifies one or more ZIP resource transformers that should be used when constructing the output. |
Parameters
Collection of ZipIncludeTaskOption
Aliases:
Include
Specifies one or more archive entry inclusions which should be added to the output archive.
The parameter is used to include entries from other ZIP archives into the output.
The option accepts simple paths, file locations, file collections or complex configuration.
Specifies the default modification time of the entries that are placed in the output archive.
The archive entries which are specified using the Resources parameter will have their modification time set to the date specified using this parameter. This is in order to have deterministic binary outputs of the archives.
If not specified, the epoch date (1970-01-01T00:00:00Z) is used.
Note that this parameter doesn't apply to entries included using the Include parameter. Those entries have the same modification time as in the source Archive.
The format of this parameter should be any of the following:
yyyy-MM-dd HH:mm:ss.SSS
yyyy-MM-dd HH:mm:ss
yyyy-MM-dd HH:mm
yyyy-MM-dd
yyyy.MM.dd
Where the pattern letters are interpreted the same way as SimpleDateFormat: https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html
Specifies the output path of the created archive.
The path must be forward relative, and the task will write the archive under the saker.zip.create subdirectory of the build directory.
If not specified, the archive is created with the "output.zip" name.
Collection of ZipResourcesTaskOption
Specifies one or more resources which should be added to the created archive.
The option accepts simple paths, file locations, file collections or complex configuration.
The path that a resource is added with to the archive is determined by the type of the configuration.
Collection of ZipResourceTransformerTaskOption
Aliases:
Transformer
Specifies one or more ZIP resource transformers that should be used when constructing the output.
ZIP resource transformers are plugins into the archive creating operation. They can customize the archive output in an implementation dependent manner.
In order to add transformers to the task, you need to implement your own Transformer with the ZIP creator task API, or use an existing implementations. Consult the use-case documentation of your transformer of interest to find out how to include it in the task.