Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Intégration de l'interface utilisateur XCTest pour iOS à Device Farm
Device Farm fournit un support pour le framework de test de l'interface utilisateur XCTest. Plus précisément, Device Farm prend en charge les tests d'interface utilisateur XCTest écrits à la fois en écriture Objective-C et en [Swift](https://developer.apple.com/swift/).
Le framework d'interface utilisateur XCTest permet de tester l'interface utilisateur dans le développement d'iOS, basé sur XCTest. Pour plus d'informations, consultez [User Interface Testing](https://developer.apple.com/library/prerelease/ios/documentation/DeveloperTools/Conceptual/testing_with_xcode/chapters/09-ui_testing.html#//apple_ref/doc/uid/TP40014132-CH13-SW1) dans la bibliothèque pour les développeurs iOS.
Pour obtenir des informations générales sur les tests dans Device Farm, consultez[Frameworks de test et tests intégrés dans AWS Device Farm](test-types.md).
Suivez les instructions suivantes pour intégrer Device Farm au framework de test de l'interface utilisateur XCTest pour iOS.
**Topics**
+ [Préparez vos tests d'interface utilisateur iOS XCTest](#test-types-ios-xctest-ui-prepare)
+ [Option 1 : Création d'un package XCTest UI .ipa](#how-to-use-create-XCTestUI-ipa-package)
+ [Option 2 : Création d'un package XCTest UI .zip](#how-to-use-create-XCTestUI-zip-package)
+ [Téléchargez vos tests d'interface utilisateur iOS XCTest](#test-types-ios-xctest-ui-upload)
## Préparez vos tests d'interface utilisateur iOS XCTest
Vous pouvez télécharger un `.ipa` fichier ou un `.zip` fichier pour votre package de test XCTEST\_UI.
Un `.ipa` fichier est une archive d'application contenant l'application iOS Runner sous forme de bundle. *Il n'est pas possible d'inclure des fichiers supplémentaires dans le `.ipa` fichier.*
Si vous importez un `.zip` fichier, il peut contenir directement l'application iOS Runner ou un `.ipa` fichier. Vous pouvez également inclure d'autres fichiers dans le `.zip` fichier si vous souhaitez les utiliser pendant les tests. Par exemple, vous pouvez inclure des fichiers tels que`.xctestrun`, `.xcworkspace` ou `.xcodeproj` dans un `.zip` fichier, pour exécuter des plans de test XCUI sur une ferme de périphériques. Des instructions détaillées sur la façon d'exécuter les plans de test sont disponibles dans le fichier de spécifications de test par défaut pour le type de test XCUI.
## Option 1 : Création d'un package XCTest UI .ipa
*Votre AppName* UITest-Runner.app bundle est produit par Xcode lorsque vous créez votre projet à des fins de test. Vous pouvez la trouver dans le répertoire Products de votre projet.
Pour créer un fichier .ipa :
1. Créez un répertoire appelé{{Payload}}.
1. Ajoutez le répertoire de votre application au répertoire Payload.
1. Archivez le répertoire Payload dans un `.zip` fichier, puis remplacez l'extension du fichier par. `.ipa`
La structure de dossiers suivante montre comment un exemple d'application nommé {{my-project-nameUITest-Runner.app}} serait empaqueté sous forme de `.ipa` fichier :
```
.
└── my-project-nameUITest.ipa
└── Payload (directory)
└── my-project-nameUITest-Runner.app
```
## Option 2 : Création d'un package XCTest UI .zip
Device Farm génère automatiquement un `.xctestrun` fichier pour exécuter votre suite complète de tests d'interface utilisateur XCTest. Si vous souhaitez utiliser votre propre `.xctestrun` fichier sur Device Farm, vous pouvez compresser vos `.xctestrun` fichiers et le répertoire de l'application dans un `.zip` fichier. Si vous avez déjà un `.ipa` fichier pour votre package de test, vous pouvez l'inclure ici au lieu de{{\*-Runner.app}}.
```
.
└── swift-sample-UI.zip (directory)
├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
├── SampleTestPlan_2.xctestrun
├── SampleTestPlan_1.xctestrun
└── (any other files)
```
*Si vous souhaitez exécuter un plan de test Xcode pour vos tests XCUI sur Device Farm, vous pouvez créer un fichier zip contenant votre fichier *mon-project-name UITest-Runner.app **ou** mon-project-name* et les fichiers de code source xcode nécessaires pour exécuter XCTEST\_UI avec les plans de test, y compris un UITest.ipa fichier ou.* `.xcworkspace` `.xcodeproj`
Voici un exemple de zip utilisant un `.xcodeproj` fichier :
```
.
└── swift-sample-UI.zip (directory)
├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
├── (any directory)
└── {{SampleXcodeProject.xcodeproj}}
├── Testplan_1.xctestplan
├── Testplan_2.xctestplan
└── (any other source code files created by xcode with .xcodeproj)
```
Voici un exemple de zip utilisant un `.xcworkspace` fichier :
```
.
└──swift-sample-UI.zip (directory)
├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
└── (any directory)
│ ├── SampleXcodeProject.xcodeproj
│ ├── Testplan_1.xctestplan
│ ├── Testplan_2.xctestplan
| └── (any other source code files created by xcode with .xcodeproj)
└── {{SampleWorkspace.xcworkspace}}
└── contents.xcworkspacedata
```
**Note**
Assurez-vous qu'il n'y a pas de répertoire nommé « Payload » dans votre package .zip de l'interface utilisateur XCTest.
## Téléchargez vos tests d'interface utilisateur iOS XCTest
Utilisez la console Device Farm pour télécharger vos tests.
1. Connectez-vous à la console Device Farm à l'adresse [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm).
1. Sur le panneau de navigation de Device Farm, choisissez **Mobile Device Testing**, puis **Projects**.
1. Dans la liste des projets, choisissez le projet dans lequel vous souhaitez télécharger vos tests.
**Astuce**
Vous pouvez utiliser la barre de recherche pour filtrer la liste des projets par nom.
Pour créer un projet, suivez les instructions de [Création d'un projet dans AWS Device Farm](how-to-create-project.md)
1. Choisissez **Create run**.
1. Sous **Paramètres d'exécution**, dans la section **Type d'exécution**, choisissez **application iOS**.
1. Sous **Sélectionner une application**, dans la section **Options de sélection des applications**, sélectionnez **Télécharger votre propre application**. Sélectionnez ensuite **Choisir un fichier** sous **Télécharger l'application**.
1. Recherchez et sélectionnez votre fichier d'application iOS. Le fichier doit être au format .ipa.
**Note**
Assurez-vous que votre fichier .ipa est conçu pour un appareil iOS et non pour un simulateur.
1. Sous **Configurer le test**, dans la section **Sélectionner le framework de test**, choisissez **XCTest UI**. Sélectionnez ensuite **Choisir un fichier** sous **Télécharger l'application**.
1. Accédez au fichier .ipa ou .zip qui contient votre lanceur de tests d'interface utilisateur iOS XCTest et choisissez-le.
1. Effectuez les étapes restantes du processus de création d'une course. Vous allez sélectionner les appareils sur lesquels vous souhaitez effectuer le test et éventuellement spécifier une configuration supplémentaire.
1. Choisissez **Create run**. Device Farm exécute votre test et affiche les résultats dans la console.