Cómo ejecutar la app de demostración

En esta página, se describe cómo ejecutar una prueba de extremo a extremo por medio de una app de demostración y Google Play Console.

Pasos

Sigue los pasos a continuación para descargar el SDK, ejecutar la app de demostración, verificar que esta funcione correctamente y ver en ella la información de latencia de fotogramas en Google Play Console:

  1. Descarga el archivo ZIP del SDK y descomprímelo.
  2. Compila y ejecuta la app de demostración.
  3. Ejecuta la app de supervisión.
  4. Crea una compilación de lanzamiento.
  5. Ejecuta la compilación de lanzamiento.
  6. Mira los gráficos en Google Play Console.

Cómo compilar y ejecutar la app de demostración

Ejecuta la app de demostración APT Insights en Android Studio para asegurarte de que todo se compile correctamente. En este proyecto, se usa CMake para la compilación de código nativo y se muestra cómo usar el archivo gamesdk.cmake, que es la forma más fácil de comenzar.

Para ejecutar la app de demostración, haz lo siguiente:

  1. Extrae el contenido del archivo ZIP en una carpeta.
  2. Abre Android Studio.
  3. Haz clic en File > Open y, luego, selecciona gamesdk/samples/tuningfork/insightsdemo/build.gradle.
  4. Espera a que Android Studio sincronice el proyecto.
  5. Conecta un dispositivo (o crea un dispositivo virtual) para ejecutar la muestra. Habilita las opciones para desarrolladores y la depuración por USB en el dispositivo.
  6. Selecciona el dispositivo de destino y haz clic en Run Botón Run de Android Studio. Para obtener más información, consulta Cómo compilar y ejecutar tu app.

    Figura 1: la app de prueba se ejecuta correctamente
  7. El APK de muestra debe compilarse e instalarse en el dispositivo de destino. Si se producen errores, verifica que se cumpla lo siguiente:

    • Tienes una versión compatible del SDK de Android. Consulta el campo compileSdkVersion en el archivo build.gradle del módulo de la app para obtener más información. Puedes actualizar la versión del SDK desde la pestaña SDK Platforms en SDK Manager.
    • Tienes una versión compatible del NDK de Android. Consulta el campo ndkVersion en el archivo build.gradle del módulo de la app para obtener más información. Puedes instalar una versión específica del NDK desde la pestaña SDK Tools en SDK Manager.
    • El archivo local.properties del proyecto no tiene una entrada para ndk.dir. Android Studio especifica esta ubicación y utiliza la versión del NDK que figura arriba. Si aparece esta entrada, borra toda la línea.
    • Después de cambiar cualquier configuración de compilación, limpia el proyecto (Build > Clean Project) y actualiza los proyectos de C++ vinculados (Build > Refresh Linked C++ Projects).

Cómo ejecutar la app de supervisión

Con una compilación de depuración de la app de demostración o cualquier otra app habilitada para Tuning Fork, puedes configurar la app a fin de que envíe y reciba datos desde un extremo local, en lugar de que lo haga desde el servidor de Google Play. Para hacerlo, establece endpoint_uri_override en la configuración de Tuning Fork:

#ifndef NDEBUG
   settings.endpoint_uri_override = "http://localhost:9000";
#endif

También debes incluir los siguientes permisos en el archivo AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

La app de demostración ya tiene estos cambios (consulta insightsdemo.cpp).

Puedes usar esta función a fin de verificar que una app envíe y reciba los datos adecuados. Para verificarlo, ejecuta la app de demostración y la app de Tuning Fork Monitor al mismo tiempo. Esta app de supervisión actúa como un servidor local y muestra los datos que produce una app compatible con Tuning Fork.

Para ejecutar la app de supervisión y la de demostración al mismo tiempo a fin de verificar que esta última funciona correctamente, haz lo siguiente:

  1. Instala el APK de la app de Tuning Fork Monitor en el dispositivo de destino mediante adb:
    adb install gamesdk/gamesdk/apks/tools/TuningForkMonitor.apk
    
  2. Abre la app de supervisión.
  3. Presiona el botón de inicio de Android para enviar la app Tuning Fork Monitor al segundo plano del dispositivo.
  4. Vuelve a ejecutar la app de demostración en primer plano durante unos 30 segundos.
  5. Vuelve a la app de Tuning Fork Monitor.
  6. La app de demostración aparece en Live Applications como com.tuningfork.insightsdemo 16. Presiona esta entrada para ver los detalles de la app y la telemetría en vivo.
