Esegui l'app demo

In questa pagina viene descritto come eseguire un test end-to-end utilizzando un'app demo e Google Play Console.

Passi

Per scaricare l'SDK, esegui l'app demo, verifica che l'app funzioni correttamente e visualizza le informazioni sulla durata dei frame dall'app in Google Play Console:

1. Scarica il file ZIP dell'SDK e decomprimilo.
2. Crea ed esegui l'app demo.
3. Esegui l'app di monitoraggio.
4. Crea una build della release.
5. Esegui la build della release.
6. Visualizza i grafici in Google Play Console.

Crea ed esegui l'app demo

Esegui l'app demo di APT Insights in Android Studio per assicurarti che tutto venga creato correttamente. Questo progetto utilizza CMake per la creazione di codice nativo e mostra come utilizzare il file gamesdk.cmake, che è il modo più semplice per iniziare.

Per eseguire l'app demo, segui questi passaggi:

1. Estrai il contenuto del file ZIP in una cartella.
2. Apri Android Studio.
3. Fai clic su File > Apri e seleziona gamesdk/samples/tuningfork/insightsdemo/build.gradle.
4. Attendi che Android Studio sincronizzi il progetto.
5. Collega un dispositivo (o crea un dispositivo virtuale) per eseguire l'esempio. Attiva le opzioni sviluppatore e il debug USB sul dispositivo.

6. Seleziona il dispositivo di destinazione e fai clic su Esegui . Per ulteriori informazioni, vedi Creare ed eseguire un'app.

   

7. L'APK di esempio deve essere creato e installato sul dispositivo di destinazione. Se si verificano errori, controlla quanto segue:

   • Disponi di una versione supportata dell'SDK Android; consulta il campo compileSdkVersion nel file build.gradle del modulo dell'app per ulteriori informazioni. Puoi aggiornare la versione dell'SDK dalla scheda Piattaforme SDK di SDK Manager.
   • Disponi di una versione supportata dell'NDK di Android; consulta il campo ndkVersion nel file build.gradle del modulo dell'app per ulteriori informazioni. Puoi installare una versione specifica dell'NDK dalla scheda SDK Tools in SDK Manager.
   • Il file local.properties nel progetto non include una voce per ndk.dir. Questa località è specificata da Android Studio e utilizza la versione NDK indicata sopra. Se è presente questa voce, cancella l'intera riga.
   • Dopo ogni modifica all'impostazione di build, pulisci il progetto (Crea > Pulisci progetto) e aggiorna i progetti C++ collegati (Crea > Aggiorna progetti C++ collegati).

Esegui l'app di monitoraggio

Con una build di debug dell'app demo o di qualsiasi altra app compatibile con Tuning Fork, puoi configurare l'app in modo da inviare e ricevere dati da un endpoint locale anziché dal server Google Play. Per farlo, imposta endpoint_uri_override nelle impostazioni del diapason:

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

Devi anche includere le seguenti autorizzazioni nel file AndroidManifest.xml:

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

L'app demo presenta già queste modifiche (vedi insightsdemo.cpp).

Puoi utilizzare questa funzionalità per verificare che un'app invii e riceva i dati corretti. Per verificarlo, esegui contemporaneamente l'app demo e l'app Tuning Fork Monitor. Questa app di monitoraggio funge da server locale e mostra i dati prodotti da un'app abilitata per Tuning Fork.

Per eseguire contemporaneamente l'app di monitoraggio e l'app demo al fine di verificare che l'app demo funzioni correttamente:

1. Installa l'APK dell'app Tuning Fork Monitor sul dispositivo di destinazione utilizzando adb:

   adb install gamesdk/gamesdk/apks/tools/TuningForkMonitor.apk
   

2. Apri l'app di monitoraggio.
3. Premi il pulsante Home di Android per inviare l'app Tuning Fork Monitor in background sul dispositivo.
4. Esegui di nuovo l'app demo in primo piano per circa 30 secondi.
5. Torna all'app Tuning Fork Monitor.
6. L'app demo viene visualizzata in Live Applications come com.tuningfork.insightsdemo 16. Tocca questa voce per vedere i dettagli sull'app e la telemetria in tempo reale.

Crea una build di release

Crea una build di release dell'app demo in Android Studio. Carica questa build su Google Play Console per abilitare i grafici della durata frame in Android vitals.

1. Abilitare l'API Android Performance Parameters nella console Google Cloud. Questa API consente all'app di comunicare con Google Play. Non è necessario limitare la chiave API per l'app demo.

2. Assicurati di copiare la chiave API dal passaggio precedente nel campo api_key in gamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt.

3. L'ID applicazione dell'app demo è riservato, quindi non è possibile caricare un APK che lo utilizza. Modifica questo ID nel file build.gradle dell'app:

   applicationId "com.tuningfork.your-unique-identifier"
   

4. Pulisci il progetto (Crea > Pulisci progetto) e aggiorna i progetti C++ collegati (Crea > Aggiorna progetti C++ collegati).

5. Crea una configurazione di firma per le build della release.

   1. Seleziona File > Struttura del progetto > Moduli.
   2. Seleziona la scheda Signing Configs (Configurazioni di firma).
   3. Aggiungi una nuova configurazione denominata release.
   4. Crea un archivio chiavi per la configurazione.

6. Associa la configurazione della firma della release alla variante della build della release.

   1. Seleziona File > Struttura del progetto > Crea varianti.
   2. Seleziona la scheda Tipi di build.
   3. Seleziona il tipo di build denominato release.
   4. Nella casella Configurazione di firma, seleziona la variabile di configurazione della release.

7. Nella finestra del progetto Android Studio, seleziona la directory app. Questa selezione consente la selezione del menu nel passaggio successivo.

8. Cambia la variante di build attiva in release (Build > seleziona Build variante).

9. Seleziona Build > Build bundle/APK(s) > Build APK(s). Una volta completata la build, fai clic sul link Individua per trovare l'APK della release.

10. Crea una nuova applicazione per l'app demo in Google Play Console. Per ulteriori informazioni, vedi Caricamento di un'app.

11. Carica l'APK della release nel canale di test interno. Per saperne di più, consulta Preparare e implementare le release.

esegui la build della release

Seleziona il dispositivo di destinazione e fai clic su Esegui . Devi utilizzare lo stesso APK di release che hai caricato su Google Play Console.

Lascia in esecuzione l'app demo per un po' di tempo. Google Play Console potrebbe impiegare fino a 30 minuti per iniziare a visualizzare i dati. Verifica che i dati vengano caricati sul server selezionando il livello di log Info nella finestra Logcat. Se vengono visualizzati errori nel log, consulta Risoluzione degli errori comuni.

... 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 {}

Visualizzare i grafici in Google Play Console

Apri Google Play Console e seleziona l'applicazione di test. Seleziona Android Vitals > Prestazioni > Approfondimenti per visualizzare il grafico della durata frame.

Figura 4. Grafico di Android vitals

Aver eseguito correttamente un test end-to-end con la libreria di Tuning Fork. Puoi eliminare il progetto dell'app di test in Google Play Console perché non è più necessario.