如何在多平台多项目 Kotlin 构建中将依赖项添加到另一个项目的测试
How to add dependencies to tests of another project in a multi-platform multi-project Kotlin build
我有一个多平台 Kotlin 项目,其中包含多个模块(子项目)。 Kotlin 的 Building Multiplatform Projects with Gradle 文档清楚地展示了如何设置模块之间的项目依赖关系:
kotlin {
sourceSets {
commonMain {
dependencies {
// All of the compilations that include source set 'commonMain'
// will get this dependency resolved to a compatible target, if any:
api project(':foo-lib')
}
}
}
}
我现在面临的问题是,虽然这篇文章记录了如何将一个模块(其所有目标平台)的依赖项添加到另一个模块(其相应的目标平台),但它没有阐明 如何将依赖项添加到另一个模块的测试源。
我希望这是一个相当常见的用例。例如,我想这样做的原因之一是我的模块 A 的测试源包含存根 classes。模块 B 依赖于模块 A,包括模块 A 的测试源中为其提供测试存根的 class 定义。因此,模块 B 的测试可能希望重用在测试模块 A 的来源。
多项目构建中的一个常见建议是将此类测试源移动到另一个模块,但这对我来说似乎没有必要。在我看来更简洁的解决方案 exist for normal multi-project builds,但我无法弄清楚如何在多平台多项目 Kotlin 构建中配置与此等效的解决方案,该构建也依赖于展示的 Kotlin Gradle DSL在上面的代码中。
要在单平台项目之间建立这种依赖关系,您通常需要在生产者项目中创建一个 Gradle Configuration
,将测试编译输出或测试 JAR 添加到该配置,并且在消费者项目中,依赖于该配置(即添加 project(...)
依赖项 with an explicit configuration or, more preferrable, add attributes to ensure that Gradle chooses the test-outputs configuration in variant-aware dependency resolution)。
但是,所有这些都需要将测试编译成可以被消费者项目的公共源集重用的形式。对于 Kotlin Multiplatform 项目,情况还不是这样。虽然参与已发布编译的 production 公共源集被编译为 Kotlin 元数据(*.kotlin_metadata
文件),但测试源和其他类型的未发布代码尚未编译转换为该格式。
相反,测试目前仅编译为最终特定于平台的二进制文件(即 *.class
文件、*.js
、本机二进制文件),不能用于公共源分析。
因此,尚不支持此类依赖项。这在未来可能会改变。请在 Kotlin 问题跟踪器中关注此问题:KT-35073.
我有一个多平台 Kotlin 项目,其中包含多个模块(子项目)。 Kotlin 的 Building Multiplatform Projects with Gradle 文档清楚地展示了如何设置模块之间的项目依赖关系:
kotlin {
sourceSets {
commonMain {
dependencies {
// All of the compilations that include source set 'commonMain'
// will get this dependency resolved to a compatible target, if any:
api project(':foo-lib')
}
}
}
}
我现在面临的问题是,虽然这篇文章记录了如何将一个模块(其所有目标平台)的依赖项添加到另一个模块(其相应的目标平台),但它没有阐明 如何将依赖项添加到另一个模块的测试源。
我希望这是一个相当常见的用例。例如,我想这样做的原因之一是我的模块 A 的测试源包含存根 classes。模块 B 依赖于模块 A,包括模块 A 的测试源中为其提供测试存根的 class 定义。因此,模块 B 的测试可能希望重用在测试模块 A 的来源。
多项目构建中的一个常见建议是将此类测试源移动到另一个模块,但这对我来说似乎没有必要。在我看来更简洁的解决方案 exist for normal multi-project builds,但我无法弄清楚如何在多平台多项目 Kotlin 构建中配置与此等效的解决方案,该构建也依赖于展示的 Kotlin Gradle DSL在上面的代码中。
要在单平台项目之间建立这种依赖关系,您通常需要在生产者项目中创建一个 Gradle Configuration
,将测试编译输出或测试 JAR 添加到该配置,并且在消费者项目中,依赖于该配置(即添加 project(...)
依赖项 with an explicit configuration or, more preferrable, add attributes to ensure that Gradle chooses the test-outputs configuration in variant-aware dependency resolution)。
但是,所有这些都需要将测试编译成可以被消费者项目的公共源集重用的形式。对于 Kotlin Multiplatform 项目,情况还不是这样。虽然参与已发布编译的 production 公共源集被编译为 Kotlin 元数据(*.kotlin_metadata
文件),但测试源和其他类型的未发布代码尚未编译转换为该格式。
相反,测试目前仅编译为最终特定于平台的二进制文件(即 *.class
文件、*.js
、本机二进制文件),不能用于公共源分析。
因此,尚不支持此类依赖项。这在未来可能会改变。请在 Kotlin 问题跟踪器中关注此问题:KT-35073.