CMAKE_GENERATOR_PLATFORM

版本 3.1 新增。

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

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

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

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

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

Visual Studio 平台選擇

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

  • platform

  • platform[,key=value]*

  • key=value[,key=value]*

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

key=value 組成逗號分隔的選項列表，以指定平台選擇的產生器特定詳細資訊。支援的配對為

version=<version>

版本 3.27 新增。

指定要使用的 Windows SDK 版本。VS 2015 及更高版本在以 Windows 或 Windows Store 為目標時支援此功能。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 變數文件中所述的方式選擇版本。