JavaFX开发：Mac Dock图标悬停时自定义名称的实现方法

问题场景 #

用JavaFX开发聊天应用，已通过代码修改Mac Dock图标，但stage.setTitle()仅能修改窗口标题，无法改变Dock图标悬停时显示的默认“java”名称。

解决方案 #

1. 设置系统属性（最简代码级方案）

在main方法最开头添加系统属性配置，必须在JavaFX应用启动前执行：

public class Main extends Application {
    public static void main(String[] args) {
        // 设置Mac Dock显示的应用名称
        System.setProperty("apple.awt.application.name", "你的聊天应用名称");
        launch(args);
    }

    // 你的start方法等业务代码...
}

该属性会直接告知Mac OS应用的正式名称，Dock悬停时将显示此值。

2. 使用苹果专属AWT API（兼容旧版Java）

若系统属性方案不生效，可调用苹果原生API设置Dock名称：

import com.apple.eawt.Application;

public class Main extends Application {
    public static void main(String[] args) {
        // 仅在Mac系统下执行，避免跨平台报错
        if (System.getProperty("os.name").toLowerCase().contains("mac")) {
            try {
                Application.getApplication().setDockIconName("你的聊天应用名称");
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
        launch(args);
    }

    // 你的start方法等业务代码...
}

注意：此API为Mac专属，非Mac环境需做系统判断，避免抛出类找不到的异常。

3. 打包时配置（正式发布推荐）

若使用jpackage或jlink打包应用，直接在打包参数中指定应用名称，无需修改代码：

• 使用jpackage时添加参数：

jpackage --name "你的聊天应用名称" --main-jar your-app.jar ...其他打包参数

打包后的应用会自动将Dock显示名称设置为指定值，这是生产环境最规范的处理方式。

注意事项 #

• 系统属性必须在launch(args)之前设置，否则可能不生效。
• 模块化项目中，需确保java.desktop模块被包含在module-info.java中：

requires java.desktop;

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