> ## 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.

# MicrosoftGame.config 编辑器

> MicrosoftGame.config 编辑器

MicrosoftGame.config 编辑器是一个用于创建和编辑 MicrosoftGame.config 文件的 UI 工具。该编辑器既作为独立工具提供，也作为集成到 Visual Studio IDE 中的组件提供。

该编辑器目前具有以下功能。

* **平台选项卡**：除了"常规"选项卡之外，还有特定平台的选项卡，允许编辑该平台的独有功能。所有平台共享的功能都在"常规"选项卡中。
* **可执行文件**：此部分允许指定与你的标题关联的可执行文件。
* **目标设备系列（平台）**：此部分允许指定你的标题打算运行的目标设备。
* **商店信息**：此部分允许将你本地的 MicrosoftGame.config 与你的合作伙伴中心实例中现有的商店数据相关联。
* **磁贴图像**：此部分允许提供产品的源输入磁贴图像，然后会以适当的分辨率自动生成所有其他所需图像。

## 启动独立版的 MicrosoftGame.config 编辑器

要启动独立版 MicrosoftGame.config 编辑器，你可以执行以下操作：

* 导航到 GDK bin 文件夹（例如 C:\Program Files (x86)\Microsoft GDK\bin），双击 GameConfigEditor.exe。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_ExeLaunch.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=c46c91a3b3136dc474f35aa049ae5edb" alt="可执行文件启动" width="355" height="257" data-path="images/gdk/features/common/GameConfig_ExeLaunch.png" />

* 在"开始"菜单中的 Microsoft GDK 文件夹中，选择 MicrosoftGame.config 编辑器图标。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_StartMenu.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=8d52866f48c11a90cd5a1e58e81c6a47" alt="开始菜单启动" width="261" height="390" data-path="images/gdk/features/common/GameConfig_StartMenu.png" />

* 在"开始"菜单中的 Microsoft GDK 文件夹中，打开任意 Gaming Command Prompt 并输入 GameConfigEditor.exe。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_MiniLauncher.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=765bdb85b1848f9d47b895bf8448382a" alt="工具列表启动" width="524" height="297" data-path="images/gdk/features/common/GameConfig_MiniLauncher.png" />

* 在任何 GDK UX 工具中，展开"Tools"下拉菜单并选择 MicrosoftGame.config 编辑器。MicrosoftGame.config 编辑器中也集成了"Tools"下拉菜单，可快速导航到其他工具。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Cmdline.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=f819fb999e9c4d87e77b495d86957799" alt="命令行启动" width="951" height="247" data-path="images/gdk/features/common/GameConfig_Cmdline.png" />

* 在"开始"菜单中的 Microsoft GDK 文件夹中，打开任意 Gaming Command Prompt 并输入 GameConfigEditor.exe 加上现有 MicrosoftGame.config 的路径或者要生成的目标文件夹路径作为参数。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Cmdline2.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=ebc45d194a46dea87793deca2e32fc68" alt="命令行启动 2" width="957" height="139" data-path="images/gdk/features/common/GameConfig_Cmdline2.png" />

启动编辑器时出现的"创建或编辑 MicrosoftGame.config"窗口将提示打开现有的 MicrosoftGame.config 文件或创建新的 MicrosoftGame.config 文件，然后会在编辑器中打开。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Editor1.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=8365e8dd245c96a042445f294e173924" alt="MicrosoftGame.config 编辑器的初始窗口" width="582" height="209" data-path="images/gdk/features/common/GameConfig_Editor1.png" />

## 从 Visual Studio 中启动 MicrosoftGame.config 编辑器

MicrosoftGame.config 编辑器在 Visual Studio 中被注册为 .mgc 文件的编辑器。要从 Visual Studio 内启动 MicrosoftGame.config 编辑器，请在**解决方案资源管理器**中双击游戏配置文件。

<Note>如果你的配置文件扩展名不是 .mgc（例如 .config），必须先重命名它，才能使用 MicrosoftGame.config 编辑器打开。</Note>

