Esegui test con Google Cloud CLI

Questa guida descrive come eseguire un test XCTest o Game Loop utilizzando la CLI gcloud.

Passaggio 1: configura l'ambiente Google Cloud SDK locale

1. Scarica Google Cloud SDK

Ciò include lo strumento gcloud CLI.

2. Assicurati che l'installazione sia aggiornata e includa il comando gcloud firebase:

         gcloud components update

3. Accedi a gcloud CLI utilizzando il tuo Account Google:

         gcloud auth login

4. Imposta il progetto Firebase in gcloud, dove PROJECT_ID è l'ID del tuo progetto Firebase:

        gcloud config set project PROJECT_ID

Passaggio 2: esegui il test

Esegui un XCTest

1. Carica il file .zip del test eseguendo il seguente comando (se non hai ancora pacchettizzato l'app, consulta la sezione Pacchettizzare XCTest):

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

2. Scegli le dimensioni del test.

   Test Lab ti consente di eseguire test su una varietà di versioni di iOS, dispositivi, orientamenti dello schermo e impostazioni internazionali. Queste configurazioni sono note come dimensioni del test. Per visualizzare le opzioni per ogni dimensione (ad es. le versioni di Xcode supportate per la versione di iOS del dispositivo), sostituisci models, versions o locales con dimension nel seguente comando:

   gcloud firebase test ios dimension list

   L'orientamento dello schermo è un po' più semplice, in quanto le uniche opzioni sono portrait e landscape.

   Esamina l'elenco delle dimensioni di test e seleziona alcune combinazioni su cui vuoi eseguire il test. Visita la pagina Piani tariffari per visualizzare il numero massimo di combinazioni che puoi eseguire al giorno.

3. Una volta scelto un insieme di dimensioni di test, puoi chiedere a Test Lab di eseguire i test utilizzando il comando firebase test ios run. Per ogni combinazione di dimensioni di test che vuoi testare, includi un flag --device separato:

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

   È possibile che il test non riesca a causa di un'incompatibilità tra la versione di Xcode con cui è stato creato il test e la versione predefinita di Xcode utilizzata da Test Lab. Per specificare una versione di Xcode supportata per il test, utilizza il flag --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

   Per aiutarti a identificare e individuare le matrici di test nella console Firebase, puoi etichettare facoltativamente la matrice di test utilizzando il flag --client-details matrixLabel="<label>" nell'esempio seguente:

   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"

Eseguire un test Ciclo di gioco

Esegui il comando gcloud beta firebase test ios run e utilizza i seguenti flag per configurare l'esecuzione:

Ad esempio, il seguente comando esegue un test del ciclo di gioco che esegue i cicli 1, 4, 6, 7 e 8 su un iPhone 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

Per saperne di più su gcloud CLI, consulta la documentazione di riferimento.

(Facoltativo) Passaggio 3: automatizza i test futuri che crei

Creazione di script dei comandi gcloud con Test Lab

Puoi utilizzare script shell o file batch per automatizzare i comandi di test delle app mobile che altrimenti eseguirai utilizzando la riga di comando gcloud. Questo script bash di esempio esegue un XCTest con un timeout di due minuti e segnala se l'esecuzione del test è stata completata correttamente:

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

Codici di uscita dello script

Test Lab fornisce diversi codici di uscita che puoi utilizzare per comprendere meglio i risultati dei test eseguiti utilizzando script o file batch.

Passaggio 4: analizza i risultati del test

All'inizio del test, riceverai un link alla pagina Risultati test. L'esecuzione dei test può richiedere diversi minuti, a seconda del numero di configurazioni diverse selezionate e della durata del timeout del test impostata per i test. Una volta eseguiti i test, puoi esaminare i risultati. Consulta Analizzare i risultati di Firebase Test Lab per scoprire di più su come interpretare i risultati del test.

Passaggio successivo

Leggi la documentazione di Google Cloud SDK per esplorare le opzioni di test disponibili a livello generale o in versione beta.