Eclipse OpenJ9 项目：仅构建编译器组件的完整指南

Eclipse OpenJ9 项目：仅构建编译器组件的完整指南

openj9 Eclipse OpenJ9: A Java Virtual Machine for OpenJDK that's optimized for small footprint, fast start-up, and high throughput. Builds on Eclipse OMR (https://github.com/eclipse/omr) and combines with the Extensions for OpenJDK for OpenJ9 repo. 项目地址: https://gitcode.com/gh_mirrors/op/openj9

为什么需要单独构建编译器

在 Eclipse OpenJ9 项目的开发过程中，当开发者专注于编译器组件的改进时，通常不需要每次都完整构建整个 JVM。完整构建不仅耗时，还会消耗大量系统资源。单独构建编译器组件可以显著提高开发效率，特别是在以下场景中：

1. 仅修改了编译器相关代码
2. 需要快速验证编译器优化效果
3. 进行编译器性能测试
4. 调试编译器特定功能

需要注意的是，如果修改涉及跨组件依赖，则仍需完整构建整个 JVM。

环境准备

在开始单独构建编译器前，需要确保已完成以下准备工作：

1. 已按照标准流程完整构建过 OpenJ9 项目
2. 已正确配置 Java 开发环境
3. 已安装必要的构建工具（如 make、gcc 等）

详细构建步骤

1. 设置基础环境变量

首先需要设置几个关键环境变量，这些变量将指导构建系统找到正确的源代码和构建输出位置：

# 设置扩展目录路径（根据实际安装位置调整）
EXTENSIONS_DIR=<openj9-openjdk扩展仓库路径>
JAVA_BASE=$EXTENSIONS_DIR/build/linux-x86_64-normal-server-release

# 进入顶层目录
cd $EXTENSIONS_DIR/..

2. 创建必要的符号链接

编译器构建需要访问特定的目录结构，通过创建符号链接可以满足这一需求：

# 创建编译器目录的符号链接
ln -s $EXTENSIONS_DIR/openj9/runtime/compiler
ln -s $EXTENSIONS_DIR/omr

3. 配置构建环境变量

设置构建过程中需要的环境变量：

# 设置基础环境变量
export TRHOME=$PWD
export J9SRC=$JAVA_BASE/vm
export PATH=$J9SRC:$PATH

4. 生成跟踪文件（首次构建时需要）

如果是首次构建或使用了干净的代码仓库，需要重新生成跟踪文件：

# 生成跟踪文件
pushd .
cd $TRHOME/compiler/env
tracegen -treatWarningAsError -generatecfiles -threshold 1 -file j9jit.tdf
echo ""
popd

5. 设置编译器特定的Makefile变量

配置编译器构建专用的变量：

# 编译器构建变量
export JIT_SRCBASE=$TRHOME
export JIT_OBJBASE=$TRHOME/objs
export JIT_DLL_DIR=$TRHOME

执行构建

完成上述配置后，可以开始构建编译器组件：

make -C $TRHOME/compiler -f compiler.mk BUILD_CONFIG=prod -j<线程数> J9_VERSION=29

其中：

• <线程数> 应根据你的CPU核心数设置，例如8核CPU可以设置为-j8
• BUILD_CONFIG=prod 表示构建生产环境配置
• J9_VERSION=29 指定了J9的版本号

清理构建

如果需要清理构建结果，执行以下命令：

rm -rf $JIT_OBJBASE

这将删除所有编译器构建生成的中间文件。

常见问题与解决方案

1. 符号链接错误：确保符号链接指向正确的目录路径
2. 环境变量未生效：检查是否在正确的shell中设置了环境变量
3. 构建失败：查看错误日志，确认是否所有前置条件都已满足
4. 性能问题：适当调整构建线程数，避免系统资源耗尽

最佳实践建议

1. 在开发过程中，可以创建一个专门的构建脚本来自动化上述步骤
2. 考虑使用ccache等工具加速重复构建过程
3. 定期清理构建目录以避免残留文件导致的问题
4. 对于大型修改，建议先进行完整构建以确保系统一致性

通过遵循本指南，开发者可以高效地专注于编译器组件的开发工作，显著提升开发效率。

openj9 Eclipse OpenJ9: A Java Virtual Machine for OpenJDK that's optimized for small footprint, fast start-up, and high throughput. Builds on Eclipse OMR (https://github.com/eclipse/omr) and combines with the Extensions for OpenJDK for OpenJ9 repo. 项目地址: https://gitcode.com/gh_mirrors/op/openj9