公共Objective-C类导入本地包ABCorePackage头文件失败求助

本地包ABCorePackage的目录结构如下：

ABCorePackage
- ObjCSources
  - include
    - Maths.h (符号链接)
  - ABCore
    - Maths.h
    - Maths.m
- Package.Swift

在集成该本地包的项目中，公共权限的Objective-C类ViewController.h添加导入语句#import "Maths.h"时，触发编译错误：'Maths.h' file not found。但将ViewController.h改为项目级权限后，导入操作正常。

需求说明：必须保持ViewController.h为公共权限（需加入伞头供Swift文件调用），已尝试在伞头中使用#import <ABCorePackage/Maths.h>导入，但问题未解决。

1. 修正Package.swift的Target配置 #

Swift Package对Objective-C公共头文件的访问有明确路径要求，需在Package.swift中为目标模块指定公共头文件目录。找到对应Target的配置代码，添加或调整publicHeadersPath：

.target(
    name: "ABCorePackage",
    path: "ObjCSources",
    publicHeadersPath: "include" // 将include目录设为公共头文件根路径
)

include目录包含Maths.h的符号链接，只有通过这个配置，外部公共权限的文件才能识别到该头文件。

2. 采用模块式导入语法 #

公共权限的文件无法通过相对路径访问本地包的头文件，必须使用模块名+头文件的导入方式，在ViewController.h和伞头中统一写成：

#import <ABCorePackage/Maths.h>

避免使用#import "Maths.h"这种相对路径导入，仅项目级权限的文件才能通过项目的头文件搜索路径识别这种写法。

3. 验证符号链接有效性 #

检查include目录下的Maths.h符号链接是否指向正确路径，在终端进入ObjCSources/include目录，执行：

ls -l Maths.h

若链接失效，重新创建：

ln -s ../ABCore/Maths.h Maths.h

4. 清理缓存重新构建 #

缓存可能导致头文件识别异常，执行以下步骤：

• 关闭Xcode
• 删除项目的DerivedData目录（路径：~/Library/Developer/Xcode/DerivedData）
• 重新打开项目并执行构建操作

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