Veröffentlichung von Installationsprogrammen

In diesem Dokument wird beschrieben, wie Sie Ihr Spiel mit dem Installationsprogramm für Ihr Spiel bei Google Play Games auf dem PC veröffentlichen.

Beim Ablauf „Vom Entwickler installiert“ muss das von Ihnen bereitgestellte Installationsprogramm für das Spiel die Installation, Aktualisierung und Deinstallation des Spiels verwalten.

Hinweis

Integrieren Sie das Google Play Games SDK in Ihr Spiel.

Spiel als WAB-Datei verpacken

Für Google Play Games auf dem PC muss das Installationsprogramm Ihres Spiels als WAB-Datei (Windows App Bundle) in die Google Play Console hochgeladen werden. So erstellen Sie eine WAB-Datei:

  1. Laden Sie das Play Publishing-Tool herunter. Sie können dieses Tool über die Windows-Befehlszeile oder PowerShell ausführen.

  2. Erstellen Sie die Play-Veröffentlichungskonfigurationsdatei mit einem beliebigen Namen. Beispiel: play_publishing_config.xml mit dem folgenden Format:

    <?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>

    Ersetzen Sie dabei Folgendes:

    • PACKAGE_NAME: Der Paketname Ihres Spiels. Dies ist die eindeutige Kennung, die Ihrem Spiel bei Google Play zugewiesen wird. Beispiel: com.yourcompany.yourgame. Der Paketname muss den folgenden Regeln entsprechen:
      • Es muss mindestens zwei Segmente (einen oder mehrere Punkte) enthalten.
      • Jedes Segment muss mit einem Buchstaben beginnen.
      • Alle Zeichen müssen alphanumerisch oder ein Unterstrich ([a-zA-Z0-9_]) sein.

    • VERSION_NAME: Der Versionsstring des Spiels. Das kann ein beliebiger String sein, er muss aber für alle hochgeladenen WABs für dein Spiel eindeutig sein. Beispiel: 1.0, 1.0.1-beta, 2025.11.24, v1.rc1.

      • INSTALLER_REQUIRES_ELEVATION: Gibt an, ob die ausführbare Datei des Installationsprogramms als Administrator ausgeführt werden muss, um den Installationsvorgang abzuschließen.

        • „true“: Die ausführbare Datei wird als Administrator ausgeführt.
        • false: Die ausführbare Datei wird als aktueller Nutzer ausgeführt.

      • INSTALLER_PATH: Der Pfad zur Installationsdatei in der WAB. Dieser Pfad kann entweder absolut oder relativ zum übergeordneten Verzeichnis der Play-Veröffentlichungskonfiguration sein. Beispiel: path\to\test\installer. Denken Sie daran, Authenticode und die Codesignierung zu verwenden, um die ausführbare Datei des Installationsprogramms Ihres Spiels zu signieren.

      • UNIQUE_REGISTRY_PATH: Der Windows-Registrierungsschlüsselpfad. Dieser Pfad muss relativ zu einer Registrierungsstruktur wie HKEY_LOCAL_MACHINE oder HKEY_CURRENT_USER angegeben werden. Der Name der Struktur darf nicht im Pfadstring enthalten sein. Wenn Ihr Installer beispielsweise in HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName schreibt, geben Sie nur Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName an. Google Play Games auf dem PC sucht in mehreren Hives nach diesem Pfad, um die für den Start und die Deinstallation erforderlichen Werte zu finden.

        Die in INSTALLER_PATH angegebene ausführbare Datei muss diese Registrierungsschlüssel erstellen. Bevor die Installation abgeschlossen ist, müssen die unter installation-path-registry-location, launch-path-registry-location und uninstall-path-registry-location angegebenen Registrierungsschlüssel- und Wertnamenpaare erstellt werden. Im Beispiel werden InstallLocation und UninstallString verwendet. Sie können jedoch einen beliebigen Namen in diesen <value-name>-Tags angeben, sofern Ihr Installationsprogramm entsprechende Registrierungseinträge für alle drei erstellt. Google Play Games auf dem PC verwendet diese Werte, um das Spiel zu starten und zu deinstallieren. Wenn Ihr Spiel einen Launcher verwendet, muss dieser Pfad auf den Registrierungsschlüssel verweisen, der Installationsinformationen für den Launcher enthält. Der Wert im Registrierungseintrag, der durch launch-path-registry-location angegeben wird, muss auf das Verzeichnis des Launchers verweisen.

        Dieser Pfad muss auf dem Computer des Nutzers eindeutig sein. Beispiel: SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

        Wenn das Installationsprogramm Ihres Spiels eine 32-Bit-Anwendung ist, die unter 64-Bit-Windows ausgeführt wird, verwendet Windows die Registrierungsumleitung, um Registrierungseinträge unter HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node zu schreiben. Beispiel: Ein Schreibvorgang für HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName wird zu HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName umgeleitet.

      • LAUNCHER_REQUIRES_ELEVATION: Gibt an, ob der Launcher oder die ausführbare Datei des Spiels bei jedem Start als Administrator ausgeführt werden muss.

        • „true“: Die ausführbare Datei wird als Administrator ausgeführt.
        • false: Die ausführbare Datei wird als aktueller Nutzer ausgeführt.

      • RELATIVE_PATH_TO_LAUNCHER_EXE: Der Pfad zum Launcher oder zur ausführbaren Datei des Spiels im Installationsverzeichnis. Dazu muss der Name der ausführbaren Datei des Launchers oder Spiels gehören. Wenn Ihre Launcher- oder Spieldatei beispielsweise „mygame.exe“ heißt und sich unter „{INSTALL_DIR}\Resources\mygame.exe“ befindet, müssen Sie „Resources\mygame.exe“ eingeben.

      • LAUNCHER_ARGS_IF_ANY: Alle Befehlszeilenargumente, die an den Launcher oder das Spiel übergeben werden müssen. Dieser Eintrag ist optional.

        • Wenn einem ausführbaren Programm mehrere Argumente zugeordnet sind, müssen sie durch ein Leerzeichen getrennt werden.
        • Den Argumenten muss ein „--“ oder „-“ vorangestellt werden, wenn das für die ausführbare Datei erforderlich ist.

      • UNINSTALLER_REQUIRES_ELEVATION: Gibt an, ob die ausführbare Datei des Deinstallationsprogramms als Administrator ausgeführt werden muss, um die Deinstallation abzuschließen.

        • „true“: Die ausführbare Datei wird als Administrator ausgeführt.
        • false: Die ausführbare Datei wird als aktueller Nutzer ausgeführt.

    Beispiel für eine Konfigurationsdatei für die Play-Veröffentlichung

    Nehmen wir an, es gibt ein Spiel namens MyGame mit dem Spielinstallationsprogramm game_installer.exe und dem Launcher des Spiels launcher.exe. Das Beispiel zeigt auch, wie CDATA verwendet wird. So sieht die play_publishing_config.xml aus:

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

