Publication du programme d'installation

Ce document explique comment publier votre jeu sur Google Play Jeux sur PC à l'aide de son programme d'installation.

Avec le flux d'installation par le développeur, le programme d'installation du jeu que vous fournissez doit gérer l'installation, la mise à jour et la désinstallation du jeu.

Avant de commencer

Intégrez le SDK Google Play Jeux à votre jeu.

Empaqueter votre jeu sous forme de fichier WAB

Google Play Jeux sur PC nécessite que le programme d'installation de votre jeu soit importé dans la Google Play Console en tant que fichier Windows App Bundle (WAB). Pour créer un fichier WAB : ​

  1. Téléchargez l'outil de publication Play. Vous pouvez exécuter cet outil sur la ligne de commande Windows ou PowerShell.

  2. Créez le fichier de configuration de publication Play, avec le nom de votre choix. Par exemple, play_publishing_config.xml avec le format suivant :

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

    Remplacez les éléments suivants :

    • PACKAGE_NAME : nom du package de votre jeu. Il s'agit de l'identifiant unique qui sera associé à votre jeu sur Google Play. Par exemple, com.yourcompany.yourgame. Le nom du package doit respecter les règles suivantes :
      • Il doit comporter au moins deux segments (un ou plusieurs points).
      • Chaque segment doit commencer par une lettre.
      • Tous les caractères doivent être alphanumériques ou un trait de soulignement ([a-zA-Z0-9_]).

    • VERSION_NAME : chaîne de version du jeu. Il peut s'agir d'une chaîne arbitraire, mais elle doit être unique pour tous les WAB importés pour votre jeu. Par exemple : 1.0, 1.0.1-beta, 2025.11.24, v1.rc1.

      • INSTALLER_REQUIRES_ELEVATION : indique si l'exécutable du programme d'installation doit être exécuté en tant qu'administrateur pour terminer le processus d'installation.

        • "true" : exécutez le fichier exécutable en tant qu'administrateur.
        • "false" : exécute l'exécutable en tant qu'utilisateur actuel.

      • INSTALLER_PATH : chemin d'accès à votre fichier d'installation dans WAB. Ce chemin peut être absolu ou relatif au répertoire parent de la configuration de publication Play. Par exemple : path\to\test\installer. N'oubliez pas d'utiliser Authenticode et la signature de code pour signer l'exécutable de l'installateur de votre jeu.

      • UNIQUE_REGISTRY_PATH : chemin d'accès à la clé de registre Windows. Ce chemin d'accès doit être fourni par rapport à une ruche de registre telle que HKEY_LOCAL_MACHINE ou HKEY_CURRENT_USER. N'incluez pas le nom de la ruche dans la chaîne de chemin d'accès. Par exemple, si votre installateur écrit dans HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName, spécifiez uniquement Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName. Google Play Jeux sur PC recherche ce chemin d'accès sous plusieurs ruches pour trouver les valeurs requises pour le lancement et la désinstallation.

        L'exécutable spécifié dans INSTALLER_PATH doit créer ces clés de registre. Avant la fin de l'installation, les paires clé de registre/nom de valeur spécifiées sous installation-path-registry-location, launch-path-registry-location et uninstall-path-registry-location doivent être créées. Bien que l'exemple utilise InstallLocation et UninstallString, vous pouvez spécifier n'importe quel nom dans ces balises <value-name>, à condition que votre programme d'installation crée les entrées de registre correspondantes pour les trois. Google Play Jeux sur PC utilise ces valeurs pour lancer et désinstaller le jeu. Si votre jeu utilise un lanceur, ce chemin d'accès doit pointer vers la clé de registre contenant les informations d'installation du lanceur, et la valeur de l'entrée de registre spécifiée par launch-path-registry-location doit pointer vers le répertoire du lanceur.

        Ce chemin doit être unique sur la machine de l'utilisateur. Par exemple :SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

        Si le programme d'installation de votre jeu est une application 32 bits exécutée sur un système Windows 64 bits, Windows utilise la redirection du Registre pour écrire les entrées de Registre sous HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node. Par exemple, une écriture sur HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName est redirigée vers HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

      • LAUNCHER_REQUIRES_ELEVATION : indique si le lanceur ou l'exécutable du jeu doivent être exécutés en tant qu'administrateur à chaque lancement.

        • "true" : exécutez le fichier exécutable en tant qu'administrateur.
        • "false" : exécute l'exécutable en tant qu'utilisateur actuel.

      • RELATIVE_PATH_TO_LAUNCHER_EXE : chemin d'accès à votre lanceur ou à l'exécutable du jeu dans le répertoire d'installation. Il doit inclure le nom de fichier exécutable de votre lanceur ou de votre jeu. Par exemple, si votre fichier de lanceur ou de jeu s'appelle mygame.exe et qu'il se trouve sous {INSTALL_DIR}\Resources\mygame.exe, vous devez saisir Resources\mygame.exe.

      • LAUNCHER_ARGS_IF_ANY : tous les arguments de ligne de commande à transmettre à votre lanceur ou à votre jeu. Cette entrée est facultative.

        • Si plusieurs arguments sont associés à un exécutable, ils doivent être séparés par un espace.
        • Les arguments doivent être précédés de "--" ou "-", si l'exécutable l'exige.

      • UNINSTALLER_REQUIRES_ELEVATION : indique si l'exécutable du programme de désinstallation doit être exécuté en tant qu'administrateur pour terminer le processus de désinstallation.

        • "true" : exécutez le fichier exécutable en tant qu'administrateur.
        • "false" : exécute l'exécutable en tant qu'utilisateur actuel.

    Exemple de fichier de configuration de publication Play

    Prenons l'exemple d'un jeu appelé MyGame, avec un programme d'installation game_installer.exe et un lanceur launcher.exe. L'exemple montre également comment utiliser CDATA. Voici à quoi ressemblera le play_publishing_config.xml :

    <?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. Exécutez l'outil de publication Play sur la ligne de commande Windows ou PowerShell.

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

    Pour écraser un fichier WAB existant portant le même nom, utilisez l'argument --force.

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

    Remplacez les éléments suivants :

    • PLAY_PUBLISHING_CONFIG_PATH : chemin d'accès à la configuration de publication Play. Par exemple, path\to\play_publishing_config.xml.
    • WAB_OUTPUT_PATH : chemin d'accès au fichier WAB. Par exemple, path\to\output_bundle.wab.

    Utiliser l'outil de publication Play

    Imaginons que vous disposez du binaire de l'outil de publication Play playpublishingtool.exe, de la configuration de publication Play play_publishing_config.xml et de votre programme d'installation de jeu game_installer.exe dans le répertoire de travail actuel.

    Votre répertoire de travail actuel devrait se présenter comme suit :

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

    Pour créer un fichier WAB nommé, par exemple, installer_bundle.wab dans le même répertoire, la commande se présente comme suit :

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

    Avec l'argument --force, la commande se présente comme suit :

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

    Si l'opération réussit, un résultat semblable aux lignes suivantes s'affiche :

    Successfully built the installer bundle at installer_bundle.wab

    Recherchez le fichier WAB dans le dossier :

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

