集成含本地Swift Package的远程Swift包：如何避免invalidManifestFormat错误

该报错是Swift Package Manager的路径解析规则设计导致的，不属于SPM缺陷：
当lib作为远程依赖导入主应用时，SPM解析lib的Package.swift中的路径依赖时，默认锚点是主应用项目的根目录，而非远程拉取到缓存中的lib包的根目录。此前写的CursorPackage/./CursorPackage都会被解析为主应用根目录下的对应路径，自然找不到lib包内的子包，因此抛出路径无效错误。

• 最优方案：使用Swift编译时字面量#filePath锚定当前Package.swift的路径，拼接子包的相对路径，示例配置如下：

// lib的Package.swift配置
let package = Package(
    name: "lib",
    dependencies: [
        // #filePath指向当前Package.swift的绝对路径，拼接相对路径指向同仓库下的子包
        .package(path: "\(#filePath)/../CursorPackage")
    ],
    targets: [
        // 原有target配置保持不变
        .target(
            name: "lib",
            dependencies: [.product(name: "CursorPackage", package: "CursorPackage")]
        )
    ]
)

该配置不需要额外环境变量、不需要硬编码路径，无论lib是本地导入还是作为远程依赖被拉取，都能正确定位到同仓库内的子包，适配CI环境。

• 若子包可独立复用：给每个子包单独创建公开git仓库、打版本标签，在lib中用远程依赖的方式引用子包，完全抛弃路径依赖。
• 本地开发适配场景：可以在Package.swift中读取自定义环境变量做判断，本地开发时使用路径依赖，发布时切换为远程依赖，适合需要频繁修改子包的开发阶段。

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