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

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

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 environnement, définissez SDK_ROOT sur l'emplacement de votre dossier de SDK Android et NDK_ROOT sur l'emplacement de votre dossier de 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 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épertoires suivante: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Ouvrez Eclipse. Si vous ne l'avez pas déjà fait, indiquez à Eclipse l'emplacement 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. Faites un clic droit sur le projet MinimalistActivity, puis cliquez sur Propriétés. Sous Android, faites défiler la page jusqu'à la section Library (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, puis ajoutez-la de 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 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 la procédure décrite dans la section Configurer les services de jeux Google Play.
  2. Dans AndroidManifest.xml, remplacez l'attribut package de la balise <manifest> par le nom du package que vous avez choisi lors de la configuration de la Google Play Console. Vous devrez peut-être corriger certaines références dans l'ensemble 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 votre ID d'application. Notez que l'ID de l'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'exemple s'ouvre, appuyez n'importe où sur l'écran. Le logo Google Play Jeux doit s'afficher. Si vous avez correctement configuré votre application, vous serez invité à vous connecter.

Facultatif: Compilation automatique avec Eclipse

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

  1. Faites un clic droit sur le projet MinimalistActivity, puis cliquez sur Propriétés. Dans la fenêtre "Propriétés", sélectionnez le volet Constructeurs.
  2. Cliquez sur Nouveau pour ajouter un compilateur, sélectionnez Programme, puis cliquez sur OK.
  3. Dans le champ Nom, saisissez "NDK Builder".
  4. Sous Location (Emplacement), cliquez sur Browse File System (Parcourir le système de fichiers), accédez au répertoire NDK_ROOT, puis sélectionnez la commande ndk-build.
  5. Sous Working Directory (Répertoire de travail), cliquez sur Browse Workspace (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 de créer votre générateur.

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