Google 致力于为黑人社区推动种族平等。查看具体举措
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Beginnen Sie mit Game Loop-Tests

Es kann schwierig sein, Spieletests zu automatisieren, wenn Spiele-Apps auf verschiedenen UI-Frameworks basieren. Mit Game Loop-Tests können Sie Ihre nativen Tests in Test Lab integrieren und sie problemlos auf ausgewählten Geräten ausführen. Ein Game Loop-Test führt Ihren Test über Ihre Gaming-App aus und simuliert gleichzeitig die Aktionen eines echten Spielers. Diese Anleitung zeigt Ihnen, wie Sie einen Game Loop-Test ausführen und dann Ihre Testergebnisse in der Firebase-Konsole anzeigen und verwalten.

Abhängig von Ihrer Spiel-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. Spieleschleifen können verwendet werden, um:

  • Führen Sie ein Level Ihres Spiels so aus, wie es ein Endbenutzer spielen würde. Sie können entweder die Eingabe des Benutzers per Skript ausführen, den Benutzer untätig lassen oder den Benutzer durch eine KI ersetzen, wenn dies in Ihrem Spiel sinnvoll ist (z. B. wenn Sie eine Rennwagen-Gaming-App haben und bereits eine KI implementiert haben. Sie können leicht einen KI-Treiber für die Eingabe des Benutzers verantwortlich machen).
  • Führen Sie Ihr Spiel mit der höchsten Qualitätseinstellung aus, um festzustellen, ob Geräte es unterstützen.
  • Führen Sie einen technischen Test durch (kompilieren Sie mehrere Shader, führen Sie sie aus, überprüfen Sie, ob die Ausgabe wie erwartet ist usw.).

Sie können einen Game-Loop-Test auf einem einzelnen Testgerät, einer Reihe von Testgeräten oder im Testlabor ausführen. Es wird jedoch nicht empfohlen, Game Loop-Tests auf virtuellen Geräten durchzuführen, da diese niedrigere Grafik-Frameraten aufweisen als physische Geräte.

Bevor Sie beginnen

Um einen Test zu implementieren, müssen Sie zuerst Ihre App für Game Loop-Tests konfigurieren.

  1. Fügen Sie in Ihrem App-Manifest Ihrer Aktivität einen neuen Absichtsfilter 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>
    

    Auf diese Weise kann Test Lab Ihr Spiel starten, indem es mit einer bestimmten Absicht ausgelöst wird.

  2. onCreate in Ihrem Code (in der onCreate Methodendeklaration wird empfohlen) Folgendes hinzu:

    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
    }

    Kotlin + KTX

    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
    }

    Auf diese Weise kann Ihre Aktivität die Absicht überprüfen, mit der sie gestartet wird. Sie können diesen Code auch später hinzufügen, wenn Sie dies bevorzugen (z. B. nach dem ersten Laden Ihrer Spiel-Engine).

  3. Empfohlen: Fügen Sie am Ende des Tests Folgendes hinzu:

    Java

    yourActivity.finish();

    Kotlin + KTX

    yourActivity.finish()

    Dies schließt Ihre App, wenn der Game Loop-Test 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 angezeigt, dass der Test abgeschlossen ist.

Erstellen Sie einen Game Loop-Test und führen Sie ihn aus

Nachdem Sie Ihre App für Game Loop-Tests 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-Konsole oder die gcloud-Befehlszeilenschnittstelle (CLI) oder auf einem lokalen Gerät mit dem Test Loop Manager ausführen .

Auf einem lokalen Gerät ausführen

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

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

  1. Laden Sie den Test Loop Manager auf ein Telefon oder Tablet herunter und installieren Sie ihn, indem Sie Folgendes ausführen:
    adb install testloopmanager.apk
  2. Öffnen Sie auf Ihrem Gerät die Test Loop Apps- App auf Ihrem Telefon oder Tablet. Die App zeigt eine Liste der Apps auf Ihrem Gerät an, die mit Spieleschleifen ausgeführt werden können. Wenn Sie Ihre Gaming-App hier nicht sehen, stellen Sie sicher, dass Ihr Absichtsfilter mit dem im ersten Schritt des Abschnitts Bevor Sie beginnen beschriebenen Filter übereinstimmt.
  3. Wählen Sie Ihre Gaming-App aus und wählen Sie dann die Anzahl der Loops aus, die Sie ausführen möchten. Hinweis: In diesem Schritt können Sie eine Teilmenge von Schleifen anstelle nur einer Schleife ausführen. Weitere Informationen zum gleichzeitigen Ausführen mehrerer Schleifen finden Sie unter Optionale Funktionen.
  4. Klicken Sie auf Test ausführen. Ihr Test wird sofort ausgeführt.

Im Testlabor ausführen

