Xcode 11 Swift包管理器中C文件处理及包未识别问题排查

我来帮你一步步排查并解决这个Swift包无法被识别的问题，咱们从最基础的配置开始检查：

1. 确认Swift包的目录结构与Package.swift配置是否正确 #

你的包目录结构Math/CMath/Source/CMath存放源文件是合理的，但关键是Package.swift的配置必须正确关联这些文件，否则Xcode无法识别包内容。

请确保你的Package.swift是这样配置的（根据你的结构调整）：

// swift-tools-version: 5.9
import PackageDescription

let package = Package(
    name: "Math",
    // 对外暴露的库名称，必须和你import的名字完全一致
    products: [
        .library(
            name: "CMath",
            targets: ["CMath"]),
    ],
    targets: [
        .target(
            name: "CMath",
            // 指定源文件所在的路径，对应你的目录结构
            path: "CMath/Source/CMath",
            // 将C头文件设为公共，确保Swift能访问到C函数的声明
            publicHeadersPath: ".",
            // 列出所有源文件，留空则自动包含目录下所有文件
            sources: ["addDoubles.c", "addDoubles.h", "WrappedCFunctions.swift"]),
    ]
)

重点注意：

• products里的name必须和你在项目中写的import CMath完全匹配
• path要准确指向存放源文件的目录
• publicHeadersPath确保C头文件能被Swift目标正常访问

2. 检查主项目是否正确添加了Swift包依赖 #

很多时候包不被识别是因为主项目没正确关联这个本地包：

• 打开主项目，在Xcode左侧导航栏选中项目根节点
• 切换到Package Dependencies标签，点击+按钮
• 选择Add Local...，找到你的Math包的根目录（包含Package.swift的文件夹），点击Add
• 添加完成后，还要确保主项目的Target已引入CMath库：
  1. 选中主项目的Target（比如你的iOS App Target）
  2. 切换到General标签，找到Frameworks, Libraries, and Embedded Content
  3. 点击+，在弹出列表中找到CMath并添加

3. 清理Xcode缓存并重新构建 #

Xcode的缓存经常会导致奇怪的识别问题，咱们彻底清理一下：

• 按下Command + Shift + K清理项目构建缓存
• 打开Xcode的Settings（Command + ,），切换到Locations标签，点击Derived Data右侧的箭头，打开文件夹后删除对应项目的Derived Data文件夹
• 重启Xcode，然后重新构建主项目

4. 核对import语句与包暴露的库名称一致 #

最后再确认：你在ViewController.swift里写的import CMath，必须和Package.swift中products里的library名称完全匹配。比如如果products里的name是Math，那你就得写import Math，这点一定要对应上。

另外，你的WrappedCFunctions结构体和addDoubles方法都已经设置为public，这部分是正确的，只要包被正确识别，就能正常调用。

内容的提问来源于stack exchange，提问作者Heinz M.