JavaFX覆盖应用初始化与线程行为不符合预期问题排查

我开发了一个以覆盖层（overlay）形式运行的JavaFX应用，需求要求用Platform.startup()启动。最初的启动画面代码如下（Kotlin伪代码）：

class SplashScreen : Stage(StageStyle.TRANSPARENT) {
    init {
        isAlwaysOnTop = true

        // 创建根节点、配置界面等逻辑

        val scene = Scene(root, w, h)
        scene.fill = Color.TRANSPARENT

        this.scene = scene
    }
}

fun main() {
    System.setProperty("apple.awt.UIElement", "true")
    Platform.setImplicitExit(false) // 应用需求，禁止隐式退出
    Platform.startup {
        instance = SplashScreen().apply { show() }
    }
}

问题在于，在macOS环境中，JavaFX似乎完全忽略了apple.awt.UIElement属性，依然会创建系统菜单并把应用加入到应用切换面板中。但如果把Platform.startup()的调用放到新线程里，这个属性就能正常生效，应用可以按预期启动：

fun main() {
    System.setProperty("apple.awt.UIElement", "true")
    Thread {
        Platform.setImplicitExit(false) // 应用需求，禁止隐式退出
        Platform.startup {
            instance = SplashScreen().apply { show() }
        }
    }.start()
}

为什么会出现这种差异？按道理设置属性后JavaFX应该立刻识别才对。

原因分析 #

这是因为JavaFX在主线程初始化时，会提前初始化AWT相关的系统集成组件，而apple.awt.UIElement属性需要在AWT组件初始化之前设置才能生效。

• 在第一种写法中：主线程中先设置了系统属性，但紧接着调用Platform.startup()，JavaFX会在主线程同步初始化其内部的AWT桥接逻辑（用于和macOS系统交互），此时AWT已经完成初始化，后续设置的属性无法被读取，自然不会生效。
• 在第二种写法中：把Platform.startup()放到新线程后，主线程设置的apple.awt.UIElement属性会在新线程初始化JavaFX/AWT之前就被系统读取到，AWT初始化时会正确应用这个属性，从而隐藏系统菜单和应用切换面板的条目。

补充说明：apple.awt.UIElement本质是AWT的属性，JavaFX在macOS上依赖AWT实现系统级集成（比如菜单、Dock图标等），所以属性的生效时机严格绑定在AWT初始化之前。如果在AWT初始化后再设置，就不会有任何效果。

内容的提问来源于stack exchange，提问作者Xavier Rubio Jansana