> ## 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 GDK 的移植指南

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

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

<Card title="引导式移植路径(入门指南)" icon="compass" href="/paths/porting/overview">
  选择你的源平台(Steam、上一代 XBOX、其他主机或 PC),然后按照精选路径进行。
</Card>

## 直达你的源平台

<CardGroup cols={2}>
  <Card title="来自 Steam" icon="steam" href="/paths/porting/from-steam">
    Steamworks 至 GDK 的功能映射。
  </Card>

  <Card title="来自上一代 XBOX" icon="xbox" href="/paths/porting/from-xbox-era">
    XBOX One ERA 与 XDK 至 GDK。
  </Card>

  <Card title="来自其他平台" icon="gamepad" href="/paths/porting/from-console">
    从其他主机或平台迁移到 XBOX Series X|S 主机。
  </Card>

  <Card title="来自 PC(非 Steam)" icon="desktop" href="/paths/porting/from-pc">
    从 Win32 或与商店无关的 PC 移植到 XBOX 与 Microsoft Store。
  </Card>
</CardGroup>

## 技术主题

### XBOX One ERA 至 GDK

涵盖 WinRT 风格的 API 替换、异步模式迁移(`IAsyncOperation` 到 `XAsyncBlock` 或 `XTaskQueue`)、内存模型变更(ERA 内存管理器到 `XMemAlloc`),以及打包迁移到 MSIXVC。

* [现有 ERA 游戏移植指南](/build/console-features/porting-from-xbox-one-era/porting-guide-for-existing-era):从 XBOX One ERA 到 GDK 的逐步迁移,涵盖内存模型变更与 API 替换。

### 着色器:FXC 至 DXC

DirectX Shader Compiler (DXC) 是现代 HLSL 编译器。FXC 至 DXC 的移植指南涵盖新的命令行参数、更新后的 HLSL 语言语义,以及在 Visual Studio 中的工具集成。

### GameInput 移植

从 `Windows.XBOX.Input` 与 XInput 迁移到统一的 [GameInput](/build/core-features/common/input/overviews/input-overview) API。涵盖设备枚举、状态读取、振动与 PIX 集成。另请参阅[输入移植:XInput 与 WGI](/build/core-features/common/input/porting/input-porting-xinput)。

### Steamworks 至 GDK 与 Microsoft Store

面向在 Steam 上发布的 PC 游戏的功能映射:

* 成就至 XSAPI 成就。
* 云存档至 Connected Storage (`XGameSave`)。
* 好友与在线状态至 XSAPI 社交。
* 多人游戏至 MPSD 或 PlayFab Multiplayer Lobby。
* 应用内购买至 `XStore`。

完整指南:[从 Steam 移植](/paths/porting/from-steam)。

### 引擎

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

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

## 参见

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


## Related topics

- [通用移植指南](/zh-CN/paths/porting/guides.md)
- [Steam 移植指南概览](/zh-CN/build/steam-porting-guide/overview.md)
- [移植概览](/zh-CN/paths/porting/overview.md)
- [仅通过向后兼容支持的跨世代游戏](/zh-CN/build/console-features/cross-gen/cross-gen-backcompat-only.md)
- [从上一代 XBOX 移植](/zh-CN/paths/porting/from-xbox-era.md)