<!--
{
  "availability" : [
    "SwiftPM: 6.1.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "PackageDescription",
  "identifier" : "/documentation/PackageDescription/BuildSettingCondition/when(platforms:configuration:traits:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "PackageDescription"
    ],
    "preciseIdentifier" : "s:18PackageDescription21BuildSettingConditionV4when9platforms13configuration6traitsACSayAA8PlatformVGSg_AA0C13ConfigurationVSgShySSGSgtFZ"
  },
  "title" : "when(platforms:configuration:traits:)"
}
-->

# when(platforms:configuration:traits:)

Creates a build setting condition.

```
static func when(platforms: [Platform]? = nil, configuration: BuildConfiguration? = nil, traits: Set<String>? = nil) -> BuildSettingCondition
```

## Parameters

`platforms`

The applicable platforms for this build setting condition.

`configuration`

The applicable build configuration for this build setting condition.

`traits`

The applicable traits for this build setting condition.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)