Erste Schritte mit Spielschleifentests

Es kann schwierig sein, Spieletests zu automatisieren, wenn Gaming-Apps auf verschiedenen UI-Frameworks basieren. Mit Spielschleifentests können Sie Ihre nativen Tests in Test Lab einbinden und sie ganz einfach auf den von Ihnen ausgewählten Geräten ausführen. Bei einem Spielschleifentest wird Ihr Test in Ihrer Gaming-App ausgeführt, während die Aktionen eines echten Spielers simuliert werden. In dieser Anleitung erfahren Sie, wie Sie einen Spielschleifentest ausführen und dann Ihre Testergebnisse in der Firebase Console ansehen und verwalten.

Je nach Game-Engine können Sie Tests mit einer oder mehreren Schleifen implementieren. Eine Schleife ist ein vollständiger oder teilweiser Durchlauf Ihres Tests in Ihrer Gaming-App. Spielschleifen können für Folgendes verwendet werden:

Ein Level Ihres Spiels so durchlaufen, wie es ein Endnutzer tun würde. Sie können die Eingabe des Nutzers entweder skripten, den Nutzer inaktiv lassen oder den Nutzer durch eine KI ersetzen, wenn das in Ihrem Spiel sinnvoll ist (z.B. wenn Sie eine Rennspiel-App haben und bereits eine KI implementiert haben. Sie können ganz einfach einen KI-Fahrer mit der Eingabe des Nutzers beauftragen).
Ihr Spiel mit der höchsten Qualitätseinstellung ausführen, um zu sehen, ob es von den Geräten unterstützt wird.
Einen technischen Test durchführen (mehrere Shader kompilieren, ausführen, prüfen, ob die Ausgabe wie erwartet ist usw.).

Sie können einen Spielschleifentest auf einem einzelnen Testgerät, einer Reihe von Testgeräten oder auf Test Lab ausführen. Wir empfehlen jedoch nicht, Spielschleifentests auf virtuellen Geräten auszuführen, da sie niedrigere Grafik-Framerate als physische Geräte haben.

Hinweis

Um einen Test zu implementieren, müssen Sie zuerst Ihre App für Spielschleifentests konfigurieren.

Fügen Sie in Ihrem App-Manifest Ihrer Aktivität einen neuen Intent-Filter hinzu:
```
<activity android:name=".MyActivity">
   <intent-filter>
       <action android:name="com.google.intent.action.TEST_LOOP"/>
       <category android:name="android.intent.category.DEFAULT"/>
       <data android:mimeType="application/javascript"/>
   </intent-filter>
   <intent-filter>
      ... (other intent filters here)
   </intent-filter>
</activity>
```
So kann Test Lab Ihr Spiel starten, indem es mit einem bestimmten Intent ausgelöst wird.

**Hinweis** :Für Spielschleifen ist ein separater, dedizierter Intent-Filter erforderlich, der nicht für andere Zwecke verwendet wird. Ihre Aktivität kann andere Intent-Filter enthalten. Weitere Informationen zu Intent-Filtern finden Sie auf der Referenzseite zu <intent-filter>.

Fügen Sie Ihrem Code Folgendes hinzu (wir empfehlen, dies in der onCreate-Methodendeklaration zu tun):

Kotlin

val launchIntent = intent
if (launchIntent.action == "com.google.intent.action.TEST_LOOP") {
    val scenario = launchIntent.getIntExtra("scenario", 0)
    // Code to handle your game loop here
}MainActivity.kt

Java

Intent launchIntent = getIntent();
if(launchIntent.getAction().equals("com.google.intent.action.TEST_LOOP")) {
    int scenario = launchIntent.getIntExtra("scenario", 0);
    // Code to handle your game loop here
}MainActivity.java

So kann Ihre Aktivität den Intent prüfen, mit dem sie gestartet wird. Sie können diesen Code auch später hinzufügen, wenn Sie möchten (z.B. nachdem Sie Ihre Game-Engine zum ersten Mal geladen haben).

