Premiers pas avec les services de jeux Play pour C++ sur Android

Suite à l'arrêt de l'API Google Sign-In, nous allons supprimer le SDK v1 pour les jeux en 2026. Après février 2025, vous ne pourrez plus publier de titres qui viennent d'être intégrés au SDK v1 de Jeux sur Google Play. Nous vous recommandons d'utiliser plutôt le SDK v2 de Jeux.
Bien que les titres existants avec les intégrations de jeux v1 précédentes continuent de fonctionner pendant quelques années, nous vous encourageons à migrer vers la v2 à partir de juin 2025.
Ce guide explique comment utiliser la version 1 du SDK des services de jeux Play. Le SDK C++ pour les services de jeux Play v2 n'est pas encore disponible.

Ce guide du développeur vous explique comment compiler et exécuter un jeu C++ sur Android qui utilise l'API des services de jeux Google Play. Avant de commencer, téléchargez et configurez les éléments suivants :

• Android NDK, révision 14 ou ultérieure.
• SDK Android v10 ou version ultérieure et dernière version d'Eclipse ADT.
• L'appareil doit être équipé d'Android 4.0 (niveau d'API 14) ou version ultérieure.
• La dernière version du SDK des services Google Play

Ce guide du développeur utilise le kit de développement natif Android (NDK). Si vous ne connaissez pas le NDK, consultez la documentation et les exemples du NDK avant de continuer.

Étape 1 : Configurer votre environnement

1. Téléchargez le SDK Android et le NDK Android, puis extrayez-les sur votre ordinateur. Dans votre environnement, définissez SDK_ROOT sur l'emplacement de votre dossier SDK Android et NDK_ROOT sur l'emplacement de votre dossier NDK Android.
2. Téléchargez les exemples de jeux C++. Dans ce guide du développeur, l'emplacement des exemples sur votre ordinateur est désigné par SAMPLES_DIR.
3. Téléchargez le SDK C++ des services de jeux Google Play. Extrayez le SDK sur votre ordinateur de développement. Dans votre environnement, définissez la variable NDK_MODULE_PATH pour qu'elle pointe vers le répertoire au-dessus du répertoire gpg-cpp-sdk. Vous devriez disposer de la structure de répertoire suivante :

   NDK_MODULE_PATH/
   gpg-cpp-sdk/

4. Ouvrez Eclipse. Si vous ne l'avez pas déjà fait, indiquez à Eclipse où vous avez installé le NDK en cliquant sur Préférences > Android > NDK.

5. Importez le projet de bibliothèque des services Google Play dans votre espace de travail Eclipse.

   1. Dans Eclipse, cliquez sur File > Import > Android > Existing Android Code into Workspace (Fichier > Importer > Android > Code Android existant dans l'espace de travail).
   2. Sélectionnez SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib, où SDK_ROOT correspond à l'emplacement de votre SDK Android.
   3. Cliquez sur Terminer.

6. Importez l'exemple de projet minimaliste dans votre espace de travail Eclipse.

   1. Dans Eclipse, cliquez sur File > Import > Android > Existing Android Code into Workspace (Fichier > Importer > Android > Code Android existant dans l'espace de travail).
   2. Sélectionnez SAMPLES_DIR/samples-android/minimalist.
   3. Cliquez sur Terminer.

7. Effectuez un clic droit sur le projet MinimalistActivity, puis cliquez sur Properties (Propriétés). Sous Android, faites défiler l'écran jusqu'à la section Bibliothèque et assurez-vous que le projet google-play-services_lib est correctement référencé. Si ce n'est pas le cas, supprimez la référence et ajoutez-la à nouveau depuis votre espace de travail.

Eclipse compilera automatiquement les sources Java et Android de votre projet. Toutefois, le code natif du dossier jni doit être compilé séparément. Pour ce faire manuellement, accédez au dossier jni et exécutez ndk-build. N'oubliez pas de le faire après avoir apporté des modifications dans le dossier jni.

Votre projet devrait maintenant se compiler, mais il ne fonctionnera pas encore. Vous devez d'abord configurer votre jeu dans la Google Play Console.

Étape 2 : Configurez le jeu dans la Google Play Console

Créez une entrée pour votre jeu dans la Google Play Console. Cela active les services de jeux pour votre application et crée un ID client OAuth 2.0 si vous n'en avez pas déjà un.

1. Créez une entrée pour votre jeu en suivant les étapes décrites dans Configurer les services de jeux Google Play.
2. Dans AndroidManifest.xml, remplacez l'attribut package de la balise <manifest> par le nom de package que vous avez choisi lors de la configuration de la Google Play Console. Vous devrez peut-être corriger certaines références dans le projet après avoir effectué cette modification (en particulier dans la classe R générée).
3. Ouvrez res/values/ids.xml et saisissez l'ID de votre application. Notez que l'ID d'application n'est pas le même que l'ID client. Il s'agit du numéro à côté du nom de votre jeu sur la page Détails du jeu de la Google Play Console.

Étape 3 : Exécuter l'exemple

Pour exécuter l'exemple, vous aurez besoin d'un appareil Android physique ou d'un émulateur sur lequel les services Google Play sont installés :

1. Exécutez ndk-build pour compiler le code natif.
2. Dans Eclipse, cliquez sur Run > Run As > Android Application (Exécuter > Exécuter en tant que > Application Android), puis exécutez l'exemple sur votre appareil.
3. Lorsque l'échantillon s'ouvre, appuyez n'importe où sur l'écran. Le logo Google Play Jeux devrait s'afficher. Si vous avez correctement configuré votre application, vous serez invité à vous connecter.

Important : Assurez-vous de signer votre APK avec le même certificat que celui dont vous avez configuré l'empreinte digitale dans la Google Play Console. Si vous ne le faites pas, des erreurs se produiront.

Important : Si vous testez un jeu non publié, assurez-vous que le compte avec lequel vous prévoyez de vous connecter (généralement le compte sur l'appareil de test) figure en tant que testeur dans le projet. Ouvrez la page Tests dans la sous-onglet Services de jeux de la Google Play Console pour vérifier ou effectuer la mise sur liste blanche. Si vous ne le faites pas, le serveur agira comme si votre projet n'existait pas et renverra des erreurs.

Facultatif : Compiler automatiquement avec Eclipse

Les étapes suivantes vous montrent comment configurer Eclipse pour exécuter automatiquement ndk-build lorsque vous modifiez des fichiers dans le dossier jni.

1. Effectuez un clic droit sur le projet MinimalistActivity, puis cliquez sur Properties (Propriétés). Dans la fenêtre "Propriétés", sélectionnez le volet Builders.
2. Cliquez sur Nouveau pour ajouter un Builder, sélectionnez Programme, puis cliquez sur OK.
3. Dans le champ Name (Nom), saisissez "NDK Builder".
4. Sous Emplacement, cliquez sur Parcourir le système de fichiers, accédez au répertoire NDK_ROOT et sélectionnez la commande ndk-build.
5. Sous Répertoire de travail, cliquez sur Parcourir l'espace de travail et sélectionnez le dossier du projet MinimalistActivity.
6. Cliquez sur l'onglet Actualiser. Assurez-vous que la case Actualiser les ressources à la fin est cochée.
7. Sélectionnez la case d'option Ressources spécifiques, puis cliquez sur Spécifier des ressources. Dans la boîte de dialogue qui s'affiche, sélectionnez le dossier jni sous MinimalActivity.
8. Cliquez sur Appliquer, puis sur OK pour terminer la création de votre générateur.

Désormais, chaque fois que vous modifierez un fichier dans le dossier jni, Eclipse exécutera ndk-build et imprimera le résultat dans la console Eclipse.

Remarque : Si des erreurs s'affichent lorsque vous modifiez des fichiers C ou C++ dans Eclipse et vous empêchent de compiler le projet, vous pouvez désactiver le signalement des erreurs C/C++ dans Eclipse. Dans les propriétés de votre projet, accédez à C/C++ General > Code Analysis > Launching (C/C++ > Analyse du code > Lancement) et assurez-vous que les deux cases sont décochées. Cliquez ensuite sur Appliquer, puis sur OK. Il s'agit d'une solution de contournement pour empêcher Eclipse de vérifier votre code natif. Elle ne corrige pas les éventuelles erreurs sous-jacentes.