Esegui l'app demo

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

Passi

Per scaricare l'SDK, esegui l'app demo, verifica che funzioni correttamente e visualizzare le informazioni sulla durata frame dall'app in Google Play Console, procedi nel seguente modo: seguenti:

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 APT Insights in Android Studio per verificare che tutto correttamente le build. Questo progetto utilizza CMake per la creazione di codice nativo e mostra come per usare il file gamesdk.cmake, che è il modo più semplice per iniziare.

Per eseguire l'app demo, procedi nel seguente modo:

1. Estrai i contenuti 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. Connetti un dispositivo (o crea un dispositivo virtuale) per eseguire l'esempio. Attiva opzioni sviluppatore e debug USB su del dispositivo.

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

   di Gemini Advanced.

   .

7. L'APK di esempio dovrebbe essere creato e installato sul dispositivo di destinazione. Se riscontri errori, verifica quanto segue:

   • Disporre di una versione supportata di Android SDK; vedi il campo compileSdkVersion nel modulo dell'app build.gradle per ulteriori informazioni. Puoi aggiornare la versione dell'SDK dal Scheda Piattaforme SDK in SDK Manager.
   • Disporre di una versione supportata di Android NDK vedi 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 (Strumenti SDK) in SDK Manager.
   • Il file local.properties nel progetto non contiene una voce per ndk.dir. Questa posizione è specificata da Android Studio e utilizza l'NDK precedente. Se è presente questa voce, cancella l'intera riga.
   • Dopo aver modificato l'impostazione di compilazione, pulisci il progetto (Crea > Pulisci progetto) e aggiorna i progetti C++ collegati (Crea > Aggiorna progetto collegato progetti C++).

Esegui l'app di monitoraggio

Con una build di debug dell'app demo o di qualsiasi altra app abilitata per Tuning Fork, puoi configurare l'app per inviare e ricevere dati da un endpoint locale anziché rispetto al server di Google Play. Per farlo, imposta endpoint_uri_override nel le impostazioni di Tuning Fork:

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

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

<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 funzione per verificare che un'app stia inviando e ricevendo dati appropriati. Per verificarlo, esegui l'app demo e l'app Tuning Fork Monitor all'indirizzo contemporaneamente. Questa app di monitoraggio funge da server locale e visualizza i dati prodotti da un'app abilitata per Tuning Fork.

Eseguire contemporaneamente l'app di monitoraggio e l'app demo per verificare che la demo funziona correttamente, procedi nel seguente modo:

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 al sfondo sul dispositivo.
4. Esegui di nuovo l'app demo in primo piano per circa 30 minuti secondi.
5. Torna all'app Tuning Fork Monitor.
6. L'app demo viene visualizzata nella sezione Applicazioni live come com.tuningfork.insightsdemo 16. Tocca questa voce per visualizzare dettagli sull'app e informazioni pubblicate la telemetria.

Crea una build di release

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

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

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

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

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

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

5. Crea una configurazione di firma per le build delle 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 configurazione.

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

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

7. Nella finestra del progetto Android Studio, seleziona la directory app. (Questo consente di selezionare il menu nel passaggio successivo.)

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

9. Seleziona Crea > Creare bundle/APK > Creare APK. Quando viene creato fai clic sul link trova per trovare l'APK di release.

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

11. Carica l'APK di release nel canale di test interno. Per ulteriori informazioni, vedi Preparazione 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 nella Google Play Console.

Lascia in esecuzione l'app demo per un po'. Potrebbero essere necessari fino a 30 minuti prima che l'account Google Play Console per iniziare a visualizzare i dati. Verifica che i dati vengano caricati selezionando il livello di log Info nella finestra Logcat. Se vedi errori nel log, consulta Risoluzione degli errori più 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 {}

Visualizza i grafici in Google Play Console

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

Figura 4. Grafico Android vitals

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