Empfohlen: Fügen Sie am Ende des Tests Folgendes hinzu:
Kotlin
```
yourActivity.finish()MainActivity.kt
```
Java
```
yourActivity.finish();MainActivity.java
```
Dadurch wird Ihre App geschlossen, wenn der Spielschleifentest abgeschlossen ist. Der Test basiert auf dem UI-Framework Ihrer App, um die nächste Schleife zu starten. Wenn Sie Ihre App schließen, wird dem Framework mitgeteilt, dass der Test beendet ist.

Spielschleifentest erstellen und ausführen

Nachdem Sie Ihre App für Spielschleifentests konfiguriert haben, können Sie sofort einen Test erstellen und in Ihrer Gaming-App ausführen. Sie können einen Test in Test Lab entweder über die Firebase Console oder die gcloud Befehlszeilenschnittstelle (Command Line Interface, CLI) oder auf einem lokalen Gerät mit dem Test Loop Manager ausführen.

Auf einem lokalen Gerät ausführen

Test LabDer Test Loop Manager von' ist eine Open-Source-App, mit der Sie Spielschleifentests einbinden und auf Ihren lokalen Geräten ausführen können. Außerdem kann Ihr Qualitätssicherungsteam dieselben Spielschleifen auf seinen Geräten ausführen.

So führen Sie einen Test auf einem lokalen Gerät mit dem Test Loop Manager aus:

Laden Sie den Test Loop Manager auf ein Smartphone oder Tablet herunter und installieren Sie ihn, indem Sie Folgendes ausführen:
```
adb install testloopmanager.apk
```
Öffnen Sie auf Ihrem Gerät die App Test Loop Apps auf Ihrem Smartphone oder Tablet. In der App wird eine Liste der Apps auf Ihrem Gerät angezeigt, die mit Spielschleifen ausgeführt werden können. Wenn Ihre Gaming-App hier nicht angezeigt wird, prüfen Sie, ob Ihr Intent-Filter mit dem im ersten Schritt des Abschnitts „Hinweis“ beschriebenen übereinstimmt.
Wählen Sie Ihre Gaming-App und dann die Anzahl der Schleifen aus, die Sie ausführen möchten. Hinweis: In diesem Schritt können Sie anstelle einer einzelnen Schleife auch eine Teilmenge von Schleifen ausführen. Weitere Informationen zum gleichzeitigen Ausführen mehrerer Schleifen finden Sie unter Optionale Funktionen.
Klicken Sie auf Testen. Der Test wird sofort ausgeführt.

In Test Lab ausführen

Sie können einen Spielschleifentest in Test Lab entweder über die Firebase Konsole oder die gcloud CLI ausführen. Öffnen Sie vor Beginn die Firebase Console und erstellen Sie ein Projekt, falls Sie das noch nicht getan haben.

Firebase Console verwenden

Klicken Sie in der Firebase Console im linken Steuerfeld auf Test Lab.
Klicken Sie auf Ersten Test ausführen oder auf Test ausführen , wenn in Ihrem Projekt bereits ein Test ausgeführt wurde.
Wählen Sie Spielschleife als Testtyp aus und klicken Sie dann auf Weiter.
Klicken Sie auf Durchsuchen und suchen Sie nach der .apk-Datei Ihrer App. Hinweis: In diesem Schritt können Sie anstelle einer einzelnen Schleife auch eine Teilmenge von Schleifen ausführen. Weitere Informationen zum gleichzeitigen Ausführen mehrerer Schleifen finden Sie unter Optionale Funktionen.
Klicken Sie auf Weiter.
Wählen Sie die physischen Geräte aus, mit denen Sie Ihre App testen möchten.
Klicken Sie auf Tests starten.

Weitere Informationen zu den ersten Schritten mit der Firebase Console finden Sie unter Mit der Firebase Console testen.

gcloud-Befehlszeile (CLI) verwenden

Laden Sie das Google Cloud SDK herunter und installieren Sie es, falls Sie das noch nicht getan haben.
Melden Sie sich mit Ihrem Google-Konto in der gcloud CLI an:

