Auf dieser Seite wird beschrieben, wie du einen End-to-End-Test mit einer Demo-App und der Google Play Console durchführst.
Schritte
So laden Sie das SDK herunter, führen die Demo-App aus, prüfen, ob die App korrekt funktioniert, und sehen sich die Frame-Timing-Informationen der App in der Google Play Console an:
- Laden Sie die SDK-ZIP-Datei herunter und entpacken Sie sie.
- Erstellen Sie die Demo-App und führen Sie sie aus.
- Führen Sie die Monitor-App aus.
- Erstellen Sie einen Release-Build.
- Führen Sie den Release-Build aus.
- Sieh dir die Grafiken in der Google Play Console an.
Demo-App erstellen und ausführen
Führen Sie die APT Insights-Demo-App in Android Studio aus, um zu prüfen, ob alles korrekt erstellt wird. In diesem Projekt wird CMake für die native Codeerstellung verwendet. Es wird gezeigt, wie die Datei gamesdk.cmake
verwendet wird, womit der Einstieg am einfachsten gelingt.
So führen Sie die Demo-App aus:
- Entpacken Sie den Inhalt der ZIP-Datei in einen Ordner.
- Öffnen Sie Android Studio.
- Klicken Sie auf File > Open (Datei > Öffnen) und wählen Sie
gamesdk/samples/tuningfork/insightsdemo/build.gradle
aus. - Warten Sie, bis Android Studio das Projekt synchronisiert hat.
- Verbinden Sie ein Gerät (oder erstellen Sie ein virtuelles Gerät), um das Beispiel auszuführen. Aktivieren Sie auf dem Gerät Entwickleroptionen und USB-Debugging.
Wählen Sie das Zielgerät aus und klicken Sie auf Ausführen
. Weitere Informationen finden Sie unter Anwendung erstellen und ausführen.
Abbildung 1: Test-App wird ausgeführt Das Beispiel-APK sollte auf dem Zielgerät erstellt und installiert werden. Wenn Fehler auftreten, prüfen Sie Folgendes:
- Du verwendest eine unterstützte Version des Android SDK. Weitere Informationen findest du im Feld
compileSdkVersion
in der Dateibuild.gradle
des App-Moduls. Im SDK-Manager können Sie auf dem Tab SDK-Plattformen die SDK-Version aktualisieren. - Du hast eine unterstützte Version des Android-NDK. Weitere Informationen findest du im Feld
ndkVersion
in der Dateibuild.gradle
des App-Moduls. Über den Tab SDK Tools im SDK Manager kannst du eine bestimmte Version des NDK installieren. - Die Datei
local.properties
im Projekt enthält keinen Eintrag fürndk.dir
. Dieser Speicherort wird von Android Studio angegeben und verwendet die oben genannte NDK-Version. Wenn Sie diesen Eintrag haben, löschen Sie die gesamte Zeile. - Nachdem Sie die Build-Einstellungen geändert haben, bereinigen Sie das Projekt (Erstellen > Projekt bereinigen) und aktualisieren Sie die verknüpften C++-Projekte (Erstellen > Verknüpfte C++-Projekte aktualisieren).
- Du verwendest eine unterstützte Version des Android SDK. Weitere Informationen findest du im Feld
Monitor-App ausführen
Mit einem Debug-Build der Demo-App oder einer anderen Abstimmung Fork-fähigen App können Sie die App so konfigurieren, dass Daten von einem lokalen Endpunkt statt vom Google Play-Server gesendet und empfangen werden. Dazu legen Sie den endpoint_uri_override
in den Einstellungen für Feinabstimmung fest:
#ifndef NDEBUG
settings.endpoint_uri_override = "http://localhost:9000";
#endif
Außerdem müssen Sie die folgenden Berechtigungen in die Datei AndroidManifest.xml
aufnehmen:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
In der Demo-App wurden diese Änderungen bereits vorgenommen (siehe insightsdemo.cpp
).
Mit dieser Funktion können Sie prüfen, ob eine Anwendung die richtigen Daten sendet und empfängt. Um dies zu überprüfen, führen Sie die Demo-App und die Abstimmung Fork Monitor-App gleichzeitig aus. Diese Monitoring-App fungiert als lokaler Server und zeigt die Daten an, die von einer Abstimmung Fork-fähigen Anwendung erzeugt werden.
So führen Sie die Monitoring-App und die Demo-App gleichzeitig aus, um zu prüfen, ob die Demo-App ordnungsgemäß funktioniert:
- Installieren Sie das APK der Abstimmung Fork Monitor App mit ADB auf dem Zielgerät:
adb install gamesdk/gamesdk/apks/tools/TuningForkMonitor.apk
- Öffnen Sie die Monitoring-App.
- Drücken Sie die Startbildschirmtaste von Android, um die App "Abstimmung Fork Monitor" in den Hintergrund des Geräts zu senden.
- Führen Sie die Demo-App noch einmal ca. 30 Sekunden lang im Vordergrund aus.
- Wechseln Sie zurück zur Abstimmung Fork Monitor App.
- Die Demo-App wird unter Live-Apps als
com.tuningfork.insightsdemo 16
angezeigt. Tippen Sie auf diesen Eintrag, um App-Details und Live-Telemetrie aufzurufen.
![](https://developer.android.com/static/images/games/performance-tuner/monitor-app1.png?authuser=6&hl=de)
![](https://developer.android.com/static/images/games/performance-tuner/monitor-app2.png?authuser=6&hl=de)
Release-Build erstellen
Erstellen Sie einen Release-Build der Demo-App in Android Studio. Du lädst diesen Build in die Google Play Console hoch, um Frame-Timing-Diagramme in Android Vitals zu aktivieren.
Aktivieren Sie die Android Performance Parameters API in der Google Cloud Console. Über diese API kann die App mit Google Play kommunizieren. Sie müssen den API-Schlüssel für die Demo-App nicht einschränken.
Kopieren Sie Ihren API-Schlüssel aus dem vorherigen Schritt in das Feld
api_key
ingamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt
.Die Anwendungs-ID der Demo-App ist reserviert. Daher kann kein APK hochgeladen werden, in dem sie verwendet wird. Ändern Sie diese ID in der Datei
build.gradle
der App:applicationId "com.tuningfork.your-unique-identifier"
Bereinigen Sie das Projekt (Erstellen > Projekt bereinigen) und aktualisieren Sie die verknüpften C++-Projekte (Erstellen > Verknüpfte C++-Projekte aktualisieren).
Signaturkonfiguration für Release-Builds erstellen
- Wählen Sie File > Project Structure > Modules (Datei > Projektstruktur > Module) aus.
- Wählen Sie den Tab Signing Configs (Signaturkonfigurationen) aus.
- Fügen Sie eine neue Konfiguration mit dem Namen
release
hinzu. - Erstellen Sie einen Schlüsselspeicher für die Konfiguration.
Verknüpfen Sie die Release-Signaturkonfiguration mit der Release-Build-Variante.
- Wählen Sie File > Project Structure > Build Variants (Datei > Projektstruktur > Varianten erstellen) aus.
- Wählen Sie den Tab Build-Typen aus.
- Wählen Sie den Build-Typ mit dem Namen
release
aus. - Wählen Sie im Feld Signing Config (Signaturkonfiguration) die Variable für die Releasekonfiguration aus.
Wählen Sie im Android Studio-Projektfenster das Verzeichnis app aus. (Dadurch wird die Menüauswahl im nächsten Schritt aktiviert.)
Ändern Sie die aktive Build-Variante in
release
(Build > Build-Variante auswählen).Wählen Sie Build > Build-Bundles/APK(s) > Build APK(s)(Build > Build-Bundles/APKs > Build-APKs) aus. Wenn der Build abgeschlossen ist, klicken Sie auf den Link Suchen, um das Release-APK zu finden.
Erstellen Sie in der Google Play Console eine neue App für die Demo-App. Weitere Informationen finden Sie unter Anwendung hochladen.
Laden Sie das Release-APK in den internen Test-Track hoch. Weitere Informationen finden Sie unter Releases vorbereiten und einführen.
Release-Build ausführen
Wählen Sie das Zielgerät aus und klicken Sie auf Ausführen
.
Du musst dasselbe Release-APK verwenden, das du in die Google Play Console hochgeladen hast.
Lassen Sie die Demo-App eine Weile laufen. Es kann bis zu 30 Minuten dauern, bis die Google Play Console Daten anzeigt. Prüfen Sie, ob Daten auf den Server hochgeladen werden. Wählen Sie dazu im Fenster Logcat die Logebene Info aus. Wenn im Log Fehler enthalten sind, lesen Sie den Abschnitt Häufige Fehler beheben.
... 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 {}
Diagramme in der Google Play Console ansehen
Öffne die Google Play Console und wähle die Test-App aus. Wähle Android Vitals > Leistung > Statistiken aus, um das Frame Time-Diagramm aufzurufen.
Abbildung 4: Grafik zu Android Vitals
Sie haben erfolgreich einen End-to-End-Test mit der Bibliothek „Abstimmung Fork“ ausgeführt. Sie können das Test-App-Projekt in der Google Play Console löschen, da es nicht mehr benötigt wird.