如何在Ubuntu上运行Java GUI应用

在 Ubuntu 上运行 Java GUI 应用的完整步骤

一 准备环境

• 安装 Java 运行环境或开发工具包（推荐 OpenJDK 11 或 OpenJDK 17）：
  • 更新索引并安装：sudo apt update & & sudo apt install openjdk-11-jdk（或 openjdk-17-jdk）
  • 验证版本：java -version、javac -version
• 若系统存在多个 Java 版本，使用 alternatives 选择默认版本：
  • 交互选择：sudo update-alternatives --config java（同理可配置 javac）
• 如使用 Oracle JDK，可从官网下载安装包或添加 PPA，再用 alternatives 切换默认版本。

二 运行打包好的 GUI 应用

• 对于可执行 JAR（包含 GUI 且已配置主类 Manifest）：
  • 终端执行：java -jar your-app.jar
  • 若报“没有主清单属性”，请在 JAR 的 Manifest 中指定 Main-Class，或用：java -cp your-app.jar 全限定主类名
• 示例：java -jar ~/Desktop/my-gui.jar。

三 从源码编译并运行 Swing 示例

• 编写示例文件 HelloSwing.java（使用 Swing，跨平台、无需额外依赖）：
  • 代码示例：
    • import javax.swing.*;
    • public class HelloSwing {
      • public static void main(String[] args) {
        • JFrame f = new JFrame(“Hello Swing”);
        • f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        • f.setSize(300, 200);
        • f.setLocationRelativeTo(null);
        • f.add(new JLabel(“Hello, Swing!”, SwingConstants.CENTER));
        • f.setVisible(true);
      • }
    • }
• 编译与运行：
  • javac HelloSwing.java
  • java HelloSwing

四 使用 JavaFX 的注意事项

• JavaFX 不在 OpenJDK 中，需单独下载 Gluon JavaFX SDK，运行时通过模块路径引入：
  • 下载解压至如 /opt/javafx-sdk-VERSION
  • 运行示例：java --module-path $PATH_TO_FX/lib --add-modules javafx.controls,javafx.fxml YourJavaFXApp
  • 或在编译/运行脚本中设置环境变量：export PATH_TO_FX=/opt/javafx-sdk-VERSION/lib。

五 远程或服务器环境常见问题与排查

• 出现错误：“No X11 DISPLAY variable was set …” 或 “Can’t connect to X11 window server …”
  • 说明需要 X11 显示。本地桌面会话可直接运行；远程 SSH 需开启 X11 转发：ssh -X user@host
  • 如仍失败，检查 $DISPLAY（常见为 :0 或 :1），必要时执行：export DISPLAY=:0
• 缺少 GUI 依赖库（在无头/最小化系统上偶发）：
  • 安装常见依赖：sudo apt install libx11-dev libxext-dev libxrender-dev libxtst-dev libxt-dev libfontconfig1-dev libxmu-dev libxi-dev libxinerama-dev libgtk2.0-dev
• 服务器无图形界面时，可临时安装桌面环境再运行 GUI：sudo apt install ubuntu-desktop 并重启（资源开销较大，仅用于测试）。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！