如何让jpackage打包的Java控制台应用在Mac上双击/Spotlight启动

问题本质 #

Mac的.app包默认是为GUI应用设计的，双击或通过Spotlight启动时，系统不会自动为控制台程序分配终端窗口。你的Java程序虽然会启动，但因缺少标准输入输出的交互环境，会在“就绪”后立刻退出，这和你在控制台日志中看到的现象一致。而直接在终端运行可执行文件时，终端已提供了必要的交互环境，所以程序能正常运行。

解决方案 #

方案一：重新打包时配置jpackage生成带终端启动的.app #

1. 创建启动脚本start.sh，内容如下：

#!/bin/bash
cd "$(dirname "$0")"
# 用osascript唤起终端并运行程序，兼容性更好
osascript -e 'tell application "Terminal" to do script "'"$(pwd)/my-app"'"'

注意：将my-app替换为你实际的Java可执行文件名（即原.app/Contents/MacOS下的文件）

2. 给脚本添加执行权限：

chmod +x start.sh

3. 执行jpackage打包命令时，指定--launcher-script参数使用该脚本：

jpackage \
  --type app-image \
  --name my-app \
  --main-class 你的主类全路径 \
  --main-jar 你的应用jar包名.jar \
  --launcher-script start.sh \
  --dest 输出目录

打包完成后，将生成的.app移动到/Applications目录即可。

方案二：修改已安装的.app包 #

如果不想重新打包，可直接修改已安装的应用：

1. 右键点击/Applications/my-app.app，选择「显示包内容」，进入Contents/MacOS目录。
2. 将原有的可执行文件（比如my-app）重命名为my-app-core。
3. 在该目录下创建新的脚本文件my-app，内容如下：

#!/bin/bash
cd "$(dirname "$0")"
osascript -e 'tell application "Terminal" to do script "'"$(pwd)/my-app-core"'"'

4. 给新脚本添加执行权限：

chmod +x /Applications/my-app.app/Contents/MacOS/my-app

验证 #

修改完成后：

• 双击/Applications中的my-app.app图标，会自动弹出终端窗口并运行你的Java程序
• 通过Spotlight搜索my-app启动，同样会唤起终端并正常运行程序

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