Xcode 15中如何让C++带引号的#include头文件被正确识别？

问题描述 #

在iOS Swift项目中集成遗留C代码，已成功搭建基础C框架模块并实现Swift调用，但遇到以下问题：

• 同目录下使用#include "Navigator.hpp"引入头文件时，Xcode提示'Navigator.hpp' file not found
• 终端用clang++或g++编译代码可正常通过
• 将Navigator.hpp设为public并使用#include <MyAPI/Navigator.hpp>可构建，但不想暴露所有私有头文件

项目结构 #

MyAPI (project)
   MyAPI (target)
      MyApi.hpp // public membership
      Navigator.hpp // project membership
      umbrella.h // public membership
      MyApi.cpp
      Navigator.cpp
      MyApi.modulemap

关键代码片段 #

MyApi.modulemap #

framework module MyAPI {
    umbrella header "umbrella.h"

    export *
    module * { export * }
}

MyApi.hpp #

#ifndef MyApi_hpp
#define MyApi_hpp

#include <stdio.h>
#include "Navigator.hpp"

class MyAPI {
    int updateRate;
    Navigator* nav;
    
public:
    MyAPI();
    
    int getUpdateRate() const;
    int getNavId() const;
};

#endif

报错信息 #

MyApi.hpp:12:10: 'Navigator.hpp' file not found

解决方案 #

1. 调整私有头文件的Target Membership #

选中Navigator.hpp，在右侧Xcode检查器的Target Membership区域，将其从"Project"改为MyAPI target的Private选项。这样Xcode会将该头文件归类为框架私有资源，编译时自动纳入私有头文件搜索路径。

2. 更新模块映射文件（modulemap） #

修改MyApi.modulemap，添加私有子模块声明，让Xcode能识别私有头文件的位置：

framework module MyAPI {
    umbrella header "umbrella.h"

    // 声明私有子模块，包含Navigator.hpp
    explicit module Private {
        private header "Navigator.hpp"
        export *
    }

    export *
    module * { export * }
}

3. 修正头文件导入路径 #

在MyApi.hpp中，将原导入语句替换为：

#include "Private/Navigator.hpp"

或使用模块导入方式：

#import <MyAPI/Private/Navigator.hpp>

补充说明：为何终端编译正常而Xcode失败？ #

终端编译时，clang++默认将当前执行目录作为头文件搜索路径，因此能找到同目录下的Navigator.hpp。但Xcode编译框架模块时，会严格遵循框架的结构规则和模块映射配置，不会默认将源码目录加入搜索路径，必须通过设置Target Membership或模块映射来明确私有头文件的位置。

内容的提问来源于stack exchange，提问作者FlyCodeRepeat