> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 為 XBOX Series X|S 與 XBOX One 設定 Visual Studio

> 為 XBOX Series X|S 與 XBOX One 組建設定 Visual Studio

您可以使用 Visual Studio 在單一專案或方案中，同時建置遊戲的 XBOX Series X|S 與 XBOX One 版本。以這種方式使用 Visual Studio，您可以更輕鬆地管理建置同時以 XBOX One 與 XBOX Series X|S 世代為目標之遊戲所需的原始程式碼與建置組態差異。

視程式碼的結構與建置流程的設計而定，您可以選擇在同一個專案中，或在同一個方案的不同專案中，建置特定二進位檔的 XBOX One 與 XBOX Series X|S 版本。對於 XBOX Series X|S 與 XBOX One 之間程式碼大致相同的二進位檔 (例如非圖形程式碼)，從同一個專案建置可能比較合理。對於程式碼在兩個平台之間差異很大的專案，分開的專案可能更容易管理。

使用 Visual Studio 中的平台概念，將 XBOX Series X|S 組建的建置組態設定與 XBOX One 組建所需的設定分開。

使用 Microsoft Game Development Kit (GDK) 提供的 Visual Studio 範本所建立的專案，同時包含 XBOX One 與 XBOX Series X|S 平台的定義。XBOX One 平台的名稱為 `Gaming.Xbox.XboxOne.x64`。XBOX Series X|S 平台的名稱為 `Gaming.Xbox.Scarlett.x64`，如下列螢幕擷取畫面所示。

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_scarlett_config.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=43dd3823fa1808f1d6991e6a4f5c3471" alt="顯示 Gaming.Xbox.XboxOne.x64 與 Gaming.Xbox.Scarlett.x64 平台之 Visual Studio 範本的螢幕擷取畫面" width="228" height="121" data-path="images/gdk/tools/vs_scarlett_config.png" />

`Gaming.Xbox.XboxOne.x64` 與 `Gaming.Xbox.Scarlett.x64` 平台會指定為 XBOX One 或 XBOX Series X|S 建置遊戲所需的前置處理器定義、include 與程式庫路徑以及其他設定。例如，`Gaming.Xbox.Scarlett.x64` 平台會設定下列前置處理器定義。

```cpp theme={null}
_GAMING_XBOX_SCARLETT
```

此平台會使用 msbuild 屬性將下列目錄新增至 include 與程式庫路徑清單。

```cpp theme={null}
C:\Program Files (x86)\Microsoft GDK\260400\GXDK\gameKit\Include\Scarlett
C:\Program Files (x86)\Microsoft GDK\260400\GXDK\gameKit\lib\amd64\Scarlett
```

`Gaming.Xbox.XboxOne.x64` 平台會對建置環境進行建置遊戲 XBOX One 版本所需的對應變更。

使用 msbuild 建置時，請在命令列上指定這些平台，如下列程式碼範例所示。

```cpp theme={null}
msbuild MySolution.sln /p:Configuration=Debug /p:Platform="Gaming.Xbox.Scarlett.x64"
```

## 使用其他建置系統

如果您的建置系統不是 Visual Studio 與 msbuild，您可以比較 GDK 所包含之 msbuild .targets 與 .props 檔案的 XBOX Series X|S 與 XBOX One 版本，以判斷需要對您自己的建置系統進行哪些變更，以進行跨世代開發。

這些檔案會安裝至 *C:\Program Files (x86)\Microsoft GDK\260400\GXDK\VS2019\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms* 底下的 `Gaming.Xbox.Scarlett.x64` 與 `Gaming.Xbox.XboxOne.x64` 目錄。

如需在不使用 Visual Studio 的情況下建置所需之特定設定的詳細資訊，請參閱[適用於 XBOX One 的 Microsoft Game Development Kit 移植指南](/zh-TW/build/console-features/porting-from-xbox-one-era/porting-guide-for-existing-era)。

## 另請參閱

[Visual Studio](/zh-TW/tools/tools-console/visualstudio/visualstudio)


## Related topics

- [XBOX One 與 XBOX Series X|S GDK 工具](/zh-TW/tools/tools-console/tools-sdk.md)
- [Visual Studio](/zh-TW/tools/tools-console/visualstudio/index.md)
- [用於主機開發的 Visual Studio](/zh-TW/tools/tools-console/visualstudio/visualstudio.md)
- [使用 Visual Studio 偵錯 XBOX 專案](/zh-TW/tools/tools-console/visualstudio/debugging-with-visualstudio.md)
- [使用 GDKX 建置並執行你的第一個主機遊戲](/zh-TW/home/build-first-title/first-console-title-walkthrough.md)