Configure build settings

To change the behavior of the build system, configure build settings in the Build Settings pane of the project editor. Xcode provides default build settings based on your project configuration, so only change build settings if necessary.

For descriptions of each build setting, go to Build settings reference.

Search for a build setting

  1. In the project editor, choose the project or target, then click Build Settings.

  2. In the search field, enter a search term—such as a build setting title, a build setting name, or other keyword.

    The search results appear below the toolbar.

Filter build settings

  1. In the project editor, choose the project or target, then click Build Settings.

  2. In the filter bar at the top of the Build Settings pane, click a filter option.

    • Basic: Shows the most common build settings.

    • Customized: Shows only build settings that have been customized for the selected project or target.

    • All: Shows all build settings.

Configure a build setting

  1. In the project editor, choose the project or target, then click Build Settings.

  2. Find the build setting you want to configure.

    To quickly find a build setting, search for the build setting or filter build settings.

  3. If you want to configure the build setting for a particular build configuration, click the disclosure triangle to the left of the build setting.

    The available build configurations appear below.

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

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

    To display a popover editor, double-click a value of type string or string list.

Toggle between showing the build setting titles and names

Toggle between showing the build setting values and definitions

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