---
title: Identifying and addressing framework module issues
framework: xcode
role: article
role_heading: Article
path: xcode/identifying-and-addressing-framework-module-issues
---

# Identifying and addressing framework module issues

Detect and fix common problems found in framework modules with the module verifier.

## Overview

Overview When you create a framework containing Objective-C, Objective-C++, C, or C++ code that you distribute to customers, clients, or other developers, it’s often challenging and time-consuming to find problems in your framework that don’t appear at build time. In Xcode version 14.3 or later, enable the module verifier in your Xcode project’s build settings so that you can identify and address problems with your framework module before you distribute it. Some examples of these problems include: Missing header references in your umbrella header Using quoted includes instead of angle-bracketed includes Using @import syntax in your public and private headers Incorrect target conditionals Imports inside of extern "C" language linkage specification Non-modular headers in your umbrella header References to private headers from public headers When you enable the module verifier, it finds module problems in your code and displays errors for them in Xcode’s Issue navigator, just like compiler errors or warnings. Enable the module verifier build setting In your Xcode project, select your framework’s target, then select the Build Settings tab. Scroll down to the Apple Clang Module Verifier section. For new projects created in Xcode 14.3 or later, the Enable Module Verifier setting defaults to Yes. For projects you created in earlier versions of Xcode, change the setting to Yes.

Then, check the values for Supported Languages and Supported Language Dialects, and update them to match your project’s requirements. View Quick Help for each setting to find valid values. For more information about configuring build settings, see Configuring the build settings of a target. Build your project and identify issues In Xcode, build your project, then show the Issue navigator to see issues in your project. Module verifier issues show up as errors in the Issue navigator.

Review the issues, then click on an issue to highlight it in your source code. Address common issues Identify each issue you find by matching it with an example error message in the following table. Then, use the error resolution examples to help you address the issue in your code.  |   |   |   |   |   |   |   |

## See Also

### Build settings

- [Configuring the build settings of a target](xcode/configuring-the-build-settings-of-a-target.md)
- [Adding a build configuration file to your project](xcode/adding-a-build-configuration-file-to-your-project.md)
- [Build settings reference](xcode/build-settings-reference.md)
- [Understanding build product layout changes in Xcode](xcode/understanding-build-product-layout-changes.md)