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 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, 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>
    <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. Par 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. 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 l'exécutable en tant qu'administrateur.
        • "false" : exécutez l'exécutable en tant qu'utilisateur actuel.

      • 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. Par 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, ces 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> balises, à 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. 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 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écutez l'exécutable en tant qu'administrateur.
        • "false" : exécutez l'exécutable en tant qu'utilisateur actuel.

      • RELATIVE_PATH_TO_LAUNCHER_EXE: chemin d'accès au lanceur ou à l'exécutable de votre jeu dans le répertoire d'installation. Vous devez inclure le nom de fichier du lanceur ou de l'exécutable de votre 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 indiquer 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écutez l'exécutable en tant qu'administrateur.
        • "false" : exécutez 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. -->
  <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

    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

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, puis 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 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 Jeux 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 appli 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.