Catch up on everthing we announced at this year's Firebase Summit. Learn more

Exécuter un XCTest

Ce guide explique comment préparer un XCTest pour le test dans Firebase Test Lab.

Étape 1: Configurer votre projet est Derived Data location

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 de 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 effectuer des tests avec Test Lab :

  1. Ouvrez votre projet dans Xcode.
  2. Dans la barre de menu Mac OS, sélectionnez Fichier> Paramètres du projet ...
  3. Modifier la dérivée des données de menu déroulant Emplacement par défaut à un emplacement personnalisé.
  4. Dans le champ sous la liste déroulante, sélectionnez un emplacement pour Xcode vers lequel sortir vos tests.

Étape 2: Construire un fichier test générique

Test de laboratoire effectue des tests unitaires et des tests UI en utilisant le XCTest cadre. Pour exécuter les XCTests de votre application sur des appareils Test Lab, créez-la pour les 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 menu Mac OS, sélectionnez Produit> Construire pour la > Test.

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

Enfin, la construction et l' emballage de votre test pour le téléchargement de laboratoire de test en comprimant les fichiers de test que vous intégré dans un .zip fichier.

  1. Pour construire 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 packager votre test en compressant les fichiers de test manuellement :

  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 la Build/Products dossier à l' intérieur.

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

É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 périphérique 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

L'étape suivante

Télécharger et exécuter votre test dans la console Firebase ou la CLI gcloud .