Kotlin MPP变体选择失败求助：依赖冲突排查

问题背景 #

我有两个相互依赖的Kotlin多平台项目（Flowchart 依赖 Beans）：

• Beans项目包含两个JVM变体：一个未设置view属性，另一个将view属性设为"javafx"
• Flowchart项目包含三个JVM变体：默认JVM、view属性为"swing"的变体、view属性为"javafx"的变体

其中Flowchart的默认和swing变体运行正常，但javafx变体出现属性匹配错误，无法在Beans的多个变体中自动选择匹配度最高的javafx变体。曾尝试将Beans的默认变体view属性设为空，但会导致Flowchart其他变体出现同样的选择问题。

Beans项目Gradle配置 #

kotlin {
    jvmToolchain(11)

    jvm()
    jvm("javafx") {
        attributes.attribute(viewAttribute, "javafx")
    }

    sourceSets {
        val commonMain by getting
        val plainMain by creating
        val javafxMain by getting {
            dependencies {
                api("org.openjfx:javafx-base:$javafxVersion:$javafxPlatform")
                api("org.fxmisc.easybind:easybind:1.0.3")
            }
        }
        val jvmMain by getting {
            dependsOn(plainMain)
        }
    }
}

Flowchart项目Gradle配置 #

kotlin {
    jvmToolchain(11)

    jvm()

    jvm("swing") {
        attributes.attribute(viewAttribute, "swing")
    }

    jvm("javafx") {
        attributes.attribute(viewAttribute, "javafx")
    }

    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation("de.fluxparticle:beans:3.3-SNAPSHOT")
            }
        }
        val javafxMain by getting {
            dependencies {
                api("org.openjfx:javafx-graphics:$javafxVersion:$javafxPlatform")
                api("org.openjfx:javafx-base:$javafxVersion:$javafxPlatform")
            }
        }
    }
}

解决方案 #

问题根源在于Gradle的变体匹配逻辑中，未设置属性的变体不会自动兼容属性不匹配的场景，同时API/Runtime变体的存在会增加匹配复杂度。可通过以下两种方式解决：

方案1：为Beans的默认JVM变体设置view属性默认值 #

修改Beans项目的默认JVM变体配置，显式设置view属性为通用值（如"plain"），这样Flowchart的非javafx变体可匹配到该默认变体，javafx变体则优先匹配Beans的javafx变体：

kotlin {
    jvmToolchain(11)

    jvm {
        // 为默认JVM变体设置view属性默认值
        attributes.attribute(viewAttribute, "plain")
    }
    jvm("javafx") {
        attributes.attribute(viewAttribute, "javafx")
    }

    // 其余sourceSets配置保持不变
}

方案2：为Flowchart不同变体指定对应Beans变体 #

通过Gradle的变体感知依赖配置，为Flowchart每个变体明确指定对应的Beans变体，消除自动匹配歧义：
修改Flowchart项目的依赖配置：

sourceSets {
    val commonMain by getting
    // 默认JVM变体依赖Beans默认变体
    val jvmMain by getting {
        dependencies {
            implementation("de.fluxparticle:beans:3.3-SNAPSHOT") {
                attributes {
                    attribute(viewAttribute, "plain") // 对应Beans默认变体的属性值
                }
            }
        }
    }
    // swing变体依赖Beans默认变体
    val swingMain by getting {
        dependencies {
            implementation("de.fluxparticle:beans:3.3-SNAPSHOT") {
                attributes {
                    attribute(viewAttribute, "plain")
                }
            }
        }
    }
    // javafx变体依赖Beans的javafx变体
    val javafxMain by getting {
        dependencies {
            implementation("de.fluxparticle:beans:3.3-SNAPSHOT") {
                attributes {
                    attribute(viewAttribute, "javafx")
                }
            }
            api("org.openjfx:javafx-graphics:$javafxVersion:$javafxPlatform")
            api("org.openjfx:javafx-base:$javafxVersion:$javafxPlatform")
        }
    }
}

额外注意事项 #

• 确保viewAttribute在两个项目中统一定义（如通过Attribute.of("view", String::class.java)），避免属性不匹配
• 使用方案1时，Flowchart的默认和swing变体的view属性要么不设置，要么设为与Beans默认变体一致的"plain"值，保证匹配优先级正确

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