- Qbs Manual
- QbsConvenienceItems
- Library
- Qbs 3.3.0

JavaJarFile ◦ LoadableModule

# Library

Generic library. More...

Since: | Qbs 1.4
Inherits: | Product
Inherited By: | CppLibrary and Plugin

- List of all members, including inherited members
- Library is part of List of All Items.

## Properties

- debugInformationInstallDir : string `(since Qbs 1.16)`
- importLibInstallDir : string `(since Qbs 1.13)`
- install : bool `(since Qbs 1.13)`
- installDebugInformation : bool `(since Qbs 1.16)`
- installDir : string `(since Qbs 1.13)`
- installImportLib : bool `(since Qbs 1.13)`

## Detailed Description

A Library item is a base item for native libraries and can have type set to one of the following values: `"dynamiclibrary"`, `"staticlibrary"`, `"objectlibrary"`, `"loadablemodule"`.

The default type value is `"dynamiclibrary"` except for iOS prior to version 8, in which case the default value is `"staticlibrary"`.

This item can automatically install the library target (and library symlinks on Unix) and separated debug information.

For Android targets, the following applies:

- The Product.type property value contains `"android.nativelibrary"` in addition to `"dynamiclibrary"`.
- There is a dependency on the cpp and Android.ndk modules.

## Property Documentation

debugInformationInstallDir : string `[since Qbs 1.16]`

Where to install the debug information if installDebugInformation is enabled.

The value is appended to qbs.installPrefix when constructing the actual installation directory.

Default: installDir.

This property was introduced in Qbs 1.16.

See also How do I separate and install debugging symbols?.

importLibInstallDir : string `[since Qbs 1.13]`

Where to install the import library, if installImportLib is enabled.

The value is appended to qbs.installPrefix when constructing the actual installation directory.

This property is only relevant for Windows targets.

Default: `lib`

This property was introduced in Qbs 1.13.

install : bool `[since Qbs 1.13]`

If `true`, the library will be installed to installDir.

Default: `false`

This property was introduced in Qbs 1.13.

installDebugInformation : bool `[since Qbs 1.16]`

If `true`, the debug information will be installed to debugInformationInstallDir.

Default: `false`

This property was introduced in Qbs 1.16.

See also How do I separate and install debugging symbols?.

installDir : string `[since Qbs 1.13]`

Where to install the library, if install is enabled. On Unix, the symbolic links are also installed to this location.

The value is appended to qbs.installPrefix when constructing the actual installation directory.

Default: `Library/Frameworks` if the library is a bundle, otherwise `bin` for Windows and `lib` for Unix-like targets.

This property was introduced in Qbs 1.13.

installImportLib : bool `[since Qbs 1.13]`

If `true`, the import library will be installed to importLibInstallDir. This property is only relevant for Windows targets. Enable it if you want to create a development package.

Default: `false`

This property was introduced in Qbs 1.13.