如何在 Linux 上为 macOS 构建 ClickHouse

本指南适用于：当你有一台 Linux 机器，并希望使用它来构建可在 OS X 上运行的 clickhouse 二进制可执行文件的情况。主要用例是运行在 Linux 机器上的持续集成（CI）检查。如果你希望直接在 macOS 上构建 ClickHouse，请参阅原生构建说明。

针对 macOS 的交叉构建基于通用构建说明，请先按照该文档操作。

以下章节将逐步演示如何为 x86_64 架构的 macOS 构建 ClickHouse。如果你的目标是 ARM 架构，只需将所有出现的 x86_64 替换为 aarch64 即可。例如，在整个步骤中将 x86_64-apple-darwin 替换为 aarch64-apple-darwin。

安装交叉编译工具链

记住安装 cctools 的路径，并将其记为 ${CCTOOLS}

mkdir ~/cctools
export CCTOOLS=$(cd ~/cctools && pwd)
cd ${CCTOOLS}

git clone https://github.com/tpoechtrager/apple-libtapi.git
cd apple-libtapi
git checkout 15dfc2a8c9a2a89d06ff227560a69f5265b692f9
INSTALLPREFIX=${CCTOOLS} ./build.sh
./install.sh
cd ..

git clone https://github.com/tpoechtrager/cctools-port.git
cd cctools-port/cctools
git checkout 2a3e1c2a6ff54a30f898b70cfb9ba1692a55fad7
./configure --prefix=$(readlink -f ${CCTOOLS}) --with-libtapi=$(readlink -f ${CCTOOLS}) --target=x86_64-apple-darwin
make install

此外，需要将 macOS X SDK 下载到工作树中。

cd ClickHouse/cmake/toolchain/darwin-x86_64
curl -L 'https://github.com/phracker/MacOSX-SDKs/releases/download/11.3/MacOSX11.0.sdk.tar.xz' | tar xJ --strip-components=1

构建 ClickHouse

cd ClickHouse
mkdir build-darwin
cd build-darwin
CC=clang-19 CXX=clang++-19 cmake -DCMAKE_AR:FILEPATH=${CCTOOLS}/bin/x86_64-apple-darwin-ar -DCMAKE_INSTALL_NAME_TOOL=${CCTOOLS}/bin/x86_64-apple-darwin-install_name_tool -DCMAKE_RANLIB:FILEPATH=${CCTOOLS}/bin/x86_64-apple-darwin-ranlib -DLINKER_NAME=${CCTOOLS}/bin/x86_64-apple-darwin-ld -DCMAKE_TOOLCHAIN_FILE=cmake/darwin/toolchain-x86_64.cmake ..
ninja

生成的二进制文件将采用 Mach-O 可执行格式，并且无法在 Linux 上运行。

安装交叉编译工具链​

构建 ClickHouse​

安装交叉编译工具链

构建 ClickHouse