<play-publishing-config version="1.0">
  <application>
    <!-- The package name for your game. -->
    <package-name>com.mycompany.mygame</package-name>
    <!-- The game's version string. -->
    <version-name>1.0.0</version-name>
  </application>
  <!-- If requiresElevation is "true", installer runs as Administrator
       and a UAC prompt is displayed. This is required for system-wide
       installs (e.g., to Program Files) or writing to HKLM. -->
  <installer requiresElevation="true">
    <!-- Path to your installer executable. -->
    <path>game_installer.exe</path>
    <!-- The registry location where the installer writes the installation path. -->
    <installation-path-registry-location>
      <!-- Registry key path (typically under HKLM or HKCU).
           game_installer.exe MUST create this key. -->
      <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
      <!-- game_installer.exe, specified in <path>, creates the registry
           value called 'InstallLocation' within
           SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey
           by the time it exits. -->
      <value-name>InstallLocation</value-name>
    </installation-path-registry-location>
  </installer>

  <!-- If requiresElevation is "true", launcher runs as Administrator
       and a UAC prompt is displayed on every game launch. -->
  <launcher requiresElevation="true">
    <!-- Specifies the registry location where Google Play Games reads the installation path
         in order to launch the game. -->
    <launch-path-registry-location >
      <!-- Registry key path (typically under HKLM or HKCU) where
           the launch path can be found. -->
      <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
      <!-- Google Play Games reads the installation directory from this
           registry value, for example InstallLocation, to launch the game. -->
      <value-name>InstallLocation</value-name>
    </launch-path-registry-location>
    <executable-invocation>
      <!-- Game executable or launcher filename, relative to the
           directory path specified in the InstallLocation registry value. -->
      <filename>launcher.exe</filename>
      <!-- Optional arguments to pass to the executable.
           CDATA is used here to avoid issues with special characters
           like & or >. -->
      <arguments><![CDATA[arg1&arg2>arg3]]></arguments>
    </executable-invocation>
  </launcher>

  <!-- If requiresElevation is "true", uninstaller runs as
       Administrator and a UAC prompt is displayed for uninstall. -->
  <uninstaller requiresElevation="true">
    <!-- Registry key where Google Play Games finds the
         uninstallation command. -->
    <uninstall-path-registry-location>
      <!-- Registry key path (typically under HKLM or HKCU) where
           uninstall command can be found. -->
      <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
      <!-- game_installer.exe also creates the registry value, for example, 'UninstallString'
           within SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey,
           containing the command Google Play Games executes to uninstall
           the game. -->
      <value-name>UninstallString</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>

  3. Führen Sie das Play-Veröffentlichungstool über die Windows-Befehlszeile oder PowerShell aus.

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

    Wenn Sie eine vorhandene WAB-Datei mit demselben Namen überschreiben möchten, verwenden Sie das Argument --force.

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

    Ersetzen Sie dabei Folgendes:

    • PLAY_PUBLISHING_CONFIG_PATH: Der Pfad zur Play-Veröffentlichungskonfiguration. Beispiel: path\to\play_publishing_config.xml.
    • WAB_OUTPUT_PATH: Der Pfad zur WAB-Datei. Beispiel: path\to\output_bundle.wab.

    Play-Veröffentlichungstool verwenden

    Angenommen, Sie haben die Binärdatei des Play-Veröffentlichungstools playpublishingtool.exe, die Play-Veröffentlichungskonfiguration play_publishing_config.xml und das Installationsprogramm für Ihr Spiel game_installer.exe im aktuellen Arbeitsverzeichnis.

    Ihr aktuelles Arbeitsverzeichnis sollte so aussehen:

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

    Wenn Sie beispielsweise eine WAB mit dem Namen installer_bundle.wab im selben Verzeichnis erstellen möchten, sieht der Befehl so aus:

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

    Mit dem Argument --force würde der Befehl so aussehen:

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

    Bei Erfolg sollte die Ausgabe in etwa so aussehen:

    Successfully built the installer bundle at installer_bundle.wab

    Suchen Sie die WAB-Datei im Ordner:

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

