Demo-App ausführen

Auf dieser Seite wird beschrieben, wie Sie einen End-to-End-Test mit einer Demo-App und dem Google Play Console

Schritte

Führen Sie zum Herunterladen des SDK die Demo-App aus, prüfen Sie, ob die App richtig funktioniert, und aus der App in der Google Play Console Informationen zum Frame-Timing abrufen, Folgendes:

1. Laden Sie die SDK-ZIP-Datei herunter und entpacken Sie sie.
2. Erstellen Sie die Demo-App und führen Sie sie aus.
3. Führen Sie die Monitor-App aus.
4. Erstellen Sie einen Release-Build.
5. Führen Sie den Release-Build aus.
6. Sieh dir die Grafiken in der Google Play Console an.

Demo-App erstellen und ausführen

Führen Sie die Demo-App von APT Insights in Android Studio aus, um sicherzustellen, richtig erstellt. Dieses Projekt nutzt CMake für die Erstellung nativer Codes und zeigt, wie die gamesdk.cmake-Datei zu verwenden. Das ist die einfachste Methode, um loszulegen.

So führen Sie die Demo-App aus:

1. Entpacken Sie den Inhalt der ZIP-Datei in einen Ordner.
2. Öffnen Sie Android Studio.
3. Klicken Sie auf Datei > Öffnen und wählen Sie gamesdk/samples/tuningfork/insightsdemo/build.gradle
4. Warten Sie, bis Android Studio das Projekt synchronisiert hat.
5. Gerät verbinden (oder virtuelles Gerät erstellen) um das Beispiel auszuführen. Aktivieren Entwickleroptionen und USB-Debugging auf auf dem Gerät.

6. Wählen Sie das Zielgerät aus und klicken Sie auf Ausführen. Weitere Informationen finden Sie unter Anwendung erstellen und ausführen.

   <ph type="x-smartling-placeholder">

   </ph> <ph type="x-smartling-placeholder">

7. Das Beispiel-APK sollte auf dem Zielgerät erstellt und installiert werden. Wenn Sie überprüfen Sie Folgendes:

   • Sie haben eine unterstützte Version von Android. SDK; siehe Feld compileSdkVersion im App-Modul build.gradle . Sie können die SDK-Version zu aktualisieren, SDK-Plattformen im SDK Manager.
   • Sie haben eine unterstützte Version von Android. NDK Das Feld ndkVersion in der build.gradle-Datei des Anwendungsmoduls ansehen . Sie können eine bestimmte Version des NDK installieren über den Tab SDK-Tools im SDK Manager.
   • Die Datei local.properties im Projekt enthält keinen Eintrag für ndk.dir. Dieser Speicherort wird von Android Studio angegeben und verwendet das NDK. oben. Wenn Sie einen solchen Eintrag haben, löschen Sie die gesamte Zeile.
   • Bereinigen Sie das Projekt nach jeder Änderung der Build-Einstellung über Build > Clean Project) und aktualisieren Sie die verknüpften C++-Projekte (Build > Refresh Linked) C++-Projekte.

Monitor-App ausführen

Mit einem Debug-Build der Demo-App oder einer anderen Tuning Fork-fähigen App können Sie die App so konfigurieren, dass Daten von einem lokalen Endpunkt gesendet und empfangen werden, als der Google Play-Server. Legen Sie dazu endpoint_uri_override fest in Einstellungen der Stimmgabeln:

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

Außerdem müssen Sie die folgenden Berechtigungen in den AndroidManifest.xml aufnehmen Datei:

<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 kannst du überprüfen, ob eine App Daten korrekt sind. Um dies zu überprüfen, führe die Demo-App und die Tuning Fork Monitor-App unter gleichzeitig. Diese Überwachungs-App fungiert als lokaler Server und zeigt die Daten an eine mit Tuning Fork erstellte App.

Um die Monitoring-App und die Demo-App gleichzeitig auszuführen, um zu prüfen, ob die Demo funktioniert App ordnungsgemäß funktioniert, gehen Sie so vor:

1. Installieren Sie das APK der Tuning Fork Monitor-App auf dem Zielgerät mit adb:

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

2. Öffnen Sie die Monitoring-App.
3. Drücken Sie die Android-Startbildschirmtaste, um die Tuning Fork Monitor-App an die Hintergrund auf dem Gerät.
4. Führen Sie die Demo-App noch einmal etwa 30 Minuten lang im Vordergrund aus. Sekunden.
5. Kehre zur App „Tuning Fork Monitor“ zurück.
6. Die Demo-App wird unter Live-Apps als com.tuningfork.insightsdemo 16 Tippe auf diesen Eintrag, um App-Details und Live-Inhalte zu sehen Telemetriedaten abzurufen.

Release-Build erstellen

Erstelle einen Release-Build der Demo-App in Android Studio. Sie laden diese Kreation hoch in der Google Play Console, um Frame-Timing-Grafiken in Android Vitals zu aktivieren.

1. Android Performance Parameters API aktivieren in der Google Cloud Console. Diese API ermöglicht der App die Kommunikation mit Google Play Sie müssen den API-Schlüssel für die Demo-App nicht einschränken.

2. Kopieren Sie Ihren API-Schlüssel aus dem vorherigen Schritt in den api_key Feld in gamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt.

3. Die App-ID der Demo-App ist reserviert, daher kann kein APK hochgeladen werden, das . Ändern Sie diese ID in der Datei build.gradle der App:

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

4. Bereinigen Sie das Projekt (Build > Clean Project) und aktualisieren Sie die verknüpfte C++- (Build > Verknüpfte C++-Projekte aktualisieren) aufrufen.

5. Signaturkonfiguration für Release-Builds erstellen

   1. Wählen Sie Datei > Projektstruktur > Module.
   2. Wählen Sie den Tab Signing Configs (Konfigurationen signieren) aus.
   3. Fügen Sie eine neue Konfiguration mit dem Namen release hinzu.
   4. Erstellen Sie einen Schlüsselspeicher für den Konfiguration.

6. Verknüpfen Sie die Konfiguration der Releasesignatur mit der Release-Build-Variante.

   1. Wählen Sie Datei > Projektstruktur > Build-Varianten.
   2. Wählen Sie den Tab Build-Typen aus.
   3. Wählen Sie den Build-Typ release aus.
   4. Wählen Sie im Feld Signing Config (Konfiguration für Signatur) die Releasekonfiguration aus. .

7. Wählen Sie im Android Studio-Projektfenster das Verzeichnis app aus. (Diese Auswahl aktiviert die Menüauswahl im nächsten Schritt.)

8. Ändern Sie die aktive Build-Variante in release (Erstellen > Build auswählen). Variante) angezeigt.

9. Wählen Sie Erstellen > Build-Bundles/APKs > Build-APKs Wenn der Build klicken Sie auf den Link Suchen, um das Release-APK zu finden.

10. Erstelle in der Google Play Console eine neue App für die Demo-App. Für finden Sie unter Laden Sie eine App hoch.

11. Laden Sie das Release-APK in den internen Test-Track hoch. Weitere Informationen Siehe Vorbereiten und Releases 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 den Google Play Console

Lassen Sie die Demo-App eine Weile laufen. Es kann bis zu 30 Minuten dauern, bis die Play Console, um Daten anzuzeigen. Stellen Sie sicher, dass Daten in den indem Sie die Logebene Info im Fenster Logcat auswählen. Wenn Sie Fehler im Protokoll, siehe 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 {}

Grafiken in der Google Play Console ansehen

Öffnen Sie die Google Play Console und wählen Sie die Test-App aus. Wählen Sie Android Vitalparameter > Leistung > Statistiken, um das Frame Time-Diagramm zu sehen.

Abbildung 4: Android Vitals-Diagramm

Sie haben erfolgreich einen End-to-End-Test mit der Stimmgabel durchgeführt. Bibliothek. Sie können das Test-App-Projekt in der Google Play Console löschen, da es nicht mehr benötigt.