> ## 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 游戏开发工具包 (GDK) 移植指南

> 面向 XBOX GDK 移植的指南索引,涵盖从 XBOX One ERA、FXC、Steamworks 及其他源平台与引擎迁移到 GDK。

将本页作为 GDK 移植主题的技术参考索引。若要获得按源平台优先的引导式路径,请从入门指南中的移植概览开始。

> [card] [引导式移植路径(入门指南)](https://docs.xbox.com/zh-CN/paths/porting/overview.md)
>
> 选择你的源平台(Steam、上一代 XBOX、其他主机或 PC),然后按照精选路径进行。

## 直达你的源平台

> [card] [来自 Steam](https://docs.xbox.com/zh-CN/paths/porting/from-steam.md)
>
> Steamworks 至 GDK 的功能映射。

> [card] [来自上一代 XBOX](https://docs.xbox.com/zh-CN/paths/porting/from-xbox-era.md)
>
> XBOX One ERA 与 XDK 至 GDK。

> [card] [来自其他平台](https://docs.xbox.com/zh-CN/paths/porting/from-console.md)
>
> 从其他主机或平台迁移到 XBOX Series X|S 主机。

> [card] [来自 PC(非 Steam)](https://docs.xbox.com/zh-CN/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-CN/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-CN/build/core-features/common/input/overviews/input-overview.md) API。涵盖设备枚举、状态读取、振动与 PIX 集成。另请参阅[输入移植:XInput 与 WGI](https://docs.xbox.com/zh-CN/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-CN/paths/porting/from-steam.md)。

### 引擎

针对中间件,请从各引擎特定的 PC 端到端指南开始:

* [Unity](https://docs.xbox.com/zh-CN/build/gdk-and-engines/unity/unity.md)
* [Unreal](https://docs.xbox.com/zh-CN/build/gdk-and-engines/unreal/unreal.md)
* [GameMaker](https://docs.xbox.com/zh-CN/build/gdk-and-engines/gamemaker.md)
* [Godot](https://docs.xbox.com/zh-CN/build/gdk-and-engines/godot.md)
* [自定义 C 与 C++ 引擎](https://docs.xbox.com/zh-CN/build/gdk-and-engines/custom-engine.md)
* [概览:GDK 与游戏引擎](https://docs.xbox.com/zh-CN/build/gdk-and-engines/gdk-and-engines.md)

## 参见

* [开发一款新的 GDK 游戏](https://docs.xbox.com/zh-CN/home/build-first-title/developing-new-titles.md)
* [跨世代开发](https://docs.xbox.com/zh-CN/build/console-features/cross-gen/cross-gen-overview.md)
* [打包](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/overviews/packaging.md)


## Related topics

- [Microsoft 游戏开发工具包示例](https://docs.xbox.com/zh-CN/home/setup-install/samples.md)
- [Microsoft 游戏开发工具包入门（内容）](https://docs.xbox.com/zh-CN/home/setup-install/get-started.md)
- [Microsoft 游戏开发工具包用户模型](https://docs.xbox.com/zh-CN/build/core-features/common/user/gamecore-user-models.md)
- [访问 Microsoft 游戏开发工具包 (GDK) 开发资源](https://docs.xbox.com/zh-CN/home/onboarding-access/access-resources.md)
- [Microsoft 游戏开发工具包 (GDK) 系统 API 参考资料](https://docs.xbox.com/zh-CN/reference/system/gc-reference-system-toc.md)