CMAKE_OSX_SYSROOT

指定要使用的 macOS 平台 SDK 的位置或名稱。 CMake 使用此值來計算 -isysroot 旗標或等效項的值,並幫助 find_* 命令在 SDK 中找到檔案。

如果未明確設定,則該值會由 SDKROOT 環境變數(如果已設定)初始化,否則根據 CMAKE_OSX_DEPLOYMENT_TARGET 或主機平台計算得出。

此變數的值應在第一次調用 project()enable_language() 命令之前設定,因為它可能會影響工具鏈和旗標的配置。 它旨在由建立建置樹狀結構的使用者在本機設定。 除非策略 CMP0126 設定為 NEW,否則此變數應設定為 CACHE 條目(否則 CMake 可能會在初始化同名快取條目時將其移除)。

儘管變數名稱中包含 OSX 部分,但它們也適用於 macOS 以外的其他 SDK,例如 iOS、tvOS、visionOS 或 watchOS。

在 Apple 以外的平台上,此變數會被忽略。