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 de 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 en tant que fichier WAB

Google Play Games 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, procédez comme suit :

  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 n'importe quel nom. Par exemple, play_publishing_config.xml au 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 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>

    Remplacez les éléments suivants :

    • PACKAGE_NAME : nom de package de votre jeu. Il s'agit de l'identifiant unique qui sera associé à votre jeu sur Google Play. Exemple : com.yourcompany.yourgame. Le nom de 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 fichiers WAB importés pour votre jeu. Exemples : 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écute l'exécutable en tant qu'administrateur.
        • "false" : exécute l'exécutable en tant qu'utilisateur actuel.

      • ACCEPTS_COMMAND_LINE_ARGUMENTS: valeur booléenne indiquant si le programme d'installation peut accepter des arguments de ligne de commande pour activer la fonctionnalité de lecture automatique. Cette option est facultative et la valeur par défaut est "false". Pour en savoir plus, consultez Activer la lecture automatique.

      • INSTALLER_PATH: chemin d'accès au fichier de votre programme d'installation dans le fichier WAB. Ce chemin d'accès peut être absolu ou relatif au répertoire parent de la configuration de publication Play. Exemple : path\to\test\installer. N'oubliez pas d'utiliser Authenticode et la signature de code pour signer l'exécutable du programme d'installation 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 programme d'installation é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 <value-name> tags, à condition que votre programme d'installation crée des 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 d'accès doit être unique sur la machine de l'utilisateur. Exemple : SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

        Si le programme d'installation de votre jeu est une application 32 bits exécutée sur Windows 64 bits, Windows utilise la redirection de registre pour écrire des entrées de registre sous HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node. Par exemple, une écriture dans 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 doit être exécuté en tant qu'administrateur à chaque lancement.

        • "true" : exécute l'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. Vous devez inclure le nom de fichier de votre lanceur ou de l'exécutable du jeu. Par exemple, si votre lanceur ou votre fichier 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 qui doivent être transmis à 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 de '-', 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écute l'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 de jeu game_installer.exe et un lanceur de jeu launcher.exe. L'exemple montre également comment utiliser CDATA. Voici à quoi ressemblera le fichier 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. -->
  <!-- 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>

  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. Exemple : path\to\play_publishing_config.xml.
    • WAB_OUTPUT_PATH : chemin d'accès au fichier WAB. Exemple : path\to\output_bundle.wab.

    Utiliser l'outil de publication Play

    Supposons que vous disposez du binaire de l'outil de publication Play playpublishingtool.exe, de la configuration de publication Play play_publishing_config.xml et du programme d'installation de votre 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 portant le nom 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, vous devriez voir un résultat semblable à celui-ci :

    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

    Activer la lecture automatique lors de l'installation de vos jeux natifs pour PC (facultatif)

    Google Play Games sur PC vous permet d'activer une fonctionnalité de "lecture automatique", qui lance automatiquement votre jeu immédiatement après la fin du processus d'installation. Cette fonctionnalité offre une expérience utilisateur fluide en redirigeant le joueur directement vers le jeu, entièrement authentifié dans l'écosystème Google Play Jeux sur PC.

    Fonctionnement

    Lorsque vous activez la fonctionnalité, Google Play Jeux sur PC transmet un jeton de session au processus d'installation tiers à l'aide d'arguments de ligne de commande. Votre programme d'installation est alors responsable de l'extraction de ce jeton et de son utilisation pour lancer l'exécutable du jeu dans un contexte authentifié.

    Prérequis

    Pour utiliser cette fonctionnalité, votre programme d'installation tiers doit être en mesure de gérer les arguments de ligne de commande.

    Étapes de mise en œuvre

    1. Activer la lecture automatique dans la configuration de publication Play

      Pour activer cette fonctionnalité, ajoutez l'attribut acceptsCommandLineArguments à l'élément <installer> dans votre fichier play_publishing_config.xml.

      Exemple d'extrait du contenu de 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
      • Type: Boolean
      • Par défaut : false
      • Comportement : lorsque vous définissez la valeur sur "true", GPG ajoute le jeton de session aux arguments de ligne de commande lors de l'exécution de votre programme d'installation.

    2. Gérer le jeton de session dans votre programme d'installation

      Lorsque votre programme d'installation est lancé par le client GPG, il reçoit le jeton de session en tant qu'argument de ligne de commande.

      • Format de l'argument : --g_session_token=<TOKEN>

      Voici ce que vous devez faire :

      • Extraction : votre programme d'installation doit analyser les arguments de ligne de commande pour récupérer la chaîne de jeton.
      • Propagation : si votre flux d'installation implique le lancement d'un lanceur secondaire ou d'un processus de jeu, votre programme d'installation est responsable de la transmission sécurisée du jeton de session au processus de jeu final qui utilise le SDK.
      • Lancement : utilisez le jeton de session fourni pour démarrer l'exécutable du jeu. Cela garantit que le jeu s'exécute dans un contexte GPG authentifié. Sinon, InitializeSDK échouera et votre joueur devra redémarrer votre jeu.

    3. Gestion des erreurs et solutions de repli

      • Récupération de jeton : si, pour une raison quelconque, GPG ne peut pas générer ni transmettre de jeton de session (par exemple, en cas d'échec de la génération de jeton), le processus d'installation se poursuit. Toutefois, votre programme d'installation sera lancé sans l'argument --g_session_token.
      • Robustesse : votre programme d'installation doit être conçu pour gérer les scénarios dans lesquels le jeton de session est absent. Dans ce cas, le programme d'installation doit procéder à une installation standard. Vous ne devez pas déclencher le lancement automatique du jeu, car InitializeSDK échouera de toute façon.
      • Erreurs du programme d'installation : vous êtes responsable de la robustesse et de la gestion des erreurs de votre programme d'installation et de la séquence de lancement du jeu qu'il initie. GPG n'a aucun contrôle sur les processus qui se produisent dans le programme d'installation après son lancement.

Publier le jeu à l'aide de la Play Console

Une fois que vous avez créé le fichier WAB pour votre jeu, importez-le dans la Play Console et gérez ses paramètres et exigences. Suivez les étapes 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 la Play Console, dans le menu de gauche, sélectionnez Test et publication > Configuration > Paramètres avancés (lien direct).

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

  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 Vue d'ensemble 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 la Play Console, dans le menu de gauche, sélectionnez Test et publication > 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 à 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 la Play Console, dans le menu de gauche, sélectionnez Test et publication > Production (lien direct).
  8. Sur la page Production, sélectionnez Google Play Games sur PC (Windows) uniquement dans le menu déroulant du facteur de forme.
  9. Dans l'onglet App bundle Windows , cliquez sur Modifier , puis importez le fichier WAB.

Configurer la configuration requise pour Windows PC

Pour configurer la configuration requise pour Windows PC :

  1. Dans la Play Console, dans le menu de gauche, sélectionnez Développer votre audience > Présence sur le Play Store > Paramètres du Play Store (lien direct).
  2. Dans la section Configuration requise pour PC, cliquez sur le bouton Modifier à droite.
  3. Mettez à jour les champs, puis cliquez sur Enregistrer.

Configurer l'image d'achat via une application

Il s'agit d'une étape facultative. Pour configurer l'image d'achat via une application :

  1. Dans la Play Console, dans le menu de gauche, 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 accédez alors à la page Fiche Play Store par défaut.
  3. Accédez à la section Google Play Jeux sur PC , puis importez l'image dans Image d'achat via une application dans Google Play Jeux sur PC (Windows).
  4. Cliquez sur Enregistrer.

Envoyer les modifications pour examen

  1. Dans la Play Console, dans le menu de gauche, 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 a approuvé vos modifications, votre jeu sera détectable sur Google Play.