安装程序发布

本文档介绍了如何使用游戏安装程序在 Google Play 游戏电脑版上发布游戏。

在“开发者安装”流程中，您提供的游戏安装程序必须管理游戏的安装、更新和卸载。

准备工作

将 Google Play Games SDK 集成到游戏中。

将游戏打包为 WAB 文件

Google Play 游戏电脑版要求您将游戏的安装程序作为 Windows app bundle (WAB) 文件上传到 Google Play 管理中心。如需创建 WAB 文件，请按以下步骤操作：

  1. 下载 Play 发布工具。 您可以在 Windows 命令行或 PowerShell 中运行此工具。

  2. 创建 Play 发布配置文件，名称随意。例如，play_publishing_config.xml 采用以下格式：

    <?xml version="1.0" encoding="UTF-8"?>
<play-publishing-config version="1.0">
  <application>
    <package-name>PACKAGE_NAME</package-name>
    <version-name>VERSION_NAME</version-name>
  </application>
  <installer requiresElevation=INSTALLER_REQUIRES_ELEVATION>
    <path>INSTALLER_PATH</path>
    <installation-path-registry-location>
      <key-name>UNIQUE_REGISTRY_PATH</key-name>
      <value-name>InstallLocation</value-name>
    </installation-path-registry-location>
  </installer>
  <launcher requiresElevation=LAUNCHER_REQUIRES_ELEVATION>
    <launch-path-registry-location>
      <key-name>UNIQUE_REGISTRY_PATH</key-name>
      <value-name>InstallLocation</value-name>
    </launch-path-registry-location>
    <executable-invocation>
      <filename>RELATIVE_PATH_TO_LAUNCHER_EXE</filename>
      <arguments>LAUNCHER_ARGS_IF_ANY</arguments>
    </executable-invocation>
  </launcher>
  <uninstaller requiresElevation=UNINSTALLER_REQUIRES_ELEVATION>
    <uninstall-path-registry-location>
      <key-name>UNIQUE_REGISTRY_PATH</key-name>
      <value-name>UninstallString</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>

    请替换以下内容：

    • PACKAGE_NAME：游戏的软件包名称。 这是将与您的游戏相关联的唯一标识符。例如 com.yourcompany.yourgame。 软件包名称必须遵循以下规则：
      • 必须至少包含两段（一个或多个圆点）。
      • 每段必须以字母开头。
      • 所有字符必须为字母数字或下划线 ([a-zA-Z0-9_])。

    • VERSION_NAME：游戏的版本字符串。这可以是任意字符串，但必须在您游戏的所有已上传 WAB 中保持唯一。例如：1.0、1.0.1-beta、2025.11.24、v1.rc1。

      • INSTALLER_REQUIRES_ELEVATION：指示安装程序可执行文件是否需要以管理员身份运行才能完成安装过程。

        • “true”：以管理员身份运行可执行文件。
        • “false”：以当前用户身份运行可执行文件。

      • INSTALLER_PATH：WAB 中安装程序文件的路径。此路径可以是绝对路径，也可以是相对于 Play 发布配置父目录的相对路径。例如，path\to\test\installer。 请务必使用 Authenticode 和代码签名为游戏的安装程序可执行文件签名。

      • UNIQUE_REGISTRY_PATH：将包含所有注册表信息的根密钥。在整个用户机器中必须是唯一的。这将是 HKLM 之上的相对路径。例如，SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName。 此条目将在 64 位 Windows 11 计算机上的 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName 下创建根密钥。

      • LAUNCHER_REQUIRES_ELEVATION：指示每次启动启动器或游戏可执行文件时是否需要以管理员身份运行。

        • “true”：以管理员身份运行可执行文件。
        • “false”：以当前用户身份运行可执行文件。

      • RELATIVE_PATH_TO_LAUNCHER_EXE：安装目录中启动器或游戏可执行文件的路径。必须包含启动器或游戏可执行文件名。例如，如果启动器或游戏文件名为 mygame.exe，且位于 {INSTALL_DIR}\Resources\mygame.exe 下，则必须将 Resources\mygame.exe

      • LAUNCHER_ARGS_IF_ANY：需要传递到启动器或游戏中的任何命令行实参。 此条目是可选的。

        • 如果可执行文件关联了多个实参，则需要用空格分隔这些实参。
        • 如果可执行文件需要，则需要在实参前添加“--”或“-”。

      • UNINSTALLER_REQUIRES_ELEVATION：指示是否需要以管理员身份运行卸载程序可执行文件才能完成卸载过程。

        • “true”：以管理员身份运行可执行文件。
        • “false”：以当前用户身份运行可执行文件。

    Play 发布配置文件示例

    假设有一款名为 MyGame 的游戏，其游戏安装程序为 game_installer.exe，游戏启动器为 launcher.exe。该示例还展示了如何使用 CDATA。 play_publishing_config.xml 的显示效果如下：

    <?xml version="1.0" encoding="UTF-8"?>

