Xcode SPM多Target重名问题：如何用moduleAliases解决Core命名冲突？

问题场景 #

项目引入两个Swift Package依赖：

.package(name: "Web3swift", url: "https://github.com/skywinder/web3swift.git", from: "3.0.6"),
.package(name: "Random", url: "https://github.com/vapor-community/random.git", .upToNextMinor(from: "1.2.0"))

其中Random依赖了一个名为Core的模块，而Web3swift自身也包含同名的Core Target，编译时触发报错：

multiple targets named 'Core' in: 'core', 'web3swift'; consider using the `moduleAliases` parameter in manifest to provide unique names

解决方案 #

通过Swift Package Manifest的moduleAliases参数给重名模块设置唯一别名，具体操作如下：

1. 给冲突依赖添加别名配置 #

在项目的Package.swift中，修改依赖声明，给其中一个包含重名Core的包添加moduleAliases。比如给Web3swift的Core模块设置别名Web3Core：

let package = Package(
    name: "YourProjectName",
    dependencies: [
        .package(
            name: "Web3swift", 
            url: "https://github.com/skywinder/web3swift.git", 
            from: "3.0.6"
        ).moduleAliases(["Core": "Web3Core"]),
        .package(
            name: "Random", 
            url: "https://github.com/vapor-community/random.git", 
            .upToNextMinor(from: "1.2.0")
        )
    ],
    // 其他项目配置...
)

也可以选择给Random依赖的Core设置别名，比如VaporCore：

.package(
    name: "Random", 
    url: "https://github.com/vapor-community/random.git", 
    .upToNextMinor(from: "1.2.0")
).moduleAliases(["Core": "VaporCore"])

2. 更新代码中的模块引用 #

把项目代码里原有的import Core语句，替换成对应的别名。比如原引用Web3swift的Core就改成import Web3Core，引用Random依赖的Core就改成import VaporCore。

3. 调整Target依赖配置（若有直接依赖） #

如果项目Target直接依赖了冲突的Core模块，需要在targets配置里把"Core"替换为设置好的别名：

.target(
    name: "YourTarget",
    dependencies: [
        .product(name: "web3swift", package: "Web3swift"),
        "Web3Core" // 替换原来的"Core"
    ]
)

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