Qbs Manual | Profile Item

Qbs 1.10.0

Product Item ◦ Project Item

# Profile Item

The profiles used by Qbs are normally set up on a user's machine and are then available to all projects. See the Configuring section for information on how to set up and use profiles on the command line. In some rare cases, however, the creator of a project has complete knowledge about the system on which that project is to be built. Then it can make sense to integrate the profile into the project:

      Product {
          // ...
          Profile {
              name: "my-special-profile"
              qbs.toolchain: ["gcc"]
              qbs.targetOS: ["linux", "unix"]
              qbs.architecture: "armv7a"
              cpp.toolchainInstallPath: "/opt/special-gcc/bin"
              cpp.toolchainPrefix: "arm-linux-gnueabi-"
          }
          qbs.profiles: ["my-special-profile"]
          // ...
      }

The project in the above example can be built in a particular well-known environment without any additional setup.

`Profile` items can appear inside Product and Project items.

## Profile Properties

Property | Type | Default | Description
--- | --- | --- | ---
baseProfile | `string` | `undefined` | The name of a profile from which this profile inherits. If the same property is set in both this profile and the base profile, the value from this profile takes precedence.
condition | `bool` | `true` | If this property is set to `false`, the profile cannot be used.
name | `string` | `undefined` | The name under which the profile can be referenced later. Setting this property is required. The value must be unique among all profiles in an entire project.

Product Item ◦ Project Item