> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 在 Linux 上为 macOS 系统交叉编译 ClickHouse 的指南

# 在 Linux 上为 macOS 构建

本节适用于这样一种情况：你有一台 Linux 机器，并希望用它构建可在 OS X 上运行的 `clickhouse` 二进制文件。
主要使用场景是在 Linux 机器上运行持续集成检查。
如果你想直接在 macOS 上构建 ClickHouse，请参阅[原生构建说明](/zh/resources/develop-contribute/build/build-osx)。

面向 macOS 的交叉构建基于[构建说明](/zh/resources/develop-contribute/build/build)，请先完成其中的步骤。

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

<div id="install-cross-compilation-toolset">
  ## 安装交叉编译工具集
</div>

请记下安装 `cctools` 的路径，即 `${CCTOOLS}`

```bash theme={null}
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 下载到源码树中。

```bash theme={null}
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
```

<div id="build-clickhouse">
  ## 构建 ClickHouse
</div>

```bash theme={null}
cd ClickHouse
mkdir build-darwin
cd build-darwin
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 上运行。