Veröffentlichung von Installationsprogrammen

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

Beim vom Entwickler installierten Ablauf muss das von Ihnen bereitgestellte Spielinstallationsprogramm 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 Windows-App-Bundle-Datei (WAB) in die Play Console hochgeladen werden. So erstellen Sie eine WAB-Datei:

1. Laden Sie das Play-Veröffentlichungstool herunter. Sie können dieses Tool in der Windows-Befehlszeile oder in PowerShell ausführen.

2. Erstellen Sie die Konfigurationsdatei für die Play-Veröffentlichung mit einem beliebigen Namen. Beispiel: play_publishing_config.xml mit folgendem 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 Folgendes:

   • PACKAGE_NAME: Der Paketname für Ihr Spiel. Dies ist die eindeutige ID, die Ihrem Spiel bei Google Play zugewiesen wird. Beispiel: com.yourcompany.yourgame. Der Paketname muss den folgenden Regeln entsprechen:
     • Er muss mindestens zwei Segmente haben (ein oder mehrere Punkte).
     • 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. Dies kann ein beliebiger String sein, muss aber für alle hochgeladenen WABs für Ihr 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 die Installation abzuschließen.

       • "true": Führen Sie die ausführbare Datei als Administrator aus.
       Warnung: Für den Spieler wird eine UAC-Aufforderung angezeigt.
       • "false": Führen Sie die ausführbare Datei als aktueller Nutzer aus.

     • INSTALLER_PATH: Der Pfad zur Installationsdatei im WAB. Dieser Pfad kann absolut oder relativ zum übergeordneten Verzeichnis der Konfiguration für die Play-Veröffentlichung sein. Beispiel: path\to\test\installer. Verwenden Sie Authenticode und die Codesignierung, um die ausführbare Datei des Installationsprogramms Ihres Spiels zu signieren.

     • UNIQUE_REGISTRY_PATH: Der Pfad des Windows-Registrierungsschlüssels. 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 Installationsprogramm 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 unter mehreren Strukturen 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. Vor Abschluss der Installation 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 in diesen <value-name> Tags jedoch einen beliebigen Namen angeben, solange 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 Ihr Spielinstallationsprogramm eine 32-Bit-Anwendung ist, die unter 64-Bit Windows ausgeführt wird, verwendet Windows die Registrierungsumleitung, um Registrierungs einträge unter HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node zu schreiben. Beispiel: Ein Schreibvorgang in 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 die ausführbare Datei des Launchers oder des Spiels bei jedem Start als Administrator ausgeführt werden muss.

       • "true": Führen Sie die ausführbare Datei als Administrator aus.
       Warnung: Für den Spieler wird eine UAC-Aufforderung angezeigt.
       • "false": Führen Sie die ausführbare Datei als aktueller Nutzer aus.

     • RELATIVE_PATH_TO_LAUNCHER_EXE: Der Pfad zur ausführbaren Datei des Launchers oder des Spiels im Installationsverzeichnis. Dieser Pfad muss den Dateinamen der ausführbaren Datei des Launchers oder des Spiels enthalten. Wenn die Launcher- oder Spieldatei beispielsweise „mygame.exe“ heißt und sich unter „{INSTALL_DIR}\Resources\mygame.exe“ befindet, müssen Sie „Resources\mygame.exe“ angeben.

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

       • Wenn mehrere Argumente mit einer ausführbaren Datei verknüpft sind, müssen sie durch ein Leerzeichen getrennt werden.
       • Den Argumenten muss ein „--“ oder „-“ vorangestellt werden, wenn dies von der ausführbaren 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": Führen Sie die ausführbare Datei als Administrator aus.
       Warnung: Für den Spieler wird eine UAC-Aufforderung angezeigt.
       • "false": Führen Sie die ausführbare Datei als aktueller Nutzer aus.

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

   Nehmen wir an, Sie haben ein Spiel namens MyGame mit dem Spielinstallationsprogramm game_installer.exe und dem Launcher launcher.exe. Das Beispiel zeigt auch, wie CDATA verwendet wird. So sieht die Datei 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 in der Windows-Befehlszeile oder in PowerShell aus.

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

   Verwenden Sie das Argument --force, um eine vorhandene WAB-Datei mit demselben Namen zu überschreiben.

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

   Ersetzen Sie Folgendes:

   • PLAY_PUBLISHING_CONFIG_PATH: Der Pfad zur Konfiguration für die Play-Veröffentlichung. Beispiel: path\to\play_publishing_config.xml.
   • WAB_OUTPUT_PATH: Der Pfad zur WAB-Datei. Beispiel: path\to\output_bundle.wab.
   Wichtig: Der WAB-Dateiname in --output muss die Erweiterung „ .wab“ haben.
   Hinweis:Die Pfade --input und --output können absolut oder relativ zum aktuellen Arbeitsverzeichnis sein.

   Play-Veröffentlichungstool verwenden

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

   Ihr aktuelles Arbeitsverzeichnis sollte so aussehen:

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

   Wenn Sie eine WAB-Datei 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 sieht der Befehl so aus:

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

   Bei Erfolg sollte eine ähnliche Ausgabe wie die folgende angezeigt werden:

   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 die WAB-Datei für Ihr Spiel erstellt haben, laden Sie sie in die Play Console hoch und verwalten Sie die Einstellungen und Anforderungen. Folgen Sie der Anleitung, um Ihr Spiel zu veröffentlichen:

Hinweis: Öffnen Sie für alle Schritte die Play Console und wählen Sie Ihre App zuerst aus. Fahren Sie dann mit den genannten Schritten für diese bestimmte App fort.

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

Dieser Schritt ist nur erforderlich, wenn Sie ein Spiel zum ersten Mal veröffentlichen.

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

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.

   Hinweis: Wenn Sie auf dem Tab „Formfaktoren“ nicht auf Google Play Games auf dem PC zugreifen können, wenden Sie sich an unsere Play-Partner, um Ihr Konto auf die Zulassungsliste setzen zu lassen.

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 Veröffentlichung – Übersicht im Bereich Verwaltete Veröffentlichung auf Verwaltete Veröffentlichung aktivieren.
2. Ein Dialogfeld wird angezeigt. Wechseln Sie für den Track zu Verwaltete Veröffentlichung aktiviert.
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 Test und Release > Erweiterte Einstellungen (Direktlink) aus.
2. Klicken Sie 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 es 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 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 Nutzer gewinnen > App-Präsenz im Play Store > Händlereinstellungen (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(Direktlink) aus.
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

Hinweis: Mit der verwalteten Veröffentlichung können Sie besser steuern, wann Ihre Änderungen veröffentlicht werden. Die verwaltete Veröffentlichung ist standardmäßig deaktiviert, das bedeutet, dass Ihre Änderungen veröffentlicht werden, sobald sie genehmigt wurden. Wenn Sie die verwaltete Veröffentlichung aktivieren möchten, rufen Sie die Seite „Veröffentlichung – Übersicht“ auf und klicken Sie rechts auf die Schaltfläche „Verwaltete Veröffentlichung aktivieren“.

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

Nachdem das Überprüfungsteam Ihre Änderungen genehmigt hat, ist Ihr Spiel bei Google Play zu finden.