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

# Microsoft Game Development Kit (GDK) 移植指南

> 從 XBOX One ERA、FXC、Steamworks 以及其他來源平台與引擎,將現有遊戲移植到 XBOX GDK 的指引索引。

請將本頁作為 GDK 移植主題的技術參考索引。若需要以來源平台為導向的引導式路徑,請從「入門」的移植概觀開始。

> [card] [引導式移植路徑(入門)](https://docs.xbox.com/zh-TW/paths/porting/overview.md)
>
> 選擇你的來源平台(Steam、先前世代的 XBOX、其他主機或 PC),並依照精選路徑進行。

## 跳到你的來源平台

> [card] [從 Steam](https://docs.xbox.com/zh-TW/paths/porting/from-steam.md)
>
> Steamworks 到 GDK 的功能對應。

> [card] [從先前世代的 XBOX](https://docs.xbox.com/zh-TW/paths/porting/from-xbox-era.md)
>
> XBOX One ERA 與 XDK 到 GDK。

> [card] [從其他平台](https://docs.xbox.com/zh-TW/paths/porting/from-console.md)
>
> 從其他主機或平台移植到 XBOX Series X|S 主機。

> [card] [從 PC(非 Steam)](https://docs.xbox.com/zh-TW/paths/porting/from-pc.md)
>
> 從 Win32 或與商店無關的 PC 遊戲移植到 XBOX 與 Microsoft Store。

## 技術主題

### XBOX One ERA 到 GDK

涵蓋 WinRT 樣式 API 的替換、非同步模式移轉(`IAsyncOperation` 到 `XAsyncBlock` 或 `XTaskQueue`)、記憶體模型變更(ERA 記憶體管理員到 `XMemAlloc`),以及封裝移轉至 MSIXVC。

* [現有 ERA 遊戲的移植指南](https://docs.xbox.com/zh-TW/build/console-features/porting-from-xbox-one-era/porting-guide-for-existing-era.md):從 XBOX One ERA 移轉到 GDK 的逐步指南,包括記憶體模型變更與 API 替換。

### 著色器:FXC 到 DXC

DirectX Shader Compiler(DXC)是現代的 HLSL 編譯器。FXC 到 DXC 的移植指南涵蓋新的命令列旗標、更新後的 HLSL 語言語意,以及 Visual Studio 中的工具整合。

### GameInput 移植

從 `Windows.XBOX.Input` 與 XInput 移轉到統一的 [GameInput](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-overview.md) API。涵蓋裝置列舉、狀態讀取、震動與 PIX 整合。另請參閱[輸入移植:XInput 與 WGI](https://docs.xbox.com/zh-TW/build/core-features/common/input/porting/input-porting-xinput.md)。

### Steamworks 到 GDK 與 Microsoft Store

適用於在 Steam 上推出的 PC 遊戲的功能對應:

* 成就對應到 XSAPI 成就。
* 雲端存檔對應到 Connected Storage(`XGameSave`)。
* 好友與狀態對應到 XSAPI 社交功能。
* 多人遊戲對應到 MPSD 或 PlayFab Multiplayer Lobby。
* 應用程式內購買對應到 `XStore`。

完整指南:[從 Steam 移植](https://docs.xbox.com/zh-TW/paths/porting/from-steam.md)。

### 引擎

若使用中介軟體,請從各引擎專屬的 PC 端對端指南開始:

* [Unity](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unity/unity.md)
* [Unreal](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unreal/unreal.md)
* [GameMaker](https://docs.xbox.com/zh-TW/build/gdk-and-engines/gamemaker.md)
* [Godot](https://docs.xbox.com/zh-TW/build/gdk-and-engines/godot.md)
* [自製 C 與 C++ 引擎](https://docs.xbox.com/zh-TW/build/gdk-and-engines/custom-engine.md)
* [概觀:GDK 與遊戲引擎](https://docs.xbox.com/zh-TW/build/gdk-and-engines/gdk-and-engines.md)

## 另請參閱

* [開發新的 GDK 遊戲](https://docs.xbox.com/zh-TW/home/build-first-title/developing-new-titles.md)
* [跨世代開發](https://docs.xbox.com/zh-TW/build/console-features/cross-gen/cross-gen-overview.md)
* [封裝](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging.md)


## Related topics

- [使用者與輸入裝置](https://docs.xbox.com/zh-TW/build/core-features/common/user/users-input-devices.md)
- [搭配 Microsoft Game Development Kit (GDK) 使用 Clang](https://docs.xbox.com/zh-TW/tools/tools-pc/visualstudio/gr-vs-clang.md)
- [Microsoft Game Development Kit (GDK) 的系統 API 參考資料](https://docs.xbox.com/zh-TW/reference/system/gc-reference-system-toc.md)
- [Steam 移植指南概觀](https://docs.xbox.com/zh-TW/build/steam-porting-guide/overview.md)
- [輸入](https://docs.xbox.com/zh-TW/build/core-features/common/input/gc-input-toc.md)