- Qbs Manual
- QbsConvenienceItems
- Library
- Qbs 2.5.1

JavaJarFile ◦ LoadableModule

# Library

Generic library. More...

Since: | Qbs 1.4
Inherits: | Product
Inherited By: | DynamicLibrary, LoadableModule, and StaticLibrary

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

## Properties

- debugInformationInstallDir : string
- importLibInstallDir : string
- install : bool
- installDebugInformation : bool
- installDir : string
- installImportLib : bool

## 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"`, `"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

[since Qbs 1.16] debugInformationInstallDir : string

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

[since Qbs 1.13] importLibInstallDir : string

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.

[since Qbs 1.13] install : bool

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

Default: `false`

This property was introduced in Qbs 1.13.

[since Qbs 1.16] installDebugInformation : bool

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

[since Qbs 1.13] installDir : string

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.

[since Qbs 1.13] installImportLib : bool

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.

JavaJarFile ◦ LoadableModule