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 di 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 del codice nativo e mostra come usare il file gamesdk.cmake, che è il modo più semplice per iniziare.

Per eseguire l'app demo:

  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 Opzioni sviluppatore e debug USB sul dispositivo.

  6. Seleziona il dispositivo di destinazione e fai clic su Esegui Pulsante Esegui Android Studio. Per ulteriori informazioni, vedi Creare ed eseguire la tua app.

    Figura 1. App di prova eseguita correttamente

  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 del modulo dell'app build.gradle per ulteriori informazioni. Puoi aggiornare la versione dell'SDK dalla scheda Piattaforme SDK in 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 contiene una voce per ndk.dir. Questa posizione è specificata da Android Studio e utilizza la versione NDK di cui 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 che invii e riceva i dati da un endpoint locale anziché dal server di 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 agisce come un 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 stia funzionando 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 Applicazioni dal vivo come com.tuningfork.insightsdemo 16. Tocca questa voce per vedere i dettagli dell'app e la telemetria in tempo reale.
Figura 2. L'app di monitoraggio rileva l'app demo
Figura 3. L'app di monitoraggio mostra i dati dell'app demo

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 di temporizzazione dei 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 del 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 di 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 > Genera 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. Modifica la variante di build attiva in release (Build > Seleziona variante build).

  9. Seleziona Build > Build bundle/APK > Build APK. Al termine della build, fai clic sul link trova per trovare l'APK della release.

  10. Crea una nuova applicazione per l'app demo in Google Play Console. Per ulteriori informazioni, consulta 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 Pulsante Esegui Android Studio. Devi utilizzare lo stesso APK di release che hai caricato in Google Play Console.

Lascia in esecuzione l'app demo per un po' di tempo. Potrebbero essere necessari fino a 30 minuti prima che Google Play Console inizi a mostrare i dati. Verifica che i dati vengano caricati nel server selezionando il livello di log Informazioni nella finestra Logcat. Se vengono visualizzati errori nel log, consulta Risolvere gli 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

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

Indietro
Informazioni su Android Performance Tuner
Avanti
Attiva l'API Android Performance Parameters