Tester avec la Google Cloud CLI

Ce guide explique comment exécuter un test XCTest ou un test de boucle de jeu à l'aide de gcloud CLI.

Étape 1 : Configurez votre environnement Google Cloud SDK local

1. Téléchargez le SDK Google Cloud.

Cela inclut l'outil gcloud CLI.

2. Assurez-vous que votre installation est à jour et qu'elle inclut la commande gcloud firebase :

         gcloud components update

3. Connectez-vous à la gcloud CLI à l'aide de votre compte Google :

         gcloud auth login

4. Définissez votre projet Firebase dans gcloud, où PROJECT_ID est l'ID de votre projet Firebase :

        gcloud config set project PROJECT_ID

Étape 2 : Exécutez votre test

Exécuter un test XCTest

1. Importez le fichier .zip de votre test en exécutant la commande suivante (si vous n'avez pas encore empaqueté votre application, consultez Empaqueter votre XCTest) :

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

2. Choisissez les dimensions de votre test.

   Test Lab vous permet d'exécuter des tests sur différentes versions d'iOS, appareils, orientations d'écran et paramètres régionaux. Ces configurations sont appelées dimensions de test. Pour afficher les options de chaque dimension (par exemple, les versions Xcode compatibles avec la version iOS de l'appareil), remplacez dimension par models, versions ou locales dans la commande suivante :

   gcloud firebase test ios dimension list

   L'orientation de l'écran est un peu plus simple, car ses seules options sont portrait et landscape.

   Parcourez la liste des dimensions de test et sélectionnez quelques combinaisons sur lesquelles vous souhaitez exécuter votre test. Consultez la page Plans tarifaires pour connaître le nombre maximal de combinaisons que vous pouvez exécuter par jour.

3. Une fois que vous avez choisi un ensemble de dimensions de test, vous pouvez demander à Test Lab d'exécuter vos tests à l'aide de la commande firebase test ios run. Pour chaque combinaison de dimensions de test que vous souhaitez tester, incluez un flag --device distinct :

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

   Il est possible que votre test échoue en raison d'une incompatibilité entre la version Xcode avec laquelle le test a été créé et la version Xcode par défaut utilisée par Test Lab. Pour spécifier une version d'Xcode compatible pour votre test, utilisez l'option --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

   Pour vous aider à identifier et à localiser vos matrices de test dans la console Firebase, vous pouvez éventuellement ajouter un libellé à votre matrice de test à l'aide de l'option --client-details matrixLabel="<label>" dans l'exemple suivant :

   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"

Exécuter un test de boucle de jeu

Exécutez la commande gcloud beta firebase test ios run et utilisez les options suivantes pour configurer l'exécution :

Par exemple, la commande suivante exécute un test de boucle de jeu qui exécute les boucles 1, 4, 6, 7 et 8 sur 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

Pour en savoir plus sur la gcloud CLI, consultez la documentation de référence.

Étape 3 (facultative) : Automatisez les futurs tests que vous créez

Créer des scripts pour les commandes gcloud avec Test Lab

Vous pouvez utiliser des scripts shell ou des fichiers de commandes pour automatiser les commandes de test d'applications mobiles que vous exécuteriez autrement à l'aide de la ligne de commande gcloud. Cet exemple de script bash exécute un test XCTest avec un délai avant expiration de deux minutes et indique si l'exécution du test a réussi :

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

Codes de sortie du script

Test Lab fournit plusieurs codes de sortie que vous pouvez utiliser pour mieux comprendre les résultats des tests que vous exécutez à l'aide de scripts ou de fichiers de commandes.

Étape 4 : Examinez les résultats du test

Lorsque le test commence, vous recevez un lien vers la page Résultats du test. L'exécution des tests peut prendre plusieurs minutes, en fonction du nombre de configurations différentes que vous avez sélectionnées et de la durée avant expiration définie pour vos tests. Une fois les tests exécutés, vous pouvez en examiner les résultats. Consultez Analyser les résultats de Firebase Test Lab pour en savoir plus sur l'interprétation des résultats de vos tests.

Étape suivante

Consultez la documentation du Google Cloud SDK pour découvrir les options de test en disponibilité générale ou en bêta.