Figura 2: la app de supervisión detecta la app de demostración
Figura 3: la app de supervisión muestra los datos de la app de demostración

Cómo crear una compilación de lanzamiento

Crea una compilación de lanzamiento de la app de demostración en Android Studio. Luego, súbela a Google Play Console para habilitar los gráficos de latencia de fotogramas en Android vitals.

  1. Habilita la API de Android Performance Parameters en Google Cloud Console. Esta API permite que la app se comunique con Google Play. Para la app de demostración, elige una de las siguientes formas de habilitar esta API:

    1. Usa el asistente para crear un proyecto de Google Cloud Console y habilitar la API en un solo paso (recomendado). Debes acceder a tu cuenta de desarrollador de Google para habilitar esta opción. Asegúrate de copiar la clave de API en el paso final del asistente. De lo contrario, podrás encontrarla en Google Cloud Console.

      ASISTENTE DE LA API

    2. Habilita la API en Google Cloud Console (consulta las instrucciones de Console). No necesitas restringir la clave de API para la app de demostración.

  2. Asegúrate de copiar tu clave de API del paso anterior en el campo api_key de gamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt.

  3. El ID de aplicación de la app de demostración está reservado, por lo que no se puede subir un APK que lo use. Cambia este ID en el archivo build.gradle de la app:

    applicationId "com.tuningfork.your-unique-identifier"
    
  4. Limpia el proyecto (Build > Clean Project) y actualiza los proyectos de C++ vinculados (Build > Refresh Linked C++ Projects).

  5. Crea una configuración de firma para las compilaciones de lanzamiento.

    1. Selecciona File > Project Structure > Modules.
    2. Selecciona la pestaña Signing Configs.
    3. Agrega una nueva configuración llamada release.
    4. Crea un almacén de claves para la configuración.
  6. Asocia la configuración de firma de lanzamiento con la variante de compilación de lanzamiento.

    1. Selecciona File > Project Structure > Build Variants.
    2. Selecciona la pestaña Build Types.
    3. Selecciona el tipo de compilación llamado release.
    4. En el cuadro Signing Config, selecciona la variante de configuración de lanzamiento.
  7. En la ventana del proyecto de Android Studio, selecciona el directorio app. Esta selección habilita la selección del menú del paso siguiente.

  8. Cambia la variante de compilación activa a release (Build > Select Build Variant).

  9. Selecciona Build > Build Bundles(s)/APK(s) > Build APK(s). Cuando se complete la compilación, haz clic en el vínculo ubicar para buscar el APK de lanzamiento.

  10. Crea una aplicación nueva para la app de demostración en Google Play Console. Para obtener más información, consulta Cómo subir una app.

  11. Sube el APK de lanzamiento al Segmento de pruebas interno. Para obtener más información, consulta Cómo preparar y lanzar versiones.

Cómo ejecutar la compilación de lanzamiento

Selecciona el dispositivo de destino y haz clic en Run Botón Run de Android Studio. Debes usar el mismo APK de lanzamiento que subiste a Google Play Console.

Deja que la app de demostración se ejecute por un tiempo. Google Play Console puede tardar hasta 30 minutos en comenzar a mostrar datos. Verifica que los datos se suban al servidor seleccionando el nivel de registro Info, en la ventana Logcat. Si ves errores en el registro, consulta Cómo solucionar errores comunes.

... I/TuningFork:Web: Connecting to:
    https://performanceparameters.googleapis.com/v1/applications/com.tuningfork.yourapp/apks/24:uploadTelemetry
... I/TuningFork: Scene loading 30 (true) took 166 ms
... I/TuningFork:Web: Response code: 200
... I/TuningFork:Web: Response message: OK
... I/TuningFork.GE: UPLOAD request returned 200 {}

Cómo ver los gráficos en Google Play Console

Abre Google Play Console y selecciona la aplicación de prueba. Selecciona Android Vitals > Performance > Insights a fin de ver el gráfico de tiempo de latencia de fotogramas.

Figura 4: gráfico de Android vitals

Ejecutaste con éxito una prueba de extremo a extremo con la biblioteca de Tuning Fork. Puedes borrar el proyecto de app de prueba en Google Play Console, dado que ya no es necesario.