Add a build configuration (xcconfig) file

Add a Configuration Settings File to your project to allow build settings to be edited outside of Xcode.

Add a build configuration (xcconfig) file

  1. Select File > New File.

  2. Select Configuration Settings File.

  3. Click Next.

  4. Click Create.

    You do not need to click any Target checkboxes.

    A [SpecifiedFileName].xcconfig file is added to your project.

  5. Map a configuration settings file to a build configuration in your project.

  6. Edit the new configuration file. See Configuration Settings File (xcconfig) format.

Map a configuration settings file to a build configuration

  1. Select your project in the project editor.

  2. Click Info at the top of the project editor.

  3. Click the disclosure triangle to expand a build configuration in the Configurations area.

  4. To expand a project and reveal available targets, click the disclosure triangle.

  5. Choose a configuration settings file from the pop-up button for the desired project or target.

Drag build settings into a configuration settings file

  1. Open the Build Settings pane in the project editor.

  2. Open the assistant editor.

  3. If the configuration settings file isn’t displayed in the assistant editor, use the jump bar in the assistant editor to display it.

  4. Select a build setting in the Build Settings pane and drag it into the configuration settings file in the assistant editor.

    The build setting is inserted into the configuration settings file.

See alsoWhat is a build setting?What is the build system?Configuration Settings File (xcconfig) formatBuild settings referenceEvaluate build setting value inheritance