Cette page a été traduite par l'API Cloud Translation.

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 :

Téléchargez l'outil de publication Play. Vous pouvez exécuter cet outil sur la ligne de commande Windows ou PowerShell.
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.
    Avertissement : affiche une invite UAC pour le joueur.
    - 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 : clé racine qui contiendra toutes les informations de votre registre. Il doit être unique sur la machine de l'utilisateur. Il s'agit du chemin d'accès relatif en plus de HKLM. Exemple : SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName. Cette entrée créera une clé racine sous HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName sur un ordinateur Windows 11 64 bits.
  - 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.
    Avertissement : affiche une invite UAC pour le joueur.
    - 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.
    Avertissement : affiche une invite UAC pour le joueur.
    - 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>
    <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>
```
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.
Important : Le nom de fichier WAB dans --output doit avoir une extension .wab.

Remarque : Les chemins --input et --output peuvent être absolus ou relatifs par rapport au répertoire de travail actuel.
Utiliser l'outil de publication Play

Imaginons que vous disposez du fichier 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 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.

Dans le menu de gauche de la Play Console, sélectionnez Tester et publier > Configuration > Paramètres avancés (lien direct).
Accédez à l'onglet Facteurs de forme, puis ajoutez Google Play Games on PC à partir du menu déroulant + Ajouter un facteur de forme.

Remarque : Si vous ne pouvez pas accéder à Google Play Jeux sur PC dans l'onglet "Facteurs de forme", vous pouvez contacter nos partenaires Play pour qu'ils ajoutent votre compte à la liste d'autorisation.
Cliquez sur le bouton Gérer correspondant au facteur de forme Google Play Jeux sur PC sur la droite.
Sélectionnez l'option Utiliser un canal dédié pour l'app bundle Windows de votre jeu.
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 :

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

Importer le fichier WAB

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

Dans le menu de gauche de la Play Console, sélectionnez Tester et publier > Paramètres avancés (lien direct).
Sur la page Paramètres avancés, cliquez sur l'onglet Facteurs de forme.
Dans l'onglet Facteurs de forme, cliquez sur + Ajouter un facteur de forme, puis sélectionnez Google Play Jeux sur PC.
Dans la section Google Play Jeux sur PC, cliquez sur Gérer.
Sélectionnez Utiliser un canal dédié pour l'app bundle Windows de votre jeu.
Cliquez sur Enregistrer.
Dans le menu de gauche de la Play Console, sélectionnez Tester et publier > Production (lien direct).
Sur la page Production, sélectionnez Google Play Jeux sur PC (Windows) uniquement dans le menu déroulant des facteurs de forme.
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 :

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).
Dans la section Configuration PC requise, cliquez sur le bouton Modifier à droite.
Modifiez les champs, puis cliquez sur Enregistrer.

Configurer l'image d'achat via une application

Cette étape est facultative. Pour configurer le graphique des achats via l'application :

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).
Dans la section Fiche Play Store par défaut de l'onglet Fiches, cliquez sur le bouton -> (flèche) à droite. Vous serez redirigé vers la page Fiche Play Store par défaut.
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).
Cliquez sur Enregistrer.

Envoi des modifications pour examen

Dans la Play Console, dans le menu de gauche, sélectionnez Vue d'ensemble de la publication.
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.

Publication du programme d'installation Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer

Empaqueter votre jeu sous forme de fichier WAB

Exemple de fichier de configuration de publication Play

Utiliser l'outil de publication Play

Publier le jeu à l'aide de la Play Console

Ajouter le facteur de forme Google Play Jeux sur PC

Activer la publication gérée

Importer le fichier WAB

Configurer la configuration requise pour les PC Windows

Configurer l'image d'achat via une application

Envoi des modifications pour examen

Publication du programme d'installation