Spiel über die Play Console veröffentlichen

Nachdem Sie das WAB für Ihr Spiel erstellt haben, laden Sie es in die Play Console hoch und verwalten Sie die Einstellungen und Anforderungen. So veröffentlichen Sie Ihr Spiel:

Formfaktor „Google Play Games auf dem PC“ hinzufügen

Dieser Schritt ist nur bei der Erstveröffentlichung eines Spiels erforderlich.

  1. Wählen Sie in der Play Console im Menü auf der linken Seite Testen und veröffentlichen > Einrichten > Erweiterte Einstellungen aus (Direktlink).

  2. Rufen Sie den Tab Formfaktoren auf und fügen Sie Google Play Games on PC über das Drop-down-Menü + Formfaktor hinzufügen hinzu.

  3. Klicken Sie rechts neben dem Formfaktor Google Play Games auf dem PC auf die Schaltfläche Verwalten.

  4. Wählen Sie die Option Speziellen Release-Track für mein Windows-App-Bundle-Spiel verwenden aus.

  5. Klicken Sie auf Speichern und dann im Bestätigungsdialogfeld noch einmal auf Speichern.

Verwaltete Veröffentlichung aktivieren

So aktivieren Sie die verwaltete Veröffentlichung:

  1. Klicken Sie auf der Seite Übersicht über die Veröffentlichung im Bereich Verwaltete Veröffentlichung auf Verwaltete Veröffentlichung aktivieren.
  2. Ein Dialogfeld wird angezeigt. Stellen Sie den Track auf Verwaltete Veröffentlichung aktiviert um.
  3. Klicken Sie auf Speichern.