<play-publishing-config version="1.0">
  <application>
    <package-name>com.mycompany.mygame</package-name>
    <version-name>1.0.0</version-name>
  </application>
  <installer requiresElevation="true">
    <path>game_installer.exe</path>
    <installation-path-registry-location>
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <value-name>InstallLocation</value-name>
    </installation-path-registry-location>
  </installer>

  <launcher requiresElevation="true">
    <launch-path-registry-location >
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <value-name>InstallLocation</value-name>
    </launch-path-registry-location>
    <executable-invocation>
      <filename>launcher.exe</filename>
      <arguments><![CDATA[arg1&arg2>arg3]]></arguments>
    </executable-invocation>
  </launcher>

  <uninstaller requiresElevation="true">
    <uninstall-path-registry-location>
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <value-name>UninstallString</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>

  3. 在 Windows 命令行或 PowerShell 中运行 Play 发布工具。

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH

    如需覆盖同名的现有 WAB 文件，请使用 --force 实参。

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force

    请替换以下内容：

    • PLAY_PUBLISHING_CONFIG_PATH：Play 发布配置的路径。例如 path\to\play_publishing_config.xml。
    • WAB_OUTPUT_PATH：WAB 文件的路径。 例如 path\to\output_bundle.wab。

    如何使用 Play 发布工具

    假设您在当前工作目录中拥有 Play 发布工具二进制文件 playpublishingtool.exe、Play 发布配置 play_publishing_config.xml 和游戏安装程序 game_installer.exe。

    您当前的工作目录应如下所示：

    .\
├── game_installer.exe
├── play_publishing_config.xml
├── playpublishingtool.exe

    如需在同一目录中创建名为 installer_bundle.wab 的 WAB，命令如下所示：

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab

    使用 --force 实参时，命令如下所示：

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force

    成功后，您应该会看到类似如下所示的输出：

    Successfully built the installer bundle at installer_bundle.wab

    在相应文件夹中找到 WAB 文件：

      .\
  ├── game_installer.exe
  ├── installer_bundle.wab
  ├── play_publishing_config.xml
  ├── playpublishingtool.exe

使用 Play 管理中心发布游戏

为游戏成功创建 WAB 后，将其上传到 Play 管理中心，并管理其设置和要求。请按照以下步骤发布游戏：

添加“Google Play 游戏电脑版”设备规格

只有在首次发布游戏时，才需要执行此步骤。

  1. 在 Play 管理中心左侧菜单中，依次选择测试和发布 > 设置 > 高级设置（直接链接）。

  2. 前往外形规格标签页，然后从 + 添加外形规格下拉菜单中添加 Google Play Games on PC。

  3. 点击右侧与 Google Play 游戏电脑版设备规格对应的管理按钮。

  4. 选择为您的 Windows app bundle 游戏使用专用轨道选项。

  5. 点击保存，然后在确认对话框中再次点击保存。

开启自管式发布模式

如需启用受管理的发布，请按以下步骤操作。

  1. 在发布概览页面上的自管式发布部分中，点击开启自管式发布模式。
  2. 系统会显示一个对话框。将该轨道切换为已开启自管式发布模式。
  3. 点击 Save。

上传 WAB 文件

如需上传 WAB 文件，请按以下步骤操作：

  1. 在 Play 管理中心的左侧菜单中，依次选择测试和发布 > 高级设置（直接链接）。
  2. 在高级设置页面中，点击外形规格标签页。
  3. 在外形规格标签页中，点击 + 添加外形规格，然后选择 Google Play 游戏电脑版进行添加。
  4. 在 Google Play Games 电脑版部分，点击管理。
  5. 选择为您的 Windows app bundle 游戏使用专用轨道。
  6. 点击 Save。
  7. 在 Play 管理中心的左侧菜单中，依次选择测试和发布 > 正式版（直接链接）。
  8. 在正式版页面中，从“设备规格”下拉菜单中选择仅限 Google Play 游戏电脑版 (Windows)。
  9. 在 Windows 应用软件包标签页中，点击修改，然后上传 WAB 文件。

配置 Windows PC 要求

如需配置 Windows PC 要求，请执行以下操作：

  1. 在 Play 管理中心的左侧菜单中，依次选择扩大用户群 > 商店发布 > 商店设置（直接链接）。
  2. 在电脑要求部分，点击右侧的修改按钮。
  3. 更新相应字段，然后点击保存。

配置应用内购图片

这是一个可选步骤。如需配置应用内购买图形，请执行以下操作：

  1. 在 Play 管理中心的左侧菜单中，依次选择拓展用户 > 商店发布 > 商品详情（直接链接）。
  2. 在商品详情标签页的默认商品详情部分中，点击右侧的 ->（箭头）按钮。系统会将您转到默认商品详情页面。
  3. 前往 Google Play Games 电脑版部分，然后在 Google Play Games 电脑版 (Windows) 应用内购买图片中上传图片。
  4. 点击 Save。

将更改内容送审

  1. 在 Play 管理中心的左侧菜单中，选择发布概览。
  2. 在更改内容尚未送审部分中，点击送审更改内容。

当审核团队批准您的更改后，您的游戏将可在 Google Play 上被发现。