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

Attention : Ce guide concerne l'utilisation des services de jeux Play v1. Le SDK C et les conseils associés pour les services de jeux Play version 2 seront bientôt disponibles. En attendant, vous trouverez plus d'informations sur la version 2 dans le guide de connexion. Si vous souhaitez tester la nouvelle version du SDK, veuillez contacter votre représentant Google pour en savoir plus.

Avant de commencer

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 NDK avant de continuer.

Étape 1: Configurez 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 Android NDK.
2. Téléchargez les exemples de jeux C++. Dans ce guide du développeur, l'emplacement des exemples sur votre machine est appelé SAMPLES_DIR.
3. Téléchargez le SDK C++ des services Google Play Jeux. 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 devez 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 la bibliothèque des services Google Play dans votre espace de travail Eclipse.

   1. Dans Eclipse, cliquez sur 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 est l'emplacement de votre SDK Android.
   3. Cliquez sur Finish (Terminer).

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

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

7. Effectuez un clic droit sur le projet minimalisteActivity, puis cliquez sur Properties (Propriétés). Sous Android, faites défiler la page jusqu'à la section Bibliothèque pour vous assurer que le projet google-play-services_lib est correctement référencé. Sinon, supprimez la référence et ajoutez-la à nouveau depuis votre espace de travail.

Eclipse compile 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, accédez au dossier jni et exécutez ndk-build. N'oubliez pas de le faire après toute modification apportée au dossier jni.

Votre projet devrait maintenant être compilé, 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 console Google Play

Créez une entrée pour votre jeu dans la Google Play Console. Cette opération 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 la procédure décrite dans Configurer les services de jeux Google Play.
2. Dans AndroidManifest.xml, remplacez l'attribut package du tag <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 pour la classe R générée).
3. Ouvrez res/values/ids.xml et placez votre ID d'application à cet endroit. Notez que l'ID de l'application est différent de l'ID client. Il s'agit du numéro situé à côté du nom de votre jeu sur la page Game Details (Détails du jeu) de la Google Play Console.

Étape 3: Exécutez l'exemple

Pour exécuter l'exemple, vous devez disposer 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'exemple s'ouvre, appuyez n'importe où sur l'écran. Un logo Google Play Jeux doit 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 sur la Google Play Console. Dans le cas contraire, des erreurs se produiront.

Important:Si vous testez un jeu non publié, assurez-vous que le compte avec lequel vous souhaitez vous connecter (généralement le compte sur l'appareil de test) est répertorié en tant que testeur dans le projet. Ouvrez la page Tests dans le sous-onglet Services de jeux de la Google Play Console pour vérifier ou ajouter la liste blanche. Si vous n'effectuez pas cette étape, le serveur agit comme si votre projet n'existait pas et renvoyait 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 minimalisteActivity, puis cliquez sur Properties (Propriétés). Dans la fenêtre "Propriétés", sélectionnez le volet Builders.
2. Cliquez sur New (Nouveau) pour ajouter un nouveau compilateur, sélectionnez Program (Programme), puis cliquez sur OK.
3. Dans le champ 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 minimalisteActivity.
6. Cliquez sur l'onglet Actualiser. Assurez-vous que la case Actualiser les ressources à la fin est cochée.
7. Cochez la case Ressources spécifiques, puis cliquez sur Spécifier les 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 compilateur.

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

Remarque : Si vous rencontrez des erreurs lors de la modification de fichiers C ou C++ dans Eclipse, vous pouvez désactiver le reporting d'erreur C/C++ dans Eclipse. Dans les propriétés de votre projet, accédez à C/C++ General > Code Analysis > Launching (Général/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, mais elle ne résout pas les éventuelles erreurs sous-jacentes réelles.