Mit der Google Cloud CLI testen

In dieser Anleitung wird beschrieben, wie Sie mit der gcloud CLI einen XCTest oder einen Spielschleifentest ausführen.

Schritt 1: Lokale Google Cloud SDK-Umgebung konfigurieren

1. Google Cloud SDK herunterladen

Dazu gehört auch das gcloud CLI-Tool.

2. Prüfen Sie, ob Ihre Installation auf dem neuesten Stand ist und den gcloud firebase Befehl enthält:

         gcloud components update

3. Melden Sie sich mit Ihrem Google-Konto in der gcloud CLI an:

         gcloud auth login

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

        gcloud config set project PROJECT_ID

Schritt 2: Test ausführen

XCTest ausführen

1. Laden Sie die ZIP-Datei Ihres Tests mit dem folgenden Befehl hoch. Wenn Sie Ihre App noch nicht verpackt haben, lesen Sie den Abschnitt XCTest verpacken.

   cd FOLDER_WITH_TEST_OUTPUT/Build/Products ; \
   zip -r MyTests.zip Debug-iphoneos YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun

2. Wählen Sie die Testdimensionen aus.

   Test Lab können Sie Tests mit verschiedenen iOS-Versionen, Geräten, Bildschirm ausrichtungen und Gebietsschemas ausführen. Diese Konfigurationen werden als Testdimensionen des Tests bezeichnet. Wenn Sie die Optionen für jede Dimension sehen möchten (z.B. unterstützte Xcode-Versionen für die iOS-Version des Geräts), ersetzen Sie models, versions oder locales durch dimension im folgenden Befehl:

   gcloud firebase test ios dimension list

   Die Bildschirmausrichtung ist etwas einfacher, da die einzigen Optionen portrait und landscape sind.

   Sehen Sie sich die Liste der Testdimensionen an und wählen Sie einige Kombinationen aus, mit denen Sie Ihren Test ausführen möchten. Unter Preispläne finden Sie die maximale Anzahl von Kombinationen, die Sie pro Tag ausführen können.

3. Nachdem Sie eine Reihe von Testdimensionen ausgewählt haben, können Sie Test Lab Ihre Tests mit dem firebase test ios run Befehl ausführen. Fügen Sie für jede Kombination von Testdimensionen, die Sie testen möchten, ein separates --device-Flag ein:

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --device model=MODEL_ID_2,version=VERSION_ID_2,locale=LOCALE_2,orientation=ORIENTATION_2 \
    etc...

   Es ist möglich, dass Ihr Test aufgrund einer Inkompatibilität zwischen der Xcode-Version, mit der der Test erstellt wurde, und der von Test Lab verwendeten Standard-Xcode-Version fehlschlägt. Verwenden Sie das Flag --xcode-version, um eine unterstützte Xcode-Version für Ihren Test anzugeben:

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --xcode-version=15

   Damit Sie Ihre Testmatrizen in der Firebase Console leichter identifizieren und finden können, können Sie Ihre Testmatrix optional mit dem --client-details matrixLabel="<label>" Flag im folgenden Beispiel kennzeichnen:

   gcloud beta firebase test ios run --test PATH/TO/MyTests.zip \
     --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
     --client-details matrixLabel="my label"

Spielschleifentest ausführen

Führen Sie den Befehl gcloud beta firebase test ios run aus und verwenden Sie die folgenden Flags, um die Ausführung zu konfigurieren:

Mit dem folgenden Befehl wird beispielsweise ein Spielschleifentest ausgeführt, bei dem die Schleifen 1, 4, 6, 7 und 8 auf einem iPhone 8 Plus ausgeführt werden:

gcloud beta firebase test ios run
 --type game-loop --app path/to/my/App.ipa --scenario-numbers 1,4,6-8
 --device-model=iphone8plus

Weitere Informationen zur gcloud CLI finden Sie in der Referenzdokumentation.

Schritt 3 (optional): Zukünftige Tests automatisieren

gcloud-Befehle mit Test Lab in Skripts verwenden

Sie können Shell-Skripts oder Batchdateien verwenden, um Befehle zum Testen von mobilen Apps zu automatisieren, die Sie andernfalls über die gcloud-Befehlszeile ausführen würden. Dieses Bash-Beispielskript führt einen XCTest mit einem Zeitlimit von zwei Minuten aus und meldet, ob die Testausführung erfolgreich abgeschlossen wurde:

if gcloud firebase test ios run --test MyTest.zip --timeout 2m
then
    echo "Test matrix successfully finished"
else
    echo "Test matrix exited abnormally with non-zero exit code: " $?
fi

Exit-Codes für Skripts

Test Lab bietet mehrere Exit-Codes, mit denen Sie die Ergebnisse von Tests, die Sie mit Skripts oder Batchdateien ausführen, besser nachvollziehen können.

Schritt 4: Testergebnisse untersuchen

Wenn der Test gestartet wird, erhalten Sie einen Link zur Seite Testergebnisse. Je nach Anzahl der ausgewählten Konfigurationen und der für Ihre Tests festgelegten Zeitüberschreitungsdauer kann es einige Minuten dauern, bis die Tests abgeschlossen sind. Nachdem die Tests ausgeführt wurden, können Sie die Testergebnisse überprüfen. Weitere Informationen zum Interpretieren von Testergebnissen finden Sie unter Analyzing Firebase Test Lab Results.

Nächster Schritt

In der Google Cloud SDK-Dokumentation finden Sie weitere Informationen zu Testoptionen, die allgemein verfügbar oder in der Beta-Phase sind.