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:
- NDK de Android, revisión 14 o posterior
- SDK de Android versión 10 o posterior y versión más reciente del complemento ADT para Eclipse
- El dispositivo debe ejecutar Android 4.0 (nivel de API 14) o una versión posterior.
- La versión más reciente del SDK de Servicios de Google Play.
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
- 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 yNDK_ROOT
en la ubicación de la carpeta del NDK de Android. - 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
. - 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 directoriogpg-cpp-sdk
. Debes tener la siguiente estructura de directorio:NDK_MODULE_PATH/ gpg-cpp-sdk/
- 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.
Importa el proyecto de biblioteca de servicios de Google Play a tu lugar de trabajo de Eclipse.
- En Eclipse, haz clic en Archivo > Importar > Android > Código Android existente en Workspace.
- Selecciona
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
, en el queSDK_ROOT
es la ubicación de tu SDK de Android. - Haz clic en Finalizar.
Importa el proyecto de muestra minimalista a tu lugar de trabajo de Eclipse.
- En Eclipse, haz clic en Archivo > Importar > Android > Código Android existente en Workspace.
- Seleccione
SAMPLES_DIR/samples-android/minimalist
. - Haz clic en Finalizar.
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.
- 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.
- En
AndroidManifest.xml
, cambia el atributopackage
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 claseR
generada). - 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:
- Ejecuta
ndk-build
para compilar el código nativo. - En Eclipse, haz clic en Ejecutar > Ejecutar como > Aplicación para Android y ejecuta la muestra en el dispositivo.
- 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
.
- Haz clic con el botón derecho en el proyecto MinimalistActivity y, luego, en Properties. En la ventana Properties, selecciona el panel Builders.
- Haga clic en New para agregar un nuevo Builder, seleccione Program y, luego, haga clic en OK.
- En el campo Nombre, ingresa "NDK Builder".
- En Ubicación, haz clic en Explorar el sistema de archivos, navega al directorio
NDK_ROOT
y selecciona el comandondk-build
. - En Directorio de trabajo, haz clic en Explorar el lugar de trabajo y selecciona la carpeta del proyecto MinimalistActivity.
- Haz clic en la pestaña Actualizar. Asegúrate de que la casilla Actualizar recursos al finalizar esté marcada.
- 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. - 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.