JavaFX Gradle 插件中变体选择难题：终极解决指南

2024-03-13 19:06:04

JavaFX Gradle 插件中的变体选择难题：终极指南

简介

使用 JavaFX-Gradle 插件构建 JavaFX 应用程序时，你可能遇到一个常见的错误，无法从 Maven 仓库解析 org.openjfx:javafx-fxml:21 依赖项。这是因为该依赖项针对不同的操作系统和架构提供了多个变体，导致 Gradle 无法确定使用哪个变体。

问题根源

org.openjfx:javafx-fxml:21 依赖项提供了适用于不同操作系统的 JavaFX 运行时，如 Windows、macOS 和 Linux。此外，它还提供了适用于不同架构的变体，如 x86、x64 和 ARM。Gradle 需要知道你正在使用的特定操作系统和架构，以便选择正确的变体。

解决方法：使用 osConfiguration

为了解决此问题，你需要将 osConfiguration 配置应用到你的项目中。这将允许你指定与你正在使用的操作系统和架构相匹配的特定变体。

configurations {
    osConfiguration
}

然后，你需要配置 osConfiguration 中的属性，以指定操作系统的系列和架构。

configurations.osConfiguration {
    attributes {
        attribute(Usage.USAGE_ATTRIBUTE, objects.named(Usage, Usage.JAVA_RUNTIME))
        attribute(OperatingSystemFamily.OPERATING_SYSTEM_ATTRIBUTE, objects.named(OperatingSystemFamily, platform.osFamily))
        attribute(MachineArchitecture.ARCHITECTURE_ATTRIBUTE, objects.named(MachineArchitecture, platform.arch))
    }
}

其中 platform 是 org.openjfx.gradle.JavaFXPlatform 对象，它会自动检测你的操作系统和架构。

步骤演示

以下是如何在 Gradle 中设置 osConfiguration 的逐步演示：

添加 osConfiguration 配置：

configurations {
    osConfiguration
}

配置属性：

configurations.osConfiguration {
    attributes {
        attribute(Usage.USAGE_ATTRIBUTE, objects.named(Usage, Usage.JAVA_RUNTIME))
        attribute(OperatingSystemFamily.OPERATING_SYSTEM_ATTRIBUTE, objects.named(OperatingSystemFamily, platform.osFamily))
        attribute(MachineArchitecture.ARCHITECTURE_ATTRIBUTE, objects.named(MachineArchitecture, platform.arch))
    }
}

添加 JavaFX 依赖项：

dependencies {
    implementation 'org.openjfx:javafx-fxml:21'
}

结论

通过应用 osConfiguration 配置，你可以在 JavaFX-Gradle 插件中指定所需的 JavaFX 运行时变体。这将解决无法从 Maven 仓库解析 org.openjfx:javafx-fxml:21 依赖项的问题，并确保你的 JavaFX 应用程序可以在你的特定操作系统和架构上成功构建和运行。