Sie können einen Game Loop-Test in Test Lab entweder über die Firebase-Konsole oder die gcloud-CLI ausführen. Bevor Sie beginnen, öffnen Sie die Firebase-Konsole und erstellen Sie ein Projekt, falls Sie dies noch nicht getan haben .

Verwenden Sie die Firebase-Konsole

  1. Klicken Sie in der Firebase-Konsole im linken Bereich auf Test Lab .
  2. Klicken Sie auf Ihren ersten Test ausführen (oder auf Test ausführen, wenn Ihr Projekt zuvor einen Test ausgeführt hat).
  3. Wählen Sie als Testtyp Game Loop aus und klicken Sie dann auf Weiter .
  4. Klicken Sie auf Durchsuchen und .apk Sie dann zur .apk Datei Ihrer App. Hinweis: In diesem Schritt können Sie eine Teilmenge von Schleifen anstelle nur einer Schleife ausführen. Weitere Informationen zum gleichzeitigen Ausführen mehrerer Schleifen finden Sie unter Optionale Funktionen.
  5. Klicken Sie auf Weiter .
  6. Wählen Sie die physischen Geräte aus, die zum Testen Ihrer App verwendet werden sollen.
  7. Klicken Sie auf Tests starten .

Weitere Informationen zu den ersten Schritten mit der Firebase-Konsole finden Sie unter Starten des Testens mit der Firebase-Konsole.

Verwenden Sie die gcloud-Befehlszeile (CLI).

  1. Wenn Sie dies noch nicht getan haben, laden Sie das Google Cloud SDK herunter und installieren Sie es .

  2. Melden Sie sich mit Ihrem Google-Konto bei der gcloud-CLI an:

    gcloud auth login

  3. Legen Sie Ihr Firebase-Projekt in gcloud fest, wobei PROJECT_ID die ID Ihres Firebase-Projekts ist:

    gcloud config set project PROJECT_ID
    
  4. Führen Sie Ihren ersten Test durch:

    gcloud firebase test android run \
     --type=game-loop --app=<var>path-to-apk</var> \
     --device model=herolte,version=23
    

Weitere Informationen zum Einstieg in die gcloud-CLI finden Sie unter Starten des Tests über die gcloud-Befehlszeile.

Optionale Funktionen

Test Lab bietet mehrere optionale Funktionen, mit denen Sie Ihre Tests weiter anpassen können, darunter die Möglichkeit, Ausgabedaten zu schreiben, die Unterstützung mehrerer Spieleschleifen und Beschriftungen für verwandte Schleifen.

Schreibe Ausgabedaten

Ihr Game Loop-Test kann Ausgaben in eine Datei schreiben, die in der Methode launchIntent.getData() ist. Nachdem Sie einen Test ausgeführt haben, können Sie im Abschnitt Test Lab der Firebase-Konsole auf diese Ausgabedaten zugreifen (siehe Beispiel für eine Game Loop-Testausgabedatei ).

Test Lab befolgt bewährte Methoden zum Freigeben einer Datei zwischen Apps, die unter Freigeben einer Datei beschrieben werden . In der onCreate() -Methode Ihrer Aktivität, in der sich Ihre Absicht befindet, können Sie Ihre Datenausgabedatei überprüfen, indem Sie den folgenden Code ausführen:

Java

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

Kotlin + KTX

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

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

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);

Kotlin + KTX

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);

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 Ausgabedatendateien (wie im folgenden Beispiel formatiert) verwenden, um Testergebnisse für Spieleschleifen im Abschnitt Test Lab der Firebase-Konsole anzuzeigen. Bereiche, die als /.../ können alle benutzerdefinierten Felder enthalten, die Sie benötigen, sofern sie nicht mit den Namen anderer in dieser Datei verwendeter Felder 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

Möglicherweise ist es hilfreich, mehrere Spieleschleifen in Ihrer App auszuführen. Eine Schleife ist ein vollständiger Durchlauf Ihrer Spiel-App von Anfang bis Ende. Wenn Sie beispielsweise mehrere Level in Ihrem Spiel haben, möchten Sie möglicherweise eine Spielschleife, um jedes Level zu starten, anstatt eine Schleife, die alle durchläuft. Auf diese Weise können Sie, wenn Ihre App auf Stufe 32 abstürzt, diese Spieleschleife direkt starten, um den Absturz zu reproduzieren und Fehlerbehebungen zu testen.

