Apache Heron在Mac OS X上的编译指南

Apache Heron在Mac OS X上的编译指南

incubator-heron Apache Heron (Incubating) is a realtime, distributed, fault-tolerant stream processing engine from Twitter 项目地址: https://gitcode.com/gh_mirrors/incu/incubator-heron

Apache Heron是一个实时、分布式、可扩展的流处理引擎，由Twitter开发并贡献给Apache基金会。本文将详细介绍如何在Mac OS X系统上编译构建Heron项目。

环境准备

在开始编译之前，需要确保您的Mac系统满足以下条件：

• 操作系统版本为10.10(Yosemite)或10.11(El Capitan)
• 已安装Xcode命令行工具
• 管理员权限

详细编译步骤

1. 安装Homebrew包管理器

Homebrew是Mac OS上最受欢迎的包管理工具，可以简化后续依赖库的安装过程。执行以下命令安装：

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安装完成后，建议运行brew doctor检查环境是否正常。

2. 安装必要的开发库

Heron编译需要以下基础库支持：

brew install automake cmake libtool

这些库分别提供：

• automake：自动生成Makefile的工具
• cmake：跨平台的构建系统
• libtool：库文件生成工具

3. 设置编译环境变量

Heron需要使用clang/clang++作为编译器，设置环境变量：

export CC=/usr/bin/clang
export CXX=/usr/bin/clang++

可以通过echo $CC $CXX验证设置是否生效。

4. 安装Bazel构建工具

Heron使用Bazel作为构建系统，安装特定版本：

wget -O /tmp/bazel.sh https://github.com/bazelbuild/bazel/releases/download/0.3.1/bazel-0.3.1-installer-darwin-x86_64.sh
chmod +x /tmp/bazel.sh
/tmp/bazel.sh --user

安装完成后，将Bazel添加到PATH环境变量：

export PATH="$PATH:$HOME/bin"

5. 获取Heron源代码

克隆最新版本的Heron源代码：

git clone https://github.com/twitter/heron.git && cd heron

6. 配置Bazel构建环境

运行配置脚本：

./bazel_configure.py

如果脚本报错提示缺少依赖，可以使用Homebrew安装相应依赖。

7. 构建Heron项目

使用Bazel进行完整构建：

bazel build --config=darwin heron/...

此过程可能需要较长时间，具体取决于机器性能。

8. 生成安装包

构建完成后，可以生成二进制包和tar包：

bazel build --config=darwin scripts/packages:binpkgs
bazel build --config=darwin scripts/packages:tarpkgs

生成的包位于bazel-bin/scripts/packages/目录下。

常见问题解决

1. 编译过程中内存不足：可以尝试增加Bazel的JVM内存限制，通过export BAZEL_JAVAC_OPTS="-J-Xmx2g"设置。

2. 依赖库版本冲突：建议使用Homebrew安装指定版本的依赖库。

3. Bazel构建失败：尝试清理缓存后重新构建：bazel clean --expunge。

后续步骤

成功编译后，您可以：

• 运行单元测试验证构建结果
• 部署本地开发环境
• 开始Heron应用的开发工作

希望本指南能帮助您在Mac系统上顺利完成Heron的编译工作。如果在过程中遇到任何问题，可以参考官方文档或社区资源获取更多帮助。

incubator-heron Apache Heron (Incubating) is a realtime, distributed, fault-tolerant stream processing engine from Twitter 项目地址: https://gitcode.com/gh_mirrors/incu/incubator-heron