開發新的 GDK 遊戲

這是引導式路徑的第 3 步。開始之前,請先依照設定並安裝 GDK 安裝 GDK 並建置一個範例。 每個 GDK 遊戲都從一個 Visual Studio 專案開始。你可以依照遊戲要執行的位置選擇範本:僅限 Windows PC、僅限 XBOX 主機,或以相同程式碼同時鎖定兩者。現在不需要做最終決定,因為之後隨時可以加入另一個目標。

​

專案範本

安裝 GXDK 會在 Visual Studio 中加入九個 GDK 專案範本:五個用於 PC,四個用於 XBOX 主機。

​

建立專案

1. 開啟 Visual Studio。
2. 前往 File > New > Project。
3. 在 All Languages 中選擇 C++。在 All Platforms 中選擇 XBOX 或 Windows。在 All Project Types 中選擇 Games。你也可以直接以範本名稱搜尋。
4. 選擇一個範本,然後選擇 OK。

​

選擇範本

​

僅限 PC

從 Direct3D 12 Desktop Game 開始。

• 使用 WINAPI_FAMILY_DESKTOP_APP,並連結完整的 PC 程式庫集合,包括 kernel32.lib 與 user32.lib。
• 包含 D3D12 的標頭與程式庫。提供簡單的交換鏈(swap chain)、D3D 裝置,以及更新與轉譯迴圈。
• 包含 XGameRuntime.h 並連結 XGameRuntime.lib。所有 GDK Gaming Runtime 功能皆可直接使用。
• 預設即可使用 XSAPI 延伸程式庫。
• 可針對標準 x64 平台或自訂的 Gaming.Desktop.x64 平台建置。
• 會建立一個 MicrosoftGameConfig.mgc 檔案,內含 Partner Center 身分識別的預留位置。

​

僅限 XBOX

從 Direct3D 12 XBOX Game 開始。

• 使用 WINAPI_FAMILY_GAMES 並連結 XGamePlatform.lib。
• 包含可直接使用 XBOX D3D12.x 延伸功能的 D3D12 標頭。
• 包含 XGameRuntime.h 並連結 XGameRuntime.lib。
• 預設即可使用 XSAPI 延伸程式庫。
• 使用 Gaming.XBOX.XboxOne.x64 MSBuild 平台,並預期以遠端偵錯方式運作。
• 會建立一個含預留位置的 MicrosoftGameConfig.mgc 檔案。

​

PC 與 XBOX(共用程式碼基底)

從一個範本開始,例如 Direct3D 12 XBOX Game,再加入鎖定 Gaming.XBOX.XboxOne.x64 的第二個建置組態(或反過來,從 Direct3D 12 Desktop Game 開始)。 使用 #define 或 #ifdef 防護來調整原始碼,或將平台專屬程式碼分割到獨立的 DLL 中:

• PC 組態使用標準 D3D12。
• XBOX 組態使用 D3D12.x。

切換使用中的組態會自動變更偵錯工具、連結的程式庫與其他工具設定。

​

在 dev kit 上完成端對端流程

在選擇更深入的路徑之前,請先完成主機實作逐步解說。它會帶著你將建立的 Direct3D 12 XBOX Game 範本一路做到在 XBOX dev kit 上執行鬆散部署(loose deployment),並進一步產生可安裝的 XVC。

​

後續步驟

你已經有一個可建置的專案。請選擇最符合你要推出內容的精選路徑。指南會為你指出接下來需要的更深入文件(建置、服務、最佳化、發行與 API 參考)。

​

另請參閱

• 移植指南:移植主題的技術索引(ERA 到 GDK、著色器、GameInput 與 Steamworks 對應)。
• MicrosoftGame.config 概觀。
• 封裝你的遊戲。