SceneBuilder无法从MavenCentral找到ControlsFX库的问题求助

问题描述 #

在SceneBuilder 8.5.0和20.0.0版本中均出现以下问题：无法通过MavenCentral搜索到ControlsFX库，也无法通过手动输入GroupId和ArtifactId选择对应版本，目前仅能通过下载JAR包并本地添加的方式引入。项目使用Maven管理该库，希望实现通过Maven直接导入SceneBuilder。

复现步骤 #

• 打开Scene Builder
• 进入Library Manager
• 点击「Search repositories」，输入controlsfx无结果
• 取消搜索后，点击「manually add library from repository」
• 输入GroupId: org.controlsfx、ArtifactId: controlsfx，无版本选项可选

已确认SceneBuilder可正常从MavenCentral找到其他库。

原因分析 #

1. SceneBuilder仓库索引同步问题：SceneBuilder内置的Maven仓库索引可能未及时同步ControlsFX的版本元数据，或者索引范围有限，导致无法检索到该库。
2. ControlsFX元数据适配问题：部分版本的ControlsFX在MavenCentral中的元数据未包含SceneBuilder识别所需的分类标签（如JavaFX相关分类），导致SceneBuilder无法识别并展示该库。

解决方法 #

方法1：手动指定版本号引入 #

在「manually add library from repository」界面，输入GroupId org.controlsfx、ArtifactId controlsfx后，手动填写项目使用的具体版本号（例如11.1.2、12.0.1），再点击确认即可尝试从MavenCentral拉取对应版本。

方法2：更新或添加自定义仓库索引 #

• 打开Library Manager，点击右上角的「Refresh」按钮（若存在），等待内置仓库索引更新完成后重新搜索。
• 若内置索引无效，可添加MavenCentral完整仓库地址：在Library Manager的仓库设置中，新增仓库地址https://repo1.maven.org/maven2/，保存后重新搜索ControlsFX。

方法3：通过项目Maven依赖同步 #

1. 确保项目的pom.xml中已正确声明ControlsFX依赖：

<dependency>
    <groupId>org.controlsfx</groupId>
    <artifactId>controlsfx</artifactId>
    <version>你的项目版本号</version>
</dependency>

2. 执行Maven命令下载依赖到本地：

mvn dependency:copy-dependencies

3. 在SceneBuilder的Library Manager中选择「Add Library/Folder」，指定上述命令生成的依赖目录（默认在target/dependency下），即可引入与项目版本一致的ControlsFX库。

方法4：IDE集成场景下自动同步 #

若在IDEA或Eclipse中使用SceneBuilder，无需单独在SceneBuilder中操作：打开FXML文件时，SceneBuilder会自动读取IDE中项目的Maven依赖，将ControlsFX纳入可用库列表。

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