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

Antes de comenzar

En esta guía para desarrolladores, se muestra cómo compilar y ejecutar un juego de C++ en Android que usa la API de servicios de juego de Google Play. 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 muestras de NDK antes de continuar.

Paso 1: Configura tu entorno

  1. Descarga el SDK de Android y el NDK de Android y extráelos en tu equipo. En tu entorno, establece SDK_ROOT en la ubicación de la carpeta del SDK de Android y NDK_ROOT en la ubicación de la carpeta del NDK de Android.
  2. Descarga los juegos de muestra de C++. En esta guía para desarrolladores, se hace referencia 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 SDK en tu máquina de desarrollo. En tu entorno, configura la variable NDK_MODULE_PATH para que apunte al directorio sobre el directorio gpg-cpp-sdk. Debes tener la siguiente estructura de directorio:
    NDK_MODULE_PATH/
    gpg-cpp-sdk/
  4. Abre Eclipse. Si todavía no lo hiciste, haz clic en Preferencias > Android > NDK para indicarle a Eclipse el lugar en que instalaste el 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 Archivo > Importar > Android > Código Android existente en Workspace.
    2. Selecciona SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib, en el que 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 Archivo > Importar > Android > Código Android existente en Workspace.
    2. Seleccione 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 Properties. En Android, desplázate hacia abajo hasta la sección Biblioteca y asegúrate de que se haga referencia al proyecto google-play-services_lib correctamente. De lo contrario, quita la referencia y vuelve a agregarla a tu espacio 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 realizar cualquier cambio en la carpeta jni.

Tu proyecto debería compilarse, aunque todavía no funcionará. Primero, debes configurar el 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 aplicación y crea un ID de cliente de OAuth 2.0, si aún no tienes uno.

  1. Crea una entrada para tu juego mediante los pasos que se describen en la sección sobre cómo configurar los servicios de juego de Google Play.
  2. En AndroidManifest.xml, cambia el atributo package de la etiqueta <manifest> al nombre del paquete que elegiste cuando configuraste Google Play Console. Es posible que debas corregir algunas referencias en todo el proyecto después de realizar este cambio (en especial, 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 igual al ID de cliente; es el número junto al nombre de tu juego en la página Detalles del juego de Google Play Console.

Paso 3: Ejecuta la muestra

Para ejecutar la muestra, necesitarás un dispositivo Android físico o un emulador con los 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 la muestra en el dispositivo.
  3. Cuando se abra la muestra, presiona cualquier parte de la pantalla. Deberías ver un logotipo de Google Play Juegos. Si configuraste correctamente la aplicación, se te solicitará que accedas.

Opcional: Compila automáticamente con Eclipse

En los siguientes pasos, se muestra cómo configurar Eclipse para ejecutar ndk-build de forma automática cuando realizas cambios en los archivos de la carpeta jni.

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

Ahora, cada vez que edites un archivo dentro de la carpeta jni, Eclipse ejecutará ndk-build y, luego, imprimirá el resultado en Eclipse Console.