A build setting provides information necessary for building the product of a target. For each task performed during the build process, such as compiling Swift code, build settings control how that task is performed. Build settings have default values, based on architecture and SDK. These defaults can be overridden by defining project-level values and target-level values. There are hundreds of configurable build settings, which are configurable in the Build Settings pane of the project editor. Build settings values are often literal values, but they can cross-reference other build settings. Build settings can also be conditionalized based on factors such as build configuration, architecture, and SDK.
Each build setting has the following attributes:
Attribute | Description | Example | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Human-readable name (also referred to as “title”) | This name is displayed in the Build Settings pane of the project editor when Xcode is set to show setting titles. |
| |||||||||
Declaration name (also referred to as “name”) | This name is displayed in the Build Settings pane of the project editor when Xcode is set to show setting names. Declaration names are also displayed in the Quick Help inspector when a build setting is selected in the project editor. Declaration names are also used in build configuration files and by the |
| |||||||||
Value type | Each build setting requires a specific type of value. There are numerous value types, but the following are the most common:
Value types are displayed in the Quick Help inspector when a build setting is selected in the project editor. |
| |||||||||
Value | A value of the specified type. |
| |||||||||