使用 Visual Studio 偵錯 XBOX 專案

在 Visual Studio 中偵錯 XBOX Microsoft Game Development Kit (GDK) 專案，是由作為 Microsoft Game Development Kit (GDK) 一部分安裝的 XBOX 偵錯工具元件所啟用。支援 Visual Studio 2019 與 2022。對於平台為 Gaming.Xbox.One.x64 或 Gaming.Xbox.Scarlett.x64 的所有專案，XBOX 偵錯工具都是預設的偵錯工具，如下列螢幕擷取畫面所示。

​

設定 Visual Studio 偵錯工具

從 Visual Studio 中使用 F5 啟動偵錯工具時，預設會使用您透過其他 Microsoft Game Development Kit (GDK) 工具 (例如 XBOX Manager 或 xbConnect) 所設定的預設主機。若要覆寫此行為，請使用專案屬性頁 XBOX One 區段底下的 Remote IP Address 屬性指定主機，如下列螢幕擷取畫面所示。 Visual Studio 中的偵錯工具列包含一個下拉式清單，指出透過 F5 或 Ctrl-F5 啟動時遊戲將部署至哪部主機。如果需要變更目標主機，該下拉式清單有一個按鈕可用於快速存取專案的屬性頁。 偵錯工具也可以從 XBOX Gaming Explorer 啟動。在此情況下，使用的主機是 XBOX Gaming Explorer 頂端連線功能區中所識別的主機，如下列螢幕擷取畫面所示。

​

符號路徑

使用 Visual Studio 偵錯時，可以使用數個 Game OS 元件的程式資料庫 (.pdb) 檔案。例如，設定 Visual Studio 使用這些符號，可在中斷進入偵錯工具時提供更完整的呼叫堆疊。 部分 Game OS 符號會由 Microsoft Game Development Kit (GDK) 安裝程式安裝在您的開發電腦上，其他符號則可在 Microsoft 公用符號伺服器上取得。 安裝程式所安裝的 Game OS 符號位於開發電腦上的 C:\Program Files (x86)\Microsoft GDK<edition number>\GXDK\gameKit\symbols。與平台無關的 .pdb 位於符號資料夾的根目錄。平台特定的 .pdb 位於 Xbox Series X|S 與 XboxOne 子目錄中。 若要在本機電腦上新增 Game OS 符號目錄的路徑，請使用 Visual Studio 選項 對話方塊 偵錯 區段底下的 符號 設定，如下列螢幕擷取畫面所示。 若要存取 Microsoft 公用符號伺服器上可用的 Game OS 符號，請勾選 符號 對話方塊中的 Microsoft 符號伺服器 核取方塊。將 Microsoft 符號伺服器新增為符號檔位置，會導致 Visual Studio 在符號伺服器上搜尋遊戲所載入的所有二進位檔。全面的符號搜尋可能相當耗時。您可以將 Visual Studio 設定為只針對遊戲所使用的特定二進位檔集合尋找 .pdb，以縮短搜尋時間。若要指定 Visual Studio 應尋找 .pdb 的二進位檔集合，請使用 選項 對話方塊中的 僅載入指定的模組 選項。下列螢幕擷取畫面顯示 Visual Studio 設定為只為少數選定的二進位檔從公用符號伺服器載入符號。

​

與偵錯相關的屬性

偵錯工具可以透過專案屬性對話方塊以及 XBOX Gaming Explorer Settings 索引標籤中公開的一組屬性進一步設定。例如，這些屬性包括將命令列引數傳遞給遊戲以及開啟模組載入記錄的功能。如需可用屬性的詳細資料，請參閱 XBOX 開發的 Visual Studio 屬性與 XBOX Gaming Explorer。

​

附加至執行中的遊戲

XBOX 功能表與 XBOX Gaming Explorer 包含將偵錯工具附加至主機上執行中遊戲的功能表選項。 若要附加至預設主機上目前執行的遊戲，請使用 XBOX 功能表上的 Attach to Running Game。XBOX 功能表可從 Visual Studio 功能表列存取，如下列螢幕擷取畫面所示。 您也可以附加至在您已透過 XBOX Gaming Explorer 新增之任何主機上執行的遊戲。Home 索引標籤之 Game Processes 與 Titles 區段中的內容功能表，包含附加至執行中遊戲的功能表項目，如下列螢幕擷取畫面所示。 Consoles 索引標籤中特定主機的內容功能表，會附加至在該主機上執行的遊戲，如下列螢幕擷取畫面所示。 Visual Studio 偵錯 功能表底下的 附加 對話方塊也可用於附加至執行中的遊戲。使用 Visual Studio 2022 時，請在 連線類型 下拉式清單中選取 XBOX Direct Connection，並在 連線目標 文字方塊中輸入主機的 Host IP 位址或 System IP 位址。可以使用 xbconnect 命令列工具判斷 Host 與 System IP 位址。 使用 Visual Studio 2019 時，請在 連線類型 下拉式清單中選取 Remote No Authentication，並在 連線目標 文字方塊中輸入主機的 Host IP 位址。

