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 以外的平台上會被忽略。