Diese Seite wurde von der Cloud Translation API übersetzt.

Veröffentlichung von Installationsprogrammen

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

Beim vom Entwickler installierten Ablauf 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 Spiele auf dem PC muss das Installationsprogramm Ihres 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 über die Windows-Befehlszeile oder PowerShell ausführen.
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:
  - 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 den Installationsvorgang abzuschließen.
    - „true“: Die ausführbare Datei wird als Administrator ausgeführt.
    Warnung :Zeigt dem Spieler eine Benutzerkontensteuerung-Aufforderung an.
    - „false“: Die ausführbare Datei wird als aktueller Nutzer ausgeführt.
  - INSTALLER_PATH: Der Pfad zur Installationsdatei in 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 Stammschlüssel, der alle Ihre Registrierungsinformationen enthält. Er muss auf dem Computer des Nutzers eindeutig sein. Dies ist der relative Pfad zusätzlich zu HKLM. Beispiel: SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName. Mit diesem Eintrag wird ein Stammschlüssel unter HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName auf einem 64-Bit-Windows 11-Computer erstellt.
  - 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.
    Warnung :Zeigt dem Spieler eine Benutzerkontensteuerung-Aufforderung an.
    - „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 Dateiname 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 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“: Die ausführbare Datei wird als Administrator ausgeführt.
    Warnung :Zeigt dem Spieler eine Benutzerkontensteuerung-Aufforderung an.
    - „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>
    <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>
```
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.
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 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 ein 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 Spiele auf dem PC“ hinzufügen

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

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.

Hinweis :Wenn Sie im Tab „Formfaktoren“ nicht auf Google Play Spiele auf dem PC zugreifen können, wenden Sie sich an unsere Play-Partner, um Ihr Konto auf die Zulassungsliste setzen zu lassen.
Klicken Sie rechts neben dem Formfaktor Google Play Spiele auf dem PC auf die Schaltfläche 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 Übersicht zur Veröffentlichung im Bereich Verwaltete Veröffentlichung auf Verwaltete Veröffentlichung aktivieren.
Ein Dialogfeld wird eingeblendet. Stellen Sie den Track auf Verwaltete Veröffentlichung aktiviert um.
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 Testen und veröffentlichen > Erweiterte Einstellungen aus (Direktlink).
Klicke 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 Test und Release > Produktion aus (Direktlink).
Wählen Sie auf der Seite Produktion im Drop-down-Menü für den Formfaktor die Option Nur Google Play Spiele auf dem PC (Windows) aus.
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:

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.
Klicken Sie im Bereich PC-Anforderungen rechts auf die Schaltfläche 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ä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).
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.
Rufen Sie den Bereich Google Play Spiele auf dem PC auf und laden Sie das Bild unter Grafik für In‑App-Käufe bei Google Play Spiele 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öffentlichung – Übersicht aus.
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.

Veröffentlichung von Installationsprogrammen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweis

Spiel als WAB-Datei verpacken

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

Play-Veröffentlichungstool verwenden

Spiel über die Play Console veröffentlichen

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

Verwaltete Veröffentlichung aktivieren

WAB-Datei hochladen

Windows-PC-Anforderungen konfigurieren

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

Änderungen zur Überprüfung senden

Veröffentlichung von Installationsprogrammen