JetBrains Runtime（JBR）构建指南：从源码到可验证的第一版产物

JetBrains RuntimeJBR构建指南从源码到可验证的第一版产物【免费下载链接】JetBrainsRuntimeRuntime environment based on OpenJDK for running IntelliJ Platform-based products on Windows, macOS, and Linux项目地址: https://gitcode.com/gh_mirrors/je/JetBrainsRuntimeJetBrains RuntimeJBR是基于 OpenJDK 的 Java 运行时环境用于在 Windows、macOS 和 Linux 上运行 IntelliJ 平台产品线。本文面向想从源码构建、定制或排查 JBR 的开发者说明它的适用边界、最短构建路径、关键参数含义以及构建后如何验证产物是否符合预期。先判断你是否需要动手构建 JBR如果你只是使用 IntelliJ 系 IDEIDE 自带的运行时已经够用不需要阅读本文。当你需要给运行时打补丁、验证 HotSpot 改动、或产出特定平台Windows/macOS/Linux的 JBR 构建时才需要走源码构建流程。注意区分两类工作改 Java 代码、改 HotSpot C 代码对应的 IDE 工程生成方式不同仓库内 doc/ide.md 分别给了 VS Code、Visual Studio、Eclipse、IntelliJ IDEA 的入口先确认你要改哪一层再配工程。JBR 相对标准 OpenJDK 的差异主要在面向 IDE 场景的定制如增强的类重定义、图形与 HiDPI 支持等。下面的图片取自仓库内 Java2D 示例的高分辨率2x素材用来演示这类图形渲染能力所处理的显示场景构建 JBR 的最短路径按仓库 doc/building.md 给出的流程多数情况下四步即可得到可运行的 JDK 镜像git clone https://gitcode.com/gh_mirrors/je/JetBrainsRuntime bash configure # 自动探测工具链与依赖失败时通常打印解决方案 make images # 产出完整 JDK 镜像 ./build/*/images/jdk/bin/java -version # 用新构建的 java 验证版本每行作用第 1 行获取源码第 2 行生成构建配置和输出目录如build/linux-x64-server-release第 3 行只构建产物镜像比默认目标更快第 4 行直接运行你刚编译出来的java而不是系统里已有的版本。前置条件源码路径不含空格、位于本地磁盘构建对磁盘 IO 要求高、系统有 UTF-8 localeLinux 上通常是C.UTF-8或en_US.UTF-8。x86 平台建议至少 2-4 核、2-4 GB 内存、6 GB 以上空闲磁盘aarch64 平台建议 8 核 8 GB。这些数值来自构建文档按你的实际机器酌情放宽。关键参数及调整时的风险参数/目标作用建议值或常见取值调整时的风险--with-boot-jdkpath指定构建所用的 Boot JDK主版本为 N 时用 N-1 的最新版本当前源码树默认功能版本为 28见make/conf/version-numbers.conf自动探测经常选不到或选错 JDK导致编译到一半才失败显式指定最稳妥--with-jtregpath告诉构建系统 JTReg 测试框架的位置指向包含lib/jtreg.jar的 JTReg 根目录不指定则make test-*无法运行路径指错会报找不到测试框架--with-debug-levellevel设置调试级别默认release排查 HotSpot 问题时用fastdebugfastdebug产物体积大、速度慢不要拿去做日常使用make test-tier1运行第一层回归测试构建完成后执行一次完整跑完耗时较长失败时先看测试日志再怀疑构建本身查看全部可用参数可用bash configure --helpshort只列 JDK 相关选项输出较短适合速查。确认构建与配置是否生效运行./build/*/images/jdk/bin/java -version输出应包含JetBrains Runtime字样与预期的版本号而不是机器上其他 JDK 的信息。如果路径不存在说明make images没有跑完。构建配置存于build/config目录下重新执行bash configure可加新参数即可切换配置无需删除目录。需要完全回退时make clean清除所有编译产物但保留配置make dist-clean连配置一起删除之后重新configure即恢复干净状态。核心功能验证用make test-tier1说明见 doc/testing.md。若测试失败先确认 Boot JDK 与 JTReg 路径配置正确再按测试输出定位。常见误区与排查现象configure直接报错退出。原因缺少工具链、外部库或 Boot JDK。configure 在失败时通常会打印针对当前平台的解决建议例如缺失的 apt 包照提示安装后重跑bash configure即可不必从零开始。现象Windows 下构建中途失败或路径解析异常。原因源码路径含空格、层级过深或系统 locale 不是 US English。建议把源码移到短路径的本地磁盘locale 问题需要按构建文档调整系统区域设置这类错误往往很隐蔽提前检查比事后排查省事。现象java -version输出里看不到 JetBrains Runtime 标识。原因你执行的是系统 PATH 里已有的java而不是新构建产物里的。验证时务必用./build/*/images/jdk/bin/java完整路径。现象想从 IDE 里改代码但工程打不开或索引不全。原因IDE 工程需要先生成。Native 侧可运行make vscode-project或make eclipse-native-envJava 侧运行bash bin/idea.sh后再在 IDE 中打开对应目录SDK 指向build/config/images/jdk。步骤细节见 doc/ide.md。下一步阅读完整构建要求、平台与工具链版本矩阵doc/building.md测试分层tier1/tier2与测试选择语法doc/testing.mdJBR API 版本信息jb/jbr-api.version构建时由make/JBRApi.gmk拉取并安装到本地 Maven 仓库【免费下载链接】JetBrainsRuntimeRuntime environment based on OpenJDK for running IntelliJ Platform-based products on Windows, macOS, and Linux项目地址: https://gitcode.com/gh_mirrors/je/JetBrainsRuntime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考