​

使用 Visual Studio 2022 偵錯 XBOX 專案

使用 Visual Studio 2022 進行偵錯，需要使用 2021 年 10 月 (或更新版本) 的 Microsoft Game Development Kit (GDK) 建置要偵錯的遊戲。之所以相依於 2021 年 10 月 (或更新版本) 的 Microsoft Game Development Kit (GDK)，是因為這些 Microsoft Game Development Kit (GDK) 版本中隨附的 Game OS 包含使用 Visual Studio 2022 進行偵錯所需的二進位檔。如果嘗試對較舊的 Game OS 使用 Visual Studio 2022 進行偵錯，會顯示下列錯誤。

​

偵錯封裝組建

XBOX Gaming Explorer 中用於在偵錯工具下啟動遊戲或附加至執行中遊戲的內容功能表選項，對於封裝組建與鬆散檔案部署同樣適用。 串流安裝套件會在 XBOX Gaming Explorer 中以 Install 部署類型與圖示加以識別，如下列螢幕擷取畫面所示。

​

偵錯遊戲生命週期狀態之間的轉換

若要正確支援遊戲生命週期，您必須為完整、暫停與受限生命週期狀態之間的轉換撰寫事件處理常式。Visual Studio 提供數項功能，協助您撰寫遊戲成功通過遊戲生命週期狀態轉換所需的強固事件處理常式。 XBOX Gaming Explorer 中的內容功能表包含 Suspend、Resume 與 Constrain 遊戲的選項，讓您可以在開發套件上偵錯處理常式。 請注意，您也可以從 XBOX Manager 與 xbApp 命令列工具手動觸發這些狀態轉換。 無論狀態轉換是如何觸發的，描述轉換的診斷訊息以及任何失敗都可以在 xbWatson 以及 Visual Studio 內的 XBOX System Monitor 視窗中看到。 在零售環境中，Suspend 事件的處理常式必須在 1 秒內完成，否則系統會終止您的遊戲。顯然不應在開發套件上一律強制執行此暫停時間限制，否則幾乎不可能偵錯 Suspend 處理常式。 根據預設，當附加 Visual Studio 偵錯工具 (或其他任何使用者模式偵錯工具) 時，會停用 1 秒暫停逾時，讓您可以花費所需的時間完成偵錯工作。 Visual Studio 偵錯工具也可以設定為在附加時重新啟用暫停逾時。在此模式下，如果您的 Suspend 處理常式未在 1 秒限制內完成，偵錯工具會強制中斷，讓您可以看到時間限制到期時您在 Suspend 處理常式中的位置。在此模式下執行偵錯工具，有助於了解您的 Suspend 處理常式超過時間限制的頻率及原因。在 Visual Studio 中設定 Break On Suspend Timeout 屬性，即可讓偵錯工具進入啟用暫停逾時的模式。在此模式下發生的偵錯中斷，是在偵錯工具插入處理序的新執行緒上進行。請瀏覽至包含 Suspend 處理常式的執行緒以開始偵錯。 如果在發生暫停逾時時未將偵錯工具附加至遊戲，系統會建立靜止當機傾印。您可以使用 xbWatson 中的記憶體傾印面板存取這些傾印。

​

Visual Studio 2022 中的 C++ 動態偵錯

C++ 動態偵錯是一項新的偵錯功能，可在不犧牲效能的情況下，為最佳化程式碼提供完整的偵錯體驗。透過隨需函式取消最佳化，您可以在任何位置設定取消最佳化的中斷點並逐步執行。若要啟用 C++ 動態偵錯：以滑鼠右鍵按一下專案，選取 屬性 > 組態屬性 > 進階 > 進階屬性 > 使用 C++ 動態偵錯 (預覽)。使用動態偵錯功能需要 Visual Studio 2022 17.14 Preview 2 或更新版本。前往 https://aka.ms/dynamicdebugging 了解詳細資訊。

​

另請參閱

XBOX Gaming Explorer Visual Studio