---
title: Building your project with embedded shader sources
framework: xcode
role: article
role_heading: Article
path: xcode/building-your-project-with-embedded-shader-sources
---

# Building your project with embedded shader sources

Prepare to debug your project’s shaders by including source code in the build.

## Overview

Overview To debug your shaders in Xcode, configure your build to include shader source code by changing your project’s build settings. Select your project in the Project navigator, click the Build Settings tab, and search for the Produce Debugging Information setting in the Metal Compiler Build Options section. Then, change the setting’s Debug entry to “Yes, include source code.”

Alternatively, you can debug the shaders that you compile for release by generating a separate symbol file for each Metal library in your project. For more information on using this approach, see Generating and loading a Metal library symbol file. important: To ensure you don’t include debugging information in apps you ship to customers, be sure to reset the Produce Debugging Information for Release option to No when you finish debugging.

## See Also

### Project preparation for debugging

- [Naming resources and commands](xcode/naming-resources-and-commands.md)
- [Creating and using custom capture scopes](xcode/creating-and-using-custom-capture-scopes.md)