JDK 构建时 configure 找不到外部依赖库怎么用 --with-freetype、--with-x 等参数指定路径【免费下载链接】jdkJDK main-line development https://openjdk.org/projects/jdk项目地址: https://gitcode.com/GitHub_Trending/jd/jdk在 Linux 上从头构建 JDK 时bash configure是第一个可能卡住的环节如果 FreeType、X11、CUPS 这类外部依赖没有被自动找到configure会直接退出并报Could not find ...错误。这篇文章给出 doc/building.md 中External Library Requirements和Running Configure两节描述的解决路径用--with-LIBpath或--with-LIB-include/--with-LIB-lib形式的参数把依赖库的实际位置指给configure重新运行后让配置步骤通过继续执行make。configure 自动探测失败时的两种指定方式configure会先尝试自动定位各组件全部找到时不需要任何额外参数某个组件没被自动找到时它会退出并说明问题。文档建议失败时多数情况下它会打印如何在当前平台解决的建议按提示处理后重新运行bash configure即可。需要手动指定路径时doc/building.md 给出了两种等价的写法bash configure --with-LIBpath这种写法更简洁但要求头文件和库文件都位于该目录下的默认层级结构中。如果依赖不是标准安装布局用第二种形式分别指向 include 目录和 lib 目录bash configure --with-LIB-includepath to include --with-LIB-libpath to lib下面以 FreeType 和 X11 两个最常见的缺失依赖为例说明具体参数。指定 FreeType 路径--with-freetype-include 与 --with-freetype-lib在 FreeType 没有被自动定位时使用bash configure --with-freetype-includeinclude 目录 --with-freetype-liblib 目录两个参数的取值对象依据 make/autoconf/lib-freetype.m4 中的检查逻辑--with-freetype-include指向直接包含ft2build.h的目录或者包含freetype2子目录其内有ft2build.h的目录--with-freetype-lib指向包含 freetype 共享库文件libfreetype加上平台后缀的目录。例如 FreeType 被安装在/opt/freetype下文中所有示例路径都只是占位请替换为你机器上 FreeType 的实际位置bash configure \ --with-freetype-include/opt/freetype/include \ --with-freetype-lib/opt/freetype/lib使用这两个参数时有三条硬性规则违反时configure会直接报错必须同时给或同时不给只指定其中一个会报Must specify both or neither of --with-freetype-include and --with-freetype-lib与 bundled 互斥--with-freetypebundled不能再搭配--with-freetype-include或--with-freetype-lib指定路径后会被校验路径下找不到可用的头文件或库时报Can not find or use freetype at location given by --with-freetype-lib|include。可选分支改用 bundled FreeType。如果本机没有可用的系统 FreeType在 Linux 上也可以改为使用 JDK 仓库自带的副本bash configure --with-freetypebundled。doc/building.md 说明 FreeType 在多数平台并非必需唯一例外是 Unix 平台配置为引用系统安装的库时按 make/autoconf/lib-freetype.m4 的定义Linux 默认使用 systemWindows 和 macOS 则只能使用 bundled在 Mac/Windows 上要求 system 会报Only bundled freetype can be specified on Mac and Windows。注意一个文档内部的冲突doc/building.md 的参数列表和示例如bash configure --with-freetype/cygdrive/c/freetype-i586 --with-target-bits32把--with-freetypepath描述为直接指向 FreeType 目录但 make/autoconf/lib-freetype.m4 中该参数只接受system和bundled两个取值传入其他值会报Valid values for --with-freetype are system and bundled。两处说法不一致因此本文推荐用--with-freetype-include/--with-freetype-lib指定路径运行前可用bash configure --help查看当前 configure 实际接受的参数定义。指定 X11 路径--with-x某些 X11 库和头文件在 Linux 上是必需的configure未正确定位时用--with-xpathbash configure --with-x/opt/x11依据 make/autoconf/lib-x11.m4path是一个基础目录configure默认在其下查找头文件path/include库文件path/lib如果头文件和库不在这样的标准子目录下可以显式覆盖这两个位置bash configure \ --with-x/opt/x11 \ --x-includes/opt/x11/include \ --x-libraries/opt/x11/lib一个边界情况构建 headless JDK 时不需要 X11此时传入--with-x只会被忽略并打印警告X11 is not used, so --with-x is ignored不会报错。其他常用的依赖路径参数同一节文档还列出了这些外部依赖的指定参数用法与上面一致路径均为示例占位替换为你的实际位置依赖指定参数CUPS除 Windows 外必需--with-cupspathALSALinux 上必需含 headless 构建--with-alsapathlibffi构建 Hotspot 的 Zero 变体时必需--with-libffipathX11Linux 上必需--with-xpath多个依赖同时缺失时可以在同一条命令中组合指定例如bash configure \ --with-freetype-include/opt/freetype/include \ --with-freetype-lib/opt/freetype/lib \ --with-x/opt/x11 \ --with-cups/opt/cups如果缺失的依赖只是没装开发包文档对每个库都给出了对应的安装命令如 apt 系的sudo apt-get install libfreetype6-dev、X11 的libx11-dev libxext-dev libxrender-dev libxrandr-dev libxtst-dev libxt-dev安装后直接重跑bash configure不需要任何--with-*参数。验证配置是否通过configure成功时会在源码目录下创建一个构建树目录文档中的典型名称形如build/linux-x64-server-release并在输出中打印各项检测结果。针对本文的两个依赖可以对照检查FreeType 被指定路径命中时会打印类似Found freetype include files at 目录 using --with-freetype最后输出Using freetype: system或bundled没有再出现Could not find ...错误、configure正常结束且生成了构建树目录即表示配置通过。随后按常规流程构建并验证产物make images ./build/*/images/jdk/bin/java -version如果configure仍然失败对照以下文档中真实存在的错误信息定位均来自 make/autoconf/lib-freetype.m4 和 make/autoconf/lib-x11.m4错误信息含义Must specify both or neither of --with-freetype-include and --with-freetype-lib两个 freetype 路径参数只给了一个Can not find or use freetype at location given by --with-freetype-lib|include指定位置下找不到ft2build.h或 freetype 共享库Could not find freetype!自动探测与指定路径都失败Could not find X11 libraries.X11 库文件未被找到Could not find all X11 headers (shape.h Xrender.h Xrandr.h XTest.h Intrinsic.h).X11 头文件不齐Only bundled freetype can be specified on Mac and Windows在 Mac/Windows 上要求了 system FreeType两个容易踩的边界交叉编译时指向的库必须属于目标平台。文档明确提醒用--with-alsa、--with-x等指向的库要是target平台的不是build平台的并且不要误覆盖构建机自身的同名库。如果通过--with-sysroot提供了 sysrootFreeType 的自动探测会跳过 pkg-config改到 sysroot 下的标准位置查找。重新运行即可无需清理。指定路径后直接重跑bash configure如果之前已经生成过配置而行为异常可参考文档中Running make doctor一节的诊断流程但针对依赖路径问题通常修正参数重跑configure就能通过。【免费下载链接】jdkJDK main-line development https://openjdk.org/projects/jdk项目地址: https://gitcode.com/GitHub_Trending/jd/jdk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考