Exécuter un XCTest

Ce guide décrit comment préparer un XCTest pour les tests dans Firebase Test Lab.

Étape 1 : Configurez l'emplacement des données dérivées de votre projet

Xcode place les artefacts iOS compilés, y compris tous les tests que vous créez, dans un répertoire de données dérivées. Il est possible de conserver l'emplacement par défaut pour ce répertoire, si vous le souhaitez, mais il est souvent utile de choisir un emplacement plus facilement accessible pour les fichiers, surtout si vous allez souvent exécuter des tests avec Test Lab :

1. Ouvrez votre projet dans Xcode.
2. Dans la barre de menus macOS, sélectionnez Fichier > Paramètres du projet...
3. Modifiez la liste déroulante Données dérivées de Emplacement par défaut à Emplacement personnalisé .
4. Dans le champ sous la liste déroulante, sélectionnez un emplacement pour Xcode vers lequel sortir vos tests.

Etape 2 : Construire un fichier de test générique

Test Lab exécute des tests unitaires et des tests d'interface utilisateur à l'aide du framework XCTest . Pour exécuter les XCTests de votre application sur des appareils Test Lab, créez-la pour la tester sur un appareil iOS générique :

1. Dans la liste déroulante des appareils en haut de la fenêtre de votre espace de travail Xcode, sélectionnez Appareil iOS générique.
2. Dans la barre de menus macOS, sélectionnez Product > Build For > Testing .

Étape 3 : empaquetez votre application pour le téléchargement

Enfin, créez et empaquetez votre test pour le télécharger dans Test Lab en compressant les fichiers de test que vous avez créés dans un fichier .zip .

1. Pour compiler votre XCTest, utilisez la commande suivante dans un terminal :

   projet

   xcodebuild -project PATH/TO/YOUR_WORKSPACE.xcodeproj \
   -scheme YOUR_SCHEME \
   -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
   -sdk iphoneos build-for-testing

   espace de travail

   xcodebuild -workspace PATH/TO/YOUR_WORKSPACE.xcworkspace \
   -scheme YOUR_SCHEME \
   -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
   -sdk iphoneos build-for-testing

2. Une fois votre test construit avec succès, compressez-le pour le télécharger dans Test Lab :

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

Vous pouvez également préparer votre test en compressant manuellement les fichiers de test :

1. Ouvrez le Finder et accédez au répertoire que vous avez désigné pour la sortie des données dérivées.

2. Ouvrez le dossier que vous avez sélectionné pour votre projet, puis ouvrez le dossier Build/Products à l'intérieur.

3. Sélectionnez les dossiers Debug-iphoneos et PROJECT_NAME _iphoneos DEVELOPMENT_TARGET -arm64.xctestrun puis compressez-les.

Étape 4. (Facultatif) Exécutez votre test localement

Avant d'exécuter votre test avec Test Lab, vous pouvez l'exécuter localement avec un appareil connecté par USB pour vérifier la qualité de son comportement :

xcodebuild test-without-building \
    -xctestrun "Derived Data/Build/Products/YourApp.xctestrun" \
    -destination id=your-phone-id

Prochaines étapes

Importez et exécutez votre test dans la console Firebase ou la CLI gcloud .