xxHash CMake Integration

This document explains how to integrate xxHash into your CMake project. Choose the method that best fits your needs.

Method 1: Install and Import (Recommended)

Best for: Projects that want to use xxHash as a system-wide library.

Step 1: Build and Install xxHash

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

Step 2: Use in Your Project

Add to your CMakeLists.txt:

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

Build Options

Configure the build with these options:

-DXXHASH_BUILD_XXHSUM=OFF - Skip building the command line tool (default: ON)
-DBUILD_SHARED_LIBS=OFF - Build static library instead of shared (default: ON)
-DCMAKE_INSTALL_PREFIX=/custom/path - Install to custom location
-DDISPATCH=OFF - Disable CPU dispatch optimization (default: ON for x64)

Method 2: Add as Subdirectory

Best for: Projects that want to bundle xxHash directly without system installation.

Add to your 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)