面向 XBOX 开发的 Visual Studio 属性

​

访问 XBOX 属性页

1. 在解决方案资源管理器中，右键单击项目名称，然后选择属性。
2. 展开配置属性。
3. 查看 XBOX General、XBOX Deploy、XBOX Layout 与调试属性页。

• XBOX General
• XBOX Deploy
• XBOX Layout
• 调试
• 相关属性页
• 游戏依赖项查找

​

XBOX General

• Gaming Edition Target. 指定生成项目所使用的 GDK 版本。默认为你的开发 PC 上安装的最高 GDK 版本。
• Gaming Extension Libraries. 指定要使用的 Gaming Extension 库集合（例如 Xbox.Services.API.C）。
• Alternate Binary Subdirectory 此可选属性用于指定游戏根目录下用于二进制文件与 CRT 依赖项的子目录。它用于镜像 Layout 文件夹中的结构，并将被调试器用于在调试时定位可执行文件。指定子目录时，MicrosoftGame.config 仍应位于游戏的根目录中。同时也需要更新 MicrosoftGame.config 中可执行文件位置的相关路径。
• Remote IP Address. 指定远程主机名或 IP 地址。这是部署、运行和调试所生成项目的目标主机。如果此属性留空或设置为空，将使用由 Connect (xbconnect.exe)、XBOX Manager 或 Windows Device Portal 指定的默认远程主机。
• Package Localization Dir. 指定一个相对于项目目录的可选目录，用于在创建本地化 shell 资源时使用。有关向项目添加本地化资源的更多信息，请参阅 MicrosoftGame.config localization。

图 1. XBOX General 属性页

  <?xml version="1.0" encoding="utf-8"?>  
  <Project ToolsVersion="4.0" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">  
    <PropertyGroup>  
      <RemoteAddress>10.10.10.10</RemoteAddress>  
    </PropertyGroup>  
  </Project>  

​

XBOX Deploy

​

XBOX Deploy 方式：Push（从开发套件运行）

• Deployment folder path override. 可选属性，用于覆盖开发套件上的默认部署路径。
• Remove extra files from target device. 可选属性，选中时会移除主机上不属于当前项目构建输出的文件（孤立文件）。

​

XBOX Deploy 方式：External（不使用 Visual Studio 部署）

• Title launch string. 启动调试（F5）时用于启动游戏的启动字符串。
• Target devkit titles. 从目标开发套件上与当前项目匹配的游戏列表中选择，用于填充游戏启动字符串。

​

XBOX Deploy 方式：Run from PC（注册网络共享）

• Network share path override. 可选属性，用于覆盖 Run From PC 部署时的默认网络共享路径。
• Network share username. 可选属性，用于访问需要凭据的网络共享位置（SMB 网络共享）。
• Network share password. 可选属性，用于访问需要凭据的网络共享位置（SMB 网络共享）。

注意： 此用户名和密码以纯文本方式传输，并以纯文本形式在本地存储。为了提高安全性，请将此字段留空，并按 XBOX Device Portal (Windows Device Portal on XBOX) 或 Developer Home on the Console (Dev Home) 中所述来管理你的凭据。

图 2. 基于部署方式的 XBOX Deploy 属性页

​

XBOX Layout

• Layout Directory. 指定用于放置构建结果的本地目录。应用会从该目录部署到远程主机。
• Exclusion Filter. 指定不会从构建输出目录复制到 Layout 目录的文件与文件类型。请注意，此属性无法排除位于构建输出目录之外的文件。
• Isolate Configurations. 设置为 Yes 时，Visual Studio 会将每个生成配置视为独立的输出，用于确定复制到 Layout 目录的文件列表。默认值为 No。
• Game OS. 指定 Game OS 的路径，该 Game OS 会随游戏的松散文件布局一起提供。
• Deploy from Outdir. 设置为 Yes 时，Visual Studio 会部署构建输出目录的内容，而不会在部署前将文件复制到 Layout 目录。Layout Directory、Exclusion Filter 和 Isolate Configurations 属性的值将被忽略。

图 3. XBOX Layout 属性页

​

调试

• 要启动的调试器： 对于 XBOX 项目，选择 XBOX Game Core Debugger。
• Debugger Type. 指定要使用的调试器类型。设置为 Auto 时，将根据 .exe 文件的内容选择调试器类型。
• Command Arguments. 传递给应用的命令行参数。
• Log Module Loading. 启用详细的调试输出，其中包含模块加载信息。Log Module Loading 选项在调试 “找不到依赖 dll” 类问题时很有用。

图 4. 调试属性页

​

相关属性页

​

游戏依赖项查找

​

另请参阅