メインコンテンツへスキップ
メインコンテンツへスキップ

Linux 上で macOS 向けの ClickHouse をビルドする方法

このドキュメントは、Linux マシンを使って OS X 上で実行する clickhouse バイナリをビルドしたい場合の手順です。 主なユースケースは、Linux マシン上で実行される継続的インテグレーション(CI)チェックです。 ClickHouse を直接 macOS 上でビルドしたい場合は、ネイティブビルド手順を参照してください。

macOS 向けのクロスビルドは ビルド手順 に基づいているため、まずそちらに従ってください。

以下のセクションでは、x86_64 macOS 向けに ClickHouse をビルドする手順を説明します。 ARM アーキテクチャをターゲットにする場合は、すべての x86_64aarch64 に置き換えてください。 たとえば、手順全体を通して x86_64-apple-darwinaarch64-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 上では実行できません。