在Apache Felix中安装TornadoFX OSGi Bundle失败求助

我之前在基于OSGi构建JavaFX相关桌面应用时，也碰到过类似的Bundle安装失败问题，结合你用Apache Felix 5.6.10的场景，给你梳理几个关键排查点：

• 先抓具体错误信息
  别只停留在“安装失败”的模糊提示上，用Felix命令行执行 file:install -s <你的TornadoFX Bundle路径>，控制台会输出详细的错误日志——比如最常见的Unresolved requirement（依赖未解决），这是定位问题的核心。如果安装后Bundle处于Installed状态而非Active，可以用 diag <BundleID> 命令查看具体的依赖缺失详情。

• 验证Bundle与Felix的规范兼容性
  Apache Felix 5.6.10基于OSGi R6规范，你需要确认下载的TornadoFX OSGi Bundle是否兼容R6。如果TornadoFX Bundle使用了OSGi R7及以上的API（比如模块化相关的新特性），Felix 5.x会无法识别，直接导致安装失败。可以打开Bundle的MANIFEST.MF文件，查看Bundle-ManifestVersion和Require-Capability字段，确认规范版本匹配。

• 检查JavaFX依赖Bundle是否齐全且版本匹配
  TornadoFX依赖JavaFX，而JavaFX本身需要OSGi化的Bundle才能在Felix环境中运行。你需要确保已经安装了对应版本的JavaFX OSGi Bundle（比如javafx.base、javafx.controls、javafx.fxml等核心模块），并且版本要和TornadoFX依赖的JavaFX版本完全一致——比如TornadoFX 1.7.x系列依赖JavaFX 11+，就不能混用JavaFX 8的Bundle。

• 确认依赖Bundle的运行状态
  用lb命令检查所有必备Bundle的状态，必须确保它们都处于Active状态，而不是Resolved或Installed。有些依赖Bundle可能因为自身的依赖问题没有启动，这会直接导致后续安装的TornadoFX Bundle无法解析依赖。

• 检查Bundle文件完整性
  偶尔会碰到下载的Bundle损坏的情况，你可以用 jar tf <TornadoFX Bundle文件路径> 命令查看Bundle内部结构，确认存在META-INF/MANIFEST.MF文件，且文件中的Import-Package、Bundle-SymbolicName等关键字段没有语法错误。

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