MacOS下JavaFX应用系统菜单栏实现及桌面事件处理咨询

我完全理解你碰到的这个痛点——JDK 9之后，macOS上的JavaFX应用菜单栏配置确实和之前不一样，踩过不少坑之后，整理出这两个核心步骤，结合我自己实践中发现的关键细节，应该能帮你解决问题：

1. 使用javapackager工具打包应用 #

javapackager是JDK自带的原生打包工具，它会自动处理macOS系统层面的菜单栏关联配置，确保应用菜单能正确挂载到系统顶部的菜单栏中。打包的基础命令示例如下：

javapackager -deploy -native image -srcdir ./build/classes -srcfiles com/yourpackage/YourMainClass.class -appclass com.yourpackage.YourMainClass -name "YourAppName" -outdir ./dist -outfile YourAppName

执行这个命令后，会生成一个标准的macOS .app 应用包，里面已经包含了菜单栏正常工作的基础配置。

2. 通过java.awt.desktop API实现系统菜单事件处理器 #

对于About、Preferences、FileOpen、Print这些系统级菜单事件，需要通过java.awt.desktop包下的API注册对应的处理器。这里有个非常关键的实践细节：必须在主线程（而非JavaFX的Application线程）中获取Desktop单例实例，否则很可能出现事件不响应、菜单栏无显示的问题。

示例代码参考：

import java.awt.Desktop;
import java.awt.desktop.AboutHandler;
import java.awt.desktop.PreferencesHandler;
import java.awt.desktop.OpenFilesHandler;
import java.awt.desktop.PrintFilesHandler;
import javafx.application.Platform;

public class DesktopMenuHandler {
    public static void setupHandlers() {
        // 确保在主线程执行此逻辑
        if (Desktop.isDesktopSupported()) {
            Desktop desktop = Desktop.getDesktop();
            
            // 注册About事件处理器
            if (desktop.isSupported(Desktop.Action.ABOUT)) {
                desktop.setAboutHandler(e -> {
                    // UI操作必须切回JavaFX线程
                    Platform.runLater(() -> showAboutWindow());
                });
            }
            
            // 注册Preferences事件处理器
            if (desktop.isSupported(Desktop.Action.PREFERENCES)) {
                desktop.setPreferencesHandler(e -> {
                    Platform.runLater(() -> showPreferencesWindow());
                });
            }
            
            // 注册FileOpen事件处理器
            if (desktop.isSupported(Desktop.Action.OPEN_FILE)) {
                desktop.setOpenFileHandler(e -> {
                    Platform.runLater(() -> handleOpenedFiles(e.getFiles()));
                });
            }
            
            // 注册Print事件处理器
            if (desktop.isSupported(Desktop.Action.PRINT_FILE)) {
                desktop.setPrintFileHandler(e -> {
                    Platform.runLater(() -> handlePrintFiles(e.getFiles()));
                });
            }
        }
    }
    
    // 以下为示例方法，根据你的应用需求实现具体逻辑
    private static void showAboutWindow() {
        // 打开关于窗口的逻辑
    }
    
    private static void showPreferencesWindow() {
        // 打开偏好设置窗口的逻辑
    }
    
    private static void handleOpenedFiles(java.util.List<java.io.File> files) {
        // 处理打开的文件列表
    }
    
    private static void handlePrintFiles(java.util.List<java.io.File> files) {
        // 处理文件打印逻辑
    }
}

在应用启动时，要先在main方法（主线程）中调用处理器配置，再启动JavaFX应用：

import javafx.application.Application;

public class Main {
    public static void main(String[] args) {
        // 先在主线程完成Desktop处理器配置
        DesktopMenuHandler.setupHandlers();
        // 再启动JavaFX应用
        Application.launch(YourJavaFXApplication.class, args);
    }
}

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