gcloud auth login
Legen Sie Ihr Firebase-Projekt in gcloud fest. PROJECT_ID ist die ID Ihres Firebase-Projekts:
```
gcloud config set project PROJECT_ID
```
Führen Sie Ihren ersten Test aus:
```
gcloud firebase test android run \
 --type=game-loop --app=<var>path-to-apk</var> \
 --device model=herolte,version=23
```
Hinweis: In diesem Schritt können Sie anstelle einer einzelnen Schleife auch eine Teilmenge von Schleifen ausführen. Weitere Informationen zum gleichzeitigen Ausführen mehrerer Schleifen finden Sie unter Optionale Funktionen.

Weitere Informationen zu den ersten Schritten mit der gcloud CLI finden Sie unter Tests über die gcloud-Befehlszeile starten.

Optionale Funktionen

Test Lab bietet mehrere optionale Funktionen, mit denen Sie Ihre Tests weiter anpassen können, darunter die Möglichkeit, Ausgabedaten zu schreiben, Unterstützung für mehrere Spiel schleifen und Labels für zugehörige Schleifen.

Ausgabedaten schreiben

Ihr Spielschleifentest kann die Ausgabe in eine Datei schreiben, die in der Methode launchIntent.getData() angegeben ist. Nachdem Sie einen Test ausgeführt haben, können Sie auf diese Ausgabedaten im Bereich Test Lab der Firebase Console zugreifen (siehe Beispiel für eine Ausgabedatei für einen Spielschleifentest).

Test Lab folgt den Best Practices für die gemeinsame Nutzung einer Datei zwischen Apps, die unter Datei freigeben beschrieben sind. In der Methode onCreate() Ihrer Aktivität, in der sich Ihr Intent befindet, können Sie Ihre Datenausgabedatei mit dem folgenden Code prüfen:

Kotlin

val launchIntent = intent
val logFile = launchIntent.data
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    // ...
}MainActivity.kt

Java

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    // ...
}MainActivity.java

Wenn Sie aus der C++-Seite Ihrer Gaming-App in die Datei schreiben möchten, können Sie anstelle des Dateipfads den Dateideskriptor übergeben:

Kotlin

val launchIntent = intent
val logFile = launchIntent.data
var fd = -1
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    fd = try {
        contentResolver
            .openAssetFileDescriptor(logFile, "w")!!
            .parcelFileDescriptor
            .fd
    } catch (e: FileNotFoundException) {
        e.printStackTrace()
        -1
    } catch (e: NullPointerException) {
        e.printStackTrace()
        -1
    }
}

// C++ code invoked here.
// native_function(fd);MainActivity.kt

Java

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
int fd = -1;
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    try {
        fd = getContentResolver()
                .openAssetFileDescriptor(logFile, "w")
                .getParcelFileDescriptor()
                .getFd();
    } catch (FileNotFoundException e) {
        e.printStackTrace();
        fd = -1;
    } catch (NullPointerException e) {
        e.printStackTrace();
        fd = -1;
    }
}

// C++ code invoked here.
// native_function(fd);MainActivity.java

C++

#include <unistd.h>
JNIEXPORT void JNICALL
Java_my_package_name_MyActivity_native_function(JNIEnv *env, jclass type, jint log_file_descriptor) {
// The file descriptor needs to be duplicated.
int my_file_descriptor = dup(log_file_descriptor);
}

Beispiel für eine Ausgabedatei

Sie können Ausgabedateien (wie im folgenden Beispiel formatiert) verwenden, um die Ergebnisse von Spiel schleifentests im Test Lab Bereich der Firebase Konsole anzuzeigen. Bereiche, die als /.../ dargestellt sind, können beliebige benutzerdefinierte Felder enthalten, solange sie nicht mit den Namen anderer Felder in dieser Datei in Konflikt stehen:

{
  "name": "test name",
  "start_timestamp": 0, // Timestamp of the test start (in us).
                           Can be absolute or relative
  "driver_info": "...",
  "frame_stats": [
    {
      "timestamp": 1200000, // Timestamp at which this section was written
                               It contains value regarding the period
                               start_timestamp(0) -> this timestamp (1200000 us)
      "avg_frame_time": 15320, // Average time to render a frame in ns
      "nb_swap": 52, // Number of frame rendered
      "threads": [
        {
          "name": "physics",
          "Avg_time": 8030 // Average time spent in this thread per frame in us
        },
        {
          "name": "AI",
          "Avg_time": 2030 // Average time spent in this thread per frame in us
        }
      ],
      /.../ // Any custom field you want (vertices display on the screen, nb units …)
    },
    {
      // Next frame data here, same format as above
    }
  ],
  "loading_stats": [
    {
      "name": "assets_level_1",
      "total_time": 7850, // in us
      /.../
    },
    {
      "name": "victory_screen",
      "total_time": 554, // in us
      /.../
    }

  ],
  /.../, // You can add custom fields here
}

Mehrere Spielschleifen

Es kann nützlich sein, mehrere Spielschleifen in Ihrer App auszuführen. Eine Schleife ist ein vollständiger Durchlauf Ihrer Gaming-App von Anfang bis Ende. Wenn Ihr Spiel beispielsweise mehrere Level hat, möchten Sie möglicherweise für jedes Level eine Spielschleife haben, anstatt eine Schleife zu verwenden, die alle Level durchläuft. Wenn Ihre App auf Level 32 abstürzt, können Sie diese Spielschleife direkt starten, um den Absturz zu reproduzieren und Fehlerbehebungen zu testen.

So aktivieren Sie die gleichzeitige Ausführung mehrerer Schleifen in Ihrer App:

Wenn Sie einen Test mit dem Test Loop Manager ausführen:
1. Fügen Sie dem Manifest Ihrer App im Element <application> die folgende Zeile hinzu:
```
<meta-data
  android:name="com.google.test.loops"
  android:value="5" />
```
  Dieser Start-Intent enthält die Zielschleife als Ganzzahlparameter. Im Feld android:value können Sie eine Ganzzahl von 1 bis 1024 angeben. Das ist die maximale Anzahl von Schleifen, die für einen einzelnen Test zulässig sind. Schleifen werden ab 1 und nicht ab 0 indexiert.
2. In der App „Test Loop Manager“ wird ein Auswahlbildschirm angezeigt, auf dem Sie die auszuführenden Schleifen auswählen können. Wenn Sie mehrere Schleifen auswählen, wird jede Schleife nacheinander gestartet, nachdem die vorherige Schleife abgeschlossen ist.
Wenn Sie einen Test mit der Firebase Konsole ausführen, geben Sie im Feld Szenarien eine Liste oder einen Bereich von Schleifennummern ein.
Wenn Sie einen Test mit der gcloud CLI ausführen, geben Sie mit dem Flag --scenario-numbers eine Liste von Schleifennummern an. Beispiel: --scenario-numbers=1,3,5 führt die Schleifen 1, 3 und 5 aus.
Wenn Sie C++ schreiben und das Verhalten Ihrer Schleife ändern möchten, übergeben Sie Ihrem nativen C++-Code Folgendes:
Kotlin
```
val launchIntent = intent
val scenario = launchIntent.getIntExtra("scenario", 0)MainActivity.kt
```
Java
```
Intent launchIntent = getIntent();
int scenario = launchIntent.getIntExtra("scenario", 0);MainActivity.java
```
Sie können das Verhalten Ihrer Schleife jetzt basierend auf dem resultierenden int-Wert ändern.

Spielschleifen labeln

Wenn Sie Ihre Spielschleifen mit einem oder mehreren Szenariolabels versehen, können Sie und Ihr Qualitätssicherungsteam ganz einfach eine Reihe zugehöriger Spielschleifen (z.B. „alle Kompatibilitäts-Spielschleifen“) starten und sie in einer einzigen Matrix testen. Sie können eigene Labels erstellen oder die vordefinierten Labels von Test Lab verwenden:

com.google.test.loops.player_experience: Für Schleifen, die verwendet werden, um die Erfahrung eines echten Nutzers beim Spielen des Spiels zu reproduzieren. Ziel des Tests mit diesen Schleifen ist es, Probleme zu finden, die ein echter Nutzer beim Spielen des Spiels haben könnte.
com.google.test.loops.gpu_compatibility: Für Schleifen, die verwendet werden, um GPU-bezogene Probleme zu testen. Ziel des Tests mit diesen Schleifen ist es, GPU-Code auszuführen, der in der Produktion möglicherweise nicht ordnungsgemäß ausgeführt wird, um Probleme mit Hardware und Treibern aufzudecken.
com.google.test.loops.compatibility: Für Schleifen, die verwendet werden, um eine breite Palette von Kompatibilitätsproblemen zu testen, einschließlich I/O- und OpenSSL-Problemen.
com.google.test.loops.performance: Für Schleifen, die verwendet werden, um die Leistung des Geräts zu testen. Beispielsweise kann ein Spiel mit den komplexesten Grafikeinstellungen ausgeführt werden, um zu sehen, wie sich ein neues Gerät verhält.

So aktivieren Sie die Ausführung von Schleifen mit demselben Label in Ihrer App:

Wenn Sie einen Test mit dem Test Loop Manager ausführen:
1. Fügen Sie dem Manifest Ihrer App die folgende Metadatenzeile hinzu und ersetzen Sie LABEL_NAME durch ein Label Ihrer Wahl:
```
<meta-data
 android:name="com.google.test.loops.LABEL_NAME"
 android:value="1,3-5" />
```
  Im Feld android:value können Sie einen Bereich oder eine Reihe von Ganzzahlen von 1 bis 1024 angeben. Das ist die maximale Anzahl von Schleifen, die für einen einzelnen Test zulässig sind. Diese Ganzzahlen stellen die Schleifen dar, die Sie labeln möchten. Schleifen werden ab 1 und nicht ab 0 indexiert. Beispiel: android:value="1,3-5" wendet LABEL_NAME auf die Schleifen 1, 3, 4 und 5 an.
2. Geben Sie in der App „Test Loop Manager“ im Feld Labels ein oder mehrere Labels ein.
Wenn Sie einen Test mit der Firebase Console ausführen, geben Sie im Feld Labels ein oder mehrere Labels ein.
Wenn Sie einen Test mit der gcloud CLI ausführen, geben Sie mit dem --scenario-labels Flag ein oder mehrere Szenariolabels an (z.B. --scenario-labels=performance,gpu).

Unterstützung für die App-Lizenzierung

Test Lab unterstützt Apps, die den von Google Play angebotenen App-Lizenzierungsservice verwenden. Wenn Sie die Lizenzierung beim Testen Ihrer App mit Test Lab prüfen möchten, müssen Sie Ihre App im Play Store im Produktionskanal veröffentlichen. Wenn Sie Ihre App im Alpha- oder Betakanal mit Test Lab testen möchten, entfernen Sie die Lizenzierungsprüfung, bevor Sie Ihre App in Test Lab hochladen.

Bekannte Probleme

Bei Spielschleifentests in Test Lab sind die folgenden Probleme bekannt:

Einige Abstürze unterstützen keine Backtraces. Bei einigen Release-Builds kann beispielsweise die Ausgabe des debuggerd-Prozesses mit prctl(PR_SET_DUMPABLE, 0) unterdrückt werden. Weitere Informationen finden Sie unter debuggerd.
API-Level 19 wird derzeit aufgrund von Fehlern bei den Dateiberechtigungen nicht unterstützt.

Erste Schritte mit Spielschleifentests Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweis

Kotlin

Java

Kotlin

Java

Spielschleifentest erstellen und ausführen

Auf einem lokalen Gerät ausführen

In Test Lab ausführen

Firebase Console verwenden

gcloud-Befehlszeile (CLI) verwenden

Optionale Funktionen

Ausgabedaten schreiben

Kotlin

Java

Kotlin

Java

C++

Beispiel für eine Ausgabedatei

Mehrere Spielschleifen

Kotlin

Java

Spielschleifen labeln

Unterstützung für die App-Lizenzierung

Bekannte Probleme

Erste Schritte mit Spielschleifentests