WAB-Datei hochladen

So laden Sie die WAB-Datei hoch:

  1. Wählen Sie in der Play Console im Menü auf der linken Seite Testen und veröffentlichen > Erweiterte Einstellungen aus (Direktlink).
  2. Klicke auf der Seite Erweiterte Einstellungen auf den Tab Formfaktoren.
  3. Klicken Sie auf dem Tab Formfaktoren auf + Formfaktor hinzufügen und wählen Sie Google Play Games auf dem PC aus, um den Formfaktor hinzuzufügen.
  4. Klicken Sie im Bereich Google Play Games auf dem PC auf Verwalten.
  5. Wählen Sie Speziellen Release-Track für mein Windows-App-Bundle-Spiel verwenden aus.
  6. Klicken Sie auf Speichern.
  7. Wählen Sie in der Play Console im Menü auf der linken Seite Test und Release > Produktion (Direktlink) aus.
  8. Wählen Sie auf der Seite Produktion im Drop-down-Menü für den Formfaktor die Option Nur Google Play Games auf dem PC (Windows) aus.
  9. Klicken Sie auf dem Tab Windows-App-Bundle auf Bearbeiten und laden Sie die WAB-Datei hoch.

Windows-PC-Anforderungen konfigurieren

So konfigurieren Sie die Windows-PC-Anforderungen:

  1. Wählen Sie in der Play Console im Menü auf der linken Seite Mehr Nutzer gewinnen > App-Präsenz im Play Store > Play Store-Einstellungen (Direktlink) aus.
  2. Klicken Sie im Bereich PC-Anforderungen rechts auf die Schaltfläche Bearbeiten.
  3. Aktualisieren Sie die Felder und klicken Sie auf Speichern.

Grafik für In‑App-Käufe konfigurieren

Dieser Schritt ist optional. So konfigurieren Sie die Grafik für In-App-Käufe:

  1. Wählen Sie in der Play Console im Menü auf der linken Seite Nutzer gewinnen > App-Präsenz im Play Store > Store-Einträge aus(Direktlink).
  2. Klicken Sie auf dem Tab Einträge im Bereich Standardmäßiger Store-Eintrag rechts auf die Schaltfläche -> (Pfeil). Dadurch gelangen Sie zur Seite Standardmäßiger Store-Eintrag.
  3. Rufen Sie den Bereich Google Play Games auf dem PC auf und laden Sie das Bild unter Grafik für In‑App-Käufe bei Google Play Games auf dem PC (Windows) hoch.
  4. Klicken Sie auf Speichern.

Änderungen zur Überprüfung senden

  1. Wählen Sie in der Play Console im Menü auf der linken Seite Veröffentlichung – Übersicht aus.
  2. Klicken Sie im Abschnitt Änderungen, die noch nicht zur Überprüfung eingereicht wurden auf Änderungen zur Überprüfung senden.

Wenn das Überprüfungsteam Ihre Änderungen genehmigt hat, ist Ihr Spiel bei Google Play auffindbar.