> ## 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 開發的 Visual Studio 屬性

> XBOX 開發的 Visual Studio 屬性

Microsoft Game Development Kit (GDK) 具有用於設定 XBOX 專案的自訂 Visual Studio 屬性頁。

#### 存取 XBOX 屬性頁

1. 在 **方案總管** 中，以滑鼠右鍵按一下專案名稱，然後選取 **屬性**。
2. 展開 **組態屬性**。
3. 查看 **XBOX General**、**XBOX Deploy**、**XBOX Layout** 與 **偵錯** 屬性頁。

下列為可用的 **XBOX** 及相關屬性頁。

* [XBOX General](#general)
* [XBOX Deploy](#deploy)
* [XBOX Layout](#layout)
* [偵錯](#debugging)
* [相關屬性頁](#related)
* [遊戲相依性查詢](#gamedependency)

<a id="general" />

## XBOX General

**XBOX General** 屬性頁包含下列屬性。

* **Gaming Edition Target。** 指定建置專案時要使用的 GDK 版本。預設為開發電腦上安裝的最高 GDK 版本。
* **Gaming Extension Libraries。** 指定要使用的 Gaming Extension 程式庫集合 (例如 Xbox.Services.API.C)。
* **Alternate Binary Subdirectory** 此選用屬性用於在遊戲根目錄底下指定二進位檔與 CRT 相依性的子目錄。這用於鏡像 Layout 資料夾中的結構，偵錯工具在偵錯時會使用它來尋找可執行檔。指定子目錄時，MicrosoftGame.config 仍應位於遊戲的根目錄中。MicrosoftGame.config 中可執行檔位置的任何路徑變更也應一併更新。
* **Remote IP Address。** 指定遠端主機名稱或 IP 位址。這是建置的專案要部署、執行與偵錯的主機。如果此屬性保留空白或設為空白，則會使用由 [Connect (xbconnect.exe)](/zh-TW/tools/tools-console/commandlinetools/xbconnect)、[XBOX Manager](/zh-TW/tools/tools-console/xbom/xbom) 或 [Windows Device Portal](/zh-TW/tools/tools-console/wdp/wdp) 所指定的預設遠端主機。
* **Package Localization Dir。** 指定相對於專案目錄的選用目錄，供建立當地語系化殼層資源時使用。如需將當地語系化資源新增至專案的其他資訊，請參閱 [MicrosoftGame.config 當地語系化](/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Localization)。

**圖 1.   XBOX General 屬性頁** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_general.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=2dd98c01503a3c4b3a5a8fb40167fca2" alt="General 屬性頁" width="1162" height="809" data-path="images/gdk/tools/property_page_general.png" />

<Note>
  您也可以在 *project*.vcxproj.user 檔案中指定遠端 IP，該檔案與 *project*.vcxproj 一起儲存在專案目錄中。該檔案應具有下列格式。
</Note>

```text theme={null}
  <?xml version="1.0" encoding="utf-8"?>  
  <Project ToolsVersion="4.0" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">  
    <PropertyGroup>  
      <RemoteAddress>10.10.10.10</RemoteAddress>  
    </PropertyGroup>  
  </Project>  
```

在上述範例中，請將 *10.10.10.10* 替換為您遠端主機的位址。

<a id="deploy" />

## XBOX Deploy

**XBOX Deploy** 屬性頁可讓您選取每種部署方法。屬性頁會依所選項目包含不同的選項。如需部署的詳細資訊，請參閱[將遊戲部署至 XBOX 開發套件](/zh-TW/home/setup-install/concepts/deployment)。

### XBOX 部署方法：Push (從開發套件執行)

此部署方法會將遊戲部署至開發套件上的資料夾 (預設為 xD:\Titles)。此部署方法包含下列屬性。

* **Deployment folder path override。** 用於覆寫開發套件上預設部署路徑的選用屬性。
* **Remove extra files from target device。** 選用屬性，勾選時會移除主機上不屬於專案建置輸出的檔案 (孤立檔案)。

### XBOX 部署方法：External (不使用 Visual Studio 進行部署)

此部署方法會將部署交由外部的獨立機制處理。此部署方法包含下列屬性。

* **Title launch string。** 開始偵錯 (F5) 時用於啟動遊戲的啟動字串。
* **Target devkit titles。** 從目標開發套件上符合目前專案的遊戲清單中選取，以填入遊戲啟動字串。

### XBOX 部署方法：Run from PC (註冊網路共用)

此部署方法會透過開發套件可存取的網路共用，從開發電腦執行遊戲。

* **Network share path override。** 用於覆寫從 PC 執行部署之預設網路共用路徑的選用屬性。
* **Network share username。** 用於存取需要認證之網路共用位置 (SMB 網路共用) 的選用屬性。
* **Network share password。** 用於存取需要認證之網路共用位置 (SMB 網路共用) 的選用屬性。

> <img src="https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/caution.gif?s=c35e42b8bb5ca0bdac12d10f6c467c29" alt="caution" width="11" height="11" data-path="images/gdk/tools/caution.gif" />**注意：** 此使用者名稱與密碼會以純文字傳遞，並以純文字儲存在本機。為了提高安全性，請將此欄位保留空白，並依照 [XBOX Device Portal (XBOX 上的 Windows Device Portal)](/zh-TW/tools/tools-console/wdp/wdp) 或[主機上的 Developer Home (Dev Home)](/zh-TW/tools/tools-console/devhome/devhome) 中所示管理您的認證。

**圖 2.   依部署方法區分的 XBOX Deploy 屬性頁** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=2645bd2b57441d389e5d623a215d9602" alt="Push 的 Deploy 屬性頁" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy.png" />

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy_external.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=6956ecceabb322d6b75dae3477011d39" alt="External 的 Deploy 屬性頁" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy_external.png" />

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy_rfpc.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=cc068e6967bb903be4e5a6c57149bd2c" alt="Run from PC 的 Deploy 屬性頁" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy_rfpc.png" />

<a id="layout" />

## XBOX Layout

**XBOX Layout** 屬性頁包含下列屬性。

* **Layout Directory。** 指定配置建置結果的本機目錄。應用程式會從此目錄部署至遠端主機。
* **Exclusion Filter。** 指定不會從建置輸出目錄複製到配置目錄的檔案與檔案類型。請注意，此屬性無法用於排除位於建置輸出目錄之外的檔案。
* **Isolate Configurations。** 設為 **Yes** 時，Visual Studio 在決定要複製到配置目錄的檔案清單時，會將每個建置組態視為個別的輸出。預設值為 **No**。
* **Game OS。** 指定要隨遊戲之鬆散檔案配置一起提供的 Game OS 路徑。
* **Deploy from Outdir。** 設為 **Yes** 時，Visual Studio 會部署建置輸出目錄的內容，而不是在部署前將檔案複製到配置目錄。**Layout Directory**、**Exclusion Filter** 與 **Isolate Configurations** 屬性的值將被忽略。

**圖 3.   XBOX Layout 屬性頁** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_layout.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=996357b982ee8d5b00c0ea2b5252398c" alt="Layout 屬性頁" width="785" height="545" data-path="images/gdk/tools/property_page_layout.png" />

<a id="debugging" />

## 偵錯

**偵錯** 屬性頁包含下列屬性。

* **要啟動的偵錯工具：** 對於 XBOX 專案，請選取 **XBOX Game Core Debugger**。
* **偵錯工具類型。** 指定要使用的偵錯工具類型。設為 Auto 時，會根據 .exe 檔案的內容選取偵錯工具類型。
* **命令引數。** 要傳遞給應用程式的命令列引數。
* **Log Module Loading。** 啟用詳細資訊偵錯輸出，其中包含模組載入資訊。**Log Module Loading** 選項適用於偵錯「找不到相依 dll」的問題。

**圖 4.   偵錯屬性頁** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_debug.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=76a15961c2b3b73d8fc332052faa57f8" alt="偵錯屬性頁" width="1172" height="812" data-path="images/gdk/tools/property_page_debug.png" />

<a id="related" />

## 相關屬性頁

還有其他屬性雖然並非 XBOX 獨有，但對於 XBOX 應用程式有必要或建議的設定。這些設定可確保 XBOX 應用程式正常且最佳地運作，如下所示。

**RandomizedBaseAddress：** 必須設為 **Yes**，這是 GDK 專案的預設值。位址空間配置隨機化 (ASLR) 需要此設定才能運作。XBOX 應用程式需要 ASLR。請勿將 **RandomizedBaseAddress** 設為 **No** 或嘗試停用 ASLR。

**RandomizedBaseAddress** 是在 **連結器**/**進階** 屬性頁上設定。

<a id="gamedependency" />

## 遊戲相依性查詢

在專案中指定遊戲相依性時，除了遊戲根目錄 G: 及其所有子目錄之外，還會查看本機路徑以尋找相依的檔案。

<a id="ID4EIIAC" />

## 另請參閱

[應用程式管理 (xbapp.exe)](/zh-TW/tools/tools-console/commandlinetools/xbapp)

[Connect (xbconnect.exe)](/zh-TW/tools/tools-console/commandlinetools/xbconnect)

[將遊戲部署至 XBOX 開發套件](/zh-TW/home/setup-install/concepts/deployment)

[操作說明：使用 Visual Studio 部署遊戲資源檔](/zh-TW/tools/tools-console/visualstudio/how-to-deploy-resources)


## Related topics

- [Visual Studio 2022 GDK 支援注意事項](/zh-TW/tools/tools-console/visualstudio/vs-2022-support-notes.md)
- [Visual Studio 2026 GDK 支援注意事項](/zh-TW/tools/tools-console/visualstudio/vs-2026-support-notes.md)
- [Visual Studio](/zh-TW/tools/tools-console/visualstudio/index.md)
- [使用 Visual Studio 偵錯 XBOX 專案](/zh-TW/tools/tools-console/visualstudio/debugging-with-visualstudio.md)
- [XBOX Gaming Project Control](/zh-TW/tools/tools-console/visualstudio/xbox-gaming-project-control.md)
