Configure build settings

Configure build settings in the Build Settings pane of the project editor to change the behavior of the build system.

Configure a build setting

Xcode assigns default build setting values based on your project configuration, so you should only need to change build settings if you require customization.

  1. Locate and select the desired build setting in the Build Settings pane of the project editor. See Find a build setting and Filter build settings.

  2. If you want to configure the build setting for a particular build configuration, click the disclosure triangle to the left of the build setting to display all available build configurations.

    You can also conditionalize build settings based on architecture and SDK. See Conditionalize build settings for different platforms.

  3. Choose or enter a value for the build setting or for a particular build configuration of the build setting.

    For values of type string or string list (see What is a build setting? to learn about value types), click the value to begin editing.

    Double-click a value of type string or string list to display a popover editor.

Find a build setting

Filter build settings

View build settings by declaration name

The declaration name of each build setting, instead of its human-readable name, is displayed in the Build Settings pane of the project editor. For example, instead of seeing Base SDK listed for the Base SDK (SDKROOT) build setting, you see SDKROOT.

View build settings by human-readable title

The human-readable name of each build setting, instead of its declaration name, is displayed in the Build Settings pane of the project editor. For example, instead of seeing SDKROOT listed for the Base SDK (SDKROOT) build setting, you see Base SDK.

View build setting calculated values

The calculated value of each build setting is displayed in the Build Settings pane of the project editor. For example, if the Intermediate Build Files Path (OBJROOT) build setting references the Build Products Path (SYMROOT) build setting, whose value is set to build, then the value of Intermediate Build Files Path (OBJROOT) also appears as build.

View build setting value definitions

The value definition of each build setting is displayed in the Build Settings pane of the project editor. For example, if the Intermediate Build Files Path (OBJROOT) build setting references the Build Products Path (SYMROOT) build setting, then the value of Intermediate Build Files Path (OBJROOT) also appears as $(SYMROOT).

See alsoWhat is a build setting?Learn about a build settingBuild settings referenceConditionalize build settings for different platformsEvaluate build setting value inheritanceAdd a build configuration (xcconfig) fileConfigure schemesWhat is the build system?