## 创建新的 MicrosoftGame.config 文件

要创建新的 MicrosoftGame.config 文件，请在初始窗口中浏览到你标题的根文件夹，然后选择**创建**以在该文件夹中生成新文件并在编辑器中打开。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_NewConfig1.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=734f074450610d3c77393c30ff6effbf" alt="输入新配置文件" width="582" height="206" data-path="images/gdk/features/common/GameConfig_NewConfig1.png" />

## 编辑现有的 MicrosoftGame.config 文件

如果 MicrosoftGame.config 文件已经存在，请在初始窗口中浏览到该文件，然后选择**编辑**以在编辑器中打开现有文件。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_ExistingConfig1.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=e5d67c1ae356607da091c28812cb6930" alt="输入现有配置文件" width="582" height="202" data-path="images/gdk/features/common/GameConfig_ExistingConfig1.png" />

## 在 MicrosoftGame.config 文件中指定你的标题可执行文件和目标设备系列

在 MicrosoftGame.config 编辑器窗口中，首先需要输入的是指定你的标题可执行文件所在的位置。可以通过在编辑器的"可执行文件"部分中浏览并选择你的标题可执行文件来设置。除了指定标题可执行文件之外，还必须指定该可执行文件打算在哪个平台上运行。有关目标设备系列规范的更多信息，请参阅 [MicrosoftGame.config 概述](/build/core-features/common/game-config/MicrosoftGameConfig-Overview)部分。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Editor2.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=7b72173102ca425079f884032a3f173a" alt="已指定可执行文件的编辑器" width="882" height="755" data-path="images/gdk/features/common/GameConfig_Editor2.png" />

未指定可执行文件时，仍可以生成和编辑 MicrosoftGame.config 文件，但编辑器将警告在设置可执行文件之前无法部署或启动标题。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_MissingExe.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=7dfc2871f186620a410f71640a78be27" alt="缺少可执行文件" width="650" height="85" data-path="images/gdk/features/common/GameConfig_MissingExe.png" />

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_MissingExe2.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=5c9605a8bfd6bc880ed0f1a2b7edcd38" alt="缺少可执行文件" width="404" height="166" data-path="images/gdk/features/common/GameConfig_MissingExe2.png" />

## 与 Microsoft Store 关联

