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

# MicrosoftGame.config 编辑器

> MicrosoftGame.config 编辑器

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

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

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

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

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

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

![可执行文件启动](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)

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

![开始菜单启动](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)

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

![工具列表启动](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)

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

![命令行启动](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)

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

![命令行启动 2](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)

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

![MicrosoftGame.config 编辑器的初始窗口](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)

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

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

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

## 创建新的 MicrosoftGame.config 文件

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

![输入新配置文件](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)

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

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

![输入现有配置文件](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)

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

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

![已指定可执行文件的编辑器](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)

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

![缺少可执行文件](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)

![缺少可执行文件](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)

## 与 Microsoft Store 关联

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

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

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

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

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

![商店关联向导](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)

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

## 生成磁贴图像

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

![磁贴图像](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)

## 添加特定平台功能

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

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

![添加功能](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)

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

![添加功能列表](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)

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

![添加功能列表](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)

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

![添加功能列表](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)

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

![添加功能列表](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)

## 提供反馈

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

![发送反馈](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)

## 文档链接

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

![文档](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)

## 另请参阅

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


## Related topics

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