Xcode中Swift依赖包图标差异及无法运行测试的解决方法

• 齿轮图标：代表当前Scheme对应的是Swift包的普通库Target，这类Target没有关联可运行的单元测试配置，Xcode不会为它加载测试执行入口，所以无法直接运行单元测试。
• 建筑图标：代表当前Scheme对应的是配置完整的Swift包可测试Target，已经正确关联了对应的单元测试Target，构建、测试的执行链路完整，支持直接触发单元测试运行。

• 显示齿轮图标：目标Swift包已经被Xcode成功拉取解析，但它的单元测试Target没有被纳入当前主项目的Scheme配置范围，或是包自身的Package.swift没有正确关联库Target和测试Target，Xcode只能识别到库本体，找不到对应的测试入口。
• 显示建筑图标：Swift包的主Target、关联的单元测试Target都被Xcode正确识别，且已经被加入当前活跃Scheme的构建、测试列表，配置链路完整。
• 完全不在菜单展示：分两种常见情况：
  • 该包是其他依赖引入的传递性依赖，主项目没有显式声明对它的直接依赖，Xcode默认不会把传递依赖的Scheme暴露到顶层菜单
  • 包本身仅包含资源、纯代码聚合类的Target，没有独立可构建、可测试的Target，不会生成对应Scheme条目

1. 先校验Swift包自身的配置：打开包的Package.swift文件，确认需要测试的库Target已经被关联到对应的测试Target，正确的配置参考如下：

let package = Package(
    name: "YourPackage",
    products: [
        .library(name: "YourLib", targets: ["YourLib"])
    ],
    targets: [
        .target(name: "YourLib"),
        // 必须在测试Target的依赖中声明主库Target，否则Xcode无法识别关联关系
        .testTarget(name: "YourLibTests", dependencies: ["YourLib"])
    ]
)

2. 回到Xcode主项目，点击顶部Scheme栏，选择「Manage Schemes」打开Scheme管理面板。
3. 在面板列表中找到显示齿轮图标的目标Swift包条目，勾选它右侧的「Show」选项；再点击面板左下角的+按钮，在弹出的Target选择列表中找到该包对应的单元测试Target，将其添加到Scheme列表中。
4. 关闭Scheme管理面板，再次点击顶部Scheme栏找到目标Swift包的条目，按住Option键点击条目进入Scheme编辑页，切换到「Test」标签，点击左下角的+按钮，将该包对应的单元测试Target添加到测试列表中，勾选测试Target旁的启用复选框。
5. 清理构建缓存：按下快捷键Shift + Command + K清理构建文件夹，再右键点击项目导航栏的「Package Dependencies」条目，选择「Resolve Package Versions」重新解析依赖，等待Xcode加载完成后，对应包的Scheme就会显示为建筑图标，可正常运行单元测试。

如果是间接引入的传递依赖，需要先在主项目的Package Dependencies中显式添加对该Swift包的直接依赖，否则Xcode不会开放它的Scheme编辑和测试权限。

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