Publier le jeu à l'aide de la Play Console

Une fois que vous avez créé le WAB pour votre jeu, importez-le dans la Play Console et gérez ses paramètres et exigences. Suivez les étapes ci-dessous pour publier votre jeu :

Ajouter le facteur de forme Google Play Jeux sur PC

Cette étape n'est requise que la première fois que vous publiez un jeu.

  1. Dans le menu de gauche de la Play Console, sélectionnez Tester et publier > Configuration > Paramètres avancés (lien direct).

  2. Accédez à l'onglet Facteurs de forme, puis ajoutez Google Play Games on PC à partir du menu déroulant + Ajouter un facteur de forme.

  3. Cliquez sur le bouton Gérer correspondant au facteur de forme Google Play Jeux sur PC sur la droite.

  4. Sélectionnez l'option Utiliser un canal dédié pour l'app bundle Windows de votre jeu.

  5. Cliquez sur Enregistrer, puis à nouveau sur Enregistrer dans la boîte de dialogue de confirmation.

Activer la publication gérée

Pour activer la publication gérée, procédez comme suit :

  1. Sur la page Aperçu de la publication, dans la section Publication gérée, cliquez sur Activer la publication gérée.
  2. Une boîte de dialogue s'affiche. Passez à Publication gérée activée pour le canal.
  3. Cliquez sur Enregistrer.

Importer le fichier WAB

Pour importer le fichier WAB, procédez comme suit :

  1. Dans le menu de gauche de la Play Console, sélectionnez Tester et publier > Paramètres avancés (lien direct).
  2. Sur la page Paramètres avancés, cliquez sur l'onglet Facteurs de forme.
  3. Dans l'onglet Facteurs de forme, cliquez sur + Ajouter un facteur de forme, puis sélectionnez Google Play Jeux sur PC pour l'ajouter.
  4. Dans la section Google Play Jeux sur PC, cliquez sur Gérer.
  5. Sélectionnez Utiliser un canal dédié pour l'app bundle Windows de votre jeu.
  6. Cliquez sur Enregistrer.
  7. Dans le menu de gauche de la Play Console, sélectionnez Tester et publier > Production (lien direct).
  8. Sur la page Production, sélectionnez Google Play Jeux sur PC (Windows) uniquement dans le menu déroulant des facteurs de forme.
  9. Dans l'onglet Bundle d'applis Windows, cliquez sur Modifier, puis importez le fichier WAB.

Configurer la configuration requise pour les PC Windows

Pour configurer la configuration requise pour les PC Windows :

  1. Dans le menu de gauche de la Play Console, sélectionnez Accroître le nombre d'utilisateurs > Présence sur le Play Store > Paramètres de la fiche Play Store (lien direct).
  2. Dans la section Configuration PC requise, cliquez sur le bouton Modifier à droite.
  3. Modifiez les champs, puis cliquez sur Enregistrer.

Configurer l'image d'achat via une application

Cette étape est facultative. Pour configurer le visuel de l'achat via l'application :

  1. Dans le menu de gauche de la Play Console, sélectionnez Développer votre audience > Présence sur le Play Store > Fiches Play Store(lien direct).
  2. Dans la section Fiche Play Store par défaut de l'onglet Fiches, cliquez sur le bouton -> (flèche) à droite. Vous êtes alors redirigé vers la page Fiche Play Store par défaut.
  3. Accédez à la section Google Play Jeux sur PC et importez l'image Image d'achat via une appli dans Google Play Jeux sur PC (Windows).
  4. Cliquez sur Enregistrer.

Envoi des modifications pour examen

  1. Dans le menu de gauche de la Play Console, sélectionnez Vue d'ensemble de la publication.
  2. Dans la section Modifications pas encore envoyées pour examen, cliquez sur Envoyer les modifications pour examen.

Une fois que l'équipe d'examen aura approuvé vos modifications, votre jeu sera visible sur Google Play.