Cómo comenzar a usar los Servicios de juego de Play para C++ en Android

Antes de comenzar

Esta guía para desarrolladores te mostrará cómo compilar y ejecutar un juego de C++ en Android que usa Google Play. API de servicios de juego Antes de comenzar, descarga y configura los siguientes requisitos:

En esta guía para desarrolladores, se usa el kit de desarrollo nativo (NDK) de Android. Si no conoces el NDK, consulta la documentación y las muestras del NDK antes de continuar.

Paso 1: Configura tu entorno

  1. Descarga el SDK de Android y el NDK de Android, y extráelos a tu equipo. En tu Configura SDK_ROOT en la ubicación de tu carpeta del SDK de Android y NDK_ROOT en la ubicación de tu carpeta del NDK de Android.
  2. Descarga los juegos de muestra de C++. Esta la guía para desarrolladores se refiere a la ubicación de las muestras en tu máquina como SAMPLES_DIR.
  3. Descarga el SDK de C++ de Servicios de juego de Google Play. Extrae el archivo en tu máquina de desarrollo. En tu entorno, configura la variable NDK_MODULE_PATH de la siguiente manera: apuntan al directorio arriba del directorio gpg-cpp-sdk. Deberías tener lo siguiente del directorio principal: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Abre Eclipse. Si todavía no lo hiciste, indícale a Eclipse la ubicación en la que instalaste el NDK. Para ello, indica hacer clic en Preferencias > Android > NDK

  5. Importa el proyecto de biblioteca de Servicios de Google Play a tu lugar de trabajo de Eclipse.

    1. En Eclipse, haz clic en File > Importar > Android > Android Code existente en Workspace
    2. Seleccionar SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib En el ejemplo anterior, SDK_ROOT es la ubicación de tu SDK de Android.
    3. Haz clic en Finalizar.

  6. Importa el proyecto de muestra minimalista a tu lugar de trabajo de Eclipse.

    1. En Eclipse, haz clic en File > Importar > Android > Android Code existente en Workspace
    2. Selecciona SAMPLES_DIR/samples-android/minimalist.
    3. Haz clic en Finalizar.

  7. Haz clic con el botón derecho en el proyecto MinimalistActivity y, luego, en Propiedades. En Android, desplázate. hasta la sección Biblioteca y asegúrate de que el proyecto google-play-services_lib esté a los que se hace referencia. De lo contrario, quita la referencia y vuelve a agregarla de tu lugar de trabajo.

Eclipse compilará automáticamente las fuentes de Java y Android de tu proyecto. Sin embargo, el código nativo de la carpeta jni se debe compilar por separado. Para hacerlo de forma manual, navega a la carpeta jni y ejecuta ndk-build. Recuerda hacer esto después de hacer cambios en el interior la carpeta jni.

Ahora tu proyecto debería compilarse, aunque todavía no funcionará. Primero debes configurar tu juego en Google Play Console.

Paso 2: Configura el juego en Google Play Console

Crea una entrada para tu juego en Google Play Console. Esto habilita los servicios de juego para tu y crea un ID de cliente de OAuth 2.0, si aún no tienes uno.

  1. Crea una entrada para tu juego siguiendo los pasos que se describen en Cómo configurar los Servicios de juego de Google Play
  2. En AndroidManifest.xml, cambia el atributo package de la etiqueta <manifest> a la nombre de paquete que elegiste cuando configuraste Google Play Console. Es posible que debas corregir algunas referencias. a lo largo del proyecto después de realizar este cambio (en particular, en la clase R generada).
  3. Abre res/values/ids.xml y coloca el ID de la app allí. Ten en cuenta que el ID de la app no es el mismo que el ID de cliente; Es el número que aparece junto al nombre del juego en la página Detalles del juego de Google Play Console.

Paso 3: Ejecuta la muestra

Para ejecutar el ejemplo necesitarás un dispositivo Android físico o un emulador con Servicios de Google Play instalados:

  1. Ejecuta ndk-build para compilar el código nativo.
  2. En Eclipse, haz clic en Ejecutar > Ejecutar como > Aplicación para Android y ejecuta el ejemplo en tu dispositivo.
  3. Cuando se abra la muestra, presiona en cualquier lugar de la pantalla. Deberías ver el logotipo de Google Play Juegos para que aparezca la opción. Si configuraste tu app de forma correcta, se te solicitará que accedas.

Opcional: compilación automática con Eclipse

Los siguientes pasos te muestran cómo configurar Eclipse para que ejecute ndk-build automáticamente cuando realiza cambios en los archivos de la carpeta jni.

  1. Haz clic con el botón derecho en el proyecto MinimalistActivity y, luego, en Propiedades. En la ventana Properties, Selecciona el panel Builders.
  2. Haz clic en New para agregar un nuevo Builder, selecciona Program y haz clic en OK.
  3. En el campo Name, ingresa 'NDK Builder'.
  4. En Ubicación, haz clic en Explorar sistema de archivos y navega al directorio NDK_ROOT y selecciona el comando ndk-build.
  5. En Directorio de trabajo, haz clic en Explorar lugar de trabajo y selecciona MinimalistActivity. en la carpeta del proyecto.
  6. Haz clic en la pestaña Actualizar. Asegúrate de que la casilla Actualizar recursos al finalizar esté marcada.
  7. Elige el botón de selección Specific resources y, luego, haz clic en Specify Resources. En la en el diálogo resultante, selecciona la carpeta jni en MinimalActivity.
  8. Haz clic en Apply y, luego, en OK para terminar de crear tu Builder.

Ahora, cada vez que edites un archivo dentro de la carpeta jni, Eclipse ejecutará ndk-build e imprimirá la salida en la consola de Eclipse.