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 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 deines Spiels als Windows-App-Bundle-Datei (WAB) in die Google Play Console hochgeladen werden. So erstellen Sie eine WAB-Datei:
Laden Sie das Play-Publishing-Tool herunter. Sie können dieses Tool in der Windows-Befehlszeile oder in PowerShell ausführen.
Erstellen Sie die Play-Veröffentlichungskonfigurationsdatei mit einem beliebigen Namen. Beispiel:
play_publishing_config.xmlim 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 acceptsCommandLineArguments=ACCEPTS_COMMAND_LINE_ARGUMENTS> <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 Ihres Spiels. Dies ist die eindeutige Kennung, die deinem Spiel bei Google Play zugeordnet wird. Beispiel:com.yourcompany.yourgame. Der Paketname muss den folgenden Regeln entsprechen:- Er 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. Dies kann ein beliebiger String sein, er muss jedoch 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": Die ausführbare Datei wird als Administrator ausgeführt.
- "false": Die ausführbare Datei wird als aktueller Nutzer ausgeführt.
ACCEPTS_COMMAND_LINE_ARGUMENTS: Ein boolescher Wert, der angibt, ob das Installationsprogramm Befehlszeilenargumente akzeptieren kann, um die automatische Wiedergabe zu aktivieren. Dies ist optional und der Standardwert ist „false“. Weitere Informationen finden Sie unter Autoplay aktivieren.INSTALLER_PATH: Der Pfad zur Installationsdatei im WAB. Dieser Pfad kann entweder absolut oder relativ zum übergeordneten Verzeichnis der Google Play-Veröffentlichungskonfiguration sein. Beispiel:path\to\test\installer. Denke daran, die ausführbare Datei des Installationsprogramms deines Spiels mit Authenticode und Codesignatur zu signieren.<installation-path-registry-location>: Der Registry-Pfad, den Google Play Spiele verwendet, um zu erkennen, ob das Spiel installiert ist. Auch wenn dein Spiel einen benutzerdefinierten Launcher verwendet, muss dieser Pfad auf den eindeutigen Registrierungsschlüssel des Spiels verweisen, nicht auf den Registrierungsschlüssel des Launchers.UNIQUE_REGISTRY_PATH: Der Pfad des Windows-Registrierungsschlüssels. Dieser Pfad muss relativ zu einem Registry-Hive wieHKEY_LOCAL_MACHINEoderHKEY_CURRENT_USERangegeben werden. Geben Sie den Hive-Namen nicht im Pfadstring an. Wenn Ihr Installationsprogramm beispielsweise inHKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNameschreibt, geben Sie nurSoftware\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNamean. Google Play Games auf dem PC sucht zuerst inHKEY_LOCAL_MACHINEund dann inHKEY_CURRENT_USERnach diesem Pfad und verwendet den ersten übereinstimmenden Wert, den es findet.Die in
Dieser Pfad muss auf dem Computer des Nutzers eindeutig sein. Beispiel:INSTALLER_PATHangegebene ausführbare Datei muss diese Registrierungsschlüssel erstellen. Vor Abschluss der Installation müssen diese Registrierungsschlüssel- und Wertnamenpaare, die unterinstallation-path-registry-location,launch-path-registry-locationunduninstall-path-registry-locationangegeben sind, erstellt werden. Im Beispiel werdenInstallLocationundUninstallStringverwendet. Sie können jedoch einen beliebigen Namen in diesen<value-name>-Tags angeben, solange das Installationsprogramm entsprechende Registry-Einträ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 der Wert im Registrierungseintrag, der durchlaunch-path-registry-locationangegeben wird, auf das Verzeichnis des Launchers verweisen.installation-path-registry-locationmuss auf den eindeutigen Registrierungsschlüssel des Spiels verweisen, nicht auf den Registrierungsschlüssel des Launchers.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\WOW6432Nodezu schreiben. Beispiel: Ein Schreibvorgang inHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNamewird anHKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNameweitergeleitet.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 zur ausführbaren Datei des Launchers oder Spiels im Installationsverzeichnis. Dazu gehört auch der Dateiname der ausführbaren Datei des Launchers oder Spiels. 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 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 verlangt wird.
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 Veröffentlichung bei Google Play
Angenommen, es gibt ein Spiel namens
MyGamemit dem Installationsprogrammgame_installer.exeund dem Launcherlauncher.exe. Das Beispiel zeigt auch, wie CDATA verwendet wird. So sieht dieplay_publishing_config.xmlaus:<?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. --> <!-- If acceptsCommandLineArguments is "true", the installer must be able to accept command-line arguments to enable the auto-play feature. --> <installer requiresElevation="true" acceptsCommandLineArguments="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>Führen Sie das Play-Publishing-Tool in der Windows-Befehlszeile oder in 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 Folgendes:
PLAY_PUBLISHING_CONFIG_PATH: Der Pfad zur Google Play-Veröffentlichungskonfiguration. Beispiel:path\to\play_publishing_config.xml.WAB_OUTPUT_PATH: Der Pfad zur WAB-Datei. Beispiel:path\to\output_bundle.wab.
Google Play-Veröffentlichungstool verwenden
Angenommen, Sie haben die Binärdatei des Google Play-Publishing-Tools
playpublishingtool.exe, die Google Play-Publishing-Konfigurationplay_publishing_config.xmlund das Installationsprogramm für Ihr Spielgame_installer.exeim aktuellen Arbeitsverzeichnis.Ihr aktuelles Arbeitsverzeichnis sollte so aussehen:
.\ ├── game_installer.exe ├── play_publishing_config.xml ├── playpublishingtool.exe
Wenn Sie ein WAB mit dem Namen
installer_bundle.wabim 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
--forcesieht der Befehl so aus:playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force
Nach einer erfolgreichen Prüfung 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
Automatische Wiedergabe bei der Installation Ihrer nativen PC-Spiele aktivieren (optional)
In Google Play Games auf dem PC können Sie die Funktion „Automatisch spielen“ aktivieren. Dadurch wird Ihr Spiel sofort nach Abschluss der Installation automatisch gestartet. Diese Funktion bietet eine nahtlose Nutzererfahrung, da der Spieler direkt in das Spiel gelangt und im Google Play Games auf dem PC-Ökosystem vollständig authentifiziert ist.
Funktionsweise
Wenn Sie die Funktion aktivieren, übergibt Google Play Games auf dem PC ein Sitzungstoken über Befehlszeilenargumente an den Installationsprozess des Drittanbieters. Das Installationsprogramm ist dann dafür verantwortlich, dieses Token zu extrahieren und damit die ausführbare Datei des Spiels in einem Authentifizierungskontext zu starten.
Voraussetzungen
Damit Sie diese Funktion verwenden können, muss Ihr Drittanbieter-Installationsprogramm Befehlszeilenargumente verarbeiten können.
Implementierungsschritte
Autoplay in der Google Play-Veröffentlichungskonfiguration aktivieren
Wenn Sie diese Funktion aktivieren möchten, fügen Sie das Attribut
acceptsCommandLineArgumentszum Element<installer>in Ihrerplay_publishing_config.xmlhinzu.Beispiel für einen Auszug aus dem Inhalt von
play_publishing_config.xml:<installer requiresElevation="true" acceptsCommandLineArguments="true"> <path>path/to/installer.exe</path> <installation-path-registry-location> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\key</key-name> <value-name>InstallPath</value-name> </installation-path-registry-location> </installer>
- Attribut:
acceptsCommandLineArguments - Typ:
Boolean - Standard:
false - Verhalten: Wenn Sie „true“ festlegen, hängt GPG das Sitzungstoken an die Befehlszeilenargumente an, wenn das Installationsprogramm ausgeführt wird.
- Attribut:
Sitzungstoken im Installationsprogramm verarbeiten
Wenn Ihr Installationsprogramm vom GPG-Client gestartet wird, erhält es das Sitzungstoken als Befehlszeilenargument.
- Argumentformat:
--g_session_token=<TOKEN>
Was du tun musst:
- Extraktion: Das Installationsprogramm muss die Befehlszeilenargumente parsen, um den Tokenstring abzurufen.
- Weitergabe: Wenn Ihr Installationsablauf das Starten eines sekundären Launchers oder Spielprozesses umfasst, ist Ihr Installationsprogramm dafür verantwortlich, das Sitzungstoken sicher an den endgültigen Spielprozess weiterzugeben, der das SDK verwendet.
- Starten: Verwenden Sie das bereitgestellte Sitzungstoken, um die ausführbare Datei des Spiels zu starten. So wird sichergestellt, dass das Spiel in einem authentifizierten GPG-Kontext ausgeführt wird. Andernfalls schlägt InitializeSDK fehl und der Spieler muss das Spiel neu starten.
- Argumentformat:
Fehlerbehandlung und Fallbacks
- Tokenabruf: Wenn GPG aus irgendeinem Grund kein Sitzungstoken generieren oder weitergeben kann (z.B. aufgrund eines Fehlers bei der Tokengenerierung), wird der Installationsvorgang trotzdem fortgesetzt. Das Installationsprogramm wird jedoch ohne das Argument
--g_session_tokengestartet. - Robustheit: Ihr Installationsprogramm sollte so konzipiert sein, dass es auch ohne Sitzungstoken funktioniert. In solchen Fällen sollte das Installationsprogramm mit einer Standardinstallation fortfahren. Sie sollten das Spiel nicht automatisch starten, da InitializeSDK ohnehin fehlschlägt.
- Installationsfehler: Sie sind für die Robustheit und Fehlerbehandlung Ihres Installationsprogramms und der von ihm initiierten Spielstartsequenz verantwortlich. Google Play Spiele hat keine Kontrolle über Prozesse, die nach dem Start des Installationsprogramms darin ausgeführt werden.
- Tokenabruf: Wenn GPG aus irgendeinem Grund kein Sitzungstoken generieren oder weitergeben kann (z.B. aufgrund eines Fehlers bei der Tokengenerierung), wird der Installationsvorgang trotzdem fortgesetzt. Das Installationsprogramm wird jedoch ohne das Argument
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. Folgen Sie der Anleitung, um Ihr Spiel zu veröffentlichen:
Formfaktor „Google Play Games auf dem PC“ hinzufügen
Dieser Schritt ist nur erforderlich, wenn Sie ein Spiel zum ersten Mal veröffentlichen.
- Wählen Sie in der Play Console im Menü auf der linken Seite Testen und veröffentlichen > Einrichten > Erweiterte Einstellungen aus (Direktlink).
Rufen Sie den Tab Formfaktoren auf und fügen Sie
Google Play Games on PCüber das Drop-down-Menü + Formfaktor hinzufügen hinzu.Klicke rechts neben dem Formfaktor Google Play Games auf dem PC auf Verwalten.
Wählen Sie die Option Speziellen Release-Track für mein Windows-App-Bundle-Spiel verwenden aus.
Klicken Sie auf Speichern und dann im Bestätigungsdialogfeld noch einmal auf Speichern.
Verwaltete Veröffentlichung aktivieren
So aktivieren Sie die verwaltete Veröffentlichung:
- Klicken Sie auf der Seite Veröffentlichungen – Übersicht im Bereich Verwaltete Veröffentlichung auf Verwaltete Veröffentlichung aktivieren.
- Ein Dialogfeld wird eingeblendet. Stellen Sie für den Track die Option Verwaltete Veröffentlichung aktiviert ein.
- Klicken Sie auf Speichern.
WAB-Datei hochladen
So laden Sie die WAB-Datei hoch:
- Wählen Sie in der Play Console im Menü auf der linken Seite Test und Release > Erweiterte Einstellungen aus (direkter Link).
- Klicken Sie auf der Seite Erweiterte Einstellungen auf den Tab Formfaktoren.
- 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.
- Klicken Sie im Abschnitt Google Play Spiele auf dem PC auf Verwalten.
- Wählen Sie Speziellen Release-Track für mein Windows-App-Bundle-Spiel verwenden aus.
- Klicken Sie auf Speichern.
- Wählen Sie in der Play Console im Menü auf der linken Seite Testen und veröffentlichen > Produktion aus (Direktlink).
- Wählen Sie auf der Seite Produktion im Drop-down-Menü für den Formfaktor Nur Google Play Games auf dem PC (Windows) aus.
- Klicken Sie auf dem Tab Windows-App-Bundle auf Bearbeiten und laden Sie die WAB-Datei hoch.
Anforderungen für Windows-PCs konfigurieren
So konfigurieren Sie die Anforderungen für Windows-PCs:
- Wählen Sie in der Play Console im Menü auf der linken Seite Mehr Nutzer gewinnen > App-Präsenz im Google Play Store > Play Store-Einstellungen aus (Direktlink).
- Klicken Sie im Bereich PC-Anforderungen rechts auf den Button Bearbeiten.
- 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:
- Wähle in der Play Console im Menü auf der linken Seite Mehr Nutzer gewinnen > App-Präsenz im Google Play Store > Store-Einträge aus (Direktlink).
- Klicken Sie im Bereich Standardmäßiger Store-Eintrag auf dem Tab Einträge rechts auf den Pfeilbutton ->. Dadurch gelangen Sie zur Seite Standardmäßiger Store-Eintrag.
- Gehen Sie zum Bereich Google Play Games auf dem PC und laden Sie das Bild unter Grafik für In‑App-Käufe bei Google Play Games auf dem PC (Windows) hoch.
- Klicken Sie auf Speichern.
Änderungen zur Überprüfung senden
- Wählen Sie in der Play Console im Menü auf der linken Seite Veröffentlichungen – Übersicht aus.
- Klicken Sie im Abschnitt Änderungen, die noch nicht zur Überprüfung eingereicht wurden auf Änderungen zur Überprüfung senden.
Sobald das Prüfteam Ihre Änderungen genehmigt hat, ist Ihr Spiel bei Google Play sichtbar.