Testowanie za pomocą Google Cloud CLI

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

Krok 1: skonfiguruj lokalne środowisko pakietu SDK Google Cloud

1. Pobierz pakiet SDK Google Cloud.

Obejmuje on 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 w Firebase w gcloud, gdzie PROJECT_ID to identyfikator Twojego projektu w 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, przeczytaj artykuł 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 w różnych wersjach iOS, na różnych urządzeniach, w różnych orientacjach ekranu i w różnych ustawieniach regionalnych. Te konfiguracje są nazywane wymiarami testu. Aby zobaczyć opcje każdego wymiaru (np. obsługiwane wersje Xcode dla wersji iOS urządzenia), zastąp models, versions lub locales w tym poleceniu słowem 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. Aby sprawdzić maksymalną liczbę kombinacji, które możesz uruchomić dziennie, otwórz stronę Plany cenowe.

3. Po wybraniu zestawu wymiarów testu możesz uruchomić Test Lab testy za pomocą polecenia firebase test ios run. Dla każdej kombinacji wymiarów testu, którą chcesz przetestować, dodaj osobny parametr --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 z a domyślną wersją Xcode używaną przez Test Lab. Aby określić obsługiwaną wersję Xcode dla testu, użyj parametru --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 znajdowanie zestawów testów w Firebase konsoli, możesz opcjonalnie oznaczyć zestaw testów za pomocą --client-details matrixLabel="<label>" flagi 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 użyj tych parametrów, aby skonfigurować uruchomienie:

Na przykład to polecenie uruchamia 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 gcloud CLI znajdziesz w dokumentacji.

Krok 3 (opcjonalny): zautomatyzuj przyszłe testy

Skryptowanie 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 przeciwnym razie uruchamiałbyś za pomocą wiersza poleceń gcloud. Ten przykładowy skrypt powłoki bash uruchamia XCTest z 2-minutowym limitem czasu 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 wyjścia, 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 potrwać kilka minut w zależności od liczby wybranych konfiguracji i czasu oczekiwania na test. Po zakończeniu testów możesz sprawdzić ich wyniki. Więcej informacji o interpretowaniu wyników testów znajdziesz w artykule Analyzing Firebase Test Lab Results.

Następny krok

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