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
- 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 etNDK_ROOT
sur l'emplacement de votre dossier Android NDK. - 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
. - 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épertoiregpg-cpp-sdk
. Vous devez disposer de la structure de répertoire suivante :NDK_MODULE_PATH/ gpg-cpp-sdk/
- 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.
Importez le projet de la bibliothèque des services Google Play dans votre espace de travail Eclipse.
- Dans Eclipse, cliquez sur Fichier > Importer > Android > Code Android existant dans l'espace de travail.
- Sélectionnez
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
, oùSDK_ROOT
est l'emplacement de votre SDK Android. - Cliquez sur Finish (Terminer).
Importez l'exemple de projet minimaliste dans votre espace de travail Eclipse.
- Dans Eclipse, cliquez sur Fichier > Importer > Android > Code Android existant dans l'espace de travail.
- Sélectionnez
SAMPLES_DIR/samples-android/minimalist
. - Cliquez sur Finish (Terminer).
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.
- Créez une entrée pour votre jeu en suivant la procédure décrite dans Configurer les services de jeux Google Play.
- Dans
AndroidManifest.xml
, remplacez l'attributpackage
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 classeR
générée). - 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:
- Exécutez
ndk-build
pour compiler le code natif. - 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.
- 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.
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
.
- 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.
- Cliquez sur New (Nouveau) pour ajouter un nouveau compilateur, sélectionnez Program (Programme), puis cliquez sur OK.
- Dans le champ Nom, saisissez "NDK Builder".
- Sous Emplacement, cliquez sur Parcourir le système de fichiers, accédez au répertoire
NDK_ROOT
et sélectionnez la commandendk-build
. - Sous Répertoire de travail, cliquez sur Parcourir l'espace de travail et sélectionnez le dossier du projet minimalisteActivity.
- Cliquez sur l'onglet Actualiser. Assurez-vous que la case Actualiser les ressources à la fin est cochée.
- 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". - 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.