Ubuntu上Java编译依赖怎么处理

Ubuntu上Java编译依赖处理指南

一 区分两类依赖

• 应用项目依赖：指项目代码运行所需的第三方库（如 JUnit、Guava、Jackson 等），通常通过 Maven/Gradle 在构建时自动下载与管理，无需在系统层面安装对应的 -dev 包。
• 编译环境依赖：指用于运行 javac/jar 的 JDK，以及编译本地代码或构建 OpenJDK 时需要的系统库与工具链（如 libfreetype6-dev、libcups2-dev、libx11-dev、libasound2-dev、libffi-dev、autoconf 等）。这类依赖需通过 APT 安装到系统。

二 应用项目的依赖处理

• 使用构建工具
  • Maven：在 pom.xml 中声明依赖并执行 mvn compile 或 mvn package 自动解析与下载依赖。
  • Gradle：在 build.gradle 中声明依赖并执行 gradle build 自动解析与下载依赖。
• 系统级库的取舍
  • 纯 Java 依赖由构建工具管理，一般不需要在 Ubuntu 上安装额外的 -dev 系统库。
  • 若依赖包含 JNI 或需要调用本地库，才需在系统层面安装对应的 -dev 包，并在构建脚本中正确设置 -Djava.library.path 或 LD_LIBRARY_PATH。

三 编译OpenJDK时的依赖处理

• 安装基础工具与编译依赖
  • 更新索引并安装基础工具：sudo apt update && sudo apt install -y build-essential autoconf zip
  • 安装图形/打印/音频/字体等依赖（按需精简）：
    • sudo apt install -y libfreetype6-dev libcups2-dev
    • sudo apt install -y libx11-dev libxext-dev libxrender-dev libxrandr-dev libxtst-dev libxt-dev
    • sudo apt install -y libasound2-dev libffi-dev libfontconfig1-dev
• 准备 Bootstrap JDK
  • 编译 OpenJDK N 通常需要安装 N-1 的可运行 JDK 作为引导（Boot JDK）。例如编译 OpenJDK 12 建议使用 JDK 11；编译 OpenJDK 16 建议使用 JDK 15。
  • 安装示例：sudo apt install openjdk-11-jdk（用于编译 OpenJDK 12 场景）。
• 配置与编译
  • 在源码根目录执行：bash configure 检查依赖与环境；根据提示安装缺失项。
  • 编译：make images（或根据需要执行 make）。
• 常见问题与提示
  • 若 configure 报缺 fontconfig 等，安装 libfontconfig1-dev 后重试。
  • 在 VMware 共享文件夹中编译可能因文件系统不支持符号链接而失败，建议将源码移至虚拟机本地磁盘再编译。

四 快速排查清单

• 命令未找到或版本不对：执行 sudo apt install openjdk-17-jdk（或所需版本），然后用 java -version / javac -version 验证；必要时在 ~/.bashrc 或 /etc/environment 中设置 JAVA_HOME 并 source 使其生效。
• 构建工具不可用：安装 Maven/Gradle 并执行 mvn -version / gradle -version 验证。
• 本地库加载失败：确认依赖的 JNI 库已安装，并在运行时设置 -Djava.library.path= 指向库目录，或配置 LD_LIBRARY_PATH。
• OpenJDK 编译 configure 失败：按报错安装缺失的 -dev 包（如 libfreetype6-dev、libcups2-dev、libx11-dev、libasound2-dev、libffi-dev、libfontconfig1-dev），再重试；确保已准备正确版本的 Bootstrap JDK。