- Qbs Manual
- Qbs 2.1.1

# archiver

Provides support for building archives. More...

Since: | Qbs 1.4

- List of all members, including inherited members

## Properties

- archiveBaseName : string
- command : string
- compressionLevel : string
- compressionType : string
- flags : stringList
- outputDirectory : string
- type : string
- workingDirectory : string

## Detailed Description

The `archiver` module contains the properties and rules for creating (compressed) archives. The output artifact has the file tag `"archiver.archive"`. The sole input artifact is a text file containing the list of files to package, with one file path per line. The paths can be relative, in which case they will be looked for in workingDirectory. The file tag of this input artifact is `"archiver.input-list"`.

## Property Documentation

archiveBaseName : string

The base name of the archive file. That is, the file name without any extensions.

Default: product.targetName

command : string

The path to the executable used to create the archive.

This is usually the native tool corresponding to the archive type being produced, but may fall back to another tool also capable of producing that archive type if the native tool is not installed on the host system. This behavior is especially useful on platforms such as Windows, where the native tools for producing `tar` and `zip` archives in particular are much less likely to be installed.

The following table lists the supported archive types and the tools capable of producing them, listed in search order from left to right:

Type | Supported tools
--- | ---
7zip | 7z
tar | tar, 7z
zip | zip (Info-Zip), 7z, jar (from Java JDK)

Default: Depends on type.

compressionLevel : string

How much effort to put into the compression of a `7-Zip` or `zip` archive.

Possible values for zip are:

- `undefined`
- `"0"`
- `"1"`
- `"2"`
- `"3"`
- `"4"`
- `"5"`
- `"6"`
- `"7"`
- `"8"`
- `"9"`

7-Zip only supports 0 and the odd numbers above.

Higher numbers result in a smaller archive, but the compression process will take more time.

If the value is left undefined, the default compression level is used.

Default: Undefined

compressionType : string

How to compress a `tar` or `zip` archive.

Possible options are:

- `"bz2"`
- `"deflate"`
- `"gz"`
- `"none"`
- `"store"`
- `undefined`, which uses the archiver's default compression type.
- `"xz"`
- `"Z"`

Default: `"gz"` for `tar` archives, otherwise `undefined`.

flags : stringList

Custom options not covered by any of the other properties.

Default: `[]`

outputDirectory : string

Where to put the archive file.

Default: product.destinationDirectory

type : string

Which kind of archiver to use.

The currently supported values are:

- `"7zip"`
- `"tar"`
- `"zip"`

Default: Undefined

workingDirectory : string

The directory in which to execute the archiver tool specified by command.

Default: Undefined