你的标题必须在[合作伙伴中心](https://partner.microsoft.com/dashboard)中启用 XBOX services 进行配置，才能使用"商店关联向导"。此外，关联的[合作伙伴中心](https://partner.microsoft.com/dashboard)帐户必须被分配以下角色之一：

* 经理 (Windows)
* 开发人员
* 业务贡献者
* 财务贡献者
* 营销人员

如果你的帐户未被分配到这些角色之一，可以分配自定义权限。使用"商店关联向导"需要为你的帐户分配"沙盒"帐户级权限，以及以下三个产品级权限之一：

* 产品级权限：光盘
* 产品级权限：发布
* 产品级权限：XBOX Live

在确保你拥有正确的权限后，选择**与 Microsoft Store 关联**按钮以通过"商店关联向导"来拉取关联的标题信息并将其保存到你本地的 MicrosoftGame.config 文件中。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_SAW1.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=3cf179745334afc539849e87acace90e" alt="商店关联向导" width="785" height="590" data-path="images/gdk/features/common/GameConfig_SAW1.png" />

<Note>完成"商店关联向导"后，在 MicrosoftGame.config 编辑器中选择**保存**，将更改写入你项目的 MicrosoftGame.config。</Note>

## 生成磁贴图像

要生成用于 Microsoft Store 的标题图像，请选择磁贴图像，然后浏览并提供一个 480x480 的 .PNG 文件作为输入。选择文件后，所有其他图像都将以此为源输入自动更新，并适当调整大小以匹配所需的分辨率。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Images.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=a6aa49c9dc32dffe573b12a8713205b4" alt="磁贴图像" width="571" height="154" data-path="images/gdk/features/common/GameConfig_Images.png" />

## 添加特定平台功能

从 2021 年 4 月 GDK 开始，MicrosoftGame.config 编辑器现在具备在 XBOX 和 PC 选项卡内添加和删除特定平台功能的功能。

功能菜单允许添加新功能、删除现有功能以及选择和配置现有功能的值。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Elements.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=3fb07d3d2006482f114e56a643c23e46" alt="添加功能" width="864" height="561" data-path="images/gdk/features/common/GameConfig_Elements.png" />

要添加功能，请选择**新增**按钮。将呈现该平台可用功能的列表。选中复选框并选择"添加"将把该功能条目添加到功能列表中以进行进一步的属性配置。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Elements_2.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=1e612a9fe8c4cb0a00c7db1bf210ab73" alt="添加功能列表" width="703" height="503" data-path="images/gdk/features/common/GameConfig_Elements_2.png" />

已添加的功能将显示在**新增**列表的底部，以黄色文本指示该功能已存在，并且只能指定一次。对于可以添加多次的功能，再次从**新增**菜单中选择该功能并选择"添加"，将向功能列表中添加该类型的另一个功能条目。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Elements_3.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=0ca1a250f4101e0924abeb5ae0802f7c" alt="添加功能列表" width="494" height="453" data-path="images/gdk/features/common/GameConfig_Elements_3.png" />

要删除某功能，请导航到功能列表中的**删除**按钮，在提示时选择"是"以确认要从功能列表中删除该功能。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Elements_4.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=60ca0abbca1c4f65b2243664117461b4" alt="添加功能列表" width="731" height="242" data-path="images/gdk/features/common/GameConfig_Elements_4.png" />

大多数功能需要在保存到 MicrosoftGame.config 文件之前配置其属性。在某些情况下，某个功能可能因缺少信息而被视为无效，将在保存时被删除，并附有指示导致删除的缺失值的详细信息。请重新添加并适当地重新配置功能属性，以确保在 MicrosoftGame.config 编辑器中保存时能够保留。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Error.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=e08de44cbdd0642cd10a1e8263d77392" alt="添加功能列表" width="397" height="152" data-path="images/gdk/features/common/GameConfig_Error.png" />

## 提供反馈

MicrosoftGame.config 编辑器从 2021 年 2 月 GDK 起可供使用。请使用建议菜单项对现有功能提供反馈或请求其他功能。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Feedback.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=49bcd4775d734ca945c7a5e85a9b583b" alt="发送反馈" width="187" height="82" data-path="images/gdk/features/common/GameConfig_Feedback.png" />

## 文档链接

有关 MicrosoftGame.config 编辑器和相关元素的更多信息，请在 MicrosoftGame.config 编辑器中单击"文档"链接。

<img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Documentation.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=43f490d90de3279c1be8fb7801c858ce" alt="文档" width="186" height="68" data-path="images/gdk/features/common/GameConfig_Documentation.png" />

## 另请参阅

[MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-toc)
[MicrosoftGame.config 概述](/build/core-features/common/game-config/MicrosoftGameConfig-Overview)
[MicrosoftGame.config 参考（示例 MicrosoftGame.config 和架构）](/reference/system/microsoftgameconfig/microsoftgameconfig-schema)
[打包概述](/build/core-features/common/packaging/overviews/packaging)


## Related topics

- [MicrosoftGame.config 编辑器与参考](/zh-CN/build/core-features/common/game-config/index.md)
- [MicrosoftGame.config 概述](/zh-CN/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md)
- [MicrosoftGame.config](/zh-CN/build/core-features/common/game-config/MicrosoftGameConfig-toc.md)
- [MicrosoftGame.config 本地化](/zh-CN/build/core-features/common/game-config/MicrosoftGameConfig-Localization.md)
- [XBOX 主机游戏打包入门](/zh-CN/build/core-features/common/packaging/overviews/packaging-getting-started-for-console.md)