So aktivieren Sie, dass Ihre App mehrere Schleifen gleichzeitig ausführen kann:

  • 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" />
      

      Diese Startabsicht enthält die Zielschleife als ganzzahligen Parameter. Im Feld android:value können Sie eine Ganzzahl von 1 bis 1024 angeben (die maximale Anzahl von Schleifen, die für einen einzelnen Test zulässig sind). Beachten Sie, dass Schleifen ab 1 indiziert werden, nicht ab 0.

    2. In der Test Loop Manager-App wird ein Auswahlbildschirm angezeigt, in dem Sie auswählen können, welche Schleife (n) Sie ausführen möchten. Wenn Sie mehrere Schleifen auswählen, wird jede Schleife nach Abschluss der vorhergehenden Schleife nacheinander gestartet.

  • Wenn Sie einen Test mit der Firebase-Konsole ausführen, geben Sie eine Liste oder einen Bereich von Schleifennummern in das Feld Szenarien ein.

  • Wenn Sie einen Test mit der gcloud-CLI ausführen, geben Sie mithilfe des --scenario-numbers eine Liste der 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 das folgende Extra an Ihren nativen C ++ - Code:

    Java

    Intent launchIntent = getIntent();
    int scenario = launchIntent.getIntExtra("scenario", 0);

    Kotlin + KTX

    val launchIntent = intent
    val scenario = launchIntent.getIntExtra("scenario", 0)

    Sie können jetzt das Verhalten Ihrer Schleife basierend auf dem resultierenden int Wert ändern.

Beschriften Sie Spieleschleifen

Wenn Sie Ihre Spieleschleifen mit einem oder mehreren Szenario-Beschriftungen kennzeichnen, können Sie und Ihr QA-Team problemlos eine Reihe verwandter Spielschleifen (z. B. "alle kompatiblen Spielschleifen") starten und in einer einzigen Matrix testen. Sie können Ihre eigenen Etiketten erstellen oder die von Test Lab angebotenen vordefinierten Etiketten verwenden:

  • com.google.test.loops.player_experience : Für Schleifen, die verwendet werden, um die Erfahrung eines echten Benutzers beim Spielen des Spiels zu reproduzieren. Das Ziel des Testens mit diesen Schleifen besteht darin, Probleme zu finden, mit denen ein echter Benutzer beim Spielen des Spiels konfrontiert wird.
  • com.google.test.loops.gpu_compatibility : Für Schleifen, die zum Testen von GPU-bezogenen Problemen verwendet werden. Das Ziel des Testens mit diesen Schleifen besteht darin, GPU-Code auszuführen, der möglicherweise nicht ordnungsgemäß in der Produktion ausgeführt wird, um Probleme mit Hardware und Treibern aufzudecken.
  • com.google.test.loops.compatibility : Für Schleifen, die zum Testen einer Vielzahl von Kompatibilitätsproblemen verwendet werden, einschließlich E / A-Problemen und OpenSSL-Problemen.
  • com.google.test.loops.performance : Für Schleifen, mit denen die Leistung des Geräts getestet wird. 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 Ihre App zum Ausführen von Schleifen mit derselben Bezeichnung:

  • Wenn Sie einen Test mit dem Test Loop Manager ausführen:

    1. LABEL_NAME Sie im Manifest Ihrer App die folgende Metadatenzeile hinzu und ersetzen Sie LABEL_NAME durch eine Bezeichnung 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 (die maximale Anzahl von Schleifen, die für einen einzelnen Test zulässig sind) angeben, die die Schleifen darstellen, die Sie beschriften möchten. Beachten Sie, dass Schleifen ab 1 und nicht 0 indiziert werden. Beispiel: android:value="1,3-5" wendet LABEL_NAME auf die Schleifen 1, 3, 4 und 5 an.

    2. Geben Sie in der Test Loop Manager-App eine oder mehrere Beschriftungen in das Feld Beschriftungen ein.

  • Wenn Sie einen Test mit der Firebase-Konsole ausführen, geben Sie eine oder mehrere Beschriftungen in das Feld Beschriftungen ein.

  • Wenn Sie einen Test mit der gcloud-CLI ausführen, geben Sie eine oder mehrere Szenariobezeichnungen mit dem --scenario-labels (z. B. --scenario-labels=performance,gpu ).

App-Lizenzierungsunterstützung

Test Lab unterstützt Apps, die den von Google Play angebotenen App-Lizenzierungsdienst verwenden . Um die Lizenzierung beim Testen Ihrer App mit Test Lab erfolgreich zu überprüfen, müssen Sie Ihre App im Produktionskanal im Play Store veröffentlichen. Um Ihre App im Alpha- oder Betakanal mit Test Lab zu testen, entfernen Sie die Lizenzprüfung, bevor Sie Ihre App in Test Lab hochladen.

Bekannte Probleme

Game Loop-Tests im Test Lab weisen die folgenden bekannten Probleme auf:

  • Einige Abstürze unterstützen keine Rückverfolgungen. Zum Beispiel baut einige Freisetzung kann die Ausgabe des unterdrücken debuggerd Verfahren unter Verwendung prctl(PR_SET_DUMPABLE, 0) . Weitere debuggerd Sie unter debuggerd .
  • API Level 19 wird derzeit aufgrund von Dateiberechtigungsfehlern nicht unterstützt.