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

Attention:Ce guide concerne l'utilisation de Play Jeux. Services v1. SDK C et conseils d'accompagnement pour la version 2 des services de jeux Play seront bientôt disponibles. En attendant, vous trouverez plus d'informations sur la v2 dans le guide de connexion. Si vous souhaitez tester la nouvelle version du SDK, veuillez contacter contactez 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 Google Play API des services de jeux. Avant de commencer, téléchargez et configurez les éléments requis 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: Configurez votre environnement

1. Téléchargez le SDK Android et le NDK Android, puis extrayez-les sur votre ordinateur. Dans votre définissez SDK_ROOT sur l'emplacement du dossier de votre SDK Android et NDK_ROOT sur le emplacement de votre dossier NDK Android.
2. Téléchargez les exemples de jeux C++. Ce Dans le guide du développeur, l'emplacement des exemples sur votre ordinateur est appelé SAMPLES_DIR.
3. Téléchargez le SDK C++ des services de jeux Google Play. Extrayez la sur votre ordinateur de développement. Dans votre environnement, définissez la variable NDK_MODULE_PATH sur pointez vers le répertoire au-dessus du répertoire gpg-cpp-sdk. Vous devez disposer des éléments suivants : structure de répertoires:

   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 en cliquant sur Préférences > Android > NDK

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

   1. Dans Eclipse, cliquez sur File > (Fichier >) Importer > Android > Code Android existant dans l'espace de travail
   2. Sélectionner 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 Terminer.

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

   1. Dans Eclipse, cliquez sur File > (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 minimalisteActivity, puis cliquez sur Propriétés. Sous Android, faites défiler l'écran. accédez à la section Bibliothèque et vérifiez que le projet "google-play-services_lib" est correctement configuré référencées. Si ce n'est pas le cas, supprimez la référence, puis ajoutez-la à nouveau à 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 le faire manuellement, accédez à le dossier jni et exécutez ndk-build. N'oubliez pas de le faire après avoir effectué des modifications dans le 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 Google Play Console

Créez une entrée pour votre jeu dans la Google Play Console. Cela permet d'activer les services de jeux 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 la 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 tout au long du 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-y l'ID de votre application. Notez que l'ID de l'application est différent de l'identifiant du client ; il s'agit du numéro situé à côté du nom de votre jeu sur la page Caractéristiques du jeu de la Google Play Console.

Étape 3: Exécuter l'exemple

Pour exécuter l'exemple, vous avez besoin d'un appareil Android physique ou d'un émulateur avec Services Google Play installés:

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

Important :Veillez à signer votre APK avec le même certificat que celui dont l'empreinte digitale que vous avez configurée dans la Google Play Console. Dans le cas contraire,

Important :Si vous testez un jeu non publié, assurez-vous que le compte avec lequel vous avez l'intention de vous connecter (généralement, le compte sur l'appareil de test) est comme testeur du projet. Ouvrez la page Tests, dans le dans le sous-onglet Services de jeux de la Google Play Console, pour accéder à la liste blanche ou l'ajouter à la liste blanche. Le fait de ne pas cette étape amène le serveur à agir comme si votre n'existe pas et renvoie des erreurs.

Facultatif: Compiler automatiquement avec Eclipse

Les étapes suivantes vous expliquent comment configurer Eclipse pour qu'il exécute automatiquement ndk-build lorsque vous Modifiez les fichiers du dossier jni.

1. Effectuez un clic droit sur le projet minimalisteActivity, puis cliquez sur Propriétés. Dans la fenêtre "Propriétés", Sélectionnez le volet Builders (Compilateurs).
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 et accédez au répertoire NDK_ROOT. sélectionnez la commande ndk-build.
5. Sous Working Directory (Répertoire de travail), cliquez sur Browse Workspace (Parcourir l'espace de travail), puis sélectionnez l'activité minimaliste. dans le dossier du projet.
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 Specific resources (Ressources spécifiques), puis cliquez sur Specify Resources (Spécifier les ressources). Dans dans la boîte de dialogue qui s'affiche, sélectionnez le dossier jni sous "MinimalActivity".
8. Cliquez sur Apply (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 imprime la ligne dans la console Eclipse.

Remarque :Si vous rencontrez des erreurs lors de la modification de fichiers C ou C++ dans Eclipse, qui vous empêchent de compiler le vous pouvez désactiver la création de rapports d'erreurs C/C++ dans Eclipse. Dans les propriétés de votre projet, accédez à C/C++ General > Analyse du code > Lancement et assurez-vous que les deux boîtes décochée. Cliquez ensuite sur Apply (Appliquer), puis sur OK. Il s'agit d'une solution de contournement pour empêcher Eclipse de vérifier votre code natif, cela ne corrige pas les éventuelles erreurs sous-jacentes réelles.