CMAKE_GENERATOR_PLATFORM

在 3.1 版本中新增。

使用者提供的、產生器特定的目標平台規格。

某些 CMake 產生器支援將目標平台名稱提供給原生建置系統，以選擇編譯器工具鏈。如果使用者指定了平台名稱 (例如透過 cmake -A 選項或透過 CMAKE_GENERATOR_PLATFORM 環境變數)，該值將在此變數中可用。

此變數的值永遠不應由專案程式碼修改。由 CMAKE_TOOLCHAIN_FILE 變數指定的工具鏈檔案可能會初始化 CMAKE_GENERATOR_PLATFORM。一旦給定的建置樹狀結構已使用此變數的特定值初始化，則變更該值將具有未定義的行為。

平台規格僅在特定產生器上支援

請參閱原生建置系統文件以了解允許的平台名稱。

Visual Studio 平台選擇

Visual Studio 產生器 支援使用以下其中一種形式的平台規格

  • 平台

  • 平台[,key=value]*

  • key=value[,key=value]*

platform 指定目標平台 (VS 目標架構)，例如 x64、ARM64 或 Win32。選取的平台名稱會在 CMAKE_VS_PLATFORM_NAME 變數中提供。

key=value 配對形成以逗號分隔的選項清單，以指定平台選擇的產生器特定詳細資訊。支援的配對是

version=<version>

在 3.27 版本中新增。

指定要使用的 Windows SDK 版本。當目標為 Windows 或 Windows Store 時，VS 2015 及更高版本支援此功能。CMake 會將 CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION 變數設定為選取的 SDK 版本。

<version> 可以是以下其中之一

10.0

指定可以使用任何 10.0 SDK 版本，並讓 Visual Studio 選擇一個。VS 2019 及更高版本支援此功能。

10.0.<build>.<increment>

指定精確的 4 組件 SDK 版本，例如 10.0.19041.0。必須安裝指定的 SDK 版本。它可能不會超過 CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM 的值 (如果已設定該變數)。

8.1

指定 8.1 SDK 版本。VS 2015 始終支援此功能。在 VS 2017 及更高版本上，必須安裝 8.1 SDK。

如果未指定 version 欄位，則 CMake 會按照 CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION 變數文件中所述的方式選擇版本。