BuildSettingCondition

By default, build settings are applicable for all platforms and build configurations. Use the .when modifier to define a build setting for a specific condition. Invalid usage of .when emits an error during manifest parsing. For example, it’s invalid to specify a .when condition with both parameters as nil.

The following example shows how to use build setting conditions with various APIs:

...
.target(
    name: "MyTool",
    dependencies: ["Utility"],
    cSettings: [
        .headerSearchPath("path/relative/to/my/target"),
        .define("DISABLE_SOMETHING", .when(platforms: [.iOS], configuration: .release)),
    ],
    swiftSettings: [
        .define("ENABLE_SOMETHING", .when(configuration: .release)),
    ],
    linkerSettings: [
        .linkLibrary("openssl", .when(platforms: [.linux])),
    ]
),

Checking for a Build Condition

• static func when(platforms: [Platform]) -> BuildSettingCondition

  Creates a build setting condition.

• static func when(configuration: BuildConfiguration) -> BuildSettingCondition

  Creates a build setting condition.

• static func when(platforms: [Platform]?, configuration: BuildConfiguration?) -> BuildSettingCondition
• static func when(platforms: [Platform], configuration: BuildConfiguration) -> BuildSettingCondition

  Creates a build setting condition.