このページの内容

xxHashのCMakeへの組み込み

この文書では、xxHashをCMakeプロジェクトに組み込む方法を説明します。用途に最も適した方法を選んでください。

方法1:インストールしてインポートする(推奨)

適した用途: xxHashをシステム全体で利用するライブラリとして使いたいプロジェクト。

手順1:xxHashをビルドしてインストールする

cd /path/to/xxHash
cmake -S build/cmake -B cmake_build
cmake --build cmake_build --parallel
cmake --install cmake_build

手順2:自分のプロジェクトで使う

CMakeLists.txtに次を追加します。

find_package(xxHash 0.8 CONFIG REQUIRED)
target_link_libraries(YourTarget PRIVATE xxHash::xxhash)

ビルドオプション

次のオプションでビルドを設定します。

  • -DXXHASH_BUILD_XXHSUM=OFF:コマンドラインツールのビルドを省略します(デフォルト:ON)。
  • -DBUILD_SHARED_LIBS=OFF:共有ライブラリの代わりに静的ライブラリをビルドします(デフォルト:ON)。
  • -DCMAKE_INSTALL_PREFIX=/custom/path:インストール先を指定します。
  • -DDISPATCH=OFF:CPUディスパッチの最適化を無効にします(x64でのデフォルト:ON)。

方法2:サブディレクトリーとして追加する

適した用途: システムにインストールせず、xxHashを直接同梱したいプロジェクト。

CMakeLists.txtに次を追加します。

# Optional: Configure xxHash before adding
set(XXHASH_BUILD_XXHSUM OFF)        # Don't build command line tool
option(BUILD_SHARED_LIBS OFF)       # Build static library

# Add xxHash to your project
add_subdirectory(path/to/xxHash/build/cmake xxhash_build EXCLUDE_FROM_ALL)

# Link to your target
target_link_libraries(YourTarget PRIVATE xxHash::xxhash)