CMAKE_OSX_SYSROOT

Specify the location or name of the macOS platform SDK to be used.

If not set explicitly, the value is initialized by the SDKROOT environment variable, if set. Otherwise, the value defaults to empty, and the compiler is expected to choose a default macOS SDK on its own.

.. versionchanged:: 4.0 The default is now empty. Previously a default was computed based on the :variable:CMAKE_OSX_DEPLOYMENT_TARGET or the host platform.

In order to pass an explicit macOS SDK via the compiler's -isysroot flag, users may configure their build tree with -DCMAKE_OSX_SYSROOT=macosx, or export SDKROOT="$(xcrun --sdk macosx --show-sdk-path)" in their environment.

Notes:

macOS compilers in /usr/bin, when not invoked with -isysroot, search for headers in /usr/local/include before system SDK paths, matching the convention on many platforms. Users on macOS-x86_64 hosts with Homebrew installed in /usr/local should pass an explicit SDK, as described above, when not building with Homebrew tools.
Some Clang compilers have no default macOS SDK selection. For these, if :variable:CMAKE_OSX_SYSROOT is empty, CMake will automatically pass -isysroot with the macOS SDK printed by xcrun --show-sdk-path.

.. include:: include/CMAKE_OSX_VARIABLE.rst