Testowanie za pomocą Google Cloud CLI

Z tego przewodnika dowiesz się, jak uruchomić test XCTest lub test pętli gry za pomocą gcloud CLI.

Krok 1. Skonfiguruj lokalne środowisko pakietu SDK Google Cloud

1. Pobierz Google Cloud SDK.

Obejmuje to narzędzie gcloud CLI.

2. Upewnij się, że instalacja jest aktualna i zawiera polecenie gcloud firebase:

         gcloud components update

3. Zaloguj się w gcloud CLI za pomocą konta Google:

         gcloud auth login

4. Ustaw projekt Firebase w gcloud, gdzie PROJECT_ID to identyfikator projektu Firebase:

        gcloud config set project PROJECT_ID

Krok 2. Przeprowadź test

Przeprowadź XCTest

1. Prześlij plik ZIP z testem, uruchamiając to polecenie (jeśli nie masz jeszcze spakowanej aplikacji, zapoznaj się z sekcją Pakowanie XCTest):

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

2. Wybierz wymiary testu.

   Test Lab umożliwia przeprowadzanie testów na różnych wersjach iOS, urządzeniach, orientacjach ekranu i językach. Te konfiguracje są nazywane wymiarami testu. Aby wyświetlić opcje każdego wymiaru (np. obsługiwane wersje Xcode dla wersji iOS urządzenia), w tym poleceniu zastąp models, versions lub locales znakiem dimension:

   gcloud firebase test ios dimension list

   Orientacja ekranu jest nieco prostsza, ponieważ ma tylko 2 opcje: portrait i landscape.

   Przejrzyj listę wymiarów testu i wybierz kilka kombinacji, w których chcesz przeprowadzić test. Na stronie Plany cenowe znajdziesz informacje o maksymalnej liczbie kombinacji, które możesz uruchamiać dziennie.

3. Po wybraniu zestawu wymiarów testu możesz uruchomić testy za pomocą polecenia firebase test ios run.Test Lab W przypadku każdej kombinacji wymiarów testu, którą chcesz przetestować, dodaj osobne oznaczenie --device:

   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...

   Test może się nie powieść z powodu niezgodności między wersją Xcode, w której został utworzony, a domyślną wersją Xcode używaną przez Test Lab. Aby określić obsługiwaną wersję Xcode na potrzeby testu, użyj flagi --xcode-version:

   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

   Aby ułatwić identyfikowanie i lokalizowanie macierzy testów w Firebasekonsoli, możesz opcjonalnie oznaczyć macierz testów za pomocą flagi --client-details matrixLabel="<label>" w tym przykładzie:

   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"

Przeprowadź test pętli gry

Uruchom polecenie gcloud beta firebase test ios run i skonfiguruj uruchomienie za pomocą tych flag:

Na przykład to polecenie przeprowadza test pętli gry, który wykonuje pętle 1, 4, 6, 7 i 8 na iPhonie 8 Plus:

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

Więcej informacji o interfejsie wiersza poleceń gcloud znajdziesz w dokumentacji.

Krok 3. (Opcjonalnie): zautomatyzuj przyszłe testy

Tworzenie skryptów poleceń gcloud za pomocą Test Lab

Możesz używać skryptów powłoki lub plików wsadowych do automatyzowania poleceń testowania aplikacji mobilnych, które w inny sposób uruchamiasz za pomocą wiersza poleceń gcloud. Ten przykładowy skrypt bash uruchamia test XCTest z 2-minutowym czasem oczekiwania i informuje, czy test zakończył się pomyślnie:

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

Kody wyjścia skryptu

Test Lab udostępnia kilka kodów zakończenia, które pomagają lepiej zrozumieć wyniki testów przeprowadzanych za pomocą skryptów lub plików wsadowych.

Krok 4. Sprawdź wyniki testu

Po rozpoczęciu testu otrzymasz link do strony Wyniki testu. Przeprowadzenie testów może zająć kilka minut w zależności od liczby wybranych konfiguracji i czasu oczekiwania na wynik testu. Po przeprowadzeniu testów możesz sprawdzić ich wyniki. Więcej informacji o interpretowaniu wyników testu znajdziesz w sekcji Analizowanie wynikówFirebase Test Lab.

Kolejny etap

Zapoznaj się z dokumentacją pakietu SDK Google Cloud, aby poznać opcje testowania, które są ogólnodostępne lub w wersji beta.