發布安裝程式

本文說明如何使用遊戲安裝程式,在 Google Play 遊戲電腦版發布遊戲。

在「開發人員安裝」流程中,您提供的遊戲安裝程式必須管理遊戲的安裝、更新和解除安裝作業。

事前準備

Google Play 遊戲 SDK 整合至遊戲。

將遊戲封裝為 WAB 檔案

如要使用 Google Play 遊戲電腦版,請將遊戲的安裝程式以 Windows 應用程式套件 (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:遊戲的套件名稱。 這是與 Google Play 上的遊戲相關聯的專屬 ID。例如:com.yourcompany.yourgame。套件名稱必須遵循下列規則:
      • 必須包含至少兩個區隔 (一或多個點)。
      • 每個區隔的開頭都必須是英文字母。
      • 所有字元都必須為英數字元或底線 ([a-zA-Z0-9_])。
    • VERSION_NAME:遊戲的版本字串。可以是任意字串,但必須與遊戲上傳的所有 WAB 都不重複。例如:1.01.0.1-beta2025.11.24v1.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」:以目前使用者身分執行可執行檔。

    Google 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 應用程式套件遊戲的專屬測試群組」選項。

  5. 依序點選「儲存」和確認對話方塊中的「儲存」

開啟控管型發布

如要開啟受管理發布功能,請按照下列步驟操作。

  1. 在「發布總覽」頁面的「控管型發布」部分,按一下「開啟控管型發布」
  2. 畫面隨即會顯示對話方塊。將該測試群組切換為「開啟控管型發布功能」
  3. 按一下 [儲存]

上傳 WAB 檔案

如要上傳 WAB 檔案,請按照下列步驟操作:

  1. 在 Play 管理中心的左選單中,選取「測試及發布」>「進階設定」 (直接連結)。
  2. 在「進階設定」頁面中,按一下「板型規格」分頁標籤。
  3. 在「板型規格」分頁中,按一下「+ 新增板型規格」,然後選取「Google Play 遊戲電腦版」新增。
  4. 在「Google Play 遊戲電腦版」部分,按一下「管理」
  5. 選取「使用 Windows 應用程式套件遊戲的專屬測試群組」
  6. 按一下 [儲存]
  7. 在 Play 管理中心的左選單中,依序選取「測試及發布」>「正式版」 (直接連結)。
  8. 在「製作」頁面中,從板型規格下拉式選單選取「僅限 Google Play Games 電腦版 (Windows)」
  9. 在「Windows 應用程式套件」分頁中,按一下「編輯」,然後上傳 WAB 檔案。

設定 Windows 電腦規格需求

如要設定 Windows 電腦規格需求,請按照下列步驟操作:

  1. 在 Play 管理中心的左選單中,依序選取「拓展使用者數量」>「商店發布」>「商店設定」 (直接連結)。
  2. 在「電腦需求」部分,按一下右側的「編輯」按鈕。
  3. 更新欄位,然後按一下「儲存」

設定應用程式內購圖片

這個步驟可以省略。如要設定應用程式內購圖像,請按照下列步驟操作:

  1. 在 Play 管理中心左選單中,依序選取「拓展使用者」>「商店發布」>「商店資訊」(直接連結)。
  2. 在「商店資訊」分頁的「預設商店資訊」部分,按一下右側的 -> (箭頭) 按鈕。系統隨即會將您導向「預設商店資訊」頁面。
  3. 前往「Google Play 遊戲電腦版」部分,然後上傳「Google Play 遊戲電腦版 (Windows) 應用程式內購圖片」
  4. 按一下「儲存」

將變更送審

  1. 在 Play 管理中心的左選單中,選取「發布總覽」
  2. 在「尚未送審的變更」部分,按一下「將變更送審」

審查團隊核准變更後,Google Play 就會顯示您的遊戲。