Qbs Manual

Qbs 1.12.1

# ib

Provides support for Apple Interface Builder and related tools and file types. More...

Since: | Qbs 1.1

- List of all members, including inherited members

## Properties

- actoolName : string
- actoolPath : string
- appIconName : string
- autoActivateCustomFonts : bool
- compressPngs : bool
- errors : bool
- flags : stringList
- flatten : bool
- ibtoolName : string
- ibtoolPath : string
- iconutilName : string
- iconutilPath : string
- launchImageName : string
- module : string
- notices : bool
- warnings : bool

## Detailed Description

The `ib` module contains properties and rules for building Interface Builder documents, storyboards, asset catalogs, and icon sets.

This module is only available on Apple platforms.

### Relevant File Tags

The file tags determine how the tagged directories and files are handled.

Tag | Auto-tagged File Names | Since | Description
--- | --- | --- | ---
`"assetcatalog"` | `*.xcassets` | 1.3 | Tagged directories are compiled into compiled asset catalog archives (`.car` files) on supported platforms, or a collection of loose resource files. The resulting files will be automatically tagged bundle.input. If the current product is a bundle, the files will be included in the bundle's resources directory.
`"iconset"` | `*.iconset` | 1.3 | Tagged directories are compiled into Apple ICNS files. The resulting files will be automatically tagged bundle.input. If the current product is a bundle, the files will be included in the bundle's resources directory.
`"nib"` | `*.nib`, `*.xib` | 1.1 | Tagged "NIB" and "XIB" files will be compiled. The output may be a flat file or a bundle (directory structure). The resulting files will be automatically tagged bundle.input. If the current product is a bundle, the files will be included in the bundle's resources directory.
`"png"` | `*.png` | 1.9 | Tagged PNG files may be converted into multi-resolution TIFFs. Source files should adopt the @2x naming convention in order to be properly grouped. The resulting files will be given the tiff file tag.
`"storyboard"` | `*.storyboard` | 1.3 | Tagged storyboard files will be compiled. The output may be a flat file or a bundle (directory structure). The resulting files will be automatically tagged bundle.input. If the current product is a bundle, the files will be included in the bundle's resources directory.

## Property Documentation

actoolName : string

The name of the `actool` binary used to compile asset catalogs.

This property should not normally need to be changed.

Default: `"actool"`

This QML property was introduced in Qbs 1.3.

actoolPath : string

The directory where the `actool` binary is located.

This property should not normally need to be changed.

Default: `actoolName`

This QML property was introduced in Qbs 1.3.

appIconName : string

The name of the resource in the asset catalog that will be used as the application's icon.

Used to generate the partial `Info.plist` which will be merged into the resulting app.

If this property is `undefined`, no application icon will be specified.

Default: Undefined

This QML property was introduced in Qbs 1.3.

autoActivateCustomFonts : bool

Instructs the `ibtool` compiler to add custom fonts to the application's `Info.plist` when compiling XIBs and storyboards, which will cause the fonts to activate upon application launch.

Requires Xcode 6 or newer.

Default: `true`

This QML property was introduced in Qbs 1.3.

compressPngs : bool

Whether to compress PNG image files when building asset catalogs.

Default: `true`

This QML property was introduced in Qbs 1.3.

errors : bool

Whether to print errors when compiling.

Does not apply to icon sets.

Default: `true`

flags : stringList

Additional flags to pass to the underlying tool (`ibtool`, `actool`, `iconutil`).

Default: Undefined

Default: `true`

flatten : bool

Compiles XIBs and storyboards into flattened (non-wrapper) files.

Set to `false` to preserve editability of the resulting NIB and storyboard bundles in Interface Builder.

This property should not normally need to be changed.

Default: `true`

ibtoolName : string

The name of the `ibtool` binary used to compile NIBs and storyboards.

This property should not normally need to be changed.

Default: `"ibtool"`

This QML property was introduced in Qbs 1.3.

ibtoolPath : string

The directory where the `ibtool` binary is located.

This property should not normally need to be changed.

Default: `ibtoolName`

This QML property was introduced in Qbs 1.3.

iconutilName : string

The name of the `iconutil` binary used to compile icon sets.

This property should not normally need to be changed.

Default: `"iconutil"`

This QML property was introduced in Qbs 1.3.

iconutilPath : string

The directory where the `iconutil` binary is located.

This property should not normally need to be changed.

Default: `iconutilName`

This QML property was introduced in Qbs 1.3.

launchImageName : string

The name of the resource in the asset catalog that will be used as the application's launch image.

Used to generate the partial `Info.plist` which will be merged into the resulting app.

If this property is `undefined`, no launch image will be specified.

This property is specific to iOS.

Default: Undefined

This QML property was introduced in Qbs 1.3.

module : string

Sets the name of the module that the NIB or storyboard is a part of.

Requires Xcode 6 or newer.

Default: Undefined

This QML property was introduced in Qbs 1.3.

notices : bool

Whether to print notifications when compiling.

Does not apply to icon sets.

Default: `true`

warnings : bool

Whether to print warnings when compiling.

Does not apply to icon sets.

Default: `true`